Geração de CIOT por Integração direta com a ANTT

Visão geral

O TryERP agora permite a geração de CIOT (Código Identificador da Operação de Transporte) diretamente pela API da ANTT, sem intermediário (IPEF). Essa integração é indicada para empresas com frota própria que possuem RNTRC ativo e desejam evitar as taxas cobradas pelas IPEFs (eFrete, Extratta, etc.).

A integração cobre todo o ciclo de vida do CIOT:

• Geração (Declaração)
• Cancelamento
• Encerramento
• Retificação
• Consulta

Toda comunicação com a ANTT usa certificado digital ICP-Brasil A1/A3 (TLS mútuo), o mesmo certificado já utilizado para emissão de NFe/MDF-e.

Quem pode usar

A integração direta com a ANTT é destinada a:

• Empresas com RNTRC ativo e cadastradas como ETC (Empresa de Transporte de Cargas) na ANTT.
• Frota própria — o transportador é o próprio emitente da NFe/MDF-e.

Pré-requisitos

Antes de gerar o primeiro CIOT pela ANTT direta:

1. Certificado digital ICP-Brasil A1 ou A3 instalado e configurado na filial.
2. RNTRC cadastrado no cadastro da filial (campo RNTRC).
3. Operador apto — confirme o Ambiente (Produção ou Homologação) nas configurações do operador.

💡 Importante: Caso você utilize várias filiais e algumas trabalhem com IPEF (eFrete ou Extratta), elas continuam funcionando normalmente. Para filiais com mais de uma integração configurada, o sistema perguntará qual usar a cada nova geração.

Gerando um CIOT pela ANTT

A partir do MDF-e (recomendado)

1. Na tela de emissão de MDF-e, após preencher os dados normalmente (municípios, veículos, motoristas, contratante, documentos relacionados, etc.), clique no botão Gerar CIOT.
2. Se a filial tiver mais de uma plataforma configurada (ex.: ANTT + Extratta), aparecerá uma tela de seleção:
   • ANTT (direta) — geração via API da ANTT, indicada para frota própria.
   • Extratta (IPEF) — intermediação Extratta, indicada para contratação de TAC.
   • eFrete (IPEF) — intermediação eFrete, alternativa à Extratta.
3. Escolhendo ANTT, a tela Geração do CIOT (ANTT) abrirá com os campos já pré-preenchidos a partir do MDF-e:
   • Filial, motorista, destinatário
   • Datas de início/fim da viagem
   • Tipo de carga, NCM, peso
   • Veículo de tração e carretas (composição veicular)
   • Valor do frete
   • Município/CEP/Lat-Lon de origem e destino (com distância rodoviária calculada via geolocalização)
   • Dados bancários do contratado (banco, agência, conta) — vindos do cadastro do parceiro
4. Revise os dados, ajuste o que for necessário e clique em Gerar CIOT (F5).

Direto pela tela de consulta

1. Acesse Movimento > Consultar CIOT.
2. No combo Plataforma, selecione ANTT.
3. Clique em Declarar Novo CIOT.
4. Preencha manualmente os campos e clique em Gerar CIOT (F5).

Fluxo interno

Quando você clica em "Gerar CIOT", o sistema executa em sequência:

1. Consulta a situação do transportador na ANTT — verifica se o RNTRC está ativo.
2. Consulta a frota — verifica se as placas informadas estão vinculadas ao RNTRC do transportador.
3. Gera o número do CIOT localmente (via biblioteca oficial da ANTT).
4. Salva um rascunho no banco de dados (com estado PendenteEnvio).
5. Envia a Declaração à ANTT.
6. Atualiza o registro local com o protocolo e código verificador retornados.

Se houver rejeição em qualquer etapa, o sistema mostra a mensagem retornada pela ANTT e o registro fica com estado ErroDeclaracao para você reabrir, ajustar e tentar de novo (o número do CIOT é preservado).

Campos importantes na tela de geração

Aba "Dados"

Aba "Veículos"

• Veículo de Tração — selecione o cavalo (deve estar no cadastro de veículos vinculado ao emitente).
• Carretas — checked combo box para selecionar uma ou mais carretas.

💡 As placas são validadas automaticamente contra a frota cadastrada no RNTRC junto à ANTT.

Aba "Origem/Destino"

A grid permite múltiplos trechos. Para cada par origem/destino, informe:

• Município de origem e destino
• CEP de origem e destino
• Coordenadas (latitude/longitude) — preenchidas automaticamente ao buscar pelo CEP
• Distância em quilômetros — calculada via geolocalização

💡 Os botões de "Buscar geo" e "Recalcular distância" facilitam o preenchimento.

Aba "Pagamento"

A grid permite múltiplas parcelas. Para cada pagamento, informe:

• Forma: Dados Bancários ou PIX
• Indicador: À Vista ou A Prazo
• CPF/CNPJ Creditado
• Banco, Agência, Conta Corrente (para Dados Bancários) ou Identificador PIX (para PIX)
• Data do Depósito e Valor

Aba "Fracionado"

Lista dos contratantes adicionais — obrigatória apenas para operações fracionadas (Tipo 2).

Cancelando um CIOT

⚠️ O cancelamento só é aceito pela ANTT até 24 horas antes do início da viagem.

1. Acesse Movimento > Consultar CIOT.
2. No combo Plataforma, selecione ANTT.
3. Localize o CIOT na grid e selecione-o.
4. Clique em Cancelar CIOT.
5. Informe o motivo do cancelamento e confirme.

O sistema atualiza o estado do CIOT para Cancelado e grava o protocolo retornado pela ANTT.

Encerrando um CIOT

⚠️ O encerramento deve ser feito em até 5 dias após a data prevista de fim da viagem. Após esse prazo, a ANTT encerra automaticamente.

1. Acesse Movimento > Consultar CIOT, selecione Plataforma = ANTT.
2. Localize o CIOT e selecione-o.
3. Clique em Encerrar CIOT — a tela modal de encerramento abrirá.
4. Confirme/ajuste o Peso total transportado.
5. Para CIOTs do tipo TAC-Agregado:
   • Adicione os trechos efetivamente realizados (origem, destino, distância e quantidade de viagens) usando a área "Adicionar Trecho".
   • Os botões de geolocalização ajudam a preencher Lat/Lon a partir do CEP.
6. Clique em (F5) Encerrar CIOT para concluir.

💡 Para Carga Lotação (Tipo Padrão) e Fracionado: os trechos já foram declarados, então não precisam ser informados aqui. A grid aparece apenas como referência informativa.

Retificando um CIOT

A retificação permite alterar dados de um CIOT já declarado.

⚠️ Até o término da viagem (Carga Lotação/Fracionado) ou 30 dias após a data fim para TAC-Agregado.

Campos que podem ser retificados:

• Valor do Frete
• Data Fim da Viagem
• Peso da Carga, Tipo da Carga e Natureza da Carga (NCM)
• Trechos de origem/destino

Campos que NÃO podem ser retificados (precisaria cancelar e reemitir):

• Partes (transportador, contratante, motorista, destinatário)
• Veículos
• Forma de pagamento

Passos:

1. Consultar CIOT > Plataforma ANTT > selecione o registro > Retificar CIOT.
2. Altere os campos desejados (campos não modificados não são enviados — a ANTT mantém o valor atual).
3. Para alterar trechos:
   • Use Adicionar Trecho para incluir novos.
   • Use o botão Remover na grid para excluir trechos existentes.
4. Clique em (F5) Retificar CIOT.

Consultando CIOTs gerados

1. Movimento > Consultar CIOT.
2. Filtros disponíveis:
   • Plataforma (eFrete / ANTT)
   • Filial
   • Contratado
   • Tipo de Operação
   • Meio de Pagamento
   • Estado do CIOT (PendenteEnvio, EmViagem, Encerrado, Cancelado, ErroDeclaracao)
   • Período (data de geração)
3. Informe os filtros e clique em Pesquisar.

Duplo clique em uma linha abre a tela de edição/visualização do CIOT.

Ambientes (Produção e Homologação)

A integração suporta dois ambientes da ANTT:

• Produção — emissão real de CIOTs com validade legal.
• Homologação — ambiente de testes (https://appservices-hml.antt.gov.br/pefServices/).

O ambiente é definido pela configuração do operador no momento da geração. Uma vez gerado, o CIOT fica vinculado ao ambiente em que foi criado — todas as operações subsequentes (cancelamento, encerramento, retificação) são automaticamente direcionadas para o mesmo ambiente, mesmo que o operador altere sua configuração depois.

Quando você está em ambiente de Homologação, um destaque visual aparece no topo da tela de geração.

Estados do CIOT

Resoluções para rejeições comuns

Modo de contingência

Caso a API da ANTT esteja indisponível no momento da operação:

1. Marque o campo Contingência na tela de geração.
2. O sistema gera o número do CIOT localmente (com a biblioteca oficial da ANTT) sem enviar a Declaração.
3. Use esse número no MDF-e normalmente.
4. Até 168 horas (7 dias) após o restabelecimento do serviço, retorne ao CIOT e clique em "Gerar CIOT" novamente para concluir a Declaração na ANTT.

A justificativa enviada à ANTT é padrão: "Indisponibilidade do webservice da ANTT no momento da declaração da operação de transporte."

Diferenças entre ANTT direta e IPEFs (eFrete / Extratta)

Suporte

Em caso de dúvidas ou problemas, entre em contato com nosso suporte através dos canais oficiais.