Gestión de capacidad de envíos

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:

• Qué es mi capacidad de envíos y para qué me sirve.
• Qué pasa cuando supero mi capacidad.
• Hasta cuándo puedo modificarla.
• Cómo la modifico si tengo más de una colecta en el día.
• Qué es mi capacidad mínima.
• Cómo finalizar colectas con mi código.

Asimismo, conoce como funciona Mercado Envíos Colecta (cross_docking), Mercado Envíos Places (xd_drop_off) 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 con intervención delay:

{
   "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",
      },
    ]
}

Respuesta con intervención early:

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

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.
• early: intervención por entregas tempranas.
• null: no tiene intervención.

Códigos de estado de respuesta

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