Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Stock distribuido
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, drop_off, crossdocking, flex, etc... | 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"
}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
}'Siguiente: Stock Multi Origen.