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

6.1. Gera CIOT

Gerar um CIOT - Código de Identificação de Operação de Transporte

Assinatura

string ANTT_GeraCIOT(int tpAmb, string nomeCertificado, string CpfCnpj, out int cStat, out string msgResultado, out string msgDados, out string CIOT12, out string DataGeracao, out string Mensagem)

Descrição:

O CIOT - Código de Identificação de Operação de Transporte é um número de 12 dígitos administrado pela ANTT.

Para o obter o CIOT - Código de Identificação de Operação de Transporte é necessário consumir a API da ANTT informando o CNPJ ou CPF de quem vai emitir a Declaração da Operação de Transporte.

O próximo passo após a obtenção do CIOT - Código de Identificação de Operação de Transporte é gerar a Declaração da Operação de Transporte e envia-la para ANTT, que será validada e registrada se não houver erros de preenchimento.

A Declaração da Operação de Transporte registrada pela ANTT recebe um código de validação de quatro dígitos que deve ser informada com o CIOT para realizar a retificação, cancelamento ou encerramento da Declaração da Operação de Transporte.

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".
CpfCNPJ string entrada informar o CPF ou CNPJ do emissor da Declaração da Operação de Transporte
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
CIOT12 string saída retorna o CIOT -Código de Identificação de Operação de Transporte de 12 dígitos gerado pela ANTT
DataGeracao string saída retorna a data de geração do CIOT
Mensagem string saída retorna a mensagem do resultado da chamada da API

Retorno da chamada:

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

{
  "Sucesso": true,
  "Mensagem": "CIOT gerado com sucesso",
  "Dados": {
    "CIOT": "560000131393",
    "CpfCnpj": "000.000.001-91",
    "DataGeracao": "2026-06-01T18:26:36.9414556"
  },
  "Erros": null
}

Histórico de atualização:

Exemplo de JSON enviado para a API da ANTT

{
  "CpfCnpj": "00000000191"
}

Exemplo de JSON da resposta "CIOT gerado com sucesso"

 
{
  "Sucesso": true,
  "Mensagem": "CIOT gerado com sucesso",
  "Dados": {
    "CIOT": "560000131393",
    "CpfCnpj": "000.000.001-91",
    "DataGeracao": "2026-06-01T18:26:36.9414556"
  },
  "Erros": null
}

Exemplo de JSON da resposta: "CPF/CNPJ é inválido"

{
  "Sucesso": false,
  "Mensagem": "CPF/CNPJ é inválido",
  "Dados": null,
  "Erros": [
    "CPF/CNPJ deve ser válido"
  ]
}

Importante

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

Exemplos de uso:

c#

 
// 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 CpfCnpj = "00000000191";
string CIOT = "";
int cStat = 0;
string msgResultado = "";
string msgDados = "";
string msgRetWS = "";
string Mensagem = "";
string DataGeracao = "";
 
// instancia DLL
 
MDFe_Util.Util util = new MDFe_Util.Util();
 
// consome API
 
msgRetWS = util.ANTT_GeraCIOT(tpAmb, 
                              nomeCertificado,
                              CpfCnpj,
                              out cStat,
                              out msgResultado,
                              out msgDados,
                              out CIOT,
                              out DataGeracao,
                              out Mensagem);
 
// exibe resposta da API
 
MessageBox.Show(msgResultado,"Gerar CIOT");
 
//
6.1. Gera CIOT
6. API da ANTT para emissão do CIOT
« Anterior
6. API da ANTT para emissão do CIOT
Próximo »
6.2. Consulta Situação Transportador