6. API da ANTT para emissão do CIOT 6.2. Consulta Situação Transportador: 6.1. Gera CIOT
« Anterior; 6.3. Consulta Frota Transportador
Próximo »

6.2. Consulta Situação Transportador

Consultar a situação do transportador

Assinatura

string ANTT_ConsultaSitTransp(int tpAmb, string nomeCertificado, string CpfCnpjInteressado, string CpfCnpjTransportador, string RNTRCTransportador, out int cStat, out string msgResultado, out string msgDados, out string NomeRazaoSocialTransportador, out string RNTRCAtivo, out string Mensagem, out string Procotolo, out string Codigo, out string TipoTransportador, out string EquiparadoTAC)

Descrição:

Consultar a situação do transportador, necessário informar o CNPJ e RNTRC do transportador.

A consulta retorna as seguintes informações do transportador consultado:

razão social;
situação do RNTRC;
tipo do transportador (TAC, ETC ou CTC);
equiparado a TAC.

Certificado Digital

Informar o Nome do titular (campo Assunto) do certificado digital a ser utilizado na conexão SSL.

Parâmetros da chamada:

nome	tipo	fluxo	descrição
*ambiente*	inteiro	entrada	informar o código do ambiente que deseja acessar: 1- produção ou 2-homologação
*nomeCertificado*	string	entrada	informar nome do titular do certificado a ser utilizado na autenticação com a API: 1. informar o assunto do certificado digital que deve existir no repositório MY do current user, ex.: "CN=NFe - Associacao NF-e:99999090910270, C=BR, L=PORTO ALEGRE, O=Teste Projeto NFe RS, OU=Teste Projeto NFe RS, S=RS". 2. informar: NUMEROSERIE\|[número de série] quando não seja possível localizar o certificado digital pelo assunto; 3. informar: ARQUIVO \| [nome do arquivo pfx com caminho completo] \| [senha do arquivo] para uso do certificado digital em arquivo pfx, ex.: "ARQUIVO\|c:\certificado.pfx\|senha". 4. informar: CERTIFICADO \| [string base64 do arquivo pfx] \| [senha do arquivo] no parâmetro NomeCertificado para passar uma string contendo um certificado digital em base64, ex.:"CERTIFICADO\|MIIGoDCCBYigAwIBAgIQep(arquivo pfx do certificado digital convertido em base64...)QQDExNBQy\|senha".
*CpfCnpjInteressado*	string	entrada	informar o CPF ou CNPJ do Interessado
*CpfCnpjTransportador*	string	entrada	informar o CPF ou CNPJ do Transportador
*RNTRCTransportador*	string	entrada	informar o Número do RNTRC do Transportador
*cStat*	inteiro	saída	retorna um código numérico devolvido pela API, exemplos de retorno: 200-[mensagem do WS] 400-Bad Request 401-Unauthorized 500-Internal Server Error, etc.
*msgResultado*	string	saída	retorna um texto com a resposta devolvida pela API
*msgDados*	string	saída	retorna a mensagem Json enviada para a API
*NomeRazaoSocialTransportador*	string	saída	retorna o Nome ou Razão Social do Transportador.
*RNTRCAtivo*	string	saída	retorna a Situação do RNTRC Ativa: false - Situação não é ativa true - Situação é ativa
*Mensagem*	string	saída	retorna a mensagem do resultado da chamada da API
*Protocolo*	string	saída	retorna o Protocolo
*Codigo*	string	saída	retorna o Código do erro ou sucesso no retorno da informação.
*TipoTransportador*	string	saída	retorna o tipo do Transportador: - TAC - ETC - CTC
*EquiparadoTAC*	string	saída	retorna se Transportador é equiparado ao TAC: false – Não true - Sim

Retorno da chamada:

O resultado da chamada da API ANTT_ConsultaSitTransp é a resposta JSON, exemplo:

{
  "CpfCnpjTransportador": "00111222000123",
  "RNTRCTransportador": "045565536",
  "NomeRazaoSocialTransportador": "OURILOG LOGISTICA E TRANSPORTES LTDA",
  "RNTRCAtivo": true,
  "Mensagem": "Consulta realizada com sucesso!",
  "Protocolo": "S98000000003796",
  "Codigo": "111",
  "TipoTransportador": "ETC",
  "EquiparadoTAC": false
}

Histórico de atualização:

2026-06-02 - versão inicial

Exemplo de JSON enviado para a API da ANTT

{
  "CpfCnpjInteressado": "10142785000190",
  "CpfCnpjTransportador": "00111222000123",
  "RNTRCTransportador": "045565536"
}

Exemplo de JSON da resposta "Consulta realizada com sucesso!"

 
{
  "CpfCnpjTransportador": "00111222000123",
  "RNTRCTransportador": "045565536",
  "NomeRazaoSocialTransportador": "OURITRAN LOGISTICA E TRANSPORTES LTDA",
  "RNTRCAtivo": true,
  "Mensagem": "Consulta realizada com sucesso!",
  "Protocolo": "S98000000003796",
  "Codigo": "111",
  "TipoTransportador": "ETC",
  "EquiparadoTAC": false
}

Exemplo de JSON da resposta: "USUARIO_NAO_AUTORIZADO"

{
  "error": "USUARIO_NAO_AUTORIZADO",
  "message": "Rejeição: O CPF/CNPJ do certificado digital não corresponde a nenhum transportador cadastrado no RNTRC",
  "timestamp": "2026-06-02T00:17:13.7640369Z",
  "correlationId": "d1fc5cce-a90d-4a04-912c-8f56e5894516",
  "path": "/pefServices/api/ConsultarSituacaoTransportador/"
}

Importante

O trecho do JSON foi formatado para uma melhor visualização, a mensagem original não tem formatação.

Exemplos de uso:

 
// inicialização das variáveis utilizadas
 
int tpAmb = 2;
string nomeCertificado = "CN=FLEXDOCS INFORMATICA LTDA:10142785000190, OU=presencial, OU=20085105000106, OU=RFB e-CNPJ A1, OU=Secretaria da Receita Federal do Brasil - RFB, L=OURINHOS, S=SP, O=ICP-Brasil, C=BR";
 
string CpfCnpjInteressado = "10142785000190";
string CpfCnpjTransportador = "00111222000123";
string RNTRCTransportador= "045565536";
int cStat = 0;
string msgResultado = "";
string msgDados = "";
string msgRetWS = "";
string NomeRazaoSocialTransportador = "";
string RNTRCAtivo = "";
string Mensagem = "";
string Protocolo = "";
string Codigo = "";
string TipoTransportador = "";
string EquiparadoTAC = "";
 
// instancia DLL
 
MDFe_Util.Util util = new MDFe_Util.Util();
 
// consome API
 
msgRetWS = util.ANTT_ConsultaSitTransp(tpAmb, 
                                       nomeCertificado, 
                                       CpfCnpjInteressado, 
                                       CpfCnpjTransportador, 
                                       RNTRCTransportador, 
                                       out cStat, 
                                       out msgResultado,
                                       out msgDados, 
                                       out NomeRazaoSocialTransportador, 
                                       out RNTRCAtivo, 
                                       out Mensagem, 
                                       out Protocolo, 
                                       out Codigo, 
                                       out TipoTransportador,
                                       out EquiparadoTAC);
 
 
// exibe resposta da API
 
MessageBox.Show(msgResultado,"Consultar Situação Transportadora");
 
//

6.2. Consulta Situação Transportador 6. API da ANTT para emissão do CIOT: « Anterior
6.1. Gera CIOT; Próximo »
6.3. Consulta Frota Transportador

Guia de Uso do MDFe_Util v4.00