---
tags: [projeto, intranet, nfse, fiscal, sefin]
status: em-andamento
date: 2026-04-29
---

# NFSe Nacional - Modulo de Notas Fiscais de Servico

## Visao Geral

Emissao de NFSe via SEFIN com XML e assinatura digital, PDF gerado via dompdf, e importacao automatica via DF-e.

## Status Atual

- **Emissao SEFIN funcionando** — HTTP 201 confirmado em homologacao + producao
- **Producao ativada** — `CronNfseAutomatica` usa `emitirSefin()`
- **45+ notas importadas** via DF-e (emitidas + tomadas)

## PDF DANFSE

- Redesenhado **100% igual ao oficial** da Receita Federal
- Gerado via **dompdf**
- Layout fiel ao documento oficial

## Configuracoes (nfse_configs)

Campos adicionados na tabela de configuracao:
- `telefone`
- `email`
- `endereco`
- `cep`

View de configuracao atualizada com os novos campos.

## Cron de Importacao

```
*/30 8-21 * * *
```

Roda a cada 30 minutos, das 8h as 21h.

## Regras de Emissao

### Campos Obrigatorios
- **cTribNac** (Codigo de Tributacao Nacional) — obrigatorio

### Campos NAO Obrigatorios
- Codigo de Servico Municipal
- CNAE

### Bloqueios
- Cliente inativo, CNPJ vazio, contrato encerrado, `data_fim` passada sem aditivo
- Pula se `boletos.ignorar_sync_sicoob = 1`
- Sem fallback de servico — exige `cliente_servicos` com match em `nfse_servicos_config`

## Auto-sync servico → nfse_servicos_config

`ClienteServicoModel::salvarServicosCliente()` garante que todo servico marcado no cadastro do cliente existe em `nfse_servicos_config`. Cria automaticamente com codigo padrao 170601 e aliquota 5% se faltar.

## Endpoints diagnosticos

- `GET /nfse/cancelar-diagnostico/{notaId}?token=X&motivo=X` — cancela NFSe no SEFIN sem auth de sessao

## Memorias detalhadas

- [[nfse-emissao-sefin]] — fluxo tecnico completo
- [[nfse-cmun-fix-2026-04-28]] — fix do codigo do municipio
- [[auditoria-cobranca-2026-04-17]] — auditoria que cobre NFSe
- [[relatorio-sindicancia-2026-04-17]] — sindicancia completa

## Pendencias
- [ ] Pre-preencher CNAE/codigos servico no mapeamento

## Relacionados
- [[financeiro-modulo]]
- [[memorias/pendentes]]