Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.![circulos azuis em degrade](https://http2.mlstatic.com/storage/developers-site-cms-admin/DevImgs/230801158836-ImgMS--1-.png)
Documentação do
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.
![](https://http2.mlstatic.com/storage/developers-site-cms-admin/190701781339-stock-distribuido-hispano.png)
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:
Tipo de localização | Caso de uso | Gestor do estoque |
---|---|---|
selling_address | O estoque gerenciado pelo vendedor tem um único ponto de origem. Nesta localização, o estoque é atualizado pelo vendedor que normalmente gerencia os tipos logísticos atuais, como xd_drop_off, crossdocking e flex. | usuário (vendedor) |
meli_facility | O vendedor envia seu estoque para os depósitos de Fulfillment do Mercado Livre. | Mercado Livre (Full) |
seller_warehouse | Múltiplas origens de estoque gerenciadas pelo vendedor. Permite ao vendedor configurar diferentes lojas ou localizações onde possui seu inventário. | usuário (vendedor) |
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.
Chamada:
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
}'
Resposta:
204
O estoque será atualizado de forma assíncrona em todas as condições de venda do user product:
Exemplo:
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.