Horarios de despacho por logística

El recurso /schedule te permite obtener los horarios de despacho que el vendedor necesita, para evitar retrasos e impacto en su reputación. Para consultar esta información, debes conocer los tipos de logísticas habilitadas en su cuenta.



Contenidos

→Consultar horarios de despacho
    ↳Errores
→Consultar processing time por tipo logístico
→Cambiar processing time por logística
    ↳Consideraciones


Consultar horarios de despacho

Obtén los datos de los servicios cuando el despacho sea por el vendedor (ME2). Utiliza los parámetros:
user_id: Id del usuario.
logistic_type: Tipo de envío:

  • drop_off: Mercado Envíos
  • xd_drop_off: Mercado Envíos Places
  • self_service: Mercado Envíos Flex
  • cross_docking: Mercado Envíos Colecta
  • Llamada:

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

    Ejemplo:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/9984538542/shipping/schedule/cross_docking

    Respuesta:

    {
       "seller_id": "84538542",
       "schedule": {
           "monday": {
               "work": true,
               "detail": [
                   {
                       "from": "13:00",
                       "to": "15:00",
                       "cutoff": "12:00",
                       "carrier": {
                           "id": "17501840",
                           "name": "Iflow"
                       },
                       "vehicle": {
                           "id": "12345",
                           "license_plate": "AZ541VW",
                           "vehicle_type": "Camioneta",
                           "only_for_today": false,
                           "new_driver": false
                       },
                       "driver": {
                           "id": "12345",
                           "name": "Test User"
                       },
                       "sla": ""
                   }
               ]
           },
           "tuesday": {
               "work": true,
               "detail": [
                   {
                       "from": "13:00",
                       "to": "15:00",
                       "cutoff": "12:00",
                       "carrier": {
                           "id": "17501840",
                           "name": "Iflow"
                       },
                       "vehicle": {
                           "id": "12345",
                           "license_plate": "AZ541VW",
                           "vehicle_type": "Camioneta",
                           "only_for_today": false,
                           "new_driver": false
                       },
                       "driver": {
                           "id": "12345",
                           "name": "Test User"
                       },
                       "sla": ""
                   }
               ]
           },
           "wednesday": {
               "work": true,
               "detail": [
                   {
                       "from": "13:00",
                       "to": "15:00",
                       "cutoff": "12:00",
                       "carrier": {
                           "id": "17501840",
                           "name": "Iflow"
                       },
                       "vehicle": {
                           "id": "12345",
                           "license_plate": "AZ541VW",
                           "vehicle_type": "Camioneta",
                           "only_for_today": false,
                           "new_driver": false
                       },
                       "driver": {
                           "id": "12345",
                           "name": "Test User"
                       },
                       "sla": ""
                   }
               ]
           },
           "thursday": {
               "work": true,
               "detail": [
                   {
                       "from": "13:00",
                       "to": "15:00",
                       "cutoff": "12:00",
                       "carrier": {
                           "id": "17501840",
                           "name": "Iflow"
                       },
                       "vehicle": {
                           "id": "12345",
                           "license_plate": "AZ541VW",
                           "vehicle_type": "Camioneta",
                           "only_for_today": false,
                           "new_driver": false
                       },
                       "driver": {
                           "id": "12345",
                           "name": "User de prueba"
                       },
                       "sla": ""
                   }
               ]
           },
           "friday": {
               "work": true,
               "detail": [
                   {
                       "from": "13:00",
                       "to": "15:00",
                       "cutoff": "12:00",
                       "carrier": {
                           "id": "17578840",
                           "name": "Iflow"
                       },
                       "vehicle": {
                           "id": "12345",
                           "license_plate": "AZ541VW",
                           "vehicle_type": "Camioneta",
                           "only_for_today": false,
                           "new_driver": false
                       },
                       "driver": {
                           "id": "12345",
                           "name": "Test User"
                       },
                       "sla": ""
                   }
               ]
           },
           "saturday": {
               "work": false,
               "detail": null
           },
           "sunday": {
               "work": false,
               "detail": null
           }
       }
    }

    Campos de respuesta

    seller_id: id del vendedor.
    work: indica si el vendedor trabaja ese día. Aplica a todas las logísticas. No tiene en cuenta los feriados.
    from: para cross_docking es el horario de inicio de la ventana de recolección. Para xd_drop_off es el horario máximo de despacho.
    to: para cross_docking es el horario de fin de ventana de recolección.
    cutoff: horario de corte.
    carrier.id: para cross_docking es Id del carrier.
    carrier.name: para cross_docking es el nombre del carrier.
    vehicle: para cross_docking es la descripción del vehículo.
    vehicle.id: para cross_docking es el ID del vehículo.
    vehicle.license_plate: para cross_docking es la patente del vehículo.
    vehicle.only_for_today: para cross_docking es si la colecta es solo por el día de hoy.
    vehicle.new_driver: para cross_docking si hubo un cambio en el conductor que pasará.
    driver.id: para cross_docking es el ID del conductor de la colecta.
    driver.name: para cross_docking es el nombre del conductor de la colecta.
    sla:

    drop_off, Flex:

    “same_day”: En el día

    “monday”: lunes

    “tuesday”: martes

    “wednesday”: miércoles

    “thursday”:jueves

    “friday”: viernes

    “satuday”: sábado

    “sunday”: domingo


    Errores

    Error Descripción
    403 (Forbidden) El usuario está intentando acceder a la información de otro.
    404 (not found) El usuario quiere acceder a la información de una logística que no posee.

    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.

    Llamada:

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

    Ejemplo:

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

    Respuesta:

    {
       "monday": {
           "visible": true,
           "available_options": [
               {
                   "processing_time": "00:30",
                   "selected": false,
                   "cutoff": "11:30",
                   "highlight_level": "low",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               },
               {
                   "processing_time": "01:00",
                   "selected": true,
                   "cutoff": "11:00",
                   "highlight_level": "default",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               },
               {
                   "processing_time": "01:30",
                   "selected": false,
                   "cutoff": "10:30",
                   "highlight_level": "high",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               },
               {
                   "processing_time": "02:00",
                   "selected": false,
                   "cutoff": "10:00",
                   "highlight_level": "high",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               }
           ],
           "enabled": true
       },
       "tuesday": {
           "visible": true,
           "available_options": [
               {
                   "processing_time": "00:30",
                   "selected": true,
                   "cutoff": "11:30",
                   "highlight_level": "low",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               },
               {
                   "processing_time": "01:00",
                   "selected": false,
                   "cutoff": "11:00",
                   "highlight_level": "default",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               },
               {
                   "processing_time": "01:30",
                   "selected": false,
                   "cutoff": "10:30",
                   "highlight_level": "high",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               },
               {
                   "processing_time": "02:00",
                   "selected": false,
                   "cutoff": "10:00",
                   "highlight_level": "high",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               }
           ],
           "enabled": false
       },
       "wednesday": {
           "visible": true,
           "available_options": [
               {
                   "processing_time": "00:30",
                   "selected": false,
                   "cutoff": "11:30",
                   "highlight_level": "low",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               },
               {
                   "processing_time": "01:00",
                   "selected": false,
                   "cutoff": "11:00",
                   "highlight_level": "default",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               },
               {
                   "processing_time": "01:30",
                   "selected": false,
                   "cutoff": "10:30",
                   "highlight_level": "high",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               },
               {
                   "processing_time": "02:00",
                   "selected": true,
                   "cutoff": "10:00",
                   "highlight_level": "high",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               }
           ],
           "enabled": true
       },
       "thursday": {
           "visible": true,
           "available_options": [
               {
                   "processing_time": "00:30",
                   "selected": false,
                   "cutoff": "11:30",
                   "highlight_level": "low",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               },
               {
                   "processing_time": "01:00",
                   "selected": false,
                   "cutoff": "11:00",
                   "highlight_level": "default",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               },
               {
                   "processing_time": "01:30",
                   "selected": true,
                   "cutoff": "10:30",
                   "highlight_level": "high",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               },
               {
                   "processing_time": "02:00",
                   "selected": false,
                   "cutoff": "10:00",
                   "highlight_level": "high",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               }
           ],
           "enabled": true
       },
       "friday": {
           "visible": true,
           "available_options": [
               {
                   "processing_time": "00:30",
                   "selected": false,
                   "cutoff": "11:30",
                   "highlight_level": "low",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               },
               {
                   "processing_time": "01:00",
                   "selected": true,
                   "cutoff": "11:00",
                   "highlight_level": "default",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               },
               {
                   "processing_time": "01:30",
                   "selected": false,
                   "cutoff": "10:30",
                   "highlight_level": "high",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               },
               {
                   "processing_time": "02:00",
                   "selected": false,
                   "cutoff": "10:00",
                   "highlight_level": "high",
                   "start_milkrun_time": "12:00",
                   "end_milkrun_time": "14:00",
                   "maximum_time": null
               }
           ],
           "enabled": true
       },
       "saturday": {
           "visible": false,
           "available_options": null,
           "enabled": false
       },
       "sunday": {
           "visible": false,
           "available_options": null,
           "enabled": false
       }
    }

    Parámetros

    visible: indica si el día debe ser mostrado en el front.
    available_options.processing_time: 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.cutoff: valor del horario de corte en formato HH:MM si se eligiese esa opción. Por ejemplo, “10:30”. En cross_docking se calcula restándole a la cota inferior de la última colecta el tiempo de procesamiento elegido. En xd_drop_off se calcula restándole al tiempo máximo de despacho el tiempo de procesamiento elegido.
    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

    available_options.start_milkrun_time: indica el valor del horario de la cota inferior de la última colecta en formato HH:MM si se eligiese esa opción. Por ejemplo, "10:30" aplica solo para cross_docking. Para el sábado, puede tomar valor nulo si no tiene horarios configurados.
    available_options.maximum_time: indica el valor del tiempo máximo de despacho HH:MM si se eligiese esa opción. Por ejemplo, “10:30" aplica solo para xd_drop_off.
    enabled: indica si la fila está habilitada para editar.



    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.

    Llamada:

    curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -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' -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 02: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.

    Siguiente: Envío gratis.

o regístrate para recibir las últimas novedades sobre nuestra API