Pular para o conteúdo principal

StockMovement (Movimentacao de Estoque)

O StockMovement representa uma movimentacao de estoque, agrupando varias transacoes de produtos.

Descricao​

Movimentacoes de estoque permitem registrar entradas, saidas, inventarios e transferencias de produtos em lote. Cada movimentacao contem uma ou mais transacoes de produtos individuais.

Dados​

Informacoes da Movimentacao​

CampoTipoObrigatorioDescricao
nameTextoAutoNome/numero da movimentacao
typeSelecaoSimTipo da movimentacao
statusSelecaoSimStatus atual
dateDataSimData da movimentacao
obsTextoNaoObservacoes

Valores Totais​

CampoTipoDescricao
total_quantityDecimalQuantidade total de itens
total_costMonetarioCusto total
total_additional_costMonetarioCustos adicionais (frete, etc.)

Relacionamentos​

Pertence a​

EntidadeObrigatorioDescricao
AccountSimConta do petshop
StoreSimFilial
DepositSimDeposito destino
ProviderCondicionalFornecedor (se entrada)
StockInvoiceNaoNota fiscal

Possui​

EntidadeDescricao
StockTransactionsTransacoes de produtos

Tipos de Movimentacao​

entry (Entrada)​

  • Aumenta estoque
  • Vinculada a fornecedor
  • Pode ter nota fiscal

exit (Saida)​

  • Diminui estoque
  • Razoes: perda, devolucao, ajuste

inventory (Inventario)​

  • Ajusta estoque para quantidade contada
  • Registra diferenca

transfer (Transferencia)​

  • Move entre depositos ou lojas
  • Cria duas transacoes: saida e entrada

Ciclo de Vida​

Estados​

StatusDescricaoAcoes
draftRascunhoEditar, adicionar itens
pendingPendenteRevisar, confirmar
doneFinalizadoSomente leitura

StockTransaction​

Dados​

CampoTipoDescricao
quantityDecimalQuantidade
signal_quantityDecimalQuantidade com sinal
new_unit_costMonetarioCusto unitario
additional_costMonetarioCusto adicional rateado
average_costMonetarioCusto medio resultante

Calculo do signal_quantity​

entry: +quantity
exit: -quantity
inventory: quantity - old_quantity
transfer exit: -quantity
transfer entry: +quantity

Custos Adicionais​

Rateio​

Custos como frete sao rateados entre produtos:

custo_adicional_item = total_additional_cost * (valor_item / total_valor)

Exemplo​

Total produtos: R$ 1.000
Frete: R$ 100

Produto A (R$ 600): frete R$ 60
Produto B (R$ 400): frete R$ 40

Entrada com Nota Fiscal​

Processo​

  1. Importar XML da NF-e
  2. Sistema identifica produtos pelo codigo
  3. Cria StockTransaction para cada item
  4. Atualiza custos e estoque

Conciliacao​

Se produto nao encontrado:

  • Vincula a produto existente, ou
  • Cria novo produto

Inventario​

Processo​

  1. Criar movimentacao tipo inventory
  2. Informar quantidade contada por produto
  3. Sistema calcula diferenca
  4. Confirmar ajustes

Calculo da Diferenca​

diferenca = quantidade_contada - quantidade_sistema
Se diferenca > 0: entrada (sobra)
Se diferenca < 0: saida (falta)

Transferencia​

Entre Depositos (Mesma Loja)​

  1. Criar movimentacao transfer
  2. Selecionar deposito origem e destino
  3. Adicionar produtos e quantidades
  4. Confirmar

Entre Lojas​

  1. Criar movimentacao transfer
  2. Selecionar loja/deposito origem e destino
  3. Confirmar: cria duas movimentacoes
    • Exit na origem
    • Entry no destino

Validacoes​

RegraDescricao
Quantidade > 0Quantidade deve ser positiva
Estoque suficienteExit nao pode exceder estoque
Deposito obrigatorioDeposito deve ser informado
Produtos obrigatoriosMinimo 1 produto

Automacoes​

Ao Confirmar (status done)​

  1. Cada StockTransaction executa done!
  2. Atualiza estoque do produto
  3. Recalcula custo medio (se entrada)
  4. Atualiza precos (se configurado)

Atualizacao de Precos​

Opcao de atualizar precos na entrada:

OpcaoEfeito
update_prices = yesAtualiza precos de venda
update_promotional_prices = yesAtualiza promocionais proporcionalmente

Depositos​

O que e um Deposito​

Local fisico de armazenamento:

  • Estoque principal
  • Estoque reserva
  • Vitrine
  • CD (Centro de Distribuicao)

Estoque por Deposito​

Cada produto tem estoque separado por deposito:

Produto: Racao Premium
- Deposito Principal: 80 un
- Deposito Reserva: 200 un
- Vitrine: 20 un
Total: 300 un

Permissoes​

AcaoDescricao
CriarCriar movimentacao
EditarAlterar movimentacao draft
ConfirmarFinalizar movimentacao
CancelarCancelar movimentacao pending
VisualizarVer detalhes e historico

Relatorios​

Posicao de Estoque​

Estoque atual por produto/deposito/loja.

Movimentacoes​

Historico de entradas e saidas por periodo.

Inventario​

Comparativo contagem x sistema.