Identificadores e periodicidade¶

Uma linha integrada precisa continuar identificável depois de retries, correções e recargas. A data também precisa representar corretamente um evento, um valor consolidado ou uma fotografia de estado.

Como formar um ID¶

Use primeiro o identificador natural e imutável do sistema de origem. Quando a origem não fornece esse identificador, concatene as dimensões que definem a granularidade da linha.

A composição deve ser:

• única: duas linhas distintas não compartilham o mesmo ID;
• estável: a mesma linha recebe o mesmo ID em uma recarga;
• reproduzível: a regra pode ser aplicada novamente sem consultar uma sequência local;
• legível: datas usam o padrão ISO AAAA-MM-DD e os componentes preservam zeros à esquerda.

Use um separador que não apareça nos componentes ou aplique uma regra de escape documentada. Os exemplos transacionais abaixo usam |.

Vendas consolidadas por dia¶

Quando a origem entrega valores consolidados, carregue uma linha para cada combinação de dimensões e dia.

Esses exemplos assumem uma única linha consolidada por combinação e uma única unidade. Se a origem mantiver valores separados por unidade, canal, documento ou outra dimensão, inclua essa dimensão no ID ou consolide os valores antes da carga.

Processos mensais¶

Quando o processo trabalha apenas com buckets mensais, o valor total do mês pode ser carregado em uma única linha datada no primeiro ou no último dia do mês. A consolidação mensal atribui o valor inteiro ao bucket; ela não distribui a quantidade entre os dias.

Exemplo: 2026-05-01|LOJA-02|MAT-001 e 2026-05-31|LOJA-02|MAT-001 pertencem ao mesmo bucket de maio. Escolha uma das convenções e mantenha-a em todas as cargas e reconciliações.

Não aplique essa economia de linhas quando o processo precisa analisar dias ou semanas, distinguir eventos ou tratar dados atrasados dentro do mês.

Estoque é fotografia, não fluxo¶

Vendas de um período podem ser somadas. Posições de estoque de datas diferentes não podem: cada linha é uma fotografia do saldo em uma data de corte.

Para Supply Planning, carregue a fotografia correspondente ao início de cada período:

• buckets mensais: primeiro dia do mês;
• buckets semanais: segunda-feira, primeiro dia da semana ISO;
• buckets diários: início do próprio dia.

Assim, um plano mensal iniciado em maio usa a posição de 2026-05-01; um bucket semanal iniciado na segunda-feira 2026-05-04 usa a fotografia dessa data. Movimentos posteriores pertencem ao fluxo do período e não devem ser incorporados retroativamente à posição inicial.

Relação com sistemas de origem¶

O formato do identificador pode aproveitar chaves compostas do ERP, mas o contrato final continua sendo da OpsFactor. Consulte as referências de integração por ERP para exemplos de mapeamento sem transportar conceitos específicos do sistema de origem para o núcleo do catálogo.

Continue nas páginas de sell-out, sell-in, posições de estoque e no modelo de dados do Supply Planning.