6.4. Declara Operação de Transporte 6.4.1. Declaração Operação de Transporte: 6.4. Declara Operação de Transporte
« Anterior; 6.4.2. Veículos
Próximo »

6.4.1. Declaração Operação de Transporte

Gerar a Declaração Operação de Transporte

Assinatura

string ANTT_Declaracao(string IdOperacaoTransporte, string TipoOperacao, string CpfCnpjContratado, string RNTRCContratado, string CpfCnpjContratante, string RNTRCContratante, string CpfCnpjDestinatario, string ValorFrete, string DataDeclaracao, string IndContingencia, string JustificativaContingencia, string DataInicioViagem, string DataFimViagem, string Veiculos, string OrigemDestino, string InfPagamento, string InfIndicadoresOperacionais)

Descrição:

Gerar a Declaração Operação de Transporte

Passo a Passo para gerar a Declaração da Operação de Transporte (CIOT)

1) obter um CIOT - Código de Identificação da Operação de Transporte no serviço GeraCIOT;

2) gerar o grupo do veículo usando o ANTT_Veiculo;

3) gerar o grupo de informações da origem e destino da operação de transporte usando o ANTT_OrigemDestino;

4) gerar o grupo de informações da carga usando o ANTT_DadosCarga;

5) gerar as informações do pagamento do frete usando o ANTT_InfPagamento;

6) gerar as informações dos indicadores operacionais usando o ANTT_InfIndicadoresOperacionais;

7) gerar a declaração usando ANTT_DeclaraOpeTransp;

Parâmetros da chamada:

nome	tipo	obrig	tamanho	descrição
*IdOperacaoTransporte*	string	S	12	Informar o CIOT - Código Identificador da Operação de Transporte obtido na ANTT usando o GeraCIOT
*TipoOperacao*	string	S	1	1 - Operação Carga Lotação 2 - Operação Carga Fracionada 3 - Operação TAC-Agregado
*CpfCnpjContratado*	string	S	11 ou 14	Informar o CPF/CNPJ do transportador contratado
*RNTRCContratado*	string	S	9	Informar o RNTRC do transportador contratado
*CpfCnpjContratante*	string	S	11 ou 14	Informar o CPF/CNPJ do contratante
*RNTRCContratante*	string	N	9	Informar o RNTRC caso o contratante possua RNTRC
*CpfCnpjDestinatario*	string	N	11 ou 14	Não deve ser informado para *tipoOperacao*=3
*ValorFrete*	string	S	10,2	Informar um valor maior que zero
*DataDeclaracao*	string	S	19	Informar a data da declaração no formato AAAA-MM-DDTHH:MM:SS, a data/hora informada deve respeitar o intervalo de tolerância de 15 minutos antes até 5 minutos após a data/hora atual.
*IndContingencia*	string	S	-	true = contingência / false = fora da contingência
*JustificativaContingencia*	string	N	255	Informar a justificativa de contingência quando o *IndContingencia* = true
*DataInicioViagem*	string	S	10	Informar a data de início da viagem no formato AAAA-MM-DDTHH:MM:SS A data informada não pode ser menor que a *DataDeclaracao*
*DataFimViagem*	string	S	10	Informar a data de fim da viagem no formato AAAA-MM-DDTHH:MM:SS A data informada deve ser maior ou igual a *DataDeclaracao*
*Veiculos*	string	S	-	Informar o grupo veículos
*OrigemDestino*	string	N	-	Informar o grupo origem e destino da operação de transporte Informação obrigatória para *TipoOperacao* = 1 e 2
*DadosCarga*	string	S	-	Informar o grupo informações da carga Informação obrigatória para *TipoOperacao* = 1 e 2
*InfPagamento*	string	S	-	Informar o grupo informações do pagamento do frete
*InfIndicadoresOperacionais*	string	N	-	Informar o grupo indicadores operacionais Informação obrigatória para *TipoOperacao* = 1

Retorno da chamada:

O resultado da chamada é uma string com as informações dos Dados da Carga da operação de transporte em JSON

Histórico de atualização:

2026-06-02 - Versão inicial.

Exemplo de JSON da Declaração de Operação de Transporte com grupo de pagamento via PIX

 
{
  "IdOperacaoTransporte": "560000119602",
  "TipoOperacao": 1,
  "CpfCnpjContratado": "02699430480",
  "RNTRCContratado": "052930200",
  "CpfCnpjContratante": "10142785000190",
  "CpfCnpjDestinatario": "00000000000191",
  "ValorFrete": "123456.00",
  "DataDeclaracao": "2026-05-30T10:00:00",
  "IndContingencia": "false",
  "DataInicioViagem": "2026-06-01",
  "DataFimViagem": "2026-06-05",
  "Veiculos": [
    {
      "Placa": "ITL9C77",
      "RNTRC": "052930200",
      "NumeroEixos": "3"
    }
  ],
  "OrigemDestino": [
    {
      "Origem": {
        "CodigoMunicipioOrigem": "4115200",
        "CepOrigem": "87013230"
      },
      "Destino": {
        "CodigoMunicipioDestino": "2304400",
        "CepDestino": "60874430"
      },
      "DistanciaPercorrida": "3234",
      "QtdViagens": "1"
    }
  ],
  "DadosCarga": {
    "CodigoNaturezaCarga": "2202",
    "PesoCarga": "120",
    "CodigoTipoCarga": "5"
  },
  "InfPagamento": [
    {
      "TipoPagamento": "6",
      "ChavePix": "12345678910",
      "CpfCnpjCreditado": "00000000191",
      "IdentificadorPix": "E00416968202605292029sdZYM77Ie2l",
      "IndPagamento": "0"
    }
  ],
  "InfIndicadoresOperacionais": {
    "IndAltoDesempenho": "false",
    "IndRetornoVazio": "false",
    "ComposicaoVeicular": "false"
  }
}

Exemplo de JSON da Declaração de Operação de Transporte com informação de pagamento do frete em conta corrente

 
{
  "IdOperacaoTransporte": "560000119602",
  "TipoOperacao": 1,
  "CpfCnpjContratado": "02699430480",
  "RNTRCContratado": "052930200",
  "CpfCnpjContratante": "10142785000190",
  "CpfCnpjDestinatario": "00000000000191",
  "ValorFrete": "123456.00",
  "DataDeclaracao": "2026-05-30T10:00:00",
  "IndContingencia": "false",
  "DataInicioViagem": "2026-06-01",
  "DataFimViagem": "2026-06-05",
  "Veiculos": [
    {
      "Placa": "ITL9C77",
      "RNTRC": "052930200",
      "NumeroEixos": "3"
    }
  ],
  "OrigemDestino": [
    {
      "Origem": {
        "CodigoMunicipioOrigem": "4115200",
        "CepOrigem": "87013230"
      },
      "Destino": {
        "CodigoMunicipioDestino": "2304400",
        "CepDestino": "60874430"
      },
      "DistanciaPercorrida": "3234",
      "QtdViagens": "1"
    }
  ],
  "DadosCarga": {
    "CodigoNaturezaCarga": "2202",
    "PesoCarga": "120",
    "CodigoTipoCarga": "5"
  },
  "InfPagamento": [
    {
    "TipoPagamento": "2",
    "CodigoInstituicaoFinanceira": "323",
    "NumeroAgencia": "0001",
    "NumeroConta": "61045543731",
    "CpfCnpjCreditado": "00000000191",
    "IndPagamento": "0"
    }
  ],
  "InfIndicadoresOperacionais": {
    "IndAltoDesempenho": "false",
    "IndRetornoVazio": "false",
    "ComposicaoVeicular": "false"
  }
}

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
 
string IdOperacaoTransporte = "560000119602";  // informar com 12 dígitos, obter o CIOT12 usando o geraCIOT
string TipoOperacao = "1";
 
string CpfCnpjContratado = "02699430480";
string RNTRCContratado = "052930200";
 
string CpfCnpjContratante = "10142785000190";
string RNTRCContratante = "";
 
string CpfCnpjDestinatario= "00000000000191";
 
string ValorFrete = "123456.00";
 
string DataDeclaracao = "2026-05-29T14:00:00"; // informar no formato AAAA-MM-DDTHH:MM:SS
 
string IndContingencia = "false";
string JustificativaContingencia = "";
 
string DataInicioViagem= "2026-06-01";
string DataFimViagem= "2026-06-05";
 
// informações dos veículos - usar o ANTT_Veiculo para gerar o grupo
 
string Veiculos= "{\"Placa\": \"ITL9C77\", \"RNTRC\": \"052930200\", \"NumeroEixos\": \"3\" }";
 
// informações do trajeto - usar o ANTT_OrigemDestino para gerar o grupo
 
string OrigemDestino= "{\"Origem\": {\"CodigoMunicipioOrigem\": \"4115200\", \"CepOrigem\": \"87013230\" }, \"Destino\": {\"CodigoMunicipioDestino\": \"2304400\", \"CepDestino\": \"60874430\" }, \"DistanciaPercorrida\": \"3234\", \"QtdViagens\": \"1\" }";
 
// informações da carga - usar o ANTT_DadosCarga para gerar o grupo
 
string DadosCarga= "{ \"CodigoNaturezaCarga\": \"0001\", \"PesoCarga\": \"120\", \"CodigoTipoCarga\": \"5\", \"ContratantesCargFrac\": [\"00000000272\",\"CNPJALFATEST40\"]}";
 
// informações do pagamento do frete - usar o ANTT_InfPagamento para gerar o grupo
 
string InfPagamento= "{\"TipoPagamento\": \"6\", \"ChavePix\": \"12345678910\" , \"CpfCnpjCreditado\": \"00000000191\" , \"IdentificadorPix\": \"E00416968202605292029sdZYM77Ie2l\" , \"IndPagamento\": \"0\" }";
 
// informações dos indicadores operacionais - usar o ANTT_InfIndicadoresOperacionais para gerar o grupo
 
string InfIndicadoresOperacionais= "{\"IndAltoDesempenho\": \"false\", \"IndRetornoVazio\": \"false\", \"ComposicaoVeicular\": \"false\" }";
 
string Declaracao = "";
 
// instancia DLL
 
MDFe_Util.Util util = new MDFe_Util.Util();
 
// gera Declaração
 
Declaracao = util.ANTT_Declaracao(IdOperacaoTransporte,
                                  TipoOperacao,
                                  CpfCnpjContratado, 
                                  RNTRCContratado, 
                                  CpfCnpjContratante, 
                                  RNTRCContratante,
                                  CpfCnpjDestinatario, 
                                  ValorFrete, 
                                  DataDeclaracao, 
                                  IndContingencia, 
                                  JustificativaContingencia,
                                  DataInicioViagem, 
                                  DataFimViagem, 
                                  Veiculos,
                                  OrigemDestino,
                                  DadosCarga,
                                  InfPagamento,
                                  InfIndicadoresOperacionais);
 
// exibe JSON gerado com formatação
 
MessageBox.Show(util.formataJson(Declaracao), "gerar Declaração");
 
//

6.4.1. Declaração Operação de Transporte 6.4. Declara Operação de Transporte: « Anterior
6.4. Declara Operação de Transporte; Próximo »
6.4.2. Veículos

Guia de Uso do MDFe_Util v4.00