Falabella Seller Center permite al encargado de la tienda administrar los productos y pedidos en su tienda en línea.

En consecuencia, la API de Seller Center permite el mantenimiento programático de productos y pedidos.

Por ejemplo, puede utilizar la API para importar productos o migrar pedidos a su sistema de contabilidad.

Formato de comunicación

En términos generales, todas las solicitudes se originan en usted; en otras palabras, usted contacta con la API. La API no se pone en contacto con usted.

Más específicamente, cada solicitud es una solicitud HTTP dirigida a un endpoint. Dependiendo de lo que desee lograr, realizará una solicitud HTTP con un comando GET o POST.

En la mayoría de los casos, la llamada sólo involucra parámetros de URL, como la llamada a GetProducts, que es tan simple como esto:

https://sellercenter-api.falabella.com/?Action=GetProducts&Filter=sold-out&Format=XML&Timestamp=2015-07-21T05%3A14%3A49%2B02%3A00&UserID=maintenance%40sellercenter.net&Version=1.0&Signature=dee80841b2aa0ad1fb517f196c56a5e5b9c78627c9256a11df11da76a3f84503

📘

Endpoint URL

A lo largo de esta documentación, el ejemplo realiza llamadas contra sellercenter-api.falabella.com.

Ambiente de Producción:

https://sellercenter-api.falabella.com

Staging:

https://sellercenter-api-staging.falabella.com

Asegúrese de probar siempre su código con una instancia de ensayo. Aparte de una restauración de la base de datos, ¡No hay cómo deshacer una llamada a la API!

📘

Falabella Seller Center URL

Ambiente de Producción:

https://sellercenter.falabella.com/

Staging:

https://sellercenter-staging.falabella.com/

Al observar la solicitud anterior, vemos que todos los parámetros necesarios ya están incluidos en la URL como parámetros. Luego, la API devuelve la información que buscamos, ya sea en formato XML o JSON, dependiendo de lo que solicitamos:

<? xml version = "1.0" encoding = "UTF-8" ?>
    <SuccessResponse>
        <Head>
            <RequestId />
            <RequestAction>GetProducts</RequestAction>
            <ResponseType>Products</ResponseType>
            <Timestamp>2015-07-01T11:11:11+0000</Timestamp>
        </Head>
        <Body>
            <Products>
                <Product>
                    <SellerSku>UPCtest2</SellerSku>
                    <ShopSku>110000030</ShopSku>
                    <Name>Violin UAT S4 UPC test</Name>
                    <Variation>...</Variation>
                    <ParentSku>UPCtest2</ParentSku>
                    <ProductId>2021011103</ProductId>
                    <Url>https://www.falabella.com/falabella-cl/product/110000029/Violin-UAT-S4-UPC-test/{Unknown macro: {product.sku}}</Url>
                    <MainImage>https://falabella.scene7.com/is/image/Falabella/gsc_110000029_1</MainImage>
                    <Images>
                        <Image>https://falabella.scene7.com/is/image/Falabella/gsc_110000029_1</Image>
                        <Image>https://falabella.scene7.com/is/image/Falabella/gsc_110000029_2</Image>
                    </Images>
                    <Description>20210111 UAT to test the UPC fix</Description>
                    <TaxClass>IVA 19%</TaxClass>
                    <Brand>MAL CREADO</Brand>
                    <PrimaryCategory>Instrumentos musicales de cuerda no eléctricos</PrimaryCategory>
                    <QCStatus>rejected</QCStatus>
                    <BusinessUnits>
                        <BusinessUnit>
                            <BusinessUnit>Falabella</BusinessUnit>
                            <OperatorCode>facl</OperatorCode>
                            <Price>2990.00</Price>
                            <SpecialPrice>1990.00</SpecialPrice>
                            <SpecialFromDate>2021-01-11 00:00:00</SpecialFromDate>
                            <SpecialToDate>2021-01-12 00:00:00</SpecialToDate>
                            <Stock>100</Stock>
                            <Status>inactive</Status>
                            <IsPublished>1</IsPublished>
                        </BusinessUnit>
                    </BusinessUnits>
                    <ProductData>
                        <Model>VIO1234</Model>
                        <ProductionCountry>Curasao</ProductionCountry>
                        <ConditionType>Nuevo</ConditionType>
                        <SellerWarranty>3 meses</SellerWarranty>
                        <PackageWidth>10</PackageWidth>
                        <PackageLength>15</PackageLength>
                        <PackageHeight>12</PackageHeight>
                        <PackageWeight>2</PackageWeight>
                        <Alto>12 cm</Alto>
                        <Ancho>12 cm</Ancho>
                        <CantidadDeCuerdas>4</CantidadDeCuerdas>
                        <Color>blanco</Color>
                        <ColorBasico>Blanco</ColorBasico>
                        <CuentaConRuedas />
                        <GrupoDeEdad>Todas las etapas</GrupoDeEdad>
                        <Idioma>Bilingüe</Idioma>
                        <OrientacionDeLaMano>Ambidiestro</OrientacionDeLaMano>
                        <Soporte>3 meses</Soporte>
                        <TipoDeInstrumento>Violín</TipoDeInstrumento>
                        <TipoDePuente>Fijo</TipoDePuente>
                    </ProductData>
                </Product>
            </Products>
        </Body>
    </SuccessResponse>
{
  "SuccessResponse": {
    "Head": {
      "RequestId": "",
      "RequestAction": "GetProducts",
      "ResponseType": "Products",
      "Timestamp": "2015-07-21T07:28:52+0200"
    },
    "Body": {
      "Products": {
        "Product": [
          {
            "SellerSku": "BobKing",
            "ShopSku": "KI995ELAAK2HNAFAMZ-53759",
            "Name": "Bob the King",
            "Variation": "...",
            "ParentSku": "BobKing",
            "Quantity": "51",
            "Available": "51",
            "Price": "323.00",
            "SalePrice": "",
            "SaleStartDate": "",
            "SaleEndDate": "",
            "Status": "active",
            "ProductId": "BobtheKing",
            "Url": "http://rocket:[email protected]/26009.html",
            "MainImage": "http://mycdn.net/p/26009-1497-90062-1-catalog.jpg"
          },
          {
            "SellerSku": "Bobqueen",
            "ShopSku": "JE134FAAAK2INAFAMZ-53760",
            "Name": "Bob the queen",
            "Variation": "42",
            "ParentSku": "Bobqueen",
            "Quantity": "5",
            "Available": "5",
            "Price": "343.00",
            "SalePrice": "",
            "SaleStartDate": "",
            "SaleEndDate": "",
            "Status": "active",
            "ProductId": "Bobthequeen",
            "Url": "http://rocket:[email protected]/26010.html",
            "MainImage": "http://mycdn.net/p/26010-4018-01062-1-catalog.jpg"
          }
        ]
      }
    }
  }
}

🚧

Todos los valores JSON son cadenas (strings)

Una limitación actual de la API es que en una respuesta JSON todos los valores son cadenas: por ejemplo, los valores booleanos se devuelven como "true" y "false", no true y false. En la respuesta JSON anterior, por ejemplo, esperaría que "Quantity" sea el entero 51, pero se devuelve como la cadena "51".

Limitaciones de la velocidad de llamada

Hay límites en la cantidad de llamadas que puede realizar por segundo (esto a veces se denomina "throttling"): si realiza más de 30 solicitudes en 3 segundos, obtendrá una respuesta de error "E429: Too many requests" (Demasiadas solicitudes).

Consulte también el tema "Feed Throttling" en la página Feeds.