API Emitelog

Integre o CIOT ao fluxo do seu sistema

Envie operações, acompanhe o resultado retornado pela ANTT e consulte o histórico sem duplicar o trabalho da equipe.

URL ilustrativa de tenant

POST https://sua-transportadora.clientes.emitelog.com.br/v1/ciot
Authorization: Bearer sua_chave
Idempotency-Key: operacao-erp-000123
Content-Type: application/json

{
  "tipoOperacao": "CARGA_LOTACAO",
  "contratado": "00000000000000",
  "rntrcContratado": "000000000",
  "inicioViagem": "2026-12-01",
  "fimViagem": "2026-12-10",
  "veiculos": [{ "placa": "ABC1D23", "numeroEixos": 3 }],
  "trechos": [{ "origem": { "codigoMunicipio": "3550308" }, … }]
}

Bearer por ambiente

Credenciais de homologação e produção mantêm o contexto explícito em cada requisição.

Idempotency-Key

A emissão e as demais mutações do CIOT exigem uma chave estável para tratar retentativas sem repetir uma ação às cegas.

Erros RFC 9457

Falhas usam application/problem+json e códigos de domínio em erros[].codigo.

Recursos reais

Grupos disponíveis após a ativação

Esta página apresenta o contrato em alto nível. Swagger, chaves e detalhes de payload permanecem no ambiente ativado de cada empresa.

POST/v1/certificados

Certificado A1

Cadastrar e validar o certificado que autentica a integração da própria ETC.

GET/v1/transportador/situacao

Situação do transportador

Consultar situação, RNTRC e elegibilidade informados pela ANTT.

POST/v1/transportador/frota/consulta

Frota

Conferir veículos vinculados antes de montar a operação.

GET · POST · PUT/v1/cadastro/*

Cadastros

Gerenciar pessoas e veículos reutilizados pelo painel e pelas integrações.

POST/v1/ciot

Emissão

Transmitir uma nova operação com Idempotency-Key obrigatória.

GET/v1/ciot/:id

Consulta

Recuperar situação, identificadores e retorno registrado da operação.

GET/v1/ciot/:id/extrato

Extrato PDF

Obter o documento da operação para consulta e arquivo.

POST/v1/ciot/:id/cancelamento

Cancelamento

Solicitar o cancelamento quando a operação permitir.

POST/v1/ciot/:id/encerramento

Encerramento

Registrar os dados de encerramento da operação.

POST/v1/ciot/:id/retificacao

Retificação

Atualizar os campos admitidos para operações aplicáveis.

GET/v1/ciot/piso-minimo/calculo

Piso mínimo

Consultar o cálculo de referência antes de transmitir a operação.

Contrato de resposta

Transporte HTTP não é confirmação do CIOT

O resultado da operação deve ser lido no corpo da resposta e nas consultas posteriores. A aceitação final depende do processamento da ANTT.

application/problem+json

{
  "type": "https://…/problemas/entrada-invalida",
  "title": "Entrada inválida",
  "status": 400,
  "erros": [{
    "codigo": "IDEMPOTENCY_KEY_AUSENTE",
    "mensagem": "Informe o cabeçalho Idempotency-Key"
  }]
}

Integração privada, processamento público

A API Emitelog é privada e não pertence à ANTT. Nas operações elegíveis, ela transmite dados aos Web Services da Agência usando o certificado da própria ETC. Não somos IP/IPEF e não realizamos pagamento eletrônico de frete.

Acesso assistido

Confira se sua empresa está apta

Valide CNPJ, RNTRC e certificado A1 antes da liberação para emissão em produção.

Solicitar validação