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.

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.