Visão geral das APIs
A Rodonaves oferece 7 APIs, cada uma com sua própria URL base e seu próprio token. Juntas, elas cobrem a jornada completa de um envio: da cotação ao comprovante de entrega.
O que cada API faz:
| API | Para que serve |
|---|---|
| Correios | Converter um CEP no código de cidade usado pelas outras APIs |
| Malha de atendimento | Saber se a Rodonaves atende um endereço de destino e por qual unidade |
| Prazo de entrega | Calcular o prazo entre origem e destino |
| Cotação | Calcular o valor do frete e gerar um protocolo de cotação |
| Coleta | Solicitar e consultar coletas, inclusive a partir de uma cotação |
| Rastreio e Comprovante de entrega | Acompanhar o transporte e obter o comprovante após a entrega |
| Cliente | Cadastrar um cliente na base Rodonaves |
Jornada típica de um envio
- Busque a cidade pelo CEP (Correios). A cotação exige o código da cidade de origem e de destino, não só o CEP.
- Confira o atendimento e o prazo (Malha de atendimento e Prazo de entrega).
- Gere a cotação (Cotação). A resposta traz um protocolo.
- Solicite a coleta a partir do protocolo (Coleta), sem precisar reenviar os dados da carga.
- Acompanhe o transporte (Rastreio). Use o campo ProcedaCode para interpretar o status. A tabela completa está na página Retorno da API de rastreio.
- Baixe o comprovante de entrega (Comprovante de entrega).
Rotas disponíveis
Padrões que valem para todas as APIs
• Formato: as respostas vêm em JSON. Envie Accept: application/json.
• Autenticação: cabeçalho Authorization: Bearer
| Código | Significado |
|---|---|
| 200 | Sucesso |
| 400 | Requisição inválida: parâmetro faltando ou em formato errado |
| 401 | Token ausente, inválido ou expirado |
| 403 | Seu usuário não tem permissão para este recurso |
| 500 | Erro interno. Tente novamente e, se persistir, avise a Rodonaves |
Updated about 18 hours ago
Did this page help you?