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
Request headers
A partir del 30 de noviembre de 2022, todas las solicitudes (requests) deberán tener el encabezado (header) User-Agent configurado con el siguiente formato:
Falabella_SellerId/Lenguaje_de_programacion/Version_del_lenguaje
Ejemplo:
User-Agent: JJJ123/PHP/8.1.7Más información sobre este header en MDN - User-Agent.
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:
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.