Exibir código-fonte para CFe - Monitoramento NFC-e (cfe nfce monitor)

{| 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.

O programa '''cfe_nfce_monitor''' faz parte do módulo '''CFe''' e é responsável pelo monitoramento de '''NFC-e.'''
==Dados técnicos==
{| class="wikitable"
|+
!Programa
!cfe_nfce_monitor
|-
|Módulo
|cfe
|-
|Versão
|1.1
|-
|Requisitos de sistema
|N/A
|-
|Integrações
|N/A
|-
|Tabelas
|
* status_sefaz
* sale_nfce
* sale
* store

* pos
|-
|Localização
|../emporium/moderator/html/modules/cfe
|-
|Arquivos
|

* cfe_nfce_monitor.php
*cfe_nfce_monitor_view.php
|}
==Funcionalidades principais==
O programa permite '''monitorar a quantidade de NFC-es que estão em advertência''', ou seja, notas fiscais que apresentam algum tipo de inconsistência operacional, como:

* NFC-es emitidas em contingência;
* NFC-es rejeitadas pela SEFAZ.

A ferramenta possibilita acompanhar os PDVs monitorados, identificar problemas relacionados às NFC-es emitidas e facilitar a análise das notas que necessitam de correção ou reenvio.

Além disso, o sistema permite visualizar informações detalhadas das NFC-es, acompanhar os status de processamento junto à SEFAZ, identificar falhas operacionais por PDV e acessar rapidamente as notas que exigem intervenção operacional.
 '''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 "'''Monitoramento NFCe'''", 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, '''“Monitoramento NFCe”'''.
[[Arquivo:Monitoramento de NFC-e.png|nenhum|miniaturadaimagem|700x700px|Menu Principal do Moderator.]]

'''3.''' Você será redirecionado para a tela abaixo. Nesta tela é possível monitorar todas as notas em advertência.
[[Arquivo:Monitoramento NFCe.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''Monitoramento NFCe.''']]

 Importante: Cada campo disposto na página é responsável por uma etapa do monitoramento e acompanhamento das NFC-es, auxiliando na identificação de inconsistências, análise operacional e tratamento das notas fiscais. Confira mais na seção "'''Visualização (view) v. 1.3'''" abaixo.
===Visualização (view) v. 1.3===
Na parte superior da tela "'''Monitoramento NFC-e'''" existem filtros aplicáveis para busca de PDVs.

'''1.''' O primeiro filtro da esquerda para a direita, "'''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 - Monitoramente NFCe.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''Monitoramento NFCe.''']]

'''2.''' O segundo e último filtro, “'''Dias'''”, permite filtrar as NFC-es em advertência com base no período desejado, podendo selecionar as seguintes opções:

* Hoje;
* Cinco dias;
* Dez dias;
* Quinze dias;
* Trinta dias;
* Sessenta dias;
* Noventa dias;
* Cem dias;
* Cento e vinte dias;
* Todos.

[[Arquivo:Filtro Dias - Monitoramento NFC-e.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''Monitoramento NFCe.''']]
'''3.''' Após selecionar o período desejado no filtro '''“Dias”''', clique no botão '''“Filtrar”.'''

'''3.1.''' Em seguida, será exibida uma tela contendo as lojas disponíveis para acompanhamento das advertências registradas no período filtrado. No quadro da loja, também serão apresentadas informações como o período filtrado e a quantidade de advertências identificadas.
[[Arquivo:Filtro Dias Loja 1.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''Monitoramento NFCe.''']]

'''4.''' Ao clicar no quadro da '''“Loja 1”''', serão exibidos os PDVs vinculados à loja selecionada. No quadro de cada '''PDV''', também serão apresentadas informações como o período filtrado e a quantidade de advertências registradas em cada PDV, conforme imagem abaixo:
[[Arquivo:PDVs Loja 1.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''Monitoramento NFCe.''']]

'''5.''' Após selecionar o PDV que precisa ser monitorado, será exibida a listagem das NFC-es que estão em advertência.

'''5.1.''' Nesta tela, é possível visualizar informações detalhadas das notas fiscais, como:
{| class="wikitable"
!Campo
!Descrição
|-
|Ticket
|Número identificador do cupom emitido
|-
|Número da nota
|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
|}
[[Arquivo:Tela PDV, monitoramento.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''Monitoramento NFCe''' - Loja: 1 PDV: 4 - NFC-e]]

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

* '''Total de notas:''' quantidade total de NFC-es registradas no PDV selecionado.
* '''NFC-es em processamento:''' notas que ainda estão em processo de autorização pela SEFAZ.
* '''NFC-es rejeitadas:''' notas que não foram autorizadas devido a alguma inconsistência e exigem correção.
* '''NFC-es em contingência:''' notas emitidas em modo de contingência quando não foi possível estabelecer comunicação com a SEFAZ.

* '''NFCeBad:''' quantidade de NFC-es que apresentaram falhas durante o processamento e necessitam de análise ou intervenção para regularização.

Também é possível utilizar o campo '''“Pesquisar...”''' para localizar informações específicas dentro da listagem apresentada.
[[Arquivo:Quantitativo monitoramento NFCe.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''Monitoramento NFCe''' - Loja: 1 PDV: 4 - NFC-e]]

'''6.1.''' Ao clicar ou passar o cursor sobre o nome da advertência, como no exemplo da imagem abaixo em '''“Contingência”''', o sistema exibirá uma observação contendo detalhes adicionais sobre o status da NFC-e.

No exemplo da nota '''3470''', a observação apresentada é: '''“Em contingência, mas a venda está cancelada”'''.
[[Arquivo:Observação Advertência.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''Monitoramento NFCe''' - Loja: 1 PDV: 4 - NFC-e]]

'''7.''' Se necessário, também é possível clicar no botão '''“Abrir”''' para visualizar somente a NFC-e em advertência escolhida e identificar mais detalhes sobre a ocorrência da mesma. Ao realizar esta ação, será aberta uma nova janela na tela '''“NFC-e - Notas”''', contendo o detalhamento da NFC-e selecionada.
[[Arquivo:NFCe - Notas - Monitoramento.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''NFCe - Notas'''.]]

'''7.1.''' Em seguida, clique sobre o PDV desejado para que seja exibida a NFC-e relacionada, permitindo selecionar a nota que deseja analisar com mais detalhes, conforme exibido abaixo.
[[Arquivo:Listagem de nota em advertência.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''NFCe - Notas''' - Loja: 1 PDV: 4 - NFC-e]]

 '''Observação''': Esta tela também pode ser acessada a partir do caminho '''CF-e > NFC-e > Notas dentro do Moderator'''. Para mais detalhes sobre a tela “'''NFC-e - Notas'''”, acesse o artigo na Wiki “'''[[CFe – Notas (cfe nfce)]]'''”.
'''8.''' Por fim, ainda na tela de "'''Monitoramento NFC-e'''", ao final da tela é exibida a quantidade de notas que foram filtradas.
[[Arquivo:Total de notas.png|nenhum|miniaturadaimagem|700x700px|Tela Principal de '''Monitoramento NFCe''' - Loja: 1 PDV: 4 - NFC-e]]

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

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