Gestión de stock en convivencia Full y Flex

Ahora los vendedores de Chile y Argentina pueden administrar el stock en su depósito y el stock en Full por separado, para tener una mejor experiencia que los ayude a tener más ventas y menos cancelaciones.

Es importante tener en cuenta que para utilizar este recurso, debes tener las formas de envío Flex y Fulfillment activos, además de tener ítems en stock Full.

Este recurso, por ahora, solo debe ser utilizado para publicaciones que tengan activadas las opciones de convivencia Full y Flex. Antes de utilizar este recurso, valide que la publicación tenga el logistic_type fulfillment y la tag self_service_in, ya que estos dos campos indican que la publicación está en convivencia de ambas logísticas.

Notificaciones

Próximamente, disponibilizaremos el tópico stock_locations notificaciones para cuando se modifiquen las stock_locations del user_product, ya sea por incremento o decremento el campo quantity.

Obtener el stock de un ítem

Para consultar el stock del ítem, primero debes obtener el user_product_id. Para esto consulta el campo a través del recurso de /ítems. Si el ítem tiene variaciones, se debe obtener el user_product_id dentro del array variations.

Llamada:

curl -X GET -h 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/user-products/$USER_PRODUCT_ID/stock

Ejemplo:

curl -X GET -h 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/user-products/MLAU12345678/stock

Respuesta:

{
    "locations":
    [
        {
            "type": "meli_facility",
            "quantity": 5
        }
        {
            "type": "selling_address",
            "quantity": 9
        }

    ],
    "id": "MLAU12345678",
    "user_id": 1376088286
}

Campos de la repuesta:

• Type: permite diferenciar las locations del ítem.

• selling_address: stock disponible en el depósito del vendedor (Flex).
• meli_facility: stock gestionado por Fulfillment.

Al consultar el endpoint, retornará un header llamado “x-version” el cual tendrá un valor entero (de tipo long) que representará la versión de la entidad.
Este header debe ser enviado a la hora de realizar modificaciones a las entidades, en caso de no ser enviado se retornará un bad request status code: 400 y en caso de que la versión enviada no sea más la última en la entidad a modificar, se retornará un conflict status code: 409.
En el caso de una respuesta con status code 409, se debe realizar nuevamente un GET a la entidad a modificar, para obtener la versión actualizada del header x-version.

Modificar el stock de un ítem

Llamada:

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
}

Ejemplo:

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
}

Respuesta:

204 OK

Posibles errores

400: formato incorreto / em itens com variantes não é possível editar estoque de flex quando o estoque de full é zero.
403: token inválido ou falta de permissões sobre o item.