Versão 1.4.6
Sistema desktop para gestão e declaração de CIOT (Código de Identificação da Operação de Transporte) junto à ANTT.
O CIOT AnDes é um aplicativo desktop que permite a transportadoras e embarcadores gerenciar e declarar operações de transporte junto à ANTT (Agência Nacional de Transportes Terrestres), em conformidade com o layout DCS PEF v1.1.
Com ele você pode:
Não atendemos operações com TAC (Transporte Autônomo de Cargas).
CIOT (Código de Identificação da Operação de Transporte) é o código obrigatório emitido pela ANTT para identificar cada operação de transporte de carga. Toda transportadora registrada na ANTT precisa declarar o CIOT antes do início da viagem.
Assista ao vídeo abaixo para conhecer os principais recursos do CIOT AnDes:
Acesse: https://www.youtube.com/watch?v=hyUcwn_f924
Ao iniciar, o aplicativo exibe a tela de entrada com o logo do CIOT e os campos:
| Campo | Descrição |
|---|---|
| Seu endereço de e-mail cadastrado | |
| Senha | Sua senha de acesso (com opção de exibir caracteres) |
Abaixo dos campos, encontra-se o botão "Entrar" para acessar o sistema.
Caso o servidor de autenticação esteja indisponível e você já tenha acessado anteriormente, aparecerá o botão "Continuar offline" para acessar em modo desconectado.
Há também o link "Tutorial", que abre o vídeo institucional do sistema.
O cadastro de usuários não é feito dentro do aplicativo. Seu administrador criará seu acesso no sistema corporativo. Você receberá seu e-mail e senha para acessar.
Usuários com perfil administrador, após autenticar, veem uma tela para selecionar a empresa na qual desejam trabalhar. Basta digitar o nome ou CNPJ da empresa e clicar em "Carregar".
Usuários comuns acessam diretamente a empresa à qual estão vinculados.
Se você já estiver logado em outro computador, o sistema alertará:
"Já existe uma sessão ativa para este usuário."
Você pode encerrar a sessão anterior e continuar, ou cancelar.
O dashboard é a tela inicial após o login. Ele mostra um resumo das operações de transporte da empresa.
No topo, seis cartões coloridos exibem os totais de operações:
| Indicador | Cor | O que significa |
|---|---|---|
| Total | Azul | Todas as operações cadastradas |
| Abertos | Verde | Operações em rascunho (ainda não declaradas) |
| Declarados | Verde-água | CIOTs declarados com sucesso na ANTT |
| Encerrados | Índigo | Operações encerradas (viagem concluída) |
| Cancelados | Vermelho | Operações canceladas |
| Retificados | Laranja | Operações que foram retificadas |
Clique em qualquer cartão para ver a lista filtrada por aquele status.
Botões de atalho para as principais funcionalidades:
| Botão | O que faz |
|---|---|
| Nova declaração | Abre o formulário para declarar uma nova operação |
| Participantes | Abre o cadastro de participantes (contratados, contratantes, destinatários) |
| Veículos | Abre o cadastro de veículos |
| Consultas | Abre o painel de consultas à ANTT |
| Listar CIOTs | Exibe a lista de todas as operações cadastradas |
| Tutorial | Abre o vídeo institucional do sistema |
Uma tabela com as 5 operações mais recentes, mostrando:
Clique em "Participantes" no dashboard ou no menu lateral (ícone de contato).
Tela para gerenciar pessoas e empresas que participam das operações de transporte:
Clique em "Novo Participante" para cadastrar ou no ícone de lápis para editar um existente.
| Campo | Obrigatório | Descrição |
|---|---|---|
| CPF/CNPJ | Sim | Apenas números. Utilizado como identificador único |
| Razão Social | Não | Nome completo ou razão social |
| Fantasia | Não | Nome fantasia |
| RNTRC | Não | Registro Nacional de Transportadores |
| Código IBGE | Não | Código de 7 dígitos do município |
| Cidade/UF | Não | Ex: São Paulo/SP |
| Não | Telefone com DDD | |
| Não | Endereço de e-mail | |
| Ativo | Não | Flag para ativar/inativar o cadastro. Registros inativos não aparecem nos campos de autopreenchimento nem nas listas (a menos que o filtro "Exibir inativos" esteja ativado) |
Dicas importantes:
Use a barra de busca no topo para localizar participantes por nome, CNPJ ou cidade.
Ao lado da barra de busca, há um flag "Exibir inativos". Quando desligado (padrão), apenas participantes ativos aparecem na lista. Ao ativar o flag, participantes inativos passam a ser exibidos com um indicador vermelho.
Na tabela, cada registro exibe um círculo colorido no início da linha:
ativo);ativo aceita os valores 1, 0, true, false, sim ou não.Clique no ícone de lixeira (vermelho) para excluir um participante. Uma confirmação será exibida antes de excluir.
Clique em "Veículos" no dashboard ou no menu lateral (ícone de caminhão).
Gerenciamento da frota de veículos utilizados nas operações de transporte.
Clique em "Novo Veículo" ou no ícone de lápis para editar.
| Campo | Obrigatório | Descrição |
|---|---|---|
| Placa | Sim | Formato Mercosul (AAA0A00) ou antigo (AAA0000) |
| Nº de Eixos | Sim | Quantidade de eixos (2 a 9) |
| RNTRC | Não | RNTRC do veículo |
| Descrição | Não | Descrição livre. Se deixado em branco, será autogerada |
| Ativo | Não | Flag para ativar/inativar o veículo. Veículos inativos não aparecem nos campos de autopreenchimento nem nas listas, inclusive na busca por veículo principal (a menos que o filtro "Exibir inativos" esteja ativado) |
Vínculo com Veículo Principal:
Para reboques e semirreboques, é possível vincular ao veículo principal (cavalo). Conforme digita a placa do cavalo, o sistema sugere veículos cadastrados (apenas ativos). Ao selecionar, vincula automaticamente.
Use a barra de busca para localizar veículos por placa ou descrição.
Ao lado da barra de busca, há um flag "Exibir inativos". Quando desligado (padrão), apenas veículos ativos aparecem na lista. Ao ativar, veículos inativos passam a ser exibidos com indicador vermelho.
Na tabela, cada registro exibe um círculo colorido no início da linha:
ativo);ativo aceita 1, 0, true, false, sim ou não.Clique no ícone de lixeira para excluir. Confirmação será exibida antes.
Clique em "Nova declaração" no dashboard, no botão "Nova declaração" na lista de operações, ou no botão "Declarar CIOT" na lista.
O formulário de declaração possui 10 abas que guiam o preenchimento passo a passo. No topo, há botões para Salvar (rascunho) e Enviar para ANTT, além de opções para importar/exportar CSV.
Ordem de navegação por Tab: Ao pressionar Tab nos campos de texto, o foco segue a ordem: CPF/CNPJ → Botão "Buscar no ERP" → Razão Social → RNTRC. O foco permanece dentro do formulário sem escapar para o menu lateral.
Dados gerais da operação.
| Campo | Descrição |
|---|---|
| Tipo de operação | Selecione: 1 - Carga Lotação ou 2 - Carga Fracionada (Tipo 3 - TAC não é suportado) |
| CIOT | Clique em "Gerar CIOT" para gerar automaticamente, ou digite manualmente |
| Operação em Contingência | Ative apenas se estiver declarando em contingência (indisponibilidade da ANTT). Ao ativar, informe a justificativa. |
Indicadores Operacionais (disponível apenas para Tipo 1 - Lotação):
Dados do transportador que executa o frete.
| Campo | Descrição |
|---|---|
| CPF/CNPJ Contratado | Digite apenas números. O sistema busca automaticamente em cadastros existentes |
| Razão Social | Preenchido automaticamente ao selecionar um cadastro, ou digite manualmente |
| RNTRC Contratado | Nº do RNTRC do transportador |
Ordem de Tab: CPF/CNPJ → Botão "Buscar no ERP" → Razão Social → RNTRC. Ao digitar o CPF/CNPJ e pressionar Enter, o foco vai para o botão "Buscar no ERP". Pressionando Enter novamente, vai para Razão Social.
O botão "Buscar no ERP" consulta o sistema corporativo (se configurado) para localizar o transportador.
Dados de quem contrata o transporte.
| Campo | Descrição |
|---|---|
| CPF/CNPJ Contratante | Apenas números, com autocomplete |
| Razão Social | Preenchido automaticamente ou manual |
| RNTRC Contratante (opcional) | Informe o RNTRC do contratante, se disponível |
Ordem de Tab: CPF/CNPJ → Botão "Buscar no ERP" → Razão Social → RNTRC.
Dados de quem recebe a carga.
| Campo | Descrição |
|---|---|
| CPF/CNPJ Destinatário | Apenas números, com autocomplete |
| Razão Social | Preenchido automaticamente ou manual |
Ordem de Tab: CPF/CNPJ → Botão "Buscar no ERP" → Razão Social.
O destinatário é obrigatório para Tipo 1 (Lotação). Para Tipo 2 (Fracionada), o destinatário é identificado nos trechos.
Datas relacionadas à operação.
| Campo | Descrição |
|---|---|
| Data da declaração | Preenchida automaticamente com a data/hora atual |
| Data de Início da Viagem | Data de início da viagem (calendário) |
| Data de Fim da Viagem | Data prevista de término (calendário) |
Lista de veículos envolvidos na operação.
Trechos da viagem (origem e destino).
Dados da carga transportada.
| Campo | Descrição |
|---|---|
| Código Natureza da Carga | Código NCM de 4 dígitos. Digite ou clique em "Buscar NCM" |
| Peso da Carga (kg) | Peso em quilogramas |
| Tipo de Carga | Selecione entre 12 tipos (Grão sólido, Granel líquido, Frigorificada, Conteinerizada, Carga Geral, Neogranel, Perigosa, etc.) |
Contratantes Carga Fracionada (visível apenas para Tipo 2):
Valores financeiros do frete.
| Campo | Descrição |
|---|---|
| Valor do Frete (R$) | Valor total do frete em reais |
| Valor Piso Mínimo (R$) - informativo | Exibe o piso mínimo calculado |
Clique em "Calcular Piso Mínimo" para calcular automaticamente o valor mínimo de frete conforme a tabela da ANTT (Resolução 6.084/2026) vigente na data da declaração. O cálculo leva em conta:
Preencha Tipo de operação, distância total, Tipo de Carga e Eixos antes de calcular.
Informações de pagamento do frete.
| Campo | Descrição |
|---|---|
| Tipo de Pagamento | IP (cartão pré-pago), Conta Corrente, Conta Poupança, Conta de Pagamento, Outros ou Pix |
| Código Instituição Financeira | Código do banco (ex: 001). Visível para tipos 2 a 4 |
| Nº Agência | Agência bancária |
| Nº Conta | Conta bancária |
| Chave Pix | Chave Pix (CPF, CNPJ, e-mail ou telefone). Visível apenas para tipo Pix |
| CPF/CNPJ Creditado | Quem receberá o pagamento. Com autocomplete |
| Indicação de Pagamento | À vista ou A prazo |
Parcelas: Se selecionar "A prazo", adicione as parcelas com número, data de vencimento e valor.
Após preencher, clique em "Salvar Pagamento" para adicionar à lista.
Clique em "Listar CIOTs" no dashboard ou no menu lateral (ícone de lista).
No topo da tela, diversos filtros para localizar operações:
| Filtro | Opções |
|---|---|
| Status | Todos, Aberto, Encerrado, Cancelado, Retificado, Declarado |
| Tipo | Todos, Carga Lotação, Carga Fracionada |
| Buscar por | CIOT, Contratante (CPF/CNPJ), Contratado (CPF/CNPJ), Protocolo ANTT, ID operação |
| Valor | Digite o valor para busca |
| Data | Filtro por Data de declaração, Início da Viagem ou Fim da Viagem, com intervalo de datas |
Use o botão de limpar (X) para resetar os filtros.
A tabela exibe as operações com as colunas:
Clique no ícone de três pontos (...) ao lado de cada operação para:
| Ação | Quando disponível |
|---|---|
| Detalhes | Sempre |
| Duplicar | Sempre |
| Copiar CIOT | Quando já declarado |
| Enviar ANTT | Quando status = Aberto |
| Editar | Quando Aberto, ou Declarado/Retificado para tipos 2 e 3 |
| Excluir | Quando Aberto |
Navegue pelas páginas com os botões: Primeira / Anterior / Próxima / Última.
Clique em "Detalhes" no menu de ações de uma operação na lista, ou clique em um dos cartões de estatísticas no dashboard.
O topo da tela exibe:
Os botões disponíveis dependem do status da operação:
| Botão | Quando | O que faz |
|---|---|---|
| Enviar para ANTT | Aberto (sem contingência) | Declara a operação na ANTT |
| Transmitir para ANTT | Aberto (em contingência) | Transmite operação em contingência |
| Editar | Aberto, ou Declarado/Retificado (tipos 2 e 3) | Permite alterar dados |
| Encerrar | Declarado ou Retificado (dentro do prazo) | Encerra a operação |
| Cancelar | Declarado ou Retificado | Cancela a operação (com motivo) |
| Retificar | Conforme regras de prazo | Retifica a operação |
| Consultar CIOT Gerado | Quando CIOT foi gerado | Consulta situação na ANTT |
| Exportar JSON | Sempre | Exporta os dados da operação em formato JSON |
| Voltar | Sempre | Retorna à lista |
| Aba | Conteúdo |
|---|---|
| Geral | Todos os dados da operação: identificação, partes (contratado, contratante, destinatário), valores, carga, indicadores, contingência, datas, protocolo/retorno ANTT |
| Veículos | Tabela com ordem, placa, RNTRC e eixos dos veículos |
| Origem/Destino | Tabela com municípios de origem/destino, CEP, distância e viagens |
| Pagamento | Tabela com tipo, CPF/CNPJ creditado, instituição, agência, conta, PIX e indicação |
| Histórico | Linha do tempo com todas as alterações de status: data/hora, status anterior, status novo, motivo e protocolo |
Clique em "Exportar JSON" para salvar um arquivo com todos os dados da operação em formato JSON. O arquivo será salvo na pasta configurada (ou na Área de Trabalho).
Clique em "Consultas" no dashboard ou no menu lateral.
A tela possui 5 abas de consulta.
Consulta a situação cadastral de um transportador na ANTT.
| Campo | Descrição |
|---|---|
| CPF/CNPJ Interessado | Quem está fazendo a consulta |
| CPF/CNPJ Transportador | Transportador a ser consultado |
| RNTRC Transportador | Ou informe o RNTRC |
Resultado exibe: Nome/Razão Social, RNTRC Ativo (Sim/Não), Tipo, Protocolo e Código/Mensagem de retorno.
Consulta os veículos vinculados a um transportador na ANTT.
Preencha CPF/CNPJ Interessado e Transportador (ou RNTRC). Adicione as placas dos veículos a consultar.
Resultado: tabela com placa e situação (Pertence / Não Pertence), colorido em verde ou vermelho.
Verifica se o transportador possui exceções cadastradas na ANTT (Resolução 5.862).
Informe o CPF/CNPJ do transportador. Resultado: "Está na lista de exceções" ou "Não está na lista de exceções".
Consulta dados de um CIOT já gerado na ANTT.
| Campo | Descrição |
|---|---|
| Código CIOT | Código de 12 dígitos |
| Ano declaração (opcional) | Ano da declaração |
Resultado exibe o código CIOT em destaque e informações de retorno.
Registro de todas as consultas realizadas anteriormente, com tipo, data/hora, parâmetro, resultado e mensagem.
Após cada consulta bem-sucedida, o botão "Salvar Consulta" aparece para registrar o resultado no banco de dados local para referência futura.
Acesse pelo menu lateral "Logs" (ícone de atribuição).
Tela de auditoria que exibe todos os eventos do sistema.
| Filtro | Descrição |
|---|---|
| Data início / Data fim | Intervalo de datas para filtrar |
| Nível | Todos, Depuração, Informação, Atenção, Erro |
| Empresa | (Admin) Filtra por empresa |
| Módulo | Filtra por módulo do sistema (ex: operação) |
| Ação | Filtra por ação (ex: declarar) |
| Usuário | Filtra por e-mail do usuário |
Exibe as colunas: Data/Hora, Nível (colorido), Empresa, Módulo, Ação, Usuário, Mensagem.
Níveis com cores:
Clique no menu lateral "Configuração" (ícone de engrenagem).
Configurações que se aplicam a todas as empresas.
Upload das DLLs oficiais da ANTT para geração local do CIOT, separadas por ambiente (Homologação / Produção).
Prazos máximos (em horas) para cada ação:
Credenciais para enviar novas versões do aplicativo ao servidor de distribuição. Usado pelo build.py com a flag --ftp.
| Campo | Descrição |
|---|---|
| FTP Host | Endereço do servidor (ex: ftp.web140.kinghost.net) |
| FTP Usuário | Usuário FTP |
| FTP Senha | Senha FTP |
| FTP Caminho Remoto | Pasta de destino (ex: www/ciot/) |
Botão "Sincronizar NCM Agora" para baixar a tabela oficial de NCM do Portal Único Siscomex.
Configurações específicas por cliente.
Configuração para conexão com o sistema corporativo Firebird:
Botão "Testar conexão ERP" para validar a integração.
Acessível apenas para administradores, permite exportar todos os dados do cliente ou apagá-los do banco de dados.
***. Os payloads JSON das operações são incluídos apenas com o tamanho em caracteres.Fluxo:
O CIOT AnDes possui um sistema de atualização automática integrado:
Verifique se o certificado digital (.pfx) está correto e se a senha foi digitada corretamente em Configuração > Configuração da Empresa > Certificado ICP-Brasil. Certifique-se de que o certificado está válido (não expirado) e que possui permissão para consumo de web service da ANTT.
O sistema alerta quando os prazos estão próximos do vencimento com cores no painel:
Os prazos são configurados em Configuração > Dados Globais > Prazos por Movimento.
Na aba Identificação do formulário de declaração, clique no botão "Gerar CIOT". O sistema tentará gerar automaticamente via API da ANTT, ou utilizando a DLL/EXE oficial configurada.
Sim, as funcionalidades de cadastro (participantes, veículos) e criação de operações em rascunho funcionam offline. Porém, as seguintes ações exigem conexão:
Contingência é um mecanismo para quando o sistema da ANTT está indisponível. Ao marcar "Operação em Contingência" na declaração, você informa uma justificativa e a operação é transmitida com indicador de contingência. A ANTT aceita operações em contingência com prazos estendidos.
Na aba Valores do formulário de declaração, preencha Tipo de operação, distância total, Tipo de Carga e Eixos, depois clique em "Calcular Piso Mínimo". O sistema calcula conforme a tabela (Resolução 6.084/2026 da ANTT) vigente na data da declaração, considerando tipo de carga, número de eixos, composição veicular, alto desempenho e retorno vazio.
Em Configuração > Configuração da Empresa > Integração ERP, configure a conexão com seu banco Firebird corporativo. Defina as consultas SQL para buscar contratados e contratantes. Após configurado, o botão "Buscar no ERP" aparecerá nas abas Contratado, Contratante e Destinatário do formulário de declaração.
Configure em Configuração > Configuração da Empresa > Ambiente.
O botão Suporte está disponível no menu lateral, em todas as telas. Ao clicar, abre o link configurado em Configuração > Dados Globais > URL de Suporte no navegador.
Tutorial gerado em julho de 2026 — Versão 1.4.6
AnDes Sistemas — https://andeserp.com.br