Fiscal e Conformidade

NFe e NFCe

Gerar, transmitir, cancelar, CC-e, contingência, inutilização e listas de XML.

Neste capítulo (20 seções)

A emissão fiscal no Nexus nasce da venda: NFe (modelo 55) para venda direta/B2B e NFCe (modelo 65) para PDV/varejo. Este capítulo explica o fluxo de gerar, transmitir, manter (imprimir, cancelar, CC-e), contingência e inutilização — e o que cada campo/botão faz.

NFe ou NFCe?#

NFe (mod. 55) NFCe (mod. 65)
Origem no sistema Venda direta (is_direct_sale) Venda de PDV (não suspensa)
Uso típico B2B, transferência, devolução, DANFE completo Varejo, balcão, cupom eletrônico
Destinatário Cliente com documento e endereço (regra por CFOP) Pode ser consumidor não identificado (limites legais por valor/UF)
Pré-requisito extra Natureza, CFOP, série/número NFe CSC ID + CSC, série/número NFCe
Eventos na tela “Manter” Cancelar, Carta de Correção (CC-e), e-mail, consulta Cancelar, consulta, forçar busca de XML (quando disponível)

Pré-requisitos (antes de clicar em Transmitir)#

Item Onde configurar Por que importa
Certificado A1 válido + senha Configurações do negócio Assina e transmite o XML
Ambiente (homologação / produção) Negócio / local Homologação para teste; produção para nota real
Último número + série (NFe e/ou NFCe) Negócio / local Próximo número = último + 1; desalinhado = rejeição por duplicidade
CSC ID e CSC Negócio / local Obrigatório para NFCe
Natureza de operação coerente Cadastro de naturezas + venda CFOP, finalidade, destacar impostos
Produtos com NCM, CST/CSOSN, origem Cadastro de produtos Maioria das rejeições de item
Cliente com CPF/CNPJ, IE, endereço, contribuinte/consumidor final Contatos Destinatário inválido na SEFAZ
Venda Final (não rascunho/orçamento/suspensa) Vendas / PDV Base do documento fiscal

Fluxo padrão de emissão#

  1. Finalize a venda (direta → NFe; PDV → NFCe).
  2. Na lista de vendas (ou no botão fiscal da linha), clique em Gerar NFe ou Gerar NFCe.
  3. Na tela de emissão, confira local, natureza/cliente (NFe), valor e último número.
  4. Opcional: Visualizar (DANFE) e/ou Gerar XML para inspecionar.
  5. Clique em Transmitir para SEFAZ e aguarde o retorno (protocolo / mensagem de erro).
  6. Se autorizada: Imprimir, Baixar XML, Enviar e-mail (NFe com e-mail no cliente).
  7. Se rejeitada: leia o motivo da SEFAZ, corrija cadastro/venda e reemita conforme o processo (não force número à toa).

Tela Emitir NFe#

Aberta a partir da venda direta quando ainda não há número de NFe. Resume a operação e oferece as ações de geração/transmissão.

Informação / botão O que é / para que serve
Local Filial/estoque emitente (nome e código do local).
Estado Situação fiscal atual da venda/nota no sistema (antes/depois da transmissão).
Último número NFe Referência de numeração: a próxima emissão usará o sequencial configurado (último + 1).
Natureza de operação Natureza da venda (CFOP, finalidade, etc.).
Cliente / CNPJ Destinatário que irá no XML.
Valor (e detalhe de IPI, se houver) Total da operação; IPI pode ser somado na exibição quando aplicável.
Forma de pagamento Resumo do pagamento da venda (grupo de pagamentos da NFe).
Alerta de contingência Se houver contingência ativa de NFe, a tela avisa — emissão pode seguir regras de tpEmis de contingência.
Visualizar Pré-visualiza o DANFE sem necessariamente autorizar.
Gerar XML Monta/baixa o XML assinado ou o arquivo gerado para conferência.
Transmitir para SEFAZ Envia o documento; em sucesso grava número, chave, recibo/protocolo e estado APROVADO (ou trata rejeição/erro).

Tela Manter NFe (pós-autorização)#

Quando a venda já tem numero_nfe, o botão passa a ser Ver NFe.

Campo / botão O que é / para que serve Como usar
Número NFe Número autorizado/emitido. Identificação operacional e fiscal.
Chave Chave de 44 dígitos da NFe. Use em consulta SEFAZ, XML e suporte.
Estado Ex.: APROVADO, CANCELADO (e outros estados de processo/erro no ciclo). Define quais botões fazem sentido (cancelar some se já cancelado).
Flag Contingência Indica que a nota foi emitida em contingência. Regularize/transmita o fluxo de contingência conforme o processo da empresa.
Imprimir DANFE da nota. Entrega ao cliente / arquivo interno.
Baixar XML Download do XML autorizado (ou do arquivo correspondente). Backup, contabilidade, portal do cliente.
Cancelar NFe Evento de cancelamento na SEFAZ. Informe justificativa com no mínimo 15 caracteres. Só dentro do prazo legal e se o estado permitir. Após sucesso, pode imprimir o cancelamento.
Corrigir NFe (CC-e) Carta de Correção Eletrônica. Informe o texto da correção. Não corrige tudo (valores, destinatário em vários casos, etc. — regras da legislação). Após sucesso, imprima a correção se necessário.
Imprimir correção / cancelamento Documentos dos eventos. Aparecem quando há CC-e (sequencia_cce) ou estado cancelado.
Consultar Consulta situação na SEFAZ pela chave/protocolo. Use após dúvida de autorização, timeout ou inconsistência local×SEFAZ.
Enviar e-mail Envia XML/DANFE ao e-mail do cliente. Só aparece se o contato tiver e-mail cadastrado.

NFCe — emitir e manter#

Emitir NFCe#

Campo / botão Para que serve
Local Ponto de venda/emitente da NFCe.
Último número NFCe Referência de numeração do cupom.
Valor Total da venda de PDV.
Gerar XML Gera o XML da NFCe para conferência.
Transmitir para SEFAZ Autoriza o cupom; grava número/chave/estado.

Na lista de vendas PDV: Gerar NFCe aparece se ainda não há número e a venda não está suspensa; depois vira Ver NFCe.

Manter NFCe#

Botão Para que serve
Imprimir DANFCE / cupom para o cliente.
Baixar XML Arquivo XML da NFCe.
Cancelar NFCe Cancelamento com justificativa (mesma disciplina de prazo e texto mínimo da legislação/processo).
Consultar Confere status na SEFAZ.
Forçar busca de XML (quando disponível) Tenta recuperar XML a partir dos dados do banco quando o arquivo se perdeu no storage.

Lista de NFe / NFCe#

Telas de consulta e arquivo por período e local.

Filtro / coluna Para que serve
Data inicial / final Recorte do período das notas.
Localização Filial emitente.
Data, Número, Chave, Recibo, Estado, Valor Identificação e status de cada documento na grade (aprovadas e canceladas em blocos).
Baixar XML / Imprimir (linha) Ações rápidas por nota aprovada ou XML de cancelada.
Download XML Aprovado (ZIP) Pacote de XMLs autorizados do local filtrado.
Download XML Cancelado (ZIP) Pacote de XMLs de notas canceladas do local.
Imprimir (lote / listagem) Impressão consolidada conforme a tela.
Soma total Total dos valores das notas listadas no bloco.

Para pacotes mensais à contabilidade com mais opções (tipos, status, DANFE), use também Exportar XML no manual de Configurações.

Contingência#

Quando a SEFAZ ou a conexão falham, a empresa pode operar em contingência para não parar o faturamento. O Nexus registra o tipo e o documento (NFe ou NFCe) e sinaliza nas telas de emissão/lista.

Ativar contingência#

Campo O que é / para que serve Como preencher
Tipo Modalidade de contingência suportada.
  • SVCRS — SVC-RS
  • SVCAN — SVC-AN
  • OFFLINE — contingência offline (típica de NFCe em vários estados)
A própria tela pode restringir NFe×NFCe conforme o tipo.
Documento NFe ou NFCe. Escolha o tipo de documento que entrará em contingência.
Motivo Justificativa da entrada em contingência. Obrigatório. Texto claro (indisponibilidade SEFAZ, link etc.).

Inutilização de numeração#

Use quando houver “buraco” na sequência (falha de emissão, teste, número pulado) e a legislação exigir inutilizar a faixa perante a SEFAZ.

Campo O que é / para que serve Como preencher
Número de início (nNFIni) Primeiro número da faixa a inutilizar. Obrigatório. Confira na numeração do emitente.
Número de fim (nNFFin) Último número da faixa. Pode ser igual ao início (um único número) ou um intervalo.
Série Série fiscal da numeração. Deve ser a mesma série em que o “buraco” ocorreu.
Modelo 55 = NFe; 65 = NFCe. Escolha o modelo correto da sequência.
Justificativa Motivo enviado à SEFAZ. Texto claro e suficiente (a SEFAZ exige tamanho mínimo em vários casos).

Importação de XML#

Tela de Importação de XML: envia arquivo(s) para preview e consolidação no histórico (legado ou outro emissor), conforme o processo da empresa. Use para escrituração e acervo, não como substituto do fluxo normal de venda + transmitir no dia a dia.

Campo Para que serve
Arquivo para importar XML (ou pacote aceito pela tela) a ser analisado no preview antes de confirmar.

Rejeições da SEFAZ: o que cada código quer dizer#

Quando a transmissão falha, o sistema não devolve o erro cru: ele traduz o retorno em título, explicação e ação, e mantém a mensagem técnica original acessível (recolhida) para quem precisa diagnosticar ou abrir chamado.

Rejeições traduzidas pelo sistema#

CódigoO que o sistema mostraCausa realOnde corrigir
204Nota duplicadaJá existe nota com essa numeração.Confira a numeração antes de reemitir — a nota pode já estar autorizada.
539Nota duplicadaJá existe nota autorizada com essa numeração, mas com chave diferente.Consulte a chave na SEFAZ antes de tentar de novo. Retransmitir em loop piora.
207 / 208CNPJ / CPF do destinatário inválidoDocumento do cliente incorreto.Cadastro do contato.
209Inscrição Estadual inválidaIE inexistente, baixada ou incompatível com a UF.Cadastro do contato — reveja também o indicador de contribuinte.
215 / 225Estrutura da nota inválidaFalha de montagem do XML (schema).Não é dado de cadastro: acione o suporte informando a nota.
610Valores da nota inconsistentesTotal da nota ≠ soma dos itens.Revise itens, descontos e frete da venda.
611 / 630Valores do item inconsistentesQuantidade × valor unitário não fecha com o total do item.Revise a linha do item (casas decimais costumam ser a causa).
778NCM inválidoNCM inexistente na tabela oficial.Cadastro do produto, aba Tributação.
796Período de apuraçãoData/numeração conflita com nota já emitida no período.Confira data de emissão e numeração da série.

Código fora dessa lista aparece como “Nota rejeitada pela SEFAZ” com o motivo oficial (xMotivo) no lugar da explicação. O motivo da SEFAZ é sempre o ponto de partida.

Erros que aparecem antes de chegar à SEFAZ#

O XML é validado localmente contra o schema antes da transmissão. Nesse caso a mensagem não traz código de rejeição:

MensagemO que houveO que fazer
Dados incompletos para emitirCampo obrigatório ausente ou incompleto. O sistema aponta o campo em português (nome/razão social, endereço, cidade, telefone, NCM, etc.).Complete o cadastro indicado — destinatário ou produto — e reemita.
Campo acima do tamanho permitidoUm texto ultrapassou o limite do schema; a mensagem informa o campo e o número máximo de caracteres.Encurte o texto no cadastro. Causa clássica: razão social ou informação complementar longa demais.

Quando o problema é a comunicação, não a nota#

O sistema separa rejeição fiscal de indisponibilidade — a distinção importa porque só a segunda justifica contingência.

SituaçãoComo se apresentaContingência?O que fazer
SEFAZ paralisadaCódigos 108 (paralisado momentaneamente) e 109 (paralisado sem previsão).Sim — a SEFAZ autodeclara indisponibilidade.Siga o procedimento de contingência.
Falha de comunicaçãoConexão resetada, tempo esgotado, recusa de conexão, erro de SSL.Sim, é candidato.Tente de novo em instantes; persistindo, contingência.
DNS / rede do emitente“Não foi possível resolver o endereço da SEFAZ”.Não.O problema é a internet daqui. Verifique a rede antes de qualquer coisa.
Rejeição fiscal (2xx–9xx)Código entre colchetes na mensagem.Não.Corrija o dado e reenvie. Contingência não conserta dado errado.

Estados do documento no sistema#

Situação O que fazer
APROVADO Imprimir, arquivar XML, enviar e-mail se preciso. Venda e fiscal ok.
CANCELADO Baixar/imprimir cancelamento; se ainda precisar faturar, emita nova nota (nova venda ou reprocesso conforme política).
Rejeição SEFAZ (mensagem xMotivo) Leia o código/motivo: cadastro (IE, endereço), NCM, CFOP, CSC, numeração, certificado. Corrija a causa raiz nos manuais de Contatos, Produtos e Configurações.
Timeout / sem retorno Não retransmita em loop. Use Consultar; verifique contingência e status SEFAZ.
Certificado inválido Reenviar A1, senha e validade em Configurações do negócio.

Checklist: primeira nota do dia / da implantação#

Conferência OK?
Ambiente correto (homologação ou produção)☐
Certificado válido☐
Série e último número alinhados☐
CSC configurado (NFCe)☐
Produto e cliente fiscalmente ok☐
Natureza correta na venda☐
Transmitir → APROVADO → imprimir/baixar XML☐
Sem contingência ativa sem necessidade☐

Problemas frequentes#

Sintoma Causa provável O que fazer
Botão “Gerar NFe” não aparece Venda não é direta, ou já tem número; permissão Usar venda direta; se já emitida, usar Ver NFe
Botão “Gerar NFCe” não aparece Venda suspensa, já tem NFCe, ou não é PDV Finalizar/retomar PDV; conferir tipo da venda
Rejeição de destinatário / IE Cliente com contribuinte/IE/endereço errados Corrigir contato (manual Contatos) e reemitir
Rejeição de NCM / CST / CFOP Produto ou natureza inadequados Corrigir produto e natureza; não “forçar” só o XML
Duplicidade de número Último número atrás da SEFAZ / retransmissão Consultar SEFAZ; ajustar numeração; inutilizar se necessário
Cancelamento negado Fora do prazo, justificativa curta, estado inválido Justificativa ≥ 15 caracteres; respeitar prazo legal
CC-e rejeitada Campo não corrigível por CC-e Avaliar cancelamento + nova nota com o contador
E-mail não envia Cliente sem e-mail ou SMTP mal configurado Cadastrar e-mail; conferir Configurações → E-mail
XML sumiu do disco Arquivo apagado ou path incorreto NFCe: forçar busca se existir; NFe: baixar de novo / exportação / backup

Continue por aqui

Configurações Negócio, certificado, CSC, naturezas/CFOP, locais, padrões fiscais e exp... Produtos e Estoque Guia da tela de cadastro: abas, campos, tributação fiscal, preços e esto... Clientes e Fornecedores Cadastro fiscal e operacional: CPF/CNPJ, IE, contribuinte, endereço, gru...