Estoque multi-origem

O Stock Multi Origem tem como objetivo permitir representar um vendedor (seller_id) que possui mais de uma localização ou loja (store). O objetivo final, juntamente com a iniciativa de Preços por Variação, é permitir itens de um mesmo vendedor com estoque distribuído em diferentes locais.
Este conceito inclui o conceito de uma loja (store), para representar uma localização ou loja que o vendedor gerencia. Nesta documentação, você encontrará informações importantes para cada um dos fluxos que serão impactados por esta iniciativa, começando por:

• Gestão de localizações
• Gestão de estoque por localização

Gestão de localizações

Inicialmente, selecionamos uma lista de vendedores que atualmente operam com múltiplos armazéns, os quais terão acesso a essa experiência, permitindo-lhes gerenciar suas localizações ou lojas.

Cada vendedor manterá uma única logística base, ou seja, um vendedor que possui várias localizações todas irão operar, por exemplo, no (cross_docking) Mercado Envios Colecta. Além disso, o fluxo de Stock Multi Origem não se aplica ao me1.

Gestão de vendedores

Para identificar os usuários configurados com mais de uma localização ou loja, utilizaremos a tag "warehouse_management" no user_id.
Consulte a API de usuários para saber se um usuário opera em modo multi-origem:

curl -X GET https://api.mercadolibre.com/users/$USER_ID -H 'Authorization: Bearer $ACCESS_TOKEN'

Exemplo para um usuário específico:

curl -X GET https://api.mercadolibre.com/users/1008002397 -H 'Authorization: Bearer $ACCESS_TOKEN'

Resposta:

{
    "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": []
}

Gestão de estoque por localização

Para modificar o estoque por localização, é necessário enviar o user_product_id e o store_id.

Utilize um método PUT para enviar a quantidade desejada de estoque. Se a loja não tiver estoque previamente atribuído, essa quantidade será atribuída a ela. Se a loja já possui estoque atribuído, a nova quantidade indicada será atribuída.

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
}'

Exemplo para um UP específico e uma localização:

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: Descrição de produtos.