Preços¶

Os preços atribuem valor comercial bruto e líquido a um material. Eles podem variar por location, período de vigência e prioridade; por isso, uma mesma quantidade física pode receber valores diferentes conforme mercado e cenário.

Preço bruto unitário é o valor antes das deduções comerciais representadas no processo de planejamento.
Preço líquido unitário é o valor após essas deduções e a principal referência para análises de contribuição e margem.

Esta página documenta os cadastros compartilhados de preço disponíveis em Data Operations. Um snapshot de preços específico do plano pode preservar os valores usados por um Demand Plan, evitando que alterações posteriores reescrevam a economia daquele plano.

Como o preço é selecionado¶

A plataforma localiza as listas atribuídas à location e vigentes no período consultado.
Um número menor em priority é avaliado primeiro.
Na lista selecionada, a linha do material fornece o preço bruto e/ou líquido unitário.
Se nenhuma lista aplicável fornecer o valor solicitado, o preço padrão por material-location é avaliado.
Um preço padrão por material pode fornecer a referência seguinte quando estiver disponível no contexto do planejamento.
Se nenhuma fonte fornecer o valor, o preço permanece ausente. Ausência não deve ser interpretada como preço real igual a zero.

Os valores observados nas vendas também podem valorar a demanda histórica. Consulte Sell-in e Sell-out para os respectivos campos transacionais.

Lista de preços¶

Caminho na plataforma¶

Data > Data Operations > Prices > Price Lists > Price List

Granularidade e chave¶

Granularidade: uma linha por lista de preços.
Chave: id único.

Campos obrigatórios¶

Campo	Significado
`id`	Identificador único da lista de preços

Campos opcionais¶

Campo	Significado	Valor Padrão se Não Preenchido
`description`	Nome legível	Em branco
`priority`	Ordem de seleção; números menores são avaliados primeiro	Avaliada depois das listas com prioridade explícita
`effectiveStartDate`	Primeira data em que a lista se aplica	Sem limite inicial de vigência
`effectiveEndDate`	Última data em que a lista se aplica	Sem data de expiração

Lista de preços — locations¶

Caminho na plataforma¶

Data > Data Operations > Prices > Price Lists > Price List - Locations

Granularidade e chave¶

Granularidade: uma location aplicável por lista de preços.
Chave: priceListId + locationId.

Campos obrigatórios¶

Campo	Significado
`priceListId`	Lista de preços atribuída à location
`locationId`	Location onde a lista se aplica

Lista de preços — materiais¶

Caminho na plataforma¶

Data > Data Operations > Prices > Price Lists > Price List - Materials

Granularidade e chave¶

Granularidade: um material por lista de preços.
Chave: priceListId + materialId.

Campos obrigatórios¶

Campo	Significado
`priceListId`	Lista de preços que contém o material
`materialId`	Material valorado

Campos opcionais¶

Campo	Significado	Valor Padrão se Não Preenchido
`unitOfMeasureId`	Unidade em que os preços unitários foram informados	Unidade de vendas do material definida em `salesUomId`
`grossUnitPrice`	Preço bruto por unidade	A linha não fornece preço bruto; a seleção continua na próxima fonte aplicável
`netUnitPrice`	Preço líquido por unidade	A linha não fornece preço líquido; a seleção continua na próxima fonte aplicável

Preço padrão — material/location¶

Caminho na plataforma¶

Data > Data Operations > Prices > Standard Prices > Standard Price - Material/Location

Granularidade e chave¶

Granularidade: um preço padrão por material-location.
Chave: materialId + locationId.

Campos obrigatórios¶

Campo	Significado
`materialId`	Material valorado
`locationId`	Location onde o preço padrão se aplica

Campos opcionais¶

Campo	Significado	Valor Padrão se Não Preenchido
`unitOfMeasureId`	Unidade em que os preços unitários foram informados	Unidade de vendas do material definida em `salesUomId`
`grossUnitPrice`	Preço bruto padrão por unidade	O cadastro não fornece preço bruto; a seleção continua na próxima fonte aplicável
`netUnitPrice`	Preço líquido padrão por unidade	O cadastro não fornece preço líquido; a seleção continua na próxima fonte aplicável

Dependências¶

materialId referencia Materiais.
locationId referencia Locations.
unitOfMeasureId referencia Unidades de medida; quando não preenchida, a unidade segue as configurações de venda e padrão do material.
priceListId referencia o cabeçalho Lista de preços documentado nesta página.
A vigência é comparada ao período da demanda, do plano ou do fato econômico que está sendo valorado.

Utilizado por¶

valoração comercial da demanda histórica e futura;
snapshots de preço do Demand Plan e análises de pricing;
valoração de cenários de Supply Planning;
Inventory Optimization nos trade-offs de falta, write-off e capital empregado;
Cost-to-Serve e P&L para receita, contribuição e comparação de planos;
modelo de dados da decisão econômica.

Validações¶

use um id único e não vazio em cada lista;
use somente inteiros positivos quando informar prioridade;
não posicione o fim da vigência antes do início;
cadastre listas, materiais, locations e unidades antes de carregar relações ou valores;
não repita a mesma chave composta;
informe somente valores numéricos finitos;
confirme que a lista pretendida está atribuída à location e intercepta o período da análise;
diferencie preço ausente de preço realmente igual a zero.