Download the PHP package rumbleh/laravel-ciot-antt without Composer
On this page you can find all versions of the php package rumbleh/laravel-ciot-antt. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package laravel-ciot-antt
laravel-ciot-antt
Cliente Laravel para emissão de CIOT (Código Identificador da Operação de Transporte) junto ao web service PEF da ANTT (Pagamento Eletrônico de Frete), conforme o manual DCS PEF v1.1 (Resolução ANTT 5.892/2019 e MP 1.343/2026 — Piso Mínimo de Frete).
Open source (MIT). Distribuído via Packagist:
composer require rumbleh/laravel-ciot-antt. Detalhes de instalação e CI/CD emdocs/INSTALL.md.
Recursos
-
Os 8 serviços do PEF/ANTT, tipados e prontos para uso: # Serviço Método no pacote 01 ConsultarSituacaoTransportador consultarSituacaoTransportador()02 ConsultarFrotaTransportador consultarFrotaTransportador()03 DeclaracaoOperacaoTransporte (gera o CIOT) declararOperacao()04 CancelamentoOperacaoTransporte cancelarOperacao()05 RetificacaoOperacaoTransporte retificarOperacao()06 EncerramentoOperacaoTransporte encerrarOperacao()07 ConsultarExcecao consultarExcecao()08 ConsultarCIOTGerado consultarCiotGerado() - mTLS com certificado ICP-Brasil A1 (
.pfx/.p12) — ideal para CI/CD. - Validação local das regras de negócio do manual (B1..B122) antes de gastar uma requisição na ANTT — mensagens claras referenciando a regra.
- Value Objects com validação de CPF/CNPJ (dígito verificador), RNTRC (normalização B60) e placa (padrões Brasileiro e Mercosul).
- Geração do
IdOperacaoTransporteplugável (contratoOperationIdGenerator) ou informada manualmente. - Gerador CIOT v3 (token + API key) embutido: caminho alternativo e simples
para gerar/consultar o CIOT (
GeradorCiot::gerarCiot()/consultarCiot()), que também se integra automaticamente comoOperationIdGenerator. - Respostas tipadas com
sucesso(),codigo(),mensagem()e helpers por serviço (ex.:ciotComDigito(),avisoTransportador()).
Requisitos
- PHP 8.2+ (testado em 8.4) com extensões
jsoneopenssl - Laravel 11 ou 12
- Certificado digital A1 (ICP-Brasil) da Instituição de Pagamento / Empresa Transportadora, habilitado pela ANTT
Instalação rápida
Build não interativo em CI/CD (com --no-dev) e configuração do certificado:
veja docs/INSTALL.md.
Uso em 30 segundos
Gerador CIOT v3 (token + API key)
Alternativa simples ao fluxo mTLS: autentica com uma API key e gera/consulta o
CIOT por HTTP. A URL é resolvida pelo CIOT_AMBIENTE; a API key é fornecida pela
sua aplicação (CIOT_API_KEY), nunca fixa no código.
O token JWT é obtido, reutilizado por ~59 min e renovado automaticamente. Além do
uso direto, definir a CIOT_API_KEY faz o GeradorCiot ser usado automaticamente
como OperationIdGenerator — o IdOperacaoTransporte da declararOperacao() passa
a ser gerado por esta API (ocupando o lugar da DLL oficial). Detalhes na seção 4 do
docs/USAGE.md.
Documentação
- 📘
docs/USAGE.md— guia completo com exemplos de todos os serviços, configuração, certificado, tratamento de erros e regras de negócio. - 🔐
docs/INSTALL.md— instalação, build em CI/CD e certificado.
Testes
Ambientes ANTT
| Ambiente | URL base |
|---|---|
| Homologação | https://appservices-hml.antt.gov.br/pefServices |
| Produção | https://appservices.antt.gov.br/pefServices |
A ANTT exige aprovação dos testes em homologação antes de liberar a produção. O host/contexto exato (segmento
api) deve ser confirmado com a ANTT — é configurável viaCIOT_PATH_PREFIXsem alterar código.
Licença
MIT © Thiago de Queiroz.
All versions of laravel-ciot-antt with dependencies
ext-json Version *
ext-openssl Version *
guzzlehttp/guzzle Version ^7.8
illuminate/support Version ^11.0 || ^12.0
illuminate/contracts Version ^11.0 || ^12.0