Sell-in¶
Sell-in registra uma venda na qual conhecemos a origem e o destino: qual unidade interna realizou a venda e para qual cliente ou location ela foi realizada.
Ele é apropriado quando o cliente atendido é uma dimensão relevante, como em canais diretos, faturamento, expedições identificadas ou vendas de uma planta ou CD para um distribuidor.
Caminho na plataforma¶
Data > Data Operations > Transactional Data > Sales / Inventory > Historical Sales > Sales / Sell-in

A operação de Sell-in segue o mesmo fluxo: escolha entre intervalo de datas e base completa, preencha os filtros obrigatórios e então execute o download.
Granularidade e identificação¶
- Granularidade: uma transação ou um agregado por data, origem, destino, material e unidade.
- Identificação:
documentIddeve diferenciar cada linha carregada.
O documentId pode ser o código da transação no sistema de origem ou uma combinação estável, como data + material + origem + destino. Se a combinação puder se repetir, acrescente o número do pedido, da nota ou outro elemento diferenciador.
Campos obrigatórios¶
| Campo | Significado |
|---|---|
documentId |
Identificador único da transação ou da linha agregada |
referenceDate |
Data da venda ou início do período agregado |
originLocationId |
Unidade interna que realizou a venda |
destinationLocationId |
Cliente ou location para a qual a venda foi realizada |
materialId |
Material vendido |
quantity |
Quantidade vendida |
Campos opcionais¶
| Campo | Significado | Valor Padrão se Não Preenchido |
|---|---|---|
uomId |
Unidade em que a quantidade foi informada | Valor definido em Parâmetros Globais de Planejamento (padrão nesse cadastro: UN) |
totalValue |
Valor total da venda | 0 |
discounts |
Descontos associados | 0 |
tax |
Tributos associados | 0 |
cost |
Custo associado | 0 |
Quando uomId for informado, o código deve existir no cadastro de unidades de medida e ser conversível para a unidade do plano.
Dependências¶
materialIdreferencia Materiais.originLocationIdedestinationLocationIdreferenciam Locations.uomIdreferencia Unidades de medida ou segue o fallback dos Parâmetros Globais de Planejamento.- A seleção desta fonte usa o enum Fonte do histórico de vendas, configurado no Perfil de execução do Demand Planning.
Utilizado por¶
- Preparação do Demand Planning
- Perfil de execução do Demand Planning
- AutoFit por cluster
- Execução do Demand Planning
- Análise do Demand Plan
Sell-in e sell-out no mesmo processo¶
Uma venda da planta ou do CD para um distribuidor é registrada como sell-in: conhecemos o elo interno de origem e a location do distribuidor. Se existir planejamento colaborativo com esse cliente, o distribuidor também pode compartilhar seu sell-out e seus estoques. Assim, a projeção de sell-out do distribuidor, combinada ao estoque atual e projetado, apoia a projeção do sell-in futuro necessário para reabastecê-lo.
As fontes podem coexistir também por canal: sell-out para um canal indireto que compartilha dados e sell-in para canais diretos. Não some as duas séries sem delimitar o ponto do fluxo e o escopo de cada uma.
Validações recomendadas¶
- não repetir o mesmo
documentIdpara linhas diferentes; - cadastrar materiais, locations e unidades antes da carga;
- estabelecer uma regra clara para devoluções e quantidades negativas;
- carregar apenas períodos históricos fechados;
- reconciliar os totais por período com o sistema de origem.