6. API da ANTT para emissão do CIOT 6.3. Consulta Frota Transportador: 6.2. Consulta Situação Transportador
« Anterior; 6.4. Declara Operação de Transporte
Próximo »

6.3. Consulta Frota Transportador

Consultar Frota do transportador

Assinatura

string ANTT_ConsultaFrotaTransp(int tpAmb, string nomeCertificado, string CpfCnpjInteressado, string CpfCnpjTransportador, string RNTRCTransportador, string Placas, 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 Frota)

Descrição:

Consultar se os veículos informados pertencem à frota do transportador; necessário informar o CNPJ, RNTRC e as placas dos veículos.

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

razão social;
situação do RNTRC do transportador;
situação das placas consultadas:
- Placa do veículo;
- veículo pertence ou não pertence à frota do transportador.

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
*Placas*	string	entrada	informar uma lista de placas a serem pesquisadas do Transportador, usar o pipe como separador de placas, ex. "ABC1234\|ABC1235\|ABC1236"
*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.
*Frota*	string	saída	retorna a situação de todos os veículos pesquisados Placa do Veículo e Situação do Veículo: 0 - (false) - Não pertence ao Transportador 1 - (true) - Pertence ao Transportador exemplo de retorno (placa:situação): ABC1234:0 ABC1235:1 ABC1236:0

Retorno da chamada:

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

{
  "CpfCnpjTransportador": "00111222000123",
  "RNTRCTransportador": "045565536",
  "NomeRazaoSocialTransportador": "OURITRAN LOGISTICA E TRANSPORTES LTDA",
  "RNTRCAtivo": true,
  "Mensagem": "Consulta realizada com sucesso!",
  "Protocolo": "F98000000005944",
  "Codigo": "111",
  "Frota": [
    {
      "PlacaVeiculo": "ABC1234",
      "SituacaoVeiculoFrotaTransportador": 0
    },
    {
      "PlacaVeiculo": "ABC1235",
      "SituacaoVeiculoFrotaTransportador": 1
    },
    {
      "PlacaVeiculo": "ABC1236",
      "SituacaoVeiculoFrotaTransportador": 0
    }
  ]
}

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",
  "Placas": [
    "ABC1234",
    "ABC1235",
    "ABC1236"
  ]
}

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": "F98000000005944",
  "Codigo": "111",
  "Frota": [
    {
      "PlacaVeiculo": "ABC1234",
      "SituacaoVeiculoFrotaTransportador": 0
    },
    {
      "PlacaVeiculo": "ABC1235",
      "SituacaoVeiculoFrotaTransportador": 1
    },
    {
      "PlacaVeiculo": "ABC1236",
      "SituacaoVeiculoFrotaTransportador": 0
    }
  ]
}

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:48:01.0022447Z",
  "correlationId": "62bac6d8-1cb1-47ef-82ba-6a63528b46e3",
  "path": "/pefServices/api/ConsultarFrotaTransportador/"
}

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";
string Placas = "ABC1234|ABC1235|ABC1236";
int cStat = 0;
string msgResultado = "";
string msgDados = "";
string msgRetWS = "";
string NomeRazaoSocialTransportador = "";
string RNTRCAtivo = "";
string Mensagem = "";
string Protocolo = "";
string Codigo = "";
string Frota = "";
 
// instancia DLL
 
MDFe_Util.Util util = new MDFe_Util.Util();
 
// consome API
 
msgRetWS = util.ANTT_ConsultaFrotaTransp(tpAmb, 
                                         nomeCertificado, 
                                         CpfCnpjInteressado, 
                                         CpfCnpjTransportador, 
                                         RNTRCTransportador,
                                         Placas,
                                         out cStat,
                                         out msgResultado,
                                         out msgDados,
                                         out NomeRazaoSocialTransportador,
                                         out RNTRCAtivo, 
                                         out Mensagem, 
                                         out Protocolo, 
                                         out Codigo, 
                                         out Frota);
 
 
// exibe resposta da API
 
MessageBox.Show(msgResultado,"Consultar Situação Transportadora");
 
//

6.3. Consulta Frota Transportador 6. API da ANTT para emissão do CIOT: « Anterior
6.2. Consulta Situação Transportador; Próximo »
6.4. Declara Operação de Transporte

Guia de Uso do MDFe_Util v4.00