6. API da ANTT para emissão do CIOT 6.7. Encerra Operação de Transporte: 6.6.2. Gerar Retificação Origem e destino
« Anterior; 6.7.1. Gerar Encerramento Operação de Transporte
Próximo »

6.7. Encerra Operação de Transporte

Sumário

Encerra Operação de Transporte (CIOT)

Assinatura

string ANTT_EncerraOpeTransp(int tpAmb, string nomeCertificado, string Encerramento, out int cStat, out string msgResultado, out string msgDados, out string DataEncerramento, out string Protocolo, out string Codigo, out string Mensagem)

Descrição:

Serviço destinado a encerrar uma operação de transporte, declarando que a mesma foi executada com sucesso e que chegou ao seu fim.

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".
*Encerramento*	string	entrada	informar os dados do Encerramento
*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
*DataEncerramento*	string	saída	retorna a data e hora de encerramento da Operação de Transporte.
*Protocolo*	string	saída	retorna o Protocolo de sucesso no encerramento
*Codigo*	string	saída	retorna o Código do erro ou sucesso no retorno da informação.
*Mensagem*	string	saída	retorna a mensagem do resultado da chamada da API

Retorno da chamada:

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

{
  "CodigoIdentificacaoOperacao": "5600001196023434",
  "DataEncerramento": "2026-06-02T21:44:49.8234715",
  "Codigo": "110",
  "Mensagem": "Dados inseridos com sucesso!",
  "Protocolo": "T98000000000720"
}

Histórico de atualização:

2026-06-01 - versão inicial

Exemplo de JSON enviado para a API da ANTT

{
  "CodigoIdentificacaoOperacao": "5600001196023434",
  "DadosCarga": {
    "PesoTotalCarga": "10000.00"
  }

Exemplo de JSON da Encerramento realizado com sucesso

 
{
  "CodigoIdentificacaoOperacao": "5600001196023434",
  "DataEncerramento": "2026-06-02T21:44:49.8234715",
  "Codigo": "110",
  "Mensagem": "Dados inseridos com sucesso!",
  "Protocolo": "T98000000000720"
}

Exemplo de JSON da resposta de rejeição de encerramento

{
  "CodigoIdentificacaoOperacao": "5600001196023435",
  "DataEncerramento": null,
  "Codigo": "220",
  "Mensagem": ["O CPF/CNPJ do certificado digital não corresponde ao transportador responsável pelo CIOT informado e, por isso, não possui permissão para realizar a operação.","Rejeição: Não foi encontrada nenhuma Operação de Transporte com os dados informados."],
  "Protocolo": "N98000000000726"
}

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-03T00:50:37.9405392Z",
  "correlationId": "cbd345d9-e898-4849-b451-4461224a29e8",
  "path": "/pefServices/api/EncerramentoOperacaoTransporte/"
}

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";
 
// usar a funcionalidade ANTT_Encerramento para gerar o Encerramento 
 
string Encerramento ="{\"CodigoIdentificacaoOperacao\": \"5600001196023434\", \"DadosCarga\": {\"PesoTotalCarga\": \"10000.00\"}";
 
string DataEncerramento = "";
string Protocolo = "";
int cStat = 0;
string msgResultado = "";
string msgDados = "";
string msgRetWS = "";
string Mensagem = "";
string Codigo = "";
 
// instancia DLL
 
MDFe_Util.Util util = new MDFe_Util.Util();
 
// consome API
 
msgRetWS = util.ANTT_EncerraOpeTransp(tpAmb,
                                      nomeCertificado, 
                                      Encerramento,
                                      out cStat,
                                      out msgResultado,
                                      out msgDados,
                                      out DataEncerramento,
                                      out Protocolo,
                                      out Codigo,
                                      out Mensagem);
 
 
 
// exibe resposta da API
 
MessageBox.Show(msgResultado,"Encerramento CIOT");
 
//

6.7. Encerra Operação de Transporte 6. API da ANTT para emissão do CIOT: « Anterior
6.6.2. Gerar Retificação Origem e destino; Próximo »
6.7.1. Gerar Encerramento Operação de Transporte

Guia de Uso do MDFe_Util v4.00