Download the PHP package marcelabeh/emissor-nfse-nacional without Composer
On this page you can find all versions of the php package marcelabeh/emissor-nfse-nacional. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download marcelabeh/emissor-nfse-nacional
More information about marcelabeh/emissor-nfse-nacional
Files in marcelabeh/emissor-nfse-nacional
Download marcelabeh/emissor-nfse-nacional
More information about marcelabeh/emissor-nfse-nacional
Files in marcelabeh/emissor-nfse-nacional
Vendor marcelabeh
Package emissor-nfse-nacional
Short Description Biblioteca PHP para emissão, consulta e cancelamento de NFS-e Nacional (Sefin) — Clean Architecture, validação XSD v1.01, assinatura SHA-256, suporte IBS/CBS
License LGPL-3.0-or-later
Homepage https://github.com/marcelabeh/emissor-nfse-nacional
Package emissor-nfse-nacional
Short Description Biblioteca PHP para emissão, consulta e cancelamento de NFS-e Nacional (Sefin) — Clean Architecture, validação XSD v1.01, assinatura SHA-256, suporte IBS/CBS
License LGPL-3.0-or-later
Homepage https://github.com/marcelabeh/emissor-nfse-nacional
FAQ
After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.
Example:
Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories.
In this case some credentials are needed to access such packages.
Please use the auth.json textarea to insert credentials, if a package is coming from a private repository.
You can look here for more information.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?
Informations about the package emissor-nfse-nacional
NFSe Padrão Nacional
Biblioteca PHP para integração com NFSe Nacional - Pacote Composer reutilizável para emissão, consulta e cancelamento de Notas Fiscais de Serviço Eletrônicas no padrão nacional.
Clean Architecture • SOLID • PSR-12 • PSR-3 (logging) • PHP 8.3+ • PHPStan Level 8
📦 Instalação
🚀 Uso Rápido
📚 Documentação
| Documento | Descrição |
|---|---|
| GUIA_IMPLEMENTACAO.md | Guia completo de uso com exemplos |
| ARQUITETURA.md | Arquitetura do sistema e decisões de design |
| SEGURANCA_COMPLIANCE.md | Diretrizes de segurança |
| CONTRIBUTING.md | Como contribuir |
| CHANGELOG.md | Histórico de alterações |
| examples/ | Exemplos práticos de uso |
✅ Requisitos
- PHP 8.3+
- ext-dom, ext-curl, ext-zlib, ext-openssl, ext-mbstring
🔧 Qualidade de Código
Métricas:
- ✅ Suíte completa de testes unitários e de integração
- ✅ PHPStan nível 8 (máximo rigor) - 0 erros
- ✅ Clean Architecture com SOLID
- ✅ PSR-12 (estilo) e PSR-3 (logging)
- ✅ Conformidade com os schemas NFSe Nacional v1.00 e v1.01
📁 Estrutura
🏛️ Padrões Aplicados
| Padrão | Onde |
|---|---|
| Clean Architecture | Separação em camadas (Domain → Application → Infrastructure → Presentation) |
| Facade | NfseNacionalFacade - ponto único de entrada |
| Factory | ServiceFactory, ConfigFactory - criação de dependências |
| DTO | DpsRequest, NfseResponse, EventoRequest - transporte de dados |
| Value Object | Cnpj, Cpf, Money, ChaveAcesso - imutáveis e auto-validáveis |
| Validator | DpsValidator, XsdValidator - validação de entrada e XML |
🔄 Fluxo de Uso
📄 API Principal
NfseNacionalFacade - Ponto único de entrada:
emitirDps(DpsRequest)→NfseResponseconsultarPorChave(string)→NfseResponse|nullconsultarDpsPorChave(string)→arraycancelar(EventoRequest)→EventoResponseconsultarEventos(string)→array
⚠️ Avisos Importantes
Configuração do Município
A variável prefeitura deve receber o código IBGE do município (7 dígitos), conforme especificação dos XSDs da NFSe (ABRASF).
Encoding XML
O XML pode vir em ISO-8859-1. Use o segundo parâmetro se necessário:
🐛 Erros da SEFIN
Quando a emissão/evento é rejeitado, a SEFIN retorna os erros estruturados. A resposta os expõe:
Os códigos (E0617, E1860, ...) e suas descrições vêm da própria SEFIN. Causas comuns de rejeição:
- CNPJ/CPF do prestador não habilitado na NFS-e Nacional
- Dados fiscais inconsistentes com o município/regime
- Indisponibilidade do ambiente de homologação
🤝 Créditos e Agradecimentos
Este projeto é uma reestruturação completa com Clean Architecture do projeto original.
📦 Projeto Original
- Repositório: hadder/nfse-nacional
- Autor: Fernando Friedrich (@fernando-friedrich)
- Contribuição: Base inicial e compreensão das regras de negócio NFSe Nacional
🔐 Dependências
- NFePHP/sped-common - Manipulação de certificados digitais A1/A3 e assinatura XML
- Projeto mantido pela comunidade brasileira desde 2008
- github.com/nfephp-org/sped-common
- Criado por Roberto L. Machado (@robmachado)
👩💻 Manutenção Atual
- Marcela Beatriz (@marcelabeh)
- Arquitetura: Clean Architecture + SOLID + DDD
- Análise estática: PHPStan level 8
📜 Licença
LGPL-3.0-or-later (GNU Lesser General Public License v3.0 ou posterior)
Veja o arquivo LICENSE para detalhes completos.
💼 O que isso significa?
✅ Você PODE:
- Usar comercialmente (grátis)
- Modificar o código
- Distribuir em projetos proprietários
- Vender produtos que usam esta biblioteca
⚠️ Você DEVE:
- Manter o copyright original
- Se modificar A BIBLIOTECA, compartilhar as mudanças (LGPL)
- Incluir uma cópia da licença LGPL
All versions of emissor-nfse-nacional with dependencies
PHP Build Version
Package Version
Requires
php Version
^8.3
composer-runtime-api Version ^2.0
nfephp-org/sped-common Version ^5.1
ext-dom Version *
ext-curl Version *
ext-zlib Version *
ext-openssl Version *
ext-mbstring Version *
psr/log Version ^3.0
composer-runtime-api Version ^2.0
nfephp-org/sped-common Version ^5.1
ext-dom Version *
ext-curl Version *
ext-zlib Version *
ext-openssl Version *
ext-mbstring Version *
psr/log Version ^3.0
The package marcelabeh/emissor-nfse-nacional contains the following files
Loading the files please wait ...