Troubleshooting - EasyData-Solutions/Documentacao GitHub Wiki

🧰 Troubleshooting

Guia prático para identificar causas prováveis e aplicar correções rápidas nos erros mais comuns.
Dica: use Ctrl/⌘ + F para buscar pelo código do erro (ex.: 669, 55, 491) ou por uma palavra‑chave (ex.: CFOP, TEF, xMun).

🔎 Índice rápido

🧾 NF‑e / NFC‑e — Rejeições Sefaz

669 — Duplicidade no MDF‑e

Sintoma: retorno de duplicidade ao transmitir MDF‑e.
Como resolver: verificar se o MDF‑e já foi autorizado para o mesmo conjunto (chave/UF/emitente). Ajuste dados e reenvie.

55 — Duplicidade em NF‑e

Sintoma: Sefaz indica que já existe NF‑e com a mesma chave/numeração.
Como resolver: conferir série, número e chave de acesso; ajuste a numeração ou inutilize conforme o caso antes de reenviar.

491 — Carta de Correção (CCe)

Sintoma: falha ao emitir CCe.
Como resolver: atualizar o sistema e repetir o envio. (Registro de bug conhecido resolvido em versões recentes.)

694 — Correção DIFAL / Inscrição Estadual

Sintoma: rejeição por DIFAL ou inconsistência de IE após importar pedido.
Como resolver: revisar Inscrição Estadual do cliente (e UF destino) antes de faturar; atualize cadastro e regenere a nota.

793 — Imposto FCP (UF Destino)

Sintoma: erro relacionado ao FCP na aba UF Destino.
Como resolver: preencher os campos do FCP (use 0 onde aplicável) para viabilizar o cálculo/validação.

886 — Código de barras igual ao EAN

Sintoma: rejeição por conflito no código de barras/EAN.
Como resolver: validar EAN/código cadastrado; ajuste o GTIN conforme a regra do produto.

778 — GTIN inválido

Sintoma: erro de GTIN (código de barras).
Como resolver: validar o GTIN informado ou remover quando não aplicável ao item.

“The element ‘COFINSOutr’…”

Sintoma: XML inválido por falta de bloco de COFINS adequado.
Como resolver: consultar a nota original / tributação do item e ajustar CST/alíquotas de COFINS.

“The element ‘pag’…” (Sem pagamento informado)

Sintoma: XML sem grupo de pagamento.
Como resolver: defina a forma/condição de pagamento antes de transmitir.

“Sem comunicação com o serviço NFeAutorizacao”

Sintoma: falha de comunicação com a Sefaz.
Como resolver: aguarde e tente novamente; confirmar internet, firewall e status da Sefaz/ambiente.

494 — Cancelamento NFe indisponível

Sintoma: não é possível registrar o evento de cancelamento.
Como resolver: verificar se o evento já foi registrado na Sefaz; aguardar restabelecimento do serviço e reenviar.

📦 Faturamento / Devolução

Devolução — NullReferenceException

Sintoma: “ERRO NA EMISSÃO DE DEVOLUÇÃO”.
Causa provável: item com campos obrigatórios vazios.
Checklist: CFOP, CST, Preço, Quantidade, CST PIS, CST IPI, CST COFINS.
Como resolver: preencha todos os campos; se persistir, adicione outro item, depois volte e inclua o item da devolução.

Itens sem CFOP

Sintoma: “nfe:CFOP: item sem o CFOP”.
Como resolver: revisar item a item e informar CFOP correto conforme operação.

👥 Cadastro (Cliente, Transportador, Produto)

xMun — Transportador incompleto

Sintoma: erro no campo Município (xMun).
Como resolver: complete Município, UF, CNPJ/CPF do transportador.

Destinatário com dados inconsistentes

Sintoma: validação falha por cadastro incompleto.
Como resolver: revisar Endereço (logradouro, número, bairro, cidade, UF, CEP) e documentos.

Natureza da Operação

Dica: sempre confira a descrição e o que aparece entre parênteses na mensagem de retorno da Sefaz.

Produto — erro ao adicionar

Sintoma: falha na inclusão do item.
Como resolver: insira outro produto e, em seguida, tente novamente o desejado (contorna validação transitória).

Erros de endereço

Sintoma: “Erro rua ou logradouro”.
Como resolver: padronize logradouro e número, evitando abreviações irregulares/caracteres especiais.

Caracteres não permitidos

Sintoma: rejeição por caracteres inválidos.
Como resolver: evite caracteres especiais em campos enviados à Sefaz (observações, endereços, etc.).

💲 Preços, Promoções e Descontos

Preço do produto inválido

Sintoma: preço abaixo da política/tabela.
Como resolver: conceda permissão especial quando necessário (venda abaixo da tabela).

Pedidos com itens zerados (prodAcrescimoCell)

Sintoma: itens com quantidade/preço 0.
Como resolver: ajuste quantidades e remova itens zerados.

🚚 Romaneio / Entrega

Entregas no Romaneio

Dica: utilize a aba de Entregas e confira status Iniciado/Finalizado/Faturado conforme o fluxo.
Edição bloqueada: entregas já faturadas não devem ser editadas.

🛒 PDV e TEF

“Access to the path ‘C:\intpos.tmp’ is denied.”

Sintoma: arquivo temporário do TEF sem permissão.
Como resolver: se a empresa não utiliza PIN PAD, acesse Configurações → Pagamentos e desmarque “Usa TEF”.

“No service for type…”

Sintoma: serviço local do PDV/integração indisponível.
Como resolver: verifique se a máquina está na mesma rede e se o serviço está em execução.

🗄️ Banco de Dados / Rede / Sistema

“Configuration system failed to initialize”

Sintoma: erro ao abrir o EasyData por conflito de versões/pastas.
Como resolver: havia duas pastas de versão (antiga e nova). Faça backup das configs, baixe a versão mais recente e substitua a pasta antiga (corrige falha de atualização).

“A network related or instance‑specific…” (T‑SQL)

Sintoma: erro de rede/instância SQL ao rodar consulta.
Como resolver: reinicie o roteador e a máquina; confira instância/porta e credenciais.

Certificado vencido — 403

Sintoma: bloqueio por certificado expirado.
Como resolver: renovar/importar certificado digital válido no sistema.

CRT inválido (Regime da Empresa)

Sintoma: regime tributário inconsistente.
Como resolver: ajustar CRT no cadastro da empresa conforme enquadramento tributário.

📎 Outros avisos e boas práticas

  • Sempre revisar o retorno da Sefaz — a dica importante geralmente está entre parênteses.
  • Backup antes de atualizar o sistema/BD.
  • Evite caracteres especiais em campos que seguem para o XML.
  • Em rejeições por duplicidade, confira se o documento já foi autorizado antes de reenviar.

🤝 Canais de Suporte