Módulo NFS-e

O que é o módulo NFS-e

O módulo NFS-e (Nota Fiscal de Serviços Eletrônica) é responsável pela emissão, cancelamento e acompanhamento das notas fiscais de serviços junto às prefeituras municipais. Diferente da NF-e e NFC-e (que são federais, SEFAZ), a NFS-e é municipal — cada prefeitura tem seu próprio padrão e seu próprio provedor de webservice.

O Bunto ERP suporta os principais padrões do mercado (ABRASF, padrão próprio das prefeituras e o Padrão Nacional da Reforma Tributária) e integra com provedores como Betha e Ginfes.

Como acessar

No menu lateral, acesse Serviços → Notas de Serviço. A rota é /notas-servicos.

Rotas disponíveis:

• /notas-servicos — listagem.
• /notas-servicos/cadastrar — nova NFS-e.
• /notas-servicos/editar/[id] — edição de rascunho ou rejeitada.
• /notas-servicos/visualizar/[id] — modo leitura.
• /notas-servicos/configuracoes — configurações do módulo.

Listagem

A listagem traz o RPS (Recibo Provisório de Serviços — série e número internos), o número da NFS-e autorizada pela prefeitura, o cliente/tomador, a descrição do serviço, o valor, o status e um indicador de integração com o financeiro.

Status

• Pendente — rascunho, ainda não enviado.
• Processando — task em execução na prefeitura.
• Emitida — autorizada, com número e código de verificação.
• Rejeitada — recusada pela prefeitura, precisa de correção.
• Cancelada.

Filtros e busca

• Abas por status (Todas, Pendentes, Emitidas, Rejeitadas, Canceladas).
• Busca por cliente, descrição do serviço ou número.
• Badge C quando as contas já foram lançadas no financeiro.

Menu de contexto

• Visualizar.
• Editar — apenas em Pendente ou Rejeitada.
• Clonar — cria um novo RPS copiando os dados.
• Emitir — abre um painel com acompanhamento em tempo real do envio à prefeitura (validação, assinatura, conexão, envio, resposta).
• Cancelar NFS-e — apenas em Emitida, com motivo obrigatório.
• Lançar em contas / Estornar.
• Baixar XML e Baixar PDF — apenas em Emitida.
• Excluir — apenas Pendentes e Rejeitadas.

Formulário

Geral

Série e número do RPS, cliente (tomador), vendedor e comissão.

Serviço

Descrição detalhada, valor, código tributário municipal, CNAE, NBS e local da prestação (município e UF).

Impostos

ISS (retido ou não), IR, INSS, PIS, COFINS e CSLL, com alíquotas dinâmicas de acordo com o regime e a configuração.

Adicionais

Quando a prefeitura exige, aba para dados de construção civil (obra, responsável técnico, CEI) e campos de IBS e CBS (RTC). Marcadores e observações gerais.

Pagamento

Condição de pagamento, parcelas, forma de recebimento e dados do gateway quando aplicável.

Emissão assíncrona e acompanhamento

A emissão da NFS-e é executada em uma tarefa Celery porque depende do webservice da prefeitura, que costuma ter latência variável. Ao clicar em Emitir, o drawer mostra o progresso em tempo real com etapas: validando dados, assinando, conectando, enviando RPS, aguardando retorno e salvando número e código de verificação.

Em caso de falha, a task faz até 3 tentativas automáticas antes de marcar como Rejeitada.

Configurações

Acesse Serviços → Notas de Serviço → botão de configurações. Os principais blocos:

Ambiente e provedor

• Ambiente — Produção ou Homologação.
• Padrão/Provedor — ABRASF, próprio da prefeitura, padrão nacional, Betha, Ginfes etc.
• Modalidade de emissão.

Série e defaults

• Série padrão do RPS.
• Código tributário municipal padrão, CNAE e NBS.

Tributação

• Alíquotas padrão de ISS, IR, INSS, PIS, COFINS e CSLL.
• ISS retido e descontar IR automaticamente.
• Zerar ISS sem retenção.
• Regime Simples Nacional com opção de alíquota.
• Regime especial e tipo de imunidade quando aplicável.

Contabilista

Nome, CPF, CRC, CNPJ, endereço e telefone — obrigatórios em alguns municípios.

Operação

• Emitir no padrão nacional.
• E-mail de cópia.
• Observação padrão.
• Integração com ordem de serviço.

Certificado digital

O certificado é compartilhado com o módulo NF — mesma assinatura A1.

Integrações com outros módulos

Clientes

O tomador vem do cadastro de clientes com todos os dados preenchidos automaticamente.

Finanças

O lançamento de contas cria parcelas no financeiro conforme a condição de pagamento. Categoria, forma de recebimento, conta bancária e gateway são configurados no formulário.

Vendedores

O vendedor responsável é selecionado entre os usuários — base para comissões e relatórios.

Ordem de serviço

Quando o módulo de serviços está em uso, a NFS-e pode ser gerada a partir de uma ordem concluída, puxando itens e valores.

NF-e

O certificado digital e a estrutura de assinatura são compartilhados com o módulo NF — você não precisa cadastrar o certificado duas vezes.

Permissões

• Visualizar NFS-e.
• Criar, editar e excluir.
• Emitir NFS-e.
• Cancelar NFS-e.
• Baixar XML e PDF.

Perguntas frequentes

Por que a emissão é assíncrona?

Prefeituras costumam ter webservices lentos, instáveis e com formatos próprios. Ao executar em segundo plano, o ERP não trava e consegue tentar novamente em caso de falha.

Minha prefeitura não está na lista — o que fazer?

O Bunto suporta o padrão nacional (obrigatório a partir da Reforma Tributária) e os padrões ABRASF. A maior parte das prefeituras se enquadra num desses. Em casos muito específicos, é possível desenvolver um provedor dedicado.

Como corrigir uma NFS-e autorizada?

Não existe carta de correção para NFS-e. Se houver erro, cancele a nota e emita uma nova (dentro da janela permitida pela prefeitura).

Posso parcelar a NFS-e?

Sim. A condição de pagamento define as parcelas, e o lançamento em contas cria cada parcela como um título a receber.

O PDF vem do ERP ou da prefeitura?

Depende do provedor. Alguns devolvem o PDF oficial; outros devolvem apenas número e código de verificação, e o ERP gera o PDF a partir dos dados da nota.