Documentação do Mercado Envios
Confira todas as informações necessárias sobre as APIs Mercado Envios.
Documentação
Envios Turbo
Envios Turbo é um serviço de entrega que se concentra em fornecer entregas rápidas em menos de 3 horas. Ele foi projetado para atender áreas próximas ao vendedor e se baseia no modelo logístico Flex. Este serviço tem como objetivo oferecer uma opção de entrega extremamente rápida, o que pode ser especialmente útil para melhorar a pontualidade nas entregas e fornecer um serviço de alta qualidade aos usuários.
Conheça mais sobre os Envios Flex, como calcular os tempos de entrega com envios turbo, perguntas frequentes sobre envios turbo.
Áreas de cobertura por países
Para poder oferecer envios Turbo, o endereço de envio do vendedor deve estar habilitado para uma das áreas de cobertura, de acordo com o país:
| País | Cobertura |
|---|---|
| Argentina | - AMBA (Área Metropolitana de Buenos Aires) |
Consultar assinatura de um usuário
Este endpoint permite consultar as assinaturas que um usuário possui.
- Se o usuário ativar ambos serviços, Flex e Turbo, ele terá duas assinaturas, já que Flex é um requisito para acessar o Turbo..
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/flex/sites/$SITE_ID/users/$USER_ID/subscriptions/v1Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipping/flex/sites/MLA/users/1438865529/subscriptions/v1Resposta:
[
{
"id": 111181,
"site_id": "MLA",
"user_id": 1438865529,
"mode": "FLEX",
"configuration_type": {
"coverage": "zone",
"delivery": "custom"
},
"service_id": 736230,
"status": {
"id": "in",
},
"creation_date": "2023-08-02T06:34:40Z"
},
{
"id": 111183,
"site_id": "MLA",
"user_id": 1438865529,
"mode": "TURBO",
"configuration_type": {
"coverage": "radius",
"delivery": "accurate"
},
"service_id": 738216,
"status": {
"id": "in",
},
"creation_date": "2023-08-02T06:35:30Z"
}
]Parámetros de resposta:
- id ID único da assinatura.
- site_id identificador do país.
- user_id ID do usuário.
- mode tipo de assinatura (TURBO neste caso).
- configuration_type Ttipo de configuração da inscrição (TURBO neste caso).
- configuration_type.coverage tipo de cobertura.
- configuration_type.delivery tipo de entrega.
- service_id ID do serviço associado a assinatura.
- status estado da assinatura.
- status.id: tipos de estados da assinatura:
- in: a assinatura está ativa. Nesse estado, o usuário pode alterar suas configurações e receber pedidos de envio no modo de assinatura.
- out: a assinatura não está ativa. Nesse estado, o usuário não pode alterar as configurações.
- pending: a assinatura está pendente de ativação. Nesse estado, o usuário pode alterar as configurações, embora não vá receber pedidos para realizar entregas.
- creation_date data de criação da assinatura.
Códigos de estado de resposta:
| Código | Mensagem | Descrição | Recomendação |
|---|---|---|---|
| 200 - OK | - | Atualizou corretamente a configuração. | - |
| 400 - Bad Request | empty site id | O site_id está vazio. | Validar o site_id. |
| 400 - Bad Request | invalid site_id | Site_id inválido. | Validar se o site_id está habilitado para envios turbo. |
| 400 - Bad Request | can't access to resource | Site_id inválido. | Validar se o site_id está habilitado para envios turbo. |
| 404 - Not Found | user not found | O usuário não existe. | Validar o user_id. |
Identificar ordens Turbo
Este endpoint determina se um envio será processado pelo serviço Turbo, permitindo concluir a transação de forma eficaz.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/$SHIPMENT_IDExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shipments/42469883906Resposta:
"tags": [
"turbo"
]