Pular para conteúdo

Sell-out

Sell-out registra a venda observada em uma location da venda quando não é relevante ou possível identificar o destino final.

O exemplo mais comum é a venda para um consumidor em uma loja: para o planejamento, é relevante saber em qual loja, data e material a demanda ocorreu, mas não identificar individualmente o consumidor. Sell-out também pode representar a saída de um distribuidor quando ele compartilha suas vendas ao mercado.

Compare essa estrutura com o sell-in, que preserva a origem e o destino do fluxo comercial.

Caminho na plataforma

Data > Data Operations > Transactional Data > Sales / Inventory > Historical Sales > Sales / Sell-out

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

A operação permite extrair um período ou a base completa. Para um intervalo, informe as datas inicial e final antes de escolher o formato do arquivo.

Granularidade e identificação

  • Granularidade: uma transação ou um agregado por data, material, location da venda e unidade.
  • Identificação: documentId deve diferenciar cada linha carregada.

O documentId pode ser o identificador da transação no sistema de origem ou uma combinação estável, como data + material + código da location. Exemplo: 2026-05-31|MAT-001|LOJA-02. Se a combinação puder se repetir, acrescente outro elemento que diferencie a linha.

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 Location da Venda na qual a demanda foi observada
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

Utilizado por

Sell-out compartilhado pelo distribuidor

Em um processo colaborativo, o fornecedor pode manter o sell-in de sua planta ou CD para o distribuidor e receber do distribuidor o sell-out e o estoque desse mesmo canal. O sell-out indica a demanda observada a partir do distribuidor; combinado ao estoque atual e projetado, ele apoia a projeção do sell-in futuro necessário para reabastecê-lo.

As duas séries representam pontos diferentes do fluxo e não devem ser somadas sem separar seus escopos.

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.