Gerenciamento de estoque em convivência Full e Flex

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.

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

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