Este documento foi desenvolvido para orientar o desenvolvimento de comunicações com a API de rastreamento da Alfa Transportes. Para consumir esta API, é necessário primeiramente entrar em contato com o comercial da matriz e solicitar uma chave de acesso único. Essa chave é a garantia da comunicação segura de ambos os lados. Com os exemplos e testes práticos abaixo, será possível realizar todos os testes antes de implementar em seu sistema.
A requisição deverá ser do tipo POST, com um JSON no corpo da requisição que pode conter os seguintes campos.
| Campo | Descrição | Tipo | Tamanho | Obrigatório |
|---|---|---|---|---|
| idr | Chave de acesso (Identificação da Empresa Remetente) | String | 30 - 40 | Sim |
| numeroNota | Número da Nota Fiscal | Inteiro | 8 | Sim |
| tomCnpj | CNPJ | Numérico | 14 | Não |
URL Requisitada:
{
"status": 2,
"nome": "RASTREAMENTO CONCLUIDO COM SUCESSO",
"dadosTransportadora": {
"nomeTransportadora": "ALFA TRANSPORTES",
"cnpjTransportadora": "82110818000121",
"cidadeTransportadora": "ICARA"
},
"dadosRemetente": {
"nomeRemetente": "ALFA TRANSPORTES",
"cnpjRemetente": "82110818000121"
},
"dadosCte": {
"notas" : [
{
"numero":"9999",
"serie":"0",
"chave":"11111111111111111111111111111111111111111111"
}
],
"numeroCte": "999999",
"valorCte": 81.6,
"dataEmissao": "2023-04-03",
"dataPrivista": "2023-04-10",
"nomeDestinatario": "ALFA TRANSPORTES",
"agenciaInicio": "ICARA",
"agenciaFim": "LOANDA",
"cidadeEntrega": "LOANDA"
},
"complemetar": [
{
"tipoCte":"CARRO DEDICADO",
"numeroCte" : "999999",
"serieCte": "0",
"valorCte": 550.25,
}
],
"dadosEmbarque": [
{
"cidadeDestino": "GOIANIA",
"cidadeOrigem": "RIBEIRAO PRETO",
"codigoViagem": 111111,
"horaChegada": "2025-08-08 -- 14:21",
"horaSaida": "2025-08-07 -- 22:06"
},
{
"cidadeDestino": "BRASILIA",
"cidadeOrigem": "GOIANIA",
"codigoViagem": 23232133,
"horaChegada": "2025-08-11 -- 08:54",
"horaSaida": "2025-08-11 -- 04:15"
},
{
"cidadeDestino": "LUZIANIA",
"cidadeOrigem": "BRASILIA",
"codigoViagem": 32132121,
"horaChegada": "2025-08-12 -- 13:37",
"horaSaida": "2025-08-12 -- 13:22"
}
],
"dadosEntrega": {
"recebedorMercadoria": "Alfa Transportes",
"dataEntrega": "2023-04-05 15:03:00",
"urlComprovante": "https://areadocliente.alfatransportes.com.br/comprovante_safe.php?cte=MTtvNDk5NjQyNA=="
},
"ocorrenciasExtras":[
{"codigoOcorrencia":0,"dataOcorrencia":"19/02/2024 03:41","descricaoOcorrencia":"PROCESSO DE TRANSPORTE INICIADO"},
{"codigoOcorrencia":12,"dataOcorrencia":"20/02/2024 02:05","descricaoOcorrencia":"TRANSBORDO DA UNIDADE DE MARINGA PARA BAURU"}
]
}
| Código | Descrição |
|---|---|
| 1 | RASTREAMENTO NAO CONCLUIDO. |
| 2 | RASTREAMENTO CONCLUIDO COM SUCESSO. |
| 3 | FALHA DE CONEXAO COM BANCO DE DADOS. |
| 4 | FALTA IDENTIFICACAO DO REMETENTE DA NOTA. |
| 5 | FALHA AO VERIFICAR IDENTIFICACAO. |
| 6 | IDENTIFICACAO NAO ENCONTRADA. |
| 7 | FALHA AO RECUPERAR OS DADOS DA NOTA FISCAL. |
| 8 | FALTA NOTA FISCAL DA MERCADORIA. |
| 9 | NOTA FISCAL NAO ENCONTRADA NESTE CNPJ. |