Para qualquer configuração e emissão de Nota Fiscal de Serviço veja também o artigo Configurar e gerar nota fiscal.
A Nota Fiscal de Serviço Eletrônica (NFS-e) é um documento digital utilizado para registrar a prestação de serviços e o recolhimento do ISS (Imposto Sobre Serviços). A emissão é obrigatória para empresas que prestam serviços a pessoas físicas ou jurídicas, conforme a legislação municipal.
Diferente da NF-e (Nota Fiscal Eletrônica de produtos), a NFS-e é regulada individualmente por cada município, que define as regras, layout do XML, forma de autenticação (certificado digital, login/senha, token), e os sistemas utilizados (como Ginfes, WebISS, Betha, entre outros).
Por isso, é fundamental validar qual é o provedor adotado pelo município onde o serviço será prestado antes de tentar integrar ou emitir notas fiscais, pois erros são frequentes quando essas variáveis não são consideradas.
Sequência e numeração de RPS
Erros relacionados ao número do RPS (Recibo Provisório de Serviços), como numeração fora da sequência, duplicidade ou falta de autorização prévia (AIDF). Esse tipo de erro impede a conversão do RPS em NFS-e e pode variar conforme o provedor utilizado pela prefeitura.
Erros mais comuns
Código/Descrição | Ação recomendada |
| Verificar o número do RPS enviado; pode haver duplicidade |
| Verificar se a data da nota está dentro do mês correto |
| Solicitar requerimento de AIDF (Autorização de Impressão) |
Possíveis causas
RPS enviado fora de ordem RPS já convertido em NFS-e;
Alterações manuais nos pem;
Sequência reiniciada incorretamente;
Falta de solicitação de AIDF junto à prefeitura;
Tentativa de reenvio de uarâmetros de numeração sem reset apropriado.
Como resolver
Confirme a sequência correta do RPS:
Verifique no sistema qual foi o último número utilizado com sucesso.
Use o próximo número válido, respeitando a numeração crescente.
Solicite a faixa de RPS (AIDF):
Acesse o portal da prefeitura/provedor.
Gere uma nova faixa de RPS e atualize no sistema emissor.
Evite reenvios duplicados:
Confirme no portal se a nota já foi gerada.
Se sim, utilize o número seguinte no envio do novo RPS.
Ajuste a data de emissão/competência:
Notas devem ser emitidas no mês correto.
Erros de competência ocorrem quando o mês informado já está encerrado ou incorreto.
Boas práticas
Use numeração automática no sistema emissor.
Mantenha um controle interno da última nota emitida com sucesso.
Evite edições manuais no número do RPS.
Dados do contribuinte
Erros relacionados a informações do prestador ou do tomador de serviços, como inscrição municipal, CNAE (atividade econômica), CPF/CNPJ ou ausência de dados obrigatórios. Esses dados são validados pela prefeitura e precisam estar corretos e atualizados conforme os registros do município.
Erros mais comuns
Código/Descrição | Ação recomendada |
| Verifique se o CNAE informado está compatível com o código de serviço cadastrado. |
| Solicite a inscrição municipal correta e atualize no sistema. |
Possíveis causas
Cadastro incompleto ou incorreto no EVO.
Dados divergentes do que consta na prefeitura;
Falta de correspondência entre CNAE e código de serviço.
Como resolver
Verifique e atualize a Inscrição Municipal
Confirme se a inscrição municipal está correta no EVO.
Atualize conforme os dados cadastrados na prefeitura.
Revise o CNAE (atividade)
O CNAE precisa estar vinculado corretamente a um código de serviço permitido.
Consulte a tabela da prefeitura para saber quais códigos são aceitos.
Cuidado com erros de digitação
Muitos erros ocorrem por inclusão incorreta de números ou letras.
Boas práticas
Valide todos os dados cadastrais antes de emitir a primeira nota.
Mantenha um cadastro mestre atualizado com os dados do contribuinte.
Em caso de dúvida, consulte a prefeitura antes de corrigir dados sensíveis.
Acesso bloqueado
Erros relacionados à suspensão temporária ou bloqueio do acesso ao sistema da prefeitura ou provedor de notas fiscais. Frequentemente associados a tentativas consecutivas de autenticação com falha, instabilidade de login ou problemas de credenciais.
Erros mais comuns
Código/Descrição | Ação recomendada |
| Aguardar o tempo de desbloqueio ou entrar em contato com a prefeitura para liberação |
Possíveis causas
Tentativas repetidas de envio com login, senha ou token incorretos;
Expiração de certificado digital;
Mudança de credenciais sem atualização no sistema;
Medidas de segurança automática do sistema da prefeitura.
Como resolver
Aguarde o período de desbloqueio automático
Alguns portais desbloqueiam o acesso em 15 a 60 minutos.
Entre em contato com a prefeitura
Solicite a liberação manual, se necessário.
Valide as credenciais
Confirme se o certificado digital ainda é válido ou se houve mudança na senha/token.
Evite novas tentativas sem revisar os dados
A insistência em enviar com erro pode prolongar o bloqueio.
Boas práticas
Não compartilhe certificados digitais sem controle;
Mantenha a senha/token sempre atualizados e documentados;
Automatize com atenção, evitando tentativas de envio em massa com erro.
Instabilidade no portal
Erros causados por indisponibilidade temporária ou falhas de comunicação com o sistema da prefeitura. Não estão relacionados a erros nos dados da nota, mas sim a falhas no servidor remoto, lentidão ou interrupções.
Erros mais comuns
Código/Descrição | Ação recomendada |
| Tentar reenviar após alguns minutos. |
| Verificar o status do portal e reenviar mais tarde. |
| Pode indicar instabilidade no processamento de XML. |
Possíveis causas
Atualizações no portal da prefeitura;
Problemas nos servidores de autenticação;
Picos de acesso ou congestionamento;
Expiração silenciosa de sessão.
Como resolver
Aguarde alguns minutos e tente novamente
Muitos portais retornam ao normal após alguns minutos.
Verifique no site da prefeitura
Alguns sites exibem avisos de manutenção programada.
Evite reenvios sucessivos automáticos
Isso pode sobrecarregar o sistema e levar a bloqueios.
Registre o horário do erro
Pode ajudar na abertura de chamados junto à prefeitura.
Boas práticas
Configure tentativas de reenvio automáticas com intervalo (ex: 30 min);
Mantenha registro de logs com data/hora e mensagem retornada;
Avise o cliente interno sobre possíveis atrasos quando houver falha generalizada.
Código de serviço
Erros relacionados à vinculação entre o código de serviço informado na nota e as atividades permitidas para o prestador de serviço. Cada município possui uma tabela própria de códigos, geralmente vinculada ao CNAE da empresa.
Erros mais comuns
Código/Descrição | Ação recomendada |
| Verificar o CNAE e sua correspondência com o código de serviço informado. |
| Ajustar o código de serviço conforme a tabela da prefeitura. |
Possíveis causas
Código de serviço incorreto ou não permitido para o prestador;
Ausência de vínculo entre CNAE e atividade no cadastro municipal;
Código digitado fora do padrão exigido pelo município (com zeros ou sem formatação correta).
Como resolver
Verifique a tabela de códigos da prefeitura
Consulte a relação oficial no site do município ou sistema emissor.
Ajuste o cadastro do prestador
Garanta que o código de serviço utilizado está autorizado para o seu CNAE.
Evite usar códigos genéricos ou desatualizados
Algumas prefeituras rejeitam códigos genéricos ou obsoletos.
Consulte um contador ou a própria prefeitura
Em caso de dúvida, é melhor validar diretamente com a autoridade fiscal.
Boas práticas
Mantenha uma tabela interna com os códigos permitidos por cidade;
Atualize periodicamente os códigos em caso de mudanças legais;
Evite copiar código de outras notas sem verificar a compatibilidade com o cadastro atual.
Data de emissão ou competência
Erros causados por diferença entre a data da nota, a data de competência e o período permitido para emissão no sistema municipal. Muitas prefeituras limitam o envio de notas dentro do mesmo mês de competência ou até o dia 10 do mês seguinte.
Erros mais comuns
Código/Descrição | Ação recomendada |
| Ajustar a data de competência para uma data compatível. |
| Emitir a nota com data dentro do mês vigente. |
Possíveis causas
Data da competência anterior à data atual;
Tentativa de emitir nota referente a um período já encerrado pela prefeitura;
Diferença entre a data de emissão e o mês declarado na nota.
Como resolver
Corrija a data da nota
Use uma data de emissão atual e uma competência válida conforme o mês vigente.
Verifique se a competência está aberta
Algumas prefeituras encerram o mês anterior no dia 10 do mês seguinte.
Evite emitir notas retroativas sem autorização
Prefeituras podem rejeitar ou multar casos de emissão retroativa sem justificativa.
Boas práticas
Revise os campos de competência e emissão antes do envio;
Consulte a prefeitura para saber os prazos limites por mês.
Endereço incompleto
Erros relacionados à ausência ou preenchimento incorreto de campos de endereço do tomador ou do prestador de serviços, como logradouro, número, complemento ou CEP. A maioria dos municípios exige o preenchimento completo e válido desses dados.
Erros mais comuns
Código/Descrição | Ação recomendada |
| Preencher o campo com um complemento válido. |
| Corrigir o CEP informado conforme os dados oficiais dos Correios. |
Possíveis causas
Dados preenchidos parcialmente ou com caracteres inválidos;
CEP inexistente, desatualizado ou de outro município;
Campo complemento vazio ou com texto curto demais.
Como resolver
Revise os campos de endereço
Logradouro, número, bairro, município, UF, complemento e CEP.
Consulte os Correios
Verifique se o CEP está correto usando o site dos Correios.
Evite abreviações ou siglas incomuns
Utilize descrições completas (ex: “Rua Dom Pedro I” em vez de “R. D. Pedro”).
Adicione um complemento significativo
Evite “-” ou “n/a”; preencha com algo útil, como “Apto 22” ou “Fundos”.
Boas práticas
Validar o endereço automaticamente na hora do cadastro;
Manter um padrão de preenchimento claro
Identifique campos obrigatórios por cidade.
Erro de assinatura digital
Erros causados por falhas na geração da assinatura digital do XML da nota fiscal, necessária para garantir a autenticidade e integridade do documento.
Erros mais comuns
Código/Descrição | Ação recomendada |
| Verifique a validade do certificado digital. |
Possíveis causas
Certificado digital expirado;
Erro na biblioteca de assinatura do sistema emissor;
Problemas no XML, como caracteres especiais não escapados corretamente;
Ambiente com antivírus ou firewall bloqueando o processo de assinatura.
Como resolver
Verifique a validade do certificado
Use o site ITI – Verificador de Certificados.
Evite caracteres especiais no corpo da nota
Caracteres como &, %, # devem estar corretamente formatados no XML.
Boas práticas
Mantenha o certificado atualizado e instalado corretamente;
Automatize alertas para aviso de expiração do certificado;
Valide a estrutura do XML antes do envio.
Nota duplicada
Erro gerado quando se tenta reenviar uma nota fiscal com o mesmo número de RPS ou quando o sistema da prefeitura já processou o documento anteriormente.
Erros mais comuns
Código/Descrição | Ação recomendada |
| Verifique no portal se a nota foi gerada com sucesso. |
Possíveis causas
Reenvio de um RPS já utilizado;
Duplicidade de requisição por falha de comunicação (ex: clicar duas vezes);
Erro no sistema de controle de sequência de notas.
Como resolver
Consulte a nota no portal
Verifique se a nota foi emitida corretamente.
Utilize o próximo número de RPS
Não tente reutilizar um número já processado.
Boas práticas
Evite tentativas manuais de correção sem validar no portal da prefeitura;
Outros
Categoria que abrange erros diversos que não se enquadram diretamente nas demais, geralmente relacionados à comunicação com o sistema ou retornos genéricos.
Erros mais comuns
Código/Descrição | Ação recomendada |
| Registrar chamado técnico com a prefeitura. |
Possíveis causas
Problemas internos do portal.
Como resolver
Evite reenvios imediatos
Aguarde alguns minutos e tente novamente, preferencialmente fora de horários de pico.