Central de Ajuda Quaza Provedores

NFSe Brasil — Nota Fiscal de Serviço (foco no padrão Nacional unificado + providers legados)

Esta wiki cobre o módulo NFSe do Quaza ponta a ponta: o que é, por que o padrão Nacional unificou (e quase aposentou) os webservices municipais, como o Quaza monta o DPS, transmite para o SEFIN Nacional, recebe protocolo e gera DANFSE; quais ações você executa em cada nota, como cancelar, como ler erros. Audiência: equipe fiscal e operadores de provedores de internet que faturam serviços (instalação, suporte, mensalidade quando enquadrada como ISS, etc.).

Por que o Padrão Nacional existe

Até 2023, o ISS (Imposto Sobre Serviços) era recolhido prefeitura a prefeitura, e cada prefeitura definia seu próprio padrão de NFSe: webservice diferente, leiaute XML diferente, endpoint diferente, credencial diferente. Isso significou que sistemas como o Quaza precisaram integrar com dezenas de "providers" (Tecnospeed, Ginfes, Issnet, Tinus, Govdigital, Megasoft, Sigiss, ABRASF v1, ABRASF v2…) para conseguir cobrir municípios diferentes.

A Lei Complementar 157/2016 e o Convênio NFS-e (ENAT 2022) instituíram o Padrão Nacional da NFS-e, com servidor único da Receita Federal — o SEFIN Nacional — e portal de consulta unificado — o ADN (Ambiente de Dados Nacional). Desde 2024 a adesão das prefeituras é progressiva: hoje a maioria das capitais e grandes cidades já está no Padrão Nacional, e os municípios pequenos vão migrando ao longo de 2025-2026.

Os 4 providers que o Quaza suporta

Fluxo geral — do espelho ao DANFSE

Glossário

Configuração — pré-requisitos

Antes de emitir a primeira NFSe você precisa configurar a Empresa NFSe Config. É lá que o Quaza decide qual provider usar, qual versão do schema, ambiente, certificado, etc.

Tela de NFSe — listagem e detalhe

O módulo NFSe tem duas telas que trabalham juntas: uma listagem com todas as notas (filtráveis por situação/competência/cliente/município) e um formulário de detalhe de cada nota individual. Você navega da listagem pro detalhe clicando no ícone da 1ª coluna; volta pelo botão "Voltar" do navegador.

Listagem

Lista todas as NFSe (criadas, transmitidas, protocoladas, rejeitadas, canceladas) com filtros por período, situação, cliente, provider, ambiente.

Listagem de NFSe — a coluna marcada em vermelho tem o ícone de editar (lápis): clica nele pra abrir o detalhe da nota. A coluna anterior, da impressora, baixa o DANFSE direto.

Detalhe / formulário

É onde você confere/edita os dados antes de transmitir, e de onde dispara todas as ações (transmitir, cancelar, consultar, obter DANFSE, obter XML, etc).

Formulário de edição da NFSe — cabeçalho, itens (serviços), totalizadores, retenção, descrição.

Estados da nota e transições

Anatomia do DPS (Padrão Nacional)

O DPS é o XML que o Quaza envia ao SEFIN. Versão atual v1.01, namespace http://www.sped.fazenda.gov.br/nfse. Schema em br/fiscal/modelos/nfse/xml/schemas/nacional/DPS_v1.01.xsd. Conhecer a estrutura ajuda a entender erros de rejeição.

<DPS xmlns="http://www.sped.fazenda.gov.br/nfse" Id="DPS3543..." versao="1.01">
<infDPS Id="DPS3543..." versao="1.01">
<tpAmb>1</tpAmb>                       # 1=Producao, 2=Homologacao
<dhEmi>2026-05-12T10:00:00-03:00</dhEmi>
<verAplic>Quaza1.0</verAplic>
<serie>1</serie>
<nDPS>12345</nDPS>                       # numero sequencial
<dCompet>2026-05-12</dCompet>             # competencia (data do servico)
<tpEmit>1</tpEmit>                       # 1=Prestador, 2=Tomador, 3=Intermediario
<cLocEmi>4310902</cLocEmi>               # codigo IBGE do municipio emitente
<prest>                                 # PRESTADOR (sua empresa)
<CNPJ>12345678000100</CNPJ>
<IM>123456</IM>                       # inscricao municipal
<xNome>Empresa Exemplo LTDA</xNome>
<enderNac>...</enderNac>
<regTrib>                              # regime tributario
<opSimpNac>1</opSimpNac>          # 1=optante Simples, 2=nao optante
<regApTribISSQN>0</regApTribISSQN>
</regTrib>
</prest>
<toma>                                  # TOMADOR (cliente)
<CPF>12345678901</CPF>
<xNome>Cliente Exemplo</xNome>
<enderNac>...</enderNac>
</toma>
<serv>                                  # SERVICO prestado
<cServ>
<cTribNac>0107</cTribNac>          # codigo LC 116/2003 (sub-item 1.07)
<cTribMun>010701</cTribMun>        # codigo tributacao municipal (se exigido)
<CNAE>6201500</CNAE>
<xDescServ>Instalacao de internet residencial</xDescServ>
</cServ>
<locPrest>                           # local da prestacao
<cLocPrestacao>4310902</cLocPrestacao>
</locPrest>
<valores>
<vServPrest>
<vServ>100.00</vServ>          # valor bruto
</vServPrest>
<trib>
<tribMun>
<tribISSQN>1</tribISSQN>
<pAliq>5.00</pAliq>        # aliquota ISS
<tpRetISSQN>1</tpRetISSQN>  # 1=nao retido, 2=retido
</tribMun>
</trib>
</valores>
</serv>
</infDPS>
<Signature>...</Signature>                  # assinatura digital com certificado A1
</DPS>

Tela de adicionar/editar — barra de ações

A tela de edição da NFSe mostra um painel lateral fixo à direita com os botões de ação contextual — o que internamente o Quaza chama de caixa-maneira, mesma barra que aparece em NFCom , NFe e NFCe.

Barra caixa-maneira em NFSe Protocolada — botões visíveis numerados. Os botões 2 (Transmitir) e 3 (Gerar) só aparecem em outras situações; veja a tabela abaixo.

Botões visíveis em uma NFSe Protocolada

O print acima é de uma NFSe na situação Protocolada — a barra mostra 5 botões. Outras situações (Criada, Transmitida, Rejeitada) revelam botões diferentes (Transmitir, Consultar) e escondem os que dependem de ter autorização (Imprimir DANFE, Cancelar).

DANFSE — o PDF

O DANFSE (Documento Auxiliar da NFSe) é o PDF gerado pelo ADN da Receita Federal (não pelo Quaza) após autorização. Não é a nota fiscal — a nota fiscal é o XML. O DANFSE é só uma representação visual com QR Code que permite consultar o XML no portal nacional.

Cancelamento e eventos

Padrão Nacional — Cancelamento via evento 101101

NFSe Protocolada pode ser cancelada via evento. O Quaza envia um XML separado (não outra NFSe) com tipo 101101. Sem restrição de prazo no Padrão Nacional — diferente do que era no legado.

Legados (Tecnospeed/Tecnos/Abase) — Cancelamento restrito

Endpoints SEFIN e ADN

Para o Padrão Nacional, o Quaza usa dois servidores distintos da Receita Federal:

Você não configura URL — só configura ambienteNfse (1=produção, 2=homologação) na Empresa NFSe Config; o Quaza decide o endpoint automaticamente.

Tributos calculados

De onde vêm os dados

Como ler erros e debugar

Onde achar a mensagem de erro

1. Abra a NFSe rejeitada (situação 4).
2. Aba "Retorno SEFIN" mostra a resposta JSON do servidor (registrada em nfseProtocolo.mensagem).
3. Botão "Ver XML / DPS" mostra o DPS enviado — confira o campo apontado pelo erro.

Códigos de erro mais comuns

Pegadinhas frequentes

FAQ

Quem é obrigado a emitir NFSe?

Toda empresa que presta serviços é obrigada a emitir NFSe pela prefeitura onde está sediada (regra geral) ou onde o serviço é prestado (alguns serviços específicos). Provedores de internet emitem NFSe principalmente para instalação, suporte técnico, manutenção, configuração e outros serviços avulsos.

NFSe Nacional substitui completamente os webservices municipais?

Em transição. A intenção é que sim, mas a adesão é progressiva. Quando uma prefeitura adere, ela passa a aceitar APENAS o Padrão Nacional naquele município — não dá pra emitir nos dois formatos simultaneamente para uma mesma cidade.

Como sei se minha prefeitura já aderiu?

Consulte a lista oficial em www.gov.br/nfse ou pergunte ao seu contador. Quaza não tem listagem interna — você precisa olhar lá fora e configurar a Empresa NFSe Config conforme.

Mensalidade de internet é serviço (NFSe) ou comunicação (NFCom)?

Comunicação. Internet residencial/empresarial é serviço de telecomunicação → emite NFCom (modelo 62) . NFSe é para serviços que não são comunicação: instalação, suporte técnico, manutenção, treinamento, consultoria.

Cliente perdeu o e-mail com a NFSe — como reenvio?

Abra a NFSe e clique Enviar e-mail de novo. Vai usar o template NFSE_ENVIO e enviar pro endereço atual do cliente.

NFSe rejeitada por código de serviço errado — o que faço?

Verifique o codServico do Produto fiscal NFSe. Confronte com a Lista LC 116/2003 — cada item tem código (ex: 1.07 = "suporte técnico em informática"). Corrija o cadastro do produto e re-transmita.

Cancelei depois do mês (provider legado) — e agora?

No legado, não cancela. Opções: emitir NFSe de substituição/complemento (se a prefeitura permite), abrir processo administrativo na prefeitura ou ajustar competência seguinte com compensação. Padrão Nacional não tem essa restrição.

Empresa optante do Simples Nacional emite NFSe?

Sim, mas o ISS não é destacado no XML — sai pelo DAS. Configure opSimpNac=1 na Empresa NFSe Config. A alíquota efetiva é a do anexo do Simples (não a alíquota municipal cheia).

Posso emitir NFSe de teste antes de virar produção?

Sim — configure o ambiente da Empresa NFSe Config como Homologação (2). Notas em homologação não têm valor fiscal, mas todo o fluxo (DPS, assinatura, transmissão, DANFSE) funciona idêntico.

NFSe não é prestada na sede — onde recolhe o ISS?

Depende do tipo de serviço. Regra geral: ISS recolhido na sede do prestador. Exceções: alguns serviços (construção civil, vigilância, segurança, transporte municipal) recolhem onde o serviço é prestado. O Quaza preenche cLocPrestacao conforme você configurar no produto — confirme com contador para serviços específicos.

Documentos relacionados