---
title: "Solução de problemas"
description: "Os erros mais comuns e como resolver."
source_url: https://nfe.io/docs/integracoes/plugins/stripe/solucao-de-problemas
last_updated: 2026-07-22
---

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](/integracoes/plugins/stripe/configuracao-fiscal#dados-do-tomador-cliente).

## 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](https://app.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](/integracoes/plugins/stripe/uso-no-dia-a-dia#corrigir-e-reemitir).

## Ainda com problemas?

Fale com o nosso suporte em **[suporte@nfe.io](mailto:suporte@nfe.io)** — resposta em até 6 horas úteis.