6. API da ANTT para emissão do CIOT
6.5. Cancela Operação de Transporte
6.4.6. Indicadores Operacionais
« Anterior
6.6. Retifica Operação de Transporte
Próximo »

6.5. Cancela Operação de Transporte

Cancelar Operação de Transporte (CIOT)

Assinatura

string ANTT_CancelaOpeTransp(int tpAmb, string nomeCertificado, string CIOT16, string MotivoCancelamento, out int cStat, out string msgResultado, out string msgDados, out string DataCancelamento, out string Protocolo, out string Codigo, out string Mensagem)

Descrição:

Serviço destinado a cancelar uma determinada operação de transporte, desde que ela ainda não tenha sido realizada.

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".
CIOT16 string entrada informar o CIOT de 12 dígitos + Código de Verificação (4 dígitos) da Declaração de Transporte a ser cancelada
MotivoCancelamento string entrada informar o motivo do cancelamento da Declaraçã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
DataCancelamento string saída retorna a data e hora de cancelamento da Operação de Transporte.
Protocolo string saída retorna o Protocolo de sucesso no Cancelamento
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_CancelaOpeTransp é a resposta JSON, exemplo:

{
  "CodigoIdentificacaoOperacao": "5600001196023434",
  "DataCancelamento": null,
  "Protocolo": null,
  "Codigo": "222",
  "Mensagem": ["Rejeição: Operação de Transporte já está cancelada."]
}

Histórico de atualização:

Exemplo de JSON enviado para a API da ANTT

{
  "CodigoIdentificacaoOperacao": "5600001196023434",
  "MotivoCancelamento": "CIOT Cancelado para testar o cancelamento"
}

Exemplo de JSON da Cancelamento realizado com sucesso

 
{
  "CodigoIdentificacaoOperacao": "5600001196023434",
  "DataCancelamento": "2026-05-30T16:19:34.7812899",
  "Protocolo": "C98000000001004",
  "Codigo": "110",
  "Mensagem": "Dados inseridos com sucesso!"
}

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

{
  "CodigoIdentificacaoOperacao": "5600001196023434",
  "DataCancelamento": null,
  "Protocolo": null,
  "Codigo": "222",
  "Mensagem": ["Rejeição: Operação de Transporte já está cancelada."]
}

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:51:48.7688599Z",
  "correlationId": "ec6e3919-8c58-41b1-a80d-f21798bcd67f",
  "path": "/pefServices/api/CancelamentoOperacaoTransporte/"
}

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 CIOT16 = "560000119602";  // CIOT (12) + protocoloANTT (4)
string MotivoCancelamento = "CIOT Cancelado para testar o cancelamento";
string DataCancelamento = "";
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_CancelaOpeTransp(tpAmb,
                                      nomeCertificado, 
                                      CIOT16,
                                      MotivoCancelamento,
                                      out cStat,
                                      out msgResultado,
                                      out msgDados,
                                      out DataCancelamento,
                                      out Protocolo,
                                      out Codigo,
                                      out Mensagem);
 
 
 
// exibe resposta da API
 
MessageBox.Show(msgResultado,"Cancelamento CIOT");
 
//
6.5. Cancela Operação de Transporte
6. API da ANTT para emissão do CIOT
« Anterior
6.4.6. Indicadores Operacionais
Próximo »
6.6. Retifica Operação de Transporte