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.

Tipos de estoque

Para a gestão do estoque, definimos as três tipologias seguintes de stock_locations:

Location type	Caso de uso	Gestor do estoque	Permite editar estoque via API
meli_facility	O vendedor envia seu estoque para os depósitos de Fulfillment do Mercado Livre.	Mercado Livre (Full)	Não.
selling_address	Depósito de origem do vendedor que representa as logísticas que não são fulfillment, tais como: crossdocking, xd_drop_off e flex.	Usuário (Vendedor)	Sim, nos sites onde a experiência de estoque distribuído full e flex está ativada, ou seja, em MLA e MLC.
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)	Sim, desde que o vendedor tenha pelo menos um depósito configurado e a experiência Multi Origem ativada.

Diagrama de exemplo de estoque distribuído para um User Product com Convivência Full - Flex em sites onde o vendedor pode gerenciar o estoque de Flex:

Diagrama de exemplo de estoque distribuído para um vendedor ativo em multiorigem e um User Product com estoque em diferentes locais:

Obter detalhe de estoque

Tenha em mente que um mesmo UP pode ter até duas tipologias, seja (selling_address e meli_facility) ou (seller_warehouse e meli_facility).

Para consultar o estoque associado a um Produto do Usuário, você deve fazer a seguinte requisição.

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/MLAU123456789/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": "MLAU123456789"
}

Considerações:

• Ao consultar os detalhes do estoque, será retornado um header chamado x-version, que terá um valor inteiro (do tipo long) que representará a versão atual de /stock/.
• Esse header deve ser enviado ao utilizar recursos que modifiquem o estoque dos User Products (PUT /stock/type/selling_address e PUT /stock/type/seller_warehouse).
• Se não for enviado, retornará um bad request (status code: 400).
• Adicionalmente, caso a versão enviada não seja a mais recente, será retornado um conflito (status code: 409).
• No caso de uma resposta com código 409, você deve consultar novamente o estoque para obter a versão atualizada do header x-version.

Gerir estoque

A gestão e atualização de estoque varia de acordo com a configuração do vendedor e a convivência entre os modelos logísticos. A seguir, são descritos os diferentes cenários e as recomendações para atualizar o estoque de forma adequada:

• Estoque em uma única localização do vendedor (sem distribuição):

  Deve-se utilizar o método PUT no endpoint /items para atualizar o estoque em available_quantity. Nesse caso, o Mercado Livre sincronizará automaticamente o estoque de todos os itens associados ao mesmo user_product_id.

• Stock com convivencia Full/Flex (localizações: meli_facility y selling_address):
  • Stock distribuído (aplica a MLA e MLC):

    Os vendedores podem gerenciar de forma independente o estoque de Full e Flex. Para isso, devem atualizar o estoque através do endpoint:

    PUT user-products/stock/type/selling_address

    Para mais detalhes, consulte a documentação: Gestão de estoque em convivência Full e Flex.

  • Sem estoque distribuído (Demais sites que operam com Full e Flex):

    Nestes casos, os vendedores não têm a possibilidade de atualizar o estoque de Flex de forma independente.

• Estoque em múltiplas localizações do vendedor (Multi Origem):

  Os vendedores habilitados para Multi Origem devem atualizar o estoque através do endpoint:

  PUT /user-products/$USER_PRODUCT_ID/stock/type/seller_warehouse

  Para mais informações, consulte a documentação: Gestão de estoque por localização.

Próxima documentação: Estoque multi-origem.