Consultar Productos

Endpoint

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.

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

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

Parámetros

Action

string

Requerido

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

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 de SellerCenter 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: text/xml. text/xml

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:

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

Respuesta 200


<?xml version="1.0" encoding="UTF-8"?>
<SuccessResponse>
    <Head>
        <RequestId/>
        <RequestAction>GetProducts</RequestAction>
        <ResponseType>Products</ResponseType>
        <Timestamp>2025-12-02T15:30:24-0300</Timestamp>
    </Head>
    <Body>
        <Products>
            <Product>
                <SellerSku>test-seller-sku-001</SellerSku>
                <ShopSku>test-shop-sku-001</ShopSku>
                <Variant>test-seller-sku-001</Variant>
                <Name>Zapatillas Marca Test Modelo X Negro Hombre</Name>
                <ProductId/>
                <Url>https://www.falabella.com/falabella-cl/product/test-product-001/Zapatillas-Test-Modelo-X-Negro-Hombre/test-variant-001</Url>
                <MainImage>https://sellercenter-static.falabella.com/test/test-main-image-001.jpeg</MainImage>
                <Images>
                    <Image>https://sellercenter-static.falabella.com/test/test-image-001.jpeg</Image>
                    <Image>https://sellercenter-static.falabella.com/test/test-image-002.jpeg</Image>
                    <Image>https://sellercenter-static.falabella.com/test/test-image-003.jpeg</Image>
                    <Image>https://sellercenter-static.falabella.com/test/test-image-004.jpeg</Image>
                </Images>
                <ContentScore>74</ContentScore>
                <Description>Este es un producto de prueba con descripción ficticia para validar integraciones.</Description>
                <TaxClass>IVA 19%</TaxClass>
                <Brand>TEST BRAND</Brand>
                <PrimaryCategory>Zapatillas deportivas</PrimaryCategory>
                <QCStatus>approved</QCStatus>
                <BusinessUnits>
                    <BusinessUnit>
                        <BusinessUnit>Falabella</BusinessUnit>
                        <OperatorCode>facl</OperatorCode>
                        <Price>64990.00</Price>
                        <SpecialPrice/>
                        <SpecialFromDate/>
                        <SpecialToDate/>
                        <Stock>14</Stock>
                        <Status>active</Status>
                        <IsPublished>1</IsPublished>
                        <AvailableToSell>
                            <Site>
                                <Site>Product published in Falabella</Site>
                            </Site>
                        </AvailableToSell>
                    </BusinessUnit>
                </BusinessUnits>
                <ProductData>
                    <Sizechartname>test-sizechart</Sizechartname>
                    <SizeChartUrl>https://catalog-reg.s3.amazonaws.com/repositorio/falabella_tallas/test-sizechart.html</SizeChartUrl>
                    <ConditionType>Nuevo</ConditionType>
                    <PackageWidth>25</PackageWidth>
                    <PackageLength>38</PackageLength>
                    <PackageHeight>15</PackageHeight>
                    <PackageWeight>0.5</PackageWeight>
                    <DisciplinaZapatillas>Running</DisciplinaZapatillas>
                    <Genero>Hombre</Genero>
                    <ImpermeabilidadDeLaTela>No</ImpermeabilidadDeLaTela>
                    <MaterialPrincipal>Sintético</MaterialPrincipal>
                    <TipoDeCana>Sin caña</TipoDeCana>
                </ProductData>
            </Product>
        </Products>
    </Body>
</SuccessResponse>

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)