Erros frequentes
| Sintoma | Causa provável | Onde corrigir |
|---|---|---|
| Tipo de nota não aparece | documento não habilitado, item incompatível ou modo de NFS-e diferente | Unidade e Catálogo |
| Prestador/emitente inválido | CNPJ, IM/IE, endereço, IBGE, certificado ou credencial divergente | Unidade; compare cadastro oficial |
| Tomador/destinatário incompleto | CPF/CNPJ, nome, CEP, município/UF ou endereço ausente | Contato |
| Código de Tributação Nacional inválido ou ausente | código não tem 6 dígitos, é zero ou não corresponde ao serviço | Catálogo → NFS-e Nacional; consulte a lista oficial |
| Código de Tributação Municipal rejeitado | código de 3 dígitos não existe para o município ou período | Catálogo e prefeitura |
| NBS/Indicador inválido | tamanho incorreto ou correlação incompatível | Catálogo; consulte anexos nacionais |
| Item da lista/código municipal rejeitado | prefeitura usa formato ou tabela própria | Catálogo e documentação municipal |
| Regime/CRT divergente | regime do Fipli não coincide com SEFAZ/Receita | Unidade e cadastro oficial; rejeição 481 pode ocorrer |
| CST/CSOSN incompatível | situação do item não combina com CRT ou grupo de impostos | Perfil fiscal do produto |
| NCM/CFOP/CEST rejeitado | código inválido, extinto, destino incorreto ou CEST obrigatório em ST | Catálogo/perfil; consulte tabelas vigentes |
| Totais não fecham | base, alíquota, desconto, frete, retenção ou arredondamento incoerente | Catálogo e Pedido de Venda; compare item a item |
| Duplicidade de número | “próximo número” foi preenchido com número já autorizado ou outro emissor usa a série | Unidade e histórico do órgão autorizador; não avance sem conciliar |
| Certificado/CSC inválido | vencimento, CNPJ divergente, senha, ambiente ou ID Token incorreto | Unidade; renove/teste credencial correta |
| Nota permanece processando | NFS-e é assíncrona ou houve indisponibilidade | aguarde consulta/webhook; não reemita com nova referência sem confirmar |
| IBS/CBS bloqueado no Fipli | CST ou Classificação Tributária ausente no produto, ou exigida para não optante em serviço | Catálogo; classifique com a contabilidade |
Método de diagnóstico
- Copie a mensagem completa e o código do órgão, sem incluir token, senha ou certificado.
- Identifique quem rejeitou: validação do Fipli, prefeitura, Sistema Nacional ou SEFAZ.
- Localize o campo no inventário deste guia e corrija sua fonte.
- Confirme a tabela e a versão vigentes na data/competência da operação.
- Gere nova prévia; reenvie apenas quando souber que a primeira tentativa não foi autorizada.
Não “tente códigos” em produção
Uma nota autorizada com classificação incorreta continua tendo efeito fiscal. Pré-visualização e validação técnica não substituem a orientação contábil.