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

Operação de download de Sell-in em tema escuro, com endpoint, escopo e período de referência

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: documentId deve diferenciar cada linha carregada.

O documentId pode ser o código da transação no sistema de origem ou uma combinação estável. Para uma carga consolidada por dia, origem, destino e material, use por exemplo 2026-05-31|CD-01|CLIENTE-07|MAT-001. Se unidade, canal, pedido, nota ou outra dimensão separar linhas, inclua-a no ID ou consolide antes da carga.

Em processos exclusivamente mensais, o total do mês pode ser carregado no primeiro ou no último dia do mês. A consolidação atribui o valor inteiro ao bucket mensal, sem distribuí-lo entre os dias. Escolha uma convenção e mantenha-a entre cargas. Consulte Identificadores e periodicidade.

Campos obrigatórios

Campo	Significado
`documentId`	Identificador único da transação ou da linha agregada
`referenceDate`	Data da venda ou data de referência escolhida para o 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

materialId referencia Materiais.
originLocationId e destinationLocationId referenciam Locations.
uomId referencia 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

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 documentId para 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.