API de CIOT para emitir e gerir CIOT a partir do seu ERP ou TMS
A API de CIOT do BrainCargo emite, retifica, encerra, cancela e consulta CIOT a partir do seu ERP ou TMS, com token por ambiente (homologação e produção) e documentação técnica liberada pela equipe.
Preço da API de CIOT
O CIOT da API sai da cota do plano
CIOT com terceiros a partir de
R$ 1,29
por CIOT, no pacote de 500 ou mais por mês
150 CIOTs com terceiros
R$ 398,40
por mês com a licença, no anual
CIOT com TAC, agregado e subcontratação de R$ 2,29 a R$ 1,29, conforme o pacote, e vale para todo CIOT do plano.
300 CIOTs com terceiros
R$ 606,90
por mês com a licença, no anual
R$ 1,69 por CIOT. Quem também emite CT-e + MDF-e na plataforma leva o módulo ilimitado a partir de 300 CIOTs de terceiros por mês.
Só frota própria
R$ 0,50
por CIOT
Veículo do CNPJ emitente. Licença da plataforma: R$ 99,90 no anual (R$ 109,90 no mensal).
Os CIOTs emitidos pela API saem da cota mensal do plano. Condições da integração (ambiente de teste, credenciais e suporte) com a equipe. Plano mensal recorrente por PIX ou boleto. Valores de tabela; o valor final vem na oferta e na fatura.
Contrato de exemplo
Uma chamada emite o CIOT
O seu sistema manda a viagem em JSON e recebe o número do CIOT na resposta. É o mesmo dado que já está no seu ERP ou TMS: contratante, contratado, veículo, carga, trajeto e pagamento. O valor do frete é conferido contra o piso mínimo da ANTT antes do envio.
POST /api/ciots/emitir
Authorization: Bearer <seu token de homologação>
Content-Type: application/json
{
"tipoOperacao": "CARGA_LOTACAO",
"ambiente": "HOMOLOGACAO",
"issuerId": "<id da filial com certificado A1>",
"dataInicio": "2026-11-10",
"dataFim": "2026-11-12",
"valorFrete": 6800.00,
"contratante": { "documento": "00000000000100", "nome": "Indústria Exemplo LTDA" },
"contratado": { "documento": "11111111000111", "rntrc": "87654321" },
"veiculos": [ { "placa": "ABC1D23", "numeroEixos": 6 } ],
"carga": { "codigoNatureza": "2711", "codigoTipoCarga": "GRANEL_SOLIDO", "peso": 32000 },
"viagens": [ {
"origem": { "cep": "13140000" },
"destino": { "cep": "86010000" },
"distanciaPercorrida": 480
} ],
"parcelasPagamento": [ {
"formaPagamento": "A_VISTA",
"tipoPagamento": "PIX",
"documentoCreditado": "11111111000111",
"valorParcela": 6800.00
} ]
}201 Created
{
"id": "5b0d7c2e-…",
"numero_ciot": "123456789012",
"protocolo": "…",
"status": "EMITIDO",
"ambiente": "HOMOLOGACAO",
"veiculo_placa": "ABC1D23",
"valor_frete": "6800",
"data_hora_emissao": "2026-11-09T14:00:00Z"
}Depois da emissão
- Encerrar:
POST /api/ciots/{id}/encerrar - Cancelar:
POST /api/ciots/{id}/cancelar - Retificar:
PUT /api/ciots/{id}/retificar - Consultar e PDF:
GET /api/ciots/{id} · /pdf · /events
Certificado digital A1
Para emitir em nome da própria transportadora, direto na ANTT, a filial precisa ter o certificado digital A1 cadastrado e válido. Ele é usado na emissão e também no encerramento, no cancelamento e na retificação desse CIOT. O cadastro da filial e o envio do certificado também são feitos pela API. Na rota pela Instituição de Pagamento (subcontratação e TAC agregado), o CIOT sai pela IP credenciada.
Exemplo ilustrativo, com documentos fictícios. O contrato completo, com todos os campos, códigos de erro e o endereço dos ambientes, é entregue pela equipe junto com o token de homologação.
A API de CIOT da BrainCargo permite que um ERP ou TMS próprio emita e gerencie o Código Identificador da Operação de Transporte sem digitar a operação na tela: o sistema do cliente envia os dados da viagem e a plataforma registra o CIOT. Pela API é possível emitir, retificar, atualizar os dados da viagem, encerrar, cancelar, reemitir e consultar o CIOT, baixar o PDF, ver o histórico de eventos, validar a frota e o transportador antes de emitir e acompanhar o consumo do período. A emissão segue pela Instituição de Pagamento ou direto na ANTT, em nome da própria transportadora, conforme o tipo de operação enviado. O acesso é por token Bearer fornecido pela equipe, separado por ambiente: homologação para testar e produção para emitir de verdade. A documentação técnica é liberada com a conta, e não está publicada neste site.
Quem já tem ERP ou TMS próprio costuma enfrentar o mesmo problema desde o CIOT para Todos: a viagem já está cadastrada no sistema, e alguém precisa redigitá-la em outro lugar para gerar o código. A API de CIOT elimina essa segunda digitação: o seu sistema envia a operação e recebe o CIOT de volta.
Esta página descreve só o que a integração entrega hoje. Se a sua operação é menor e não tem sistema próprio, o emissor de CIOT na plataforma resolve na tela, no mesmo despacho do CT-e e do MDF-e. Em dúvida sobre quem precisa gerar o CIOT, leia frota própria precisa de CIOT?.
Por que esse módulo
Uma digitação só
A operação nasce no seu ERP ou TMS e vai para o CIOT por integração. Sem planilha, sem portal aberto em outra aba a cada viagem.
Ciclo de vida completo
Emitir, retificar, encerrar e cancelar são chamadas da API. O seu sistema pode encerrar no prazo, sem depender de alguém lembrar.
Duas rotas de emissão
O tipo de operação enviado define se o CIOT sai pela Instituição de Pagamento ou direto na ANTT, em nome da própria transportadora, que exige filial e certificado digital ativo.
Teste antes de emitir
O token de homologação não emite em produção. O ambiente é definido por token, então o time de TI valida o fluxo antes do primeiro CIOT real.
Como integrar o CIOT ao seu ERP ou TMS em 5 passos
O acesso é combinado com a equipe, e o contrato técnico é entregue com a conta. A ordem abaixo é a do fluxo real da integração.
-
Defina quem gera o CIOT na sua operação
Quem contrata TAC ou TAC equiparado gera por Instituição de Pagamento. A ETC que transporta sozinha pode gerar direto na ANTT ou por uma IP (Portaria SUROC 6/2026, art. 3º). Veja frota própria precisa de CIOT? e TAC, ETC e CTC.
-
Peça o acesso à equipe
Fale com a equipe pelo WhatsApp. Ela ativa a conta, gera o token de integração e libera a documentação técnica. O token é pessoal e de responsabilidade do titular, conforme a política de API.
-
Teste em homologação
Com o token de homologação, valide frota e transportador, emita e consulte. Para a emissão direta na ANTT, cadastre a filial e o certificado digital A1; para emitir pela Instituição de Pagamento, filial e certificado não são necessários.
-
Acompanhe e encerre
Consulte o status e o histórico de eventos, baixe o PDF e encerre, cancele ou retifique conforme a operação. Entenda os prazos em cancelar, encerrar e retificar CIOT.
-
Vá para produção
A equipe libera a emissão em produção para o seu token. Depois disso, acompanhe o consumo do período pela própria API.
O que está incluído
Emissão fiscal e canhotos integrados à plataforma
- Emitir CIOT a partir do ERP ou TMS, sem redigitar a viagem
- Retificar, atualizar os dados da viagem, encerrar, cancelar e reemitir
- Consultar CIOT, listar, baixar o PDF e ver o histórico de eventos
- Validar a frota do contratado e a situação do transportador antes de emitir
- Emissão pela Instituição de Pagamento ou direto na ANTT, em nome próprio
- Cadastro e atualização de filiais e do certificado digital, para a emissão direta
- Consumo do período por rota de emissão
- Token separado para homologação e para produção
Emissor na plataforma, API ou portal: qual combina com a sua operação
Comparação por critérios, não por marca. A diferença está em onde a viagem é cadastrada e em quem aciona cada etapa do CIOT.
| Critério | Emissor na plataforma | API de CIOT | Portal da IP ou da ANTT |
|---|---|---|---|
| Onde os dados da viagem são digitados | Na tela da plataforma, no mesmo despacho do CT-e e do MDF-e | No seu ERP ou TMS, que envia a operação | No portal, a cada operação |
| Esforço de implantação | Nenhum desenvolvimento | Desenvolvimento do lado do cliente e testes em homologação | Nenhum desenvolvimento |
| Encerrar, cancelar e retificar | Na tela, com lista de pendentes | Por chamadas que o seu sistema aciona e agenda | Um a um, no portal |
| Conferência antes de emitir | Piso mínimo conferido pelo sistema | Validação de frota e de transportador por consulta, antes da emissão | Conferência manual |
| Quando faz sentido | Operação sem sistema próprio, ou que quer o fiscal e o CIOT no mesmo lugar | Há ERP ou TMS que já cadastra a viagem, ou o volume pede automação | Poucas operações por mês |
A coluna "API" descreve o contrato de integração de CIOT da BrainCargo. Prazos seguem a norma vigente (Portaria SUROC 6/2026 e Resolução ANTT 5.862/2019).
Perguntas frequentes
Existe API para emitir CIOT?
Sim. A BrainCargo tem uma API de integração para emitir, retificar, atualizar os dados da viagem, encerrar, cancelar, reemitir e consultar CIOT, além de baixar o PDF e listar o histórico de eventos. O acesso é por token fornecido pela equipe.
Como consigo acesso à API de CIOT?
Pela equipe: fale pelo WhatsApp, ela ativa a conta, gera o token de integração e libera a documentação técnica. A documentação não é pública e o endereço do ambiente não está neste site. O token é pessoal, intransferível e de responsabilidade do titular (política de API).
Dá para testar antes de emitir CIOT de verdade?
Sim. O token tem ambiente: um token de homologação só emite em homologação, e um token de produção emite nos dois ambientes. A equipe libera a produção quando a sua integração estiver validada.
A API emite CIOT sem certificado digital?
Depende da rota. Pela Instituição de Pagamento, não é preciso cadastrar filial nem certificado. Direto na ANTT, em nome da própria transportadora, a filial e o certificado digital ativo são necessários. O tipo de operação enviado define o caminho.
A API também emite CT-e e MDF-e?
O contrato de integração descrito nesta página cobre CIOT, o cadastro de filiais e certificado e a carga de notas, motoristas e transportes. A emissão de CT-e e MDF-e por API não faz parte dele, e nós só afirmamos o que está confirmado. Se você precisa disso, fale com a equipe sobre o seu caso. Na plataforma, o CT-e e o MDF-e funcionam normalmente com o CIOT.
Quem precisa gerar o CIOT: o meu ERP ou o meu contratado?
Quem contrata TAC ou TAC equiparado gera por Instituição de Pagamento. A ETC que realiza o transporte sem subcontratar TAC gera o próprio CIOT, direto na ANTT ou por IP (Portaria SUROC 6/2026, art. 3º). Veja frota própria precisa de CIOT?.
Preciso encerrar o CIOT emitido pela API?
Sim, como em qualquer CIOT. Em carga lotação e fracionada, o prazo é de até 5 dias da data prevista para o término, com encerramento automático depois disso (Portaria SUROC 6/2026, arts. 18 e 20). A API permite encerrar, e o seu sistema pode agendar essa chamada. Detalhes em cancelar, encerrar e retificar CIOT.
Em que a API é diferente do emissor de CIOT na plataforma?
O resultado é o mesmo CIOT. No emissor, a equipe digita a viagem na tela e o CIOT sai no despacho junto com o CT-e e o MDF-e. Na API, o seu ERP ou TMS envia a operação e aciona as etapas do ciclo de vida. Veja o emissor de CIOT e como escolher um emissor.
Guias de CIOT
Todos os guias →- Quanto custa emitir um CIOT em 2026? O que é gratuito e o que se paga O código do CIOT é gratuito: a ANTT proíbe cobrar pela geração. O que tem preço é o sistema que emite o CIOT junto com o MDF-e e os serviços de pagamento do frete. Na BrainCargo, a partir de R$ 0,50 por CIOT.
- Como emitir o CIOT na ANTT em 2026: os 3 caminhos e o passo a passo A ANTT não oferece um site para preencher o CIOT. A geração é por web service: via Instituição de Pagamento (obrigatória com TAC), integração direta (só ETC com mais de três veículos) ou um sistema que faz isso junto com o CT-e e o MDF-e.
- Como emitir CIOT para frota própria: passo a passo da transportadora Transportadora com mais de três veículos que faz o transporte com a própria frota gera o próprio CIOT, antes da viagem, pelo web service da ANTT ou por uma Instituição de Pagamento. Com até três veículos, quem contrata gera.
- CIOT não aparece na consulta da ANTT? 7 causas e como resolver Gerou o CIOT e o código não aparece na consulta pública da ANTT? As causas vão de erro de RNTRC/RENAVAM a tipo de consulta errado ou registro em contingência. Veja as 7 causas e o passo a passo para resolver cada uma.
Conteúdo relacionado
Quer integrar o CIOT ao seu ERP ou TMS?
Fale com a equipe pelo WhatsApp: ela ativa a conta, gera o token de homologação e libera a documentação técnica.
Preço modular, sob medida para o porte da sua operação: você contrata só os módulos que usa e o plano acompanha o seu volume. Peça sua proposta pelo WhatsApp.