Manual do ConnectCIOTANTT

1. Sobre o sistema

O ConnectCIOTANTT é o gerador de CIOT (Código Identificador da Operação de Transporte) da Sistemas Connect. Lê os XMLs de CT-e da sua transportadora, monta a declaração e transmite diretamente para a ANTT em homologação ou produção, devolvendo o número de 16 dígitos pronto para uso.

2. O que é o CIOT (e a base legal da ANTT)

O CIOT — Código Identificador da Operação de Transporte é o registro eletrônico que formaliza, antes do início da viagem, a operação de transporte rodoviário de cargas e o pagamento do frete. Ele é gerado junto à ANTT e identifica de forma única aquela operação: contratante, transportador, veículos, carga, trajeto, valor e forma de pagamento.

Quem é obrigado a emitir

• TAC — Transportador Autônomo de Cargas.
• ETC equiparada a TAC — Empresa de Transporte Rodoviário de Cargas com até 3 veículos na frota do RNTRC.
• CTC — Cooperativas de Transporte Rodoviário de Cargas.
• A partir de 2026, a obrigatoriedade foi ampliada para todas as operações de transporte remunerado de cargas, inclusive empresas com frota própria.

As três modalidades de operação

Pagamento Eletrônico de Frete (PEF)

O pagamento do frete ao TAC (ou equiparado) deve ser feito eletronicamente — por crédito em conta de depósito mantida em instituição autorizada ou por outro meio regulado pela ANTT (as IPEF — Instituições de Pagamento Eletrônico de Frete). É por isso que a tela de geração pede a forma de pagamento (PIX ou Conta Corrente) e os dados do favorecido.

Piso Mínimo de Frete

Base legal (fontes oficiais)

Fontes oficiais: ANTT (portal.antt.gov.br e gov.br/antt), legislação da ANTT (anttlegis.antt.gov.br) e Lei 11.442/2007 (Planalto). Este resumo é informativo; em caso de dúvida regulatória, consulte sempre o texto oficial vigente.

3. Requisitos mínimos

• Windows 10 ou 11 (também funciona em Windows Server 2016+).
• .NET Framework 4.7.2 ou superior (incluso no Windows 10 desde 2018).
• Banco de dados: SQL Server 2014+ (rede/servidor) ou nenhum — quando não há SQL Server o sistema usa automaticamente um banco local SQLite (veja a seção 4).
• Certificado digital ICP-Brasil A1 (.pfx) da empresa transportadora.
• Acesso à internet para os endpoints da ANTT.

4. Banco de dados: SQL Server ou SQLite

O ConnectCIOTANTT guarda os dados (CIOTs emitidos, XMLs, configurações) em um banco de dados. Você pode usar SQL Server (quando há um servidor na empresa/rede) ou um banco SQLite local, que não exige instalar nem configurar servidor nenhum.

Escolha automática (você quase nunca precisa fazer nada)

1. Na primeira execução o sistema tenta conectar ao SQL Server.
2. Se conectar, segue em SQL Server.
3. Se não conectar e a máquina não tiver nenhum SQL Server instalado, o sistema configura o SQLite sozinho e abre normalmente — sem perguntar nada.
4. Se houver SQL Server instalado mas a conexão falhar, abre a tela Configurar banco para você ajustar.

Tela "Configurar banco de dados"

Abre sozinha quando necessário, ou manualmente em Configurações → Reconfigurar banco…. Nela você pode:

• Marcar "Usar banco local SQLite (não requer SQL Server)" — o caminho mais simples.
• Ou informar Servidor (o botão Detectar lista as instâncias instaladas), Banco (padrão conectciot, criado se não existir) e a Autenticação (Windows ou SQL Server com usuário/senha).
• Testar conexão e Salvar. Se nenhum SQL for detectado, há o botão "Baixar SQL Express".

5. Primeira execução

1. Instale o ConnectCIOTANTT em C:\ConectGr\ConnectCIOTANTT\.
2. Abra o programa pelo atalho do menu Iniciar.
3. Se a conexão padrão com o banco falhar, a tela Configurar acesso ao banco abre automaticamente. Preencha:
   • Servidor: ex. localhost, 10.0.0.5,1433, SRVDB\SQLEXPRESS.
   • Banco: conectciot (será criado se não existir).
   • Autenticação: Windows ou SQL Server (com usuário/senha).
4. Clique em Testar conexão e depois em Salvar.
5. O sistema cria o banco, tabelas e popula tab_aux_cidade com os 5.555 municípios do IBGE (operação única, dura poucos segundos).

6. Licença, teste, planos e renovação por Pix

Primeiro acesso: cadastro do cliente (ativa o teste)

Na primeira vez, aparece a tela "Cadastro do cliente", obrigatória. Informe CNPJ, Razão social, E-mail e Telefone e clique em "Cadastrar e ativar teste". Isso cria automaticamente uma licença de teste e libera o sistema. (Se você fechar sem cadastrar, o sistema encerra.)

Estados da licença

O banner colorido no topo da tela principal sempre mostra o estado atual (ex.: "Licença ativa até dd/mm/aaaa" ou "Licença TESTE — transmissão para ANTT bloqueada").

Renovar / ativar por Pix (autosserviço)

Pela tela de Suporte (botão "Renovar / Ativar licença") ou pelo link "Renovar licença" que aparece quando a licença não está ativa:

1. Escolha um plano na lista.
2. Clique em "Gerar Pix" — aparece o QR Code, o Pix copia-e-cola e o valor.
3. Pague pelo app do seu banco (escaneie o QR ou use "Copiar código Pix").
4. A tela verifica sozinha a cada poucos segundos: quando o pagamento é confirmado, aparece "Licença renovada com sucesso até dd/mm/aaaa". Não é preciso digitar nenhum código.

Adiar vencimento (cortesia)

Não consegue pagar agora? Na tela de renovação há o botão "Adiar vencimento (cortesia)", que prorroga o vencimento por alguns dias para você concluir o pagamento depois. A cortesia é concedida 1× por mês; a elegibilidade e o prazo são definidos pelo sistema central (se não estiver disponível no momento, a própria tela explica o motivo).

A tela de Suporte — o que ela mostra

• Sobre o sistema: versão (com a data de atualização), data de instalação e a "Renovação prevista".
• Licença: CNPJ licenciado, status colorido, data de vencimento, modo teste (Sim/Não), origem da validação (Online/Cache) e o Código da instalação.
• Contato: botão "Abrir WhatsApp" e link para este manual.
• Botões "Renovar / Ativar licença" e "Trocar empresa".

7. Cadastro de empresa(s)

No menu inicial clique em Configurações.

Cadastrando a primeira empresa

1. Clique em Nova empresa.
2. Informe CNPJ, Razão Social e RNTRC (com 9 dígitos).
3. Escolha o Ambiente:
   • Homologação para testes — não gera CIOT válido.
   • Produção para uso real — gera CIOT com efeitos legais.
4. Clique em Buscar... e selecione o arquivo .pfx do certificado A1.
5. Informe a senha do certificado, depois Ler dados para confirmar e Testar certificado para validar.
6. Aponte a Pasta XML CT-e onde estão os XMLs da empresa.
7. Clique em Salvar.

Várias filiais

Repita o passo acima para cada filial. O sistema mantém todas na grade superior da tela de Configurações e escolhe automaticamente a configuração certa pelo RNTRC informado no contratado durante a emissão.

8. Importar XMLs de CT-e

No menu inicial, clique em Lista de XML CT-e.

1. Clique em Carregar XMLs da pasta.
2. O sistema varre recursivamente a pasta configurada, ignorando arquivos que não sejam de CT-e.
3. Acompanhe o progresso no rodapé da tela.
4. A qualquer momento clique em Cancelar carga para interromper.

Carregamento incremental

Por padrão o checkbox Somente novos (incremental) fica marcado. Ele considera apenas arquivos modificados após a última importação — em pastas grandes, isso reduz minutos para segundos.

Importar arquivos avulsos

Além de varrer a pasta, o botão "Importar XMLs…" permite escolher arquivos individuais (segure Ctrl/Shift para vários). Ao final, o sistema oferece preencher a placa do cavalo em todos de uma vez.

Identificar o cavalo (placa)

A maioria dos XMLs de CT-e não traz a placa do cavalo. Selecione um ou mais CT-es e clique em "Identificar cavalo (placa)" para definir a mesma placa em lote (valida o formato Mercosul AAA0A00 ou antigo AAA0000). CT-es já emitidos não podem ter a placa alterada — ela já foi registrada na ANTT.

Status e filtros

Cada CT-e tem um status no seu ciclo de vida, usado nos filtros da lista:

Os filtros (em cascata, com contagem em cada opção) permitem filtrar por Status, Filial (emitente) e Placa; o botão "Limpar filtros" zera tudo.

9. A tela de geração de CIOT (visão geral)

Há três caminhos para abrir a tela de Geração de CIOT:

• No menu inicial, clicar em Gerar CIOT (abre a tela vazia).
• Na Lista de XML CT-e, dar duplo clique em uma linha (1 CT-e).
• Na Lista de XML CT-e, marcar várias linhas e clicar em Gerar selecionados.

Com a tela aberta e vazia, você ainda pode arrastar e soltar o XML do CT-e em cima dela, ou clicar no botão Selecionar XML (canto superior direito).

Como a tela está organizada

Os campos ficam agrupados em blocos com título em azul, de cima para baixo:

Veículos: comece só com o cavalo, adicione carretas só se precisar

Para não poluir a tela, o bloco Veículos mostra inicialmente apenas a linha do Cavalo. Para incluir reboques:

• Clique no botão + para exibir a próxima linha (Carreta 1 e depois Carreta 2).
• Clique no botão − para ocultar a última linha vazia.
• O conjunto suporta Cavalo + até 2 carretas.

Seletores rápidos

Ao lado dos campos Tipo de carga e Natureza há um botão … que abre uma lista filtrável com os códigos oficiais da ANTT. O botão … ao lado do CNPJ Destinatário aparece na Carga Fracionada com vários destinatários.

10. Gerar CIOT — Carga Lotação (1 CT-e)

É o caminho mais comum: 1 CT-e = 1 CIOT. Ao abrir a tela com um único CT-e, a primeira linha mostra a chave de acesso, a emissão, o número e a série do CT-e.

Campos preenchidos automaticamente

Indicadores operacionais

Marque conforme a operação:

• Alto desempenho — veículos do programa específico da ANTT.
• Retorno vazio — viagem de retorno sem carga.
• Composição veicular — marcado por padrão; conjunto cavalo + carretas.

Conferir o ambiente antes de transmitir

Após a transmissão

• O número do CIOT (16 dígitos) aparece no bloco Resultado (Protocolo/CIOT).
• O botão Copiar fica ativo — copia o CIOT para a área de transferência com um clique.
• O botão Imprimir PDF gera um comprovante do CIOT para salvar ou compartilhar.
• O status do XML na grade muda para CIOT_EMITIDO.

11. Gerar CIOT — Carga Fracionada (vários CT-es)

Quando vários CT-es viajam juntos no mesmo veículo, você emite um único CIOT agrupando todos eles.

Passo a passo

1. Abra a Lista de XML CT-e.
2. Marque as linhas dos CT-es que farão parte da mesma operação. O rodapé mostra um resumo: quantidade selecionada, valor total, peso total e a modalidade sugerida.
3. Clique em Gerar selecionados.

O resumo no topo da tela

Na Carga Fracionada a tela não mostra a chave/emissão/número/série de um CT-e só (não faria sentido com vários). No lugar deles aparece um quadro-resumo da operação:

• A 1ª linha traz os totais (quantidade, contratantes, valor e peso).
• A 2ª linha (em âmbar, com ⚠) traz avisos — modalidade sugerida e pontos a revisar (ex.: origens divergentes). Se o texto for longo, ele é cortado com "…"; passe o mouse para ver completo.
• O botão Ver CT-es abre uma janela com a grade detalhada de todos os CT-es (chave, número, tomador, destinatário, frete, peso, origem, destino) e, logo abaixo, a mensagem de avisos por extenso.

Os campos da tela vêm somados/consolidados (valor e peso totais, origem/destino quando únicos). Revise os Participantes, os Veículos e o Pagamento e clique em Gerar CIOT — a confirmação de ambiente é a mesma da Carga Lotação.

12. Gerar CIOT — TAC-Agregado

Use a modalidade TAC-Agregado quando o transportador autônomo coloca um veículo próprio (da sua frota no RNTRC) à disposição exclusiva de um embarcador/ETC, por um período e com remuneração certa — em vez de um frete avulso por viagem.

No combo Tipo de operação escolha "TAC Agregado". A tela então esconde automaticamente os campos que a ANTT não aceita nessa modalidade e mantém só o necessário:

13. Catálogo de carga, distância e localização

Natureza e Tipo da carga (botões "…")

Ao lado dos campos Natureza da carga e Tipo da carga há um botão … que abre uma busca com os códigos oficiais da ANTT: digite parte do código ou da descrição, a lista filtra na hora, e um duplo-clique (ou Enter) escolhe. São cerca de 1.200 naturezas e os 12 tipos de carga oficiais.

Distância (km) e Google Maps

O botão ao lado de Distância (km) abre o Google Maps no navegador, já com origem e destino preenchidos, para você conferir/copiar a distância. Se já houver histórico do mesmo trecho (origem + destino), a distância é preenchida automaticamente com o valor da última emissão.

Localização: Cidade, CEP ou Latitude/Longitude

Para origem e destino, basta uma das três formas de localização. Se informar mais de uma, o sistema envia à ANTT a mais específica, nesta ordem: Latitude/Longitude › CEP › Cidade (código IBGE). No campo de cidade você pode digitar no formato Betim/MG — o sistema busca o código IBGE e normaliza o nome/UF automaticamente.

14. Comprovante do CIOT em PDF

Após emitir (ou ao abrir um CIOT já emitido), o botão "Imprimir PDF" gera um comprovante da Declaração de Operação de Transporte (CIOT) no layout padrão, com número do CIOT, participantes, datas, carga, origem/destino, tabela de veículos, indicadores e dados de pagamento.

1. Clique em "Imprimir PDF" (só habilita quando há um CIOT de 16 dígitos).
2. Escolha onde salvar (sugere CIOT_<numero>_<data>.pdf em Documentos\ConnectCIOTANTT).
3. O sistema pergunta se deseja abrir o PDF agora — ou abre a pasta com o arquivo selecionado, pronto para anexar a um e-mail/WhatsApp.

15. Mensagem de retorno da ANTT

Quando a ANTT rejeita uma emissão (erro de negócio), o sistema abre uma janela própria, Retorno ANTT, em vez de espremer a mensagem na tela de geração.

• A mensagem da ANTT aparece em destaque, em linguagem direta (ex.: "A placa AAA2565 não pertence ao transportador de RNTRC 001526506, ou o mesmo não está ativo.").
• Quando o erro tem um código conhecido, a janela mostra uma dica do que conferir.
• Em Detalhes técnicos (recolhível) ficam ambiente, HTTP, código e URL — úteis para o suporte.
• Botões Copiar mensagem (texto amigável) e Copiar detalhes (bloco técnico completo) e Sair.

Quando a ANTT está em manutenção ou indisponível

Às vezes o problema não é o seu dado: é o próprio servidor da ANTT que está fora do ar ou em manutenção. Nesses casos o sistema mostra uma mensagem clara, em vez de um texto técnico confuso:

• "A ANTT está em manutenção no momento. Aguarde alguns minutos e tente gerar o CIOT novamente."
• "A ANTT está temporariamente indisponível (erro no servidor da ANTT). Aguarde alguns minutos e tente novamente."

16. Consultar, encerrar e cancelar

Quando você abre um CT-e que já tem CIOT (por consulta/pesquisa na lista), a tela vem preenchida com os dados do banco e bloqueada para edição — e o botão Selecionar XML fica oculto, já que não se troca o XML de um CIOT existente. Use os botões:

17. Contingência

O botão Contingência fica desabilitado por padrão.

1. Clique em Gerar CIOT normalmente.
2. Se a ANTT não responder (timeout, sem internet), o botão Contingência é liberado.
3. Preencha o campo Motivo/obs com a justificativa.
4. Clique em Contingência — o sistema transmite com a flag IndContingencia = true.

18. Plug-ins de lookup (avançado)

Se sua transportadora já tem um TMS/ERP com cadastro de conjuntos de veículos, é possível ligar o ConnectCIOTANTT a esse banco para preencher placas e eixos automaticamente ao carregar o XML.

Como funciona

1. O dev do sistema cria um arquivo .json com a connection string e a SQL.
2. Salva em C:\ConectGr\ConnectCIOTANTT\Plugins\ClientesLookup\.
3. Em Configurações, clica em ↻, escolhe o plugin no combo, salva.
4. Próximo XML carregado já vem com placas e eixos preenchidos pelo banco do cliente.

Exemplo de plug-in (Access)

{
  "Nome": "MeuSistema",
  "Driver": "OleDb",
  "ConnectionString": "Provider=Microsoft.ACE.OLEDB.12.0;Data Source=\\\\servidor\\MMsoftware\\base.mdb;Jet OLEDB:Database Password=senha;",
  "ConsultaSql": "SELECT v.placa AS placa_cavalo, v.eixos AS eixos_cavalo FROM tab_viagem WHERE chave_cte = @chave"
}

Suporta também SQL Server ("Driver": "SqlServer") e ODBC ("Driver": "Odbc"). Para casos avançados, é possível entregar uma DLL .NET implementando a interface IClienteVeiculoLookup.

Testar o plug-in

Em Configurações, selecione o plug-in, clique em Testar plugin. Cole uma chave do CT-e (44 dígitos) que existe no banco do cliente e veja a resposta na hora — o diagnóstico indica: não instalado, chave inválida, banco fora do ar, sem registro, ou registro encontrado com as placas.

19. Suporte e versão do sistema

Dentro do app, clique em Suporte na tela inicial. A janela mostra:

• Versão do sistema — em destaque, no formato 1.0.x.y (atualizado em dd/mm/aaaa). A versão se atualiza sozinha a cada nova atualização do programa, então é a forma rápida de saber se você está na última versão.
• Data de instalação e data limite para renovação.
• Botão para abrir o WhatsApp Web direto com a Sistemas Connect.
• Link para esta página de manual.

Atendimento via WhatsApp em horário comercial: +55 (31) 99060-8998.

20. Principais dúvidas (FAQ)

Sobre o CIOT e a operação

O que é o CIOT e quando preciso emitir?
É o registro eletrônico da operação de transporte na ANTT, exigido antes do início da viagem sempre que há transporte rodoviário remunerado de cargas (seção 2). Desde 2026 vale para praticamente todas as operações, inclusive frota própria.

Homologação gera CIOT válido?
Não. Homologação é só para testes; o CIOT com efeitos legais só sai em Produção. O painel mostra o ambiente em laranja (Homologação) ou verde (Produção).

O CIOT tem quantos dígitos?
O número completo tem 16 dígitos (12 do identificador da operação + 4 do código verificador).

Lotação, Fracionada ou TAC-Agregado: qual escolho?
Lotação = um contratante. Fracionada = mais de um contratante na mesma operação. TAC-Agregado = veículo do TAC à disposição exclusiva de um embarcador/ETC por 10 a 30 dias (seções 11 e 12).

Apareceu "ANTT em manutenção / indisponível". E agora?
É instabilidade no servidor da ANTT, não no seu cadastro. Aguarde alguns minutos e tente de novo (seção 15).

"A placa X não pertence ao RNTRC…". O que faço?
Confira se a placa está vinculada ao RNTRC do transportador e se esse RNTRC está ativo na ANTT. Corrija e gere novamente.

Não consegui gerar por causa do valor do frete.
Na Carga Lotação a ANTT valida o Piso Mínimo de Frete: se o valor estiver abaixo do mínimo, o CIOT não é gerado. Ajuste o valor (seção 2).

Quando uso a Contingência?
Só quando a ANTT não responde (timeout / sem internet) — nunca para erro de negócio (seção 17).

Posso usar sem SQL Server?
Sim. Sem SQL Server, o sistema usa um banco local SQLite automaticamente (seção 4).

Sobre licença, teste e renovação

Estou em "modo teste" e não consigo transmitir. É normal?
Sim. Em teste tudo funciona, menos a transmissão real à ANTT. Renove/ative a licença por Pix para liberar (seção 6).

Como renovo a licença?
Em Suporte → Renovar / Ativar licença: escolha o plano, gere o Pix, pague — a tela confirma sozinha, sem digitar código (seção 6).

Não posso pagar agora. Tenho como continuar?
Use "Adiar vencimento (cortesia)" na tela de renovação (1× por mês), que prorroga o vencimento por alguns dias.

O sistema vai parar de abrir se a licença vencer?
Não. Ele sempre abre; apenas a transmissão à ANTT fica bloqueada até a regularização.

Para a equipe de suporte

O que pedir ao cliente para localizar a instalação?
O Código da instalação (tela de Suporte) e o CNPJ licenciado. O código identifica aquela máquina no sistema central.

O cliente diz que renovou mas continua bloqueado.
Confirme a "Data de vencimento" (validação da licença) — não a "Renovação prevista", que é só um lembrete local de 30 dias. Peça para reabrir o Suporte (revalida) e cheque a internet (origem "Online" × "Cache").

O cliente trocou de computador ou quer usar outro CNPJ.
Na tela de Suporte, "Trocar empresa" limpa a licença local e libera para novo cadastro. Em bloqueio por máquina, use o Código da instalação para liberar no sistema central.

Onde estão os dados para diagnosticar uma falha de emissão?
Em Logs\falhas_ciot_aaaa-mm-dd.log, com REQUEST e RESPONSE JSON completos (seção 22).

"Erro ao executar operação" ou a ANTT oscilou.
Costuma ser transitório no lado da ANTT — oriente a tentar novamente em seguida.

21. Problemas comuns

22. Logs e diagnóstico

Quando algo dá errado, estes arquivos ajudam você e o suporte a entender o que aconteceu:

A pasta padrão do app é C:\ConectGr\ConnectCIOTANTT\ (pode variar se outro local foi escolhido na instalação).