Estoque distribuído

Estoque Distribuído tem como objetivo permitir que os vendedores configurem diferentes localizações de estoque (stock_locations) para um mesmo User Product.

Como mostra o gráfico, o estoque será compartilhado entre canais (marketplace e MShops).

Para a gestão do estoque, definimos três tipos de stock_locations:

Obter detalhe do estoque

Para consultar o estoque associado a um User Product, você deverá fazer a seguinte chamada:

curl -X GET https://api.mercadolibre.com/user-products/$USER_PRODUCT_ID/stock -H 'Authorization: Bearer $ACCESS_TOKEN'

Exemplo:

curl -X GET https://api.mercadolibre.com/user-products/MLBU206642488/stock -H 'Authorization: Bearer $ACCESS_TOKEN'

Exemplo de resposta para tipologia selling_address:

{
   "locations": [
       {
           "type": "selling_address",
           "quantity": 5
       }
   ],
   "user_id": 1234,
   "id": "MLBU206642488"
}

Exemplo de resposta para tipologia meli_facility:

{
   "locations": [
       {
           "type": "meli_facility", //fulfillment
           "quantity": 5
       }
   ],
   "user_id": 1234,
   "id": "MLBU206642488"
}

Exemplo de resposta 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"
}

Um mesmo UP poderá ter até duas tipologias, seja (selling_address e meli_facility) ou (seller_warehouse e meli_facility).

Gerenciar estoque

Para modificar o estoque de uma localização selling_address, você poderá continuar utilizando o PUT de itens.
Nesse caso, o Mercado Livre atualizará o estoque para todos os itens associados ao mesmo user_product_id de forma automática.

Ou você poderá utilizar a seguinte chamada, para enviar a quantidade de estoque a nível de User Products nesses dois tipos de localizações de estoque: selling_address e meli_facility.

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

204 

O estoque será atualizado de forma assíncrona em todas as condições de venda do user product:

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

Próximo: Estoque Multi Origem.