Bem-vindo à documentação da API Veltra TMS. Esta API permite que marketplaces e plataformas de e-commerce integrem serviços de logística, incluindo cotação de frete, rastreamento de encomendas e gestão de transportadoras.
Base URL
https://api.veltra.com.br/v1Formato
Todas as requisições e respostas utilizam JSON.
A API utiliza autenticação via Bearer Token. Inclua o token no header Authorization de todas as requisições.
Nota: O token deve ser obtido através do painel administrativo da Veltra. Entre em contato com nosso suporte para gerar suas credenciais.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Authorization | string | Sim | Bearer {token} |
| Content-Type | string | Sim | application/json |
/api/docs/cotacaoCalcula o valor do frete com base nas dimensões, peso e localidades de origem e destino.
Parâmetros do Request
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| peso | number | Sim | Peso em kg |
| altura | number | Sim | Altura em cm |
| largura | number | Sim | Largura em cm |
| comprimento | number | Sim | Comprimento em cm |
| cep_origem | string | Sim | CEP de origem (XXXXX-XXX) |
| cep_destino | string | Sim | CEP de destino (XXXXX-XXX) |
/api/docs/rastreio?codigo_rastreamento={codigo}Retorna o status atual de uma encomenda e todo o histórico de eventos.
Parâmetros de Query
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| codigo_rastreamento | string | Sim | Código de rastreamento único |
Os webhooks notificam sua aplicação sobre eventos em tempo real. Configure a URL de callback no painel administrativo.
Eventos Disponíveis
frete.cotadoDisparado quando uma cotação é realizada
frete.concluidoDisparado quando a entrega é concluída
frete.exceptionDisparado quando ocorre uma exceção na entrega
Assinatura do Webhook
Os webhooks incluem um header X-Veltra-Signaturepara validação. Use o segredo configurado para verificar a autenticidade.
https://api.veltra.com.br/v1