> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suot.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# SUOT — SDKs PHP para Software de Transporte no Brasil

> SDKs tipados para documentos fiscais e obrigações regulatórias de transporte no Brasil. PHP 8.4+, Laravel, IDEs e agentes de IA.

SUOT para Desenvolvedores — infraestrutura para quem constrói software de transporte no Brasil.

**Infraestrutura para construir software de transporte no Brasil.**

SDKs tipados para documentos fiscais e obrigações regulatórias, com uma experiência de desenvolvimento pensada para PHP, Laravel, IDEs e agentes de IA. Da ordem ao resultado.

<CardGroup cols={2}>
  <Card title="Começar integração" icon="rocket" href="/introducao/quickstart">
    Do zero ao primeiro CT-e autorizado: configure o registry, instale os pacotes e envie seu primeiro documento fiscal.
  </Card>

  <Card title="Acessar Developer Portal" icon="building-columns" href="https://developers.suot.dev">
    Crie sua organização, obtenha sua licença e gere tokens Composer para acessar o registry privado.
  </Card>
</CardGroup>

<CardGroup cols={3}>
  <Card title="Fiscal SDK" icon="file-invoice" href="/fiscal/visao-geral">
    Documentos fiscais — CT-e, MDF-e e base futura para CT-e OS e BP-e — por API PHP tipada.
  </Card>

  <Card title="ANTT SDK" icon="truck" href="/antt/visao-geral">
    CIOT, RNTRC e obrigações regulatórias junto à ANTT por API PHP tipada.
  </Card>

  <Card title="Developer Platform" icon="building" href="/platform/organizacoes">
    Organizações, licenças, tokens Composer e acesso ao registry privado.
  </Card>
</CardGroup>

## 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.

```
Sua aplicação → [Laravel Bridge opcional] → SDK → SEFAZ / Serviço regulatório
```

<Note>
  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.
</Note>

## Primeiros passos

<Steps>
  <Step title="Acesse o Developer Portal">
    Crie sua organização em [developers.suot.dev](https://developers.suot.dev) e gere seu token Composer. A licença é vinculada à organização.
  </Step>

  <Step title="Configure o registry Composer">
    Adicione `packages.suot.dev` como repositório Composer autenticado com seu token pessoal ou de CI/CD.
  </Step>

  <Step title="Instale o SDK desejado">
    Use `composer require` para instalar os pacotes do Fiscal SDK, do ANTT SDK ou de ambos — são independentes.
  </Step>

  <Step title="Faça sua primeira operação">
    Construa um Command, passe para o Handler e inspecione o Result. Autocomplete e PHPDoc em pt-BR guiam cada etapa.
  </Step>
</Steps>

## Por que SUOT?

<CardGroup cols={2}>
  <Card title="Tipagem total" icon="code">
    PHPStan máximo, zero métodos mágicos. Autocomplete funciona em qualquer IDE sem configuração extra.
  </Card>

  <Card title="Pronto para IA" icon="robot">
    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.
  </Card>

  <Card title="Laravel ou framework-agnostic" icon="laravel">
    Use diretamente em qualquer projeto PHP 8.4+ ou ative o Laravel Bridge para injeção de dependência e configuração via `config/`.
  </Card>

  <Card title="Resultado ou exceção — sem ambiguidade" icon="shield-check">
    Rejeições esperadas retornam um `Result`. Falhas técnicas lançam `InfrastructureException`. Nunca um array anônimo.
  </Card>
</CardGroup>

## Explore a documentação

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/introducao/quickstart">
    Do zero ao primeiro CT-e autorizado em minutos.
  </Card>

  <Card title="Ecossistema SUOT" icon="diagram-project" href="/introducao/ecossistema">
    Entenda como docs, developer portal, registry e SDKs se relacionam.
  </Card>

  <Card title="Conceitos de arquitetura" icon="layer-group" href="/conceitos/arquitetura">
    Command, Handler, Result, Value Objects e CQRS — os blocos fundamentais.
  </Card>

  <Card title="Guia de homologação" icon="flask" href="/guias/homologacao">
    Configure o ambiente de testes antes de ir para produção.
  </Card>
</CardGroup>