Entidade SALDOS_MENSAIS_ESTOQUES

ESTOQUE.SALDOS_MENSAIS_ESTOQUES

Descrição

Os saldos mensais de estoque resumem todos os Movimentos de estoques dos produtos em um determinado mês, tipo de estoque e estabelecimento. Os registros desta entidade são automaticamente atualizados pelos movimentos de estoque e os objetivos de se ter esta informação são:

Acelerar a obtenção do saldo de estoque de um produto em qualquer data (ver Saldos dos movimentos de estoques).
Garantir o valor correto para o saldo atual após eventos de replicação assíncrona.
Facilitar auditorias que identifiquem inconsistências nos saldos.

Esta entidade possui apenas registros que tiveram algum movimento de estoque na combinação do produto, tipo de estoque, estabelecimento e mês. A visão auxiliar Saldos mensais de estoques (completo) apresenta as mesmas informações mesmo para meses em que o produto não teve movimentação.

Atributos

Atributo	Domínio	Regras	Descrição
ID	ID(18)	Rqd PK	Id: Chave de identificação interna
MES	UPPER	Rqd UK	Mês: Mês relativo ao movimento registrado no formato YYYY-MM. Exemplo: 2015-07 (julho de 2015)
ESTABELECIMENTO_ID	ID(18)	Rqd UK FK	Estabelecimento: Estabelecimento ao qual pertence o saldo. Referência para ESTABELECIMENTOS
TIPO_ESTOQUE_ID	ID(18)	Rqd UK FK	Tipo de estoque: Tipo de estoque relacionado aos movimentos. Referência para TIPOS_ESTOQUES
PRODUTO_ID	ID(18)	Rqd UK FK	Produto: Produto que tem saldo neste tipo de estoque/estabelecimento/mês. Referência para PRODUTOS
TOTAL_ENTRADAS	DOUBLE(18)	Rqd	Total de entradas: Quantidade total de produtos que entraram neste estoque deste estabelecimento durante o mês. Valor padrão = 0
TOTAL_SAIDAS	DOUBLE(18)	Rqd	Total de saídas: Quantidade total de produtos que saíram deste estoque deste estabelecimento durante o mês. Valor padrão = 0
CUSTO_FISCAL_ENTRADAS	DOUBLE(18)	Rqd	Custo fiscal das entradas: Custo fiscal total dos produtos que entraram neste estoque deste estabelecimento durante o mês. Valor padrão = 0
CUSTO_FISCAL_SAIDAS	DOUBLE(18)	Rqd	Custo fiscal das saídas: Custo fiscal total dos produtos que saíram deste estoque deste estabelecimento durante o mês. Valor padrão = 0
CUSTO_FINANCEIRO_ENTRADAS	DOUBLE(18)	Rqd	Custo financeiro das entradas: Custo financeiro total dos produtos que entraram neste estoque deste estabelecimento durante o mês. Valor padrão = 0
CUSTO_FINANCEIRO_SAIDAS	DOUBLE(18)	Rqd	Custo financeiro das saídas: Custo financeiro total dos produtos que saíram deste estoque deste estabelecimento durante o mês. Valor padrão = 0
SALDO_FISICO_INICIAL	DOUBLE(18)	Rqd	Saldo físico inicial: Saldo físico de produtos no início do mês. Informação obtida do saldo físico final do mês anterior (ou ultimo mês em que este produto teve movimento neste estoque). Valor padrão = 0
SALDO_FISICO_FINAL	DOUBLE(18)	Rqd	Saldo físico final: Saldo físico de produtos no final do mês (Calculado pelo saldo físico inicial + total de entradas - total de saídas).
SALDO_CUSTO_FISCAL_INICIAL	DOUBLE(18)	Rqd	Saldo de custo fiscal inicial: Saldo de custo fiscal acumulado no início do mês. Valor padrão = 0
SALDO_CUSTO_FISCAL_FINAL	DOUBLE(18)	Rqd	Saldo de custo fiscal final: Saldo de custo fiscal acumulado no final do mês. Calculado pelo saldo de custo fiscal inicial + custo fiscal das entradas - custo fiscal das saídas.
SALDO_CUSTO_FINANCEIRO_INICIAL	DOUBLE(18)	Rqd	Saldo de custo financeiro inicial: Saldo de custo financeiro acumulado no início do mês. Valor padrão = 0
SALDO_CUSTO_FINANCEIRO_FINAL	DOUBLE(18)	Rqd	Saldo de custo financeiro final: Saldo de custo financeiro acumulado no final do mês. Calculado pelo saldo de custo financeiro inicial + custo financeiro das entradas - custo financeiro das saídas.
AUDITORIA_PENDENTE	FLAG(1)	Rqd AK	Auditoria pendente: Indica que os valores deste registro devem ser revisados. Alguns eventos/processos (alteração do saldo através de replicação, por exemplo) marcam este atributo para que ele seja revisado por uma rotina agendada para ser executada a cada 15 minutos, por exemplo. Valor padrão = N

Regras

Buscar saldo inicial

(Antes de inserir)

Ao inserir, o saldo inicial será composto pelo saldo final do mês anterior. Note que se o mês anterior não teve movimentos, a rotina deverá buscar do último mês que teve movimentos.

Calcular saldos finais

(Antes de inserir, Antes de alterar)

Esta rotina calcula os saldos finais usando os saldos inciais + entradas - saídas:

Saldo físico final
Saldo de custo fiscal final
Saldo de custo financeiro final

Atualizar saldos posteriores

(Depois de inserir, Depois de alterar, Depois de excluir)

Sempre que alterar um dos saldos finais, os saldos dos meses subsequentes devem ser atualizados.
Caso registro seja excluído, os saldos posteriores deverão ser atualizados com base nos saldos do mes anterior ao excluído.

Notificar replicação

Este método é chamado a partir de eventos de replicação. Sempre que o registro for alterado através do replicador, ele será marcado para ser auditado.

Recalcular totais

Recalcula os totais com base nos movimentos do mês.