Entregas¶

Uma entrega registra a execução de uma linha de ordem: o que já foi separado, colocado em trânsito ou entregue. Ela não repete material, location ou unidade. Esses atributos vêm do item da ordem vinculado, mantendo a entrega reconciliada com o compromisso comercial ou de abastecimento.

Duas bases compartilham o mesmo modelo de linha de entrega:

• Sell-Out Deliveries vincula a execução às ordens de sell-out;
• Sell-In / Purchase / Transfer Deliveries vincula a execução às ordens com destino identificado e pode informar uma data esperada de entrega.

Essas bases pertencem atualmente à superfície Enterprise de Data Upload. O Community não publica essas interfaces versionadas como contratos Community.

Caminho na plataforma¶

• Data > Data Operations > Transactional Data > Orders > Sell-Out Orders > Sell-Out Deliveries
• Data > Data Operations > Transactional Data > Orders > Sell-In / Purchase / Transfer Orders > Sell-In / Purchase / Transfer Deliveries

Granularidade e chave¶

Uma linha representa uma linha de entrega aplicada a um item da ordem. A chave única combina:

deliveryId × orderId × orderItemId × deliveryLineId

Uma mesma entrega pode conter várias linhas. Reutilizar uma dessas chaves compostas substituiria a identidade de uma linha de entrega existente.

Campos obrigatórios¶

Campos opcionais comuns às duas bases¶

status aceita somente os valores documentados em Status da entrega.

Campo opcional adicional de Sell-In / Purchase / Transfer Deliveries¶

O arquivo Sell-Out Deliveries não possui expectedDeliveryDate.

Dados herdados do item da ordem¶

O arquivo de entregas não solicita novamente:

• material;
• locations de origem e destino;
• unidade de medida;
• datas solicitadas ou confirmadas da ordem.

Esses valores são resolvidos por orderId e orderItemId em Ordens abertas. A quantidade da entrega, portanto, utiliza a unidade da linha da ordem vinculada.

Dependências¶

• item de ordem aberta existente, identificado por orderId e orderItemId;
• material, locations e unidade de medida já resolvidos pelo item da ordem;
• ordem de carga de veículo quando loadingOrderId estiver preenchido;
• Status da entrega;
• malha de transporte quando a ordem vinculada representar uma transferência.

Utilizado por¶

• reconciliação das quantidades pedida, entregue e ainda aberta;
• projeção efetiva de ordens abertas usada pelo modelo de dados do Supply Planning;
• posicionamento dos recebimentos no destino pela data esperada;
• tratamento de quantidades em separação, trânsito ou já entregues;
• análise histórica de formação de cargas por Ordens de carga de veículos quando loadingOrderId estiver preenchido;
• DRP, Deployment e formação de cargas;
• análise de atendimento e da última data de entrega do item da ordem.

Validações¶

• os quatro campos da chave estão preenchidos e a combinação é única;
• orderId e orderItemId resolvem o mesmo item de ordem existente;
• loadingOrderId, quando preenchido, resolve uma ordem de carga existente;
• a quantidade é finita e não negativa;
• o status usa exatamente um valor aceito no payload;
• a quantidade entregue e a quantidade da ordem são reconciliadas na mesma unidade;
• uma entrega não é contada simultaneamente como quantidade aberta e recebimento concluído;
• as datas de criação e esperada são preenchidas quando o filtro cronológico e a disponibilidade no destino precisam ser auditáveis.