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 multi origen
Stock Multi Origen tiene como objetivo permitir representar un vendedor (seller_id ) que tiene más de una ubicación o tienda (store). El endgame junto con la iniciativa de Precios por Variación es permitir items de un mismo seller con stock distribuido en sus diferentes ubicaciones.
Se incluye el concepto de un store, para representar una ubicación o tienda que un vendedor maneja. En esta documentación, encontrarás información importante para cada uno de los flujos que se verán impactados por esta iniciativa, comenzando por:
- Gestión de ubicaciones.
- Gestión de stock por ubicación.
Gestión de ubicaciones
En un principio, hemos seleccionado una lista de vendedores que actualmente operan con múltiples almacenes, quienes tendrán esta experiencia disponible, permitiéndoles así gestionar sus ubicaciones o tiendas.
Cada vendedor va a mantener una única logística base, es decir, un vendedor que tiene varias ubicaciones todas van a operar por ejemplo en (cross_docking) Mercado Envios Colecta. Por otra parte, el flujo de Stock Multi Origen no aplica para me1.
Gestión de vendedores
Para identificar a los usuarios que estén configurados con más de una ubicación o tienda, utilizaremos el tag "warehouse_management" en user_id.
Consulta el api de users, para saber si un usuario opera en modo multiorigen:
curl -X GET https://api.mercadolibre.com/users/$USER_ID -H 'Authorization: Bearer $ACCESS_TOKEN'
Ejemplo para un usuario específico:
curl -X GET https://api.mercadolibre.com/users/1008002397 -H 'Authorization: Bearer $ACCESS_TOKEN'
Respuesta:
{
"id": 1008002397,
"nickname": "TETE9326760",
"registration_date": "2021-10-27T14:48:55.000-04:00",
"first_name": "Test",
"last_name": "Test",
"gender": "",
"country_id": "MX",
"email": "test_user_19653740@testuser.com",
"identification": {...},
"address": {...},
"phone": {...},
"alternative_phone": {...},
"user_type": "normal",
"tags": [
"normal",
"warehouse_management",
"mshops",
"messages_as_seller"
],
"logo": null,
"points": 1,
"site_id": "MLM",
"permalink": "http://perfil.mercadolibre.com.mx/TETE9326760",
"seller_experience": "NEWBIE",
"bill_data": {...},
"seller_reputation": {...},
"buyer_reputation": {...},
"status": {...},
"secure_email": "ttest.y25p1f@mail.mercadolibre.com.mx",
"company": {...},
"credit": {...},
"context": {...},
"registration_identifiers": []
}
Gestión de stock por ubicación
Para modificar el stock por ubicación, es necesario enviar el user_product_id y el store_id.
![](https://http2.mlstatic.com/storage/developers-site-cms-admin/191324730568-hispano-multiorigen.png)
Utiliza un método PUT para enviar la cantidad deseada de stock. Si la tienda no tiene stock asignado previamente, se le asignará esta cantidad. Si la tienda ya cuenta con stock asignado, se le asignará la nueva cantidad indicada.
curl -X PUT https://api.mercadolibre.com/user-products/$USER_PRODUCT_ID/stock/type/store/$STORE_ID -H 'x-version: $HEADER' -H 'Content-Type: application/json' -H 'Authorization: Bearer $ACCESS_TOKEN' -d '{
"quantity": $STOCK_QUANTITY
}'
Ejemplo para un UP específico y una ubicación:
curl -X PUT https://api.mercadolibre.com/user-products/MLBU206642488/stock/type/store/9876543 -H 'x-version: 1' -H 'Content-Type: application/json' -H 'Authorization: Bearer $ACCESS_TOKEN' -d '{
"quantity": 15
}'
Siguiente: Descripción de productos.