Automatizar o processo de emissão de Notas Fiscais de Serviço eletrônicas (NFS-e) a partir do momento em que uma parcela do Contas a Receber é quitada, eliminando a necessidade de intervenção manual do usuário. A funcionalidade introduz um controle hierárquico, permitindo configurações globais no Plano de Contas e ajustes finos por plano e por parcela.
2. Fluxo de Configuração e Regras de Negócio
2.1 Configuração no Plano de Contas
O ponto de partida da funcionalidade é o cadastro/edição de itens no Financeiro > Plano de Contas.
- Gatilho visual: A configuração de automação só é exibida se o checkbox "Item é um serviço sujeito a ISS" estiver marcado.
- Comportamento do campo: Exibir o combo "Permitir emissão automática de NFS-e no Contas a Receber" com as seguintes opções:
- Não permitir (Padrão/Default)
- Permitir (padrão marcado)
- Permitir (padrão desmarcado)
⚠️ Atenção: Se o usuário desmarcar a opção "Item é um serviço sujeito a ISS", o campo de emissão automática deve ser ocultado e seu valor resetado para Não permitir.
2.2 Contas a Receber (Aba: Dados do Plano)
Centraliza o comportamento padrão que será replicado para as parcelas do contrato.
- Exibição: O checkbox "Gerar NFS-e automaticamente ao quitar o plano" só aparece se a categoria/item selecionado no plano de contas permitir a emissão.
- Regra de Inicialização:
- Se no Plano de Contas estiver Permitir (padrão marcado) → Checkbox nasce marcado.
- Se no Plano de Contas estiver Permitir (padrão desmarcado) → Checkbox nasce desmarcado.
- Tooltip Informativo (Gatilho no Texto):
- Ao passar o mouse (hover) sobre o texto do campo "Gerar NFS-e automaticamente ao quitar o plano", o sistema deve exibir a mensagem:
"Ao marcar esta opção, todas as parcelas do plano serão configuradas para gerar NFS-e automaticamente no momento da quitação. Você poderá ajustar individualmente por parcela na aba Parcelas." 
📌 Regra Crucial de Comportamento (Apenas na Criação):
- No momento de salvar o NOVO plano:
- Se o checkbox estiver marcado ao salvar → Todas as parcelas geradas no grid nascerão com Gerar NFS-e = Sim.
- Se o checkbox estiver desmarcado ao salvar → Todas as parcelas geradas no grid nascerão com Gerar NFS-e = Não.
- ⚠️ Comportamento após o plano ser salvo (Edição):
- Este checkbox funciona exclusivamente como um parâmetro de criação. Se o usuário editar um plano existente, marcar ou desmarcar este checkbox e clicar em salvar, o sistema não fará nada nas parcelas. Qualquer ajuste posterior deve ser feito de forma fina, diretamente na aba de Parcelas.
2.3 Visibilidade nos Grids (Plano Financeiro e Parcelamento do Curso)
Financeiro → Aba Parcelas (Grid)
- Nova Coluna: NFS-e Aut.
- Componente Visual: Uma Checkbox na linha de cada parcela.
- Desmarcada: Indica que não irá gerar (Não).
- Marcada: Indica que a parcela está configurada para gerar a nota (Sim).
- Edição Individual: Ao abrir a modal/tela de edição de uma parcela específica, haverá o checkbox "Gerar NFS-e ao quitar esta parcela" para permitir o ajuste fino (ex: o cliente quer NF de todas as parcelas, exceto de uma específica).
- Desmarcada: Indica que não irá gerar (Não).
- Marcada: Indica que a parcela está configurada para gerar a nota (Sim).
Plano Contrato → Aba Financeiro → Parcelamento do Curso (Grid do Contrato)
- Nova Coluna: NFS-e Aut.
- Componente Visual: Uma Checkbox na linha da Parcelamento de Curso.
- Comportamento: Apenas visualização para conferência rápida.
3. Matriz de Prioridade (Hierarquia do Sistema)
Para evitar bugs de escopo, a regra de prioridade segue estritamente a ordem abaixo:
Plano de Contas (Disponibiliza) → Dados do Plano (Propaga) → Parcela (Decide o Comportamento Final)
- Se o Plano de Contas estiver como Não permitir, o recurso deixa de existir para as parcelas.
2. Se o Plano de Contas liberar, a Parcela individual é quem dita o comportamento final no momento do gatilho.
4. O Gatilho de Emissão (Regra Principal)
A geração da NFS-e acontece exclusivamente por processo em background (assíncrono) quando o status da parcela transaciona para Quitada.
🟢 Condições Obrigatórias para Disparo:
- A situação da parcela mudou para Quitada.
- A parcela específica está configurada com Gerar NFS-e = Sim.
- O plano de contas do item permanece ativo para ISS e automação.
- Não existe nenhuma NFS-e previamente vinculada/emitida para esta parcela (Evita duplicidade).
🔴 O Gatilho NÃO deve ser disparado se:
- O plano for criado, editado ou salvo (sem quitação).
- A parcela for alterada para as situações: Cancelada, Negativada ou Estornada.
- Tratamento de Exceções e Logs
- Legado / Planos Existentes: Se o usuário ativar a automação em um plano que já possui parcelas pagas, a regra só se aplica às parcelas em aberto. As parcelas já quitadas permanecem inalteradas para evitar emissões retroativas indevidas.
- Rastreabilidade (Logs): Após o disparo com sucesso, gravar no log da nota:
- "NFS-e gerada automaticamente na quitação da parcela XYZ pelo usuário [Nome/Sistema]."
- Controle de Falhas (Instabilidade da Prefeitura): Caso o serviço da prefeitura falhe ou rejeite a nota, o sistema deve:
- Registrar o status de tentativa com o erro retornado.
- Exibir o log de erro detalhado para o usuário.
- Permitir o reprocessamento manual (reutilizando o fluxo já existente hoje no sistema).
Ainda não utiliza a emissão de NFS-e pelo Sponte?
Com essa solução, sua instituição pode emitir notas fiscais diretamente pelo Sponte e aproveitar recursos como a emissão automática de NFS-e na quitação das parcelas, reduzindo tarefas manuais e trazendo mais agilidade para a rotina.