CONTEÚDO

Visão Geral
Exemplo de utilização
Tela XXX
1. Outras Ações / Ações relacionadas
Tela XXX
1. Principais Campos e Parâmetros
Tabelas utilizadas

01. VISÃO GERAL

Descreva a visão geral.

02. EXEMPLO DE UTILIZAÇÃO

Use esse espaço para colocar exemplos de utilização.

03. TELA XXXXX

Outras Ações / Ações relacionadas

Ação	Descrição
Inclua a ação	Inclua a descrição relacionada
Inclua a ação	Inclua a descrição relacionada
Inclua a ação	Inclua a descrição relacionada

04. TELA XXXXX

Principais Campos e Parâmetros

Campo	Descrição
Inclua o campo	Inclua a descrição relacionada
Inclua o campo	Inclua a descrição relacionada
Inclua o campo	Inclua a descrição relacionada

Documentação de Referência do Programa OBF25100 - Consulta de Documentos Fiscais

CONTEÚDO

Visão Geral
Exemplo de utilização
Tela OBF25100 - Consulta dos Documentos Fiscais
- Outras Ações / Ações relacionadas
Tela de Detalhes da Nota Fiscal
- Outras Ações / Ações relacionadas
Tela de Detalhamento do Item
- Outras Ações / Ações relacionadas
Principais Campos e Parâmetros
Tabelas utilizadas

01. VISÃO GERAL

O programa OBF25100 - Consulta de Documentos Fiscais é uma ferramenta completa para gestão e análise de documentos fiscais empresariais. O sistema oferece três níveis de consulta hierárquicos que permitem navegação detalhada através dos dados fiscais:

🔍 Estrutura de Navegação em 3 Níveis

📊 Tela 1 - Consulta Geral: Visualização panorâmica de todos os documentos fiscais com filtros avançados
📋 Tela 2 - Detalhes da Nota Fiscal: Informações completas de um documento específico e seus itens
🏛️ Tela 3 - Detalhamento do Item: Análise tributária detalhada de cada item/serviço do documento

🎯 Principais Funcionalidades

Filtros Avançados: Período, origem, empresa, cliente/fornecedor, situação, CFOP, classificação tributária
Navegação Intuitiva: Fluxo lógico através de ícones de detalhe (🔍)
Análise Tributária Completa: Breakdown detalhado de todos os tributos por item
Suporte à Nova Legislação: Compatível com IBS/CBS da reforma tributária
Exportação de Dados: Geração de relatórios e planilhas
Legenda Visual: Identificação rápida por cores dos tipos de documento

02. EXEMPLO DE UTILIZAÇÃO

Cenário: Auditor fiscal precisa verificar a conformidade tributária de itens específicos em notas fiscais de entrada de um fornecedor no último trimestre.

🔄 Fluxo Completo de Navegação

Etapa 1 - Consulta Geral (Tela 1)

Acesse o Programa: Abra o programa OBF25100
Defina Filtros:
- Período: 01/04/2025 a 30/06/2025
- Origem: "Entradas"
- Cliente/Fornecedor: "SCCONTRIB" (use a lupa para pesquisar)
Execute Pesquisa: Clique no botão [Pesquisar] 🔍
Analise Resultados: Visualize os documentos na grade inferior
Selecione Documento: Clique na lupa 🔍 da coluna "Detalhe" da nota desejada

Etapa 2 - Detalhes da Nota (Tela 2)

Verifique Cabeçalho: Analise informações gerais do documento (valor total, data, situação)
Examine Itens: Visualize a lista completa de itens da nota fiscal
Selecione Item: Clique na lupa 🔍 da coluna "Detalhe" do item a ser analisado

Etapa 3 - Detalhamento Tributário (Tela 3)

Analise Tributos: Examine o breakdown completo de todos os tributos aplicados
Verifique Conformidade: Confirme alíquotas, bases de cálculo e valores
Documente Achados: Anote irregularidades ou pontos de atenção
Retorne: Use o botão [Sair] para voltar às telas anteriores

03. TELA OBF25100 - CONSULTA DOS DOCUMENTOS FISCAIS

Esta é a tela principal do programa, ponto de entrada para toda a análise fiscal. Organizada em quatro seções funcionais que proporcionam uma visão abrangente dos documentos fiscais da empresa.

Layout da Interface

🔧 Barra de Ferramentas Superior

Botões de ação global e configurações do programa

📋 Painel de Filtros (Esquerda)

Critérios de pesquisa para localização precisa de documentos

🏷️ Painel de Legenda (Direita)

Explicação visual dos tipos de documento por cores

📊 Grade de Resultados (Inferior)

Lista dinâmica dos documentos fiscais encontrados

Outras Ações / Ações relacionadas

Botão/Ícone	Nome	Função
🔍	Pesquisar	Executa a busca com base nos filtros informados e atualiza a grade de resultados
📊	Exportar	Exporta os dados da grade para formato externo (Excel, CSV)
👤	Profile	Configurações de perfil e preferências do usuário
🚪	Sair	Fecha a tela de consulta de documentos fiscais
❓	Ajuda	Abre documentação de ajuda contextual
❌	Fechar	Fecha completamente o programa OBF25100

Filtros de Pesquisa Disponíveis

📅 Período: Campos de data (De/Até) com seletor de calendário

🏢 Origem: Dropdown para tipo de origem (Fiscal, Contábil)

🏭 Empresa origem: Campo com pesquisa (lupa) para seleção de empresa

👥 Cliente/Fornecedor: Campos com pesquisa (lupa) para parceiros

📋 Situação nota fiscal: Dropdown com status (Normal, Cancelada, etc.)

📄 Nota fiscal: Campo com pesquisa (lupa) para número específico

📦 Item: Campo com pesquisa (lupa) para item específico

🏷️ CFOP: Campo com pesquisa (lupa) para código fiscal

⚖️ Class. Tributária IBS/CBS: Campo com pesquisa (lupa) para classificação

Legenda de Tipos de Documento

Ícone	Tipo	Descrição
🔵	Entradas	Documentos fiscais de entrada (compras, devoluções recebidas)
🔴	Saídas	Documentos fiscais de saída (vendas, remessas)
🟢	Serviços tomados	Notas fiscais de serviços contratados
⚫	Serviços prestados	Notas fiscais de serviços fornecidos

Grade de Resultados - Estrutura das Colunas

Coluna	Tipo	Descrição	Exemplo
Seleciona	Checkbox	Seleção múltipla para ações em massa	☑️
Legenda	Ícone colorido	Tipo de operação conforme legenda	🔵🔴🟢⚫
*Empresa origem	Texto	Código da empresa originadora	FI
*Data Entrada/Emissão	Data	Data do documento fiscal	27/06/2025
*Nota fiscal	Numérico	Número identificador do documento	623496
*Espécie	Texto	Tipo do documento (NFE, CON, NFS, CTE)	NFE
*Série	Alfanumérico	Série do documento fiscal	1, 01, N, U, S
*Situação	Texto	Status atual do documento	N (Normal)
*Cliente/Fornecedor	Texto	Código do parceiro comercial	SCCONTRIB
Descrição	Texto	Nome/descrição do parceiro	SC CONTRIBUINTE
Detalhe	Ícone 🔍	Navega para Tela 2 - Detalhes da Nota Fiscal	��

04. TELA DE DETALHES DA NOTA FISCAL

Esta é a segunda tela do programa, acessada através do ícone 🔍 na coluna "Detalhe" da grade de resultados da tela principal. Apresenta informações completas e detalhadas de um documento fiscal específico, permitindo análise do cabeçalho e navegação pelos itens.

Layout da Interface

A tela está organizada em duas seções principais:

📋 Seção Superior - Cabeçalho da Nota Fiscal

Informações gerais, identificação e valores totais do documento

📊 Seção Inferior - Grade de Itens

Lista detalhada de todos os itens/serviços da nota fiscal

Outras Ações / Ações relacionadas

Botão/Ícone	Nome	Função
🚪	Sair	Retorna para a tela anterior (Consulta dos Documentos Fiscais)
❓	Ajuda	Abre documentação de ajuda contextual para esta tela
❌	Fechar (X)	Fecha a janela de detalhes da nota fiscal
🔍	Detalhe do Item	Navega para Tela 3 - Detalhamento do Item

Seção de Cabeçalho - Informações Gerais

Campo	Valor Exemplo	Descrição
Empresa origem	FI	Código da empresa que registrou o documento
Origem	Entrada	Tipo de operação (Entrada/Saída)
Aviso Rec.	623496	Número do aviso de recebimento
Nota Fiscal	623496	Número identificador da nota fiscal
Espécie	NFE	Tipo de documento (NFE = Nota Fiscal Eletrônica)
Modelo	55	Modelo fiscal do documento (55 = NF-e padrão)
Série/Subsérie	1	Série do documento fiscal
Situação	Normal	Status atual do documento
Data Emissão/Entrada	27/06/2025	Data de emissão ou entrada do documento
Finalidade	(vazio)	Finalidade específica da operação
UF	SC	Unidade Federativa (Estado) - Santa Catarina
Cliente/Fornecedor	SCCONTRIB	Código do parceiro comercial
Nome/Descrição	SC CONTRIBUINTE	Razão social do cliente/fornecedor
Valor Nota Fiscal	14.000,00	Valor total da nota fiscal

Grade de Itens - Estrutura das Colunas

Coluna	Exemplo Item 1	Exemplo Item 2	Descrição
*Seq	1	2	Número sequencial do item na nota
*Item	INDUST.1	INDUST.2	Código identificador do produto/serviço
Descrição	INDUST.1	INDUST.2	Descrição do produto/serviço
*CFOP	1.101	1.101	Código Fiscal de Operações e Prestações
*UN	UN	UN	Unidade de medida (UN = Unidade)
*Quantidade	2.000000	1.000000	Quantidade do item
*Valor unitário	5.000,000000	4.000,000000	Preço por unidade
*Valor líquido	10.000,00	4.000,00	Valor total do item (Qtd × Valor Unit.)
*Valor contábil	10.000,00	4.000,00	Valor para fins contábeis
Detalhe	��	🔍	Navega para Tela 3 - Detalhamento do Item

Validações e Consistências

🧮 Validação Matemática:

Valor Total da Nota: 14.000,00
Soma dos Itens: 10.000,00 + 4.000,00 = 14.000,00 ✅
Consistência: O valor total da nota fiscal corresponde exatamente à soma dos valores líquidos dos itens

05. TELA DE DETALHAMENTO DO ITEM

Esta é a terceira tela do programa, acessada através do ícone 🔍 na coluna "Detalhe" da grade de itens da tela de Detalhes da Nota Fiscal. Apresenta informações tributárias completas e detalhadas de um item específico do documento fiscal.

Layout da Interface

A tela está organizada em duas seções principais:

📋 Seção Superior - Identificação do Item

Informações básicas e identificação do item selecionado

📊 Seção Inferior - Tabela Tributária Detalhada

Breakdown completo de todos os tributos aplicados ao item

Outras Ações / Ações relacionadas

Botão/Ícone	Nome	Função
🚪	Sair	Retorna para a tela anterior (Detalhes da Nota Fiscal)
❓	Ajuda	Abre documentação de ajuda contextual para esta tela
❌	Fechar (X)	Fecha a janela de detalhamento do item
▲▼	Ordenação	Permite ordenar colunas da tabela tributária (indicado pelos triângulos)

Principais Campos e Parâmetros

📋 Seção de Identificação do Item

Campo	Valor	Descrição
Seq.	1	Número sequencial do item na nota fiscal
Item	INDUST.1	Código identificador do produto/serviço
Nat. Oper./Grupo Despesa	1000	Natureza da operação ou grupo de despesa
CFOP	1.101	Código Fiscal de Operações e Prestações
NCM/NBS	0	Nomenclatura Comum do Mercosul / Nomenclatura Brasileira de Serviços

📊 Tabela Tributária Detalhada

Tributo	Incidência	CST	Base Cálculo	Alíquota (%)	Valor Tributo	Valor Outros
CBS	10	999999	8.300,00	9,000000	747,00	0,00
COFINS	300	-	0,00	0,000000	0,00	0,00
IBS_MUN	10	999999	8.300,00	14,000000	1.162,00	0,00
IBS_UF	10	000001	8.300,00	18,000000	1.494,00	0,00
ICMS	1000	-	10.000,00	17,000000	1.700,00	0,00
IPI	300	-	10.000,00	0,000000	0,00	10.000,00
PIS	300	-	0,00	0,000000	0,00	0,00

📋 Campos Adicionais da Tabela Tributária

Campos com Valores Zerados/Vazios (não exibidos na tabela principal):

Campo	Descrição	Valor Padrão
Clas. Tributária IBS/CBS	Classificação tributária específica	(vazio)
Redução BC	Percentual de redução da base de cálculo	0,000000
Redução Alíquota	Percentual de redução da alíquota	0,0000
Alíquota Efetiva	Alíquota final após reduções	(vazio)
Dif. Aliquota	Diferencial de alíquota	0,000000
Valor Trib. Diferencial	Valor do tributo diferencial	0,00
Perc. Diferido	Percentual diferido	(vazio)
Valor Diferido	Valor diferido	(vazio)
Cód. Apuração	Código de apuração	(vazio)
Cód. Ajuste	Código de ajuste	(vazio)
CBenef	Código de benefício	(vazio)

Análise Tributária do Item

💰 Resumo Financeiro

Descrição	Valor	Observação
Valor do Item	10.000,00	Valor base do produto (conforme tela anterior)
Total de Tributos	5.103,00	CBS + IBS_MUN + IBS_UF + ICMS
Carga Tributária	51,03%	Percentual de tributos sobre o valor do item

🏛️ Breakdown por Esfera Governamental

Federal: CBS (747,00)
Estadual: IBS_UF (1.494,00) + ICMS (1.700,00) = 3.194,00
Municipal: IBS_MUN (1.162,00)

📋 Observações Importantes

COFINS e PIS: Tributos zerados (possivelmente regime de não cumulatividade)
IPI: Sem incidência de tributo, mas registrado em "Valor Outros"
Base de Cálculo Diferenciada: IBS e CBS utilizam base reduzida (8.300,00 vs 10.000,00)
CST 999999: Código específico para situações especiais de tributação

IMPORTANTE!
Nova Legislação Tributária: Esta tela apresenta os novos tributos IBS (Imposto sobre Bens e Serviços) e CBS (Contribuição sobre Bens e Serviços), que fazem parte da reforma tributária brasileira. O IBS substitui parcialmente o ICMS e ISS, sendo dividido em:
IBS_UF: Componente estadual (18%)
IBS_MUN: Componente municipal (14%)
Campos com Asterisco (*): Indicam campos obrigatórios ou de maior relevância para análise fiscal.
Ordenação de Colunas: Os triângulos (▲▼) permitem ordenar a tabela por qualquer coluna para facilitar análises comparativas.

🔄 Fluxo de Navegação:

Tela Anterior: Detalhes da Nota Fiscal
Tela Atual: Detalhamento do Item
Retorno: Volta para Detalhes da Nota Fiscal (botão Sair)

05. TELA DE DETALHAMENTO DO ITEM

Esta é a terceira tela do programa, acessada através do ícone 🔍 na coluna "Detalhe" da grade de itens da tela de Detalhes da Nota Fiscal. Apresenta informações tributárias completas e detalhadas de um item específico do documento fiscal, incluindo o breakdown completo de todos os tributos aplicados.

Layout da Interface

A tela está organizada em duas seções principais:

�� Seção Superior - Identificação do Item

Informações básicas e identificação do item selecionado

📊 Seção Inferior - Tabela Tributária Detalhada

Breakdown completo de todos os tributos aplicados ao item

Outras Ações / Ações relacionadas

Botão/Ícone	Nome	Função
🚪	Sair	Retorna para a tela anterior (Detalhes da Nota Fiscal)
❓	Ajuda	Abre documentação de ajuda contextual para esta tela
❌	Fechar (X)	Fecha a janela de detalhamento do item
▲▼	Ordenação	Permite ordenar colunas da tabela tributária (indicado pelos triângulos)

Seção de Identificação do Item

Campo	Valor	Descrição
Seq.	1	Número sequencial do item na nota fiscal
Item	INDUST.1	Código identificador do produto/serviço
Nat. Oper./Grupo Despesa	1000	Natureza da operação ou grupo de despesa
CFOP	1.101	Código Fiscal de Operações e Prestações
NCM/NBS	0	Nomenclatura Comum do Mercosul / Nomenclatura Brasileira de Serviços

Tabela Tributária Detalhada

Tributo	Incidência	CST	Base Cálculo	Alíquota (%)	Valor Tributo	Valor Outros
CBS	10	999999	8.300,00	9,000000	747,00	0,00
COFINS	300	-	0,00	0,000000	0,00	0,00
IBS_MUN	10	999999	8.300,00	14,000000	1.162,00	0,00
IBS_UF	10	000001	8.300,00	18,000000	1.494,00	0,00
ICMS	1000	-	10.000,00	17,000000	1.700,00	0,00
IPI	300	-	10.000,00	0,000000	0,00	10.000,00
PIS	300	-	0,00	0,000000	0,00	0,00

Análise Tributária do Item

💰 Resumo Financeiro

Descrição	Valor	Observação
Valor do Item	10.000,00	Valor base do produto (conforme tela anterior)
Total de Tributos	5.103,00	CBS + IBS_MUN + IBS_UF + ICMS
Carga Tributária	51,03%	Percentual de tributos sobre o valor do item

🏛️ Breakdown por Esfera Governamental

Federal: CBS (747,00)
Estadual: IBS_UF (1.494,00) + ICMS (1.700,00) = 3.194,00
Municipal: IBS_MUN (1.162,00)

06. PRINCIPAIS CAMPOS E PARÂMETROS

🔍 Campos de Filtro (Tela 1)

Campo	Tipo	Obrigatório	Descrição
Período (De/Até)	Data	Sim	Intervalo de datas para consulta com seletor de calendário
Origem	Dropdown	Não	Tipo/fonte do documento (Fiscal, Contábil)
Empresa origem	Texto + Lupa	Não	Empresa específica com pesquisa assistida
Cliente/Fornecedor	Texto + Lupa	Não	Parceiro de negócio com pesquisa assistida
Situação nota fiscal	Dropdown	Não	Status do documento (Normal, Cancelada, etc.)
Nota fiscal	Numérico + Lupa	Não	Número específico do documento
Item	Texto + Lupa	Não	Item específico na composição
CFOP	Texto + Lupa	Não	Código Fiscal de Operações
Class. Tributária IBS/CBS	Texto + Lupa	Não	Classificação tributária da reforma

📋 Campos de Identificação (Tela 2)

Campos Obrigatórios: Empresa origem, Nota Fiscal, Espécie, Modelo, Série, Situação, Data, Cliente/Fornecedor
Campos Opcionais: Aviso Rec., Finalidade, UF
Campos Calculados: Valor Nota Fiscal (soma dos itens)

🏛️ Campos Tributários (Tela 3)

Identificação: Seq., Item, Nat. Oper., CFOP, NCM/NBS
Tributos Principais: CBS, IBS_MUN, IBS_UF, ICMS, IPI, COFINS, PIS
Campos por Tributo: Incidência, CST, Base Cálculo, Alíquota, Valor Tributo, Valor Outros

IMPORTANTE!
Nova Legislação Tributária: O sistema está preparado para a Reforma Tributária Brasileira, apresentando os novos tributos:
IBS (Imposto sobre Bens e Serviços): Substitui parcialmente ICMS e ISS
IBS_UF: Componente estadual
IBS_MUN: Componente municipal
CBS (Contribuição sobre Bens e Serviços): Substitui PIS/COFINS
Navegação Hierárquica: O fluxo de navegação através dos ícones 🔍 permite análise progressiva desde a visão geral até o detalhamento tributário específico de cada item.
Campos Obrigatórios: Todos os campos marcados com asterisco (*) são obrigatórios e sempre conterão informações válidas.

07. TABELAS UTILIZADAS

O programa OBF25100 acessa diversas tabelas do sistema fiscal para compor as informações apresentadas nas três telas. Embora a estrutura exata dependa da implementação específica, as principais categorias de tabelas são:

📊 Tabelas de Documentos Fiscais

Categoria	Exemplos de Tabelas	Conteúdo
Cabeçalho de Notas	TB_NF_CABECALHO FISCAL_DOCS_HEADER	Dados gerais de cada nota fiscal (número, data, valor total, situação)
Itens de Notas	TB_NF_ITENS FISCAL_DOCS_ITEMS	Detalhes de cada item/serviço (código, descrição, quantidade, valores)
Informações Tributárias	TB_NF_TRIBUTOS FISCAL_TAX_DETAILS	Breakdown tributário por item (alíquotas, bases, valores de tributos)

👥 Tabelas de Cadastros

Categoria	Exemplos de Tabelas	Conteúdo
Parceiros de Negócio	TB_CLIENTES_FORNECEDORES CAD_PARTNER	Informações de clientes e fornecedores (razão social, CNPJ, endereços)
Produtos/Serviços	TB_PRODUTOS CAD_ITEMS	Cadastro de produtos e serviços (códigos, descrições, unidades)
Empresas/Filiais	TB_EMPRESAS CAD_FILIAIS	Dados das entidades em sistemas multi-empresas

🏷️ Tabelas de Classificações Fiscais

Categoria	Exemplos de Tabelas	Conteúdo
CFOP	TB_CFOP FISCAL_CFOP	Códigos e descrições fiscais de operações
Classificação Tributária	TB_CLASSES_TRIBUTARIAS TAX_CLASSIFICATION	Classificações IBS/CBS da reforma tributária
NCM/NBS	TB_NCM TB_NBS	Nomenclaturas de mercadorias e serviços
Situações/Status	TB_SITUACAO_FISCAL COD_STATUS_DOC	Códigos de status dos documentos fiscais

⚖️ Tabelas de Configuração Tributária

Categoria	Exemplos de Tabelas	Conteúdo
Alíquotas	TB_ALIQUOTAS TAX_RATES	Percentuais de tributos por UF, município, produto
CST/CSOSN	TB_CST TB_CSOSN	Códigos de Situação Tributária
Regras Tributárias	TB_REGRAS_TRIBUTARIAS TAX_RULES	Configurações específicas de tributação por cenário

🔄 Relacionamentos Principais

Fluxo de Dados entre Tabelas:

Cabeçalho da Nota → Itens da Nota (1:N)
Itens da Nota → Detalhes Tributários (1:N)
Cabeçalho → Parceiros de Negócio (N:1)
Itens → Produtos/Serviços (N:1)
Itens → CFOP (N:1)
Detalhes Tributários → Configurações Fiscais (N:1)

🔄 Fluxo Completo de Navegação:

Tela 1: OBF25100 - Consulta dos Documentos Fiscais
Tela 2: Detalhes da Nota Fiscal (via ícone 🔍)
Tela 3: Detalhamento do Item (via ícone 🔍)

05. TABELAS UTILIZADAS

Coloque o link das tabelas relacionadas