O que o Fiscal SDK oferece
CT-e
Emissão, cancelamento, carta de correção e consulta de Conhecimento de Transporte Eletrônico com tipagem completa e validação em camadas.
MDF-e
Emissão, encerramento, inclusão de condutor e cancelamento de Manifesto Eletrônico de Documentos Fiscais para cargas em trânsito.
SEFAZ / Autorizadores
Suporte aos autorizadores estaduais, SVC-AN e SVC-RS. Chaveamento por UF com fallback configurável e tratamento padronizado de retornos.
Laravel Bridge
Integração nativa com Laravel: Service Provider, Facades, configuração via
config/fiscal.php e suporte a múltiplos emitentes por tenant.Pacotes disponíveis
O Fiscal SDK é distribuído como um conjunto de pacotes Composer independentes e composáveis. Instale apenas o que o seu projeto precisa.| Pacote | Descrição |
|---|---|
suot/fiscal-core | Tipos base, Value Objects, contratos e interfaces compartilhadas por todos os pacotes fiscais |
suot/fiscal-sefaz | Comunicação com os autorizadores SEFAZ: envio, consulta, retorno e tratamento de erros |
suot/fiscal-cte | Emissão e gestão completa de CT-e: construção, assinatura, transmissão e eventos |
suot/fiscal-mdfe | Emissão e gestão completa de MDF-e: construção, assinatura, transmissão e encerramento |
suot/fiscal-laravel | Laravel Bridge opcional: Service Provider, Facades e helpers de configuração |
Documentos em desenvolvimento e roadmap
O Fiscal SDK está em expansão contínua. Os documentos abaixo estão previstos e serão disponibilizados em versões futuras:Os documentos listados nesta seção ainda não estão disponíveis para uso em produção. As informações abaixo refletem o estado atual de desenvolvimento e podem ser alteradas sem aviso prévio.
Developer Experience
O Fiscal SDK foi projetado desde o início para oferecer uma experiência de desenvolvimento previsível e produtiva:- Tipagem total — sem arrays associativos soltos ou
mixed. Cada campo é um tipo ou Value Object com validação embutida. - PHPStan nível máximo — toda a base de código é validada no nível máximo de análise estática, garantindo contratos explícitos em cada API pública.
- Sem métodos mágicos — nenhum
__get,__setou__call. O que a IDE e a IA enxergam é exatamente o que existe. - Named arguments e enums — APIs construídas com parâmetros nomeados e enums PHP 8.1+ para eliminar erros por posição e magic strings.
- Fluent Interface com Step Builder — construção de documentos guiada passo a passo pelo compilador: você não consegue criar um CT-e incompleto sem um erro de tipo.
- Padrão CQRS — Command, Handler e Result explícitos em todas as operações de transmissão. Sem efeitos colaterais escondidos.
- PHPDoc em pt-BR — toda a documentação inline está em português do Brasil, facilitando leitura por equipes nacionais e ferramentas de IA treinadas no contexto fiscal brasileiro.
Requisitos
Antes de instalar o Fiscal SDK, verifique se o seu ambiente atende aos seguintes requisitos:- PHP 8.4 ou superior
- Composer 2 (Composer 1 não é suportado)
- Licença SUOT ativa — obtenha a sua em developers.suot.dev
- Token Composer — gerado no painel SUOT para autenticar o acesso ao registry privado (saiba mais)
- Extensões PHP:
openssl,soap,curl,mbstring,dom(geralmente já presentes em ambientes de produção)
Próximos passos
Instalação
Configure o registry privado e instale os pacotes do Fiscal SDK com Composer.
Configuração
Configure o CNPJ emitente, certificado digital A1 e ambiente SEFAZ.
Emitir CT-e
Construa e transmita seu primeiro Conhecimento de Transporte Eletrônico.