Skip to main content
SUOT para Desenvolvedores — infraestrutura para quem constrói software de transporte no Brasil. SDKs tipados para documentos fiscais e obrigações regulatórias, com DX pensada para PHP 8.4+, Laravel, IDEs e agentes de IA.

Avaliar o Fiscal SDK

Leia a API pública, veja exemplos de CT-e com $cte->…->handle() e entenda Result e rejeição — sem criar conta.

Contratar / Developer Portal

Crie a organização, ative a licença e gere tokens Composer para instalar via packages.suot.dev.

CT-e

Emitir, consultar, eventos, contingência e DF-e com $cte->…->handle().

Instalar com Composer

Registry privado, autenticação e composer require quando for integrar de verdade.

Como funciona

Não há API REST intermediária. Você consome o SDK na sua aplicação:
A documentação é pública. Conta e licença não são pré-requisito para avaliar a API. Licença e token Composer entram quando você for instalar os pacotes no seu projeto.

Mental model (CT-e)

Monte a intenção no client e encerre em handle():
Rejeição fiscal é Result (isRejected(), failure()), não exception. Falha de infraestrutura (rede, certificado) é exception. O host persiste XML/chave e executa retry — o SDK só orienta.

Primeiros passos

1

Entenda a API pública

Leia API pública e a jornada CT-e.
2

Siga a trilha Avaliar

Veja Avaliar o SDK — caminho de aprendizado da API pública, Result e fluxos de CT-e.
3

Instale quando for integrar

Com licença ativa, configure o registry e rode composer requireInstalação.
4

Homologue na SEFAZ

Ambiente de homologação, certificado e flags explícitas antes de produção — Homologação.

Por que SUOT?

Tipagem total

PHPStan no máximo, zero métodos mágicos. Autocomplete sem configuração extra.

Pronto para IA

PHPDoc em pt-BR, enums e named arguments — agentes geram código alinhado à API.

Laravel ou agnóstico

PHP 8.4+ direto ou Laravel Bridge com DI e config/.

Result sem ambiguidade

Rejeição esperada → Result. Falha técnica → InfrastructureException.