Obrigações disponíveis
A tabela abaixo relaciona as obrigações regulatórias cobertas ou planejadas pelo SDK:| Obrigação | Pacote | Status |
|---|---|---|
| CIOT | suot/antt-ciot | Disponível |
| RNTRC | suot/antt-rntrc | Disponível |
| PEF | — | Em desenvolvimento |
| Vale-pedágio | — | Roadmap |
| Piso mínimo de frete | — | Roadmap |
| MONITRIIP | — | Roadmap |
| Autorizações de passageiros | — | Roadmap |
Pacotes disponíveis
O SDK é distribuído em pacotes independentes para que você instale apenas o que precisa:| Pacote | Responsabilidade |
|---|---|
suot/antt-core | Contratos, Value Objects e infraestrutura compartilhada |
suot/antt-ciot | Registro, consulta e encerramento de CIOT |
suot/antt-rntrc | Consulta de situação cadastral de transportadores |
suot/antt-laravel | Bridge opcional para Laravel (ServiceProvider, DI, config) |
suot/antt-core é a única dependência obrigatória — os demais pacotes dependem dele automaticamente via Composer.
Developer Experience
O SUOT ANTT SDK adota o mesmo padrão de qualidade do SUOT Fiscal SDK:- Tipagem total — nenhum parâmetro do tipo
mixedouarraysem forma definida - PHPStan nível máximo — toda a base de código é verificada no nível mais estrito disponível
- Sem métodos mágicos — comportamento explícito em cada classe; o que não está declarado não existe
- Named arguments — todos os comandos e Value Objects aceitam argumentos nomeados para clareza na chamada
- Value Objects — CNPJ, código CIOT, número RNTRC e demais primitivos são representados por objetos com validação interna
- PHPDoc em pt-BR — documentação inline escrita em português, sem ambiguidade conceitual
- Padrão CQRS — Command → Handler → Result; sem side effects ocultos, sem estado global
O SUOT ANTT SDK e o SUOT Fiscal SDK são independentes. Não existe pacote agregador entre eles. Instale apenas os pacotes que a sua aplicação utiliza.
Requisitos
Antes de instalar, confirme que o seu ambiente atende aos requisitos mínimos:- PHP 8.4 ou superior — o SDK utiliza recursos de tipagem introduzidos no PHP 8.4
- Composer 2 — necessário para resolução de dependências e acesso ao registry privado
- Licença SUOT ativa — necessária para autenticação no registry
packages.suot.dev
Próximos passos
Instalação
Configure o registry, autentique e instale os pacotes do ANTT SDK via Composer.
CIOT
Registre, consulte e encerre Códigos Identificadores de Operação de Transporte.
RNTRC
Consulte a situação cadastral de transportadores rodoviários de cargas.