Solução de problemas
Os erros mais comuns e como resolver.
Documento do tomador ausente ou inválido
Sintoma: a nota não é emitida, ou sai como "cliente não identificado".
Causa: a fatura foi paga sem CPF/CNPJ identificável.
Solução: cadastre o CPF/CNPJ do cliente como Tax ID no Stripe (br_cnpj ou br_cpf) ou em metadata (ex.: cpf_cnpj) e reemita. Veja Dados do tomador.
Endereço ou CEP incorreto
Sintoma: a prefeitura rejeita a nota.
Causa: CEP, cidade ou endereço inconsistentes — causa comum de rejeição.
Solução: corrija o endereço do cliente no Stripe (CEP válido e cidade correta) e reemita. Quando faltar o bairro, informe-o via metadata.district ou campo personalizado do Checkout.
Empresa sem Inscrição Municipal ou certificado
Sintoma: a conexão não ativa, ou a emissão falha por empresa não habilitada.
Causa: a empresa emissora não tem Inscrição Municipal ativa ou certificado A1 válido.
Solução: complete o cadastro fiscal da empresa no painel da NFE.io (Inscrição Municipal e certificado). O app não faz esse cadastro.
Prefeitura não homologada
Sintoma: a empresa está cadastrada, mas a emissão não é possível para a cidade.
Causa: a NFE.io ainda não tem integração homologada com aquela prefeitura.
Solução: confira o status no painel da NFE.io e fale com o suporte.
Como reemitir
Abra a fatura no Dashboard do Stripe, veja o motivo do bloqueio, corrija o dado indicado e use a ação de reemitir. Veja Corrigir e reemitir.
Ainda com problemas?
Fale com o nosso suporte em [email protected] — resposta em até 6 horas úteis.