Gerenciamento de estoque em convivência Full e Flex (MLA e MLC)

Agora, para Argentina e no Chile, em itens com convivência Full e Flex, os vendedores podem gerenciar o estoque em seu depósito (selling_address) e o estoque em Full (meli_facility) de forma separada, proporcionando uma melhor experiência que os ajude a ter mais vendas e 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.

É importante ter em mente que, para utilizar o recurso de atualização de estoque, além de possuir itens em estoque Full, você deve ter as formas de envio Flex e Fulfillment ativas Para confirmar isso, verifique se a publicação possui o logistic_type fulfillment e a tag self_service_in, pois esses dois campos indicam que a publicação está operando na convivência de ambas as 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
}

Códigos de estado de resposta: