6. API da ANTT para emissão do CIOT 6.9. Consulta CIOT Gerado: 6.8. Consulta Exceção
« Anterior

6.9. Consulta CIOT Gerado

Consultar CIOT Gerado

Assinatura

string ANTT_ConsultaCIOTGerado(int tpAmb, string nomeCertificado, string CIOT12, int AnoDeclaracao, out int cStat, out string msgResultado, out string msgDados, out string Mensagem, out string Codigo, out string CIOT16)

Descrição:

Consultar a situação do CIOT. Informar o CIOT12 de 12 dígitos, em caso de sucesso retorna o CIOT16 de 16 dígitos que consiste do CIOT12 (12 dígitos) + Código de Verificação (4 dígitos).

O retorno do CIOT16 significa que existe uma Declaração de Operação de Transporte registrada para o CIOT12.

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".
*CIOT12*	string	entrada	informar o CIOT de 12 dígitos a ser consultado
*AnoDeclaracao*	inteiro	entrada	informar o ano de declaração do CIOT de 12 dígitos a ser consultado
*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
*Mensagem*	string	saída	retorna a mensagem do resultado da chamada da API
*Codigo*	string	saída	retorna o Código do erro ou sucesso no retorno da informação.
*CIOT16*	string	saída	retorna um número de 16 dígitos que consiste do CIOT (12 dígitos) + Código de Verificação (4 dígitos) caso exista uma Declaração de Operação de Transporte vinculada ao CIOT12 consultado.

Retorno da chamada:

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

{
  "CodigoIdentificacaoOperacao": "5600001196023434",
  "Codigo": [
    "111"
  ],
  "Mensagem": [
    "Código 111 - Consulta realizada com sucesso!"
  ]
}

Histórico de atualização:

2026-06-02 - versão inicial

Exemplo de JSON enviado para a API da ANTT

{
  "CodigoIdentificacaoOperacao": "560000119602",
  "AnoDeclaracao": 2026
}

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

 
{
  "CodigoIdentificacaoOperacao": "5600001196023434",
  "Codigo": [
    "111"
  ],
  "Mensagem": [
    "Código 111 - Consulta realizada com sucesso!"
  ]
}

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-02T01:29:26.5327636Z",
  "correlationId": "b96d8cfe-5742-4e4a-b6ba-a16683ad376b",
  "path": "/pefServices/api/ConsultarCIOTGerado/"
}

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 CIOT12 = "560000119602";
int AnoDeclaracao = 2026;
int cStat = 0;
string msgResultado = "";
string msgDados = "";
string msgRetWS = "";
string Mensagem = "";
string Protocolo = "";
string Codigo = "";
string CIOT16 = "";
 
// instancia DLL
 
MDFe_Util.Util util = new MDFe_Util.Util();
 
// consome API
 
msgRetWS = util.ANTT_ConsultaCIOTGerado(tpAmb, 
                                        nomeCertificado, 
                                        CIOT12,
                                        AnoDeclaracao,
                                        out cStat,
                                        out msgResultado,
                                        out msgDados,
                                        out Mensagem,
                                        out Código,
                                        out CIOT16);
 
 
 
// exibe resposta da API
 
MessageBox.Show(msgResultado,"Consultar CIOT gerado");
 
//

6.9. Consulta CIOT Gerado 6. API da ANTT para emissão do CIOT: « Anterior
6.8. Consulta Exceção

Guia de Uso do MDFe_Util v4.00