Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação

Última atualização em 11/01/2024

Gerenciamento de estoque em convivência Full e Flex

Importante:
O novo recurso só está produtivo para vendedores do Chile.
A ativação em novos sites será comunicada com antecedência.
MLA: Ativação por waves com as seguintes datas planejadas:
23/1: Wave 1: Sellers com último dígito do cust_id 0;
30/1: Wave 2: Sellers com último dígito do cust_id 1, 2 ou 3;
6/2: Wave 3: 100%.

Agora os vendedores 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.

Nota:
O rate limit deste recurso é de 100rpm.

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.
  • Quantity: quantidade de itens disponíveis para a venda.

  • 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

    Para começar a vender,é necessário informar o estoque do item em selling_address. Não é permitido modificar o estoque de Full. A conta do vendedor deve ter Flex ativado e o item deve ter estoque em Full.


    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