README

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.

Status: Em desenvolvimento. Use por sua conta e risco.

📦 Instalação

composer require marcelabeh/emissor-nfse-nacional

🚀 Uso Rápido

use MarcelaBeh\EmissorNfseNacional\Presentation\Facade\NfseNacionalFacade;
use MarcelaBeh\EmissorNfseNacional\Presentation\Factory\ConfigFactory;
use NFePHP\Common\Certificate;

// 1. Carregar certificado
$certificado = Certificate::loadPfx($caminhoCertificado, $senha);

// 2. Criar configuração
$config = ConfigFactory::createHomologacao('codigo-ibge-municipio');

// 3. Criar facade
$nfse = NfseNacionalFacade::create((array)$config, $certificado);

// 4. Emitir DPS
$response = $nfse->emitirDps($dpsRequest);

📚 Documentação

✅ Requisitos

• PHP 8.3+
• ext-dom, ext-curl, ext-zlib, ext-openssl, ext-mbstring

🔧 Qualidade de Código

composer test    # PHPUnit (481 testes)
composer cs     # PHP-CS-Fixer (dry-run)
composer cs:fix # PHP-CS-Fixer (aplicar)
composer stan    # PHPStan nível 8
composer check   # Tudo junto

Badge	Info
	PHP 8.3+
	Análise estática
	100% passando
	Código limpo

📁 Estrutura

src/
├── Domain/           # Entidades e Value Objects
├── Application/     # Services e DTOs
├── Infrastructure/  # HTTP, XML, Segurança
└── Presentation/    # Facade e Factories

📄 API Principal

NfseNacionalFacade - Ponto único de entrada:

• emitirDps(DpsRequest) → NfseResponse
• consultarPorChave(string) → NfseResponse|null
• consultarDpsPorChave(string) → array
• cancelar(EventoRequest) → EventoResponse
• consultarEventos(string) → array
• consultarDanfse(string) → string|array
• consultarDanfseNfse(string) → string|array

⚠️ Avisos Importantes

Configuração do Município

A variável prefeitura aceita:

• Código IBGE do município (recomendado)
• Identificador textual (ex: americana-sp) - temporário

Encoding XML

O XML pode vir em ISO-8859-1. Use o segundo parâmetro se necessário:

$nfse->consultarNfseChave('CHAVE', false);

🐛 FAQ - Erro E999

O erro E999 indica falha não catalogada pela Receita. Causas comuns:

• CNPJ/CPF do prestador não cadastrado/habilitado na NFSe Nacional
• Erros de servidor (500)
• Problemas no ambiente de homologação (comum)

📦 API Legado (v1)

Consulte examples/ para detalhes.

🤝 Créditos

• Original: hadder/nfse-nacional por Fernando Friedrich
• Baseado em: NFePHP por Roberto L. Machado
• Mantido por: Marcela Beatriz