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

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>BobKing</SellerSku>
        <ShopSku>KI995ELAAK2HNAFAMZ-53759</ShopSku>
        <Name>Bob the King</Name>
        <Variation>...</Variation>
        <ParentSku>BobKing</ParentSku>
        <Quantity>51</Quantity>
        <Available>51</Available>
        <Price>323.00</Price>
        <SalePrice/>
        <SaleStartDate/>
        <SaleEndDate/>
        <Status>active</Status>
        <ProductId>BobtheKing</ProductId>
        <Url>http://rocket:[email protected]/26009.html</Url>
        <MainImage>http://mycdn.net/p/26009-1497-90062-1-catalog.jpg</MainImage>
      </Product>
      <Product>
        <SellerSku>Bobqueen</SellerSku>
        <ShopSku>JE134FAAAK2INAFAMZ-53760</ShopSku>
        <Name>Bob the queen</Name>
        <Variation>42</Variation>
        <ParentSku>Bobqueen</ParentSku>
        <Quantity>5</Quantity>
        <Available>5</Available>
        <Price>343.00</Price>
        <SalePrice/>
        <SaleStartDate/>
        <SaleEndDate/>
        <Status>active</Status>
        <ProductId>Bobthequeen</ProductId>
        <Url>http://rocket:[email protected]/26010.html</Url>
        <MainImage>http://mycdn.net/p/26010-4018-01062-1-catalog.jpg</MainImage>
      </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.