Começar integração
Do zero ao primeiro CT-e autorizado: configure o registry, instale os pacotes e envie seu primeiro documento fiscal.
Acessar Developer Portal
Crie sua organização, obtenha sua licença e gere tokens Composer para acessar o registry privado.
Fiscal SDK
Documentos fiscais — CT-e, MDF-e e base futura para CT-e OS e BP-e — por API PHP tipada.
ANTT SDK
CIOT, RNTRC e obrigações regulatórias junto à ANTT por API PHP tipada.
Developer Platform
Organizações, licenças, tokens Composer e acesso ao registry privado.
Como funciona
A SUOT fornece SDKs independentes que a sua aplicação hospedeira consome diretamente. Não existe uma API REST intermediária — você instala os pacotes via Composer, configura credenciais e chama os handlers tipados.A coordenação das obrigações fiscais e regulatórias pertence à sua aplicação. Os SDKs executam as operações; a sua lógica de negócio decide quando e como chamá-los.
Primeiros passos
Acesse o Developer Portal
Crie sua organização em developers.suot.dev e gere seu token Composer. A licença é vinculada à organização.
Configure o registry Composer
Adicione
packages.suot.dev como repositório Composer autenticado com seu token pessoal ou de CI/CD.Instale o SDK desejado
Use
composer require para instalar os pacotes do Fiscal SDK, do ANTT SDK ou de ambos — são independentes.Por que SUOT?
Tipagem total
PHPStan máximo, zero métodos mágicos. Autocomplete funciona em qualquer IDE sem configuração extra.
Pronto para IA
PHPDoc em pt-BR, tipos explícitos e named arguments permitem que agentes de IA como Copilot e Claude Code gerem código correto na primeira tentativa.
Laravel ou framework-agnostic
Use diretamente em qualquer projeto PHP 8.4+ ou ative o Laravel Bridge para injeção de dependência e configuração via
config/.Resultado ou exceção — sem ambiguidade
Rejeições esperadas retornam um
Result. Falhas técnicas lançam InfrastructureException. Nunca um array anônimo.Explore a documentação
Quickstart
Do zero ao primeiro CT-e autorizado em minutos.
Ecossistema SUOT
Entenda como docs, developer portal, registry e SDKs se relacionam.
Conceitos de arquitetura
Command, Handler, Result, Value Objects e CQRS — os blocos fundamentais.
Guia de homologação
Configure o ambiente de testes antes de ir para produção.