ACBr PHP — documentação em português
Integre NF-e e NFC-e a aplicações PHP sem depender de Laravel, Symfony, Node.js ou FFI. O cliente envia uma requisição por operação a um worker nativo ACBr separado e entrega objetos de documento, configuração, resultado e erro.
Estado: 0.1.0-alpha2, pré-release publicada no Packagist. Esta documentação fixa a tag no commit a3815542ee1a7d922d0cb4c553f53bf97144f0d4, com runtime 0.2.1. Instale pela origem Composer publicada. Os exemplos deste site são sintéticos e offline ou simulados. A fonte registra provas históricas de um roteiro específico de homologação NF-e 55; isso não certifica outros cenários nem produção. Veja fontes e limites.
Comece aqui
- Confira a plataforma e instalação: PHP 8.2+, Linux x64 e glibc.
- Instale e confira o runtime fixado.
- Execute a primeira geração offline, com dados sintéticos de homologação.
- Explore a ajuda de campos e tipos e os modelos antes de montar seu próprio documento.
- Prepare configuração A1/CSC e leia resultados, erros e recuperação antes de qualquer operação de rede.
Recursos desta revisão
| Recurso | Situação e alcance |
|---|---|
| NF-e 55 e NFC-e 65 | Geração, validação e assinatura nativa com evidência offline no projeto |
| API síncrona | gerarXml, validar, assinar, transmitir, consultar, cancelar, cartaCorrecao, inutilizar, recuperarXml |
| Configuração e contrato | A1, CSC, 204 tipos gerados; validação estrutural e help de campos |
| Operações SEFAZ | Testes automatizados com mocks/HTTPS local; relato histórico de roteiro NF-e 55 delimitado nas fontes |
| Assíncrono | Fila opcional em Linux CLI com pcntl e posix; uma operação ativa por instância |
| Windows, ARM, macOS e Alpine/musl | Sem suporte neste pacote PHP |
| DANFE, PDF, impressão e A3 | Ausentes no motor fixado |
| Recuperação de XML | recuperarXml usa o XML original assinado; limites e testes sintéticos em recuperação |
O runtime usado é a distribuição Linux x64 0.2.1 do projeto ACBr Node, revisão ACBr 48590, sem modificações. O nome da embalagem npm não torna Node.js uma dependência do cliente PHP.
Navegação da documentação
- Instalação e plataformas
- Runtime, integridade e licenças
- Configuração segura, A1 e CSC
- Primeiro XML e exemplos
- Ajuda de campos e tipos
- Modelos e contrato de entrada
- Referência completa dos 204 tipos
- Referência da API
- Operações fiscais e parâmetros
- Resultados e confirmação
- Erros, TLS, timeout e cancelamento
- Recuperação e reconciliação
- Fila assíncrona
- Perguntas frequentes
- Fontes, licenças e validação
Todos os exemplos fornecidos são sintéticos, restritos ao ambiente HOMOLOGAÇÃO, e não têm valor fiscal. Os exemplos executáveis de operações de rede usam um motor simulado e não contactam a SEFAZ. Ambiente 2 continua sendo uma operação fiscal real quando uma aplicação chama um serviço remoto.