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 05/10/2023

Gestión de capacidad de envíos

Importante:
Actualmente, la funcionalidad está disponible solo para vendedores con Mercado Envíos Colecta (cross_docking) de Argentina, Brasil, México, Chile y Colombia.

La gestión de capacidad de envíos es una herramienta que permite a los vendedores configurar la cantidad máxima de envíos que pueden despachar en un día sin sufrir demoras. Esto les brinda la flexibilidad de organizarse y evitar retrasos, ya sea frente a cambios planificados en su volumen de ventas o situaciones inesperadas.
Conoce más sobre:

Asimismo, conoce como funciona Mercado Envíos Colecta (cross_docking) y qué es Mercado Envíos 2.



Obtener capacidad actual

Este endpoint permite obtener la configuración actual de la capacidad de envío de un usuario:


Llamada:

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

Ejemplo:

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

Respuesta:

{
   "capacities":[
       {
         "day": "monday",
         "capacity_min":20,
         "capacity_max": 140,
         "capacity": {
          "value": 120,
          "maximum": false
         },
         "next_capacity": {
          "value": 110,
          "maximum": false
         },
         "can_add_capacity": false,
         "can_subtract_capacity": true,
         "intervention" : "delay",
      },
      {
         "day": "tuesday",
         "capacity_min":20,
         "capacity_max": 140,
         "capacity": {
          "value": 120,
          "maximum": false
         },
         "next_capacity": null,
         "can_add_capacity": true,
         "can_subtract_capacity": false,
         "intervention" : "delay",
      },
      {
         "day": "wednesday",
         "capacity_min":20,
         "capacity_max": 140,
         "capacity": {
          "value": 140,
          "maximum": false
         },
         "next_capacity": null,
         "can_add_capacity": true,
         "can_subtract_capacity": false,
         "intervention" : "delay",
      },
      {
         "day": "thursday",
         "capacity_min":20,
         "capacity_max": 140,
         "capacity": {
          "value": 120,
          "maximum": false
         },
         "next_capacity": null,
         "can_add_capacity": true,
         "can_subtract_capacity": false,
         "intervention" : "delay",
      },
      {
         "day": "friday",
         "capacity_min":20,
         "capacity_max": 140,
         "capacity": {
          "value": 110,
          "maximum": false 
         },
         "next_capacity": null,
         "can_add_capacity": true,
         "can_subtract_capacity": false,
         "intervention" : "delay",
      },
      {
         "day": "saturday",
         "capacity_min":20,
         "capacity_max": 140,
         "capacity": {
          "value": 120,
          "maximum": true
         },
         "next_capacity": null,
         "can_add_capacity": true,
         "can_subtract_capacity": false,
         "intervention" : "delay",
      },
    ]
}

Parámetros de respuesta:

  • day: Representa el día de la semana al que se refiere la capacidad. Los valores posibles son monday, tuesday, wednesday, thursday, friday, y saturday.
  • capacity_min: Es el valor mínimo de capacidad permitido para ese día.
  • capacity_max: Es el valor máximo de capacidad permitido para ese día.
  • capacity.value: Es el valor de la capacidad actual para el día y semana en la que se encuentra el usuario.
  • capacity.maximum: Indica si el usuario tiene seleccionado la capacidad infinita(false) / máxima(true). En caso de no tener next_capacity se devuelve un null para este campo.
  • next_capacity.value: Es el valor de la capacidad configurada aplicable para la siguiente semana.
  • next_capacity.maximum: Indica si el usuario tiene seleccionado la capacidad infinita(false) / máxima(true) para la siguiente semana.
  • can_add_capacity: Indica si es posible agregar capacidad adicional para ese día. Los posibles valores son true o false.
  • can_subtract_capacity: Indica si es posible restar capacidad para ese día. Los posibles valores son true o false.
  • intervention: Describe el tipo de intervención en el que pueda incurrir el usuario:
    • delay: intervención por demoras.
    • null: no tiene intervención.

Códigos de estado de respuesta

Código Mensaje Descripción Recomendación
200 - OK - Se obtuvo correctamente la configuración actual. -
404 - Not Found not valid logistic type No existe el usuario o no tiene la logística de cross_docking. Validar el user_id y los tipos de logística del usuario.
Notas:
- Si no se configura la capacidad de despacho, el sistema no impondrá restricciones. Sin embargo, se recomienda a los vendedores que utilicen esta función para optimizar sus entregas y mejorar la experiencia del cliente.
- Cuando un vendedor no cumple con su objetivo de capacidad de envíos, entra en un estado de intervención. Durante este período, hay restricciones en la capacidad de modificar o actualizar la capacidad de envíos. Esto se hace para garantizar que los vendedores se comprometan a mejorar su rendimiento.Una vez que se cumplan los requisitos durante el período de intervención, se levantarán las restricciones y podrás volver a ajustar tu capacidad de envíos.


Actualizar capacidad de envíos

Este endpoint permite actualizar o modificar la configuración actual de capacidad de envío del usuario.


Llamada:

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

Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/419059119/capacity_middleend/cross_docking

   {
      "capacities": [
         {  
            "day": "monday",
            "capacity": {
             "value": 120,
             "maximum": false
            },
         },
         {  
            "day": "tuesday",
            "capacity": {
             "value": 120,
             "maximum": false
            },
         },
         {  
            "day": "wednesday",
            "capacity": {
             "value": 120,
             "maximum": false
            },
         },
         {  
            "day": "tuesday",
            "capacity": {
             "value": 120,
             "maximum": false
            },
         },
         {  
            "day": "friday",
            "capacity": {
             "value": 120,
             "maximum": true
            },
         },
         {  
            "day": "saturday",
            "capacity": {
             "value": 120,
             "maximum": false
            },
         },          
      ]
   }'

Códigos de estado de respuesta

Código Mensaje Descripción Recomendación
200 - OK - Se obtuvo correctamente la configuración actual. -
400 - Bad Request there was an error parsing the request body Error en los parámetros del request body. Validar el request body.
404 - Not Found not valid logistic type No existe el usuario o no tiene la logística de cross_docking. Validar el user_id y los tipos de logística del usuario.