crazynds / php-nfse
API para geração e comunicação da NFSe com as Prefeituras. Este é um fork do projeto nfephp-org/sped-nfse que foi descontinuado
Requires
- php: ~8.0
- nfephp-org/sped-common: ^5.1
- respect/validation: ^1.1
Requires (Dev)
- phpunit/phpunit: ^12.0
- scrutinizer/ocular: ^1.3
- squizlabs/php_codesniffer: ^2.8
- xerohoster/php-dump-die: dev-main
This package is auto-updated.
Last update: 2025-08-23 23:50:57 UTC
README
Framework para integração com sistemas de Notas Fiscais Eletrônicas de Serviços (NFSe) das Prefeituras Municipais.
Este projeto é um fork do projeto original nfephp-org/sped-nfse https://github.com/nfephp-org/sped-nfse que foi descontinuado.
Este projeto é um fork do fork do projeto original nfephp-org/sped-nfse https://github.com/lucas-simoes/php-nfse que também foi descontinuado.
A emissão de NFSe depende de prévio cadastramento do emissor e da disponibilidade de certificado digital do tipo A1 (PKCS#12), emitido por certificadora no Brasil pertencente ao ICP-Brasil.
🚀 Instalação
Usando Composer
composer require crazynds/php-nfse
Requisitos
-
PHP >= 8.0
-
Extensões PHP:
- curl
- soap
- zlib
- dom
- openssl
- json
- simplexml
- libxml
⚠️ Aviso Importante
As prefeituras podem alterar livremente o modelo de NFSe, layout de XML e acesso aos webservices. Isso torna a integração altamente específica para cada município, podendo afetar a funcionalidade do sistema a qualquer momento. Avalie os riscos antes de utilizar este framework em produção.
Considere constribuir para o projeto para mante-lo sempre atualizado.
🌎 Disponibilidade
É possivel encontrar a disponibilidade de cada município no arquivo AVALIABILITY.md
.
🧪 Exemplos de Uso
Confira os exemplos na pasta examples
.
⭐ Creditos Especiais
- Lucas Simões: Criador do projeto original.
- Tiago Franco: Mantenedor do fork.
- Matheus Felipe Marinho: Mantenedor do fork.
Security
Caso você encontre algum problema relativo a segurança, abra uma ISSUE nesse repositório.
📄 Licença
Este projeto está licenciado sob a Apache License 2.0.