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. ⚠️ Atenção Para contratação de TAC (autônomo) ou cargas via terceiros, continue utilizando uma IPEF (eFrete ou Extratta). A integração ANTT direta é restrita a frota própria. Pré-requisitos Antes de gerar o primeiro CIOT pela ANTT direta: Certificado digital ICP-Brasil A1 ou A3 instalado e configurado na filial. RNTRC cadastrado no cadastro da filial (campo RNTRC). 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) 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. 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. 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 Revise os dados, ajuste o que for necessário e clique em Gerar CIOT (F5). Direto pela tela de consulta Acesse Movimento > Consultar CIOT. No combo Plataforma, selecione ANTT. Clique em Declarar Novo CIOT. Preencha manualmente os campos e clique em Gerar CIOT (F5). Fluxo interno Quando você clica em "Gerar CIOT", o sistema executa em sequência: Consulta a situação do transportador na ANTT — verifica se o RNTRC está ativo. Consulta a frota — verifica se as placas informadas estão vinculadas ao RNTRC do transportador. Gera o número do CIOT localmente (via biblioteca oficial da ANTT). Salva um rascunho no banco de dados (com estado PendenteEnvio). Envia a Declaração à ANTT. 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" Campo Observações Filial Sua filial transportadora (emitente da NFe). Contratado Para frota própria, é preenchido automaticamente com o próprio emitente. Destinatário Obrigatório apenas para operação Padrão (Carga Lotação). Motorista CPF do motorista. Tipo de Operação Padrão / Fracionado / TAC-Agregado. Tipo da Carga Selecione na lista (Comum, Granel Sólido, Granel Líquido, etc.). Natureza da Carga (NCM) Informe os 4 primeiros dígitos do NCM da mercadoria. A ANTT aceita apenas esse formato resumido. Peso da Carga Em quilogramas. Composição Veicular Marcado automaticamente quando há carretas vinculadas. Retorno Vazio Indica se o veículo retornará vazio. Contingência Marque caso esteja gerando em modo de contingência (webservice indisponível). 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. Acesse Movimento > Consultar CIOT. No combo Plataforma, selecione ANTT. Localize o CIOT na grid e selecione-o. Clique em Cancelar CIOT. 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. Acesse Movimento > Consultar CIOT, selecione Plataforma = ANTT. Localize o CIOT e selecione-o. Clique em Encerrar CIOT — a tela modal de encerramento abrirá. Confirme/ajuste o Peso total transportado. 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. 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: Consultar CIOT > Plataforma ANTT > selecione o registro > Retificar CIOT. Altere os campos desejados (campos não modificados não são enviados — a ANTT mantém o valor atual). Para alterar trechos: Use Adicionar Trecho para incluir novos. Use o botão Remover na grid para excluir trechos existentes. Clique em (F5) Retificar CIOT. Consultando CIOTs gerados Movimento > Consultar CIOT. 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) 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 Estado Descrição PendenteEnvio Rascunho local, ainda não enviado à ANTT. EmViagem Declarado com sucesso e válido na ANTT. Encerrado Operação concluída. Cancelado Cancelado antes do início da viagem. ErroDeclaracao Tentativa de declaração rejeitada pela ANTT — abra o registro para ajustar e tentar de novo. Resoluções para rejeições comuns Mensagem da ANTT Causa Como resolver USUARIO_NAO_AUTORIZADO Certificado digital não tem RNTRC ativo cadastrado como ETC Verifique o cadastro do RNTRC no portal da ANTT RNTRC INATIVO RNTRC do transportador não está ativo Regularize a situação no portal da ANTT Veículo bloqueado/não vinculado Placa não está vinculada ao RNTRC Vincule a placa no portal da ANTT antes de gerar Data de início no passado DataInicioViagem é anterior ao momento da declaração Ajuste a data início para o futuro CodigoTipoCarga inválido Código com zero à esquerda O sistema já trata isso automaticamente NaturezaCarga inválida NCM com mais de 4 dígitos ou com zero à esquerda inicial Use os 4 primeiros dígitos do NCM (sem zero à esquerda quando aplicável — o sistema converte) OrigemDestino não permitido (Carga Lotação) Tentativa de enviar trechos no encerramento para Tipo 1 O sistema bloqueia esse envio automaticamente para Carga Lotação Modo de contingência Caso a API da ANTT esteja indisponível no momento da operação: Marque o campo Contingência na tela de geração. O sistema gera o número do CIOT localmente (com a biblioteca oficial da ANTT) sem enviar a Declaração. Use esse número no MDF-e normalmente. 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) Aspecto ANTT direta IPEF (eFrete / Extratta) Taxa por CIOT Sem taxa de intermediação Cobrada pela IPEF Indicação Frota própria Contratação de TAC ou cargas via terceiros Autenticação Certificado ICP-Brasil Usuário/senha (eFrete) ou Token (Extratta) PDF do CIOT Não disponível Disponível (eFrete) Retificação Disponível Não disponível na v8 do manual eFrete Encerramento Disponível Disponível Suporte Em caso de dúvidas ou problemas, entre em contato com nosso suporte através dos canais oficiais.