Emitir NFS-e

Para que serve

Nesta tela você emite uma NFS-e para um cliente do escritório. O sistema monta a DPS, assina com o certificado digital A1 do cliente e envia para a Sefin Nacional. Se tudo estiver certo, a nota volta autorizada, com chave de acesso.

Há duas formas de emitir, em abas no topo do formulário:

• Tomador + serviço + valor: a forma simples. Você escolhe o tomador da agenda, o serviço do catálogo e o valor. O motor de tributação calcula ISS, retenções e IBS/CBS e mostra de onde veio cada número.
• Modo avançado (DPS completa): você preenche todos os campos da DPS à mão (códigos, alíquotas, retenções, IBS/CBS). Serve para casos fora do padrão, como tomador que não está na agenda.

Para abrir esta tela, clique no botão Emitir e escolha NFS-e (ou use + Emitir na lista de NFS-e). Quem não tem permissão de emitir notas não vê essas opções.

Antes de começar

• O cliente precisa estar pronto para emitir: certificado A1 válido, dados da Receita, município e numeração em ordem. Se faltar algo, aparece no topo o quadro vermelho "Este cliente ainda não está pronto para emitir", com o que falta e um link para corrigir. Veja pronto para emitir.
• Cliente do Lucro Presumido ou Lucro Real em município que não usa o emissor Nacional: na primeira emissão aparece a janela Este município pode recusar a nota. Veja a seção "Município sem Emissor Nacional", logo abaixo.
• A série da DPS vai de 1 a 49999. O leiaute da NFS-e muda sozinho: as notas emitidas a partir de 01/12/2026 seguem a NT 009, sem nenhuma ação sua.
• Para a forma simples, o tomador precisa estar cadastrado em Tomadores e o serviço no catálogo de Serviços.

Município sem Emissor Nacional

Para clientes do Lucro Presumido ou Lucro Real em município que mantém sistema próprio ou não habilitou o prestador, a Sefin Nacional pode recusar a nota (E0016 ou E0084). O sistema não bloqueia: antes de emitir, a janela Este município pode recusar a nota mostra o município, o regime, a fonte da informação e o risco. Confirmo, emitir assim mesmo registra a confirmação do cliente e segue; as próximas notas não pedem de novo, enquanto o município e a situação dele não mudarem. Nada é criado nem numerado até você decidir. MEI e Simples Nacional nunca veem esse aviso. Veja NFS-e: quem pode emitir pelo sistema.

Homologação ou produção

O ambiente não é escolhido nesta tela: ele vem do cadastro do cliente (campo Ambiente, em editar cliente).

• Homologação (no detalhe da nota aparece como "Produção restrita (teste)"): a nota passa pelas validações oficiais, mas não tem valor fiscal. Use para testar. Se ali toda nota volta com a rejeição E0084, o CNPJ não está habilitado no cadastro de contribuintes próprio da Produção Restrita: o cliente pede a habilitação à prefeitura. Veja E0084 em homologação.
• Produção: a nota vale como documento fiscal e só pode ser desfeita por cancelamento ou substituição.

Confira o ambiente do cliente antes da primeira emissão de verdade. Veja Editar cliente.

Passo a passo

Escolher quem emite ("Emitindo por")

1. No topo do formulário aparece Emitindo por com a razão social e o CNPJ/CPF do cliente emitente.
2. Para emitir por outro cliente, clique em trocar (ou use o atalho Ctrl+K, ou ⌘+K no Mac) e busque o cliente. O botão só aparece se você tiver acesso a mais de um cliente.
3. Ao trocar de cliente, o formulário recarrega o catálogo e limpa o tomador escolhido.

Forma simples: tomador + serviço + valor

1. Deixe selecionada a aba Tomador + serviço + valor.
2. Em Tomador, digite parte do nome ou do CPF/CNPJ e clique no tomador na lista. A busca é só na agenda do cliente. Depois de escolhido, se o tomador retém tributos, aparece ao lado "retém federais", "substituto do ISS" ou um selo com a exigência cadastrada. Para mudar, clique em trocar. Em tomador pessoa jurídica, o atalho Este tomador retém impostos? (para quem pode alterar cadastros) abre a janela para gravar o que ele retém, em todos os serviços ou só neste. Veja Retenções exigidas pelo tomador.
3. Em Serviço, busque por descrição, código ou código nacional e clique no serviço. Se o serviço tem valor padrão, ele preenche o valor.
4. Informe o Valor R$ (ex.: 1.500,00). Pode deixar em branco se o serviço tem valor padrão.
5. Confira a Competência (vem com a data de hoje, no horário de Brasília). Se houver desconto que não depende de condição, informe o Desconto incondicionado R$: o ISS, o PIS/COFINS, as retenções e o IBS/CBS são calculados sobre o valor menos o desconto (por exemplo, 1.000,00 com desconto de 100,00 e ISS de 5% dá base de 900,00 e ISS de 45,00). Desconto igual ou maior que o valor é pendência. Se o serviço retém INSS, aparece também Materiais/equipamentos (INSS) R$, para o valor discriminado na nota sair da base.
6. Se quiser, preencha Descrição (aceita {competencia}, {mes} e {ano}) e Referência externa.
7. Espere o cálculo: logo abaixo aparece uma linha de resumo, por exemplo "ISS 37,50 · PIS 4,88 · COFINS 22,50 · IBS 0,69 · CBS 6,17 — líquido 738,75".
8. Clique em Ver detalhes para ver cada campo calculado e a origem de cada valor (veja abaixo).
9. Se aparecer o quadro "Resolva antes de emitir", corrija o que ele pede. Enquanto houver pendência, o botão fica desativado.
10. Clique em Emitir NFS-e.

O cálculo é feito pelo servidor, com as mesmas regras que serão usadas na emissão. Ele refaz sozinho a cada mudança de tomador, serviço, valor, competência, descrição ou ajuste. Os valores em reais são arredondados em 2 casas pelo arredondamento bancário (o meio exato vai para o par: 10,005 vira 10,00 e 10,015 vira 10,02), como pede a norma técnica da NFS-e Nacional.

Modo avançado: DPS completa

1. Clique na aba Modo avançado (DPS completa).
2. Preencha Série, Competência e, se quiser, Referência externa (opcional).
3. Em Serviço (tributação), escolha um Serviço do catálogo para preencher os códigos, a descrição e o primeiro item, ou deixe "— preencher manualmente —" e digite o Código de tributação nacional.
4. Em Tomador, busque um Tomador cadastrado ou preencha os dados à mão. Com CNPJ, a tela busca os dados na Receita e preenche. Marque Salvar este tomador na agenda se quiser guardá-lo depois da emissão.
5. Em Serviços, preencha NBS, descrição, quantidade, valor unitário e ISS %. O V. Total é calculado sozinho. Use + Item para mais linhas.
6. Em Tributação, confira a exigibilidade do ISS, a classificação IBS/CBS e, se for o caso, marque Declarar o grupo IBS/CBS na nota (reforma tributária).
7. Se houver retenções ou dedução, abra Retenções federais e dedução (clique em "mostrar").
8. Confira o quadro Resumo (calculado automaticamente).
9. Clique em Validar sem emitir para conferir tudo sem enviar (veja abaixo).
10. Clique em Emitir NFS-e.

Emitir a partir de um pedido ou de uma duplicação

• Ao clicar em Emitir num pedido de nota, a tela abre já preenchida com tomador, serviço, valor, descrição e competência do pedido, e mostra "Emitindo o pedido de nota de…". O emitente é o cliente do pedido ("Emitente definido pelo pedido"). Trocar o emitente pede confirmação e desfaz o vínculo com o pedido. Veja Pedidos de nota.
• Ao clicar em Duplicar no detalhe de uma nota, a tela abre com os dados dela e a competência de hoje. Se a nota original foi emitida pela forma simples, o motor recalcula com as regras de hoje e mostra o que mudou (por exemplo "ISS: R$ 37,50 → R$ 45,00"). Veja Detalhe da nota.

O que o motor preenche e de onde vem cada valor

Na forma simples, o motor junta o regime do cliente na competência, o serviço, o tomador, a regra serviço × tomador (se houver), o município e a lei. Ele preenche, entre outros:

• regime do prestador e município de incidência do ISS;
• Alíquota do ISS e se o ISS é retido pelo tomador (ISS retido);
• PIS e COFINS pelo regime;
• Retenções federais: IRRF, CSRF e INSS retido, respeitando as dispensas de valores pequenos;
• IBS e CBS do ano da competência (pela calculadora oficial quando ela está ligada para a conta) e o cClassTrib;
• tributos aproximados da lei 12.741 (pela tabela IBPT, quando importada e vigente).

Quando dois cadastros trazem o mesmo dado, vale, campo a campo, nesta ordem: o que foi informado na nota (ou ajustado na tela) > a regra serviço × tomador > a exigência do tomador > o serviço > o tomador > o cliente/regime > o município ou a lei.

Em Ver detalhes, cada linha tem uma etiqueta de origem do valor (o selo de onde veio o valor). Passe o mouse sobre ela para ver o fundamento (lei, base × alíquota, valor anterior, motivo).

Ajustar um valor calculado

1. Em Ver detalhes, clique em ajustar na linha (só linhas ajustáveis, como alíquotas, PIS, COFINS, retenções e cClassTrib).
2. Digite o novo valor. A etiqueta muda para Ajustado.
3. Se o ajuste diminui uma retenção, informe o Motivo (obrigatório ao reduzir retenção). Sem motivo, o botão de emitir fica bloqueado.
4. Para desfazer, clique em voltar ao calculado.

Avisos do cálculo

Abaixo do resumo podem aparecer avisos (⚠). Eles não bloqueiam a emissão, mas leia antes de emitir. Exemplo: se o cliente emitente é MEI ou pessoa física (CPF) e há retenções federais (IRRF, INSS, PIS/COFINS/CSLL) informadas, elas são ignoradas — a nota desse emitente não leva tributos federais — e o aviso diz o que ficou de fora. Combine com o tomador.

Avisos que você pode encontrar:

• Retenção sugerida e não configurada: para tomador pessoa jurídica e serviços que costumam ter retenção de IRRF e CSRF (lista do RIR/2018, art. 714), o aviso mostra os valores sugeridos. Aplicar sugestão nesta nota vale só para a nota; Salvar como regra deste tomador grava a regra para as próximas; Manter sem retenção esconde o aviso. O cadastro do serviço não é alterado.
• Simples sem percentual da Lei 12.741: o cliente do Simples está sem o percentual aproximado de tributos no perfil fiscal. A nota sai com os tributos aproximados zerados; informe o percentual (use a calculadora de alíquota efetiva no detalhe do cliente).
• Regime especial do ISS: com o regime especial no perfil fiscal (sociedade de profissionais, autônomo, estimativa etc.), a nota sai sem alíquota, base e valor de ISS e sem ISS retido. O ISS é apurado pelo município e o sistema não calcula esse valor. Alíquota, retenção de ISS ou dedução informadas na nota viram pendência.
• PIS/COFINS cumulativo sugerido: no Lucro Real, serviços de informática (1.01 a 1.08) costumam ser cumulativos. A nota não muda sozinha; defina o regime de PIS/COFINS no cadastro do serviço.
• Exigência do tomador ignorada: se o prestador é do Simples ou MEI, o tomador é pessoa física ou o emitente é MEI/CPF, a exigência do tomador não é aplicada e o aviso explica por quê.
• INSS pela CPRB: cliente optante pela CPRB tem INSS retido de 3,5% até 31/12/2027; depois volta a 11%, com aviso.

Depois de gravar uma retenção, a tela mostra o efeito no valor líquido. Em Ver detalhes, a linha Retenção aplicada por diz se a retenção veio de uma regra do par ou da exigência do tomador, com o link ver regra.

Aviso de interpretação fiscal em revisão

Se aparecer "Usa interpretações fiscais ainda em revisão — confira os valores.", o motor usou uma premissa fiscal marcada "a confirmar". A nota pode ser emitida, mas confira os valores. Em 23/10/2026 a maioria das premissas foi revisada e não gera mais o aviso. Veja Premissas fiscais.

Validar antes de emitir

No modo avançado, Validar sem emitir confere a DPS inteira sem enviar e sem gastar número:

• Se estiver tudo certo, aparece "✓ DPS válida — número previsto…".
• Se não, aparece "A DPS tem N problema(s)", agrupados em etapas: Estrutura dos dados, Coerência dos valores, Cliente emitente, Geração do XML e Validação no XSD oficial.
• Use Ver XML e Copiar para ver o XML que seria enviado.

Na forma simples, a validação acontece sozinha a cada mudança: o resumo, os avisos e as pendências já são o resultado dela.

Quem integra pela API faz a mesma validação em POST /clientes/{id}/nfse/validar. Veja a documentação da API.

O que acontece depois de enviar

• Autorizada: a tela abre o detalhe da nota, com número, chave de acesso, XML e DANFSe.
• Processando: se a Sefin demorar a responder, a nota segue em processamento e você volta para a lista de NFS-e. Ela aparece na lista quando for autorizada.
• Rejeitada: a rejeição não vira nota. A mensagem aparece no fim do formulário, com o código (ex.: E0084). Nos dois modos (por cadastros e avançado) aparece também o quadro com o título do problema, quem resolve ("Você resolve", "Depende da prefeitura/Receita"…), os passos e, às vezes, um botão para a tela onde se corrige. Corrija e emita de novo.

Clicar duas vezes em Emitir NFS-e não gera duas notas: cada envio leva uma chave que impede duplicidade (pela API, o cabeçalho Idempotency-Key). A numeração da DPS é reservada pelo sistema.

Campos

Forma simples

Modo avançado

Erros comuns e como resolver

• "Este cliente ainda não está pronto para emitir": siga os itens do quadro (certificado, inscrição municipal, numeração…). Veja Certificado digital A1.
• "Tomador fora da agenda": cadastre o tomador em Tomadores ou use o modo avançado.
• Botão Emitir desativado na forma simples: há pendência ("Resolva antes de emitir"), cálculo em andamento ou ajuste que reduz retenção sem motivo.
• Pendência de alíquota do ISS: o serviço não tem alíquota e o município não informou uma. Use o link corrigir o serviço e informe a alíquota no catálogo. Veja Serviços.
• "Corrija os campos destacados" (modo avançado): algum número está em formato inválido ou é obrigatório. O campo com erro fica marcado.
• Itens com NBS ou alíquota diferentes: emita notas separadas.
• Rejeição da Sefin (código E seguido de 4 números): veja Como resolver rejeições.
• "Desconto incondicionado igual ou maior que o valor do serviço": reduza o desconto.
• Pendência de regime especial (alíquota, ISS retido ou dedução informados na nota): retire o campo. Com regime especial do ISS a Sefin recusa esses campos (E0604, E0588, E0438).
• "Franquia do plano ... atingida ... ative o excedente ... ou troque de plano em Plano e uso": as notas do mês chegaram à franquia do plano e o excedente está desativado (padrão). Nenhuma nota é emitida. Quem pode ver o plano tem no aviso o link Ativar excedente ou trocar de plano: um Dono ou Administrador ativa o excedente (cada nota a mais é cobrada pelo preço do plano) ou troca de plano. Em plano sem excedente, a mensagem é "Limite do plano ... atingido" e o link é Ver planos. Vale também para lote, emissão automática e "emitir quando pagar". Veja Plano e uso e o erro.
• "O período de teste terminou — escolha um plano para continuar emitindo": o teste grátis acabou. Escolha um plano em Plano e uso. Veja o erro.

Veja também

• Notas emitidas
• Detalhe da nota
• Emissão em lote
• Motor de tributação
• Retenções exigidas pelo tomador
• Tributação municipal
• Como começar a emitir
• Documentação técnica oficial da NFS-e