Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 31/07/2024

Stock distribuido

Importante:
La iniciativa ya esta en producción en Argentina y Chile, y a partir de 1.º de octubre de 2024 se encenderá en México. Para realizar pruebas, podrán solicitar la ambientación de un usuario de pruebas de Argentina a través del siguiente formulario.

Stock Distribuido tiene como objetivo permitir que los sellers configuren diferentes ubicaciones del stock (stock_locations) a un mismo User Product.



Como lo evidencia el gráfico, el stock será compartido entre channels (marketplace y MShops).


Para la gestión del store definimos tres tipologías de stock_locations:

Location type Caso de uso Gestor del stock
selling_address El stock gestionado por el vendedor tiene un sólo punto de origen. En este location se actualiza el stock que el vendedor maneja normalmente los tipos logísticos actuales, tal y como, crossdocking, xd_drop_off y flex. usuario (vendedor)
meli_facility El vendedor envía su stock a los depósitos de Fulfillment de Mercado Libre. Mercado Libre (Full)
seller_warehouse Múltiples orígenes de stock gestionados por el vendedor. Permite al vendedor configurar distintas tiendas o ubicaciones donde tiene su inventario. usuario (vendedor)


Obtener detalle de stock

Para consultar el stock asociado a un User Product deberás hacer la siguiente llamada:

curl -X GET https://api.mercadolibre.com/user-products/$USER_PRODUCT_ID/stock -H 'Authorization: Bearer $ACCESS_TOKEN'

Ejemplo:

curl -X GET https://api.mercadolibre.com/user-products/MLBU206642488/stock -H 'Authorization: Bearer $ACCESS_TOKEN'

Ejemplo de respuesta para tipologia selling_address:

{
   "locations": [
       {
           "type": "selling_address",
           "quantity": 5
       }
   ],
   "user_id": 1234,
   "id": "MLBU206642488"
}

Ejemplo de respuesta para tipologia meli_facility:

{
   "locations": [
       {
           "type": "meli_facility", //fulfillment
           "quantity": 5
       }
   ],
   "user_id": 1234,
   "id": "MLBU206642488"
}

Ejemplo de respuesta para tipologia seller_warehouse:

{
   "locations": [
       {
           "type": "seller_warehouse",
           "network_node_id": "MXP123451",
           "store_id": 9876543,
           "quantity": 15
       },
       {
           "type": "seller_warehouse",
           "network_node_id": "MXP123452",
           "store_id": 9876553,
           "quantity": 15
       }
   ],
   "user_id": 1234,
   "id": "MLBU206642488"
}
Nota:
Al consultar el detalle de stock, se retornará un header llamado "x-version", el cual tendrá un valor entero (de tipo long) que representará la versión actual de /stock/. Este header debe ser enviado al realizar llamados PUT en /stock/.

Si no se envía, retornará un código de status 400 (Bad Request). Adicionalmente, en caso de que la versión enviada no es la correcta, se retornará un Conflict (status code: 409).

En el caso de una respuesta con código 409, se debe consultar nuevamente el stock para obtener la versión actualizada del header "x-version".

Un mismo UP podrá tener hasta dos tipologías, ya sea (selling_address y meli_facility) o (seller_warehouse y meli_facility).



Gestionar stock

Para modificar el stock de un location selling_address, podrás continuar utilizando el PUT de ítems.
En cuyo caso Mercado Libre, actualizará el stock para todos los ítems asociados al mismo user_product_id de manera automática.

O podrás utilizar la siguiente llamada, para enviar la cantidad de stock a nível User Products en estos dos tipos de stock locations selling_address y meli_facility.


Llamada:

curl -X PUT https://api.mercadolibre.com/user-products/$USER_PRODUCT_ID/stock/type/selling_address -H 'x-version: $HEADER' -H 'Content-Type: application/json' -H 'Authorization: Bearer $ACCESS_TOKEN' -d '{
    "quantity": $STOCK_QUANTITY
}'

Respuesta:

204 

el stock se actualizará de manera asíncrona en todas las condiciones de venta del user product:


Ejemplo:

curl -X PUT https://api.mercadolibre.com/user-products/MLBU206642488/stock/type/selling_address -H 'x-version: 1' -H 'Content-Type: application/json' -H 'Authorization: Bearer $ACCESS_TOKEN' -d '{
    "quantity": 15
}'

Para actualizar el stock de un seller multi origen revisar la siguiente documentación.


Siguiente: Stock Multi Origen.