2. Carga de dados de demanda¶

Este treinamento apresenta a estrutura de dados utilizada pelo Demand Planning e orienta a carga de cada base na Edição Community. Os oito arquivos seguem a mesma sequência do processo, de 01 a 08.

Visão geral do Demand Planning¶

O Demand Planning tem o objetivo de gerar uma projeção de vendas que integre dois componentes:

• uma fundação estatística para as projeções de vendas;
• a colaboração das equipes de Planejamento, Comercial, Marketing e outras áreas na construção do plano.

O plano de demanda é essencial para modelos operacionais make-to-stock, em particular em cadeias longas, como aquelas que dependem de produtos ou componentes importados. Como esse tipo de operação depende de uma projeção futura de vendas para decidir estoques, produção, distribuição e capacidade produtiva e logística, o plano de demanda torna-se o principal insumo para as decisões táticas e operacionais subsequentes.

Estrutura de dados¶

Na edição Community o módulo de planejamento de demanda possui uma estrutura de dados bastante simples, consistindo basicamente dos dados mestres e transacionais apresentados abaixo:

---
config:
  layout: elk
  elk:
    mergeEdges: false
    nodePlacementStrategy: NETWORK_SIMPLEX
---
flowchart LR
    %% Layout + subgrafo global para manter os 3 subgrafos empilhados ao invés de lado a lado : queremos que os 3 apontem para as vendas à direita 
  subgraph registrations[" "]
    direction TB

    subgraph materialRegistration["Cadastro de Materiais"]
      direction LR
      materialCharacteristics["Características<br/>de Materiais<br/><span style='font-size:10px;color:#64748b'>Ex: Família, Categoria</span>"]
      materialCharacteristicValues["Valor da<br/>Característica<br/>por Material"]
      materials["Materiais<br/><span style='font-size:10px;color:#64748b'>Produtos Acabados, Semiacabados,<br>Matérias Primas</span>"]

      materialCharacteristics --> materialCharacteristicValues --> materials
    end

    subgraph locationRegistration["Cadastro de Locations"]
      direction LR
      locationCharacteristics["Características<br/>de Locations<br/><span style='font-size:10px;color:#64748b'>Ex: Canal, Regional</span>"]
      locationCharacteristicValues["Valor da<br/>Característica<br/>por Location"]
      locations["Locations<br/><span style='font-size:10px;color:#64748b'>Clientes, Fábricas,<br>CDs, Fornecedores</span>"]

      locationCharacteristics --> locationCharacteristicValues --> locations
    end

    subgraph unitRegistration["Cadastro de Unidades de Medida"]
      direction LR
      globalConversions["Conversões<br/>Globais<br/><span style='font-size:10px;color:#64748b'>Ex: TON->KG</span>"]
      unitsOfMeasure["Unidades de<br/>Medida"]
      materialConversions["Conversões por<br/>Material"]

      globalConversions --> unitsOfMeasure
      materialConversions --> unitsOfMeasure 
    end
  end

  sellout["Vendas<br/>(Sell-Out)"]

  materials --> sellout
  locations --> sellout
  unitsOfMeasure --> sellout

%% para não mostrar o subgrafo externo (registrations) com um fundo escuro 
style registrations fill:transparent,stroke:transparent,stroke-width:0px

Acesso à tela de Cadastro e Extração de Dados¶

Na Edição Community, abra o menu lateral → Data → Data Operations. O catálogo é organizado, da esquerda para a direita, em Theme, Group, Section e Topic. Quando um tópico é selecionado, a área inferior mostra o endpoint da API e as operações Download, Import e, quando aplicável, Delete.

Ordem das cargas¶

A numeração é global: ela indica a ordem em que os arquivos são apresentados e carregados neste tutorial.

01. Unidades de medida¶

As unidades de medida são referências usadas por materiais, vendas, estoques, roteiros e listas técnicas. Neste tutorial são cadastradas UN, KG e TON.

Carga da base de unidades de medida¶

X01_unit_of_measure.xlsx

CaminhoImportaçãoArquivo ExcelCampos

Campo	Significado	Valores usados no tutorial
Unit of Measure Id	Código único da unidade de medida. É a chave usada pelas demais bases.	UN, KG e TON
Description	Nome apresentado ao usuário.	Units, Kilograms e Metric tons

Importe as três linhas pela opção Import.

02. Características de material¶

As características de planejamento classificam os materiais e serão usadas no próximo treinamento para formar clusters de forecast. Esta base cadastra o nome e o tipo de cada característica; seus valores são informados depois, nas colunas do arquivo de materiais.

Carga da base de características de material¶

X02_material_characteristics.xlsx

CaminhoImportaçãoArquivo ExcelCampos

Campo	Significado	Valores usados no tutorial
Material Characteristic Id	Código único da característica.	MATERIAL_STAGE, PRODUCT_FAMILY, PRODUCT_FORMAT
Description	Nome apresentado ao usuário e usado como título da coluna no arquivo de materiais.	Material Stage, Product Family, Product Format
Type	Tipo dos valores aceitos pela característica.	CATEGORICAL nas três linhas

As três características têm funções diferentes:

• Material Stage indica a posição do material no processo: Raw Material, Roll, Semi-Finished ou Finished Good;
• Product Family agrupa materiais pela família de produto: Pulp, White Paper ou Tissue Paper;
• Product Format descreve a apresentação física: Pulp, Jumbo Roll, Skid, A4, Letter ou 12-Roll Pack.

03. Base de materiais¶

Os materiais representam matérias-primas, intermediários e produtos acabados. As colunas Material Stage, Product Family e Product Format são acrescentadas ao mesmo arquivo porque as características foram cadastradas no passo anterior.

Carga da base de materiais¶

X03_materials.xlsx

CaminhoImportaçãoArquivo ExcelCampos

Campo	Significado	Valores usados no tutorial
Id	Código único do material.	16 códigos entre matérias-primas, intermediários e acabados
Description	Descrição por extenso do material.	Descrição correspondente a cada código
Active	Define se o material participa das execuções de planejamento. O histórico de um material inativo ainda pode ser considerado pelos modelos estatísticos.	TRUE ou 1
Lifecycle Stage	Estágio comercial do ciclo de vida.	Em branco, pois não é usado neste tutorial
Introduction Date	Data a partir da qual o material passa a ser considerado vigente.	Em branco
Discontinuation Date	Data após a qual o material deixa de ser considerado vigente.	Em branco
Default Unit of Measure (SNP)	Unidade-base usada pelos planos de Supply Chain para produção, compra e transferência.	TON
Sales Unit of Measure (DP)	Unidade de referência opcional do Demand Planning.	Em branco; a unidade efetiva do forecast será confirmada na configuração por combinação de clusters
Default Transfer Unit of Measure (DRP)	Unidade-padrão opcional para transferências.	Em branco, fora do escopo deste treinamento
Operational Model	Indica como o material é atendido operacionalmente.	MTS (make-to-stock)
Material Stage	Posição do material no processo produtivo.	Raw Material, Roll, Semi-Finished, Finished Good
Product Family	Família comercial ou produtiva usada para agrupamento.	Pulp, White Paper, Tissue Paper
Product Format	Formato físico ou apresentação do material.	Pulp, Jumbo Roll, Skid, A4, Letter, 12-Roll Pack

Importe os 16 materiais pela opção Import.

04. Conversões globais de unidade¶

As conversões globais registram equivalências válidas para todos os materiais. Elas são usadas quando a relação entre duas unidades não depende do SKU, ao contrário das conversões por material apresentadas no passo seguinte.

Neste cenário, o histórico de Vendas está em KG, enquanto o forecast será gerado e analisado em TON. Por isso, a conversão global entre massa em quilogramas e toneladas é necessária para a execução do Demand Planning.

Carga da base de conversões globais de unidade¶

X04_unit_conversions.xlsx

CaminhoImportaçãoArquivo ExcelCampos

Campo	Significado	Valor usado no tutorial
Origin Unit of Measure Id	Unidade na qual a quantidade de origem é expressa.	TON
Target Unit of Measure Id	Unidade equivalente de destino.	KG
Origin Quantity	Quantidade tomada como referência na unidade de origem.	1
Target Quantity	Quantidade equivalente na unidade de destino.	1000

A linha estabelece que 1 TON = 1.000 KG. A plataforma também realiza a conversão inversa, de KG para TON.

05. Conversões por material¶

Esta base registra equivalências que dependem do SKU. Nos oito produtos acabados, uma UN corresponde a 0,25 KG ou 0,40 KG, conforme o material.

O histórico utilizado agora já está em KG, e as produtividades do cenário estão em TON. Portanto, a conversão global KG ↔ TON do arquivo 04 é suficiente para o forecast atual. O arquivo 05 completa a malha UN → KG → TON para que uma entrada ou análise futura em unidades também possa ser convertida.

Carga da base de conversões por material¶

X05_material_unit_conversions.xlsx

CaminhoImportaçãoArquivo ExcelCampos

Campo	Significado	Valores usados no tutorial
Material Id	Material ao qual a equivalência específica se aplica.	Oito produtos acabados
Origin Unit of Measure Id	Unidade da quantidade de origem.	UN
Target Unit of Measure Id	Unidade equivalente de destino.	KG
Origin Quantity	Quantidade tomada como referência na unidade de origem.	1
Target Quantity	Peso de uma unidade do material.	0,25 ou 0,40

06. Características de location¶

Estas características classificam as locations de demanda por região e canal. Assim como ocorre com materiais, esta base cadastra as características, e os valores são informados depois no próprio arquivo de locations.

Carga da base de características de location¶

X06_customer_characteristics.xlsx

CaminhoImportaçãoArquivo ExcelCampos

Campo	Significado	Valores usados no tutorial
Location Characteristic Id	Código único da característica.	CUSTOMER_REGION, SALES_CHANNEL
Description	Nome apresentado ao usuário e usado como título da coluna no arquivo de locations.	Customer Region, Sales Channel
Type	Tipo dos valores aceitos.	CATEGORICAL nas duas linhas

• Customer Region identifica a região atendida: Central, Coastal ou East;
• Sales Channel identifica o canal de vendas: Direct ou Indirect.

07. Base de locations¶

As locations representam fornecedores, fábricas, centros de distribuição, pontos de transbordo, clientes ou regiões de demanda. Os valores de Customer Region e Sales Channel são carregados nas últimas colunas deste mesmo arquivo; não existe uma carga separada para esses valores.

Carga da base de locations¶

X07_locations.xlsx

CaminhoImportaçãoArquivo ExcelCampos

Campo	Significado	Valores usados no tutorial
Location Id	Código único da location. Pode ser o código do ERP, uma sigla interna, um cliente ou uma combinação de região e canal.	12 códigos
Description	Descrição por extenso da location.	Descrição correspondente a cada código
Active	Define se a location participa das execuções de planejamento. Seu histórico ainda pode ser usado pelos modelos estatísticos quando ela estiver inativa.	TRUE ou 1
Location Type	Papel da location na rede.	Internal para fábrica/CD, Supplier para fornecedor e End Client para cliente ou região de demanda
Country, State, City	Localização geográfica opcional.	Dados de referência; não são usados nos cálculos deste tutorial
Customer Region	Região associada às locations do tipo End Client.	Central, Coastal, East
Sales Channel	Canal associado às locations do tipo End Client.	Direct, Indirect

Os campos de disponibilidade em planning books, unidade-padrão e consideração indireta de estoque de segurança permanecem em branco porque não participam do fluxo de Demand Planning deste tutorial.

08. Vendas¶

Na OpsFactor, o histórico de Vendas pode representar sell-in ou sell-out. Na Edição Community está disponível o sell-out, que registra uma venda passada — normalmente associada ao faturamento — a partir de uma location. Neste tutorial usamos o termo Vendas, que é mais direto para quem está executando o processo.

O histórico de Vendas é o insumo dos modelos estatísticos do Demand Planning. Para projeções mensais ou semanais, recomenda-se carregar pelo menos dois anos de histórico, de modo que existam ao menos dois ciclos sazonais completos para modelos como Holt-Winters e ARIMA.

O arquivo contém 38 meses, de janeiro de 2024 a fevereiro de 2027, para oito produtos acabados e seis locations de clientes. Todas as quantidades estão em KG; a conversão global do arquivo 04 permitirá gerar e analisar o forecast em TON.

Carga da base de Vendas¶

X08_sellout_history.xlsx

CaminhoImportaçãoArquivo ExcelCampos

Campo	Significado	Valores usados no tutorial
Document Id	Identificador único do registro de venda.	Um código por linha
Reference Date	Data de referência da venda.	Primeiro dia de cada mês
Origin Location Id	Cliente ou região de demanda de origem do histórico. Deve existir na base de locations.	Seis locations End Client
Material Id	Produto vendido. Deve existir na base de materiais.	Oito produtos acabados
Unit of Measure Id	Unidade na qual a quantidade foi registrada.	KG em todas as linhas
Quantity	Quantidade vendida na data, location e material indicados.	Quantidade histórica positiva

Importe as 1.824 linhas por último, depois que materiais, locations e unidades de medida já estiverem cadastrados.

Volte ao mapa do curso ou continue para a 3. Visão geral do Forecast de Demanda.