Tempo de Preparação de envios

O recurso /processing_time_middleend permite que o vendedor ajuste seus tempos diários de atendimento de pedidos e controle os prazos de entrega dos produtos, permitindo uma gestão eficiente de remessas.

Consultar processing time por tipo logístico

O processing_time é o tempo mínimo que o pedido leva pra ficar pronto, desde a hora da compra até o envio, e está disponível apenas para os tipos logísticos cross_docking (Mercado Envios Coleta) e xd_drop_off (Mercado Envios Places). Além disso, todos os dados são obtidos por conta, por isso é necessário informar o user_id.

Chamada:

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

Exemplo:

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

Resposta:

{   
"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": {...},
}

Parâmetros

modified_by_meli: caso seja true indica que o Mercado Livre é responsável por modificar seu processing time.
visible: indica se o dia deve ser mostrado no front.
enabled: Indica se a linha está habilitada para edição.
current_processing_time: Indica o valor do processing time anterior a alteração. Se for diferente de nulo, será exibida a mensagem de que valerá para a próxima semana. Caso contrário, o dia será exibido normalmente.
available_options.processing_time: tempo de processamento possível no formato HH:MM. Por exemplo, “00:30” (30 minutos).
available_options.selected: valor atual configurado pelo usuário, ou o default se nunca foi alterado.
available_options.highlight_level: as opções são:

• low: menos tempo de preparação que o default
• default: tempo de preparação default
• high: mais tempo de preparação que o default

Alterar processing time por logística

Para as logisticas cross_docking (Mercado Envíos Coleta) e xd_drop_off (Mercado Envíos Places) é possível alterar os tempos de processamento, ou seja, o horário de corte para envio de pedidos do mesmo dia.

Chamada:

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

Exemplo:

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

Resposta:

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

Considerações

• Enviar o processing_time no formato “01:00”, “00:30” como vem no GET.
• Caso envie o campo processing_times vazio, a integração seguirá com os valores default, dependendo da logística: 01:00 cross_docking e 01:30 xd_drop_off.
• Caso envie um dia bloqueado, ou seja, um dia que esteja como enabled false, a integração ignora este valor e deixa o valor que foi seleccionado antes da alteração.
• A atualização do processing_time do dia vigente terá impacto apenas na semana seguinte.

Saiba quais são os impactos e vantagens da alteração do processing_time para logística:

• Argentina: cross_docking (Mercado Envios Coleta) e xd_drop_off (Mercado Envios Places).
• México: cross_docking (Mercado Envios Coleta) e xd_drop_off (Mercado Envios Places).
• Colômbia: cross_docking (Mercado Envios Coleta) e xd_drop_off (Mercado Envios Places).
• Chile: cross_docking (Mercado Envios Coleta) e xd_drop_off (Mercado Envios Places).
• Brasil: cross_docking (Mercado Envios Coleta) e xd_drop_off (Mercado Envios Places).

Conheça mais sobre O que é o Tempo de preparação
Conheça mais sobre Qual é o objetivo de ajustar meu tempo de preparação
Conheça mais sobre Até quando posso alterá-lo no mesmo dia
Conheça mais sobre Como faço a alteração se eu tiver mais de uma coleta no mesmo dia
Conheça mais sobre Por que tenho menos opções de tempo de preparação em alguns dias?

Seguinte: Horários de despacho por logística.