SAP reference for sell-out¶
This reference translates the current public Community/Enterprise contracts.
The legacy planning-* codebase is not a mapping authority; confirm final
availability in the deployed edition and OpenAPI.
This page complements the sell-out contract. In SAP environments, sell-out often comes from the point of sale, SAP Customer Activity Repository/POS Data Management, or data shared by distributors. No universal SAP table represents sell-out across all these scenarios.
Nearby SAP grain¶
An official POS interface for SAP Demand Management Foundation applications aggregates sales by store, day, product, and offer. In OpsFactor, offer only needs to remain a dimension when rows for the same store, day, and material are not consolidated before loading.
| OpsFactor | Nearby SAP concept | Note |
|---|---|---|
documentId |
POS transaction ID or aggregate key | The key must remain stable across retries and reloads |
referenceDate |
business day or sales date | Normalize to the agreed business time zone |
originLocationId |
store or point of sale | Must reference an existing OpsFactor location |
materialId |
SAP product or material | Map to the same code used in the material master |
quantity |
quantity sold in base or sales unit | Do not mix units in the same consolidated row |
totalValue |
net or gross sales from the POS aggregate | Choose one definition and reconcile currency and taxes |
What to place in documentId¶
When the source retains individual transactions, use the immutable POS transaction and item identifier. When the source provides values consolidated by day, an appropriate ID is:
2026-05-31|STORE-02|MAT-001
This example assumes one unit and one consolidated row. Add unit or offer if they still separate records. For a monthly-only process, the total may be dated on either the first or last day of the month, following Identifiers and periodicity.
When SD documents can be used¶
VBRK/VBRP or another billing source represents sell-out only when the event
is truly the sale to the consumer or market at the observed location. Do not
automatically classify all SAP billing as sell-out: a manufacturer's sale to a
distributor is sell-in.
Technical POS tables and monitors vary across SAP Retail, SAP CAR, releases, and integration architectures. This reference therefore does not prescribe a single table or transaction; the contract must identify the selected POS interface or distributor source.