Entidade MOVIMENTOS_ESTOQUES

ESTOQUE.MOVIMENTOS_ESTOQUES

Descrição

Registro da movimentação física de entrada e/ou saída do produto em estoque no estabelecimento.

Atributos

Atributo	Domínio	Regras	Descrição
ID	ID(18)	Rqd PK FK AK	Id: Chave de identificação interna Referência para V_SALDOS_MOVIMENTOS_ESTOQUES
DATA_HORA	DATE_TIME_HM	Rqd	Data/hora: Data e hora em que o produto foi movimentado no estoque. Valor padrão = [SYSDATE]
DATA_MOVIMENTO	DATE	Rqd AK	Data do movimento: Data do movimento do produto no estoque. Valor padrão = [SYSDATE]
QUANTIDADE	DECIMAL_VALUE	Rqd	Quantidade: Quantidade do estoque movimentada.
ESTOQUE_ID	ID(18)	Rqd FK AK	Estoque: Indica o registro de estoque que este registro está se movimentando. Referência para ESTOQUES_PRODUTOS
PRODUTO_ID	ID(18)	Rqd FK AK	Produto: Produto movimentado no estoque. Referência para PRODUTOS
ESTABELECIMENTO_ID	ID(18)	Rqd FK AK	Estabelecimento: Estalecimento onde o produto foi movimentado. Referência para ESTABELECIMENTOS
TIPO_MOVIMENTACAO_ESTOQUE_ID	ID(18)	Rqd FK	Tipo de movimento: Histórico da movimentação de estoque. Referência para TIPOS_MOVIMENTACOES_ESTOQUES
RESPONSAVEL_ID	ID(18)	FK	Responsável: Quando informado, indica que os produtos ficaram sob a responsabilidade de uma determinada pessoa. No caso de movimentos de unidades de produtos (bens materiais/ equipamentos), indica com quem ficou a unidade. Referência para PESSOAS
LOCALIZACAO	UPPER(40)		Localização: Indica o local para onde o produto foi movimentado. No caso de unidades de produtos, esta atributo atualiza a localização do estoque. No caso de controle de estoque por FIFO, esta informação poderá dar a localização exata onde se encontram os produtos.
OBSERVACAO	TEXT		Observação: Observação sobre a movimentação do estoque. Este atributo pode ser utilizado para descrever transações avulsas de movimentação do produto no estoque.
ITEM_DOCUMENTO_ID	ID(18)	FK	Item de documento: Item de documento que deu origem ao movimento do estoque. Existem alguns casos que um movimento não está associado a um item de documento: Implosão/explosão (preenchimento do campo Movimentos de outros movimento s- Nestes casos deve ser preenchido o campo "MOVIMENTO_ESTOQUE_ID", referenciando outro movimento de estoque KIT de produtos - Neste caso é feito a referencia a um kit que deve estar vinculado a outros itens de documento. Referência para ITENS_DOC_ENTRADAS_SAIDAS
MOVIMENTO_ESTOQUE_ID	ID(18)	FK	Movimento de estoque: Representa a qual movimento está vinculado. Como por exemplo nos casos de unidade de produto, que possuem apenas um movimento pai (único) e diversos movimentos de unidade. Referência para MOVIMENTOS_ESTOQUES
KIT_DOCUMENTO_ID	ID(18)	FK	Kit documento: Relacionamento com um kit de documento, neste caso substitui o vinculo com o item de documento. Referência para KITS_DOCUMENTOS
QUANTIDADE_ACUMULADA	DECIMAL_VALUE		Quantidade acumulada: Quantidade que ficou em estoque no estabelecimento, logo após a movimentação. Esta quantidade é calculada pela quantidade acumulada do movimento anterior somado ou subtraído da quantidade deste movimento, independente do tipo de estoque.
CUSTO	DECIMAL_VALUE(25,8)		Custo fiscal total: Custo fiscal total que este movimento agregou ou retirou no estoque. Este valor é calculado de acordo com o que estiver definido no atributo Cálculo do custo no respectivo tipo de movimentação de estoque.
CUSTO_ACUMULADO	DECIMAL_VALUE(25,8)		Custo fiscal acumulado: Custo fiscal acumulado para este estoque logo após este movimento (custo fiscal total anterior + custo fiscal total do movimento).
CUSTO_MEDIO	VALUE(18,8)		Custo fiscal médio: Custo fiscal médio para este produto após a realização deste movimento calculado pelo custo fiscal acumulado dividido pelo saldo do estoque no movimento. Caso o saldo do estoque no movimento seja zero será mantido o custo fiscal médio do movimento anterior a este movimento.
CUSTO_FINANCEIRO	DECIMAL_VALUE(25,8)		Custo financeiro total: Custo financeiro total que este movimento agregou ou retirou do valor financeiro do estoque. Este valor é calculado de acordo com o que estiver definido no atributo Cálculo do custo no respectivo tipo de movimentação de estoque.
CUSTO_FINANCEIRO_ACUMULADO	DECIMAL_VALUE(25,8)		Custo financeiro acumulado: Custo financeiro acumulado para este estoque logo após este movimento (custo financeiro total anterior + custo financeiro total do movimento).
CUSTO_FINANCEIRO_MEDIO	VALUE(18,8)		Custo financeiro médio: Custo financeiro médio para este produto após a realização deste movimento calculado pelo custo financeiro acumulado dividido pelo saldo do estoque no movimento. Caso o saldo do estoque no movimento seja zero será mantido o custo financeiro médio do movimento anterior a este movimento.
SALDO_FIFO	DECIMAL_VALUE		Saldo FIFO: Quantidade física em estoque que ainda não foi utilizada. Este atributo é utilizado quando o controle de custo do estoque é calculado através do procedimento FIFO. Neste caso, todas as entradas no estoque populam este valor com a mesma quantidade do movimento e, posteriormente, as saídas de estoque irão consumir quantidades deste saldo até que ele seja zerado.
TEM_SALDO_FIFO	FLAG(1)	Rqd AK	Tem saldo FIFO: Indica que existe saldo em estoque originado por este movimento. Este atributo é automaticamente atualizado conforme o valor do saldo FIFO. O objetivo deste atributo é de permitir uma indexação específica para produtos com saldo, acelerando o processo de baixa de estoques quando é utilizado FIFO. Valores permitidos: S - Sim - O movimento (de entrada) possui saldo que pode ser consumido. N - Não - O movimento não possui saldo que possa ser movimentado. P - Pendente - O movimento é uma saída que não conseguiu consumir saldos pois não havia mais em estoque. Esta indicação serve apenas como recurso para facilitar o reprocessamento de movimentos de saída registrados antes dos respectivos movimentos de entrada. ESTE RECURSO AINDA NÃO ESTÁ IMPLEMENTADO Valor padrão = N

Regras

Atualizar o valor do estoque mensal

(Depois de inserir)

Deve realizar a atualização do valor de estoque no mês.

Realizar movimentações de embalagem

(Depois de inserir)

Quando o estoque do produto estiver negativo e este tiver um relacionamento com um outro produto deve-se criar um movimento de acerto de estoque, permitindo que este produto fique com seu estoque real corrigido.
P.ex:
Vendido -2 do produto 37 CX ( 10UN), ficou com estoque -2, este é relacionado com produto 39 UN , deve ser criado um movimento de saída do 39 com -20 e criado um movimento de crédito para o 37 de 2. Com isso o produto 37 fica com o saldo zerado e o produto 39 fica com um estoque de -20.

OBS: Somente devem ser feitos movimentos se o item_de_documento_id for informado.

Realizar movimentações de unidade de produto ou modelo

(Depois de inserir)

Quando o movimento está relacionado a um documento que informa as unidades de produto, então o estoque das respectivas unidades de produto devem ser movimentadas.

Em caso de um produto que é modelo, deve movimentar estoque dos produtos que utilizam este como modelo.

Excluir movimentos de unidade de produto

(Antes de excluir)

Antes de excluir o estoque, deve retornar a quantidade antiga de unidades de produto.

Atualizar saldo mensal

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

Atualiza a entidade Saldos mensais de estoques com os dados deste movimento.

Na inclusão de um movimento, apenas adiciona este movimento ao saldo mensal.
Na exclusão de um movimento, recalcula o saldo mensal (somando todos os movimentos da chave).
Na alteração de um movimento, também recalcula o saldo mensal e, caso a chave tenha mudado, recalcula também o saldo mensal da chave antiga.

A chave é formada pela combinação produto + tipo de estoque + estabelecimento + data do movimento.

Atualizar o custo do produto para o estabelecimento

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

Caso o estabelecimento esteja configurado para fazer a atualização do custo do produto de forma online, então dispara o processamento de calculo do mesmo.
Caso contrário, o custo do produto é marcado como não atualizado e caso a data do movimento for inferior à data de atualização do respectivo custo, então a mesma será alterada para a menor (mais antiga).

Ajustar custo na exclusão

(Antes de excluir)

Quando excluir um movimento que é a ultima aquisição ou ultimo movimento daquele produto naquele estabelecimento, corrige o respectivo registro em custos de produtos. Isso evita o erro que causaria excluir um movimento que é referência para o controle de custos.

Preencher o saldo FIFO

(Antes de inserir)

Na inclusão de um movimento de entrada, o saldo FIFO será populado com a quantidade movimentada.

Atualizar se tem saldo FIFO

(Antes de inserir, Antes de alterar)

Atualiza o atributo conforme o saldo FIFO.

Bloquear estoque sendo inventariado

(Antes de inserir)

Verifica se existe um inventário geral em andamento ou um inventário parcial do produto, considerando o respectivo inventário e tipo de estoque.

Atualizar saldo diario

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

Atualiza todos os espelhos do saldo de estoque com data igual ou superior à data do movimento (mesmo produto, estabelecimento e tipo de estoque).
Caso a alteração do estoque resultar em um saldo igual a zero, então o registro da fotografia é excluído.

Atualizar o estoque atual do produto do estabelecimento

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

Atualiza o saldo do estoque do produto (por estabelecimento e tipo de estoque) ao movimentar o estoque.

As operações de entrada somam as quantidades movimentadas ao estoque atual.
As operações de saída subtraem as quantidades movimentadas do estoque atual.
As operações de exclusão de movimento devem realizar a operação inversa no saldo do estoque. P.ex. Ao excluir um movimento de entrada, a quantidade excluída deve ser subtraída do saldo do estoque e ao excluir um movimento de saída, quantidade excluída deve ser acrescida ao saldo do estoque.

Atenção

Apesar de pouco usual, este método é propositalmente chamado na PRE-INSERT (normalmente seria em uma POS-INSERT) para que seja possível manter registrado o ID do estoque associado na entidade.

Corrigir os vínculos de estoque do produto com o último movimento

(Antes de excluir)

Corrigir os vínculos de estoque do produto com o último movimento

Atualizar alocação

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

Quando informado, atualiza as in informações de responsável/localização do estoque das unidades de produto.

Calcular data e data/hora

(Antes de inserir, Antes de alterar)

Caso seja informada apenas a "Data/hora" do movimento, então a "Data" será preenchida com a mesma data, removendo a hora.
Caso seja informada a "Data" do movimento e igual ao dia de hoje, a "Data/hora" será preenchida com o dia e a hora do sistema.
Caso seja informada a "Data" co movimento e com um dia diferente do hoje, a "Data/hora" será preenchida com a data do movimento e hora 00:00.
Caso nenhuma data seja informada, assume a data e hora do sistema.

Atualizar custo FIFO

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

Na inclusão de um movimento, esta regra cria registros de Consumos de saldos FIFO em movimentos de saída para indicar os movimentos de entrada deste estoque, considerando FIFO (First In, First Out).
Na alteração de um movimento, esta regra somente terá algum tratamento no caso da quantidade ser alterada (situação raramente usada).
Na exclusão, esta regra remove os respectivos registros de consumo.

Produtos to tipo "Serviço" não podem movimentar estoque!

(Antes de inserir)

Verificar se este produto pode movimentar estoque.
Serviços não podem movimentar estoque.

Item de documento é requerido para este tipo de movimento!

(Antes de inserir, Antes de alterar, Antes de excluir)

Verifica se o tipo de movimento exige que o mesmo esteja ligado a um documento.

Data do movimento é superior a atual

(Antes de inserir)

Data do movimento do estoque não pode ser superior a data atual.

Produto existe a movimentação do lote do produto

(Antes de inserir, Antes de alterar)

Caso o tipo de produto exija o lote, deve ser apresentado mensagem de erro quando movimentado diretamente com um documento.

Unidade de medida do produto não permite movimento fracionado

(Antes de inserir)

Caso unidade de medida do produto não permitir quantidade fracionada, então deve validar a respectiva quantidade.

Validar movimentação tipo de estoque

(Antes de inserir)

Valida a movimentação do estoque não permitindo a inclusão de novos registros caso o tipo de estoque em questão esteja com a situação diferente de ativo.

Atualizar saldos(data)

Recalcula os saldos (e custos) de todos os movimentos de estoque a partir da data do lançamento informada.
Os movimentos são ordenados por data e através do atributo sequencia em Tipos de movimentações de estoques.

Apresentar informações sobre o movimento

Apresentar mais informações sobre a movimentação do estoque:

Documento de entrada/saída vinculado
Pedidos de venda/serviço/produção/transferência vinculados
Ajustes de estoque
Movimentações de variação de estoque
Operações de explosão e implosão de estoque

Criar consumos FIFO(quantidade)

Procedimento para gerar os consumos de saldos FIFO para o movimento.
Caso o movimento seja de entrada, então esta rotina não faz nada.
Para movimentos de saída, irá consumir estoque de movimentos de entrada que ainda não foram consumidos (saldo FIFO maior que zero).

Caso o movimento de saída esteja vinculado a um item de documento que está vinculado a outro, então o saldo FIFO deverá ser retirado deste movimento de entrada.
Exemplo: Saída por devolução de mercadoria recebida: O custo deverá ser o do respectivo documento de entrada e não do mais antigo.

Custo do produto

Localiza ou cria um registro para representar o custo do produto relacionado com este movimento.

Movimentar avulso(estabelecimento, tipo_movimento, data_movimento, produto, quantidade)

Este método permite criar um movimento de estoque avulso.

relacionamento(pr, v)

Realizar o procedimento para implosão ou explosão de um produto.