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 06/07/2023

Tiempo de Preparación de envíos

El recurso /processing_time_middleend permite al vendedor ajustar sus tiempos de preparación de pedidos diarios y controlar los plazos para la entrega de productos, permitiendo una gestión eficiente de los envíos.


Consultar processing time por tipo logístico

El processing time es el tiempo mínimo que el pedido tiene para estar listo, desde la hora de la compra hasta el envío. Este recurso está disponible para los tipos logísticos cross_docking (Mercado Envíos Colecta) y xd_drop_off (Mercado Envíos Places). Además, todos los datos son obtenidos por cuenta, es decir, debes informar el user_id.


Importante:
Los vendedores que no cumplan con el processing time que fue configurado, tendrán sus tiempos ajustados por Mercado Libre de acuerdo con la performace del día en las semanas anteriores, es decir, por ejemplo que no esté performando bien el lunes aumentaremos el processing time para que se ajuste a la operación. En estos casos el campo modified_by_meli se mostrará en true. Vamos a considerar la performance de las últimas 4 semanas para bloquear los horarios o para liberar el envío en el caso de que el vendedor haya mejorado su operación.

Llamada:

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

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'X-Version:v3' https://api.mercadolibre.com/shipping/users/123456789/processing_time_middleend/cross_docking

Respuesta:

{
  "monday": {
     "modified_by_meli": false,
     "visible": true,
     "enabled": true,
     "current_processing_time": null
     "available_options": [
        {
          "processing_time": "00:30",
          "selected": false,
          "highlight_level": "low",
          "disabled": false
        },
        ...
        ...
        ...
        {
          "processing_time": "07:00",
          "selected": true,
          "highlight_level": "high",
          "disabled": false
        }
     ]
  }
Nota:
- modified_by_meli solo estará en true en la primera semana en que Mercado Libre hace el cambio después de la mala performance del vendedor. Después de la primera semana es necesario verificar si el campo disabled está como true.
- Es recomendable mantener las notificaciones de la iniciativa activas para poder estar alerta ante cualquier cambio.

Parámetros

modified_by_meli: en caso de que venga true indica que Mercado Libre es el responsable de modificar su processing time.
visible: indica si el día debe ser mostrado en el front.
enabled: Indica si la fila está habilitada para editar.
current_processing_time: indica el valor del processing time que se encontraba seleccionado antes del cambio. Si es distinto de null se mostrará el mensaje de que entrará en vigencia para la próxima semana. Si no, se mostrará el día normalmente.
available_options.processing_time: indica el tiempo de procesamiento posible a seleccionar en formato HH:MM. Por ejemplo, “00:30” (30 minutos).
available_options.selected: valor actual elegido por el usuario, o el default si es que nunca lo configuró antes.
available_options.highlight_level: las opciones son:

  • low: menos tiempo de preparación que el default
  • default: tiempo de preparación default
  • high: más tiempo de preparación que el default


Cambiar processing time por logística

Para las logísticas cross_docking (Mercado Envíos Coleta) y xd_drop_off (Mercado Envíos Places) puedes cambiar los tiempos de procesamiento, o sea el horario de corte para envío de los pedidos del mismo día.

Nota:
Ahora es posible actualizar el processing_time del día vigente, aunque se verá impactado en la semana siguiente. Para esto, es necesario utilizar el header X-Version:v3

Llamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' 'X-Version:v3' -d 
{
   "processing_times": {
       "monday": {
           "processing_time": $PROCESSING_TIME
           },
       "tuesday":{
           "processing_time": $PROCESSING_TIME
           },
       "wednesday":{
           "processing_time": $PROCESSING_TIME
           },
       "thursday":{
           "processing_time": $PROCESSING_TIME
           },
       "friday":{
           "processing_time": $PROCESSING_TIME
           },
       "saturday":{
           "processing_time": $PROCESSING_TIME
           },
   }
}
https://api.mercadolibre.com/shipping/users/$USER_ID/processing_time_middleend/$LOGISTIC_TYPE

Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' 'X-Version:v3' -d
{
    "processing_times": {
        "monday": {
            "processing_time": "01:00"
        },
        "tuesday": {
            "processing_time": "01:00"
        },
        "wednesday": {
            "processing_time": "01:00"
        },
        "thursday": {
            "processing_time": "01:30"
        },
        "friday": {
            "processing_time": "00:30"
        },
        "saturday": {
            "processing_time": "01:00"
        }
    }
}
https://api.mercadolibre.com/shipping/users/123456789/processing_time_middleend/cross_docking

Respuesta:

{
    "message": "The seller processing times were successfully saved"
}

Consideraciones

  • Enviar en el formato “01:00”, “00:30” como viene en el GET.
  • En caso de enviarse el campo processing_times vacío, la integración tomará los valores default dependiendo la logística 01:00 cross_docking y 01:30 xd_drop_off.
  • En caso de enviarse un día bloqueado, es decir, un día que esté en enabled false, la integración ignora este valor y deja el valor que tiene seleccionado antes del cambio.
  • La actualización del processing_time del día vigente solo va tener impacto en la próxima semana.

Conozca cuáles son los impactos y ventajas de cambiar el procecessing_time para las logísticas:


Conoce más sobre Qué es el tiempo de preparación
Conoce más sobre Para qué me sirve ajustarlo
Conoce más sobre Hasta cuándo puedo modificarlo en el día
Conoce más sobre Cómo lo modifico si tengo más de una colecta en el día
Conoce más sobre Por qué hay días con menos opciones de tiempo de preparación


Siguiente: Horarios de despacho por logística.