Monitoramento de NFS-e
Monitoramento de NFS-e (ERPV2)
A tela “NFS-e – Monitoramento” (Documentos Fiscais Eletrônicos > NFS-e > Monitoramento) mostra, automaticamente, todas as notas fiscais de serviço eletrônicas (NFS-e Nacional) emitidas contra o CNPJ das filiais escolhidas pelo usuário — sem que seja preciso consultar manualmente o portal do governo.
Visão Geral
A tela “NFS-e – Monitoramento” (Documentos Fiscais Eletrônicos > NFS-e > Monitoramento) mostra, automaticamente, todas as notas fiscais de serviço eletrônicas (NFS-e Nacional) emitidas contra o CNPJ das filiais escolhidas pelo usuário — sem que seja preciso consultar manualmente o portal do governo. Um serviço em segundo plano consulta periodicamente o ambiente Nacional da NFS-e e disponibiliza aqui tudo o que foi capturado, tanto notas quanto eventos (como cancelamentos), para consulta, download e envio para a tela de Importação.
Autorização
| Ação | Permissão necessária |
|---|---|
| Acessar a tela / usar todas as ações desta tela | Visualizar (DFeNFSeMonitoramentoMenu) |
Hoje esta tela tem apenas uma permissão registrada — quem tem acesso à tela pode usar todas as suas funções (consultar, baixar arquivos, ativar/desativar monitoramento por filial).
Interface e Comportamentos da Tela
Filiais Monitoradas
No topo da tela, um campo de seleção múltipla mostra quais filiais estão com o monitoramento automático ativo. Marcar uma filial liga o monitoramento para ela; desmarcar desliga — o efeito é imediato, sem precisar salvar em separado.
Duas listagens (abas)
- Aba “NFS-e”: lista as notas capturadas — colunas: Integrado ao ERP?, Status, Filial, NSU, Chave de Acesso, Número da NFS-e, Ambiente, Data/hora de processamento, CNPJ/CPF e Nome do Emitente, Valor, Retenções, Valor Líquido, Código de Tributação Nacional do Serviço (CTribNac), CNBS e Descrição do Serviço.
- Aba “Eventos”: lista eventos vinculados às notas (por exemplo, cancelamentos) — colunas: Filial, NSU, Chave de Acesso, Ambiente, Data/hora de processamento, CNPJ/CPF do Autor do evento, código e descrição do Evento, código e descrição do Motivo.
Filtros
- Filial (múltiplo)
- Tipo de Ambiente (obrigatório): Produção ou Homologação
- Tipo de Data (obrigatório) + Data Inicial/Final (obrigatórios)
- Chave de Acesso (opcional)
- Número da NFS-e (opcional, só na aba NFS-e)
- Integrado ao ERP? (opcional, só na aba NFS-e): indica se já existe, no ERP, um documento de entrada correspondente àquela nota
- Tipo de Evento (opcional, só na aba Eventos)
Seleção e barra de lote
Marcar uma ou mais linhas (em qualquer uma das duas abas) faz aparecer uma barra na parte inferior da tela com a quantidade selecionada e os botões:
- Limpar — desmarca a seleção atual.
- Importar — envia as notas/eventos selecionados diretamente para a tela de Importação de NFS-e.
- Exportar XML — baixa os XMLs selecionados.
- Baixar PDF (DANFSe) — disponível apenas na aba NFS-e; gera o PDF do DANFSe das notas selecionadas.
Campos da Tela
| Campo (como aparece na tela) | Obrigatório | Descrição |
|---|---|---|
| Filiais Monitoradas | Não | Liga/desliga o monitoramento automático para cada filial |
| Filial | Não | Filtro por uma ou mais filiais |
| Tipo de Ambiente | Sim | Produção ou Homologação |
| Tipo de Data / Data Inicial / Data Final | Sim | Período de consulta |
| Chave de Acesso | Não | Localiza uma nota/evento específico |
| Número NFS-e | Não | Localiza pela numeração da nota (aba NFS-e) |
| Integrado ao ERP? | Não | Sim / Não / Todos — se já existe documento correspondente no ERP (aba NFS-e) |
| Tipo de Evento | Não | Filtro por tipo de evento (aba Eventos) |
Regras de Negócio
Só filiais com monitoramento ativo são consultadas
Para cada filial marcada em “Filiais Monitoradas”, o sistema consulta periodicamente (a cada 3 horas) o ambiente Nacional da NFS-e, buscando novos documentos a partir do último ponto em que parou na consulta anterior — nenhuma nota é perdida nem consultada em duplicidade entre execuções. Filiais desmarcadas simplesmente não são consultadas; nenhum dado novo é buscado para elas.
Falha na consulta a uma filial não afeta as demais
Se a consulta ao ambiente Nacional falhar para uma filial (por exemplo, indisponibilidade do serviço do governo), o erro é registrado para consulta técnica, e as demais filiais monitoradas continuam sendo consultadas normalmente na sua própria periodicidade.
Esta tela não substitui a Importação de NFS-e
As notas capturadas pelo monitoramento não entram automaticamente no ERP como documentos — é preciso selecioná-las e usar o botão “Importar” (que leva o lote escolhido para a tela de Importação de NFS-e) para efetivamente gerar o documento de entrada.
Solução de Problemas
Uma filial não aparece recebendo notas novas
Mensagem exibida: Nenhuma — a listagem simplesmente não mostra notas novas daquela filial.
O que fazer: confira se a filial está marcada em “Filiais Monitoradas” no topo da tela; se não estiver, marque-a — a próxima execução do monitoramento (em até 3 horas) passará a capturar as notas dela.
Casos de Uso
Caso 1 — Ativar o monitoramento para uma filial nova
Uma filial começou a receber serviços de terceiros e ainda não estava sendo monitorada. O usuário abre a tela de Monitoramento, marca a nova filial em “Filiais Monitoradas” e aguarda a próxima execução automática (até 3 horas) para que as notas comecem a aparecer na listagem.
Caso 2 — Revisar e importar notas capturadas na semana
O usuário filtra a aba “NFS-e” por período e por “Integrado ao ERP? = Não”, seleciona as notas pendentes e clica em “Importar” — é levado à tela de Importação de NFS-e com o lote já pré-carregado, restando apenas conferir e processar.
Integrações
Consulta diretamente o ambiente Nacional da NFS-e (Governo). Envia lotes selecionados para a tela de Importação de NFS-e.