API de cotação de fretes

Conecte seu ERP, loja virtual ou sistema próprio ao Portal do Transportador e receba cotações de frete aéreo em tempo real, no formato JSON.

REST + JSONChave de acesso (X-API-Key)Tomador opcional

Entrar

Já tem cadastro? Acesse para ver sua chave, testar e acompanhar suas chamadas.

Criar conta de API

Informe o CNPJ – buscamos os dados da empresa para você. Depois crie seu usuário e senha e receba sua chave na hora.

Dados de conexão

Use estes dados no seu sistema para pedir cotações.

Endpoint (POST)
Alternativo
Teste de conexão (GET)
Cabeçalho: X-API-Key: …
Formato: Content-Type: application/json
Limite

Sua chave de acesso – copie e guarde agora. Por segurança ela não será exibida novamente.

Ao gerar uma nova, a chave anterior deixa de funcionar.

Sua conta

Empresa vinculada à chave.

Testar pedido de cotação

Monte um pedido pelos campos (ou edite o JSON) e envie para a API. O teste usa sua sessão; se quiser, cole sua chave para testar exatamente como o seu sistema fará.

Corpo da requisição (JSON)

Resposta

Documentação

Envie um POST com JSON para o endpoint, com sua chave no cabeçalho X-API-Key (ou Authorization: Bearer <chave>).

Campo	Tipo	Obrigatório	Descrição
`cep_origem`	texto	sim	CEP de coleta/origem (8 números).
`cep_destino`	texto	sim	CEP de destino (8 números).
`volumes[]`	lista	sim	Cada volume: `altura`, `largura`, `comprimento` (cm), `peso` (kg, obrigatório) e `quantidade` (padrão 1).
`valor_carga`	número	recomendado	Valor da mercadoria em R$ (base do ad-valorem).
`tipo_entrega`	texto	não	`domicilio` (padrão) ou `balcao`.
`coleta`	booleano	não	`true` se precisa de coleta.
`tomador_cnpj`	texto	não	CNPJ de quem paga o frete. Se não enviar, vale o tomador padrão do contrato.
`fonte`	texto	não	`ambas` (padrão – os dois modelos), `api` (Cotação Aéreo API – tarifa online da companhia) ou `tabela` (Cotação Aéreo Próprio – tabelas de frete próprias).
`nfe_chave`	texto	não	Chave da NF-e (44 números), apenas para referência.

Na resposta, modelos.aereo_api e modelos.aereo_proprio trazem cada modelo separado (serviços, menor valor e erros), e servicos[] traz todos juntos, do menor para o maior valor. Todas as cotações usam a unidade de origem . Códigos HTTP: 200 ok · 401 chave ausente/inválida · 422 dados inválidos (veja erros[].campo) · 429 limite por minuto · 502/503 indisponibilidade temporária.

Últimas chamadas

Histórico das cotações pedidas com a sua conta (API e testes).