Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.![circulos azuis em degrade](https://http2.mlstatic.com/storage/developers-site-cms-admin/DevImgs/230801158836-ImgMS--1-.png)
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.
![](https://http2.mlstatic.com/storage/developers-site-cms-admin/190701781339-stock-distribuido-hispano.png)
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"
}
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.