Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CIOT: ANTT e integradoras (coleção Postman)

Coleção Postman do CIOT (Código Identificador da Operação de Transporte), cobrindo a API oficial da ANTT (pefServices) e as integradoras de pagamento de frete.

Arquivo: postman/CIOT-ANTT-Integradoras.postman_collection.json (21 itens em 3 pastas).

O ponto que ninguém explica de cara

Não existe um órgão único emitindo CIOT via API pública como a SEFAZ. A ANTT regula (Lei 11.442/2007, MP 1.343/2026, Res. ANTT 6.078/2026, Portaria SUROC 6/2026, obrigatório desde 24/05/2026) e existem duas vias:

  • ETC com frota própria / sem subcontratar TAC: fala DIRETO com a ANTT (pefServices), autenticando com certificado e-CNPJ via mTLS. É a pasta principal desta coleção, com endpoints reais.
  • Operação com subcontratação de TAC + pagamento de frete: exige uma instituição de pagamento homologada. A Extratta tem portal público (docs.extratta.com.br); Roadcard/Pamcard, Repom/Edenred, DBTrans e Sem Parar operam sob credenciamento/NDA e estão na pasta "sob credenciamento", sem endpoints inventados.

O fluxo POST /pefServices/gerar foi testado em homologação em 12/09/2026 com um e-CNPJ A1 real: HTTP 200, CIOT retornado.

Setup no Postman

  1. Import > postman/CIOT-ANTT-Integradoras.postman_collection.json.
  2. ANTT: certificado e-CNPJ em Settings > Certificates para appservices.antt.gov.br (prod) e appservices-hml.antt.gov.br (homolog). Desligue a verificação SSL do servidor se necessário.
  3. Extratta: preencha as variáveis cnpjApp, tokenExtratta e cnpj (viajam em headers).
  4. Ajuste a variável cnpj (14 dígitos, só números) e dispare.

Honestidade sobre as fontes

Os endpoints da ANTT vêm do guia FlexDocs e dos paths reais expostos pela API. Confirme os campos exatos no Swagger oficial do Portal do Desenvolvedor ANTT antes de usar em produção. Itens marcados [a confirmar] não têm spec pública fechada.

Como é gerado

Fonte de verdade: gen_ciot.py monta o .json do Postman. Para propor mudança, edite o gerador, rode e abra um PR.

Repositórios irmãos

Sobre

Mantido pela Stoix. Licença MIT.

About

Coleção Postman do CIOT: API oficial da ANTT (pefServices) e integradoras de pagamento de frete. Gerar CIOT testado em homologação.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages