Painel de Eventos¶
Em uma frase. O histórico de todos os eventos fiscais das NF-e da conta — do emitente, do destinatário e da sucessora — e o assistente para registrar eventos numa nota, em várias notas de uma vez ou por chave de acesso.
Quem usa: analista fiscal, recebimento fiscal, apuração IBS/CBS · Frequência: diária · Pré-requisitos: empresa com certificado digital ativo; notas Autorizadas (eventos do emitente) ou chaves de acesso de terceiros (eventos do destinatário)
Para que serve¶
Evento é tudo o que acontece com uma NF-e depois da autorização e fica registrado na SEFAZ vinculado à chave de acesso: cancelamento, carta de correção, manifestação do destinatário e os eventos da Reforma Tributária (IBS/CBS/IS). Cada nota mostra os próprios eventos no detalhe; este painel junta os de todas as notas numa lista só, com autoria (manual, em massa, SEFAZ, integração, upload), retorno da SEFAZ e XMLs.
Três famílias de eventos passam por aqui:
| Família | Códigos | Autor |
|---|---|---|
| Clássicos | 110111 Cancelamento · 110110 Carta de Correção | Emitente |
| Manifestação do destinatário | 210200 Confirmação · 210210 Ciência · 210220 Desconhecimento · 210240 Operação não Realizada | Destinatário |
| Reforma Tributária (IBS/CBS/IS) | 112110–112150 (emitente) · 211110–211150 (destinatário) · 212110/212120 (sucessora) · 412120/412130 (Fisco, só recebidos) · 110001 (cancelamento de evento) | Conforme o evento |
Como chegar¶
- No Hub, abra o app NF-e.
- Selecione Painel de Eventos.
O assistente Novo evento também abre a partir de Documentos ▸ Emitidos (raio da linha, Ações em massa ▸ Criar eventos / Cancelar documentos) e da aba Eventos do detalhe da nota — nesses casos já com as notas e, às vezes, o evento escolhidos.
A tela de listagem¶
Título Painel de Eventos; botão Novo evento no cabeçalho.
Cards¶
| Card | Conteúdo | Clique |
|---|---|---|
| Todos | Eventos que atendem aos filtros | Mostra todos |
| Registrados | Aceitos pela SEFAZ | Filtra Registrado |
| Eventos pendentes | Enviados e sem desfecho | Filtra Pendente |
| Rejeitados — aguardando ação | Recusados pela SEFAZ | Filtra Rejeitado |
| Operações ativas | Operações em massa em andamento da conta toda (não segue filtro) | Abre a aba Operações em massa |
Os quatro primeiros seguem os mesmos filtros da lista (empresa, período, avançados); só a situação é o agrupamento dos cards.
Abas¶
- Histórico de eventos — a lista (padrão).
- Operações em massa — as operações disparadas em segundo plano.
Filtros do histórico¶
| Filtro | Onde | Regra |
|---|---|---|
| Empresa | Barra | Uma ou todas |
| De / Até | Barra | Data de registro do evento no sistema; padrão hoje |
| Eventos | Mais filtros | Chips agrupados em Clássicos, Manifestação do destinatário e Reforma Tributária (IBS/CBS/IS); vários |
| Ambiente | Mais filtros | Produção · Homologação |
| Papel | Mais filtros | Emitente · Destinatário |
| Origem do disparo | Mais filtros | Manual · Em massa · SEFAZ (automático) · Upload · Integração |
| Sequência (nSeqEvento) | Mais filtros | Número exato |
| Chave de acesso | Mais filtros | Várias; só contam as de 44 dígitos |
Barra: Atualizar reaplica os filtros e recarrega lista e cards. Os filtros avançados viram etiquetas removíveis.
O que a lista mostra¶
| Coluna | Conteúdo | Ordenável |
|---|---|---|
| Data | DD/MM/AA HH:mm |
sim |
| Evento | Código e descrição | sim |
| Papel | Emitente, Destinatário, Sucessora, Fisco | não |
| Nota | Série/número (extraídos da chave) | não |
| Chave | Chave com botão de copiar | não |
| Seq | nSeqEvento | sim |
| Status | Registrado / Pendente / Rejeitado, com cStat; motivo no tooltip | sim |
| Protocolo | Protocolo da SEFAZ | não |
| Origem | Origem do disparo | não |
| Ambiente | Produção / Homologação | não |
Ordenação padrão: data mais recente primeiro. No fim da linha, o ícone Ver nota de origem abre o detalhe da nota (quando ela está na base); Voltar retorna ao painel com os filtros preservados.
Seleção e exportação¶
A caixa da linha marca o evento; a do cabeçalho, a página. Com eventos marcados: Exportar selecionados (XML do evento, PDF, XML da nota, DANFE, Excel — o mesmo Exportar documentos das notas) e Limpar seleção. A exportação abre o Centro de Tarefas (botão de lista na barra da grade), que é o mesmo das notas emitidas.
Exporte uma página por vez. A seleção fica marcada ao trocar de página, mas a exportação leva só os eventos marcados na página exibida.
Novo evento — o assistente¶
Quatro passos: escolha o evento → selecione os alvos → dados do evento → conferência e envio. Uma faixa fixa no topo mostra o evento escolhido, o papel, se é em massa ou individual — itens, o prazo e a quantidade de alvos.
Passo 1 — evento¶
Eventos agrupados por papel (Emitente, Destinatário, Sucessora). Só aparecem os habilitados na conta e que o sistema pode emitir. Cada um mostra o prazo, o limite por nota («máx. N por nota» ou «cumulativo») e se aceita chave avulsa ou exige valores por item.
Passo 2 — alvos¶
| Modo | Quando | Como funciona |
|---|---|---|
| Notas da base | Eventos do emitente e eventos com itens | Grade de notas elegíveis ao evento, filtrada por emissão de/até e Mais filtros (número, série, CNPJ do destinatário, CNPJ do emitente, empresa, chaves). Busca só no Atualizar. mostrar inelegíveis exibe as recusadas com o motivo. Selecionar todas as N do filtro vale para todo o resultado |
| Colar chaves | Eventos que aceitam chave avulsa (destinatário, sucessora) | Escolha a Empresa (autora do evento), cole as chaves e Validar chaves: cada uma volta válida ou inválida com motivo, e as válidas fora da base aparecem como «fora da base» |
Evento com itens aceita uma nota. Com alvos vindos da listagem de notas, este passo não aparece.
Passo 3 — dados¶
| Evento | Campo | Regra |
|---|---|---|
| 110111 Cancelamento | Justificativa (aplicada a todas) | 15 a 255 caracteres |
| 110110 Carta de Correção | Texto da correção | 15 a 1.000 caracteres; o mesmo texto para todas as notas |
| 210240 Operação não Realizada | Justificativa | 15 a 255 caracteres |
| 210200 · 210210 · 210220 | — | Sem dados adicionais |
| 112110 Pagamento integral | Quitação integral | Valor fixo «Sim» |
| 112150 Previsão de entrega | Nova data de previsão | Data |
| 211128 Aceite de débito | Aceite / Não aceite | |
| 212110 · 212120 Transferência de crédito | Aceita / Não aceita | |
| Eventos com itens (112120, 112130, 112140, 211110, 211124, 211130, 211140, 211150) | Itens da nota | Marque os itens e informe os valores. O sistema sugere os valores da nota e não aceita valor acima do da nota (IBS, CBS, quantidade) |
Passo 4 — conferência e envio¶
Lista os alvos (ou «Todas as N notas do filtro aplicado»), os dados informados e os itens. O aviso lembra que, ao confirmar, o evento é transmitido imediatamente.
No cancelamento, duas travas a mais: marcar Estou ciente de que o cancelamento é irreversível perante a SEFAZ e digitar CANCELAR. O botão diz quantas notas serão canceladas.
Resultado:
- Evento com itens — envio na hora; a janela mostra «Evento N registrado/rejeitado — cStat …».
- Demais — cria uma operação em massa e mostra Operação disparada: quantos alvos foram enfileirados e a lista dos ignorados na pré-validação, com o motivo. Acompanhar operação leva à aba Operações em massa.
Sub-telas¶
Detalhe do evento¶
Painel lateral com código e descrição, situação e cStat, papel, destino e ambiente. Traz nota (com Ver nota), sequência, chave (copiar sem formatação), data, protocolo, Retorno SEFAZ, Autoria (origem, usuário, operação em massa, tentativa) e o Detalhe do evento (detEvento).
Documentos: XML ▸ XML do Evento e XML Autorizado (da nota); PDF ▸ PDF do Evento (só Carta de Correção registrada) e DANFE (PDF) — os de PDF só com a nota na base.
Cancelar evento (110001) — para evento da Reforma Tributária Registrado, com protocolo e nota na base: pede confirmação e envia o cancelamento do evento na hora.
Operações em massa¶
Tabela com operação, situação, progresso (processados/total), resultado (ok, falhas, ignoradas) e
data; atualiza sozinha enquanto houver operação ativa. O clique abre o resultado por alvo
(Pendente, Processado, Falha, Ignorado, com o motivo) e, havendo falhas numa operação concluída,
Reexecutar N falhas.
Regras de negócio¶
- RN-EVT-001 — Evento do emitente exige nota Autorizada. Manifestação vale também para documento recebido (completo ou resumo); eventos da Reforma do destinatário e da sucessora exigem documento Autorizado ou Recebido com XML completo.
- RN-EVT-002 — Limite de sequência por nota: cancelamento 1, carta de correção 20, manifestação 2 (Ciência 1), Reforma Tributária 1 — exceto 112150 (previsão de entrega), cumulativo.
- RN-EVT-003 — Prazos padrão: Confirmação, Desconhecimento e Operação não Realizada 90 dias; Ciência 10 dias; cancelamento, carta de correção e Reforma sem prazo definido no sistema. O prazo pode ser sobrescrito por conta.
- RN-EVT-004 — Cancelamento e carta de correção fora do prazo não são bloqueados. A SEFAZ aceita ou recusa.
- RN-EVT-005 — Envio em massa é um evento por requisição. "Em massa" é uma fila de envios individuais, acompanhada na aba Operações em massa.
- RN-EVT-006 — Eventos com itens são individuais: uma nota por disparo, envio imediato, valores limitados aos da nota.
- RN-EVT-007 — Chave avulsa só em evento que a aceita (destinatário e sucessora); o autor é a empresa escolhida no passo 2.
- RN-EVT-008 — Eventos do Fisco (412120, 412130) só são recebidos, nunca emitidos.
- RN-EVT-009 — Cancelamento de evento (110001) só para evento da Reforma Tributária. Não cancela cancelamento, carta de correção nem manifestação.
- RN-EVT-010 — Cancelamento em massa exige ciência explícita e a palavra CANCELAR.
- RN-EVT-011 — Até 2.000 alvos por operação em massa.
O que esta tela não faz¶
- Não inutiliza numeração. Inutilização não é evento de nota; fica em Inutilização por Faixa.
- Não mostra os eventos no detalhe de cada nota — isso é a aba Eventos do detalhe; aqui é a visão consolidada.
- Não aplica evento com itens em massa.
- Não edita nem apaga evento registrado. Corrige-se com novo evento (nova sequência) ou cancelamento de evento, quando o leiaute permite.
- Não altera prazos e habilitação de eventos nesta tela.
Erros e mensagens¶
| Mensagem | Quando aparece | O que fazer |
|---|---|---|
| «Erro ao carregar o histórico de eventos.» | Falha na busca | Atualizar |
| «Selecione ao menos uma nota.» / «Selecione a nota.» | Avançou sem alvo | Busque e marque as notas |
| «Informe ao menos uma chave de acesso.» / «Nenhuma chave válida para prosseguir.» | Modo chaves sem chave válida | Cole chaves de 44 dígitos e valide |
| «Selecione a empresa (autora do evento).» | Modo chaves sem empresa | Escolha a empresa |
| «Campo obrigatório: …» / «…: mínimo N caracteres» | Dados incompletos | Complete o campo |
| «Selecione ao menos um item da nota.» / «Item N: "…" não pode exceder X (valor da nota).» | Evento com itens | Marque itens e respeite os valores da nota |
| «Confirme que está ciente da irreversibilidade.» / «Digite CANCELAR para liberar o envio.» | Cancelamento sem as travas | Marque e digite |
| «Limite de sequência atingido para … (máx. N, atual M).» | Nota já no limite do evento | Não há novo envio possível daquele evento |
| «Prazo do evento … expirado em …» | Fora do prazo configurado | Evento não pode mais ser registrado |
| «Status 'X' não permite o evento …» | Situação da nota inadequada | Confira a situação da nota |
| «Evento … exige a NF-e na base (não aceita chave avulsa).» | Chave de nota que não está na base | Use o modo Notas da base |
| Linha Rejeitado com cStat | A SEFAZ recusou | Leia o motivo no detalhe do evento |
Relação com a NF-e / SEFAZ / EFD¶
| Evento | Na SEFAZ | Efeito no sistema |
|---|---|---|
| 110111 Cancelamento | Webservice da UF do emitente | Nota passa a Cancelada; na EFD-ICMS/IPI o C100 fica com COD_SIT 02, com identificação e chave [Guia Prático EFD-ICMS/IPI 3.2.3, p. 63] |
| 110110 Carta de Correção | Webservice da UF; gera o DACCe | Nota continua Autorizada; PDF do evento disponível |
| 210200–210240 Manifestação | Ambiente Nacional | Registra a posição do destinatário sobre a nota recebida |
| Eventos IBS/CBS/IS | Recepção nacional de eventos da Reforma | Registro do evento e do detEvento, com os valores por item quando houver |
| 110001 Cancelamento de evento | Recepção nacional de eventos da Reforma | Informa o evento e o protocolo cancelados (tpEventoAut, nProtEvento) |
Perguntas frequentes¶
O evento sumiu da lista. O período padrão é hoje. Ajuste De/Até e clique em Atualizar.
Não consigo escolher a nota no assistente. A grade só lista notas elegíveis; marque mostrar inelegíveis para ver o motivo (situação, prazo, limite de sequência, nota sem chave).
Posso cancelar uma carta de correção? Não pelo sistema: o cancelamento de evento (110001) não se aplica à carta de correção. Envie nova carta (nova sequência, até 20 por nota) com o texto correto.
Por que o card Operações ativas não muda com o filtro? Ele mede o trabalho em andamento da conta toda, não os eventos filtrados.
O que é "fora da base" na validação de chaves? A chave é válida, mas a nota não está no sistema. O evento pode ser enviado assim mesmo quando o evento aceita chave avulsa.