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 08/08/2023

Gestión de capacidad de envíos

Importante:
Actualmente, la funcionalidad está disponible solo para vendedores con Mercado Envíos Colecta (cross_docking).

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.

Nota:
- 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.


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:

Status Error Code Descripción
400 Bad request Parámetro inválido o que se configure una capacidad por debajo del mínimo que indica en el GET.
404 Not_found No tenga la logística que envía en los parámetros o sea un usuario que no existe.


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