Para verificar o motivo do erro, é necessário acessar o detalhamento da venda. Isso pode ser feito tanto pelo painel de notas fiscais quanto pelo painel de vendas.

No menu de ações, selecione a opção “Visualizar venda”. Essa opção exibirá mais detalhes da venda.

Caso precise de ajuda para localizar a venda ou acompanhar a emissão, consulte este artigo:
https://zuppy.co/ajuda/como-acompanhar-a-emissao-da-nota

Onde encontrar o erro da nota

1. Dentro do detalhamento da venda, localize a seção de Notas Fiscais, onde é exibido o status da nota.

2. Se a nota estiver com status como “Emissão negada”, clique no botão de ações e selecione a opção “Ver informações de emissão de NF”.

3. Será aberto um modal com os dados da requisição em formato JSON.
   Esses dados representam as informações que foram enviadas para a prefeitura no momento da tentativa de emissão da nota. O formato JSON é apenas uma forma estruturada de exibir esses dados, organizada em campos e valores para facilitar a leitura pelo sistema.

Como identificar a mensagem de erro

No conteúdo exibido, role até o final. Procure pela seção que apresenta o retorno do emissor da nota fiscal.

Nessa parte, localize os campos “mensagem” ou “message”. É nesse campo que estará a descrição do erro.

Alguns exemplos:

• "Certificado vencido em: 26/11/2025 08:19:00, atualize seu certificado digital para continuar emitindo."

  
  

• [{"Codigo":"E0312","Descricao":"O código de tributação nacional informado não está administrado pelo município de incidência do ISSQN na data de competência informada na DPS."}]

Em alguns casos, a mensagem pode ser genérica, como:

• "Erro desconhecido: Erro ao realizar a requisição."

• "null"

Como proceder após identificar o erro

A ação necessária depende do tipo de erro identificado.

Em casos simples, a correção pode ser feita diretamente, como:

• Atualizar o certificado digital quando estiver vencido

• Ajustar dados incorretos no cadastro da empresa

Já em situações mais complexas, como erros relacionados a regras fiscais ou tributação, o ideal é entrar em contato com o suporte.

Principais causas de erro

A maioria dos erros ocorre por inconsistências cadastrais ou fiscais, como:

• Regime de tributação da empresa diferente do registrado na prefeitura

• Dados da empresa divergentes do portal nacional

• Produto ou serviço configurado de forma incorreta

• Categoria do produto incompatível com a atividade da empresa

• Cadastro de produto incompleto

• Falta de informações obrigatórias para emissão

Se não for possível identificar ou corrigir o erro com base na mensagem retornada, entre em contato com o suporte para orientação.