Pular para o conteúdo principal

Notas Fiscais — erros ao emitir

Ao emitir uma NF-e, o idworks faz duas etapas: primeiro monta a nota (busca a regra fiscal do produto, os dados do cliente e os valores do pedido) e só então envia para a SEFAZ. Erros podem aparecer em qualquer uma das duas etapas, e a solução é diferente em cada caso. Este artigo reúne os erros da primeira etapa — os que o próprio idworks detecta antes de enviar, normalmente porque falta uma configuração fiscal ou um dado do pedido.

Esses erros não têm código numérico e vêm com uma frase em português (por exemplo, "sem regra fiscal encontrada", "status do pedido não permite emitir nota fiscal"). Já as rejeições da SEFAZ — que vêm com um número, como 719 ou 733 — estão na tabela de códigos em Notas Fiscais → Por que minha NF foi rejeitada?.

A emissão em si acontece na tela de Pedidos (ou no Packing, quando configurado para emitir ao fechar a operação). A tela Vendas → Notas Fiscais apenas mostra o resultado.

Índice​

Conceito

Erros de preparação (antes de enviar à SEFAZ)

Comunicação com a SEFAZ

Rejeições da SEFAZ

Referência rápida

Onde os erros de emissão aparecem?​

📍 Onde: a emissão acontece em Vendas → Pedidos (ou no Packing, quando configurado). Quando a emissão falha, o pedido volta para o status anterior (geralmente Pendente) e a mensagem de erro aparece na própria tela do pedido. A lista de notas e o histórico ficam em Vendas → Notas Fiscais.

Os erros deste artigo são detectados pelo idworks, antes de a nota ser enviada à SEFAZ. Por isso, em todos eles, a correção é feita no idworks (regra fiscal, cadastro do cliente, dados do pedido) — não há nada a fazer no portal da SEFAZ.

Qual a diferença entre erro de preparação e rejeição da SEFAZ?​

  • Erro de preparação (este artigo): o idworks nem chegou a enviar a nota. A mensagem vem em português, sem número, e aponta uma configuração ou um dado faltando. Exemplos: "sem regra fiscal encontrada", "CPF/CNPJ do cliente é obrigatório".
  • Rejeição da SEFAZ: a nota foi enviada, mas a SEFAZ recusou. A mensagem vem com um número (o código da rejeição) seguido de uma frase. Exemplos: 719 - NF-e sem a identificação do destinatário, 733 - CFOP de operação interna e idDest <> 1. Esses estão na tabela de códigos da SEFAZ.

Em ambos os casos a nota não é emitida e o pedido volta para Pendente até você corrigir a causa e reemitir.

SKU sem regra fiscal encontrada no departamento fiscal​

Mensagem "SKU: CÓDIGO sem regra fiscal encontrada no dpto fiscal: DEPARTAMENTO, operação TIPO, ... faturador: EMPRESA". É o erro de preparação mais comum. O idworks não achou, no Departamento Fiscal do produto, uma regra (CFOP) que sirva para aquela combinação de operação. A mensagem mostra exatamente o que faltou:

  • dpto fiscal — o departamento amarrado ao produto (ex.: PADRÃO, Alcoólicos, Vestuário).
  • operação — o cenário da venda: operação normal, operação para consumidor final, contribuinte, etc.
  • faturador — a empresa (matriz/filial) que emite a nota.

Ou seja: o produto tem um departamento fiscal, mas dentro dele não existe um CFOP cadastrado para aquela operação/faturador específicos.

Como resolver:

  1. Confirme qual departamento fiscal está amarrado ao produto em Produtos → Listar Produtos → editar SKU.
  2. Abra esse departamento em Produtos → Departamento Fiscal → Configurar.
  3. Verifique se existe um CFOP para a operação que a mensagem citou (consumidor final, normal, contribuinte) e para o faturador (matriz ou filial) correto. Se não existir, adicione a regra com o CFOP adequado e marque uma como Principal.
  4. Salve e reemita a nota na tela de Pedidos.

O passo a passo completo da configuração está em Departamento Fiscal.

SKU não tem departamento fiscal​

Mensagem "SKU CÓDIGO não tem departamento fiscal. Verificar tab fiscal dentro do cadastro do item". É diferente do erro acima — aqui o produto nem está vinculado a um departamento fiscal. Sem departamento, o sistema não tem onde buscar a regra (CFOP, NCM, CEST, ICMS), e a montagem da NF falha logo no início.

Acontece especialmente em SKUs cadastrados pela primeira vez (importação de planilha, criação rápida via Hub Anúncios) e em SKUs migrados de outro sistema, em que a aba Fiscal não foi preenchida.

Como resolver:

  1. Abra o produto em Produtos → Listar Produtos → editar o SKU.
  2. Na aba Fiscal, selecione o Departamento fiscal correto (o departamento que reúne as regras fiscais para essa categoria de produto — ex.: Padrão, Vestuário, Alcoólicos).
  3. Confirme também o NCM e, se aplicável, o CEST — todos ficam nessa aba.
  4. Salve o produto e reemita a nota.

Se você não sabe qual departamento usar, abra Produtos → Departamento Fiscal e confira os que já existem. Em caso de dúvida sobre a tributação, consulte o contador antes de criar um departamento novo.

SKU sem CFOP preenchido no departamento fiscal​

Mensagem "SKU CÓDIGO sem CFOP preenchido no departamento fiscal sem emissão (OPERAÇÃO)". O produto tem um departamento fiscal vinculado, mas dentro do departamento falta o CFOP para aquela situação específica. É próximo do erro principal de "sem regra fiscal encontrada", com a diferença de que o sistema chegou a achar a regra — só que ela está com o campo CFOP em branco.

Como resolver:

  1. Em Produtos → Departamento Fiscal, abra o departamento amarrado ao SKU e clique em Configurar.
  2. Localize a linha da operação citada na mensagem (consumidor final, contribuinte, NFC-e, etc.) e preencha o CFOP adequado para a operação e a UF.
  3. Confirme com o contador se houver dúvida sobre qual CFOP usar.
  4. Salve e reemita a nota.

SKU sem CEST ou CEST inválido​

Mensagem "SKU CÓDIGO sem Cest ou Cest inválido. Preencher no cadastro. Verificar tab fiscal dentro do cadastro do item". O CEST (Código Especificador da Substituição Tributária) é obrigatório para produtos sujeitos à ST (substituição tributária). Se o CST/CSOSN da regra fiscal pede ST e o CEST está em branco — ou foi digitado com formato errado — a SEFAZ rejeita a nota.

O CEST tem 7 dígitos (padrão XX.XXX.XX). Ele identifica o segmento do produto na tabela do CONFAZ.

Como resolver:

  1. Abra o produto em Produtos → Listar Produtos → editar o SKU → aba Fiscal.
  2. Preencha o CEST correto para aquele produto (consulte a tabela do CONFAZ ou o contador).
  3. Confira também se o NCM está coerente com o CEST — os dois precisam combinar de acordo com a tabela CEST × NCM publicada pelo CONFAZ.
  4. Salve e reemita a nota.

Quando o produto não tem ST na operação, o erro não deveria aparecer. Se aparecer mesmo assim, é sinal de que a regra fiscal do departamento está marcando ST onde não deveria — revise o CST/CSOSN da regra em Produtos → Departamento Fiscal.

SKU sem NCM ou NCM inválido​

Mensagem "SKU CÓDIGO sem NCM ou NCM inválido. Preencher no cadastro. Verificar tab fiscal dentro do cadastro do item". O NCM (Nomenclatura Comum do Mercosul) é obrigatório em toda NF-e, independente da tributação. O sistema bloqueia a emissão quando o campo está em branco ou quando o número informado não tem o formato correto (8 dígitos, padrão XXXX.XX.XX).

Como resolver:

  1. Abra o produto em Produtos → Listar Produtos → editar o SKU → aba Fiscal.
  2. Preencha o NCM correto (8 dígitos). Se você não souber o NCM, consulte o contador ou a etiqueta/ficha técnica do fornecedor — todo produto industrializado tem NCM definido.
  3. Para evitar repetir essa correção em vários SKUs do mesmo tipo, defina o NCM no departamento fiscal (assim ele passa a valer como padrão para os produtos vinculados àquele departamento).
  4. Salve e reemita a nota.

SKU sem parte de ICMS preenchida para o estado X​

Mensagem "SKU CÓDIGO sem parte de ICMS preenchida estado: UF". Para emitir nota para um cliente de uma UF específica, a regra fiscal do produto precisa ter o bloco de ICMS por estado preenchido para aquela UF. Quando a UF do cliente é diferente das que estão cadastradas — ou foi adicionada uma UF nova e a regra antiga não cobriu ela — o sistema bloqueia.

Como resolver:

  1. Confirme a UF do cliente no pedido (em Vendas → Pedidos → endereço de entrega).
  2. Abra o departamento do produto em Produtos → Departamento Fiscal → Configurar → escolha o CFOP usado naquela operação → seção ICMS por estado.
  3. Adicione (ou edite) a regra para a UF citada no erro. Preencha CST/CSOSN, alíquotas, MVA quando houver ST, e demais campos que a operação exige.
  4. Confirme com o contador se a tributação por UF está correta (especialmente em vendas interestaduais com DIFAL).
  5. Salve e reemita a nota.

Se a operação é NFC-e (consumidor final dentro do estado), só a UF da própria empresa precisa estar cadastrada. Se for NF-e (55) com cliente em outro estado, a UF de destino precisa estar lá.

Status do pedido não permite emitir nota fiscal​

Mensagem "Status do pedido não permite emitir nota fiscal". A emissão só é permitida quando o pedido está em um status que comporta faturamento. Se o pedido está, por exemplo, em Orçamento, Cancelado ou já Faturado, a emissão é bloqueada.

Como resolver:

  1. Abra o pedido em Vendas → Pedidos e confira o status atual.
  2. Avance o pedido até o status que permite faturar (conforme o fluxo da sua operação) e então emita a nota.
  3. Se o pedido já tem nota emitida, não há o que reemitir — confira em Vendas → Notas Fiscais.

Pedido só tem itens de serviço (nenhum produto para a NF-e)​

Mensagem "Pedido não possui itens de produto para emitir NF-e após ignorar itens de Serviço" (ou, em pedidos de serviço, "Pedido de serviço não possui itens de produto para emitir NF-e. Emitir NFS-e para os serviços."). Acontece quando o pedido tem somente itens do tipo Serviço e a empresa está com a parametrização Ignorar itens tipo serviço na emissão da nota fiscal ativada (ou o pedido é de serviço). Nesse modo, o sistema tira os itens de serviço da NF-e e fatura só os produtos — mas, se não sobrou nenhum produto, não há o que emitir na NF-e.

Quando o pedido tem produtos e serviços misturados, o sistema emite a NF-e só dos produtos e ajusta os pagamentos automaticamente: o valor dos itens de serviço é descontado do total a pagar da NF-e e cada parcela informada no pedido é recalculada proporcionalmente, para que a soma das parcelas bata com o valor da NF-e emitida (sem os serviços).

A NF-e (modelo 55) documenta mercadoria; serviço é documentado na NFS-e (nota fiscal de serviço). Por isso o sistema bloqueia em vez de emitir uma NF-e vazia.

Como resolver:

  1. Se o pedido era para vender só serviço, emita uma NFS-e em Vendas → Listar NF Serviço (não a NF-e). Veja Listar NF Serviço.
  2. Se o pedido deveria ter produtos, abra o pedido em Vendas → Pedidos e confira se os itens de produto estão lançados. Adicione os produtos faltantes e reemita.
  3. Se a empresa não deveria estar separando serviço da NF-e, revise a parametrização em Configurações → Parametrizações → Fiscal Serviço → Ignorar itens tipo serviço na emissão da nota fiscal. Com ela desligada, os itens de serviço voltam a entrar na NF-e.

CPF/CNPJ do cliente é obrigatório na emissão de NFe​

Mensagem "CPF/CNPJ do cliente é obrigatório na emissão de NFe". A nota não pode ser emitida sem o documento do destinatário. O cliente do pedido está sem CPF (pessoa física) ou CNPJ (pessoa jurídica).

Como resolver:

  1. Abra o pedido em Vendas → Pedidos e localize o cliente.
  2. Preencha o CPF/CNPJ no cadastro do cliente (e, no caso de empresa, confira também a inscrição estadual quando for contribuinte).
  3. Reemita a nota.

Em vendas para consumidor final sem identificação, use o modelo NFC-e (65) quando a operação permitir — a NF-e (55) exige destinatário identificado.

Este XML não é válido (valores de ICMS-ST fora do padrão)​

Mensagens como "Este XML não é válido. Element pMVAST: ... The value ... is not accepted by the pattern ..." ou "Element modBCST: ... is not an element of the set {0,1,2,3,4,5,6}". Os dados de ICMS-ST (substituição tributária) da regra fiscal estão fora do formato que a SEFAZ aceita:

  • pMVAST é o percentual de MVA (margem de valor agregado) da ST — precisa estar no formato de percentual válido.
  • modBCST é a modalidade de base de cálculo da ST — só aceita os valores de 0 a 6.

Esses valores saem da regra fiscal do produto, então o ajuste é no Departamento Fiscal.

Como resolver:

  1. Abra o departamento do produto em Produtos → Departamento Fiscal → Configurar → o CFOP usado → a regra de ICMS por estado do estado de destino.
  2. Revise a MVA e a modalidade de base de cálculo da ST — preencha valores válidos (a modalidade tem que ser uma opção da lista; a MVA, um percentual coerente).
  3. Confirme os valores com o contador da empresa — quem define a tributação correta é ele.
  4. Salve e reemita a nota.

Informação complementar passou do tamanho máximo (infCpl)​

Mensagem "Este XML não é válido. Element {}infCpl: [facet maxLength] The value has a length of N; this exceeds the allowed maximum length of M". O campo de informação complementar da NF (texto livre que aparece na nota — observações, dados adicionais, mensagens fiscais obrigatórias) passou do tamanho que a SEFAZ aceita. O limite oficial é de 5.000 caracteres (e cada linha tem limite próprio, de algumas centenas).

A informação complementar é montada a partir de várias fontes — comentários do pedido, mensagens da regra fiscal (CST/CSOSN, ICMS, ST, DIFAL), informações obrigatórias por tipo de operação. Quando essas mensagens somadas passam do limite, a SEFAZ recusa.

Como resolver:

  1. Abra o pedido em Vendas → Pedidos e revise o campo Comentário da NF. Se houver texto longo (especificações técnicas, descrições copiadas), encurte ou retire o que não é obrigatório fiscalmente.
  2. Em Produtos → Departamento Fiscal, revise as mensagens cadastradas em cada CFOP/CST. Em alguns casos a regra fiscal carrega blocos longos repetidos por imposto — consolide o texto.
  3. Em Configurações → Parametrizações → Fiscal Produto, confira parametrizações que adicionam texto padrão à NF (comentário padrão, mensagem de cupom, mensagem de DIFAL).
  4. Reemita a nota.

Itens obrigatórios por lei (por exemplo, a mensagem de DIFAL ou a base legal de isenção) não podem ser removidos. Encurte o texto livre antes de mexer no obrigatório, e consulte o contador se ficar em dúvida.

Processo já está rodando, aguardar​

Mensagem "Processo já está rodando, aguardar!". Já existe uma emissão em andamento para aquele pedido. Acontece quando o botão de emitir é clicado várias vezes seguidas ou quando duas pessoas tentam emitir o mesmo pedido ao mesmo tempo.

Como resolver: aguarde alguns segundos e atualize a tela de Vendas → Pedidos. Não clique em emitir repetidamente — a emissão anterior pode concluir sozinha. Se o pedido ficar travado nesse estado por muito tempo, acione o suporte com o número do pedido.

Erro de comunicação via SOAP — Failed to connect to nfe.fazenda...​

Mensagem "Erro de comunicação via soap, Failed to connect to nfe.fazenda.UF.gov.br port 443 after N ms: Timeout was reached". Não é erro do idworks — é instabilidade do servidor da SEFAZ da UF emissora. O servidor responsável por receber/autorizar NF-e ficou sem resposta no momento da emissão. Aparece principalmente:

  • Em horários de pico (manhã do início do mês, fim do dia útil).
  • Em manutenção programada da SEFAZ (geralmente sábado/domingo).
  • Em quedas momentâneas (alguns minutos).

A nota não foi rejeitada — ela nem chegou ao servidor. O pedido volta para o status anterior e pode ser reemitido normalmente quando a SEFAZ voltar.

Como resolver:

  1. Confira o status da SEFAZ da sua UF — o portal nacional NF-e Nacional → Disponibilidade mostra cada UF e cada serviço (autorização, consulta, cancelamento) em verde/amarelo/vermelho.
  2. Se a SEFAZ está fora do ar, aguarde alguns minutos e tente de novo. Em geral o serviço volta em até 15 minutos.
  3. Se a indisponibilidade durar mais que algumas horas, considere usar a emissão em contingência (SVC) — modo previsto na legislação para emergências. A configuração fica em Configurações → Minhas Empresas → ambiente de NF-e. Combine com o contador antes.
  4. Não confunda com timeout do certificado digital — esse vem com mensagem diferente, relacionada ao A1.

Onde estão os códigos de rejeição da SEFAZ?​

Quando o erro vem com um número (por exemplo 719, 733, 805, 610), é uma rejeição da SEFAZ — a nota foi enviada e recusada. Esses códigos, com a causa e a ação de correção, estão reunidos na tabela em Notas Fiscais → Por que minha NF foi rejeitada? (códigos da SEFAZ).

Dois exemplos que aparecem com frequência:

  • 719 — NF-e sem a identificação do destinatário: a nota foi montada sem os dados do cliente. Confirme que o pedido tem cliente vinculado com nome/razão social e CPF/CNPJ.
  • 733 — CFOP de operação interna e idDest <> 1: o CFOP usado é de operação dentro do estado, mas o cliente é de outra UF. Confira a UF do cliente no pedido e os CFOPs por direção/estado no Departamento Fiscal.

Rejeição 204 — Duplicidade de NF-e, com Recibo em branco​

Mensagem "204 - Rejeição: Duplicidade de NF-e nRec:NÚMERO - Recibo:" (sem nada depois de "Recibo:"). É a rejeição 204 da SEFAZ — "Duplicidade de NF-e" — mas com uma variação específica: a SEFAZ devolveu o número do recibo (o nRec), mas não devolveu o número/chave da nota já existente. Acontece em três cenários:

  • Você reenviou uma nota antes do tempo de consulta normal — a SEFAZ guarda o lote por algumas horas e, se o mesmo conjunto chegar de novo, devolve "duplicidade" sem precisar abrir a chave anterior.
  • Houve falha de rede no envio anterior — a nota chegou na SEFAZ e foi autorizada, mas a resposta não voltou ao idworks, então o operador clicou em emitir de novo.
  • O sistema tentou reenviar automaticamente depois de um timeout — o mecanismo de retry colidiu com a nota que já foi autorizada.

A nota provavelmente já existe na SEFAZ — você só não recebeu a confirmação ainda.

Como resolver:

  1. Não reemita de novo. Aguarde alguns minutos para a SEFAZ liberar a consulta.
  2. Em Vendas → Notas Fiscais, busque o pedido — frequentemente a nota original aparece autorizada depois de alguns minutos (o idworks reconsulta sozinho usando o recibo).
  3. Se a nota não aparecer em algumas horas, consulte direto no portal da SEFAZ com o número do recibo (nRec) usando a consulta de recibo. Lá você confirma se a nota original foi autorizada e pega o número/chave.
  4. Se confirmar que está autorizada na SEFAZ, abra chamado no suporte com o número do pedido e do recibo — o suporte importa a chave que faltou e o pedido volta a ter NF.
  5. Nunca emita uma segunda nota "manual" para a mesma venda sem confirmar antes na SEFAZ — gera duplicidade fiscal real (com duas chaves autorizadas) e exige cancelamento de uma delas.

A rejeição 204 "normal" (com a chave da nota original informada) está coberta na tabela de códigos da SEFAZ. Esta variação (com Recibo em branco) costuma virar chamado de suporte por falta de informação aparente — daí o destaque aqui.

Resumo de parametrizações​

A emissão de NF-e não tem um grupo de parametrizações próprio "de erros" — o que define o conteúdo e a tributação da nota vem de duas fontes:

OndeO que controla
Produtos → Departamento FiscalAs regras fiscais (CFOP, CST, ICMS, ST, MVA, DIFAL, FCP) por produto, operação e estado. É a origem da maioria dos erros de preparação. Detalhes em Departamento Fiscal.
Configurações → Parametrizações → Fiscal ProdutoAjustes do conteúdo da NF emitida (alíquotas, comentário padrão, bases de cálculo, autorização de XML, envio de e-mail). Resumo em Notas Fiscais.
Configurações → Parametrizações → Fiscal ServiçoA opção Ignorar itens tipo serviço na emissão da nota fiscal tira os itens de serviço da NF-e e fatura só os produtos. Se o pedido só tem serviço, a emissão é bloqueada (ver acima).
Configurações → Minhas Empresas → CertificadoO certificado digital A1 da empresa emissora. Sem ele, a emissão e o cancelamento ficam bloqueados.

Privilégios da tela​

Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela. Como a correção desses erros passa por várias telas, os privilégios mais usados são:

PrivilégioLibera
Visualizar PedidoAcessar Vendas → Pedidos para emitir/reemitir a nota e corrigir dados do pedido.
Emitir Nota FiscalDisparar a emissão da NF-e a partir do pedido.
Visualizar Notas FiscaisAcessar Vendas → Notas Fiscais e a tabela de códigos de rejeição da SEFAZ.
Visualizar departamento fiscalAcessar Produtos → Departamento Fiscal para conferir as regras.
Editar departamento fiscalCadastrar e ajustar CFOPs e regras de ICMS/ST.
Editar ConsumidorCorrigir CPF/CNPJ e inscrição estadual no cadastro do cliente.
Última atualização em