Dashboard¶
Em uma frase. A tela de entrada do NF-e: mostra, num relance, quanto foi emitido no mês, o que está parado esperando ação e quais certificados estão para vencer — e leva direto à tela onde se resolve cada ponto.
Quem usa: analista fiscal, faturamento, supervisor da emissão · Frequência: várias vezes ao dia · Pré-requisitos: empresa cadastrada; para os alertas de certificado, certificado A1 cadastrado em Dados Mestres ▸ Empresas
Para que serve¶
O Dashboard é o ponto de partida do app. Ele não guarda dado próprio e não altera nada: consulta os mesmos números que as telas de Documentos, Painel de Eventos, Gestão de Arquivos e Inutilização usam, e os resume em três perguntas:
- Como foi o mês? — quantas notas saíram e quanto valeram;
- O que precisa de mim agora? — notas rejeitadas, com erro, em processamento, eventos e inutilizações pendentes, arquivos que não entraram;
- Vou conseguir emitir amanhã? — certificado digital vencido ou a vencer.
Cada indicador de operação é clicável e abre a tela em que o problema é tratado.
Como chegar¶
- No Hub, abra o app NF-e.
- Selecione o tile Dashboard.
É a tela padrão do app: abre nela quando nenhum tile é informado, e também quando o tile pedido não existe.
A tela¶
O título é Dashboard, com o subtítulo «Visão geral da emissão e do que precisa de atenção». Os números são carregados uma vez, ao abrir a tela — não há atualização automática. Para ver números novos, saia e volte ao Dashboard.
Enquanto um indicador não chega, ele mostra —. Se uma das consultas falhar, só aquele bloco
fica em —: o restante do painel continua funcionando.
Faixa de alertas de certificado¶
Aparece só quando há o que sinalizar. Considera os certificados ativos das empresas da conta (os cadastrados em Dados Mestres ▸ Empresas, aba Certificado) e mostra no máximo dois, primeiro os vencidos e depois os que vencem antes.
| Situação | Aparência | Texto |
|---|---|---|
| Vencido | Faixa vermelha | «Certificado vencido — |
| Vence em até 30 dias | Faixa amarela | «Certificado a vencer — |
O <nome> é o titular (CN) gravado no próprio certificado, que costuma trazer a razão social.
O botão Gerenciar certificado abre Configurações ▸ Emissão.
Cards do mês¶
Quatro cards no topo, sempre sobre o mês corrente (do dia 1º ao último dia do mês, pela data de emissão da nota):
| Card | O que conta |
|---|---|
| Notas emitidas no mês | Todas as notas emitidas pelo app com emissão no mês, em qualquer situação — autorizadas, rejeitadas, canceladas, em processamento |
| Notas recebidas no mês | Documentos de terceiros (completos e resumos) com emissão no mês — ver a pergunta frequente sobre este card |
| Valor total emitido | Soma do valor total das notas emitidas autorizadas no mês. Canceladas não entram |
| Valor total recebido | Soma do valor dos documentos recebidos no mês — ver a pergunta frequente sobre este card |
Os valores aparecem em reais, sem centavos, no formato do idioma escolhido no Hub.
Operação — requer atenção¶
Oito indicadores, sobre todo o período (sem filtro de data), de todas as empresas da conta. Os que indicam trabalho em aberto pulsam quando são maiores que zero.
| Indicador | O que conta | Clique abre |
|---|---|---|
| Autorizadas | Notas emitidas autorizadas pela SEFAZ | Documentos ▸ Emitidos |
| Em processamento | Notas emitidas ainda no caminho até a SEFAZ: recebida por integração, pendente de validação, validada, XML gerado, XML assinado, enfileirada, enviada à SEFAZ | Documentos ▸ Emitidos |
| Rejeitadas — ação | Notas rejeitadas e denegadas | Documentos ▸ Emitidos |
| Com erro | Erro de processamento e emitente não cadastrado | Documentos ▸ Emitidos |
| Eventos pendentes | Eventos (cancelamento, carta de correção, manifestação…) aguardando retorno, nos últimos 90 dias | Painel de Eventos |
| Eventos rejeitados | Eventos recusados pela SEFAZ, nos últimos 90 dias | Painel de Eventos |
| Arquivos com erro | Arquivos enviados (upload, e-mail, integração) que ficaram inválidos ou com erro de processamento | Gestão de Arquivos |
| Inutilizações pendentes | Pedidos de inutilização ainda sem retorno da SEFAZ | Inutilização por Faixa |
O clique abre a tela de destino sem filtro: o indicador aponta o problema, a lista é que mostra quais notas são.
Distribuição das notas emitidas por status¶
Quatro barras, sobre todo o período: Autorizadas, Em processamento, Rejeitadas / erro (rejeitadas, denegadas e com erro somadas) e Canceladas. O comprimento de cada barra é a proporção sobre a soma dessas quatro, não sobre o total de notas — rascunhos, notas aguardando autorização e numerações inutilizadas não entram no gráfico.
Atalhos rápidos¶
Seis botões: Notas emitidas, Notas recebidas, Painel de eventos, Gestão de arquivos, Inutilização e Configurações (este abre Configurações ▸ Emissão).
Regras de negócio¶
- RN-DSH-001 — O mês é o calendário corrente, pela data de emissão. Os cards do topo usam o dia 1º e o último dia do mês atual, no fuso do navegador. Não há seletor de período.
- RN-DSH-002 — Operação olha tudo, não só o mês. Nota rejeitada em março continua pedindo ação em setembro; por isso os indicadores de operação e a distribuição não têm corte de data.
- RN-DSH-003 — Eventos têm janela de 90 dias. Os dois indicadores de eventos seguem a mesma janela padrão do Painel de Eventos, para os números baterem com a lista que o clique abre.
- RN-DSH-004 — Valor emitido é só o autorizado. Nota rejeitada, cancelada ou em processamento conta em "Notas emitidas no mês", mas não soma em "Valor total emitido".
- RN-DSH-005 — Rejeição inclui denegação. "Rejeitadas — ação" soma rejeitadas e denegadas; "Com erro" soma erro de processamento e emitente não cadastrado.
- RN-DSH-006 — Certificado a vencer é 30 dias ou menos. Vencido é validade anterior ao momento da consulta. Só certificados ativos são considerados; no máximo dois alertas aparecem.
- RN-DSH-007 — Todas as empresas da conta. O Dashboard não filtra por empresa.
O que esta tela não faz¶
- Não filtra por empresa nem por período. Para recortes, use Análise de Documentos ou os filtros das próprias listagens.
- Não se atualiza sozinha. Os números são os do momento em que a tela abriu.
- Não bloqueia a emissão por certificado vencido. O aviso informa a situação; a recusa acontece na comunicação com a SEFAZ, e a troca do certificado é feita em Dados Mestres.
- Não mostra quais notas estão em cada indicador. Isso é papel das listagens que o clique abre.
- Não cadastra nem renova certificado.
Erros e mensagens¶
| Mensagem | Quando aparece | O que fazer |
|---|---|---|
| «Aguardando contexto do Hub…» | A tela abriu antes de o Hub informar a conta | Aguarde; se persistir, recarregue o app pelo Hub |
Indicador com — |
A consulta daquele bloco falhou ou ainda não voltou | Saia e volte ao Dashboard; se persistir, abra a tela de destino para ver o erro |
| «Certificado vencido — … A emissão está bloqueada.» | Certificado ativo com validade expirada | Cadastre o certificado novo em Dados Mestres ▸ Empresas |
| «Certificado a vencer — … vence em N dias» | Faltam 30 dias ou menos | Providencie a renovação antes do vencimento |
Relação com a NF-e / SEFAZ / EFD¶
| Indicador | Relação |
|---|---|
| Autorizadas / Valor total emitido | Notas com autorização de uso concedida pela SEFAZ — as que vão para a escrituração como emissão própria |
| Canceladas | Notas com evento de cancelamento homologado. Continuam escrituradas: na EFD-ICMS/IPI, o C100 de documento cancelado é informado com os campos de identificação e a chave, sem registros filhos [Guia Prático EFD-ICMS/IPI 3.2.3, p. 63] |
| Rejeitadas / Denegadas | Não têm autorização de uso. Denegada deixou de ser de informação obrigatória na EFD desde 01/12/2021 [Guia Prático EFD-ICMS/IPI 3.2.3, p. 63] |
| Inutilizações pendentes | Numeração cujo pedido de inutilização ainda não teve retorno. Enquanto não homologada, a faixa segue como furo de numeração |
Perguntas frequentes¶
Os cards "Notas recebidas no mês" e "Valor total recebido" estão sempre zerados. Por quê?
Na versão atual, esses dois cards consultam o mesmo recorte das notas emitidas e ficam em zero.
Para o número real de documentos recebidos no mês, use Documentos ▸ Recebidos com o filtro de
período, ou a Análise de Documentos filtrando Tipo = Recebida.
"Notas emitidas no mês" é maior que a soma das barras. Está errado? Não. O card conta todas as situações do mês; as barras cobrem todo o período e só quatro grupos de situação (RN-DSH-002 e a seção de distribuição).
Cliquei em "Rejeitadas — ação" e a lista veio com todas as notas. É o comportamento atual: o clique abre a tela sem filtro. Filtre por situação na própria lista.
O alerta de certificado mostra um nome diferente da razão social. O nome vem do titular gravado no certificado, não do cadastro da empresa.
Qual o prazo do alerta de vencimento? Trinta dias ou menos (RN-DSH-006).