Estoque Multi Origem

Nesta documentação, você encontrará informações importantes para cada um dos fluxos que serão impactados por esta iniciativa, começando por:

• Gestão de vendedores.
• Publicação de item com estoque multi origem
• Gestão de estoque por depósito

Identificar vendedor Multi-Warehouse

Para identificar que o usuário tem a funcionalidade ativada em sua conta, utilizaremos o tag "warehouse_management" em /users.

Chamada:

curl -X GET https://api.mercadolibre.com/users/$USER_ID -H 'Authorization: Bearer $ACCESS_TOKEN'

Exemplo:

curl -X GET https://api.mercadolibre.com/users/1008002397 -H 'Authorization: Bearer $ACCESS_TOKEN'

Resposta:

{
  "id": 1008002397,
  "nickname": "TETE9326760",
  "registration_date": "2021-10-27T14:48:55.000-04:00",
  "first_name": "Test",
  "last_name": "Test",
  "gender": "",
  "country_id": "MX",
  ...
  "tags": [
    "normal",
    "user_product_seller",
    "warehouse_management",
    "mshops"
  ],
  ...
}

Gestão de depósitos

Busca de depósitos (stores) de um usuário

Para identificar os depósitos criados por cada usuário, você deve utilizar o seguinte endpoint:

Chamada:

curl -X GET https://api.mercadolibre.com/users/$USER_ID/stores/search?tags=stock_location -H 'Authorization: Bearer $ACCESS_TOKEN'

Exemplo:

curl -X GET https://api.mercadolibre.com/users/1008002397/stores/search?tags=stock_location -H 'Authorization: Bearer $ACCESS_TOKEN'

Resposta:

{
    "paging": {
        "limit": 50,
        "total": 2
    },
    "results": [
        {
            "id": "100",
            "user_id": "200",
            "description": "my store",
            "status": "active",
            "location": {
                "address_id": 501,
                "address_line": "Calle 31 Pte 260",
                "street_name": "Calle 31 Pte",
                "street_number": 260,
                "latitude": 21.1637963,
                "longitude": -86.8737132,
                "city": "Cancún/Benito Juárez",
                "state": "Quintana Roo",
                "country": "Mexico",
                "zip_code": "77518"
            },
            "tags": ["stock_location"],
            "network_node_id": "123451"
        },
        {
            "id": "101",
            "user_id": "200",
            "description": "my store 2",
            "status": "active",
            "location": {
                "address_id": 502,
                "address_line": "Calle 30 Pte 300",
                "street_name": "Calle 30 Pte",
                "street_number": 300,
                "latitude": 21.1637963,
                "longitude": -86.8737132,
                "city": "Cancún/Benito Juárez",
                "state": "Quintana Roo",
                "country": "Mexico",
                "zip_code": "77518"
            },
            "tags": ["stock_location"],
            "network_node_id": "571615"
        }
    ]
}

Criação de itens Multi-Armazém

A nova estrutura do Item, com seu User Product e as Localizações de Estoque estará no seguinte formato:

Onde o User Product agrupará todos os itens que coincidam, baseado nas regras de UP, mas agora também terá a entidade Stock_Location para agrupar o estoque dos itens, podendo identificar a quantidade disponível em cada depósito (store).

Para a criação de novos itens com estoque atribuído aos depósitos, tanto tradicionais quanto de catálogo nos vendedores com a tag "warehouse_management", você deve utilizar o seguinte recurso:

Chamada:

curl POST --'https://api.mercadolibre.com/items/multiwarehouse' -H 'Content-Type: application/json' -H 'Authorization: Bearer $ACCESS_TOKEN' -d 
    {
        "title": "Item Lata de tomate ",
        "category_id": "MLB455668",
        "price": 1000,
        "listing_type_id": "gold_special",
        "currency_id": "ARS",
        ...
        "channels": [
            "marketplace"
        ],
        "stock_locations": [
       {
        "store_id": "123456",
          "network_node_id": "123451",
          "quantity": 10
       }
       ...
    ] 
    }

Resposta:

{
    "id": "MLM2198240631",
    "site_id": "MLM",
    "title": "Item Lata De Tomate",
    "seller_id": 123456789,
    "category_id": "MLM191212",
    "user_product_id": "MLMU123456789",
    "price": 1000,
    "base_price": 1000,
    ...
    "channels": [
        "marketplace"
    ],
    "stock_locations": [
        {
            "store_id": "123456",
            "quantity": 10,
            "network_node_id": "MXP123451"
        }
    ]
 } 
    

Códigos de Estado de resposta:

Considerações:

• Tanto o store_id quanto o network_node_id estarão na resposta da busca pelas lojas do vendedor.
• Após a publicação, não será mais possível encontrar stock_location na requisição do Item, devendo começar a utilizar o recurso de consulta de estoque de user_product.
• Você deve salvar o user_product_id da resposta que será utilizado posteriormente para a gestão de estoque.

Consultar detalhes de estoque depósitos (User Products)

Para consultar o estoque dos depósitos, utilize o seguinte endpoint indicando o user_product_id do item criado.

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/MLMU123456789/stock -H 'Authorization: Bearer $ACCESS_TOKEN'

Resposta:

{ "locations": [ { "type": "seller_warehouse", "network_node_id": "123451", "store_id": "9876543", "quantity": 15 }, { "type": "seller_warehouse", "network_node_id": "571615", "store_id": "9876553", "quantity": 25 } ], "user_id": 1234, "id": "MLMU123456789" }

Gestão de estoque por localização

Para modificar o estoque de cada depósito, você deve ter previamente o user_product_id, o store_id e o network_node_id.

O seguinte PUT mudará o estoque atual de cada depósito (store). No caso de a loja ter estoque 0, será atribuída a quantidade do PUT.

Chamada:

curl -X PUT https://api.mercadolibre.com/user-products/$USER_PRODUCT_ID/stock/type/seller_warehouse -H 'x-version: $HEADER' -H 'Content-Type: application/json' -H 'Authorization: Bearer $ACCESS_TOKEN'

Exemplo:

curl -X PUT https://api.mercadolibre.com/user-products/MLMU123456789/stock/type/seller_warehouse -H 'x-version: 1' -H 'Content-Type: application/json' -H 'Authorization: Bearer $ACCESS_TOKEN' -d ' { "locations": [ { "store_id": "123456", "network_node_id": "MXP123451", //o campo network_node_id é opcional e não é validado na requisição "quantity": 10 }, { "store_id": "123457", "network_node_id": "MXP571615", "quantity": 5 }, { "store_id": "123458", "network_node_id": "MXP725258", "quantity": 20 } ] }

Resposta:

{
"user_id": 123456789,
"product_release_date": null,
"id": "MLMU123456789",
"locations": [
    {
        "store_id": "123456",
        "network_node_id": "MXP123451",
        "type": "seller_warehouse",
        "quantity": 10
    },
    {
        "store_id": "123457",
        "network_node_id": "MXP571615",
        "type": "seller_warehouse",
        "quantity": 5
    },
    {
        "store_id": "123458",
        "network_node_id": "MXP725258",
        "type": "seller_warehouse",
        "quantity": 20
    }
]
}

Códigos de Estado de resposta:

Próxima documentação: Estoque distribuído