COGS¶

COGS representa o custo unitário do material vendido ou atendido. Ele sustenta análises de margem bruta e contribuição, mas não substitui custos de produção, transporte, armazenagem, impostos ou demais custos operacionais. Esses custos permanecem separados para que o resultado possa ser rastreado até a decisão física que o gerou.

Como o COGS é selecionado¶

A plataforma localiza as listas de COGS 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 COGS unitário.
Se nenhuma lista aplicável fornecer o valor, o COGS padrão por material-location é avaliado.
Um COGS 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 COGS permanece ausente. Ausência não deve ser interpretada como custo real igual a zero.

Lista de COGS¶

Caminho na plataforma¶

Data > Data Operations > Costs > Cost Lists > Cost List

Granularidade e chave¶

Granularidade: uma linha por lista de COGS.
Chave: id único.

Campos obrigatórios¶

Campo	Significado
`id`	Identificador único da lista de COGS

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 COGS — locations¶

Caminho na plataforma¶

Data > Data Operations > Costs > Cost Lists > Cost List - Locations

Granularidade e chave¶

Granularidade: uma location aplicável por lista de COGS.
Chave: cogsListId + locationId.

Campos obrigatórios¶

Campo	Significado
`cogsListId`	Lista de COGS atribuída à location
`locationId`	Location onde a lista se aplica

Lista de COGS — produtos¶

Caminho na plataforma¶

Data > Data Operations > Costs > Cost Lists > Cost List - Products

Granularidade e chave¶

Granularidade: um material por lista de COGS.
Chave: cogsListId + materialId.

Campos obrigatórios¶

Campo	Significado
`cogsListId`	Lista de COGS que contém o material
`materialId`	Material valorado

Campos opcionais¶

Campo	Significado	Valor Padrão se Não Preenchido
`unitOfMeasureId`	Unidade em que o COGS unitário foi informado	Unidade padrão de Supply Planning definida em Parâmetros Globais de Planejamento
`unitCogs`	Custo de uma unidade do material	A linha não fornece COGS; a seleção continua na próxima fonte aplicável

COGS padrão — material/location¶

Caminho na plataforma¶

Data > Data Operations > Costs > Material / Location Costs > Standard Cost - Material/Location

Granularidade e chave¶

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

Campos obrigatórios¶

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

Campos opcionais¶

Campo	Significado	Valor Padrão se Não Preenchido
`unitOfMeasureId`	Unidade em que o COGS unitário foi informado	Unidade padrão de Supply Planning definida em Parâmetros Globais de Planejamento
`unitCogs`	Custo padrão de uma unidade do material	O cadastro não fornece COGS; a seleção continua na próxima fonte aplicável

Dependências¶

materialId referencia Materiais.
locationId referencia Locations.
unitOfMeasureId referencia Unidades de medida ou segue os Parâmetros Globais de Planejamento.
cogsListId referencia o cabeçalho Lista de COGS 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¶

análises de margem bruta e contribuição;
valoração de cenários de Supply Planning;
Inventory Optimization quando a decisão de estoque altera vendas, write-off ou exposição de material;
Cost-to-Serve e P&L como componente de custo do material da demanda atendida;
análises de pricing e sortimento;
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;
considere que valor em branco, zero ou negativo não fornece COGS positivo para a seleção econômica;
não combine COGS com produção, frete, armazenagem ou impostos no mesmo campo.