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 |
| merNF | Número da Nota Fiscal | Inteiro | 8 | Sim |
| tomCnpj | CNPJ | Numérico | 14 | Não |
| modoJson | Modo Json | Booleano (0/1) | 1 | Não |
| xmlCte | Retorna XML do CTe | Booleano (0/1) | 1 | Não |
URL Requisitada:
<?xml version="1.0" encoding="utf-8"?>
<wsRastreamento>
<rst versao="1.0">
<rstStatus stsCd="2">RASTREAMENTO CONCLUIDO COM SUCESSO</rstStatus>
<emi>
<rem remCnpj="00000000000000">ALFA TRANSPORTES LTDA</rem>
<emiTransp transpCnpj="82110818001446">ALFA TRANSPORTES LTDA</emiTransp>
<emiUnid>CAMBE</emiUnid>
</emi>
<NF nro="000">
<NFCtrc>333333</NFCtrc>
<NFCtrValor>195.0</NFCtrValor>
<NFData>2023-05-09</NFData>
<NFDataPrevista>2023-05-17</NFDataPrevista>
<NFDest>ALFA TRANSPORTES LTDA</NFDest>
<NFInicio>CAMBE</NFInicio>
<NFFim>PINHEIRAL</NFFim>
<NFCidade>RESENDE-RJ</NFCidade>
</NF>
<embarque>
<embNF>
<embOrigem>CAMBE</embOrigem>
<embDestino>GUARULHOS</embDestino>
<embSaida>2023-05-10 -- 00:04</embSaida>
<embChegada>2023-05-10 -- 14:30</embChegada>
</embNF>
<embNF>
<embOrigem>GUARULHOS</embOrigem>
<embDestino>PINHEIRAL</embDestino>
<embSaida>2023-05-11 -- 00:58</embSaida>
<embChegada>2023-05-11 -- 07:24</embChegada>
</embNF>
</embarque>
<entrega>
<entS>
<entSaida>2023-05-12 -- 08:23</entSaida>
</entS>
<entNF>
<entData>2023-05-12</entData>
<entHora>21:48:00</entHora>
<entNome>ALFA TRANSPORTES LTDA</entNome>
<entSetor></entSetor>
<entComprovante>https://areadocliente.alfatransportes.com.br/comprovante_safe.php?cte=MTtvNDk5NjQyNA==</entComprovante>
</entNF>
</entrega>
</rst>
</wsRastreamento>
{
"status": 2,
"nome": "RASTREAMENTO CONCLUIDO COM SUCESSO",
"dadosTransportadora": {
"nomeTransportadora": "ALFA TRANSPORTES",
"cnpjTransportadora": "82110818000121",
"cidadeTransportadora": "ICARA"
},
"dadosRemetente": {
"nomeRemetente": "LOJA DA CASA LTDA",
"cnpjRemetente": "82110818000121"
},
"dadosCte": {
"numeroNota": 9999,
"numeroCte": 999999,
"valorCte": 81.6,
"dataEmissao": "2023-04-03",
"dataPrivista": "2023-04-10",
"nomeDestinatario": "ALFA TRANSPORTES",
"agenciaInicio": "ICARA",
"agenciaFim": "LOANDA",
"cidadeEntrega": "LOANDA"
},
"dadosEmbarque": {
"codigoViagem": 999999,
"cidadeOrigem": "CURITIBA",
"cidadeDestino": "MARINGA",
"horaSaida": "2023-04-04 -- 21:25",
"horaChegada": "2023-04-05 -- 04:52"
},
"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. |