Last update 07/06/2022

Logistics dispatch schedule

The /schedule resource allows you get the dispatch times that the seller needs, to avoid delays and impact on their reputation. To consult this information, you must know the types of logistics enabled in your account.



Check dispatch schedule

Get the services data when the dispatch is the responsibility of the seller and they are part of ME2 with the parameters:
user_id: user ID.
logistic_type: Logistic type. You can use:

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

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

    Example:

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

    Response:

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

    Response fields

    seller_id: seller id.
    work: indicates if seller works that day. Applies to all logistics. It does not take into account holidays.
    from: in cross_docking is the start time of the harvest window. In xd_drop_off is the maximum dispatch time.
    to: in cross_docking is the end of the harvest window.
    cutoff: cut-off time.
    carrier.id: in cross_docking is the carrier Id.
    carrier.name: in cross_docking is the carrier name.
    vehicle: in cross_docking is the vehicle description.
    vehicle.id: in cross_docking is the vehicle ID.
    vehicle.license_plate: in cross_docking is the plate license vehicle
    vehicle.only_for_today: in cross_docking is if the collect is only for today.
    vehicle.new_driver: in cross_docking if there was a change in the driver that will happen.
    driver.id: in cross_docking is the driver ID of the collect.
    driver.name: in cross_docking is the driver name of the collect.
    sla:

    drop_off, Flex:

    “same_day”: on day

    “monday”

    “tuesday"

    “wednesday”

    “thursday”

    “friday”

    “satuday”

    “sunday”


    Errors

    Error Description
    403 (Forbidden) The user is trying to access the information of another.
    404 (not found) The user wants to access the information of a logistics that he does not have.

    Get processing time by logistic type

    The processing time is the minimum time that the order has to be ready, from the time of purchase to shipment. This resource is available for the logistics types cross_docking (Mercado Envíos Colecta) and xd_drop_off (Mercado Envíos Places). In addition, all the data is obtained by account, that is, you must inform the user_id.

    Request:

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

    Example:

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

    Response:

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

    Parameters

    visible: indicates if the day should be displayed on the front.
    available_options.processing_time: Possible processing time to be selected in HH: MM format. For example, “00:30” (30 minutes).
    available_options.selected: current value chosen by the user, or the default if you have never set it before.
    available_options.cutoff: cut-off time value in HH:MM format if that option is chosen. For example, "10:30". In cross_docking, it is calculated by subtracting the chosen processing time from the lower bound of the last collection. In xd_drop_off is calculated by subtracting the chosen processing time from the maximum dispatch time.
    available_options.highlight_level: the options are:

    • low: less setup time than default
    • default: default preparation time
    • high: more preparation time than default

    available_options.start_milkrun_time: indicates the value of the hour of the lower limit of the last collection in HH:MM format if that option is chosen. For example, "10:30" applies only to cross_docking. For Saturday, it can take a null value if you do not have schedules configured.
    available_options.maximum_time: indicates the value of the maximum dispatch time HH: MM if that option is chosen. For example, "10:30" applies only to xd_drop_off.
    enabled: indicates whether the row is enabled for editing.



    Edit processing time by logistic type

    For ligistic types cross_docking (Mercado Envíos Coleta) and xd_drop_off (Mercado Envíos Places) you can change the processing times, that is, the cut-off time for shipping orders on the same day.

    Request:

    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

    Example:

    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

    Response:

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

    Considerations

    • Send in the format "01:00", "00:30" as it comes in the GET.
    • If the processing_times field is sent empty, the integration will take the default values depending on the logistics 01:00 cross_docking and 02:30 xd_drop_off.
    • In case of sending a blocked day, that is, a day that is enabled false, the integration ignores this value and leaves the value selected before the change.

    Next: Free shipping.

banner footer

Subscribe to our Newletter

or register to recieve the latest news about our API