Corrigindo uma nota recusada

Quando a prefeitura não aceita uma emissão, a nota fica com o selo emissão não concluída ou emissão recusada. Nada se perde: a tentativa continua no histórico, e a ficha da nota explica o motivo em português claro — cada erro vem com um botão de conserto que leva você direto ao lugar onde o problema se resolve.

Este artigo mostra como ler os erros, para onde cada botão leva e os dois caminhos de correção: a nova emissão corrigida e a correção por substituição.

Onde ver o que deu errado

Abra a ficha da nota (tela Notas fiscais → linha da nota). O grupo Ocorrências da emissão lista cada problema devolvido pela prefeitura, já traduzido:

Título amigável — por exemplo, "Revise o regime tributário da empresa" em vez de um código técnico.
A explicação — o que exatamente precisa ser corrigido.
Detalhe técnico para o suporte — a mensagem original da prefeitura, em letra pequena, para quando você precisar mostrá-la ao contador ou ao suporte.
Referência para o suporte — o código do erro, para citar no atendimento.

Na tela de lista, o filtro Com erro mostra todas as notas que precisam de revisão de uma vez.

O botão de conserto: para onde cada erro leva

O sistema lê a ocorrência e decide o destino do botão. A regra de bolso: problema de configuração leva para a configuração da empresa; problema no conteúdo da nota leva para uma nova emissão. Uma nota recusada nunca é editada em silêncio — corrigir sempre significa criar uma emissão nova, com nova referência.

Tipo de problema	Botão que aparece	Onde você cai
Regime tributário / Simples Nacional (ex.: código E0713)	Ajustar o regime da empresa	Configurar empresa — a configuração fiscal da empresa emissora
Certificado digital, senha, token ou credenciais	Revisar o acesso da empresa	Configurar empresa, na parte de acesso fiscal
Alíquota, código do serviço, CNAE, tributação, natureza	Revisar o perfil fiscal	Configurar empresa, nas regras do serviço
Série ou numeração de RPS	Revisar a numeração fiscal	Configurar empresa
Dados do prestador (a sua própria empresa)	Revisar o cadastro da empresa	Configurar empresa
Dados da nota ou do tomador — CPF/CNPJ, endereço, CEP, data de emissão, competência	Corrigir e emitir novamente	Emissão nova, já pré-preenchida com os dados da nota recusada
Erro sem categoria clara	Emitir novamente	Emissão nova pré-preenchida

Os botões só aparecem para o titular da conta — em consulta compartilhada, os erros continuam visíveis, mas sem as ações.

"Corrigir e emitir novamente": a reemissão amigável

Para notas emitidas livremente (sem receita vinculada), esse botão fecha a ficha e abre a tela Emitir nota com valor, descrição do serviço e empresa emissora já preenchidos — iguais aos da nota recusada. A pessoa (o tomador) você vincula de novo: aproveite esse momento para conferir o cadastro dela, porque é dele que saem CPF/CNPJ, e-mail e endereço da nota. Corrigiu o cadastro, corrigiu a causa — não só o sintoma.

Uma nota criada a partir de uma receita não mostra esse atalho — reemiti-la como nota avulsa a desligaria da transação de origem. Para essas, use o grupo Nova emissão corrigida na própria ficha, descrito a seguir.

Nova emissão corrigida

Quando a nota está recusada e o sistema confirma a disponibilidade, a ficha mostra o grupo Nova emissão corrigida. A ideia: preencha somente os campos que precisam mudar — cada linha mostra "sem correção" até você informar algo, e a dica da tela reforça: "Preencha somente se esse dado precisa ser corrigido."

Nova descrição do serviço — substitui a descrição da nota. O texto atual aparece como exemplo no campo.
Dados do tomador — Nome ou razão social, CPF ou CNPJ, E-mail e Telefone. O CPF/CNPJ é validado pelos dígitos verificadores; se você informar um documento sem o nome, a ficha pede o nome também.
Endereço fiscal — Logradouro, Número, Complemento, Bairro, Município (IBGE) (o código do IBGE tem 7 dígitos), UF (duas letras, como SP) e CEP (8 dígitos).
Campos técnicos em JSON — só para campos fiscais aceitos pela API que não aparecem acima; em geral, quem usa é o contador ou o suporte. Precisa ser um objeto JSON válido, com até 48 mil caracteres. Exemplo de formato:

{"configuracao_avancada":{}}

💡 Identidade da empresa, transação, valor, referência e chave são imutáveis: nenhuma correção muda quem emitiu, quanto foi, nem os identificadores da nota original. Se você tentar, a ficha recusa com o nome do campo.

O fluxo completo:

Preencha o campo (ou os campos) que causaram a recusa.
Toque em Revisar nova emissão.
Confirme na pergunta "Criar uma nova emissão corrigida?" — o aviso explica: "A tentativa … permanecerá no histórico. A correção receberá uma nova referência e será processada como outra emissão."
Toque em Criar nova emissão. Ao concluir, aparece "A nota corrigida recebeu uma nova referência." e você acompanha a nova emissão na mesma tela.

É preciso informar ao menos uma correção — repetir a nota igual não faz sentido: daria o mesmo erro.

Corrigir por substituição (nota já autorizada)

Às vezes o erro só é percebido depois da autorização — uma descrição errada, um dado do tomador trocado. Nesse caso, o mesmo grupo aparece com o nome Corrigir por substituição (disponível quando a nota está autorizada e o sistema confirma a substituição). Os campos de correção são os mesmos; o que muda é a justificativa, que depende do trilho da nota:

Trilho municipal — Justificativa do cancelamento vinculado, opcional; se informada, precisa ter entre 15 e 255 caracteres. A confirmação avisa: "A nota atual será cancelada; somente após a confirmação será criada a nova emissão."
Trilho nacional — Justificativa da substituição, com dois campos: Código (01 a 05 ou 99; deixe em Código automático na dúvida) e Motivo (entre 15 e 255 caracteres). Só informe quando a prefeitura exigir um motivo específico. A confirmação avisa: "A nova nota será vinculada como substituta da nota atual."

O botão aqui é Revisar substituição, e a pergunta de confirmação é "Substituir por uma nota corrigida?" → Confirmar substituição.

O que acontece com a nota recusada

Ela fica no histórico, com a referência original — nada é apagado. Isso preserva a rastreabilidade fiscal e ajuda o suporte a entender o caso.
A correção nasce com uma referência nova e é processada como outra emissão, do zero.
Numa substituição, a nota original passa ao selo substituída: "Esta nota foi substituída. Consulte a nova referência vinculada."

Problemas comuns

O que você vê	Causa	O que fazer
"Informe ao menos uma correção antes de criar a nova emissão."	Você tocou em Revisar sem preencher nenhum campo.	Preencha ao menos o campo que causou a recusa; os demais permanecem como na nota original.
"O JSON técnico precisa ser válido." / "…precisa formar um objeto."	O texto no campo técnico não é um JSON bem formado.	Confira chaves e aspas duplas — ou apague o campo e use os campos normais da ficha.
"O campo … pertence à nota original e não pode ser alterado."	O JSON técnico tentou mudar valor, empresa, referência ou chave.	Esses campos são imutáveis numa correção. Se o valor está errado, o caminho é emitir uma nota nova com o valor certo (e cancelar a autorizada, se houver).
"O motivo da substituição deve ter entre 15 e 255 caracteres."	Motivo curto demais na substituição nacional.	Explique o motivo com pelo menos 15 caracteres.
"Revise o CPF ou CNPJ: o número informado não é válido."	O documento não passa na conferência dos dígitos verificadores.	Confirme o número com o cliente — um dígito trocado é a causa mais comum.
O botão "Corrigir e emitir novamente" não aparece	A nota está vinculada a uma receita, ou você não é o titular da conta.	Use o grupo Nova emissão corrigida na ficha; em conta compartilhada, peça ao titular.
"A nova emissão corrigida não foi confirmada como disponível para esta tentativa."	O sistema ainda não confirmou a disponibilidade — a situação da nota pode ter mudado.	Use Atualizar → Consultar situação agora e tente de novo.