Shipment Preparation Time

The /processing_time_middleend resource allows the vendor to adjust their daily order fulfillment times and control the delivery times of two products, allowing efficient remittance management.

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' 'X-Version:v3' https://api.mercadolibre.com/shipping/users/$USER_ID/processing_time_middleend/$LOGISTIC_TYPE

Example:

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

Response:

{   
"monday": {
      "visible": true,
      "modified_by_meli" : true,
      "current_processing_time": null,
      "available_options": [
         {
            "processing_time": "01:00",
            "selected": false,
            "cutoff": "16:45",
            "highlight_level": "low",
            "start_milkrun_time": null,
            "end_milkrun_time": null,
            "maximum_time": "17:45",
            "disabled": true
         },
         {
          …
         },
         {
            "processing_time": "05:00",
            "selected": true,
            "cutoff": "12:45",
            "highlight_level": "high",
            "start_milkrun_time": null,
            "end_milkrun_time": null,
            "maximum_time": "17:45",
            "disabled": false
         },
     ]
    },
"tuesday": {...},
"wednesday": {...},
"thursday": {...},
"friday": {...},
"saturday": {...},
"sunday": {...},
}

Parameters

modified_by_meli: in case it comes true it indicates that Mercado Libre is responsible for modifying its processing time.
visible: indicates if the day should be displayed on the front.
enabled: Indicates whether the row is enabled for editing.
current_processing_time: Indicates the value of the processing time prior to the alteration. If it is different from null, the message that it will take effect for the next week will be displayed. If not, the day will be displayed normally.
available_options.processing_time: indicates the 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.highlight_level: the options are:

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

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' '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

Example:

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

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 01: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: Logistics dispatch schedule.