Skip to main content
O ecossistema SUOT reúne os recursos que um desenvolvedor precisa para construir software de transporte no Brasil: documentação pública, um portal de gestão de organização e licenças, um registry Composer privado para distribuição dos pacotes e dois SDKs PHP independentes que cobrem obrigações fiscais e regulatórias. Cada componente tem uma responsabilidade bem definida — você usa apenas o que a sua aplicação precisa.

​
Os quatro componentes

docs.suot.dev

Documentação pública para desenvolvedores. Guias de instalação, referência de API, conceitos de arquitetura, quickstarts e guias de homologação e produção. Você está aqui agora.

developers.suot.dev

Developer Portal da SUOT. Crie e gerencie sua organização, visualize licenças ativas, emita e revogue tokens Composer para membros e pipelines de CI/CD.

packages.suot.dev

Registry Composer privado da SUOT. Hospeda todos os pacotes dos SDKs. O acesso é autenticado por token Composer emitido no Developer Portal — não há pacotes públicos no Packagist.

SDKs PHP

Dois SDKs independentes instalados via Composer: Fiscal SDK para documentos fiscais de transporte e ANTT SDK para obrigações regulatórias. Sem acoplamento entre eles.

​
Dois SDKs independentes

A SUOT oferece dois SDKs com escopos completamente separados. Não existe um pacote agregador que instale ambos — você declara apenas as dependências que a sua aplicação realmente utiliza.
SDKEscopoPacotes principais
SUOT Fiscal SDK para PHPDocumentos fiscais de transporte: CT-e, MDF-esuot/fiscal-core, suot/fiscal-sefaz, suot/fiscal-cte, suot/fiscal-mdfe, suot/fiscal-laravel
SUOT ANTT SDK para PHPObrigações regulatórias ANTT: CIOT, RNTRCsuot/antt-core, suot/antt-ciot, suot/antt-rntrc, suot/antt-laravel
Você pode instalar somente o Fiscal SDK, somente o ANTT SDK ou ambos no mesmo projeto. Eles compartilham a mesma convenção de Command / Handler / Result e a mesma filosofia de tipagem, mas as dependências são inteiramente distintas. Requisitos do Fiscal SDK: PHP 8.4+ e Composer 2. O Laravel Bridge (suot/fiscal-laravel) é opcional. Requisitos do ANTT SDK: PHP 8.4+ e Composer 2. O Laravel Bridge (suot/antt-laravel) é opcional.

​
Sua aplicação coordena

Os SDKs da SUOT executam operações — emitir documentos, consultar registros, enviar lotes. A lógica de negócio que decide quando e como chamar essas operações pertence à sua aplicação hospedeira. A SUOT não impõe uma camada de orquestração: você chama os handlers diretamente. 
Sua aplicação → [Laravel Bridge opcional] → SDK → SEFAZ / Serviço regulatório
O Laravel Bridge (suot/fiscal-laravel ou suot/antt-laravel) é um facilitador de injeção de dependência e configuração via config/ — não é obrigatório. Em qualquer projeto PHP 8.4+ você instancia os handlers diretamente.
A coordenação de fluxos complexos — como emitir um CT-e e depois fechar um MDF-e — é responsabilidade da sua aplicação. O SDK garante que cada operação individual seja executada com tipagem total e retorno previsível.

​
O que é SOT?

A SUOT propõe a categoria SOT — Sistema de Ordens de Transporte. Um SOT é o sistema que governa o ciclo de vida das ordens de transporte: da criação da ordem à entrega, passando por documentos fiscais, obrigações regulatórias e rastreabilidade. Diferente de um ERP genérico ou de um simples emissor fiscal, um SOT trata o transporte como domínio central — não como módulo periférico. Os SDKs da SUOT são a infraestrutura PHP para construir esse tipo de sistema.
Da ordem ao resultado. — Tagline SUOT

Quickstart — primeiro CT-e

Instale o Fiscal SDK e autorize seu primeiro CT-e de teste em menos de 15 minutos.

Developer Platform

Crie sua organização, obtenha sua licença e gere tokens Composer.