Gestión de capacidad de envíos

El recurso /capacity_middleend permite al vendedor configurar su capacidad de procesamiento de pedidos diarios, ayudando a evitar retrasos de envios en casos de alta demanda.

Obtener capacidad actual

Para obtener la configuración de capacidad de un vendedor ejecute la siguiente llamada:

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": {
          "value": 120,
          "maximum": false
         },
         "next_capacity": {
          "value": 110,
          "maximum": false
         },
         "can_add_capacity": false,
         "can_subtract_capacity": true
      },
      {
         "day": "tuesday",
         "capacity_min":20,
         "capacity": {
          "value": 120,
          "maximum": false
         },
         "next_capacity": null,
         "can_add_capacity": true,
         "can_subtract_capacity": false
      },
      {
         "day": "wednesday",
         "capacity_min":20,
         "capacity": {
          "value": null,
          "maximum": true
         },
         "next_capacity": {
          "value": null,
          "maximum": false
         },
         "can_add_capacity": true,
         "can_subtract_capacity": false
      },
      {
         "day": "tuesday",
         "capacity_min":20,
         "capacity": {
          "value": 120,
          "maximum": false
         },
         "next_capacity": null,
         "can_add_capacity": true,
         "can_subtract_capacity": false
      },
      {
         "day": "friday",
         "capacity_min":20,
         "capacity": {
          "value": null,
          "maximum": true 
         },
         "next_capacity": null,
         "can_add_capacity": true,
         "can_subtract_capacity": false
      },
      {
         "day": "saturday",
         "capacity_min":20,
         "capacity": {
          "value": 120,
          "maximum": true
         },
         "next_capacity": null,
         "can_add_capacity": true,
         "can_subtract_capacity": false
      },
    ]
}

Parámetros de respuesta

• day (string): indica el día de la semana a la que aplica la configuración de capacidad.Los valores posibles son: monday, tuesday, wednesday, thursday, friday, saturday y sunday.
• capacity_min (uint): indica la capacidad mínima que un vendedor se puede configurar.
• capacity.value (int): indica la capacidad actual del vendedor para la semana en que se encuentra.
• capacity.maximum (bool): indica si el vendedor tiene seleccionada la capacidad infinita(false)/máxima(true). En caso de no tener next_capacity se devuelve un null para este campo.
• next_capacity.value (uint): indica la capacidad que tiene configurado el vendedor aplicable para la siguiente semana.
• next_capacity.maximum (uint): indica si la configuración de capacidad que aplica para la siguiente semana es la infinita/máxima.
• can_add_capacity (bool): indica si el vendedor puede incrementar su capacidad para ese dia.
• can_subtract_capacity (bool): indica si el vendedor puede restar su capacidad para ese día.

Actualizar capacidad de envíos

Para actualizar la configuración de capacidad del vendedor, es necesario ejecutar un PUT en el recurso /capacity_middleend, utilizando los campos como en el ejemplo a continuación:

Llamada:

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

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

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

Respuesta:

OK 200

Parámetros de respuesta

• day (string): indica el día de la capacidad a aplicar el cambio.
• capacity.value (uint): indica la capacidad que el vendedor se configuró.
• capacity.maximum (bool): indica si la capacidad que el vendedor se configuró es máxima.

Posibles respuestas:

200 - OK: la capacidad ha sido modificada exitosamente.

Manejo de errores:

Respuesta con error:

{
    "code": "not_found",
    "message": "not valid logistic type"
}

Posibles errores:

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