Consultar Categorías

Endpoint

https://sellercenter-api.falabella.com/?Action=GetCategoryTree

Esta Api obtiene el listado de todas las categorías existentes.

Cada categoría está compuesta por los siguientes campos:

Nombre	Tipo	Descripción
Name	String	El nombre de la categoría
GlobalIdentifier	String	Un identificador único para esta categoría en todos los países
CategoryId	Integer	ID de la categoría
AttributeSetId	Integer	ID del AttributeSet que se utilizará en otras llamadas a la API (es decir, GetCategoriesByAttributeSet)
Children	Node	Lista de todas las categorías secundarias (recursos de categoría)

Parámetros

Action

string

Requerido

Nombre de la función que se va a llamar. Obligatorio y debe ser 'GetCategoryTree' en este caso. Si se omite, se devuelve un error 'E001: Parameter Action is mandatory' (El parámetro Action es obligatorio). Si se proporciona una cadena de función desconocida, se devuelve un mensaje de error 'E008: Invalid Action' (Acción no válida). GetCategoryTree

Format

string

Opcional

Si se proporciona, debe ser 'JSON' o 'XML'. Si no se proporciona, se asume 'XML'. XML

Timestamp

date

Requerido

La hora actual en formato ISO8601 relativa a UTC (p. Ej., Marca de tiempo = 2015-04-01T10: 00: 00 + 02: 00 para Berlín), de modo que las llamadas no puedan ser reproducidas por un tercero que espíe (es decir, aquellas llamadas demasiado lejos en el pasado o en el futuro producen un mensaje de error). Obligatorio. Si no se proporciona, aparece el mensaje de error 'E001: La marca de tiempo del parámetro es obligatoria'. Si la marca de tiempo es demasiado antigua o está en el futuro, se devuelve un mensaje de error "E003: Timestamp has expired" (Timestamp expiró).

UserID

string

Requerido

El ID del usuario que realiza la llamada. La lista de usuarios autorizados se mantiene en la interfaz web del Centro de vendedores en Configuración general / Administrar usuarios.

Version

string

Requerido

La versión de API contra la que se ejecutará esta llamada, en formato mayor-punto-menor. Actualmente debe ser 1.0, aunque la versión real de la API es 2.6.20. Si se omite, se devuelve un mensaje de error "E001: Parameter Version is mandatory" (El parámetro Version es obligatorio).

Headers

accept

string

Opcional

Generado a partir de los tipos de contenido de respuesta disponibles. Valores permitidos: application/xml, application/json. application/json

La respuesta de este endpoint contiene la colección "Categories", la cual incluye recursos de categoría de forma recursiva. Es importante tener en cuenta que Falabella solo permite la creación de productos en el último nivel de categoría; no es posible cargar productos en niveles intermedios.

Respuesta 200

<?xml version="1.0" encoding="UTF-8"?>
<SuccessResponse>
	<Head>
		<RequestId/>
		<RequestAction>GetCategoryTree</RequestAction>
		<ResponseType>Categories</ResponseType>
		<Timestamp>2015-07-01T11:11:11+0000</Timestamp>
	</Head>
	<Body>
		<Categories>
			<Category>
				<Name>Quadrilaterals</Name>
				<CategoryId>2790</CategoryId>
        <GlobalIdentifier>QUADRILATER</GlobalIdentifier>
        <AttributeSetId>1</AttributeSetId>
				<Children>
					<Category>
						<Name>Rectangles</Name>
						<CategoryId>589</CategoryId>
            <GlobalIdentifier>RECTANGLE</GlobalIdentifier>
	          <AttributeSetId>1</AttributeSetId>
						<Children>
							<Category>
								<Name>Squares</Name>
								<CategoryId>603</CategoryId>
                <GlobalIdentifier>SQUARE</GlobalIdentifier>
			          <AttributeSetId>2</AttributeSetId>
								<Children/>
							</Category>
						</Children>
					</Category>
				</Children>
      </Category>
		</Categories>
	</Body>
</SuccessResponse>