Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 26/09/2024

Gestión de stock en convivencia Full y Flex

Importante:
A partir de agosto 2024, en items sin variantes , es posible modificar el stock de Flex en selling_address, independiente del stock en Full

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.

Nota:
El rate limit de este recurso es de 100 RPM.

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.
  • Quantity: cantidad de ítems disponibles para la venta.

  • 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

    Nota:
    - Para empezar a vender, es necesario que se informe el stock del ítem en selling_address
    - La cuenta del vendedor debe tener Flex encendido y el ítem debe estar también en Full
    - En items sin variantes, es posible modificar el stock de Flex en selling_address, independiente del stock en Full
    - En items con variantes, únicamente es posible modificar el stock de Flex en selling_address cuando la variación del ítem a modificar cuente con stock en Full

    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.