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
Gerenciamento de estoque em convivência Full e Flex
Agora os vendedores do Chile e Argentina podem administrar o estoque em seu depósito e o estoque em Full separadamente, para ter uma melhor experiência que os ajude a realizar mais vendas e ter menos cancelamentos.
É importante considerar que para utilizar este recurso, deverá ter as formas de envio Flex e Fulfillment ativas, além de ter itens em estoque Full.
Este recurso, por agora, só deve ser usado para publicações que tenham a convivência Full e Flex ativados. Antes de utilizar este recurso, valide que a publicação tenha o logistic_type fulfillment e a tag self_service_in, estes dois campos indicam que a publicação está em convivência das duas logísticas.
Notificações
Em breve, disponibilizaremos as notificações do tópico stock_locations para quando os stock_locations do user_product forem modificados, seja aumentando ou diminuindo o campo quantity.
Obter o estoque de um item
Para consultar o estoque de um item, primeiro você deve obter o user_product_id. Para isso consulte o campo através do recurso de /items. Se o item tem variações, deverá obter o user_product_id no array variations.
Chamada:
curl -X GET -h 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/user-products/$USER_PRODUCT_ID/stock
Exemplo:
curl -X GET -h 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/user-products/MLAU12345678/stock
Resposta:
{
"locations":
[
{
"type": "meli_facility",
"quantity": 5
}
{
"type": "selling_address",
"quantity": 9
}
],
"id": "MLAU12345678",
"user_id": 1376088286
}
Campos da resposta:
- Type: permite diferenciar as locations do item.
- selling_address: estoque disponível no depósito do vendedor (Flex).
- meli_facility: estoque gerenciado por Fulfillment.
Ao consultar o endpoint, retornará um header chamado “x-version” no qual terá um valor inteiro (de tipo long) que representará a versão da entidade.
Este header deve ser enviado ao realizar modificações a entidades, caso não envie, retornará um bad request status code: 400 e caso a versão enviada não seja mais a última na entidade a modificar, será retornado um conflict status code: 409.
No caso de uma resposta com status code 409, você deve realizar novamente um GET a entidade a modificar, para obter a versão atualizada do header x-version.
Modificar o estoque de um item
Chamada:
curl -X PUT -h 'Authorization: Bearer $ACCESS_TOKEN' -h 'x-version:$HEADER -h 'Content-Type: application/json'
https://api.mercadolibre.com/user-products/$USER_PRODUCT_ID/stock/type/selling_address -d
{
"quantity": XX
}
Exemplo:
curl -X PUT -h 'Authorization: Bearer $ACCESS_TOKEN' -h 'x-version:$HEADER -h 'Content-Type: application/json'
https://api.mercadolibre.com/user-products/MLAU12345678/stock/type/selling_address -d
{
"quantity": 10
}
Resposta:
204 OK