01. DADOS GERAIS

Produto:

Linha de Produto:

Segmento:

Módulo:

Função:
País:Brasil
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :


DOCUMENTO TÉCNICO: COCKPIT DE EVENTOS (OBF26000)

02. SITUAÇÃO/REQUISITO

A crescente complexidade na gestão de eventos fiscais, impulsionada pelas significativas alterações da Reforma Tributária (Lei Complementar nº 214/2025) e pelas especificações detalhadas da Nota Técnica 2025.002-RTC, gerou um cenário onde as funcionalidades para administrar o ciclo de vida dos eventos (cadastro de tipos, consulta de ocorrências e inclusão manual) estavam dispersas em múltiplos programas do sistema. Essa pulverização resultava em ineficiência operacional, demandando navegação excessiva e dificultando uma visão integrada e ágil.

Havia a necessidade premente de desenvolver uma interface unificada e centralizada que consolidasse todas essas operações. O principal requisito era proporcionar ao usuário uma experiência integrada, que otimizasse a navegabilidade, reduzisse o tempo gasto em alternância de telas e garantisse o acesso imediato às ferramentas de monitoramento e gerenciamento. Adicionalmente, era crucial incorporar um mecanismo de validação de segurança para as informações, assegurando que o acesso e a manipulação de dados (consultas ou inclusões) fossem restritos àquelas empresas às quais o usuário possui permissão.

03. SOLUÇÃO

O Cockpit de Eventos (OBF26000) foi concebido como a solução para centralizar e simplificar a gestão dos eventos fiscais eletrônicos. Ele serve como um hub que integra os programas de cadastro, consulta e inclusão manual de eventos, proporcionando um ambiente de trabalho coeso e eficiente.

Passo 01: Inicialização e Visão Padrão

Passo 02: Navegação e Gerenciamento de Funcionalidades

04. DEMAIS INFORMAÇÕES

O Cockpit de Eventos (OBF26000) foi implementado para transformar a gestão de eventos fiscais, passando de um modelo fragmentado para um ambiente centralizado e intuitivo. Sua estrutura é composta por um painel de navegação persistente e uma área de trabalho dinâmica.

O painel de navegação lateral organiza o acesso às funcionalidades em:

A área principal do Cockpit é adaptativa, exibindo a interface do programa selecionado. Ao abrir o Cockpit, a Central de Eventos (OBF26200) é carregada por padrão, oferecendo uma visão imediata dos eventos existentes, conforme o exemplo de uso onde um analista pode alternar entre configurar um evento (OBF26100), incluí-lo manualmente (OBF26300) e monitorar seu status (OBF26200) sem sair do Cockpit. Ações como "Sair" fecham o Cockpit, e outros botões na barra superior são contextuais ao programa ativo.

Esta solução não só melhora a produtividade e navegabilidade do usuário, como também reforça a segurança das informações, pois cada interação dentro do Cockpit — seja para consulta, configuração ou inclusão de eventos — é validada para garantir que o usuário possui as permissões necessárias para acessar a empresa ou os dados em questão. Essa abordagem garante a integridade e a conformidade dos dados fiscais em um ambiente regulatório complexo.


O COCKPIT DE EVENTOS (OBF26000) é a interface unificada para toda a gestão de eventos fiscais, centralizando os programas OBF26100, OBF26200 e OBF26300. Sua principal característica é a inicialização automática com o OBF26200 - Central de Eventos, proporcionando usabilidade imediata, e a validação de segurança que restringe o acesso aos dados da empresa conforme as permissões do usuário.





Os programas que o OBF26000 - Cockpit Eventos integra



OBF26100 - Cadastro Eventos

01. SITUAÇÃO/REQUISITO

Com a introdução da Reforma Tributária (Lei Complementar nº 214/2025) e as diretrizes da Nota Técnica 2025.002-RTC, o cenário de eventos fiscais tornou-se significativamente mais complexo. Uma nova série de eventos para a apuração do IBS (Imposto sobre Bens e Serviços) e CBS (Contribuição Social sobre Bens e Serviços), bem como a gestão de créditos, tornou-se indispensável.

Antes da implementação do OBF26100, havia um requisito crítico para uma ferramenta que permitisse:

  1. Parametrização Centralizada: Gerenciar e configurar de forma minuciosa os diversos tipos de eventos (identificação única, regras de negócio, origem, tipo de autor, necessidade de aceitação, inclusão de detalhes de itens, etc.) em uma única interface, garantindo conformidade com a nova legislação.
  2. Manutenção e Coerência: Assegurar que o sistema opere corretamente ao gerar, processar ou consumir eventos, com a garantia de que as informações sobre os tipos de eventos fossem consistentes e atualizadas para todas as empresas.
  3. Segurança da Informação: Implementar mecanismos de segurança que validassem o acesso do usuário à empresa associada aos eventos, tanto para consultas quanto para a inclusão de novos eventos, protegendo a integridade e confidencialidade dos dados fiscais.

02. SOLUÇÃO

A tela OBF26100 - Cadastro de Eventos foi desenvolvida para atender a esses requisitos, proporcionando uma ferramenta essencial para a gestão e configuração dos tipos de eventos fiscais. Ela centraliza a manutenção dos parâmetros que governam o comportamento de cada evento, garantindo que o sistema opere em conformidade com as regulamentações fiscais e necessidades operacionais. A interface do OBF26100 é única para todas as empresas, e a segurança é garantida por validações de acesso do usuário.

Passo 01: Acesso e Funcionalidade Central

  • O OBF26100 é acessado através do OBF26000 - Cockpit de Eventos (no painel de navegação lateral, seção "Cadastros").
  • Sua funcionalidade central é permitir o cadastro e a manutenção dos tipos de eventos que serão utilizados na aplicação, definindo suas características e regras de negócio, as quais impactam diretamente a geração e apuração de tributos.

Passo 02: Parametrização Detalhada dos Tipos de Evento

  • A tela OBF26100 disponibiliza campos específicos para a parametrização de cada tipo de evento:
    • Evento: Código identificador único (numérico de 6 dígitos, ex: 112110, 211110). Pode ser selecionado via lookup (🔍) que exibe a "Zoom de Eventos". O código 110001 (cancelamento) é preenchido automaticamente se for o caso.
    • Descrição: Nome descritivo do evento (texto), preenchido automaticamente ao selecionar o evento no lookup.
    • Versão do leiaute: Versão técnica do leiaute (numérico com 2 decimais, ex: 1.00), crucial para a formatação do XML, conforme Schema XML - parte específica: e[CODIGO_EVENTO]_v1.00.xsd da NT 2025.002-RTC.
    • Origem: Módulo ou área funcional do sistema (lista de seleção: CAP, CRE, FAT, FIN, OBF, PAT, SUP, OUTROS), que indica o contexto do evento.
    • Tipo autor: Entidade responsável pelo evento (lista de seleção: Empresa emitente, Empresa destinatária, Empresa, RFB, Empresa sucessora, Outros órgãos), conforme Seção 8.1 da NT 2025.002-RTC.
    • Possui indicador de aceitação?: Checkbox que, se marcado, exige o preenchimento do campo "Indicador de aceitação". Relevante para eventos como 211128, 212110, 212120.
    • Indicador de aceitação: Status de aceitação (lista de seleção: 0 - Não aceite, 1 - Aceite), condicionalmente obrigatório quando "Possui indicador de aceitação?" está marcado.
    • Data de validade (De/Até): Período de ativação da configuração (DD/MM/AAAA), sendo que a "Data De" deve ser menor ou igual à "Data Até". Os eventos da Reforma Tributária têm valor jurídico a partir de 01/01/2026.
    • Gera informações dos itens?: Checkbox que, se marcado, indica que o evento inclui detalhes de itens, conforme a estrutura do detEvento na NT 2025.002-RTC. Eventos como 112120, 211110, 211130 devem ter este campo marcado.
    • Caminho do XML: Caminho do diretório para salvar o schema XML correspondente ao evento.

Passo 03: Ciclo de Vida do Cadastro e Ações

  • A barra de ferramentas oferece ações para gerenciar os cadastros:
    • Incluir: Inicia a criação de um novo registro.
    • Modificar: Habilita a edição de um registro selecionado.
    • Copiar: Duplica um registro existente.
    • Excluir: Remove um registro (com validações de dependência).
    • Pesquisar: Abre funcionalidade de busca.
    • Navegação: Primeiro/Anterior, Seguinte/Último para mover entre registros.
    • Lista: Exibe uma visão tabular de todos os eventos cadastrados.
    • Relatório: Gera relatórios de configuração.
    • Configurar: Direciona para o programa VDP10076 para configurações adicionais.
    • Sair: Fecha a tela.
    • Confirmar (Visto Verde): Salva alterações ou um novo registro (com validações de negócio).
    • Cancelar (X Vermelho): Descarta alterações ou o processo de inclusão.

03. DEMAIS INFORMAÇÕES

A tela OBF26100 - Cadastro de Eventos é uma interface crítica para garantir a conformidade fiscal contínua do sistema, especialmente diante da dinâmica legislativa da Reforma Tributária. A sua capacidade de permitir uma parametrização detalhada e centralizada dos tipos de eventos assegura que o sistema esteja sempre alinhado às exigências da Lei Complementar nº 214/2025 e da Nota Técnica 2025.002-RTC. Ao cadastrar um evento, o usuário define como ele deve ser tratado, quais dados deve conter e quais validações são aplicáveis, impactando diretamente a geração dos eventos e a apuração de tributos. A interface é projetada para ser universal, servindo a todas as empresas.


O OBF26100 - Cadastro de Eventos é a única tela responsável pela configuração minuciosa de todos os tipos de eventos para todas as empresas, garantindo a conformidade com a Reforma Tributária (IBS/CBS) e as especificações da NT 2025.002-RTC. 

OBF26300 - Inclusão Manual Eventos

01. VISÃO GERAL

A tela "Inclusão de eventos" (OBF26300) é a interface central para registrar e gerenciar eventos fiscais e operacionais no sistema, associando-os a documentos fiscais eletrônicos (NF-e) e seus respectivos itens. Esta funcionalidade é crucial para a conformidade com a Reforma Tributária, especialmente na apuração dos novos Impostos sobre Bens e Serviços (IBS) e Contribuição sobre Bens e Serviços (CBS).

Nesta tela, o usuário concentra-se principalmente na seleção do documento fiscal, que deve ser sempre uma NF-e modelo 55. Os dados do evento em si (como código, descrição, versão do leiaute, tipo de autor e origem) são automaticamente preenchidos com base na configuração realizada na tela de cadastro de eventos (OBF26100), garantindo consistência e padronização.

A exibição da grade de itens é condicional: ela só aparecerá se o evento selecionado, de acordo com seu cadastro em OBF26100, exigir a especificação de informações em nível de item. Quando visível, a grid permite detalhar cada item da NF-e que será afetado pelo evento, incluindo características fiscais, quantidades e valores de IBS/CBS. Funcionalidades de pesquisa (Unid., Consulta inventário) e referenciamento (NFE Ref.) são disponibilizadas se a natureza do evento exigir.

Em suma, a OBF26300 atua como ponto principal para criar os eventos, assegurando que as informações fluam adequadamente para a apuração fiscal e o cumprimento das obrigações acessórias, conforme exigências da Nota Técnica 2025.002-RTC.

02. SITUAÇÃO/REQUISITO

A Reforma Tributária (Lei Complementar nº 214/2025) e a Nota Técnica 2025.002-RTC introduziram uma série de novos eventos fiscais e operacionais, essenciais para a correta apuração do IBS, CBS e a gestão de créditos. Embora muitos eventos possam ser gerados automaticamente pelo sistema, existem cenários (ex: ajustes, situações atípicas, correções) que exigem a intervenção manual do usuário para registrar um evento fiscal.

Neste contexto, o requisito era criar uma interface que permitisse a inclusão manual de eventos fiscais, garantindo:

  1. Consistência dos Dados: O evento manual deve estar em estrita conformidade com as configurações predefinidas no OBF26100 - Cadastro de Eventos, evitando erros e inconsistências.
  2. Vinculação Precisa: O evento precisa ser associado de forma clara e correta a um documento fiscal eletrônico (NF-e modelo 55) e, quando aplicável, aos seus itens específicos.
  3. Segurança e Validação: Assegurar que a inclusão manual respeite as regras de negócio e de segurança, incluindo as permissões de acesso do usuário à empresa e ao documento fiscal referenciado.
  4. Flexibilidade: A tela deve se adaptar ao tipo de evento, exibindo e solicitando informações de itens apenas quando necessário, e fornecendo ferramentas contextuais (pesquisa de inventário, referenciamento de NF-e) conforme a natureza do evento.

03. SOLUÇÃO

A tela OBF26300 - Inclusão Manual Eventos foi desenvolvida como a interface central para registrar e gerenciar eventos fiscais e operacionais de forma manual. Ela associa esses eventos a documentos fiscais eletrônicos (NF-e modelo 55) e, quando necessário, aos seus respectivos itens, garantindo conformidade com a Reforma Tributária e a Nota Técnica 2025.002-RTC.

Passo 01: Seleção do Evento e Preenchimento Automático dos Dados Gerais

  • O OBF26300 é acessado através do OBF26000 - Cockpit de Eventos (no painel de navegação lateral, seção "Processamento").
  • O usuário inicia o processo de inclusão clicando no botão "Incluir".
  • A tela exige que o usuário selecione o tipo de evento que deseja incluir. Uma vez selecionado, os campos "Evento", "Versão do leiaute", "Tipo autor", "Origem" e "Indicador de aceitação" são automaticamente preenchidos com base na configuração prévia realizada na tela OBF26100 - Cadastro de Eventos, garantindo a padronização e a conformidade com as regras de negócio. O campo "Indicador de aceitação" só será exibido se a configuração do evento em OBF26100 assim o determinar.

Passo 02: Vinculação do Documento Fiscal Eletrônico (NF-e Modelo 55)

  • O usuário procede à seção "Dados do Documento Fiscal", onde a principal ação é a seleção de uma Nota Fiscal Eletrônica (NF-e modelo 55).
  • Os campos "Empresa" e "Nota Fiscal" são obrigatórios e podem ser preenchidos via lookup (🔍).
  • Após a seleção da NF-e, campos como "Série", "Subsérie", "Tipo nota fiscal", "Espécie", "Data entrada/emissão", "Fornecedor/Cliente" e "Chave Nfe" são automaticamente preenchidos e exibidos como somente leitura.
  • Campos como "Valor IBS" e "Valor CBS" são automaticamente preenchidos com o somatório dos valores dos itens da NF-e vinculada.

Passo 03: Detalhamento de Itens (Condicional) e Informações Específicas

  • A grade de itens na seção "Seleção dos Itens Relacionados ao Evento" é condicional: ela só aparece se o tipo de evento, conforme cadastrado em OBF26100, exige a especificação de informações em nível de item (ex: "Gera informações dos itens?" marcado).
  • Quando visível, a grade lista os itens da NF-e selecionada. O usuário pode selecionar itens específicos via checkbox e, para cada item, detalhar informações como "Unid.", "Quantidade", "Valor IBS.", "Valor CBS.", "Estorno crédito IBS", "Estorno crédito CBS".
  • Funcionalidades contextuais são habilitadas de acordo com o tipo de evento:
    • Inventário/Parcela/Consulta inventário (🔍): Habilitados para o Evento 211130 - Imobilização de Item.
    • NFE Ref. (🔍): Habilitado para o Evento 211120 - Destinação de item para consumo pessoal, permitindo referenciar uma nota fiscal de saída.
  • Após preencher todos os dados necessários, o usuário clica em "Confirmar" para salvar o evento, ou "Cancelar" para descartar as informações.

04. DEMAIS INFORMAÇÕES

A tela OBF26300 - Inclusão Manual Eventos é fundamental para a flexibilidade operacional e a conformidade fiscal no contexto da Reforma Tributária. Sua capacidade de associar eventos a documentos e itens da NF-e, combinada com a automação de preenchimento de dados a partir do cadastro de eventos (OBF26100), minimiza erros e garante a padronização.

A interface foca na seleção da NF-e modelo 55 como documento base. A exibição condicional da grade de itens e das funcionalidades de pesquisa (Unid., Consulta inventário) e referenciamento (NFE Ref.) demonstra a adaptabilidade da tela às especificações de cada tipo de evento conforme a Nota Técnica 2025.002-RTC.

Outras Ações / Ações relacionadas

A barra de ações superior da tela OBF26300 fornece um conjunto de funcionalidades essenciais para a manipulação dos registros de eventos.

  • Incluir: Inicia a operação para a criação de um novo registro de evento. Ao clicar, os campos da tela são habilitados para preenchimento dos detalhes do novo evento.
  • Confirmar: Salva as informações inseridas ou modificadas na base de dados. Esta ação valida os dados preenchidos contra as regras de negócio e de sistema antes de persistir o registro. Em caso de sucesso, o novo evento ou as alterações são efetivados.
  • Cancelar: Descarta todas as alterações feitas na tela para o registro atual. Se estiver em modo de inclusão, cancela a criação do novo evento. Se estiver em modo de modificação, desfaz as alterações e reverte o registro para seu estado original antes da edição.
  • Sair: Fecha a tela "Inclusão de eventos" e retorna à tela anterior ou ao menu principal do sistema. Todas as alterações não salvas serão perdidas.

Principais Campos e Parâmetros

Esta seção detalha os campos da tela "Inclusão de eventos" (OBF26300), suas finalidades e as validações conforme evento cadastrado e configurado no OBF26100.

2. Dados do Evento

Esta seção é dedicada às informações gerais e técnicas do evento a ser registrado. Esses campos são preenchidos automaticamente com base na configuração realizada na tela OBF26100 - Cadastro de Eventos.

  • Evento: Código ou identificador do evento que está sendo registrado. É um campo de preenchimento automático (somente leitura). O código é preenchido automaticamente a partir da configuração do evento selecionado em OBF26100.
  • Versão do leiaute: Indica a versão do leiaute XML ou padrão técnico associado ao evento. É um campo de preenchimento automático (somente leitura). A versão do leiaute (1.00 para a maioria dos eventos da NT) é preenchida automaticamente com base na configuração do evento em OBF26100.
  • Tipo autor: Define a entidade que é considerada o autor ou responsável pelo evento. É um campo de preenchimento automático (somente leitura). O tipo de autor é preenchido automaticamente com base na configuração do evento em OBF26100, que por sua vez segue as especificações da NT 2025.002-RTC.
  • Origem: Indica a área funcional ou módulo do sistema que é a fonte principal ou o contexto do evento. É um campo de preenchimento automático (somente leitura). A origem do evento é preenchida automaticamente com base na configuração do evento em OBF26100.
  • Indicador de aceitação: Define o status de aceitação ou não aceitação do evento. O comportamento deste campo é condicional: ele só será exibido e preenchido automaticamente se o evento, conforme configurado em OBF26100, requer um indicador de aceitação. Se não for o caso, este campo não será exibido nesta seção.

3. Dados do Documento Fiscal

Esta seção é utilizada para identificar o documento fiscal ao qual o evento está vinculado. A principal ação do usuário nesta tela é selecionar a Nota Fiscal.

  • Empresa: Código ou nome da empresa emissora/receptora do documento fiscal. Este campo é Obrigatório e permite formato numérico ou alfanumérico. Um lookup (🔍) permite pesquisar e selecionar uma empresa cadastrada no sistema e à qual o evento será gerado.
  • Aviso recebimento: Número do aviso de recebimento associado ao documento fiscal. Este campo é Opcional, de formato numérico ou alfanumérico. Um lookup (🔍) pode ser usado para buscar avisos de recebimento existentes.
  • Nota Fiscal: Número do documento fiscal NF-e. Este campo é Obrigatório, de formato numérico. Um lookup (🔍) permite pesquisar notas fiscais existentes. Importante: A Nota Fiscal selecionada deve ser do Modelo 55 (NF-e).
  • Série: Série do documento fiscal. É um campo de preenchimento automático (somente leitura), de formato alfanumérico, conforme seleção da nota fiscal.
  • Subsérie: Subsérie do documento fiscal, se aplicável. É um campo de preenchimento automático (somente leitura), de formato alfanumérico, conforme seleção da nota fiscal.
  • Tipo nota fiscal: Tipo da Nota Fiscal (saída/entrada). É um campo de preenchimento automático (somente leitura), de formato alfanumérico, conforme seleção da nota fiscal.
  • Espécie: Espécie do documento fiscal. É um campo de preenchimento automático (somente leitura), de formato alfanumérico (Ex: "NFE"), conforme seleção da nota fiscal.
  • Data entrada/emissão: Data de entrada ou de emissão do documento fiscal. É um campo de preenchimento automático (somente leitura), de formato DD/MM/AAAA, conforme seleção da nota fiscal. Deve apresentar uma data válida.
  • Fornecedor/Cliente: Código ou nome do fornecedor (para notas de entrada) ou cliente (para notas de saída). É um campo de preenchimento automático (somente leitura), de formato numérico ou alfanumérico, conforme seleção da nota fiscal.
  • Chave Nfe: Chave de acesso de 44 dígitos da Nota Fiscal Eletrônica. É um campo de preenchimento automático (somente leitura), de formato numérico, 44 dígitos, conforme seleção da nota fiscal. Validação: Deve corresponder a uma chave de acesso de NF-e válida e autorizada.
  • Valor IBS: Valor total do Imposto sobre Bens e Serviços (IBS) no documento fiscal. É um campo de exibição (leitura), preenchido automaticamente com o somatório dos valores de IBS dos itens da NF-e vinculada.
  • Valor CBS: Valor total da Contribuição sobre Bens e Serviços (CBS) no documento fiscal. É um campo de exibição (leitura), preenchido automaticamente com o somatório dos valores de CBS dos itens da NF-e vinculada.

4. Seleção dos Itens Relacionados ao Evento (Grid)

Esta grade exibe os itens do documento fiscal. Ela será apresentada apenas se o evento, conforme configurado na tela OBF26100, exigir informações em nível de item.

  • Selec.: Checkbox para seleção individual de um item na lista, indicando que ele é relevante para o evento em questão. Permite a interação de selecionar um ou mais itens.
  • Seq.: Número sequencial do item na Nota Fiscal original. É um campo de exibição preenchido automaticamente. Deve corresponder à sequência do item na NF-e vinculada.
  • Item: Código de identificação do item (produto/serviço). É um campo de exibição preenchido automaticamente ao vincular a NF-e.
  • Descrição item: Descrição detalhada do item. É um campo de exibição preenchido automaticamente ao vincular a NF-e.
  • CST: Código de Situação Tributária IBS/CBS do item. É um campo de exibição preenchido automaticamente ao vincular a NF-e.
  • Classif. Tributária: Classificação Tributária IBS/CBS do item. É um campo de exibição preenchido automaticamente ao vincular a NF-e.
  • Unid.: Unidade de medida do item. Permite entrada/lookup (🔍) para pesquisa e seleção da unidade de medida.
  • Quantidade: Quantidade do item. É um campo de entrada/exibição preenchido automaticamente ao vincular a NF-e. Permite a inserção ou exibe a quantidade do item. Para eventos que geram informações de item, este campo é crucial. Validação: Deve ser um valor numérico válido e pode ter restrições de acordo com o evento (Ex: não maior que a quantidade original da NF-e).
  • Valor IBS.: Valor do IBS referente a este item. É um campo de entrada/exibição. O valor de IBS do item é preenchido automaticamente ao vincular a NF-e. Se a quantidade do item for alterada, o valor do IBS será recalculado proporcionalmente.
  • Valor CBS.: Valor da CBS referente a este item. É um campo de entrada/exibição. O valor de CBS do item é preenchido automaticamente ao vincular a NF-e. Se a quantidade do item for alterada, o valor da CBS será recalculado proporcionalmente.
  • Estorno crédito IBS: Valor de estorno de crédito de IBS aplicável ao item. É um campo de entrada/exibição, relevante para eventos como o de Estorno de Crédito.
  • Estorno crédito CBS: Valor de estorno de crédito de CBS aplicável ao item. É um campo de entrada/exibição, relevante para eventos como o de Estorno de Crédito.
  • Inventário: Código ou identificador de inventário associado ao item. Este campo possui habilitação condicional: é habilitado apenas quando o Evento for 211130 - Imobilização de Item.
  • Parcela: Número ou identificador da parcela do inventário associado ao item. Este campo possui habilitação condicional: é habilitado apenas quando o Evento for 211130 - Imobilização de Item.
  • Consulta inventário: Ícone de lupa (🔍) que permite acessar detalhes do inventário associado ao item. Este campo possui habilitação condicional: é habilitado apenas quando o Evento for 211130 - Imobilização de Item. Ação: Abre a tela de consulta de inventário e parcelas do patrimônio.
  • NFE Ref.: Ícone de lupa (🔍) que abre o pop-up "NFE Referência" para vincular uma NF-e específica como referência para este item. Este campo possui habilitação condicional: é habilitado apenas quando o Evento for 211120 - Destinação de item para consumo pessoal. Ação: Abre o pop-up "NFE Referência". Este mecanismo é utilizado para referenciar uma nota fiscal de saída relacionada ao evento, como a NF-e de consumo pessoal, conforme a NT 2025.002-RTC.


A OBF26300 é a ferramenta essencial para a intervenção manual na gestão de eventos fiscais, garantindo que mesmo em cenários não automatizados, a inclusão seja feita com consistência e conformidade. A dependência de OBF26100 para os dados do evento e a exibição condicional da grade de itens e de campos específicos otimizam a usabilidade, adaptando a interface à natureza de cada evento e às exigências da Nota Técnica 2025.002-RTC.

NFE Referência 

01. VISÃO GERAL

O pop-up "NFE Referência" é uma funcionalidade integrante da tela OBF26300 - Inclusão Manual Eventos, projetada para estabelecer uma associação precisa entre um item de uma Nota Fiscal Eletrônica principal e uma Nota Fiscal Eletrônica de referência. Este mecanismo é acionado especificamente para eventos que, pela sua natureza, exigem tal vínculo, como o Evento 211120 - Destinação de item para consumo pessoal, conforme as diretrizes da Nota Técnica 2025.002-RTC.

Sua finalidade é permitir que o usuário pesquise e selecione uma NF-e de referência, cujos dados (número, série, cliente, data de emissão) são automaticamente preenchidos. O pop-up também oferece a opção de vincular um item específico dentro dessa NF-e de referência, garantindo que o evento manual reflita com exatidão a transação fiscal subjacente e suas ramificações para a apuração de IBS/CBS.

02. SITUAÇÃO/REQUISITO

A Nota Técnica 2025.002-RTC, especialmente para o Evento 211120 - Destinação de item para consumo pessoal, estabelece a necessidade de referenciar uma Nota Fiscal de saída (NF-e ou NFC-e) que comprove a destinação para consumo pessoal. No contexto da OBF26300 - Inclusão Manual Eventos, que permite a inclusão de eventos em nível de item, tornou-se um requisito fundamental a capacidade de vincular um item da NF-e principal a uma NF-e específica de consumo pessoal.

Os requisitos para esta funcionalidade eram:

  1. Vínculo Direto: Permitir que o usuário associe uma NF-e de referência a um item específico da NF-e principal que está sendo processada no evento 211120.
  2. Automação de Dados: Após a seleção da NF-e de referência, seus dados básicos (série, cliente, data de emissão) deveriam ser automaticamente preenchidos para agilizar o processo e minimizar erros.
  3. Precisão no Detalhamento: Oferecer a opção de selecionar um item específico dentro da NF-e de referência, caso a legislação ou a regra de negócio exija tal nível de detalhe (relacionando-se ao nItem do DFeReferenciado na NT).
  4. Interface Intuitiva: Apresentar uma interface simples e clara para a seleção da NF-e e, opcionalmente, de seu item.

03. SOLUÇÃO

O pop-up "NFE Referência" foi implementado como uma extensão contextual da tela OBF26300 - Inclusão Manual Eventos, ativando-se especificamente para o Evento 211120 quando a coluna "NFE Ref." é acionada na grade de itens. Ele cumpre a função de permitir a seleção e o detalhamento de uma Nota Fiscal Eletrônica que serve como referência.

Passo 01: Acionamento e Seleção da NF-e de Referência

  • O pop-up é acionado ao clicar no ícone de lupa (🔍) na coluna "NFE Ref." da grade de itens na tela OBF26300. Esta coluna é habilitada condicionalmente apenas quando o evento principal sendo incluído manualmente é o 211120 - Destinação de item para consumo pessoal.
  • Dentro do pop-up, o usuário encontrará um campo para Nota Fiscal (numérico), que permite a entrada do número da NF-e de referência. Um ícone de lupa (🔍) ao lado deste campo facilita a pesquisa e seleção de notas fiscais existentes no sistema.
  • Após a seleção da NF-e de referência, os campos Série (alfanumérico), Cliente (código ou nome, numérico/alfanuméríco) e Data emissão (DD/MM/AAAA) são automaticamente preenchidos (somente leitura) com as informações da NF-e selecionada.

Passo 02: Detalhamento Opcional do Item de Referência

  • O pop-up oferece os campos Sequência e Item para o usuário, permitindo o detalhamento do item específico dentro da NF-e de referência, caso seja necessário.
    • Sequência: Um campo para o número sequencial ou identificador do item (opcional). Um ícone de lupa (🔍) pode ser usado para buscar sequências de itens dentro da NF-e de referência.
    • Item: O código do item dentro da Nota Fiscal de referência (numérico). Este campo é preenchido automaticamente ao vincular a NF-e e a sequência do item. Sua consistência é validada para garantir que corresponda a um item existente na NF de referência, relacionando-se ao nItem do DFeReferenciado na NT 2025.002-RTC.

Passo 03: Confirmação ou Cancelamento

  • O pop-up possui dois botões de ação:
    • Confirmar: Salva a seleção da NF-e de referência e, opcionalmente, do item de referência, e fecha o pop-up, aplicando as informações ao item correspondente na grade da OBF26300.
    • Cancelar: Fecha o pop-up sem salvar as alterações, descartando qualquer seleção feita.


O pop-up "NFE Referência" é uma funcionalidade condicional, ativada apenas para o Evento 211120 - Destinação de item para consumo pessoal na OBF26300. Ele permite vincular uma NF-e de saída e, opcionalmente, um item dela, a um item do evento principal, assegurando a conformidade com a NT 2025.002-RTC ao referenciar documentos para consumo pessoal.



Consultar Inventário 

01. VISÃO GERAL

O pop-up "Consultar Inventário" é uma funcionalidade integrada à tela OBF26300 - Inclusão Manual Eventos. Ele foi projetado para permitir que o usuário, ao registrar um evento de imobilização, possa consultar o vinculo de um item da Nota Fiscal Eletrônica (NF-e) a um ativo do inventário, incluindo sua respectiva parcela. Este pop-up é acionado exclusivamente para o Evento 211130 - Imobilização de Item, conforme as especificações da Nota Técnica 2025.002-RTC.

Sua principal finalidade é garantir a precisão na vinculação de bens imobilizados, integrando as informações fiscais com os registros físicos do patrimônio. Ele atua como um elo direto com o programa de controle do Patrimônio (PAT10028), possibilitando a consulta do inventário e suas parcelas associadas.

02. SITUAÇÃO/REQUISITO

O Evento 211130 - Imobilização de Item, introduzido pela Nota Técnica 2025.002-RTC no contexto da Reforma Tributária, exige que o adquirente informe quando um bem é integrado ao seu ativo imobilizado. Essa informação é crucial para a adequada identificação, pelos sistemas da administração tributária, do prazo-limite para apreciação de eventuais pedidos de ressarcimento de crédito, conforme o Art. 40, I da LC 214/2025. Para eventos manuais (OBF26300), isso implica a necessidade de vincular um item da NF-e que representa o bem a um registro específico no controle de patrimônio/inventário do sistema.

O requisito para esta funcionalidade era:

  1. Vínculo com o Patrimônio: Permitir que o usuário associe um item da NF-e (que está sendo imobilizado) a um registro existente de inventário e sua parcela correspondente, conforme gerenciado pelo programa PAT10028.
  2. Consulta Integrada: Oferecer uma interface intuitiva de consulta que permita ao usuário buscar e selecionar o inventário e a parcela corretos diretamente durante o processo de inclusão manual do evento 211130 na OBF26300.
  3. Habilitação Condicional: O acesso a essa consulta deveria ser restrito apenas ao cenário do Evento 211130, mantendo a interface da OBF26300 limpa e contextualizada para outros tipos de eventos.
  4. Minimização de Erros: Garantir que o inventário e a parcela selecionados sejam válidos e consistentes com o programa PAT10028, reduzindo a possibilidade de erros na vinculação.

03. SOLUÇÃO

O pop-up "Consultar Inventário" foi implementado como uma extensão contextual da tela OBF26300 - Inclusão Manual Eventos, ativando-se especificamente para o Evento 211130. Ele fornece uma ponte direta para as informações do PAT10028, permitindo uma vinculação precisa e segura dos bens imobilizados.

Passo 01: Acionamento Condicional da Consulta

  • O pop-up "Consultar Inventário" é acionado ao clicar no ícone de lupa (🔍) presente na coluna "Consulta inventário" da grade de itens na tela OBF26300.
  • Esta coluna e seu ícone de lupa são habilitados condicionalmente apenas quando o evento principal sendo incluído manualmente é o 211130 - Imobilização de Item. Para outros tipos de eventos, essa funcionalidade permanece desabilitada ou oculta.

Passo 02: Realização da Consulta e Seleção

  • Ao ser acionado, o pop-up "Consultar Inventário" exibe uma interface de pesquisa que permite ao usuário buscar registros de inventário e suas parcelas no sistema, integrando-se com o programa PAT10028.
  • A interface de consulta permite ao usuário aplicar critérios de busca para localizar o inventário e a parcela desejados.

04. DEMAIS INFORMAÇÕES

A implementação do pop-up "Consultar Inventário" é crucial para a integridade dos dados fiscais e patrimoniais. Ele assegura que o processo de imobilização de itens seja transparente e auditável, ao vincular diretamente o documento fiscal à base de patrimônio da empresa.

A sua habilitação contextual simplifica a experiência do usuário, apresentando a funcionalidade apenas quando ela é relevante para o Evento 211130. Essa integração com o PAT10028 garante que os dados de inventário sejam consistentes e que a apuração de créditos e prazos fiscais para ativos imobilizados seja feita com base em informações precisas e verificáveis.


O pop-up "Consultar Inventário" é uma funcionalidade exclusiva para o Evento 211130 - Imobilização de Item na OBF26300. Ele permite a integração direta com o programa PAT10028, possibilitando a consulta e vinculação precisa de bens imobilizados a seu registro de inventário e parcela, fundamental para a apuração de créditos da Reforma Tributária.

OBF26200 - Central de Eventos

01. VISÃO GERAL

A tela "Central de Eventos" (OBF26200) serve como um ponto de controle centralizado para todos os eventos gerados e gerenciados no sistema. Seu principal objetivo é proporcionar aos usuários uma visão abrangente e detalhada de todas as ocorrências de eventos, permitindo a pesquisa, filtragem e visualização do status de cada um. Esta funcionalidade é essencial para monitorar processos operacionais e de conformidade que envolvem a comunicação e o registro de eventos eletrônicos, especialmente aqueles relacionados à Reforma Tributária (IBS, CBS), conforme detalhado na Nota Técnica 2025.002-RTC.

Através da "Central de Eventos", os usuários podem identificar rapidamente o status de envio de um evento, sua origem (módulo do sistema), data de inclusão e as notas fiscais associadas. Uma funcionalidade chave é a opção de "Detalhe", que, ao ser acionada para um evento específico, permite consultar os documentos fiscais e os itens relacionados, oferecendo uma auditoria completa e acesso à informação contextual necessária. A tela facilita a gestão de um grande volume de eventos, desde autorizações e cancelamentos até manifestações do contribuinte e eventos de imobilização ou apropriação de crédito, garantindo transparência e rastreabilidade em todos os processos.

02. SITUAÇÃO/REQUISITO

A proliferação de eventos fiscais eletrônicos, intensificada pelas novas regulamentações da Reforma Tributária (Lei Complementar nº 214/2025) e pelas especificações da Nota Técnica 2025.002-RTC, gerou a necessidade crítica de uma ferramenta que permitisse o monitoramento e gerenciamento centralizado de todas essas ocorrências. Com uma variedade crescente de eventos (como Informação de pagamento integral, Imobilização de Item, Solicitação de Apropriação de crédito presumido, entre outros), tornou-se impraticável acompanhar seu status e detalhes sem uma visão unificada.

Os requisitos para a "Central de Eventos" (OBF26200) incluíam:

  1. Visibilidade Abrangente: Fornecer uma visão completa de todos os eventos gerados, independentemente de sua origem ou tipo.
  2. Rastreabilidade e Status: Permitir que o usuário consultasse o status de envio e processamento de cada evento (pendente, autorizado, rejeitado, etc.).
  3. Filtragem Eficiente: Oferecer múltiplos critérios de pesquisa e filtro para que os usuários pudessem localizar rapidamente eventos específicos ou conjuntos de eventos (por período, empresa, tipo de evento, nota fiscal associada, etc.).
  4. Acesso a Detalhes: Disponibilizar uma funcionalidade de "Detalhe" que permitisse uma análise aprofundada de um evento, incluindo seus dados gerais, o XML gerado, o histórico de auditoria e informações sobre os documentos fiscais e itens relacionados.
  5. Ações Corretivas e de Gerenciamento: Habilitar ações diretas sobre os eventos, como reenvio, exclusão ou cancelamento, para que os usuários pudessem reagir proativamente a qualquer inconsistência ou mudança de cenário.
  6. Experiência Integrada: Ser a tela principal de consulta de eventos, sendo acessível diretamente ao abrir o OBF26000 - Cockpit de Eventos.

03. SOLUÇÃO

A tela OBF26200 - Central de Eventos foi desenvolvida como a solução para a necessidade de monitoramento e gerenciamento centralizado de eventos fiscais. Ela oferece uma interface unificada onde os usuários podem visualizar, filtrar, detalhar e executar ações sobre todas as ocorrências de eventos registradas no sistema.

Passo 01: Acesso e Visão Inicial

  • O OBF26200 é a tela padrão que se abre ao acessar o OBF26000 - Cockpit de Eventos. Isso garante que o usuário tenha uma visão imediata dos eventos existentes, agilizando o início do monitoramento.
  • A interface apresenta uma "Área de Filtros/Pesquisa" na parte superior e uma "Grid de Resultados" na parte inferior, exibindo uma lista de eventos conforme os critérios de busca.

Passo 02: Pesquisa e Filtragem de Eventos

  • O usuário pode utilizar a "Área de Filtros/Pesquisa" para refinar a busca por eventos. Critérios como "Empresa", "Período (De/Até)", "Evento", "Ambiente", "Status envio", "Origem", "Nota fiscal", "Série", "Cliente/Fornecedor" e "Chave Nfe" permitem localizar eventos específicos.
  • Após definir os filtros, o usuário aciona o botão "Pesquisar" para atualizar a "Grid de Resultados" com os eventos correspondentes.

Passo 03: Análise e Detalhamento dos Eventos

  • A "Grid de Resultados" exibe os eventos em formato tabular, com colunas como "Empresa", "Evento", "Descrição do evento", "Status Envio", "Data inclusão", "Nota fiscal", "Chave Nfe", "Protocolo", entre outros.
  • Para uma análise aprofundada, o usuário pode clicar no ícone de lupa (🔍) na coluna "Detalhe" de um evento específico. Esta ação abre uma nova visualização (ou modal) que contém as informações completas do evento, incluindo:
    • Dados Gerais: Informações básicas do evento.
    • XML: O conteúdo técnico do XML gerado para o evento.
    • Auditoria: Histórico de ações e modificações no evento.
    • Documentos Fiscais e Itens Relacionados: Detalhes da NF-e e seus itens associados ao evento.

Passo 04: Execução de Ações sobre os Eventos

  • A "Barra de Ferramentas" superior da tela oferece diversas ações que podem ser aplicadas aos eventos, individualmente ou em lote (utilizando o checkbox na coluna "Selec." da grid):
    • Excluir: Remove eventos selecionados (com validações de segurança).
    • Enviar: Reenvia eventos pendentes para processamento.
    • Retornar: Atualiza o status do evento conforme o retorno da Sefaz.
    • Atualizar: Recarrega a grid para exibir informações recentes.
    • Cancelar: Gera automaticamente um evento de cancelamento para o evento selecionado.
    • Profile: Acessa configurações de perfil do usuário.

04. DEMAIS INFORMAÇÕES

A "Central de Eventos" (OBF26200) é a espinha dorsal para a gestão reativa e proativa de eventos fiscais. Sua integração direta com o OBF26000 - Cockpit de Eventos posiciona-a como a primeira interface de contato do usuário com o universo dos eventos, reforçando sua importância estratégica.

A capacidade de filtrar, pesquisar e detalhar eventos de maneira granular é essencial para o cumprimento das obrigações acessórias decorrentes da Reforma Tributária. Os diversos campos de filtro permitem ao usuário navegar por um grande volume de dados, encontrando rapidamente a informação necessária para a tomada de decisão ou para a correção de eventuais inconsistências.

A funcionalidade de "Detalhe" é um diferencial, pois fornece uma "fotografia" completa do evento, incluindo o XML original e o histórico de auditoria, elementos indispensáveis para a rastreabilidade e a transparência exigidas pela legislação tributária moderna. As ações da barra de ferramentas permitem que o usuário atue diretamente sobre os eventos, agilizando a correção e o envio, e garantindo que o ciclo de vida do evento seja gerenciado de forma eficiente.

Outras Ações / Ações relacionadas

A Barra de Ferramentas da "Central de Eventos" oferece um conjunto de botões de ação para interagir com os eventos listados na grid, permitindo desde a pesquisa e atualização até ações mais complexas como exclusão e envio.

  • Pesquisar: Inicia a busca por eventos na base de dados, aplicando os critérios definidos na Área de Filtros/Pesquisa. O resultado é exibido na Grid de Resultados.
  • Excluir: Permite a exclusão de um ou mais eventos selecionados na Grid de Resultados. Esta ação deve ser utilizada com cautela, geralmente requer confirmação e possui validações que determinam se a exclusão é permitida.
  • Enviar: Envia os eventos selecionados para processamento.
  • Retornar: Opção que consulta e atualiza o evento conforme retorno da Sefaz.
  • Atualizar: Recarrega a lista de eventos na Grid de Resultados, aplicando os filtros atualmente configurados, para exibir as informações mais recentes.
  • Cancelar: Cancela os eventos selecionados na Grid, gerando automaticamente um evento de cancelamento vinculado ao evento original. O sistema valida o status atual do evento antes de criar o evento de cancelamento.
  • Profile: Acessa as configurações de perfil do usuário, que podem incluir preferências de exibição da tela, filtros padrão ou outras personalizações.
  • Sair: Fecha a tela "Central de Eventos", retornando o usuário para a tela anterior ou para o menu principal do sistema.

Principais Campos e Parâmetros

A tela "Central de Eventos" é dividida em três áreas principais: Área de Filtros/Pesquisa, Grid de Resultados e a funcionalidade de Detalhe.

3.1. Área de Filtros/Pesquisa

Esta seção permite refinar a busca por eventos, utilizando diversos critérios para localizar ocorrências específicas.

  • Empresa: Código ou nome da empresa à qual o evento está relacionado. Este campo é Opcional, de formato alfanumérico. Um lookup (🔍) permite pesquisar e selecionar uma empresa cadastrada.
  • Período (De/Até): Intervalo de datas para filtrar os eventos. Refere-se à data de inclusão ou ocorrência do evento. Este campo é Opcional, no formato DD/MM/AAAA. Consistência: A data "De" deve ser anterior ou igual à data "Até". O ícone de calendário (📅) facilita a seleção.
  • Evento: Código do evento. Este campo é Opcional, de formato alfanumérico. Um lookup (🔍) permite pesquisar e selecionar um tipo de evento cadastrado (ex: 211130 - Imobilização de Item).
  • Ambiente: Ambiente de origem do evento no sistema. Este campo é Opcional, com valores permitidos selecionáveis por um dropdown: "Produção" ou "Homologação".
  • Status envio: Status atual do envio ou processamento do evento. Este campo é Opcional, com valores permitidos selecionáveis por um dropdown: "Pendente de envio", "Enviado, aguardando retorno de autorização", "Autorizado", "Cancelamento enviado, aguardando retorno", "Cancelamento autorizado", "Rejeitado".
  • Origem: Módulo ou área do sistema onde o evento foi gerado. Este campo é Opcional, com valores permitidos selecionáveis por um dropdown: "Contas a Pagar", "Contas a Receber", "Faturamento", "Financeiro", "Fiscal", "Patrimônio", "Suprimentos", "Outros".
  • Nota fiscal: Número da nota fiscal associada ao evento. Este campo é Opcional, de formato numérico. Um lookup (🔍) permite pesquisar notas fiscais.
  • Série: Série da nota fiscal associada. Este campo é Opcional, de formato alfanumérico.
  • Cliente/Fornecedor: Código ou nome do cliente/fornecedor envolvido na nota fiscal do evento. Este campo é Opcional, de formato alfanumérico. Um lookup (🔍) permite pesquisar e selecionar clientes/fornecedores.
  • Chave Nfe: Chave de acesso da Nota Fiscal Eletrônica (NFe) de 44 dígitos. Este campo é Opcional, de formato numérico, 44 dígitos.

3.2. Grid de Resultados

Exibe a lista de eventos encontrados de acordo com os filtros aplicados. Os ícones de seta ao lado dos cabeçalhos das colunas sugerem a possibilidade de ordenação.

  • Selec.: Caixa de seleção (checkbox) para selecionar um ou mais eventos para ações em lote. Permite a seleção múltipla para ações como Excluir, Enviar ou Cancelar.
  • Empresa: Código ou nome da empresa relacionada ao evento. Identifica a entidade responsável ou envolvida no evento.
  • Evento: Código ou identificador único do evento. Referencia o tipo de evento (ex: 211130 - Imobilização de Item).
  • Descrição do evento: Descrição detalhada do evento. Nome compreensível do evento.
  • Status Envio: Status atual do processamento ou envio do evento. Indicadores como "Autorizado", "Pendente de envio", "Rejeitado", etc. Reflete o ciclo de vida do evento.
  • Origem: Módulo ou área do sistema onde o evento foi gerado (e.g., Fiscal, Faturamento). Fornece o contexto de origem do evento.
  • Data inclusão: Data em que o evento foi registrado no sistema. Essencial para o rastreamento e auditoria.
  • Seq. evento: Número sequencial do evento. Identificador sequencial do evento.
  • Nota fiscal: Número da nota fiscal associada ao evento. É o número da NF-e que originou ou está relacionada ao evento.
  • Série: Série da nota fiscal associada. É a série do documento fiscal.
  • Data Entrada/Emissão: Data de entrada ou emissão do documento fiscal associado. Data de referência do documento fiscal.
  • Cliente/Fornecedor: Nome ou código do cliente/fornecedor envolvido na transação. Identifica a contraparte da operação.
  • Chave Nfe: Chave de acesso da NFe associada. É a chave de 44 dígitos da Nota Fiscal Eletrônica.
  • Ambiente: Ambiente em que o evento foi processado (Produção/Homologação). Indica se o evento foi gerado em um ambiente de testes ou real.
  • Lote: Número do lote de processamento. Se o evento foi enviado em um lote (conjunto de eventos).
  • Protocolo: Número do protocolo gerado para o evento. Identificador único de autorização do evento.
  • Detalhe: Ícone de lupa (🔍) que, ao ser clicado, abre uma tela ou seção com informações detalhadas. Funcionalidade Crucial: Ao clicar neste ícone, o sistema deve apresentar uma nova visualização ou modal contendo as informações completas do evento selecionado, incluindo documentos fiscais vinculados e a lista de itens relacionados. Esta funcionalidade permite aprofundar na análise de cada ocorrência.


A OBF26200 - Central de Eventos é o principal ponto de controle para o monitoramento abrangente de todos os eventos fiscais, incluindo aqueles da Reforma Tributária (IBS/CBS), conforme a NT 2025.002-RTC. Sua integração com o OBF26000 - Cockpit de Eventos, combinada com filtros robustos e a funcionalidade de "Detalhe", garante transparência, rastreabilidade e a capacidade de agir proativamente sobre o ciclo de vida dos eventos.

Detalhe

01. VISÃO GERAL

A funcionalidade "Detalhe" na tela OBF26200 - Central de Eventos é um componente crucial para a análise aprofundada de qualquer evento fiscal ou operacional registrado no sistema. Ao acionar o ícone de lupa (🔍) associado a um evento específico na grade de resultados, o sistema proporciona uma visão completa de todas as informações pertinentes a essa ocorrência. Isso inclui os dados cadastrais e de processamento do evento, detalhes dos documentos fiscais vinculados (especialmente a NF-e Modelo 55), e, se aplicável, uma lista minuciosa dos itens relacionados, com suas quantidades, valores de IBS/CBS, Códigos de Situação Tributária (CST) e classificações tributárias.

Essa visão integrada é vital para a auditoria, rastreabilidade e compreensão completa das transações fiscais e operacionais. Ela capacita os usuários a verificar a conformidade com a Reforma Tributária (IBS, CBS) e as especificações da Nota Técnica 2025.002-RTC, oferecendo acesso rápido a todas as informações contextuais necessárias para análise e tomada de decisão.

02. SITUAÇÃO/REQUISITO

Em um ambiente de gestão de eventos fiscais, como o proposto pela Reforma Tributária e detalhado na Nota Técnica 2025.002-RTC, a complexidade das informações associadas a cada evento é significativa. Um evento pode estar ligado a uma NF-e, conter múltiplos itens com tributações específicas (IBS/CBS), ter um status de processamento particular e possuir um histórico de interações. A OBF26200 - Central de Eventos fornece uma visão agregada, mas para fins de auditoria, resolução de problemas, contestação de status ou para simplesmente entender o impacto fiscal detalhado de uma ocorrência, era necessário ir além da visão resumida da grade.

O requisito fundamental era fornecer uma capacidade de "drill-down" ou detalhamento que permitisse ao usuário:

  1. Acesso Granular aos Dados: Visualizar todos os atributos de um evento, seus documentos e itens relacionados em um único local, sem a necessidade de navegar por múltiplas telas ou programas.
  2. Transparência e Auditoria: Oferecer todas as informações necessárias para auditar o ciclo de vida de um evento, desde sua criação até seu status final, incluindo o que foi enviado e quais foram os resultados.
  3. Contextualização Fiscal: Entender o impacto de um evento sobre os itens de uma NF-e, incluindo a base de cálculo e os valores de IBS/CBS, especialmente relevante para os novos tributos.
  4. Conformidade Documental: Acessar os detalhes da NF-e vinculada, como chave de acesso e data de emissão, garantindo que o evento esteja corretamente referenciado.

03. SOLUÇÃO

A funcionalidade "Detalhe" foi implementada na OBF26200 - Central de Eventos para proporcionar uma visão aprofundada e consolidada de cada evento individual. Ela é ativada através de um ícone de lupa (🔍) presente em cada linha da grade de resultados.

Passo 01: Acionamento da Funcionalidade

  • Na OBF26200 - Central de Eventos, após a aplicação de filtros e a exibição dos eventos na "Grid de Resultados", o usuário localiza o evento que deseja analisar em profundidade.
  • Ao clicar no ícone de lupa (🔍) localizado na coluna "Detalhe" da linha correspondente ao evento, o sistema aciona a funcionalidade.

Passo 02: Apresentação da Visão Detalhada

  • Ao ser acionada, a funcionalidade "Detalhe" abre uma nova tela, um modal ou um painel lateral, contendo todas as informações relevantes para o evento selecionado, estruturadas em seções claras:
    • Informações completas do evento selecionado:
      • Serão exibidos todos os dados cadastrais e de processamento do evento, incluindo: Código do Evento, Descrição, Versão do Leiaute (conforme OBF26100), Tipo de Autor, Origem, Ambiente de processamento, Status de Envio, Data de Inclusão, Número Sequencial do Evento, Lote e Protocolo de Autorização.
    • Acesso aos documentos fiscais vinculados:
      • Detalhes da Nota Fiscal Eletrônica (NF-e Modelo 55) associada ao evento serão apresentados. Isso inclui: Número da Nota Fiscal, Série, Tipo de Nota Fiscal, Espécie, Data de Entrada/Emissão, Fornecedor/Cliente envolvido, e a crucial Chave de Acesso da NF-e de 44 dígitos.
    • A lista de itens relacionados:
      • Esta seção é exibida condicionalmente, ou seja, apenas se o tipo de evento (conforme configurado em OBF26100 com "Gera informações dos itens?" marcado e especificado nos leiautes da NT 2025.002-RTC) prevê o detalhamento de itens.
      • Quando presente, uma grade ou lista detalhará cada item da NF-e impactado pelo evento. Para cada item, serão mostrados: Código do Item, Descrição, Quantidade, Unidade de Medida, Valor de IBS e CBS, Código de Situação Tributária (CST), Classificação Tributária, e outros dados específicos que foram preenchidos ou calculados no contexto do evento (ex: Estorno de Crédito, Inventário, NFE Referência).

04. DEMAIS INFORMAÇÕES

A funcionalidade "Detalhe" na OBF26200 transcende a simples exibição de dados; ela se configura como uma ferramenta analítica e de auditoria, indispensável para a gestão fiscal moderna. A capacidade de navegar de uma visão sumária para um nível de detalhe tão granular é fundamental para:

  • Diagnóstico de Problemas: Identificar a raiz de um evento rejeitado ou com status inesperado, analisando o XML, os dados da NF-e e os valores de item.
  • Validação de Conformidade: Assegurar que os valores de IBS/CBS nos itens estejam corretos e que o evento esteja em conformidade com as regras específicas da NT 2025.002-RTC.
  • Suporte a Contestações: Fornecer informações completas para responder a questionamentos internos ou externos sobre a natureza e o impacto de um evento.
  • Tomada de Decisão Estratégica: Oferecer insights sobre o comportamento dos eventos e seus efeitos sobre a apuração de impostos.

A interconectividade das informações exibidas – desde o status do evento até os detalhes do item – reforça a rastreabilidade e a transparência que são pilares da Reforma Tributária.


A funcionalidade "Detalhe" na OBF26200 é o ponto de acesso para a visão completa e auditável de um evento. Ao clicar no ícone (🔍), o usuário obtém todos os dados do evento, da NF-e vinculada e, condicionalmente, dos itens relacionados, incluindo seus aspectos fiscais de IBS/CBS, em conformidade com a NT 2025.002-RTC, garantindo transparência e suporte à decisão.

1- Dados Gerais



2 - XML


01. VISÃO GERAL

A aba "2 - XML" da tela "Detalhar Evento" (OBF26200) é acessada a partir da "Central de Eventos" e tem como objetivo principal exibir o conteúdo bruto do arquivo XML que foi gerado para o evento selecionado. Esta aba é uma ferramenta de consulta e verificação técnica, apresentando o XML em modo de somente leitura.

A importância desta aba reside na capacidade de:

  • Verificar a Estrutura: Permite confirmar se o XML está corretamente estruturado, aderindo aos schemas definidos na Nota Técnica 2025.002-RTC.
  • Auditoria de Conteúdo: Possibilita inspecionar os valores e tags gerados para o evento, garantindo que todas as informações necessárias (como dados da NF-e, itens, valores de IBS/CBS, códigos de classificação tributária) foram incluídas conforme as regras de negócio e as especificações da NT.
  • Diagnóstico de Erros: Em casos de rejeição ou processamento incorreto do evento, o conteúdo do XML pode ser crucial para identificar a causa raiz do problema, comparando-o com os requisitos da autoridade fiscal.
  • Conformidade: Assegura que o XML gerado está em plena conformidade com os leiautes e versões especificados pela legislação, como os schemas envEventoNFe_v9.99.xsd e os schemas específicos para cada tipo de evento (ex: e211130_v1.00.xsd), que são referenciados na NT 2025.002-RTC.

É uma visão essencial para usuários técnicos, desenvolvedores e analistas fiscais que precisam validar a integridade e precisão dos dados fiscais eletrônicos.



03. TELA Detalhar Evento - Aba "2 - XML" (OBF26200)

Outras Ações / Ações relacionadas

Esta aba, sendo uma interface de visualização de detalhes técnicos, possui um conjunto limitado de ações, focando na inspeção do XML.

AçãoDescrição
FecharFecha a tela "Detalhar Evento", retornando o usuário para a "Central de Eventos" (OBF26200). Este botão (geralmente um "X" ou "Fechar" no canto) encerra a visualização do detalhe.




04. TELA Detalhar Evento - Aba "2 - XML" (OBF26200)

Principais Campos e Parâmetros

A aba "2 - XML" contém uma única área de exibição principal: o campo de texto que mostra o conteúdo XML. Todos os campos são de somente leitura.

CampoDescriçãoFormato e Observações
Conteúdo XMLÁrea de texto expandida que exibe a representação estruturada em formato XML do evento que está sendo detalhado. Este é o XML que seria enviado (ou foi enviado) para a autoridade fiscal.Formato: XML. O conteúdo reflete a estrutura definida pelos schemas da NT 2025.002-RTC.
Modo: Somente leitura.




3 - Auditoria


01. VISÃO GERAL

A aba "3 - Auditoria" da tela "Detalhar Evento" (OBF26200), acessada a partir da "Central de Eventos", tem como finalidade principal rastrear e registrar todas as alterações e interações significativas que ocorreram com o evento selecionado desde a sua criação. Esta aba funciona como um histórico detalhado, fornecendo uma trilha de auditoria completa, essencial para a governança, conformidade e resolução de problemas.

Em um contexto de eventos fiscais, como os regidos pela Nota Técnica 2025.002-RTC, a capacidade de auditar cada etapa do ciclo de vida de um evento é fundamental para:


  • Conformidade Legal: Demonstra que os processos seguiram as regras estabelecidas e que todas as interações foram registradas.
  • Rastreabilidade: Permite identificar quem realizou determinada ação, quando e o que foi alterado, desde a inclusão até qualquer alteração de status ou conteúdo.
  • Diagnóstico: Facilita a investigação de divergências, rejeições ou inconsistências, ao apresentar a sequência exata de eventos e ações.
  • Segurança: Reforça a integridade dos dados ao registrar todas as modificações, prevenindo fraudes e garantindo a confiabilidade das informações fiscais.


Esta aba, geralmente em modo de somente leitura, oferece uma visão cronológica de todas as operações que impactaram o evento, garantindo transparência e controle sobre o fluxo de informações fiscais e operacionais.


03. TELA Detalhar Evento - Aba "1 - Dados Gerais" (OBF26200)

Outras Ações / Ações relacionadas

Esta aba, sendo uma interface de visualização de detalhes em somente leitura, possui um conjunto limitado de ações diretamente na sua superfície. As ações para modificar, confirmar, cancelar ou sair da tela principal "Detalhar Evento" (OBF26200) estão localizadas na barra de botões acima das abas.

AçãoDescrição
SairFecha a tela "Detalhar Evento", retornando o usuário para a "Central de Eventos" (OBF26200).




Seção: Dados do Evento

Esta seção exibe os identificadores principais e o status do evento.

CampoDescriçãoFormato e Observações
EventoCódigo ou identificador único atribuído ao evento.Numérico. 
Status envioIndica o estado atual do processamento ou da comunicação do evento com os sistemas externos.Texto descritivo (ex: "Autorizado", "Rejeitado", "Pendente"). Reflete o status de processamento do evento, como os status de autorização descritos em NT 2025.002-RTC.
ID do eventoUm identificador único e completo para a instância específica do evento.Alfanumérico longo. É um identificador composto que garante a unicidade da ocorrência do evento, como o ID do elemento infProt nos protocolos de autorização (NT 2025.002-RTC).





Seção: Detalhamento auditoria

Esta seção oferece um registro conciso das principais interações com o evento.

CampoDescriçãoFormato e Observações
Data/hora inclusãoA data e hora exata em que o evento foi originalmente registrado no sistema.Data e Hora (DD/MM/AAAA HH:MM:SS). Este é o registro de quando o evento foi primeiramente criado ou recebido.
Usuário inclusãoO nome do usuário que executou a operação de inclusão do evento.Alfanumérico. Identifica a autoria da criação do evento.
Data/hora envioA data e hora em que o evento foi submetido para processamento ou para o sistema externo (ex: SEFAZ).Data e Hora (DD/MM/AAAA HH:MM:SS). Registra quando a comunicação do evento foi efetivamente realizada.
Usuário envioO nome do usuário que iniciou a operação de envio do evento.Alfanumérico. Identifica quem solicitou o envio do evento.
Data/hora cancelamentoA data e hora em que o evento foi solicitado o cancelado no sistema.Data e Hora (DD/MM/AAAA HH:MM:SS). 
Usuário cancelamentoO nome do usuário que executou a solicitado o cancelado no sistema.Alfanumérico. Identifica quem solicitou o cancelamento do evento.
Tipo inclusãoO método ou processo pelo qual o evento foi inserido no sistema.Texto descritivo (ex: "Manual", "Automático"). Indica a forma como o registro inicial foi realizado.

4 - Autorização 


01. VISÃO GERAL

A aba "4 - Autorização" da tela "Detalhar Evento" (OBF26200) é a interface designada para apresentar o resultado final do processamento de um evento eletrônico, focando nas informações de sua autorização ou cancelamento. Esta aba é acessada a partir da "Central de Eventos" e serve como um resumo do status de conformidade do evento. Todos os campos nesta aba são exibidos em modo de somente leitura.

Ela fornece dados cruciais para a validação fiscal, incluindo:

  • Identificação do Evento: Confirma qual evento está sendo detalhado.
  • Status de Envio: O estado atual e oficial do evento, se foi autorizado, rejeitado ou cancelado.
  • Detalhamento da Autorização/Cancelamento: As datas, horas e protocolos associados à autorização ou, se aplicável, ao cancelamento do evento.
  • Mensagem de Retorno: Qualquer informação adicional ou código de erro fornecido pelo sistema autorizador.

Esta aba é fundamental para analistas fiscais, equipes de suporte e auditores que precisam rapidamente verificar se um evento foi processado com sucesso e qual protocolo foi gerado, garantindo a conformidade com as exigências fiscais e as especificações de comunicação de eventos, como as delineadas na Nota Técnica 2025.002-RTC.


03. TELA Detalhar Evento - Aba "4 - Autorização" (OBF26200)

Outras Ações / Ações relacionadas

Esta aba é uma interface de visualização de detalhes em somente leitura. As ações de manipulação ( Sair) localizadas na barra de botões superior aplicam-se ao evento de forma geral e não diretamente a esta aba específica.

AçãoDescrição
SairFecha a tela "Detalhar Evento", retornando o usuário para a "Central de Eventos" (OBF26200).




04. TELA Detalhar Evento - Aba "4 - Autorização" (OBF26200)

Principais Campos e Parâmetros

A aba "4 - Autorização" apresenta os detalhes sobre o status de autorização do evento. Todos os campos são de somente leitura.


Seção: Informações do Evento

Esta seção identifica o evento e seu status geral de processamento.

CampoDescriçãoFormato e Observações
EventoCódigo ou identificador único atribuído ao evento.Numérico. 
Status envioIndica o estado atual do processamento ou da comunicação do evento com os sistemas externos.Texto descritivo (ex: "Autorizado", "Rejeitado", "Pendente"). Reflete o status de processamento do evento, como os status de autorização descritos em NT 2025.002-RTC.





Seção: Detalhamento de Autorização

Esta seção fornece os detalhes específicos do processo de autorização ou cancelamento.

CampoDescriçãoFormato e Observações
Data/hora autorizaçãoA data e hora exata em que o evento foi oficialmente autorizado pelo sistema ou autoridade fiscal.Data e Hora (DD/MM/AAAA HH:MM:SS). Por exemplo, 16/11/2025 11:00:53. Este campo é preenchido quando o Status envio é "Autorizado".
Protocolo autorizaçãoO número de protocolo único atribuído ao evento no momento de sua autorização.Numérico. Por exemplo, 342250001700187. Este protocolo serve como comprovante da autorização do evento e é um campo chave na NT 2025.002-RTC.
Data/hora cancelamentoA data e hora exata em que o evento foi oficialmente cancelado.Data e Hora (DD/MM/AAAA HH:MM:SS). Este campo estará vazio se o evento não foi cancelado. É preenchido quando um evento de cancelamento (110001) é autorizado para este evento, conforme NT 2025.002-RTC.
Protocolo cancelamentoO número de protocolo único atribuído ao evento de cancelamento.Numérico. Este protocolo serve como comprovante da autorização do cancelamento do evento conforme NT 2025.002-RTC.
Mensagem de retornoUma área de texto para exibir mensagens detalhadas, códigos de erro ou informações adicionais recebidas do sistema autorizador.Texto. Caso houvesse rejeição, a mensagem de retorno seria crucial para entender o motivo, como as descrições de erro.

Evento Cancelado

01. VISÃO GERAL

Funcionalidade de Cancelamento de Eventos

Na tela "Detalhar Evento" (OBF26200), apenas as abas "1 - Dados Gerais", "3 - Auditoria",  "4 - autorização" são modificadas para eventos de cancelamento, enquanto as demais abas permanecem inalteradas.

Evento 110001 - Cancelamento de Evento

Quando exibido um evento do tipo 110001, a tela tem como objetivo principal apresentar uma visão consolidada e o status da solicitação de cancelamento de um evento previamente registrado. A interface opera exclusivamente em modo de leitura, permitindo ao usuário revisar todos os detalhes da operação de cancelamento.

Estrutura da Aba "Dados Gerais"

Esta aba é fundamental para compreender o estado do processo de cancelamento e está organizada em duas seções principais:

Dados do Evento: Apresenta os identificadores principais e o status atual da solicitação de cancelamento (referente ao próprio evento 110001)

Detalhes do Cancelamento: Seção específica para eventos de cancelamento que referencia diretamente o evento original alvo da solicitação de anulação, exibindo seu código e protocolo

Importância para Auditoria

Esta funcionalidade é essencial para o monitoramento e auditoria de cancelamentos de eventos fiscais, garantindo transparência sobre:

  • Qual evento foi cancelado
  • Quem solicitou o cancelamento
  • Status atual da solicitação

Tudo em conformidade com as diretrizes estabelecidas na Nota Técnica 2025.002-RTC.



1 - Dados Gerais

02. TELA Detalhar Evento - Aba "1 - Dados Gerais" (OBF26200) - Evento de Cancelamento

Outras Ações / Ações relacionadas

Esta aba, sendo uma interface de visualização de detalhes em somente leitura, possui um conjunto limitado de ações diretamente na sua superfície. As ações para modificar, confirmar, cancelar ou sair da tela principal "Detalhar Evento" (OBF26200) estão localizadas na barra de botões acima das abas.

AçãoDescrição
SairFecha a tela "Detalhar Evento", retornando o usuário para a "Central de Eventos" (OBF26200).




03. TELA Detalhar Evento - Aba "1 - Dados Gerais" (OBF26200) - Evento de Cancelamento

Principais Campos e Parâmetros

A aba "1 - Dados Gerais" apresenta informações essenciais sobre a solicitação de cancelamento do evento. Todos os campos são de somente leitura.


Seção: Dados do Evento

Esta seção exibe os identificadores principais e o status do evento de cancelamento (Evento 110001).

CampoDescriçãoFormato e Observações (conforme ANALYZE_IMAGES RESULT)
EventoO código identificador do próprio evento de cancelamento.Numérico. Exatamente 110001 para "Cancelamento de Evento" (NT 2025.002-RTC)
Versão do leiauteA versão do leiaute do evento de cancelamento.Numérico. Exatamente 1.00, conforme NT 2025.002-RTC.
Data inclusãoA data em que o evento de cancelamento foi registrado no sistema.Data (DD/MM/AAAA). 
Usuário inclusãoO nome do usuário que incluiu o evento de cancelamento.Alfanumérico. 
Órgão autorO código do órgão autor da solicitação de cancelamento.Numérico. "O mesmo Autor do Evento que está sendo cancelado". 
Tipo autorO tipo de entidade que é o autor da solicitação de cancelamento.Define que o autor do evento de cancelamento é "O mesmo Autor do Evento que está sendo cancelado". 
SequênciaO número sequencial deste evento de cancelamento.Numérico. 
OrigemA origem do evento de cancelamento no sistema.A mesma origem do Evento que está sendo cancelado. 
AmbienteO ambiente em que o evento de cancelamento foi processado.O mesmo ambiente do Evento que está sendo cancelado. 
LoteO identificador do lote, se o evento de cancelamento foi enviado em lote.Alfanumérico. 
Status envioO status atual do envio e processamento da solicitação de cancelamento.Texto. 
Indicador de aceitaçãoO status de aceitação da própria solicitação de cancelamento.Campo de seleção. Exatamente "Não aceite", conforme a imagem.





Seção: Detalhes do cancelamento

Esta seção é exibida especificamente para eventos de cancelamento (110001) e informa sobre o evento original que está sendo cancelado.

CampoDescriçãoFormato e Observações (conforme ANALYZE_IMAGES RESULT)
EventoO código do evento original que está sendo cancelado pela solicitação atual.Numérico. 
ProtocoloO número do protocolo de autorização do evento original que está sendo cancelado.Numérico. 
Consultar EventoUm botão que permite abrir diretamente a tela de detalhe do evento original referenciado.Ação. Ao clicar, o sistema carregaria a tela "Detalhar Evento" para o evento de origem.



3 - Auditoria

03. TELA Detalhar Evento - Aba "3 - Auditoria" (OBF26200)

Outras Ações / Ações relacionadas

Esta aba, sendo uma interface de visualização de detalhes em somente leitura, possui um conjunto limitado de ações diretamente na sua superfície. A ação sair da tela principal "Detalhar Evento" (OBF26200) estão localizadas na barra de botões acima das abas.

AçãoDescrição
SairFecha a tela "Detalhar Evento", retornando o usuário para a "Central de Eventos" (OBF26200).



04.
TELA Detalhar Evento - Aba "3 - Auditoria" (OBF26200)

Principais Campos e Parâmetros

A aba "3 - Auditoria" apresenta informações essenciais sobre o evento que está sendo visualizado. Todos os campos são de somente leitura.

Seção: Dados do Evento

Esta seção exibe os identificadores principais e o status do evento, conforme visível na imagem.

CampoDescriçãoFormato e Observações (conforme a imagem)
EventoO código identificador único do evento.Numérico. Exemplo: 110001 (indicando um evento de "Cancelamento de Evento", conforme NT 2025.002-RTC)
Status envioIndica o estado atual do processamento ou da comunicação do evento com os sistemas externos.Texto descritivo. Exemplo: "Cancelamento enviado, aguardando retorno" (indicando que a solicitação de cancelamento foi enviada e o sistema aguarda uma resposta do ambiente autorizador).
ID do eventoUm identificador único e completo para a instância específica do evento.Alfanumérico longo. Exemplo: "ID1100014219105311379100179055003000100232100010023202". Este é o identificador completo do evento, similar ao ID do elemento infProt nos protocolos de autorização (NT 2025.002-RTC).





Seção: Detalhamento auditoria

Esta seção oferece um registro conciso das principais interações com o evento, conforme visível na imagem.

CampoDescriçãoFormato e Observações (conforme a imagem)
Data/hora inclusãoA data e hora exata em que o evento foi originalmente registrado no sistema.Data e Hora (DD/MM/AAAA HH:MM:SS). 
Usuário inclusãoO nome do usuário que executou a operação de inclusão do evento.Alfanumérico. 
Data/hora envioA data e hora em que o evento foi submetido para processamento ou para o sistema externo (ex: SEFAZ).Data e Hora (DD/MM/AAAA HH:MM:SS). 
Usuário envioO nome do usuário que iniciou a operação de envio do evento.Alfanumérico. 
Tipo inclusãoO método ou processo pelo qual o evento foi inserido no sistema.Texto descritivo. Exemplo: "Manual". Indica a forma como o registro inicial foi realizado (ex: Manual, Automático, via API).




Autorização 


03. TELA Detalhar Evento - Aba "4 - Autorização" (OBF26200) - Evento de Cancelamento Autorizado

Outras Ações / Ações relacionadas

Esta aba é uma interface de visualização de detalhes em somente leitura. As ações de manipulação ( Sair) localizadas na barra de botões superior aplicam-se ao evento de forma geral e não diretamente a esta aba específica.

AçãoDescrição
SairFecha a tela "Detalhar Evento", retornando o usuário para a "Central de Eventos" (OBF26200).




04. TELA Detalhar Evento - Aba "4 - Autorização" (OBF26200) - Evento de Cancelamento Autorizado

Principais Campos e Parâmetros

A aba "4 - Autorização", quando exibe um evento de cancelamento (110001) que foi autorizado, apresenta os seguintes campos. Todos são de somente leitura.

Seção: Informações do Evento

Esta seção identifica o evento de cancelamento e seu status geral de processamento.

CampoDescriçãoFormato e Observações
EventoO número identificador único do evento que está sendo detalhado. Para este cenário, sempre será 110001.Numérico. Exatamente 110001.
Status envioO status atual do processamento do evento de cancelamento.Texto descritivo. 





Seção: Detalhamento de Autorização

Esta seção fornece os detalhes específicos do processo de autorização do próprio evento de cancelamento.

CampoDescriçãoFormato e Observações
Data/hora autorizaçãoA data e hora exata em que o evento de cancelamento (110001) foi oficialmente autorizado pela Sefaz.Data e Hora (DD/MM/AAAA HH:MM:SS). Este campo é preenchido com a data e hora da resposta de sucesso do serviço de autorização de eventos.
Protocolo autorizaçãoO número de protocolo único atribuído ao evento de cancelamento no momento de sua autorização.Numérico. Este protocolo é o identificador da autorização da solicitação de cancelamento. Conforme a NT 2025.002-RTC é um código que atesta o registro do evento.
Mensagem de retornoUma área de texto para exibir a mensagem de sucesso ou informações adicionais recebidas do sistema autorizador.Texto. Geralmente, uma mensagem de "Evento registrado e autorizado com sucesso" ou similar. Em caso de sucesso, este campo é conciso ou vazio.


05. TABELAS UTILIZADAS







05. ASSUNTOS RELACIONADOS