CFe – Notas (cfe nfce)

De Conecto wiki
Ir para navegação Ir para pesquisar
Conteúdo em construção.

Este artigo faz parte de uma série dedicada ao Moderator, abordando as diversas funcionalidades e programas disponíveis em suas telas. Cada artigo tem como objetivo fornecer uma visão geral detalhada das operações, características e fluxos de trabalho de cada componente, facilitando o entendimento e a utilização do sistema.

O programa cfe_nfce faz parte do módulo CFe e é responsável pelo gerenciamento, acompanhamento, emissão e edição NFC-e.

Dados técnicos

Programa cfe_nfce
Módulo cfe
Versão 1.5
Requisitos de sistema N/A
Integrações N/A
Tabelas
  • status_sefaz
  • sale_nfce
  • sale
  • store
  • pos
  • store_group
  • answer_data
  • store_data
  • globals
  • parameter
  • customer
  • customer_sku
  • customer_address
  • sale_item
  • sale_item_nozzle
  • sale_item_service
  • sku
  • tax_type
  • class_trib_ibs_cbs
  • plu
  • unit
  • plu_store
  • gas_station_tax_anp
  • gas_station_tax_anp_import
  • sale_media
  • entity
  • sale_media_data
  • nfce_reconciliation_control
Localização ../emporium/moderator/html/modules/cfe
Arquivos
  • cfe_nfce.php
  • cfe_nfce_view.php
  • cfe_resend_nfce.php

Funcionalidades principais

O programa permite acompanhar os PDVs monitorados em tempo real, oferecendo uma visão completa sobre o processo de emissão de NFC-e e o desempenho operacional das vendas realizadas. A tela do CF-e realiza a análise das NFC-e emitidas conforme o período filtrado, identificando notas rejeitadas com base nas Regras de Validação definidas pela NT 2021.003, além de detectar notas emitidas em contingência e acompanhar o status de comunicação com a SEFAZ (Secretaria da Fazenda) em tempo real.

O programa também identifica as notas emitidas sem intercorrências, permitindo calcular o índice geral de sucesso das emissões, bem como os percentuais de rejeições, contingências, alertas e demais inconsistências encontradas durante o processo. Todas as informações referentes às compras finalizadas nos PDVs monitorados são consolidadas para análise operacional e fiscal.

Além disso, a solução analisa problemas críticos relacionados ao processo de emissão de NFC-e, emitindo alertas e avisos sobre possíveis falhas ou ocorrências identificadas. Com isso, o sistema auxilia no acompanhamento, correção e controle das operações fiscais, proporcionando maior agilidade na identificação e resolução de intercorrências, contribuindo para um fluxo operacional mais seguro, eficiente e contínuo.

A NT 2021.003 é uma Nota Técnica publicada pela SEFAZ que estabelece novas regras de validação para a emissão de NFC-e e NF-e. Seu objetivo é ampliar o controle fiscal sobre as operações comerciais, validando informações da nota fiscal durante o processo de autorização e reduzindo inconsistências nas emissões.

Cenários para correção de notas

Quando uma nota fiscal é emitida em contingência, ela permanece pendente de transmissão para a SEFAZ até que as inconsistências identificadas sejam corrigidas. Após os ajustes necessários, o XML deve ser reenviado para processamento e autorização.

A seguir, são apresentados alguns dos cenários mais comuns de intercorrências que podem impedir a aceitação do XML pela SEFAZ, exigindo correção do XML antes do reenvio da nota:

  • Produto sem NCM: o código NCM (Nomenclatura Comum do Mercosul) é obrigatório para a identificação fiscal dos produtos. A ausência dessa informação impede a validação da nota fiscal.
  • CFOP incompatível com a operação: o CFOP (Código Fiscal de Operações e Prestações) deve estar de acordo com o tipo de operação realizada, como venda, devolução, transferência ou remessa. Utilizar um CFOP incorreto pode gerar rejeição da nota.
  • Total da nota diferente da soma dos produtos: o valor total da NFC-e deve corresponder exatamente à soma dos itens, acrescida ou descontada de frete, descontos, acréscimos e demais valores fiscais. Divergências nos cálculos impedem a autorização.
  • EAN inválido: o código de barras (EAN/GTIN) informado no produto deve possuir estrutura válida e estar em conformidade com os padrões cadastrados. Informações inconsistentes podem causar rejeição.
  • CST/CSOSN incompatível com o regime tributário: o CST ou CSOSN deve ser compatível com o regime tributário da empresa emitente, como Simples Nacional, Lucro Presumido ou Lucro Real. Configurações incorretas impactam diretamente a validação fiscal.
  • Falha de schema XML: ocorre quando a estrutura do XML está fora do padrão definido pela SEFAZ, como tags inválidas, informações ausentes ou formatação incorreta.
  • Produto sem estoque com venda autorizada: algumas empresas utilizam validações de estoque integradas ao sistema. Quando um produto está sem saldo disponível, a emissão pode ser bloqueada ou sinalizada para correção antes do envio.
  • Pagamento incompatível: as informações de pagamento devem ser coerentes com o valor total da nota e com o tipo de operação realizada. Inconsistências entre formas de pagamento, parcelas ou valores podem resultar em rejeição.
  • Duplicidade de NFC-e: acontece quando uma nota fiscal é transmitida mais de uma vez utilizando a mesma numeração, série ou chave de acesso já existente na base da SEFAZ.
Importante: O acesso ao Módulo CFe do Moderator é limitado aos usuários com perfil administrador e à equipe de Suporte responsável.

Guia do usuário

Acesso ao programa

Siga o passo a passo abaixo para acessar o programa dentro do Moderator.

1. Para acessar a aba "Notas", clique no ícone de Menu Principal, disponível no canto superior esquerdo.

Menu Principal do Moderator.

2. Em seguida, selecione a opção “CFe”, depois “NFC-e” e, por fim, “Notas”.

Menu Principal do Moderator.

3. Você será redirecionado para a tela abaixo. Nesta tela é possível acompanhar todo processo de operação da NFC-e.

Tela Principal de Notas.
Importante: Cada campo disposto na página é responsável por uma etapa do acompanhamento das NFC-e e deve seguir uma diretriz específica. Confira mais na seção "Visualização (view) v. 1.46" abaixo.

Visualização (view) v. 1.51

Na parte superior da tela "NFCe - Notas" existem filtros aplicáveis para busca de PDVs:

1. O primeiro filtro da esquerda para a direita, "Loja", permite filtrar entre uma loja específica ou todas disponíveis.

Tela Principal de NFCe - Notas.

2. O segundo, "PDV", permite filtrar entre PDVs específicos ou todos disponíveis.

Tela Principal de NFCe - Notas.

3. O terceiro, "Status", permite definir a situação da NFC-e, podendo ser:

  • Emitida: exibe NFC-es autorizadas com sucesso pela SEFAZ;
  • Em processamento: exibe NFC-es que ainda estão aguardando retorno ou processamento pela SEFAZ;
  • Rejeitada: exibe NFC-es recusadas pela SEFAZ devido a inconsistências ou erros de validação;
  • Cancelada: exibe NFC-es que foram canceladas após a emissão;
  • Inutilizada: exibe numerações de NFC-es inutilizadas pelo sistema ou pela SEFAZ;
  • Em contingência: exibe NFC-es emitidas em modo de contingência devido à indisponibilidade de comunicação com a SEFAZ;
  • Advertência: exibe NFC-es que receberam alertas ou advertências durante o processo de autorização.
Tela Principal de NFCe - Notas.

4. O quarto, "Origem Aut.", permite filtrar a origem da autorização da NFC-e pelas seguintes opções:

  • Todos: exibe NFC-es autorizadas por qualquer origem disponível no sistema;
  • PDV: exibe NFC-es autorizadas diretamente pelo PDV;
  • Painel: exibe NFC-es autorizadas por meio do painel de controle;
  • Sonda: exibe NFC-es autorizadas pelo serviço de monitoramento e comunicação da aplicação;
  • Script: exibe NFC-es autorizadas por rotinas automatizadas ou scripts do sistema.
Tela Principal de NFCe - Notas.

5. O quinto filtro, “Condições”, permite definir condições específicas da NFC-e, podendo ser:

  • Sem protocolo: exibe NFC-es que ainda não possuem protocolo de autorização retornado pela SEFAZ;
  • Cancelamento por Substituição: exibe NFC-es canceladas em função da emissão de uma nota substituta;
  • Nota substituta: exibe NFC-es emitidas como substituição de outra nota;
  • CS e nota substituta: exibe NFC-es que possuem cancelamento por substituição e também uma nota substituta vinculada.
Tela Principal de NFCe - Notas.

6. O sexto filtro, "Status Sefaz", permite filtrar a situação da NFC-e junto à SEFAZ.

Tela Principal de NFCe - Notas.

7. Os filtros seguintes, "Data inicial" e "Data final", permitem filtrar as vendas por um intervalo de datas.

Tela Principal de NFCe - Notas.

8. O último, "Refresh", permite recarregar automaticamente a página nos seguintes intervalos:

  • Quinze segundos;
  • Trinta segundos;
  • Um minuto;
  • Um minuto e meio;
  • Dois minutos.
Tela Principal de NFCe - Notas.

9. Além dos filtros principais localizados na parte superior da tela, também é possível visualizar os indicadores disponíveis na parte inferior. Após aplicar um filtro de período das compras finalizadas, o sistema apresentará o "Resumo Operacional NFC-e", contendo as seguintes informações:

Campo Descrição
PDVs monitorados Quantidade de PDVs acompanhados pelo sistema
NFC-e no período Total de NFC-es emitidas no intervalo selecionado
Rejeitadas Quantidade de NFC-es rejeitadas pela SEFAZ
Contingência Quantidade de NFC-es emitidas em modo de contingência
Sucesso geral Percentual ou total de NFC-es autorizadas com sucesso
Problemas críticos Quantidade de ocorrências consideradas críticas pelo sistema
Alertas e avisos Notificações e advertências identificadas durante o monitoramento das NFC-es
Tela Principal de NFCe - Notas.

10. Logo abaixo do resumo operacional, também estão disponíveis atalhos rápidos para análise operacional:

Atalhos Descrição
Ver apenas problemas Exibe somente ocorrências com falhas ou inconsistências
Foco rejeitadas/contingência Destaca NFC-es rejeitadas ou emitidas em contingência
Próximo erro Direciona para a próxima ocorrência identificada
Modo operador Altera a visualização para um modo simplificado de acompanhamento operacional
Tela Principal de NFCe - Notas.

11. Na parte inferior da tela, abaixo do "Resumo Operacional NFC-e", também é exibido um quadro resumido apresentando as lojas monitoradas pelo sistema, contendo informações como:

  • Quantidade total de NFC-es;
  • Quantidade de emissões com sucesso;
  • Percentual de sucesso;
  • Quantidade de advertências;
  • Percentual de falhas ou rejeições identificadas no período.
Tela Principal de NFCe - Notas.

12. Ao clicar na Loja 1, o sistema aplicará automaticamente o filtro da loja selecionada e apresentará os PDVs relacionados a ela, conforme imagem:

Tela Principal de NFCe - Notas.

13. Em seguida, ao clicar sobre um dos PDVs disponíveis, será exibida uma nova tela contendo o PDV selecionado e o detalhamento das NFC-es vinculadas a ele. Nesta tela, é possível visualizar informações detalhadas das notas fiscais, como:

Campo Descrição
Cupom Número identificador do cupom emitido
Número Número de registro da nota fiscal
Data Data e horário de conclusão da venda
Data de emissão Data e horário de emissão do cupom fiscal
Chave Chave de acesso da NFC-e
Protocolo Número do protocolo de autorização da NFC-e
Status da NFC-e Situação da autorização da nota junto à SEFAZ
Valor Valor total final da venda
Origem da autorização Origem da autorização da NFC-e
Tela Principal de NFCe - Notas - Loja: 1 PDV: 4 - NFC-e

14. Além disso, na parte superior da tela, o sistema apresenta um resumo quantitativo das NFC-es do PDV selecionado, incluindo:

  • Total de notas;
  • Emitidas;
  • Em processamento;
  • Rejeitadas;
  • Canceladas;
  • Inutilizadas;
  • Em contingência;
  • Inutilizar (essa ação oficializa que uma determinada faixa ou número específico de nota não será mais utilizado);
  • NFCeBad (utilizado para armazenar arquivos de erro ou rejeição de NFC-e, como logs e registros de falhas no processo de autorização ou transmissão).

Também é possível utilizar o campo “Pesquisar...” para localizar informações específicas dentro da listagem apresentada.

Tela Principal de NFCe - Notas - Loja: 1 PDV: 4 - NFC-e

Reenvio da NFC-e (resend) v. 1.45

Na listagem das NFC-es, o sistema disponibiliza, na última coluna, um botão correspondente ao status da nota fiscal, como “Emitidas”, “Canceladas”, "Contingência", entre outros.

1. Ao clicar neste botão, será exibido um menu de ações relacionadas à NFC-e selecionada, permitindo executar as seguintes operações:

  • Detalhes da nota: exibe as informações completas da NFC-e;
  • Consultar Chave: realiza a consulta da chave da NFC-e junto à SEFAZ;
  • Visualizar XML: permite visualizar o XML da NFC-e;
  • Validar Schema: realiza a validação estrutural do XML conforme o schema da SEFAZ;
  • Editar XML: permite editar o conteúdo do XML da NFC-e;
  • Baixar XML: realiza o download do arquivo XML da NFC-e;
  • Prazo de cancelamento expirado: informa que a NFC-e não pode mais ser cancelada devido ao prazo permitido pela SEFAZ ter sido excedido.
Tela Principal de NFCe - Notas - Loja: 1 PDV: 4 - NFC-e

2. Estes botões de edição são importantes, pois permitem editar NFC-es que ainda não foram autorizadas pela SEFAZ, possibilitando acessar o XML da nota para corrigir possíveis inconformidades.

2.1. Abaixo, filtramos e exibimos as NFC-es com status “Contingência”.

Tela Principal de NFCe - Notas - Loja: 1 PDV: 4 - NFC-e

2.2. Diferente do status “Emitida”, exibido anteriormente, nesta tela também é disponibilizada a opção “Reenviar Nota”. Após realizar as correções necessárias na NFC-e, essa opção permite submeter novamente o documento à SEFAZ, iniciando uma nova tentativa de validação e autorização da nota. O reenvio deve ser realizado após a correção da inconsistência que impediu o processamento ou a autorização anterior da NFC-e. Durante o processo, o XML atualizado é transmitido novamente para a SEFAZ, que realiza as validações aplicáveis e retorna o resultado do processamento ao sistema.

Obs.: Só é possível editar o XML de notas em contingência e rejeitadas.

2.3. Conforme exibido abaixo, o filtro “Rejeitadas” foi aplicado na pesquisa. Em seguida, ao selecionar a NFC-e com status “Rejeitada”, destacada em vermelho, a opção “Editar XML” será habilitada para seleção.

Tela Principal de NFCe - Notas - Loja: 1 PDV: 4 - NFC-e

3. Após clicar em “Editar XML”, será exibida a tela de edição contendo os parâmetros do XML da NFC-e.

3.1. Identifique a inconsistência apresentada na nota, realize as correções necessárias no XML e clique em “Gravar alterações” para salvar as modificações.

Obs.: Consulte, neste mesmo documento, o tópico “Cenários para correção de notas”, onde são apresentadas algumas das principais inconsistências identificadas em NFC-e. Para localizar as tags e realizar as correções necessárias no XML da nota, consulte também o artigo DICIONÁRIO XML EMPORIUM.
Tela Principal de NFCe - Notas - Editar XML NFCe

4. Após gravar as correções realizadas no XML da nota, clique na opção “Reenviar Nota” para realizar uma nova tentativa de envio da NFC-e à SEFAZ.

Ao executar o reenvio, o XML atualizado será submetido novamente aos serviços da SEFAZ para validação e processamento. A partir do retorno obtido, a NFC-e poderá ser autorizada ou rejeitada novamente.

Em caso de autorização, o processamento da NFC-e será concluído e seu status será atualizado no sistema conforme o retorno da SEFAZ. Caso a nota seja rejeitada novamente, será necessário analisar a mensagem de rejeição apresentada, identificar a inconsistência e, quando aplicável, realizar uma nova correção no XML antes de efetuar outro reenvio.

Tela Principal de NFCe - Notas - Loja: 1 PDV: 4 - NFC-e

Ver também