Solução de problemas

Os problemas mais comuns, com causa e correção. Não achou o seu? Fale com o suporte — com a mensagem de erro completa, a resposta sai muito mais rápido.

Não recebo o código por e-mail — confira a caixa de spam; o código expira em alguns minutos (peça outro). Após 5 tentativas erradas, o acesso trava por 5 minutos (proteção contra ataques).

Entrei e não vejo a empresa/os dados — você provavelmente entrou com outro e-mail (cada e-mail é uma conta). Se era para entrar na empresa de um colega, peça a ele um convite para o e-mail certo.

Não vejo o espaço Administração — seu papel é Operador. Um Admin pode promover você em Administração → Usuários.

Certificado e transmissão

"Erro de comunicação com a SEFAZ" persistente — primeiro confira o status da SEFAZ da sua UF. Se a SEFAZ está no ar, a causa mais comum é o certificado: vencido, senha incorreta na importação, ou de CNPJ diferente do emitente. Reenvie o .pfx na tela do certificado — a validação aponta o problema. Se a SEFAZ estiver realmente fora, use a contingência SVC no cadastro do emitente.

Certificado vence em breve — você recebe alerta por e-mail a partir de 30 dias. Renove com sua Autoridade Certificadora (não precisa ser a mesma) e reenvie o novo .pfx.

Rejeições da SEFAZ mais comuns

Código	Mensagem (resumo)	Causa e correção
204	Duplicidade de NF-e	A nota já foi autorizada antes (ex.: reenvio após timeout). Consulte a situação da nota — ela provavelmente já está autorizada.
391	Dados do cartão não informados	Pagamento cartão/PIX dinâmico exige o grupo de dados do cartão. O Notavia já preenche automaticamente — atualize a página e emita de novo; persistindo, contate o suporte.
539	Duplicidade com diferença na chave	A SEFAZ já tem uma nota com a mesma série e número, mas com outra chave. Não reenvie: consulte a situação da nota original. Se estiver autorizada, ela vale e o próximo número da série precisa avançar (veja Séries de numeração); se não existir nota nenhuma, emita com um número nunca usado. A inutilização serve só para números que você pulou e não vai usar. Guia completo: blog da Notavia.
531	Total da BC ICMS difere do somatório	Inconsistência entre itens e total — normalmente regra da matriz com CST/CSOSN trocado. Confira a regra de ICMS no Simulador.
693	Alíquota de ICMS superior à permitida	Alíquota errada na matriz para aquela UF. Corrija a regra.
627	vICMSDeson/motDesICMS sem o par	A desoneração precisa do valor e do motivo juntos. Na matriz, marque ICMS desonerado e preencha o Motivo (o sistema já garante isso — se cair aqui, revise a regra).
625	Inscrição SUFRAMA deve ser informada	Venda com isenção para a Zona Franca de Manaus exige a Inscrição SUFRAMA do cliente — preencha o campo em Cadastros → Clientes (veja Cadastros).
235	Inscrição SUFRAMA inválida	A SEFAZ valida o dígito verificador do ISUF. Confirme o número com o seu cliente (8-9 dígitos, sem pontuação).
626	CFOP de operação isenta para ZFM diferente do previsto	Venda isenta para a ZFM usa CFOP 5110/6110 — ajuste o CFOP da operação fiscal.
812 (DC-e)	Remetente contribuinte de ICMS	Contribuinte não pode ser remetente de DC-e em nenhuma modalidade — a mercadoria dele circula com NF-e. O portal bloqueia antes de transmitir quando reconhece o documento (veja DC-e).
930	CST com benefício fiscal e cBenef não informado	A CST tem benefício (20/30/40/41/50/70) e falta o código de benefício fiscal (cBenef). Informe-o no item, na emissão — o código sai da tabela cBenef da sua UF (ex.: SP `SP010030` CST 40, `SP020030` CST 20). Confirme com a contabilidade. Ver Matriz → desoneração.
931	Código de benefício incompatível com a CST ou com a UF	O cBenef informado não corresponde à CST do item ou pertence à tabela de outra UF. Confira o código na tabela oficial da UF do emitente e confirme com a contabilidade.
946	Código de benefício incorreto ou inexistente na UF	O cBenef informado não existe na tabela da UF (costuma ser digitação). Confira o código na tabela oficial da UF. Guia: blog da Notavia.
696	Operação com não contribuinte deve indicar consumidor final	Venda a cliente não contribuinte exige a operação marcada como consumidor final. Marque "Consumidor final" na operação fiscal.
778	NCM inexistente	NCM do produto inválido/desatualizado. Corrija no cadastro do produto.
226	UF do emitente difere da UF autorizadora	UF errada no cadastro do emitente.
217/218	NF-e não consta / NF-e já cancelada	Evento sobre nota inexistente ou já cancelada — consulte a situação da nota antes.
501/573	Prazo de cancelamento expirado	Passou o prazo (em regra 24h). Avalie devolução/estorno com sua contabilidade.

Inscrição Estadual rejeitada — digite a IE sem se preocupar com pontos e traços (o sistema normaliza), mas confira se a IE pertence mesmo àquele CNPJ e UF. Empresa isenta: use ISENTO.

Rejeições de cadastro do emitente

Essas rejeições não se resolvem mexendo na nota: a SEFAZ está dizendo que a situação da empresa não permite emitir. Quando uma delas acontece, a tela Emitir NF-e e o detalhe da nota mostram um quadro O que fazer com a explicação e os passos. Na API de integração, a consulta do job traz o mesmo conteúdo no campo orientacao.

Código	Mensagem da SEFAZ	Causa mais comum e correção
245	CNPJ Emitente não cadastrado	A SEFAZ da sua UF não reconhece o CNPJ como emissor de NF-e. O motivo mais comum é não ter feito o credenciamento como emissor — em alguns estados ele vale até para homologação (veja abaixo). Confira também se o CNPJ está correto.
203 / 781	Emissor não habilitado para emissão da NF-e	O estabelecimento não está autorizado a emitir NF-e (falta de credenciamento ou pendência cadastral no fisco). Faça ou confira o credenciamento; se estiver em dia, procure o contador ou o posto fiscal.
230	IE do emitente não cadastrada	A inscrição estadual do emitente não existe no cadastro da UF — número digitado errado ou inscrição recém-concedida que ainda não foi propagada.
231	IE do emitente não vinculada ao CNPJ	A inscrição existe, mas é de outro CNPJ (por exemplo, a IE da matriz usada numa filial).
164	Emitente com situação irregular na UF	A nota saiu sem IE (ou como ISENTO) e o cadastro centralizado marca o CNPJ como bloqueado ou vedado na UF.
163	Emitente possui inscrição estadual ativa no cadastro da UF	A nota saiu sem IE (ou como ISENTO), mas a empresa tem IE ativa. Informe a IE no cadastro do emitente.
213	CNPJ-Base do Emitente difere do CNPJ-Base do Certificado Digital	O certificado A1 é de outra empresa. Envie o certificado da própria empresa.
301	Uso Denegado: Irregularidade fiscal do emitente	A nota foi registrada, mas o uso foi negado; o número fica consumido. Regularize a situação antes de emitir de novo.

Para conferir a situação da empresa, abra o emitente em Cadastros → Emitentes e use Verificar na SEFAZ, ou consulte o cadastro de contribuintes da sua UF (Sintegra; em SP, o Cadesp).

Credenciamento como emissor de NF-e

Em alguns estados a empresa precisa se credenciar como emissora de NF-e na SEFAZ antes de emitir com um sistema como a Notavia. Ter a inscrição estadual ativa não basta. Quando a UF (e o regime) do emitente é um desses casos, o cadastro do emitente mostra um aviso com o link oficial.

Credenciamento exigido também para a homologação (testes):

São Paulo — só o MEI. Os demais contribuintes são credenciados de ofício. O MEI pede o credenciamento com certificado digital, e o pedido para o ambiente de testes é separado do de produção; a liberação pode levar até 24 horas (carta de serviço da SEFAZ-SP; Portaria CAT 162/2008).
Minas Gerais — cadastro como emissor no SIARE; libera a homologação na hora e a produção pode ser pedida 2 horas depois.
Pernambuco — pedido por estabelecimento, primeiro para homologação (com no mínimo 10 testes) e depois para produção (SEFAZ-PE).
Distrito Federal — pedido por estabelecimento na Agência Virtual, com o certificado da empresa; vale para homologação e produção.
Mato Grosso do Sul — credenciamento de NF-e antes de usar a homologação; a produção exige testes de autorização, cancelamento e inutilização.

Homologação liberada; credenciamento só para produção:

Paraná — pedido no Receita/PR (UPD, finalidade 55).
Santa Catarina — credenciamento no SAT.

Credenciamento exigido (a norma não trata da homologação):

Goiás — portal de credenciamento, com certificado da empresa e DT-e ativo.
Rio Grande do Sul — pedido no site da Receita Estadual para quem não foi credenciado de ofício; até 2 dias úteis.
Mato Grosso — só o MEI, pelo Credenciamento Especial no Sefaz Digital.

Nos demais estados, ou o credenciamento é automático, ou não conseguimos confirmar a regra em fonte oficial: confira com a SEFAZ da sua UF ou com o seu contador. Links conferidos em 14/09/2026.

Emissão e numeração

"Pulei" um número de nota — uma transmissão falhou depois da reserva do número. É normal: inutilize a faixa até o fim do mês seguinte.

Não consigo cancelar / corrigir / inutilizar uma nota de série 900–999 — a SEFAZ trata as séries 900 a 999 como reservadas: rejeita eventos (cancelamento/carta de correção, rejeição 574) e inutilização (rejeição 266 — "série fora da faixa permitida (0-889)") nessas notas. Use série até 889 para notas que poderão ter eventos.

A nota não calcula imposto / valor zerado — a matriz não tem regra que combine com aquela operação (UF, produto, cliente, vigência!). Use o Simulador para ver qual regra está sendo (ou não) encontrada. Lembre: no Simples, CSOSN 102/103/300/400 não destacam ICMS — base zerada ali é o comportamento correto.

Emissão bloqueada com aviso de limite (plano Free) — você atingiu as 3 notas do dia. A cota zera à meia-noite no horário do estado do seu emitente padrão, ou faça upgrade com ativação imediata. Em homologação não há limite.

Notas recebidas

"Aguarde 1 hora entre consultas" — limite da própria SEFAZ por CNPJ. A tela informa quando a próxima consulta libera.

DANFE e e-mail

DANFE não abre/erro ao gerar — tente de novo (a geração é sob demanda). Persistindo, baixe o XML (sempre disponível) e contate o suporte.

Cliente diz que não recebeu o e-mail — confira: e-mail correto no cadastro do cliente, envio ativo em Administração → E-mail da NF-e, e a caixa de spam do destinatário. Você sempre pode baixar XML + DANFE no detalhe da nota e encaminhar manualmente.

API e integração

Erros 401, 429 e jobs com falha estão detalhados na documentação da API → Erros.