Consultar Productos

get

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

GetProducts. Obtienes todos o una variedad de productos, puedes usar campos como "filter", "SkuSellerList" o "limit" para poder realizar un filtro de los productos.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Respuesta

Los valores incluidos en la respuesta variarán según los atributos del producto y la categoría a la que pertenezca.
En la siguiente tabla se detallan algunos de los campos que esta API puede devolver en la respuesta:

Nombre	Tipo	Descripción
SellerSku	String	Identificador único del vendedor
ShopSku	String	Identificador único de la tienda
Name	String	Nombre del producto
Brand	String	Marca del producto
Description	String	Descripción del producto
TaxClass	String	Clase de impuesto aplicada al producto
Variation	String	Nombre de la agrupación de fotos, para categorías sin variación
BusinessUnit.Stock	Integer	El stock vendible en el almacén del vendedor. Este campo no contempla el stock reservado por órdenes en curso
BusinessUnit.Price	Decimal	El precio habitual del producto
BusinessUnit.SalePrice	Decimal	El precio de venta especial del producto
BusinessUnit.SaleStartDate	DateTime	Fecha de inicio de la oferta especial
BusinessUnit.SaleEndDate	DateTime	Fecha de finalización de la oferta especial
BusinessUnit.Status	Integer	Estado del producto: 'active', 'inactive' o 'deleted'
ProductId	String	EAN / UPC / ISBN del producto, si existe
Url	String	Enlace al producto en el sitio web de la empresa
MainImage	String	Enlace a la imagen principal del producto
Images	Multiple Image Elements	Todas las imágenes del producto (incluida la imagen principal)
PrimaryCategory	String	La categoría principal del producto
Categories	String	Categorías adicionales del producto (separadas por comas)
ProductData	Multiple Attribute Elements	Los atributos del producto
QCStatus	String	El estado de QC (Quality Control) del producto al momento de la llamada. "pending" (pendiente), "approved" (aprobado), "rejected" (rechazado)
isPublished	Integer	Estado de aprobación de la publicación del producto. 0 - no aprobado para publicar 1 - aprobado para publicar
BusinessUnit.OperatorCode	String	El código de la tienda donde el producto será publicado. facl= Chile, fape= Perú, FACO= Colombia.
ContentScore	Integer	Puntaje del producto

Es importante recordar que los atributos podrían cambiar entre categorías, por lo cual la respuesta al consultar por un producto, podría variar. Recuerda que puedes consultar los atributos de una categoría usando el API GetCategoryAttributes

Errores

Código de error	Mensaje
17	E017: "%s" Invalid Date Format (Formato de fecha inválido)
19	E019: "%s" Invalid Limit (Limite inválido)
14	E014: "%s" Invalid Offset (Offset inválido)
36	E036: Invalid status filter (Filtro de estado inválido)
70	E070: You have corrupt data in your sku seller list (Tiene datos corruptos en su lista de vendedores de sku)

🚧
Importante
puedes hacer uso de Offset y Limit para recorrer todo el listado de productos, en caso de que tengas más productos que el máximo devuelto por el API

Query Params

Action

string

required

Defaults to GetProducts

Nombre de la función que se va a llamar. Obligatorio y debe ser 'GetProducts' 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).

Format

string

enum

Defaults to XML

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

Allowed:

Timestamp

date

required

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

required

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

Version

string

required

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).

Signature

string

required

La firma criptográfica que autentica la solicitud. Una persona que llama debe crear este valor calculando el hash SHA256 de la solicitud, utilizando la clave API del usuario especificado en el parámetro UserID. Obligatorio. Si se omite, se devuelve un mensaje de error "E001: Parameter Signature is mandatory" (El parámetro Signature es obligatorio). Si la firma es incorrecta, un 'E007: Login failed' (Error de inicio de sesión). Se devuelve el mensaje de error de discrepancia de firma.

CreatedAfter

date

Limita la lista de productos devueltos a aquellos creados después o en una fecha específica, dada en formato de fecha ISO 8601. Opcional

CreatedBefore

date

Limita la lista de productos devueltos a aquellos creados antes o en una fecha específica, en formato de fecha ISO 8601. Opcional

string

Devuelve aquellos productos donde la cadena de búsqueda está contenida en el nombre y / o SKU del producto.

Filter

string

enum

Defaults to all

Devuelve sólo aquellos productos cuyo estado coincida con este parámetro. Los valores posibles son all (todos), live (en vivo), active (activo), inactive (inactivo), deleted (eliminado), image-missing (falta imagen), pending (pendiente), rejected (rechazado), sold-out (agotado). Obligatorio.

Limit

int32

Defaults to 1000

El número máximo de productos que se deben devolver. Si omite este parámetro, se utiliza el valor predeterminado de 1000. La mayor cantidad de productos que puede solicitar con una sola llamada es 1000(este es el límite estricto predeterminado, que se puede cambiar por instancia). Si necesita recuperar más productos que eso, debe hojear el conjunto de resultados usando el parámetro Offset.

Offset

int32

Número de productos para omitir (es decir, un desplazamiento en el conjunto de resultados; junto con el parámetro Limit, es posible una paginación simple del conjunto de resultados; si recorre los resultados, tenga en cuenta que la lista de productos puede cambiar durante la paginación).

SkuSellerList

array of strings

Solo se devolverán los productos cuyo SKU esté incluido en esta lista. Ej., ["E213", "KI21", "HT0"]

SkuSellerList

UpdatedAfter

date

Limita la lista de productos devueltos a aquellos actualizados después o en una fecha específica, en formato de fecha ISO 8601. Opcional

UpdatedBefore

date

Limita la lista de productos devueltos a aquellos actualizados antes o en una fecha específica, en formato de fecha ISO 8601. Opcional

GlobalIdentifier

int32

Defaults to 0

Si se establece en 1, Brand, PrimaryCategory, Categorías y todos los atributos en ProductData se devolverán con identificadores globales.

Response

Respuesta

Errores

Importante

200200