O sistema passa a suportar NFS-e Multi-Provedor por Empresa, permitindo que cada organização opte de maneira exclusiva entre dois modelos oficiais de emissão de Nota Fiscal de Serviço Eletrônica:
- Provedor 1 — PlugNotas (Parceiro Municipal / TecnoSpeed): Integração municipal terceirizada, indicada para municípios que utilizam provedores municipais tradicionais.
- Provedor 2 — NFS-e Nacional (Federal Direto / Sefin Nacional): Emissão direta da Declaração de Prestação de Serviço (DPS) ao Ambiente de Dados Nacional (Sefin Nacional) via comunicação segura mTLS (com Certificado Digital A1) no leiaute nacional v1.01, com geração local do DANFSe conforme a NT 008.
|
💡 O Conceito Fundamental de "Fotografia da Nota" A troca de provedor nas configurações da empresa tem vigência apenas para novas notas. Ao ser gerada (manualmente ou por contrato), a nota grava permanentemente qual provedor a originou: • Preservação Histórica: Se uma empresa emitia via PlugNotas e migrar para o Federal, todas as notas antigas continuarão sendo consultadas, canceladas, baixadas em XML e impressas em DANFSe através da PlugNotas. • Segurança Operacional: Evita que alterações nos parâmetros da empresa rompam a comunicação ou gerem erros ao gerenciar documentos fiscais emitidos no passado. |
Onde Encontrar no Sistema (Localização e Telas)
|
Módulo / Recurso |
Caminho de Navegação |
Localização |
|
Parametrização da Empresa |
PDVx Office > Configurações > Parâmetros > Aba Fiscal |
Sub-aba NFS-e |
|
Emissão e Acompanhamento de Notas |
PDVx Office > Módulo Vendas > Notas > NFS-e |
Listagem e Nova NFS-e |
|
Controle de Séries e Numeração |
PDVx Office > Configurações > Parâmetros > Aba Fiscal > Séries de Nota |
Modelo 56 (NFS-e) |
Parametrização: O que muda na tela ao selecionar o Provedor Federal?
Ao acessar a aba NFS-e nas configurações fiscais, o usuário encontra o seletor Provedor de NFS-e com comportamentos visuais dinâmicos:
|
Provedor Selecionado |
Comportamento dos Campos na Tela |
Gestão de Certificado e Numeração |
|
PlugNotas (Parceiro Municipal) |
Exibe todos os campos legados de prefeitura: Tipo de Contrato, Receita Bruta, Lei, Data Início, Lote, Número, Série, Ambiente Nacional e Layout. |
O certificado A1 é sincronizado com os servidores da PlugNotas. A numeração é controlada nos campos de RPS da própria tela. |
|
NFS-e Nacional (Federal Direto) |
Oculta automaticamente os campos legados de prefeitura e os campos manuais de Número/Série de RPS. Exibe aviso informativo sobre a conexão direta. |
O certificado A1 é usado estritamente de forma local para assinatura XMLDSIG e autenticação mTLS com a Receita Federal (nada é enviado a terceiros). A numeração e série passam a ser administradas em Séries de Nota. |
Particularidades Técnicas e Validações do Padrão Nacional (Sefin Nacional)
A emissão no padrão federal direto cumpre rigorosamente as exigências do leiaute nacional v1.01:
- Codificação UTF-8 e Assinatura Digital (Prevenção do Erro E1229): A DPS é assinada digitalmente com padrão XMLDSIG enveloped e a declaração de cabeçalho <?xml version="1.0" encoding="UTF-8"?> é preservada. O payload é compactado em GZip e transmitido em Base64 via mTLS.
- Identificação do Emitente e Prestador (E0121 e E0128): Quando o emitente for o próprio prestador (tpEmit = 1), as tags de razão social (xNome) e endereço do prestador são omitidas conforme exigência da SEFIN, que valida esses dados diretamente na base cadastral federal.
- Enquadramento Tributário e Alíquotas (E0712 e E0625): Para prestadores optantes pelo Simples Nacional com ISSQN não retido apurado pelo regime simplificado, o sistema não envia a tag indTotTrib nem a alíquota pAliq, prevenindo rejeições fiscais em municípios conveniados.
- Resposta e Numeração da NFS-e Autorizada: A resposta síncrona devolve a Chave de Acesso Nacional (50 dígitos). O sistema extrai automaticamente do XML autorizado o número oficial da NFS-e (nNFSe) e o protocolo (nDFSe), atualizando o campo nota_numero para exibição imediata no grid.
- DANFSe Nacional (Documento Auxiliar): Devido à suspensão da API externa pela Receita Federal, o sistema gera o DANFSe v2.0 localmente via biblioteca nativa (sped-da), com cabeçalho oficial, chave de acesso legível e QR Code de autenticação.
Fluxo de Cancelamento Multi-Provedor
Ao acionar a opção Cancelar NFS-e na listagem, o sistema identifica automaticamente o provedor de origem da nota selecionada e carrega os motivos de cancelamento específicos para aquele ambiente:
|
Motivos no Provedor 1 (PlugNotas) |
Motivos no Provedor 2 (Sefin Nacional Federal) |
|
• 1 - Erro na nota
|
• 1 - Erro na emissão
|
- No Provedor Federal: O cancelamento transmite um evento assinado diretamente à SEFIN Nacional. Ao ser homologado, o status muda para Cancelada (Cinza) e o DANFSe passa a exibir marca d'água oficial de cancelamento.
- Segurança Operacional: Notas rejeitadas ou denegadas não exibem o botão de cancelamento, pois não geraram documento fiscal definitivo na SEFAZ/SEFIN.
Faturamento Recorrente e Contratos
A integração multi-provedor atua de forma totalmente integrada com o faturamento automático de contratos:
- Emissão Vinculada ao Contrato: As recorrências configuradas para gerar nota fiscal (junto com a fatura ou após o pagamento) emitem a NFS-e utilizando o provedor ativo na empresa no momento do faturamento.
- Prevenção de Duplicidades: A numeração da série 56 é bloqueada sob transação em lote durante o processamento concorrente das cobranças do dia, impedindo que múltiplos contratos recebam a mesma numeração de DPS.
- Envio Automático por E-mail: O envio aguarda a conclusão da autorização no provedor fotografado, anexa o XML oficial e o DANFSe gerado e realiza o disparo ao cliente tomador.
Novo Status de Nota: Status 8 (Nota Denegada)
- Badge Visual: Identificada na listagem pelo badge roxo Nota Denegada (status = 8).
- Filtros da Listagem: O filtro avançado de status da tela de NFS-e conta com a opção explícita Nota Denegada.
- Tratamento Fiscal: Notas denegadas caracterizam irregularidade cadastral/fiscal do prestador ou tomador apontada pelo fisco, mantendo o histórico registrado sem permitir cancelamento.
Perguntas Frequentes (FAQ)
• Se eu alterar o provedor de PlugNotas para NFS-e Nacional, o que acontece com as notas antigas?
Absolutamente nada. Graças ao recurso de fotografia, as notas antigas continuam registradas sob o provedor PlugNotas. Você poderá consultá-las, reimprimir o DANFSe ou cancelá-las normalmente. Apenas as notas criadas após a alteração serão transmitidas à Sefin Nacional.
• O que significa a mensagem: "Documento não está ativo para este emissor. Será necessário ativar nas configurações da empresa"?
Essa mensagem ocorre quando a empresa ainda não concluiu a configuração básica do módulo de NFS-e ou não possui Certificado Digital A1 ativo. Para resolver: 1. Acesse Configurações > Parâmetros > Fiscal > NFS-e; 2. Verifique se o Regime Tributário e o Provedor estão salvos; 3. Na aba Certificado, certifique-se de que há um Certificado Digital A1 válido cadastrado; 4. Em Configurações > Séries de Nota, confirme se a série do modelo 56 está cadastrada.
• Onde consulto o número da NFS-e após a autorização no Ambiente Nacional?
O número oficial gerado pela Receita Federal (nNFSe) é extraído do XML autorizado e gravado diretamente na coluna Número da listagem de NFS-e, permitindo a localização imediata pelo cliente ou pela contabilidade.
• Preciso cadastrar login e senha da prefeitura ao usar o Emissor Nacional?
Não. O Ambiente Nacional da Sefin dispensa login ou senha web de prefeituras municipais. A comunicação é autenticada única e exclusivamente pelo seu Certificado Digital A1 via conexão mTLS.