Erros comuns ao emitir NFS-e e como resolver
Configurações e Integrações — atualizado em 31/10/2026
A emissão passa pelo Emissor Nacional de NFS-e, e a maior parte das falhas vem de um dado de configuração. Veja os casos mais comuns.
"Configure a emissão de NFS-e"
Por quê: falta configuração.
Como resolver: abra Configurações → Tributação e notas fiscais e preencha CNPJ, razão social, código IBGE do município, certificado digital com senha, regime tributário, alíquota de ISS e o código de tributação nacional.
Erro no certificado digital
Por quê: a senha está errada, o arquivo não é .pfx/.p12 ou o certificado venceu.
Como resolver: envie o arquivo novamente, confira a senha e verifique a validade. Certificado A1 vale 1 ano — vencido, nenhuma nota é emitida.
CNPJ inválido ou não encontrado
Por quê: o número está incorreto ou não confere com o certificado.
Como resolver: confira o CNPJ em Minha conta e em Configurações → Tributação e notas fiscais. Ele precisa ser o mesmo do certificado digital.
⚠️ Se você precisa trocar o CNPJ do titular, fale com o suporte. A troca tem um procedimento próprio, e alterar o campo direto não funciona.
Inscrição municipal inválida
Por quê: o número não corresponde ao cadastro na prefeitura, ou foi preenchido quando não deveria.
Como resolver: confirme com o seu contador ou no portal da prefeitura. A própria tela de configuração explica quando o campo deve ser preenchido e quando pode ficar em branco.
Código de tributação recusado
Por quê: o código informado não é aceito para a sua atividade ou município.
Como resolver: em Configurações → Tributação e notas fiscais, revise o Código de tributação nacional (CTN) — a tela lista os códigos mais usados por fotógrafos. Só preencha o código de tributação municipal se o portal da prefeitura exigir explicitamente.
Alíquota de ISS incorreta
Por quê: a alíquota varia por município, normalmente entre 2% e 5%.
Como resolver: confirme a alíquota da sua cidade com o contador e ajuste na configuração.
A nota saiu com status "Com erro"
Na página Notas fiscais, o filtro Com erro reúne as tentativas que falharam. Abrindo o registro, você vê a mensagem devolvida pelo Emissor Nacional — normalmente ela aponta o campo exato do problema.
Antes de tudo: teste em Homologação
Em Configurações → Tributação e notas fiscais, deixe o Ambiente em Homologação (Teste) e emita uma nota de teste. Erro de código ou de alíquota aparece ali, sem gerar documento fiscal de verdade.
Quando pedir ajuda
Se a mensagem não indicar o campo, acione o suporte informando: a mensagem de erro exata, o nome do cliente, o valor da nota e o município. Com esses dados, a análise é direta.