Ver código fonte para Relatorio 2495 Resultado Acuracidade

'''Módulo''': [[Modulo Acuracidade Estoque]]

== Objetivo ==

O relatório '''2495 - Resultado Acuracidade''' mostra o resultado de uma ou mais apurações de acuracidade de estoque (contagens de inventário), cadastradas no recurso 944 - Acuracidade Estoque: para cada produto contado, compara a quantidade que o sistema tinha registrada (Estoque) com a quantidade apurada fisicamente (Inventário), calculando a diferença e o valor financeiro dessa diferença (sobra ou falta).

O relatório tem dois modos, que não se combinam:
* '''Modo normal''': lista os produtos que foram efetivamente contados na(s) apuração(ões) selecionada(s), com os valores de Estoque, Inventário, Diferença e Custo Total de cada um.
* '''Modo "Somente Produtos Não Informados na Acuracidade"''': em vez dos produtos contados, lista os produtos que têm saldo em estoque mas '''não''' foram contados na apuração selecionada — ajuda a achar o que "ficou de fora" da contagem.

Também é possível pedir, ao final do relatório, um resumo dos produtos que foram contados em mais de uma das apurações selecionadas (Mostrar Resumo Produtos Repetidos).

== Filtros Disponíveis ==
{| class="wikitable"
|+
!Filtro
!Descrição
!Observação
!Referência Técnica
|-
|Filtrar Data Cadastro
|Restringe as apurações de acuracidade consideradas às que foram cadastradas dentro de um período de datas.
|Quando ativado, exige o preenchimento de Data Cadastro Inicial e Data Cadastro Final.
|FILTRAR_DATA_CADASTRO
|-
|Data Cadastro Inicial
|Data inicial do período de cadastro da apuração de acuracidade.
|Obrigatório apenas quando Filtrar Data Cadastro está ativado.
|DATA_CADASTRO_INICIAL
|-
|Data Cadastro Final
|Data final do período de cadastro da apuração de acuracidade.
|Obrigatório apenas quando Filtrar Data Cadastro está ativado.
|DATA_CADASTRO_FINAL
|-
|Filtrar Acuracidade
|Restringe o relatório a uma ou mais apurações específicas, cadastradas no recurso 944 - Acuracidade Estoque.
|Quando ativado, exige a seleção de ao menos uma apuração em Ids. Apuracidade. Precisa estar ativo para poder usar Mostrar Resumo Produtos Repetidos.
|FILTRAR_IDENTIFICADOR_APURACIDADE
|-
|Ids. Apuracidade
|Apuração(ões) de acuracidade consideradas quando o filtro Filtrar Acuracidade está ativo.
|Quando Somente Produtos Não Informados na Acuracidade está ativo, o sistema usa apenas a '''primeira''' apuração desta lista para decidir o centro de estoque, a empresa e a data de saldo — mesmo que mais de uma tenha sido selecionada aqui.
|IDS_APURACIDADE
|-
|Filtrar Espécie
|Restringe os produtos do relatório a uma faixa de espécies, cadastradas no recurso 57 - Espécie.
|Quando ativado, exige Id. Espécie Inicial e Final.
|P_FILTRAR_ESPECIE
|-
|Id. Espécie Inicial
|Espécie inicial da faixa considerada quando Filtrar Espécie está ativo.
|—
|P_ID_ESPECIE_INICIAL
|-
|Id. Espécie Final
|Espécie final da faixa considerada quando Filtrar Espécie está ativo.
|—
|P_ID_ESPECIE_FINAL
|-
|Filtrar Subespécie
|Restringe os produtos do relatório a uma faixa de subespécies, cadastradas no recurso 58 - Sub-espécie.
|Quando ativado, exige Id. Subespécie Inicial e Final.
|P_FILTRAR_SUB_ESPECIE
|-
|Id. Subespécie Inicial
|Subespécie inicial da faixa considerada quando Filtrar Subespécie está ativo.
|—
|P_ID_SUB_ESPECIE_INICIAL
|-
|Id. Subespécie Final
|Subespécie final da faixa considerada quando Filtrar Subespécie está ativo.
|—
|P_ID_SUB_ESPECIE_FINAL
|-
|Filtrar Empresa
|Restringe o relatório a uma faixa de empresas, cadastradas no recurso 49 - Empresas.
|Quando ativado, exige Id. Empresa Inicial e Final.
|FILTRAR_EMPRESA
|-
|Id. Empresa Inicial
|Empresa inicial da faixa considerada quando Filtrar Empresa está ativo.
|—
|ID_EMPRESA_INICIAL
|-
|Id. Empresa Final
|Empresa final da faixa considerada quando Filtrar Empresa está ativo.
|—
|ID_EMPRESA_FINAL
|-
|Somente Produtos Não Informados na Acuracidade
|Troca completamente o conteúdo do relatório: em vez de mostrar os produtos contados, mostra os produtos que têm saldo em estoque mas '''não''' foram contados na apuração selecionada.
|Usa apenas a primeira apuração de Ids. Apuracidade para saber qual centro de estoque, empresa e data usar na consulta de saldo (ver observação desse filtro). Nos produtos trazidos por este filtro, a coluna Inventário sempre aparece zerada e a linha exibe a mensagem "Produto Não Informado Na Acuracidade". Além disso, para estes produtos a coluna Estoque muda de origem: em vez do valor congelado do item da apuração, ela vem de uma consulta de saldo recalculada a partir das movimentações, posicionada na data de cadastro da primeira apuração selecionada (não na data de hoje) — ver Dicas de Análise.
|P_SOM_PROD_NAO_INF_ACURACIDADE
|-
|Mostrar Resumo Produtos Repetidos
|Acrescenta, ao final do relatório, uma lista dos produtos contados em mais de uma das apurações selecionadas em Filtrar Acuracidade, com o(s) número(s) dessas apurações.
|Só funciona com Filtrar Acuracidade ativo. Sem nenhum produto repetido entre as apurações selecionadas, a lista não aparece mesmo com o filtro ativado.
|P_MOSTRAR_RESUMO_PRODUTOS_REPETIDOS
|-
|Exibir Código de Barras
|Controla se a coluna Cód. Barras aparece no relatório.
|—
|P_EXIBIR_COD_BARRAS
|}

== Campos Corpo ==
{| class="wikitable"
|+
!Campo
!Descrição
!Observação
!Referência Técnica
|-
|Cód Aux.
|Código auxiliar do produto, cadastrado no recurso 65 - Produtos e Serviços.
|—
|F_CODIGO_AUXILIAR_PRODUTO
|-
|Descrição
|Nome do produto.
|—
|F_NOME_PRODUTO
|-
|Cód. Barras
|Menor código de barras cadastrado para o produto.
|Só aparece quando o filtro Exibir Código de Barras está ativado.
|F_CODIGO_BARRAS
|-
|UM
|Sigla da unidade de medida do produto.
|—
|F_SIGLA_UNIDADE_MEDIDA
|-
|Num. Ac.
|Número(s) da(s) apuração(ões) de acuracidade (recurso 944) em que este produto foi contado, dentre as selecionadas em Filtrar Acuracidade.
|Quando aparece mais de um número aqui, os valores de Estoque, Inventário e Custo desta linha já vêm somados/calculados juntando todas essas apurações — não é uma linha por apuração (ver Dicas de Análise).
|F_IDS_ACURACIDADES
|-
|Estoque
|Quantidade que o sistema tinha registrada para o produto na apuração de acuracidade, no momento em que ela foi gerada.
|Não é uma consulta ao saldo de estoque atual — é o valor gravado no item da apuração (recurso 944) quando ela foi criada. Se a apuração for antiga, este valor pode não refletir o estoque de hoje. Quando o produto está em mais de uma apuração selecionada (ver Num. Ac.), este valor é a soma da quantidade registrada em cada uma delas.
|F_QUANTIDADE_INICIAL — ItemApuracidadeEstoque.quantidadeInicial
|-
|Inventário
|Quantidade física apurada (contada) para o produto na apuração de acuracidade.
|Quando o produto está em mais de uma apuração selecionada, este valor é a soma da quantidade contada em cada uma delas. Aparece zerado (com a mensagem "Produto Não Informado Na Acuracidade" na linha) quando o produto vem do filtro Somente Produtos Não Informados na Acuracidade — nesse caso o produto tem saldo em estoque, mas não foi contado.
|F_QUANTIDADE_FINAL — ItemApuracidadeEstoque.quantidadeFinal
|-
|Diferença
|Diferença entre a quantidade apurada e a registrada: Inventário − Estoque. Positivo indica sobra (contou-se mais do que o sistema tinha); negativo indica falta.
|Calculada direto na impressão, não é um campo próprio do BI.
|F_QUANTIDADE_FINAL − F_QUANTIDADE_INICIAL
|-
|Custo
|Preço médio do produto usado para valorizar a diferença encontrada.
|Quando o produto está em mais de uma apuração selecionada, este valor é a média simples entre o preço médio de cada apuração — não é ponderado pela quantidade de cada uma.
|F_PRECO_MEDIO_FINAL — ItemApuracidadeEstoque.precoMedioFinal
|-
|Custo Total
|Valor financeiro da diferença encontrada para o produto: (Inventário − Estoque) × Custo. Positivo indica valor a mais em estoque; negativo indica valor faltante.
|—
|F_CUSTO_TOTAL — (F_QUANTIDADE_FINAL − F_QUANTIDADE_INICIAL) × F_PRECO_MEDIO_FINAL
|-
|Total Estoque (rodapé)
|Soma do valor de estoque teórico de todos os produtos do relatório: Estoque × Custo de cada linha, somado.
|—
|Variável Total_Qtd_Inicial — SUM(F_QUANTIDADE_INICIAL × F_PRECO_MEDIO_FINAL)
|-
|Total Físico (rodapé)
|Soma do valor da contagem física de todos os produtos do relatório: Inventário × Custo de cada linha, somado.
|—
|Variável Total_fisico — SUM(F_QUANTIDADE_FINAL × F_PRECO_MEDIO_FINAL)
|-
|Custo Total (rodapé)
|Soma de Estoque × Custo de todos os produtos do relatório.
|Usa a mesma fórmula de Total Estoque, então sempre mostra o mesmo valor que ele — não soma a coluna Custo Total de cada linha. O valor financeiro da diferença apurada aparece em Diferença Custo Total, não aqui.
|Variável valor_total_curto — SUM(F_QUANTIDADE_INICIAL × F_PRECO_MEDIO_FINAL)
|-
|Diferença Custo Total (rodapé)
|Soma do Custo Total (a diferença financeira) de todos os produtos do relatório — o impacto financeiro total da contagem.
|—
|Variável diferenca_custo_total — SUM((F_QUANTIDADE_FINAL − F_QUANTIDADE_INICIAL) × F_PRECO_MEDIO_FINAL)
|-
|Quantidade de Itens iguais (rodapé)
|Quantidade de produtos do relatório em que a contagem física bateu exatamente com o estoque teórico (Diferença zero).
|—
|Variável quantidade_de_iguais
|-
|Quantidade de Diferentes (rodapé)
|Quantidade de produtos do relatório em que houve alguma divergência entre a contagem física e o estoque teórico (Diferença diferente de zero).
|—
|Variável quantidade_de_diferentes
|-
|Quantidade Total de itens (rodapé)
|Quantidade total de produtos listados no relatório.
|—
|Variável quntidade_total
|}

=== Resumo Produtos Repetidos (bloco condicional) ===

Quando o filtro Mostrar Resumo Produtos Repetidos está ativo e existe ao menos um produto contado em mais de uma apuração selecionada, o relatório imprime, ao final, uma lista separada com esses produtos: Cód. Auxiliar, Cód. Barras, Descrição e Acuracidades (os números das apurações em que o produto se repete) — os mesmos dados já descritos na tabela acima, só que reunidos numa lista dedicada para facilitar a conferência de repetições.

== Dicas de Análise do Relatório ==

'''Estoque não é "saldo de hoje" — nem no modo normal, nem no modo "Não Informados":''' no modo normal, a coluna Estoque mostra o valor que ficou gravado no item da apuração de acuracidade selecionada (recurso 944), congelado no momento em que ela foi gerada — o relatório não refaz essa conta. Já para os produtos trazidos pelo filtro Somente Produtos Não Informados na Acuracidade (que não têm item de apuração, pois não foram contados), a origem do Estoque é outra: uma consulta de saldo recalculada a partir das movimentações de estoque, mas ainda assim posicionada na '''data de cadastro da apuração''' (a primeira selecionada em Ids. Apuracidade) — não na data de hoje. Ou seja, em nenhum dos dois casos o Estoque reflete necessariamente o saldo atual do produto; se a apuração é antiga, o valor mostrado (congelado ou recalculado) tende a não bater com o estoque de hoje — isso é esperado, não é falha do relatório.

'''Diferença e Custo Total mostram sobra ou falta em quantidade e em dinheiro:''' Diferença positiva é sobra (o físico tem mais do que o sistema esperava), negativa é falta. O Custo Total de cada linha já traz esse valor em dinheiro; a soma de todas as linhas é o que aparece no rodapé em Diferença Custo Total — esse é o número que representa o impacto financeiro total da apuração.

'''Produto contado em mais de uma apuração vira uma linha só, não uma por apuração:''' ao selecionar mais de uma apuração em Filtrar Acuracidade, se o mesmo produto foi contado em mais de uma delas, o relatório soma o Estoque e o Inventário de todas e calcula uma média simples dos Custos (não ponderada pela quantidade). A coluna Num. Ac. mostra quais apurações foram reunidas naquela linha. Para uma lista dedicada só desses casos, use o filtro Mostrar Resumo Produtos Repetidos.

'''Total Estoque e Custo Total (rodapé) são sempre o mesmo número:''' as duas linhas do rodapé usam a mesma fórmula (soma de Estoque × Custo). Não confundir com Diferença Custo Total, que é o valor financeiro da diferença apurada — esse sim muda de acordo com a contagem física.

== Problemas Comuns e Como Resolver ==
{| class="wikitable"
|+
!Situação
!O que fazer
|-
|A coluna Estoque não mostra o saldo atual do produto
|Comportamento esperado, mas a causa depende do modo. '''Modo normal:''' a coluna Estoque mostra o valor congelado no item da apuração de acuracidade selecionada (recurso 944), no momento em que ela foi gerada — não é uma nova consulta ao saldo de hoje. Se o valor estiver desatualizado, zerado ou divergente do estoque atual, o ponto a conferir é a geração/preenchimento da própria apuração (recursos 944 - Acuracidade Estoque / 1439 - Pré-Acuracidade Estoque), não os filtros do BI. '''Modo Somente Produtos Não Informados na Acuracidade:''' aqui o Estoque já é recalculado a partir das movimentações (não é o valor congelado), mas posicionado na '''data de cadastro da apuração''' selecionada, não na data de hoje — então mesmo assim pode divergir do saldo atual se a apuração for antiga. Não existe parâmetro neste relatório que force o cálculo na data de hoje em nenhum dos dois modos.
|-
|Aparecem produtos que não foram contados, com Inventário zerado e uma mensagem na linha
|Verificar se o filtro Somente Produtos Não Informados na Acuracidade está ativado — quando ativo, o relatório troca a lista pelos produtos que têm saldo em estoque mas não foram contados na apuração; Inventário = 0 e a mensagem "Produto Não Informado Na Acuracidade" são esperados nesse caso.
|-
|Mostrar Resumo Produtos Repetidos não mostra nenhuma lista mesmo ativado
|Confirmar que Filtrar Acuracidade também está ativo e que mais de uma apuração foi selecionada em Ids. Apuracidade — sem isso não há como haver produto repetido entre apurações. A lista só aparece quando existe pelo menos um produto contado em mais de uma das apurações selecionadas.
|-
|Um produto aparece com Estoque, Inventário ou Custo diferentes do esperado para uma apuração específica
|Conferir a coluna Num. Ac.: se mostrar mais de um número de apuração, os valores da linha são a soma (Estoque, Inventário) e a média simples (Custo) de todas as apurações ali listadas, não os valores de uma apuração isolada.
|}