Ajustes de CMV Histórico

Reprocessa o CMV dos itens de venda usando snapshot de custo por item. Suporta dry run, overwrite e filtro por venda.

Regras de imutabilidade

Overwrite = OFF: itens com cmv_item já preenchido são ignorados (histórico congelado).
Overwrite = ON: regrava TODOS os itens usando o custo médio atual do produto como base histórica.
Hierarquia de custo: (1) unit_cost do item, (2) average_cost do produto.
Itens sem nenhum custo disponível são ignorados e reportados.
Faturamento (unit_price, total_item) nunca é alterado.
Novos campos calculados: margin_item_value e margin_item_percent.

Parâmetros

Overwrite (forçar reescrita) — Se marcado, regrava TODOS os itens, mesmo os já congelados, usando o custo médio atual do produto. Use apenas quando souber que o custo médio foi corrigido nos produtos.

ID de uma venda específica (opcional)

Deixe em branco para processar todas.

Limite de itens (opcional)

Útil para testes parciais antes do lote completo.

Entendo que a execução real preenche/sobrescreve custos históricos de forma irreversível (apenas itens sem cmv_item serão alterados).