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. | usuario (vendedor) |
meli_facility | El vendedor envía su stock a los depósitos de Fulfillment de Mercado Libre. | Mercado Libre (Full) |
store | 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 el siguiente llamado:
curl -X GET https://api.mercadolibre.com/user-products/$USER_PRODUCT_ID/stock -H 'Authorization: Bearer $ACCESS_TOKEN'
Ejemplo para un UP específico:
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 store:
{
"locations": [
{
"type": "store",
"store_id": 9876543,
"quantity": 15
},
{
"type": "store",
"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 (store y meli_facility).
Gestionar stock
Para modificar el stock de un location selling_address, podrás continuar utilizando el PUT de ítems.
O podrás utilizar el método PUT para enviar la cantidad deseada de stock.
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
}'
Ejemplo para un UP específico:
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.