Envios Coletas e Places

Coleta regular (cross_docking):

• Processo: Um carrier recolhe os produtos do domicílio do vendedor e os leva a um HUB (armazém).
• Entrega: Do HUB, escolhe-se o carrier mais conveniente para a entrega ao comprador.
• Rota: Vendedor → Coleta → HUB → Carrier → Comprador.

Coleta rápida (xd_same_day):

A Coleta Rápida é um novo método de envios (por enquanto disponível somente no Brasil) que consiste em uma coleta no endereço do vendedor e uma entrega no mesmo dia ao comprador, realizadas pelo Mercado Livre. As vendas feitas antes do horário de corte serão coletadas e entregues no mesmo dia, enquanto as vendas feitas após o horário de corte serão coletadas no dia seguinte e entregues ao comprador..

• Processo: Um carrier recolhe os produtos do domicílio do vendedor e os leva a um HUB (armazém).
• Entrega: Do HUB, escolhe-se o carrier mais conveniente para a entrega ao comprador.
• Rota: Vendedor → Coleta → HUB → Carrier → Comprador.

Cross Docking com Drop Off (XD_drop_off):

• Processo: O vendedor deixa os produtos em um ponto de recolhimento designado (places). Places ou pontos de despacho são lojas comerciais que também possuem o logo do Mercado Livre, Pickit ou HOP na porta.
• Recolhimento e Entrega: Uma coleta transporta os produtos do Place até o HUB para sua entrega final.
• Rota: Vendedor → Place → Coleta → HUB → Carrier → Comprador.

Drop_off:

• Processo: O vendedor leva os produtos diretamente ao correio ou ponto de entrega designado. Os pacotes seguem o fluxo normal do correio até serem entregues ao comprador.
• Recolhimento e Entrega: O carrier é selecionado para a entrega final.
• Rota: Vendedor → Carrier → Comprador.

Ativar Coleta ou Places

No Mercado Livre, avaliamos semanalmente o desempenho na entrega de produtos dos vendedores de Coletas e Places. Esta avaliação pode influenciar na ativação desses serviços conforme o desempenho.

Pontos chave da ativação:

• Revisão e Configuração de Endereços: garanta que os endereços para envios, despachos e devoluções estejam sempre atualizados e configurados corretamente para evitar problemas.
• Ativação de Notificações: mantenha suas notificações ativas, isso permitirá que você receba alertas imediatos sobre qualquer mudança nos serviços de Coleta ou Places.

O monitoramento constante do seu desempenho e a configuração correta dos seus endereços são essenciais para garantir uma operação fluida e sem interrupções na logística dos seus produtos.

Configurar un usuario de test

Para configurar la modalidad de envío colecta para usuarios de prueba, sigue estos pasos:

1. Iniciar sesión en la página de Developers de Mercado Libre.
2. Seleccionar la categoría a consultar, en este caso: "Configuraciones de test".
3. Desplegar la sección de "Configuración" y elija "Colecta".
4. Completar la información requerida sobre el usuario de prueba.
5. Enviar solicitud de activación de Colecta para su cuenta de usuario de prueba.

Capacidade de envios

A gestão de capacidade de envios é uma ferramenta que permite aos vendedores configurar a quantidade máxima de envios que podem despachar em um dia sem sofrer atrasos. Isso lhes dá a flexibilidade de se organizar e evitar atrasos, seja em mudanças planejadas no volume de vendas ou em situações inesperadas.

Saiba mais sobre:

• O que é minha capacidade de envios e para que serve
• O que acontece quando ultrapasso minha capacidade
• Até quando posso modificá-la
• Como modificá-la se tenho mais de uma coleta no dia
• O que é minha capacidade mínima

Vista do vendedor:

Consultar a capacidade de envios

Este endpoint permite obter a configuração atual da capacidade de envio de um usuário.

Consulta por USER_ID

Chamada:

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

Exemplo:

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

Resposta:

{
   "peak_season_mode": {
       "start_date": "2025-09-30",
       "end_date": "2025-10-10"
   }
   "capacities": [
       {
           "day": "monday",
           "capacity_min": 40,
           "capacity_max": 50,
           "capacity": {
               "value": 45,
               "maximum": false,
               "source": "seller"
           },
           "can_add_capacity": true,
           "can_subtract_capacity": true,
           "intervention": ""
       },
       ...
       {
           "day": "saturday",
           "capacity_min": 40,
           "capacity_max": 50,
           "capacity": {
               "value": 45,
               "maximum": false,
               "source": "seller"
           },
           "can_add_capacity": true,
           "can_subtract_capacity": true,
           "intervention": ""
       }
   ]
}

Consulta por NODE_ID

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/nodes/$NETWORK_NODE_ID/capacity_middleend

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/nodes/MXP20157465171/capacity_middleend

Resposta:

{
   "peak_season_mode": null,
   "capacities": [
       {
           "day": "monday",
           "capacity_min": 5,
           "capacity_max": 200,
           "capacity": {
               "value": 100,
               "maximum": false,
               "source": "seller"
           },
           "can_add_capacity": true,
           "can_subtract_capacity": true,
           "intervention": ""
       },
       {
           "day": "tuesday",
           "capacity_min": 5,
           "capacity_max": 200,
           "capacity": {
               "value": 100,
               "maximum": false,
               "source": "seller"
           },
           "can_add_capacity": true,
           "can_subtract_capacity": true,
           "intervention": ""
       },
       {
           "day": "wednesday",
           "capacity_min": 5,
           "capacity_max": 200,
           "capacity": {
               "value": 100,
               "maximum": false,
               "source": "seller"
           },
           "can_add_capacity": true,
           "can_subtract_capacity": true,
           "intervention": ""
       },
       {
           "day": "thursday",
           "capacity_min": 5,
           "capacity_max": 200,
           "capacity": {
               "value": 100,
               "maximum": false,
               "source": "seller"
           },
           "can_add_capacity": true,
           "can_subtract_capacity": true,
           "intervention": ""
       },
       {
           "day": "friday",
           "capacity_min": 5,
           "capacity_max": 200,
           "capacity": {
               "value": 100,
               "maximum": false,
               "source": "seller"
           },
           "can_add_capacity": true,
           "can_subtract_capacity": true,
           "intervention": ""
       }
   ]
}

Parâmetros de resposta:

• peak_season_mode: Neste objeto são indicadas a data de início e a data de fim em que o vendedor tem o modo 'temporada alta' ativo, onde poderá ter alterações em sua capacidade de entrega.
• day: Representa o dia da semana ao qual a capacidade se refere. Os valores possíveis são monday, tuesday, wednesday, thursday, friday e saturday.
• capacity_min: É o valor mínimo de capacidade permitido para esse dia.
• capacity_max: É o valor máximo de capacidade permitido para esse dia.
• capacity.value: É o valor da capacidade atual para o dia e semana em que o usuário se encontra.
• capacity.maximum: Depreciado. Indica se o usuário tem capacidade infinita (true). Será sempre false.
• next_capacity.value: É o valor da capacidade configurada aplicável para a próxima semana.
• next_capacity.maximum: Depreciado. Indica se o usuário tem capacidade infinita (true) para a próxima semana. Será sempre false ou null.
• can_add_capacity: Indica se é possível adicionar capacidade adicional para esse dia. Os valores possíveis são true ou false.
• can_subtract_capacity: Indica se é possível diminuir a capacidade para esse dia. Os valores possíveis são true ou false.
• intervention: Descreve o tipo de intervenção em que o usuário pode incorrer:
  • delay: intervenção por demoras.
  • early: intervenção por entregas antecipadas.
  • null: não há intervenção.

Restrições de capacidade

• Capacidade infinita não permitida: O campo maximum não aceita mais o valor true. Deve ser sempre false.
• Limite máximo: O capacity.value deve ser menor ou igual a capacity_max.

Considerações

• Se a capacidade de despacho não for configurada, o sistema não imporá restrições. No entanto, recomenda-se aos vendedores que utilizem esta função para otimizar suas entregas e melhorar a experiência do cliente.
• Quando um vendedor não cumpre seu objetivo de capacidade de envios, entra em um estado de intervenção por delay. Durante este período, há restrições na capacidade de modificar ou atualizar a capacidade de envios. Isso é feito para garantir que os vendedores se comprometam a melhorar seu desempenho. Uma vez cumpridos os requisitos durante o período de intervenção, as restrições serão levantadas e você poderá ajustar novamente sua capacidade de envios.
• Quando um vendedor consegue despachar mais do que sua capacidade, entra em um estado de intervenção por early. Durante este período, não há restrições na capacidade de modificar ou atualizar a capacidade de envios; o objetivo é que o vendedor possa maximizar sua injeção e configurar uma capacidade mais precisa.
• Para uma experiência ideal, recomendamos habilitar as Novidades para vendedores, pois é aqui que serão notificadas quaisquer atualizações ou mudanças relevantes neste processo.
• Para o peak_season_mode, quando vigente, o vendedor verá no seu painel de preferências de vendas o seguinte aviso:
  
  

Atualizar a capacidade de envios

Este endpoint permite modificar ou atualizar a configuração da capacidade de envio de um usuário.

Atualização por USER_ID

Chamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/users/$USER_ID/capacity_middleend/$LOGISTIC_TYPE

Exemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/users/123456789/capacity_middleend/cross_docking


{
 "capacities": [
   {
     "day": "monday",
     "capacity": {
       "value": 120,
       "maximum": false
     }
   },
   {
     "day": "tuesday",
     "capacity": {
       "value": 120,
       "maximum": false
     }
   },
   {
     "day": "wednesday",
     "capacity": {
       "value": 120,
       "maximum": false
     }
   },
   {
     "day": "thursday",
     "capacity": {
       "value": 120,
       "maximum": false
     }
   },
   {
     "day": "friday",
     "capacity": {
       "value": 120,
       "maximum": false
     }
   },
   {
     "day": "saturday",
     "capacity": {
       "value": 120,
       "maximum": false
     }
   }
 ]
}

Atualização por NODE_ID

Chamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/nodes/$NETWORK_NODE_ID/capacity_middleend

Exemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/nodes/MXP20214899242/capacity_middleend

Códigos de status de resposta

Tempo de preparação de envios

O tempo de preparação de envios é o tempo para gerenciar ou despachar um pedido uma vez processado.

Saiba mais sobre:

• Perguntas frequentes sobre o tempo de preparação
• Para que serve ajustá-lo
• Até quando posso modificá-lo no dia
• Como modificá-lo se tenho mais de uma coleta no dia
• Por que há dias com menos opções de tempo de preparação

Consultar o tempo de preparação

Este endpoint permite obter o tempo de preparação para o envio.

Consulta por USER_ID

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'X-Version: v3' \
https://api.mercadolibre.com/users/$USER_ID/service/$SERVICE_TYPE/processing_time_tool

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'X-Version: v3' \
https://api.mercadolibre.com/users/123456789/service/carrier_pickup/processing_time_tool

Resposta:

{
 "monday": {
   "modified_by_meli": false,
   "intervention_type": null,
   "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
     }
   ]
 }
}

Consulta por NODE_ID

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/nodes/$NETWORK_NODE_ID/service/$SERVICE_TYPE/processing_time_tool

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/nodes/MXP20157465171/service/carrier_pickup/processing_time_tool

Resposta:

{
 "monday": {
   "modified_by_meli": false,
   "intervention_type": null,
   "visible": true,
   "available_options": [
     {
       "processing_time": "01:00",
       "selected": false,
       "highlight_level": "",
       "disabled": false
     },
     {
       "processing_time": "01:30",
       "selected": false,
       "highlight_level": "",
       "disabled": false
     },
     ...
   ]
 },
 "saturday": {
   "modified_by_meli": false,
   "intervention_type": null,
   "visible": false,
   "available_options": null,
   "enabled": false,
   "current_processing_time": null
 },
 "sunday": {
   "modified_by_meli": false,
   "intervention_type": null,
   "visible": false,
   "available_options": null,
   "enabled": false,
   "current_processing_time": null
 }
}

Parâmetros de resposta:

• modified_by_meli: caso venha true, indica que o Mercado Livre é o responsável por modificar seu processing time.
• intervention_type: indica se o Mercado Livre interveio no processing time do seller para aquele dia. Os valores possíveis são early (o tempo foi adiantado), delay_with_changes (foi atrasado com alterações), delay (foi atrasado). Se for null, não há intervenção ativa.
• visible: indica se o dia deve ser exibido no front.
• enabled: indica se a linha está habilitada para edição.
• current_processing_time: indica o valor do processing time que estava selecionado antes da alteração. Se for diferente de null, será exibida a mensagem de que entrará em vigor na próxima semana. Caso contrário, o dia será exibido normalmente.
• available_options.processing_time: indica o tempo de processamento possível de selecionar no formato HH:MM. Por exemplo, "00:30" (30 minutos).
• available_options.selected: valor atual escolhido pelo usuário, ou o padrão caso nunca tenha sido configurado anteriormente.
• available_options.highlight_level: as opções são:
  • low: menos tempo de preparação que o padrão.
  • default: tempo de preparação padrão.
  • high: mais tempo de preparação que o padrão.

Atualizar o tempo de preparação

Este endpoint permite atualizar o tempo de preparação do envio.

Atualização por USER_ID

Chamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' 'X-Version:v3' -d \
https://api.mercadolibre.com/users/$USER_ID/service/$SERVICE_TYPE/processing_time_tool

Exemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' 'X-Version:v3' -d \
https://api.mercadolibre.com/users/123456789/service/carrier_pickup/processing_time_tool


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

Resposta:

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

Atualização por NODE_ID

Chamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' 'x-version: v3' -d \
https://api.mercadolibre.com/nodes/$NETWORK_NODE_ID/service/$SERVICE_TYPE/processing_time_tool

Exemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' 'x-version: v3' -d \
https://api.mercadolibre.com/nodes/MXP20157465171/service/carrier_pickup/processing_time_tool

Resposta:

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

Considerações

• Enviar no formato "01:00", "00:30" conforme retornado no GET.
• Caso o campo processing_times seja enviado vazio, a integração utilizará os valores padrão de acordo com a logística: 01:00 cross_docking e 01:30 xd_drop_off.
• Caso seja enviado um dia bloqueado, ou seja, um dia que esteja em enabled: false, a integração ignora este valor e mantém o valor selecionado antes da alteração.
• A atualização do processing_time do dia vigente só terá impacto na próxima semana.

Códigos de status de resposta

Horários de despacho

Os horários de despacho ajudam os vendedores a programar suas entregas e evitar atrasos, protegendo sua reputação. Para acessar esta informação, é necessário conhecer os tipos de logística habilitados na sua conta. Utilize o recurso de preferencia de envio de um usuário para conhecer os tipos logisticos do vendedor.

Consultar os horários de despacho

Este recurso permite consultar os horários de despacho de um usuario.

Consulta por USER_ID

Chamada:

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

Exemplo:

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

Resposta:

{
    "seller_id": "123456789",
    "schedule": {
        "monday": {            
           "work": true,
            "detail": [
                {
                    "milkrun_same_day": true,
                    "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": "same_day",
                   "logistic_type": ""
                }
            ]
        }
        ...
        "saturday": {
            "work": false,
            "detail": null
        },
        "sunday": {
            "work": false,
            "detail": null
        }
    }
 }

Consulta por NODE_ID

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/nodes/$NETWORK_NODE_ID/schedule/$LOGISTIC_TYPE

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/nodes/MXP20157465171/schedule/xd_drop_off

Resposta:

{
   "seller_id": "123456789",
   "node_id": "MXP20157465171",
   "schedule": {
       "monday": {
           "work": true,
           "detail": [
               {
                   "milkrun_same_day": false,
                   "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": "same_day_or_tuesday",
                   "logistic_type": "xd_drop_off"
               }
           ]
       },
        ...
              "saturday": {
           "work": false,
           "detail": null
       },
       "sunday": {
           "work": false,
           "detail": null
       }
   }
}

Parâmetros de resposta:

• seller_id: id do vendedor.
• node_id: id correspondente a network_node_id do recurso de stores para identificar o depósito
• work: indica se o vendedor trabalha nesse dia. Aplica-se a todas as logísticas. Não considera feriados.
• milkrun_same_day: indica se corresponde a uma Colecta Rápida ou não.
• from: é o horário de início da janela de coleta. Para xd_drop_off é o horário máximo de despacho.
• to: é o horário de fim da janela de coleta.
• cutoff: horário de corte.
• carrier.id: id do transportador.
• carrier.name: nome do transportador.
• vehicle: é a descrição do veículo.
• vehicle.id: id do veículo.
• vehicle.license_plate: é a placa do veículo.
• vehicle.only_for_today: indica se a coleta é apenas para hoje.
• vehicle.new_driver: indica se houve uma mudança no motorista que passará.
• driver.id: id do motorista da coleta.
• driver.name: é o nome do motorista da coleta.

Códigos de estado de resposta: