Estoque distribuído

Stock 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 channels (marketplace e MShops).

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

Obter detalhe de 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 para um UP específico:

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 store:

{
   "locations": [
       {
           "type": "store",
           "store_id": 9876543,
           "quantity": 15
       },
       {
           "type": "store",
           "store_id": 9876553,
           "quantity": 15
       }
   ],
   "user_id": 1234,
   "id": "MLBU206642488"
}

Um mesmo UP pode ter até duas tipologias, seja (selling_address e meli_facility) ou (store e meli_facility).

Gerenciar estoque

Para modificar o estoque de uma localização selling_address, você pode continuar utilizando o PUT de itens.
Ou pode utilizar o método PUT para enviar a quantidade desejada de estoque.

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

Exemplo para um 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: Estoque multi-origem.