---
name: NFSe Emissão via SEFIN
description: Detalhes técnicos da emissão NFSe Nacional via endpoint SEFIN com XML+assinatura digital - testado e funcionando HTTP 201
type: project
---

## Emissão NFSe Nacional - Integração Completa (2026-03-12)

### Endpoint Correto
- **Produção**: `POST https://sefin.nfse.gov.br/SefinNacional/nfse`
- **Homologação**: `POST https://sefin.producaorestrita.nfse.gov.br/SefinNacional/nfse`
- **NÃO usar ADN** (`adn.nfse.gov.br/contribuinte/`) - retorna 404 para emissão

### Fluxo de Emissão
1. Montar XML `<infDPS>` (sem `<DPS>` wrapper)
2. Carregar em DOM com `<DPS versao="1.00" xmlns="http://www.sped.fazenda.gov.br/nfse">`
3. C14N **inclusive** (`C14N(false, false)`) do infDPS → SHA1 digest
4. Montar SignedInfo → C14N inclusive → RSA-SHA1 assinatura
5. Montar XML final como **string** (não DOM) com `<DPS versao="1.00" xmlns="...">` + infDPS + Signature
6. gzencode() → base64_encode()
7. POST JSON: `{"dpsXmlGZipB64": "<base64>"}`

### Campos XML Validados (HTTP 201)
- `tpAmb`: 1 (prod) ou 2 (homolog)
- `tpEmit`: 1
- `cLocEmi`: 3154606 (IBGE Rib. Neves)
- `opSimpNac`: 3 (ME/EPP)
- `regApTribSN`: 1 (obrigatório para opSimpNac=3)
- `regEspTrib`: 0
- `cTribNac`: 170601
- `tribISSQN`: 1
- `tpRetISSQN`: 1
- `pTotTribSN`: 4.23 (em vez de indTotTrib para ME/EPP)
- **SEM `<IM>`** em homologação (E0120)
- `dCompet`: formato `Y-m-d` (data completa, não só ano-mês)
- `serie`: 900 para testes

### Estrutura XML Específica (diferente do schema docs)
- Endereço: `<end><endNac><cMun>...</cMun><CEP>...</CEP></endNac><xLgr>...</xLgr></end>`
- Serviço: `<serv><locPrest><cLocPrestacao>3154606</cLocPrestacao></locPrest><cServ><cTribNac>170601</cTribNac><xDescServ>...</xDescServ></cServ></serv>`
- Valores: `<valores><vServPrest><vServ>100.00</vServ></vServPrest><trib>...</trib></valores>`

### Problemas Resolvidos
- **E0008 data futura**: Servidor PHP em UTC, SEFIN em Brasília. Fix: forçar `America/Sao_Paulo` no timezone
- **RNG6110 versao**: `versao="1.00"` vai no `<DPS>` (não no `<infDPS>`), mas deve ser montado como STRING, não como atributo DOM
- **`<?xml` em comentário PHP**: Causa parse error pois PHP interpreta como open tag
- **C14N exclusive vs inclusive**: Deve usar `C14N(false, false)` (inclusive), não `C14N(true, false)` (exclusive)

### Arquivos
- `app/Libraries/NfseNacionalApi.php`: `emitirSefin()`, `montarDPSXml()`, `assinarXmlDPS()`
- `app/Controllers/Nfse.php`: `processarEmissao()`, `testeEmissao()`
- `app/Views/nfse/danfse_pdf.php`: Template DANFSE para dompdf (redesenhado 100% igual ao oficial da Receita)
- `app/Controllers/CronNfseAutomatica.php`: Emissão automática via SEFIN ao pagar boleto

### PDF DANFSE (ATUALIZADO 2026-03-12)
- API da Receita NÃO retorna PDF para download (endpoints /danfse/ e /nfse/{chave}/pdf retornam erro)
- Solução: gerar PDF localmente via **dompdf** usando dados do XML importado
- Template: `app/Views/nfse/danfse_pdf.php` - **Layout 100% igual ao oficial da Receita Federal**
  - Header: Logo NFS-e + DANFSe v1.0 + Município
  - Chave de Acesso
  - Grid: Número NFS-e, Competência, Data/Hora, DPS, Série
  - EMITENTE DA NFS-e (Prestador): CNPJ, IM, Telefone, Nome, Email, Endereço, Município, CEP, Simples Nacional
  - TOMADOR DO SERVIÇO: mesmos campos
  - INTERMEDIÁRIO DO SERVIÇO
  - SERVIÇO PRESTADO: Código Tributação Nacional, Municipal, Local, País, Descrição
  - TRIBUTAÇÃO MUNICIPAL: ISSQN, regime, valores, BC, alíquota, retenção
  - TRIBUTAÇÃO FEDERAL: IRRF, contribuições
  - VALOR TOTAL DA NFS-E
  - TOTAIS APROXIMADOS DOS TRIBUTOS
  - INFORMAÇÕES COMPLEMENTARES
  - Footer com logo GotechBR
- Cache: `writable/uploads/nfse/danfse_*.pdf`

### Tabela nfse_configs - Campos Adicionados (2026-03-12)
- `telefone`, `email`, `endereco`, `cep` - dados do emitente para o DANFSE PDF
- View config atualizada com esses campos

### Importação DF-e
- Endpoint: `GET https://adn.nfse.gov.br/contribuintes/DFe/{NSU}` (contribuinte**S** com S!)
- 404 = sem documentos novos (normal, não erro)
- XML no response: `ArquivoXml` é base64(gzip(xml))
- 45 notas importadas (emitidas + tomadas)
- Cron: `*/30 8-21 * * *` via cPanel

### Cod. Serviço Municipal e CNAE
- Campos `codigo_servico` e `cnae` existem na tabela `nfse_servicos_config`
- Visíveis na tela de config em "Mapeamento de Serviços"
- **NÃO são obrigatórios** para emissão via NFSe Nacional (o `cTribNac` é o obrigatório)
- São opcionais e servem para referência no DANFSE e controle interno