Thmartins: Criação da Categoria: CF-e (cfe).

2026-09-25T12:34:11Z

Criação da Categoria: CF-e (cfe).

← Edição anterior		Edição das 12h34min de 25 de setembro de 2026
Linha 306:		Linha 306:
	*[[CFe - Monitoramento NFC-e (cfe nfce monitor)]]		*[[CFe - Monitoramento NFC-e (cfe nfce monitor)]]
	*[[CFe - Parâmetros CFe (cfe param)]]		*[[CFe - Parâmetros CFe (cfe param)]]

			[[Categoria: CF-e (cfe)]]

Chenrique: /* Ver também */

2026-09-23T19:19:40Z

Ver também

← Edição anterior		Edição das 19h19min de 23 de setembro de 2026
Linha 303:		Linha 303:

	== Ver também==		== Ver também==
			*[[CFe – Validação de ambiente (cfe nfce validate setup)]]
			*[[CFe - Monitoramento NFC-e (cfe nfce monitor)]]
			*[[CFe - Parâmetros CFe (cfe param)]]

Chenrique em 18h01min de 23 de setembro de 2026

2026-09-23T18:01:45Z

← Edição anterior		Edição das 18h01min de 23 de setembro de 2026
Linha 1:		Linha 1:
			{\| align="left" style="width: 100%;"
			\|-
			\| [[Arquivo: Logo Conecto Wiki Oficial.png\|esquerda\|700x700px\|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.		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.

Chenrique: Criação de interlink

2026-09-23T18:00:54Z

Criação de interlink

Página nova

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==
{| class="wikitable"
|+
!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.[[Arquivo:Menu Principal Emporium.png|nenhum|miniaturadaimagem|700x700px|Menu Principal do Moderator.|ligação=https://nunki.conecto.com.br/mediawiki/index.php/Arquivo:Menu_Principal_Emporium.png]]'''2.''' Em seguida, selecione a opção '''“CFe”''', depois '''“NFC-e”''' e, por fim, '''“Notas”'''.
[[Arquivo:Moderator Notas CFe.png|nenhum|miniaturadaimagem|700x700px|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.
[[Arquivo:Moderator tela de Notas.png|nenhum|miniaturadaimagem|700x700px|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.
[[Arquivo:Filtro loja CFe.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''NFCe - Notas.''']]

'''2.''' O segundo, "'''PDV'''", permite '''filtrar''' entre PDVs específicos ou todos disponíveis.
[[Arquivo:Filtro PDV CFe.png|nenhum|miniaturadaimagem|700x700px|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.
[[Arquivo:Filtro Status CFe.png|nenhum|miniaturadaimagem|700x700px|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.
[[Arquivo:Filtro Origem Aut. CFe.png|nenhum|miniaturadaimagem|700x700px|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.
[[Arquivo:Filtro Condições CFe.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''NFCe - Notas.''']]

'''6.''' O sexto filtro, "'''Status Sefaz'''", permite filtrar a situação da NFC-e junto à SEFAZ.
[[Arquivo:Filtro Status Sefaz CFe.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''NFCe - Notas.''']]

'''7.''' Os filtros seguintes, "'''Data inicial'''" e "'''Data final'''", permitem filtrar as vendas por um intervalo de datas.
[[Arquivo:Filtro por Datas CFe.png|nenhum|miniaturadaimagem|700x700px|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.
[[Arquivo:Filtro Refresh CFe.png|nenhum|miniaturadaimagem|700x700px|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:
{| class="wikitable"
|+
!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
|}
[[Arquivo:Resumo Operacional NFC-e - CFe.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''NFCe - Notas.''']]

'''10.''' Logo abaixo do resumo operacional, também estão disponíveis atalhos rápidos para análise operacional:
{| class="wikitable"
|+
! 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
|}
[[Arquivo:Atalho CFe.png|nenhum|miniaturadaimagem|700x700px|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.

[[Arquivo:Resumo Loja.png|nenhum|miniaturadaimagem|700x700px|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:
[[Arquivo:Filtro de Loja 1.png|nenhum|miniaturadaimagem|700x700px|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:
{| class="wikitable"
!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
|}
[[Arquivo:Filtro PDV 4.png|nenhum|miniaturadaimagem|700x700px|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.
[[Arquivo:Filtro PDV 2.png|nenhum|miniaturadaimagem|700x700px|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.

[[Arquivo:Acompanhamento de NFC-e.png|nenhum|miniaturadaimagem|700x700px|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”'''.
[[Arquivo:Filtro Contingência.png|nenhum|miniaturadaimagem|700x700px|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.
[[Arquivo:Editar XML.png|nenhum|miniaturadaimagem|700x700px|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|DICIONÁRIO XML EMPORIUM.]]
[[Arquivo:Editar XML NFCe.png|nenhum|miniaturadaimagem|700x700px|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.
[[Arquivo:Reenviar nota.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''NFCe - Notas -''' Loja: 1 PDV: 4 - NFC-e]]

== Ver também==

CFe – Notas (cfe nfce) - Histórico de revisão

Thmartins: Criação da Categoria: CF-e (cfe).

Chenrique: /* Ver também */

Chenrique em 18h01min de 23 de setembro de 2026

Chenrique: Criação de interlink