Como emitir um CIOT

Antes de começar

Tenha em mãos:

• O CT-e ou a NF-e da viagem (XML).
• O contratado cadastrado: motorista TAC autônomo, frota própria, ou transportadora ETC.
• O Tomador da operação (quem paga o frete) — pode ser o embarcador ou outro contratante.

1. 1

   Passo 1 — Escolher a modalidade

   Em CIOT → Nova operação, o primeiro passo é escolher a modalidade. Ela fica fixada após a criação do rascunho — para mudar é preciso criar uma nova operação.

   Campo	Tipo	Descrição
   Frota Própria	Motorista e veículo da empresa	Use quando a viagem é executada pela própria empresa. O contratado é preenchido automaticamente com o CNPJ e o RNTRC da sua empresa.
   Terceiro — TAC autônomo	Motorista autônomo	Subcontratação de um motorista autônomo com RNTRC TAC. Você seleciona o parceiro como contratado.
   Terceiro — ETC	Transportadora	Subcontratação de uma transportadora (ETC). O contratado é o CNPJ da empresa transportadora.
   Terceiro — ETC equiparado a TAC	ETC com RNTRC TAC	Empresa cujo RNTRC é da categoria TAC. Marque a opção 'Equiparado a TAC' no cadastro do parceiro — o sistema aplica as regras de TAC nos pagamentos.

2. 2

   Passo 2 — Criar a operação

   Escolha o tipo de operação e clique em Criar. O tipo muda o que o formulário cobra mais à frente:

   Campo	Tipo	Descrição
   Lotação	1 contratante principal	Carga inteira para um único destinatário. Exige destinatário e itens de pagamento do tomador.
   Fracionada	Vários contratantes	Carga dividida entre vários remetentes/destinatários. Exige a lista completa de contratantes na aba Partes.

3. 3

   Passo 3 — Anexar os documentos (XML)

   Na aba Documentos, solte o XML do CT-e, MDF-e ou NF-e. O sistema lê o arquivo e preenche automaticamente vários campos:

   • Veículo (placa), motorista e RNTRC do emitente
   • Valor da carga, valor do frete e pedágio
   • Peso e natureza da carga
   • Origem e destino
   • Remetente e destinatário sugeridos para a aba Partes

   No topo da tela aparece um aviso dizendo quantos campos foram preenchidos — ex.: "Documento anexado — 7 campos preenchidos automaticamente". Você pode anexar mais de um XML; se os documentos divergirem (emitentes ou placas diferentes), o sistema avisa.

4. 4

   Passo 4 — Aba Operação (campo a campo)

   Campo	Tipo	Descrição
   Tipo de operaçãoreq	Lotação / Fracionada	Escolhido no Passo 2. Não pode mais ser alterado depois.
   Valor do fretereq	R$	Valor total bruto pago ao contratado. Deve ser maior que zero e bater com a soma dos itens de pagamento.
   Data de declaraçãoreq	Data	Quando o CIOT está sendo declarado. Por padrão, o dia de hoje.
   Início da viagemreq	Data	Data em que a viagem começa. Não pode ser posterior ao fim. Se for anterior à declaração, o sistema apenas avisa.
   Fim da viagemreq	Data	Previsão de término. Intervalo máximo: 90 dias para lotação e fracionada.
   Operação em contingência	Sim / Não	Marque apenas quando o envio for feito offline por indisponibilidade do órgão regulador. Exige justificativa.
   Justificativa de contingência	Texto	Obrigatória quando 'contingência' está marcada. Se desmarcou, apague o texto.
   Contratado — CPF/CNPJreq	Documento	Use o campo 'Buscar parceiro contratado' — preenche CNPJ, nome, RNTRC e tipo automaticamente. Em Frota Própria já vem da própria empresa.
   Contratado — RNTRCreq	9 dígitos	Vem do cadastro do parceiro. Deve estar ativo na ANTT — se estiver inativo, o sistema bloqueia a emissão.
   Contratado — Tiporeq	TAC / ETC / CTC	Definido pela categoria do RNTRC cadastrada. Para empresa com RNTRC TAC, marque também 'Equiparado a TAC'.
   Destinatárioreq	CPF/CNPJ + nome	Quem recebe a carga (lotação). Vem do XML quando há CT-e/NF-e anexado; também pode ser selecionado de Parceiros.

5. 5

   Passo 5 — Aba Partes (Contratantes)

   A aba Partes lista quem participa da operação: tomador (quem paga o frete), remetente (quem despacha) e destinatário (quem recebe). O sistema sugere contratantes a partir dos XMLs anexados — basta clicar em Adicionar.

   • Lotação: basta o tomador. Os demais entram conforme o XML.
   • Fracionada: exige a lista completa de contratantes. Sem isso, a emissão é bloqueada.
   • Cada contratante usado nos pagamentos precisa estar nesta aba antes.
6. 6

   Passo 6 — Aba Trajeto / Carga

   Campo	Tipo	Descrição
   Tipo de localizaçãoreq	Município / CEP / Coordenadas	Escolha o tipo. Origem e destino devem usar o mesmo tipo, ou ter pelo menos um dado em comum.
   Origemreq	Município, CEP ou Lat/Lng	Escolha um local cadastrado ou da lista de sugestões. Coordenadas devem estar dentro do intervalo válido.
   Destinoreq	Município, CEP ou Lat/Lng	Mesma regra da origem.
   Distância (km)req	Número	O sistema calcula automaticamente quando origem e destino estão preenchidos. Pode ser ajustada manualmente.
   Natureza da cargareq	Tabela ANTT	Use o seletor — busca pelo código ou descrição. Vem do CT-e quando disponível.
   Peso da carga (kg)req	Número	Maior que zero. Vem do CT-e/MDF-e.
   Tipo da cargareq	Geral / Granel / etc.	Selecione o tipo físico da carga transportada.
   NCM	Código	Opcional. Preencha quando exigido pelo embarcador.

7. 7

   Passo 7 — Aba Veículos

   Adicione as placas que vão executar a viagem. Regras principais:

   Campo	Tipo	Descrição
   Placareq	Padrão Brasileiro/Mercosul	Sem placas duplicadas. Placas fora do padrão geram apenas aviso.
   RNTRC do proprietárioreq	9 dígitos	Sempre o RNTRC do real dono da placa — não do contratado nem do contratante. Para agregados, é o RNTRC do proprietário cadastrado.
   Tipo / Categoriareq	Tração / Implemento	É preciso exatamente 1 tração (automotor ou cavalo). Cavalo-trator exige pelo menos 1 implemento.
   Número de eixosreq	Número	Obrigatório no envio — vem do cadastro do veículo.
   Total de veículos	1 a 5	Máximo de 5 veículos por operação.
   Emitir apenas o cavalo	Sim / Não	Opção para omitir os reboques no envio — usa-se quando o cliente prefere evitar recusa por composição com RNTRCs distintos. Responsabilidade do operador.

8. 8

   Passo 8 — Aba Financeiro (Pagamentos)

   Cada item de pagamento informa quanto, para quem e como o tomador vai pagar. Para operações com um único contratado, o sistema já cria saldo e pedágio automaticamente a partir do CT-e.

   Campo	Tipo	Descrição
   Contratantereq	Vínculo	Cada item precisa estar vinculado a um contratante já presente na aba Partes.
   Tipo do itemreq	Saldo / Pedágio / Adiantamento / ...	Sem duplicidade: não pode haver mais de um item de pedágio (ou saldo) para o mesmo contratante.
   Meio de pagamentoreq	TED / PIX / IP / Outros	TED exige banco, agência, conta e CPF/CNPJ do titular. PIX exige chave + tipo de chave. IP exige instituição emissora + identificador do cartão. 'Outros' exige descrição — e não é permitido para TAC/equiparado TAC.
   Valorreq	R$	A soma de todos os itens precisa bater exatamente com o valor do frete da operação.

9. 9

   Passo 9 — Resolver as 'Lacunas para emissão'

   O painel Lacunas para emissão lista tudo o que ainda impede o envio. Use a tabela abaixo como referência rápida:

   Operação

   Campo	Tipo	Descrição
   Valor zerado	Bloqueio	Preencha o valor do frete (maior que zero) na aba Operação.
   Datas inconsistentes	Bloqueio	Fim da viagem anterior ao início, ou intervalo maior que 90 dias.
   Contingência sem justificativa	Bloqueio	Preencha o motivo da contingência ou desmarque a opção.

   Transportador

   Campo	Tipo	Descrição
   Contratado ausente	Bloqueio	Selecione o parceiro contratado em Parceiros e vincule-o à operação.
   RNTRC ausente	Bloqueio	Cadastre o RNTRC no parceiro contratado.
   RNTRC inativo na ANTT	Bloqueio	Atualize a situação do RNTRC com o transportador — só ativo emite.

   Destinatário

   Campo	Tipo	Descrição
   Destinatário ausente	Bloqueio	Lotação/fracionada exigem CPF/CNPJ do destinatário.

   Trajeto e Carga

   Campo	Tipo	Descrição
   Origem/destino não identificados	Bloqueio	Escolha um local cadastrado ou um endereço da lista de sugestões.
   Distância obrigatória	Bloqueio	Informe a distância percorrida em km.
   Natureza, peso ou tipo de carga ausentes	Bloqueio	Preencha os 3 campos na aba Trajeto / Carga.
   Fracionada sem contratantes	Aviso	Adicione a lista completa de contratantes na aba Partes.

   Veículos

   Campo	Tipo	Descrição
   Sem veículo / sem tração	Bloqueio	Adicione ao menos 1 veículo de tração (automotor ou cavalo).
   Mais de uma tração	Bloqueio	Só 1 tração é permitida; o resto deve ser implemento/reboque.
   Cavalo sem implemento	Bloqueio	Cavalo-trator precisa de ao menos 1 reboque vinculado.
   Placas duplicadas	Bloqueio	Remova as placas repetidas.
   Eixos faltando	Bloqueio	Edite o cadastro do veículo e informe o número de eixos.

   Pagamentos

   Campo	Tipo	Descrição
   Sem itens de pagamento	Bloqueio	Adicione ao menos 1 item na aba Financeiro.
   Soma diferente do valor do frete	Bloqueio	Ajuste os valores para que a soma bata com o frete.
   Dados bancários incompletos (TED)	Bloqueio	Preencha banco, agência, conta e CPF/CNPJ do titular.
   Chave PIX faltando	Bloqueio	Informe a chave e o tipo (CPF, CNPJ, e-mail, celular ou aleatória).
   TAC com meio 'Outros'	Bloqueio	TAC/equiparado TAC não aceita 'Outros' — use TED, PIX ou IP.
   Item duplicado (pedágio/saldo)	Bloqueio	Há mais de um item de pedágio ou saldo para o mesmo contratante.

   Documentos

   Campo	Tipo	Descrição
   Nenhum XML anexado	Bloqueio	Anexe ao menos um CT-e ou NF-e na aba Documentos.
   Emitentes/placas divergentes	Aviso	Confira se os XMLs realmente fazem parte da mesma viagem.
   Valor declarado >5% da soma dos docs	Aviso	Confira o valor do frete contra a soma dos documentos.

10. 10

    Passo 10 — Emitir CIOT

    Quando o painel de lacunas estiver limpo, clique em Emitir CIOT. Em segundos o retorno aparece com o número do CIOT, o protocolo e o código verificador.

    Aviso de 'Advertência' = sucesso

    Se o retorno disser "Dados cadastrados com sucesso com ressalvas…", o CIOT foi gerado normalmente. A ressalva é só um aviso (geralmente sobre a distância informada).

Diferenças por modalidade

Depois da emissão

Cada operação fica em CIOT com o status atual. A partir dela você acessa os eventos pós-emissão:

Onde encontrar o CIOT depois

Cada operação fica em CIOT. Abra para ver o número, baixar o comprovante, consultar os eventos enviados e o histórico de mudanças.

Composição com vários veículos (cavalo + reboques)

Quando a operação envolve um cavalo-trator e um ou mais reboques de proprietários diferentes (frota mista ou agregados), a regra correta é enviar cada placa com o RNTRC do seu real proprietário. O FreteFlow grava esse vínculo no cadastro de veículos e usa o RNTRC do dono no envio — não cai no RNTRC do contratado nem do contratante.

Para casos em que o cliente prefere não enviar os reboques (por exemplo para evitar a recusa acima), ative em CIOT → Veículos a opção "Emitir apenas o cavalo (omitir reboques)". Esse modo envia somente a placa do automotor — o operador assume o risco de autuação por composição incompleta.

Veículos agregados (terceiros)

Um veículo agregado pertence a outra empresa/pessoa, mas roda para um contratado específico. No cadastro do veículo (Veículos → Editar) preencha o campo Agregador (opcional) apontando para o transportador que opera a placa. Na hora de criar a operação CIOT, esse veículo aparece no seletor do contratado com o selo "Agregado" e o nome/RNTRC do proprietário real logo abaixo — o envio à ANTT vai com o RNTRC do dono, não do agregador.

Modalidade Agregado — contrato de 30 dias

Quando o transportador opera continuamente para a sua empresa, é possível substituir a emissão de 1 CIOT por viagem por um contrato de até 30 dias ("CIOT Agregado"). Cada frete executado vira um crédito no extrato do agregado, despesas viram débitos e o saldo é consolidado. Configure em Parceiros → CIOT — modalidade e abra o primeiro contrato em /ciot/agregados/novo. A referência da API está em API: CIOT Agregado.