CX-0157 Predictive Unit Real-Time Information Service (PURIS)
ABSTRACT
The Catena-X Predictive Unit Real-Time Information Service (PURIS) Standard is created for all members of the automotive supply chain.
The PURIS standard provides the key information needed to assess this situation from both sides, based on the "quid pro quo" principle. This principle is based on the idea of sharing information that is perceived as being of equal value. The information defined in this standard adds to the information exchanged within the current EDI formats:
- Short-Term Material Demands to provide the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s actual need from production.
- Planned Production Output reflecting the internal production planning to fulfill the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. demands.
- Delivery Information bridging the geographical gap between the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. and supplierSupplier In the context of OSim, the producer of goods. facilities.
- Item Stock levels to better understand the current demand and supply situation.
- Supply Chain Disruption Notifications to inform customersCustomer In the context of OSim, the receiver of produced goods from a supplier. and suppliersSupplier In the context of OSim, the producer of goods. in a structured way about present and upcoming supply chain disruptions.
- Days of Supply providing inbound and outbound supply ranges for considered time frame.
The information exchanged provides a foundation for collaboration. It establishes a shared understanding on the supply situation between the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. and the supplierSupplier In the context of OSim, the producer of goods.. Catena-X provides the framework (see [CX-REG]) and tools to enable the exchange of this sensitive information and take advantage of the benefits.
1 INTRODUCTION
In recent years, global supply chains have been significantly affected by global crises. Ever-increasing complexity and interdependencies compound this issue. As a result, small and medium-sized enterprises as well as large enterprises are exposed to an increased risk of disruptions in their supply chains. To adapt to short-term fluctuations and develop the right countermeasures, it is essential to have sound information about the current supply situation. This is commonly needed in two cases: either you 1) face a disruption you need to manage or you 2) want to detect disruptions faster.
This standard specifies the key information and ensures interoperability for the exchange of key information to detect and manage disruptions targeting a short-term period of up to 4 weeks. During a disruption, this information is often collected manually and exchanged via e.g. phone calls or e-mail correspondence. All information is partner-specific. It is intended to be used to manage or prevent disruptions.
- Delivery Information allows customersCustomer In the context of OSim, the receiver of produced goods from a supplier. and suppliersSupplier In the context of OSim, the producer of goods. to align their views on deliveries including tracking numbers to assess the timely fulfilment of customerCustomer In the context of OSim, the receiver of produced goods from a supplier. orders from various suppliersSupplier In the context of OSim, the producer of goods. helping to avoid shortages and bottlenecks.
- Short-Term Material Demand allows customersCustomer In the context of OSim, the receiver of produced goods from a supplier. to provide their latest material requirements, derived directly from their production schedules. This enables suppliersSupplier In the context of OSim, the producer of goods. to identify actual needs during a disruption or may anticipate disruptions.
- Planned Production Output allows suppliersSupplier In the context of OSim, the producer of goods. to provide planned production quantities. This enables customersCustomer In the context of OSim, the receiver of produced goods from a supplier. to understand the actual supply situation during a disruption or may anticipate disruptions.
- Item Stock allows customersCustomer In the context of OSim, the receiver of produced goods from a supplier. and suppliersSupplier In the context of OSim, the producer of goods. to share their latest stock levels (inbound, outbound). This enables both parties to better align countermeasures during a disruption or anticipate disruptions.
- Days of Supply allows customersCustomer In the context of OSim, the receiver of produced goods from a supplier. and suppliersSupplier In the context of OSim, the producer of goods. to share a common metric (inbound, outbound) used during disruptions or to anticipate disruptions.
- Supply Chain Disruption Notifications allow customersCustomer In the context of OSim, the receiver of produced goods from a supplier. and suppliersSupplier In the context of OSim, the producer of goods. to receive, warn and forward disruption information in a structured way. It allows to link affected materials and sites and document measures taken.
This information is combined to provide the partners a common view on the current supply situation. This standard provides you additional definitions on how the information is assembled and how it may be combined. Additionally it provides compliance strategies.
1.1 AUDIENCE & SCOPE
This section is non-normative
This standard is relevant for the following roles defined in [CX-OMW]:
Data Providers willing to provide any of the following information:
- Delivery Information
- Short-term Material Demand
- Planned Production Output
- Item Stock
- Days of Supply
- Supply Chain Disruption Notifications
Data Consumers who are interested in requesting and receiving any of the following information:
- Delivery Information
- Planned Production Output
- Short-term Material Demand
- Item Stock
- Days of Supply
- Supply Chain Disruption Notifications
Business Application Providers interested in providing solutions implementing this standard.
Advisory Services Providers interested in supporting companies fulfilling the standard.
For clarity on the roles and responsibilities of each actor, please see Chapter 5. The scope of this standard is the exchange of previously mentioned information. It does not cover any specific countermeasures between partners in a one-to-one business relationship resulting from the notification process.
Illustrations and descriptions of roles are provided to help explain concepts and processes, but these are not mandatory (see Chapter 5).
This standard requires that data consumers, data providers and business application providers must adopt the uniform business logic (according to Chapter 5), data models and data exchange protocols to ensure interoperable data exchange.
This standard focuses on direct one-to-one business relationships between customersCustomer In the context of OSim, the receiver of produced goods from a supplier. and suppliersSupplier In the context of OSim, the producer of goods..
1.2 CONTEXT AND ARCHITECTURE FIT
This section is non-normative
This standard defines the data models and APIsAPI An API is a way for two or more computer programs to communicate with each other. required for the exchange of Supply Chain Disruption Notifications. Implementing it ensures that:
- all actors exchange information in an identical manner.
- all actors process information data in an identical manner.
- all actors exchange information data only via a connector conformant to [CX-0018].
- all actors interpret the exchanged information data in an identical manner.
The APIsAPI An API is a way for two or more computer programs to communicate with each other. must only be used in the context of Catena-X and must only be accessible via a connector conformant to [CX-0018].
1.3 CONFORMANCE AND PROOF OF CONFORMITY
This section is non-normative
Non-mandatory sections include authoring guidelines, diagrams, examples and notes. All other content is mandatory.
The capitalized keywords such as MAY, MUST, MUST NOT, OPTIONAL, RECOMMENDED, REQUIRED, SHOULD and SHOULD NOT are to be interpreted as defined in BCP 14 ([RFC2119] [RFC8174]).
Participants must demonstrate conformity with Catena-X standards. Conformity Assessment Bodies (CABs) verify that standards are correctly applied.
Proof of Conformity for Data Models
Participants must implement and conform to the standardized Data Models as outlined in Chapter 3.
Proof of Conformity for APIsAPI An API is a way for two or more computer programs to communicate with each other.
Participants must implement and conform to the standardized APIsAPI An API is a way for two or more computer programs to communicate with each other. as detailed in Chapter 4.
Proof of Conformity for Process & Core Business Logic
Participants must implement and conform to the Predictive Unit Real-Time Information Service (PURIS) core business logic as described in Chapter 5.
1.4 EXAMPLES
Examples of data models: See the relevant subsection 3 Aspect Models.
1.5 TERMINOLOGY
This section is non-normative
| Name | Abrev. | Description |
|---|---|---|
| Business Partner Number | BPNBPN A BPN is the unique identifier of a partner within Catena-X. | A BPNBPN A BPN is the unique identifier of a partner within Catena-X. is the unique identifier of a partner within Catena-X as defined in [CX-0010]. |
| Business Partner Number Address | BPNA | A BPNA is the unique identifier of a partner address within Catena-X as defined in [CX-0010]. |
| Business Partner Number Legal Entity | BPNLBPNL The unique identifier of a legal entity of a partner within Catena-X (e.g., a company). | A BPNLBPNL The unique identifier of a legal entity of a partner within Catena-X (e.g., a company). is the unique identifier of a partner legal entity within Catena-X as defined in [CX-0010]. |
| Business Partner Number Site | BPNSBPNS The unique identifier of a partner site within Catena-X (e.g., a specific factory). | A BPNSBPNS The unique identifier of a partner site within Catena-X (e.g., a specific factory). is the unique identifier of a partner site within Catena-X as defined in [CX-0010]. |
| Actual time | - | Refers to the specific, real-time date and time when an event occurs during delivery. |
| Estimated time | - | Refers to a projected or estimated time for an event or occurrence, based on calculations or predictions, rather than the exact, confirmed time. |
| Incoterms | - | Is a combination of "International" and "Commercial Terms." Incoterms are a set of standardized international trade terms that facilitate and define the responsibilities of customersCustomer In the context of OSim, the receiver of produced goods from a supplier. and suppliersSupplier In the context of OSim, the producer of goods. in transactions. |
| Origin | - | The starting point from which goods are dispatched or shipped from. |
| Destination | - | The final location at which the goods are to be delivered or received. |
| Demand | - | The quantity demanded over a given time frame. This must be greater than or equal to 0 and less than or equal to 999999999999999999.999. It allows up to 12 digits and three decimal places. |
| Demand series | - | The demands for a specific material over a given time period at a given demand rate, distinguished by their demand location and demand category. |
| Demand category | - | Classification of demands used for prioritization or allocation. |
| Position | - | A position within an order defines the product and the quantity the supplierSupplier In the context of OSim, the producer of goods. has to manufacture / supply for a customerCustomer In the context of OSim, the receiver of produced goods from a supplier.. A single order may contain multiple positions for different products. |
| Order | - | A request from a customerCustomer In the context of OSim, the receiver of produced goods from a supplier. towards a supplierSupplier In the context of OSim, the producer of goods. to manufacture / supply a given quantity of a specific product in a predefined timeframe. |
| Allocated Stock | - | These are products, components or materials that have already been manufactured but not yet used. These are allocated to a specific customerCustomer In the context of OSim, the receiver of produced goods from a supplier. based on their orders and are either still in the supplierSupplier In the context of OSim, the producer of goods.'s warehouse or have already been transferred to the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s warehouse. |
| Provider | - | The party providing the Item Stock data. In the context of the Item Stock exchange this is: - the supplierSupplier In the context of OSim, the producer of goods. for OUTBOUND Item Stock - the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. for INBOUND Item Stock. |
| Consumer | - | The party requesting and consuming the Item Stock data provided by the Provider. In the context of the Item Stock exchange this is: - the supplierSupplier In the context of OSim, the producer of goods. for OUTBOUND Item Stock - the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. INBOUND Item Stock. |
| Stock Location | - | The physical location of a stock specified by its corresponding BPNSBPNS The unique identifier of a partner site within Catena-X (e.g., a specific factory). and BPNA. More information on BPNBPN A BPN is the unique identifier of a partner within Catena-X./S/A is provided in [CX-0010]. |
| CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | - | The recipient of products ordered from / manufactured by a supplierSupplier In the context of OSim, the producer of goods.. |
| SupplierSupplier In the context of OSim, the producer of goods. | - | The supplierSupplier In the context of OSim, the producer of goods. / manufacturer of a product. |
| Stock | Two-way direction of material on stock: - One can have a stock of material ready for delivery to customersCustomer In the context of OSim, the receiver of produced goods from a supplier. - One can have a stock of material which can be used for one's production. | |
| Material | - | The term material is used as a catalogue item in the meaning of the Industry Core Part Type ([CX-0126]). Whenever using the term material, it refers to products, components or items. Semi-finished goods are not included. |
| Production Output | - | The output quantity in a defined period of time for a component or material. |
| Direction | - | The direction of the stock from the perspective of the data provider. |
| Date | - | Date refers to the specific calendar day (current or projected) associated with the measured (or expected) inventory level. It serves as a timestamp for calculating Days of Supply, indicating when the inventory count was taken or projected. |
| Days of Supply | DoS | The number of days until the current stock is expected to run out. Days of supply of a customerCustomer In the context of OSim, the receiver of produced goods from a supplier.: Number of days where; (Stock) - S(daily Demand) >= 0 Days of supply of a supplierSupplier In the context of OSim, the producer of goods.: Number of days where; (Stock) - S(daily Outgoing Shipments) >= 0 |
| Allocated Days of Supply | - | Defines the number of days with allocated supply for an item stock in a given location that is available for the use in production or deliveries. The allocated days of supply are not available for other customersCustomer In the context of OSim, the receiver of produced goods from a supplier.. |
| Digital Twin | DT | Digital representation of an assetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. that provides data on aspects of the represented data following [CX-0002]. |
| (decentralized) Digital Twin Registry | dDTR / DTR | Component providing registration and discovery APIAPI An API is a way for two or more computer programs to communicate with each other. implementations following [CX-0002]. Sometimes referred to without the "decentralized" BUT in Catena-X these are always decentralized. |
| Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin. | AAS | Technical concept for Digital Twins consisting of different standards. Application in Catena-X is described in Digital Twins in Catena-X standard ([CX-0002]) |
| Shell Descriptor | - | Technical concept of the AAS APIAPI An API is a way for two or more computer programs to communicate with each other. describing metadata of an Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin. representing a Digital Twin. It contains identification information and metadata about which submodels are available and where the data can be obtained (see [CX-0002] and [IDTA-01002-3-0]). There may be multiple Shell Descriptors for the same represented AssetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. (see [CX-0126]). |
| Submodel Descriptor | - | Technical concept of the AAS APIAPI An API is a way for two or more computer programs to communicate with each other. describing metadata of Submodels within a Shell Descriptor (Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin.) (see [CX-0002], [IDTA-01002-3-0]). |
| Specific AssetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. IdsIDS The International Data Space enables 'smart services' and business processes across companies and industries while ensuring data sovereignty and self-determined control of data use. | - | Identifiers of the Shell Descriptor (Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin.) that refer to common identification data for an assetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer./material at hand e.g., manufacturer part Id. Common specific assetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. idsIDS The International Data Space enables 'smart services' and business processes across companies and industries while ensuring data sovereignty and self-determined control of data use. used for identification are described in Industry Core Part Type Standard (see [CX-0126]). |
| Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin. Identifier | AAS ID | Also referred to as Shell Descriptor id, is the technical identifier of the Shell Descriptor. |
| Global AssetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. Id | - | Also referred to as Catena-X Id, is the Catena-X identifier for assetsAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. represented by Digital Twins (see [CX-0126]). |
| Aspect | - | A domain-specific view on information and functionality associated with a specific Digital Twin with a reference to a concrete Aspect ModelAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). (see [CX-0002]). Within Catena-X, an aspect is formally described using the Semantic Aspect Meta Model (see [CX-0003]). |
| Semantic Id | - | Identifier including namespace to specify the semantic description of submodels using the Semantic Aspect Meta Model (SAMM). It allows partners to know the exact data format and semantics when e.g., browsing catalogs (see [CX-0003]). |
| Data Space Protocol | DSP | A set of specifications designed to facilitate interoperable data sharing between entities governed by usage control and based on Web technologies. These specifications define the schemas and protocols required for entities to publish data, negotiate Agreements, and access data as part of a Dataspace. It is governed by the International Data Spaces Association. Connectors compliant to [CX-0018] support the Data Space Protocol. |
| Shared AssetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. Approach | - | Digital twin pattern in which each party has a twin for the same assetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. (Part Type). They share the same identification data in terms of specific assetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. idsIDS The International Data Space enables 'smart services' and business processes across companies and industries while ensuring data sovereignty and self-determined control of data use. and global assetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. id. The digital twins do have different technical identifiers. |
Table 1: Terminology for PURIS Standard
Additional terminology used in this standard can be looked up in the glossary on the association's homepage.
2 RELEVANT PARTS OF THE STANDARD FOR SPECIFIC USE CASES
This section is normative
2.1 DATA PROVISIONING: PREDICTIVE UNIT REAL-TIME INFORMATION SERVICE (PURIS) DATA MODELS
2.1.1 LIST OF STANDALONE STANDARDS
The following Catena-X standards are a prerequisite for implementing this standard and therefore MUST be considered / implemented by the relevant parties specified in each standard.
| Number | Standard | Version |
|---|---|---|
| [CX-0001] | Participant Agent Registration | 1.2.0 |
| [CX-0003] | SAMM Aspect Meta Model | 1.2.0 |
| [CX-0006] | Registration and initial onboarding | 2.0.1 |
| [CX-0010] | Business Partner Number (BPNBPN A BPN is the unique identifier of a partner within Catena-X.) | 3.0.1 |
| [CX-0018] | Dataspace Connectivity | 4.1.1 |
| [CX-0126] | Industry Core Part Type | 2.1.1 |
Table 2: List of mandatory standards
The usage of this standard MAY be complemented with the following Catena-X standards to further extend the range of shortage prevention possibilities:
| Number | Standard | Version |
|---|---|---|
| [CX-0146] | Supply Chain Disruption Notifications | 2.0.1 |
Table 3: List of non-mandatory, but complementary standards
2.1.2 DATA REQUIRED
The data provisioning follows the rules of Case 1 and Case 2 as described in Chapter 2 in [CX-0126]. Thus, it follows the following design patterns:
- Usage of Digital Twins as shared assetsAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. to follow a pull approach for data.
- Usage of the specific assetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. IDsIDS The International Data Space enables 'smart services' and business processes across companies and industries while ensuring data sovereignty and self-determined control of data use. and further identification data for the Digital Twin for the Part Type (see [CX-0126]).
- Provisioning of the PartTypeInformation on supplierSupplier In the context of OSim, the producer of goods. side (see [CX-0126]).
The following table provides an overview
- which partner role MUST provide which submodel data (based on the semantic model) by attaching it to their part type twin.
- which partner role MUST consume which submodel data (based on the semantic model) by reading from their partner's part type twin.
| Provider Partner Role | Consumer Partner Role | Semantic Model | Further Information |
|---|---|---|---|
| CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | SupplierSupplier In the context of OSim, the producer of goods. | Short-Term Material Demand | - |
| CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | SupplierSupplier In the context of OSim, the producer of goods. | Item Stock | Provided with direction inbound. |
| CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | SupplierSupplier In the context of OSim, the producer of goods. | Delivery Information | Provisioning role depends on incoterm as defined in Table 9. |
| CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | SupplierSupplier In the context of OSim, the producer of goods. | Days of Supply | Provided with direction inbound. |
| SupplierSupplier In the context of OSim, the producer of goods. | CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | Planned Production Output | - |
| SupplierSupplier In the context of OSim, the producer of goods. | CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | Item Stock | Provided with direction outbound. |
| SupplierSupplier In the context of OSim, the producer of goods. | CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | Delivery Information | Provisioning role depends on incoterm as defined in Table 9. |
| SupplierSupplier In the context of OSim, the producer of goods. | CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | Days of Supply | Provided with direction outbound. |
Table 4: Overview which semantic model is provided by which partner.
2.1.3 ADDITIONAL REQUIREMENTS
CONVENTIONS FOR USE CASE POLICY IN CONTEXT DATA EXCHANGE
In alignment with our commitment to data sovereignty, a specific framework governing the utilization of data within the Catena-X use cases has been outlined. A set of specific policies on data offering and data usage level detail the conditions under which data may be accessed, shared, and used, ensuring compliance with legal standards.
For a comprehensive understanding of the rights, restrictions, and obligations associated with data usage in the Catena-X ecosystem, we refer users to:
- the detailed ODRL policy repository [CX-ODRL]. This document provides in-depth explanations of the terms and conditions applied to data access and utilization, ensuring that all engagement with our data conducted responsibly and in accordance with established guidelines.
- the ODRL schema template. This defines how policies used for data sharing/usage should get defined. Those schemas MUST be followed when providing services or apps for data sharing/consuming.
ADDITIONAL DETAILS REGARDING ACCESS POLICIES
A Data Provider may tie certain access authorizations ("Access Policies") to its data offers for members of Catena-X and one or several Data Consumers. By limiting access to certain Participants, Data Provider maintains control over its anti-trust obligations when sharing certain data. In particular, Data Provider may apply Access Policies to restrict access to a particular data offer for only one Participant identified by a specific business partner number.
- Membership
- BPNLBPNL The unique identifier of a legal entity of a partner within Catena-X (e.g., a company).
ADDITIONAL DETAILS REGARDING USAGE POLICIES
In the context of data usage policies (“Usage Policies”), Participants and related services MUST use the following policy rules:
- Use Case Framework (“FrameworkAgreement”)
- at least the use case purpose (“UsagePurpose”) with right operand
cx.puris.base:1from the above mentioned ODRL policy repository.
Additionally, respective usage policies MAY include the following policy rule:
- Reference Contract (“ContractReference”).
Details on namespaces and ODRL policy rule values to be used for the above-mentioned types are provided via the ODRL policy repository [CX-ODRL].
VERSIONING
The Aspect ModelsAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). that are deployed as Digital Twins MUST be published in dcat:Dataset (http://www.w3.org/ns/dcat#) in the property that holds the full URN of the Aspect ModelAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). https://admin-shell.io/aas/3/0/HasSemantics/semanticId. Versions are explicitly contained in the URN.
The APIAPI An API is a way for two or more computer programs to communicate with each other. versions MUST be published in the property https://w3id.org/catenax/ontology/common#version as version X.Y in dcat:Dataset (http://www.w3.org/ns/dcat#).
Note: Data AssetsAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. differentiated only by major versions MUST be offered in parallel. The current standard and APIAPI An API is a way for two or more computer programs to communicate with each other. versions mark the start of Life Cycle Management in Catena-X operations. Previous versions are dismissed.
2.1.4 DIGITAL TWINS AND SPECIFIC ASSETAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. IDsIDS The International Data Space enables 'smart services' and business processes across companies and industries while ensuring data sovereignty and self-determined control of data use.
This standard follows the definitions of [CX-0126] to provide digital twins following the industry core. This includes the definition of identification data (Catena-X ID / Global AssetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. Id, Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin. ID, Specific AssetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. ID) and the access restrictions.
Additionally this implies that the supplierSupplier In the context of OSim, the producer of goods. always needs to create the digital twins first to define the Catena-X ID / Global AssetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. Id. The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. then looks up the supplierSupplier In the context of OSim, the producer of goods. twin when creating his copy to use the same Catena-X ID / Global AssetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. Id. Table 4 describes which partner provides which information.
3 ASPECT MODELSAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing).
This section is normative
Relevant semantic models of this standard are:
| AspectModel | Version |
|---|---|
| ShortTermDemandInformation | 1.0.0 |
| ItemStock | 2.0.0 |
| PlannedProductionOutput | 2.0.0 |
| DeliveryInformation | 2.0.0 |
| DaysOfSupply | 2.0.0 |
Table 5: Overview of aspect modelsAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). specific to this standard.
3.1 ASPECT MODELAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). "SHORT-TERM MATERIAL DEMAND"
3.1.1 INTRODUCTION
This section describes the "Short-Term Material Demand" semantic model. It defines the demand of material, product, component or items for a customerCustomer In the context of OSim, the receiver of produced goods from a supplier.. For the complete semantics and detailed description of its properties refer to the SAMM model in Chapter 3.1.5.1.
3.1.2 SPECIFICATIONS ARTIFACTS
The modeling of the semantic model specified in this document was done in accordance to the "semantic-driven workflow" to create a submodel template specification [SMT].
This aspect modelAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). is written in SAMM 2.1.0 as a modeling language conformant to [CX-0003] as input for the semantic-driven workflow.
Like all Catena-X data models, this model is available in a machine-readable format on GitHub conformant to [CX-0003].
3.1.2.1 SHORT-TERM MATERIAL DEMAND CATEGORY HANDLING
The Short-Term Material Demand data MUST consider the following demand categories shared with the DCM standard CX-0128.
| Demand Category | Description | Demand Category Code (Based on Data Model) |
|---|---|---|
| Default | No Assignment. Use if no other category applies. | 0001 |
| After-Sales | After sales demand of spare parts | A1S1 |
| Series | Dependent demand e.g. production, assembly, raw material | SR99 |
| Phase-In-Period | Ramp up of a new product or new material introduction | PI01 |
| Single-Order | Demand outside the normal spectrum of supply | OS01 |
| Small Series | Short time frame for demand and pose to higher volatility | OI01 |
| Extraordinary Demand | Temporary demand on top of standard demand. Used e.g. in the following scenarios: - logistic optimization (e.g., full use of container) - preventing shortage by building stock (banking) - restocking safety stock | ED01 |
| Phase-Out-Period | Ramp down; Product or material retires from the market | PO01 |
Table 6: Short-Term Material Demand categories
3.1.3 LICENSE
This Catena-X data model is made available under the terms of the Creative Commons Attribution 4.0 International (CC-BY-4.0) license, which is available at Creative Commons.
3.1.4 IDENTIFIER OF SEMANTIC MODEL
The semantic model ShortTermMaterialDemand v1.0.0 has the unique identifier:
urn:samm:io.catenax.short_term_material_demand:1.0.0
3.1.5 FORMATS OF SEMANTIC MODEL
3.1.5.1 RDF TURTLE
The RDF turtle file, an instance of the Semantic Aspect Meta Model, is the master for generating additional file formats and serializations. It can be found under the following link:
The open source command line tool of the Eclipse Semantic Modeling Framework is used for generation of other file formats, such as a JSON Schema, AASX for Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin. Submodel Template or a HTML documentation.
3.1.5.2 JSON SCHEMA
A JSON Schema MUST be generated from the RDF Turtle file. The JSON Schema defines the Value-Only payload of the Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin. for the APIAPI An API is a way for two or more computer programs to communicate with each other. operation "GetSubmodel".
3.1.5.3 AASX
An AASX file can be generated from the RDF Turtle file. The AASX file defines one of the requested artifacts for a Submodel Template Specification conformant to [SMT].
3.1.6 EXAMPLE DATA
Example JSON payload: Submodel "ShortTermMaterialDemand" v1.0.0
{
"materialGlobalAssetId": "urn:uuid:48878d48-6f1d-47f5-8ded-a441d0d879df",
"demandSeries": [
{
"lastUpdatedOnDateTime" : "2023-11-05T08:15:30.123-05:00",
"expectedSupplierLocation": "BPNS8888888888XX",
"demands": [
{
"demand": {
"value": 180,
"unit" : "unit:piece"
},
"day" : "2023-10-09"
}
],
"customerLocation": "BPNS9090909090YY",
"demandCategory": {
"demandCategoryCode": "SR99"
}
},
{
"expectedSupplierLocation": "BPNS8888888888XX",
"lastUpdatedOnDateTime" : "2023-11-05T08:15:30.123-05:00",
"demands": [
{
"demand": {
"value": 100,
"unit" : "unit:piece"
},
"day" : "2023-10-09"
}
],
"customerLocation": "BPNS5555555555XX",
"demandCategory": {
"demandCategoryCode": "A1S1"
}
}
]
}
3.2 ASPECT MODELAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). "ITEM STOCK"
3.2.1 INTRODUCTION
This section describes the "ItemStock" semantic model used in the Catena-X network. For the complete semantics and detailed description of its properties refer to the SAMM model in Chapter 3.2.5.1.
3.2.2 SPECIFICATIONS ARTIFACTS
The modeling of the semantic model specified in this document was done in accordance to the "semantic-driven workflow" to create a submodel template specification [SMT].
This aspect modelAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). is written in SAMM 2.0.0 as a modeling language conformant to [CX-0003] as input for the semantic driven workflow.
Like all Catena-X data models, this model is available in a machine-readable format on GitHub conformant to [CX-0003].
3.2.3 LICENSE
This Catena-X data model is made available under the terms of the Creative Commons Attribution 4.0 International (CC-BY-4.0) license, which is available at Creative Commons.
3.2.4 IDENTIFIER OF SEMANTIC MODEL
The semantic model has the unique identifier
urn:samm:io.catenax.item_stock:2.0.0
This identifier MUST be used by the data provider to define the semantics of the data being transferred.
3.2.5 FORMATS OF SEMANTIC MODEL
3.2.5.1 RDF TURTLE
The RDF turtle file, an instance of the Semantic Aspect Meta Model, is the master for generating additional file formats and serializations. It can be found under the following link:
The open source command line tool of the Eclipse Semantic Modeling Framework is used for generation of other file formats like for example a JSON Schema, aasx for Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin. Submodel Template or a HTML documentation.
3.2.5.2 JSON SCHEMA
A JSON Schema can be generated from the RDF Turtle file. The JSON Schema defines the Value-Only payload of the Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin. for the APIAPI An API is a way for two or more computer programs to communicate with each other. operation "GetSubmodel".
3.2.5.3 AASX
An AASX file can be generated from the RDF Turtle file. The AASX file defines one of the requested artifacts for a Submodel Template Specification conformant to [SMT].
3.2.6 EXAMPLE DATA
Example JSON payload: Submodel "ItemStock" v2.0.0
{
"materialGlobalAssetId" : "urn:uuid:48878d48-6f1d-47f5-8ded-a441d0d879df",
"positions" : [ {
"orderPositionReference" : {
"supplierOrderId" : "M-Nbr-4711",
"customerOrderId" : "C-Nbr-4711",
"customerOrderPositionId" : "PositionId-01"
},
"allocatedStocks" : [ {
"isBlocked" : false,
"stockLocationBPNA" : "BPNA1234567890ZZ",
"lastUpdatedOnDateTime" : "2023-04-28T14:23:00.123456+14:00",
"quantityOnAllocatedStock" : {
"value" : 20.0,
"unit" : "unit:piece"
},
"stockLocationBPNS" : "BPNS1234567890ZZ"
} ]
} ],
"direction" : "INBOUND"
}
3.3 ASPECT MODELAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). "PLANNED PRODUCTION OUTPUT"
3.3.1 INTRODUCTION
The Planned Production Output defines the set of quantities of a material that will be produced for a customerCustomer In the context of OSim, the receiver of produced goods from a supplier. until a given point in time. For the complete semantics and detailed description of its properties refer to the SAMM model in Chapter 3.3.5.1.
3.3.2 SPECIFICATIONS ARTIFACTS
The modeling of the semantic model specified in this document was done in accordance to the "semantic-driven workflow" to create a submodel template specification [SMT].
This aspect modelAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). is written in SAMM 2.1.0 as a modeling language conformant to [CX-0003] as input for the semantic-driven workflow.
Like all Catena-X data models, this model is available in a machine-readable format on GitHub conformant to [CX-0003].
3.3.3 LICENSE
This Catena-X data model is made available under the terms of the Creative Commons Attribution 4.0 International (CC-BY-4.0) license, which is available at Creative Commons.
3.3.4 IDENTIFIER OF SEMANTIC MODEL
The semantic model has the unique identifier
urn:samm:io.catenax.planned_production_output:2.0.0
This identifier MUST be used by the data provider to define the semantics of the data being transferred.
3.3.5 FORMATS OF SEMANTIC MODEL
3.3.5.1 RDF TURTLE
The RDF turtle file, an instance of the Semantic Aspect Meta Model, is the master for generating additional file formats and serializations. It can be found under the following link:
The open source command line tool of the Eclipse Semantic Modeling Framework is used for generation of other file formats, such as a JSON Schema, AASX for Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin. Submodel Template or a HTML documentation.
3.3.5.2 JSON SCHEMA
A JSON Schema can be generated from the RDF Turtle file. The JSON Schema defines the Value-Only payload of the Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin. for the APIAPI An API is a way for two or more computer programs to communicate with each other. operation "GetSubmodel".
3.3.5.3 AASX
An AASX file can be generated from the RDF Turtle file. The AASX file defines one of the requested artifacts for a Submodel Template Specification conformant to [SMT].
3.3.6 EXAMPLE DATA
Example JSON payload: Submodel "PlannedProductionOutput" v2.0.0
{
"materialGlobalAssetId":"urn:uuid:48878d48-6f1d-47f5-8ded-a441d0d879df",
"positions":[
{
"lastUpdatedOnDateTime":"2023-04-01T14:23:00+01:00",
"orderPositionReference": {
"supplierOrderId":"M-Nbr-4711",
"customerOrderId":"C-Nbr-4711",
"customerOrderPositionId":"PositionId-01"
},
"allocatedPlannedProductionOutputs":[
{
"plannedProductionQuantity":{
"value": 10,
"unit":"unit:piece"
},
"productionSiteBpns":"BPNS0123456789ZZ",
"estimatedTimeOfCompletion":"2023-04-01T14:23:00+01:00"
},
{
"plannedProductionQuantity":{
"value":20,
"unit":"unit:piece"
},
"productionSiteBpns":"BPNS0123456789YZ",
"estimatedTimeOfCompletion":"2023-04-02T14:23:00+01:00"
},
{
"plannedProductionQuantity":{
"value": 10,
"unit":"unit:piece"
},
"productionSiteBpns":"BPNS0123456789ZZ",
"estimatedTimeOfCompletion":"2023-04-03T14:23:00+01:00"
}
]
}
]
}
3.4 ASPECT MODELAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). "DELIVERY INFORMATION"
3.4.1 INTRODUCTION
The Delivery Information semantic model defines the data and details regarding when and how products or goods are scheduled to be delivered and are actually delivered from supplierSupplier In the context of OSim, the producer of goods. site to customerCustomer In the context of OSim, the receiver of produced goods from a supplier. site. It includes information about order positions, material numbers and deliveries (quantity, status of the delivery and location of the delivery). It may include tracking number and incoterms as well. For the complete semantics and detailed description of its properties refer to the SAMM model in Chapter 3.4.5.1.
3.4.2 SPECIFICATIONS ARTIFACTS
The modeling of the semantic model specified in this document was done in accordance to the "semantic driven workflow" to create a submodel template specification [SMT].
This aspect modelAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). is written in SAMM 2.1.0 as a modeling language conformant to [CX-0003] as input for the semantic-driven workflow.
Like all Catena-X data models, this model is available in a machine-readable format on GitHub conformant to [CX-0003].
3.4.3 LICENSE
This Catena-X data model is made available under the terms of the Creative Commons Attribution 4.0 International (CC-BY-4.0) license, which is available at Creative Commons.
3.4.4 IDENTIFIER OF SEMANTIC MODEL
The semantic model has the unique identifier
urn:samm:io.catenax.delivery_information:2.0.0
This identifier MUST be used by the data provider to define the semantics of the data being transferred.
3.4.5 FORMATS OF SEMANTIC MODEL
3.4.5.1 RDF TURTLE
The RDF turtle file, an instance of the Semantic Aspect Meta Model, is the master for generating additional file formats and serializations. It can be found under the following link:
The open source command line tool of the Eclipse Semantic Modeling Framework is used for generation of other file formats, such as a JSON Schema, AASX for Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin. Submodel Template or a HTML documentation.
3.4.5.2 JSON SCHEMA
A JSON Schema can be generated from the RDF Turtle file. The JSON Schema defines the Value-Only payload of the Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin. for the APIAPI An API is a way for two or more computer programs to communicate with each other. operation "GetSubmodel".
3.4.5.3 AASX
An AASX file can be generated from the RDF Turtle file. The AASX file defines one of the requested artifacts for a Submodel Template Specification conformant to [SMT].
3.4.6 EXAMPLE DATA
Example JSON payloads: Submodel "DeliveryInformation" v2.0.0
1. The order has not yet departed from its origin, as indicated by the estimated values for both departure and arrival. This is an example of estimated delivery.
{
"materialGlobalAssetId" : "urn:uuid:48878d48-6f1d-47f5-8ded-a441d0d879df",
"positions" : [ {
"orderPositionReference" : {
"supplierOrderId" : "M-Nbr-4711",
"customerOrderId" : "C-Nbr-4711",
"customerOrderPositionId" : "PositionId-01"
},
"deliveries" : [ {
"lastUpdatedOnDateTime" : "2023-04-28T14:23:00.123456+14:00",
"deliveryQuantity" : {
"value" : 20.0,
"unit" : "unit:piece"
},
"transitEvents" : [ {
"dateTimeOfEvent": "2023-04-01T14:23:00+01:00",
"eventType": "estimated-departure"
},
{
"dateTimeOfEvent": "2023-04-05T14:23:00+01:00",
"eventType": "estimated-arrival"
} ],
"trackingNumber" : "1Z9829WDE02128",
"incoterm" : "EXW",
"transitLocations" : {
"destination" : {
"bpnsProperty" : "BPNS0123456789ZZ",
"bpnaProperty" : "BPNA0123456789ZZ"
},
"origin" : {
"bpnsProperty" : "BPNS0987654321YY",
"bpnaProperty" : "BPNA0987654321YY"
}
}
} ]
} ]
}
2. The status of this delivery is currently in transit, denoted by the actual departure and estimated arrival values.
{
"materialGlobalAssetId" : "urn:uuid:48878d48-6f1d-47f5-8ded-a441d0d879df",
"positions" : [ {
"orderPositionReference" : {
"supplierOrderId" : "M-Nbr-4711",
"customerOrderId" : "C-Nbr-4711",
"customerOrderPositionId" : "PositionId-01"
},
"deliveries" : [ {
"lastUpdatedOnDateTime" : "2023-04-28T14:23:00.123456+14:00",
"deliveryQuantity" : {
"value" : 20.0,
"unit" : "unit:piece"
},
"transitEvents" : [ {
"dateTimeOfEvent": "2023-04-01T14:23:00+01:00",
"eventType": "actual-departure"
},
{
"dateTimeOfEvent": "2023-04-05T14:23:00+01:00",
"eventType": "estimated-arrival"
} ],
"trackingNumber" : "1Z9829WDE02128",
"incoterm" : "EXW",
"transitLocations" : {
"destination" : {
"bpnsProperty" : "BPNS0123456789ZZ",
"bpnaProperty" : "BPNA0123456789ZZ"
},
"origin" : {
"bpnsProperty" : "BPNS0123456789ZZ",
"bpnaProperty" : "BPNA0123456789ZZ"
}
}
} ]
} ]
}
3. As seen from the actual departure and actual arrival values, this is an example of a completed delivery.
{
"materialGlobalAssetId" : "urn:uuid:48878d48-6f1d-47f5-8ded-a441d0d879df",
"positions" : [ {
"orderPositionReference" : {
"supplierOrderId" : "M-Nbr-4711",
"customerOrderId" : "C-Nbr-4711",
"customerOrderPositionId" : "PositionId-01"
},
"deliveries" : [ {
"lastUpdatedOnDateTime" : "2023-04-28T14:23:00.123456+14:00",
"deliveryQuantity" : {
"value" : 20.0,
"unit" : "unit:piece"
},
"transitEvents" : [ {
"dateTimeOfEvent": "2023-04-01T14:23:00+01:00",
"eventType": "actual-departure"
},
{
"dateTimeOfEvent": "2023-04-05T14:23:00+01:00",
"eventType": "actual-arrival"
} ],
"trackingNumber" : "1Z9829WDE02128",
"incoterm" : "EXW",
"transitLocations" : {
"destination" : {
"bpnsProperty" : "BPNS0123456789ZZ",
"bpnaProperty" : "BPNA0123456789ZZ"
},
"origin" : {
"bpnsProperty" : "BPNS0123456789ZZ",
"bpnaProperty" : "BPNA0123456789ZZ"
}
}
} ]
} ]
}
3.5 "DAYS OF SUPPLY" ASPECT MODELAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing).
3.5.1 INTRODUCTION
This section describes the Days Of Supply semantic model used in the Catena-X network. For the complete semantics and detailed description of its properties refer to the SAMM model in Chapter 3.5.5.1.
3.5.2 SPECIFICATIONS ARTIFACTS
The modeling of the semantic model specified in this document was done in accordance to the "semantic-driven workflow" to create a submodel template specification [SMT].
This aspect modelAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). is written in SAMM 2.1.0 as a modeling language conformant to [CX-0003] as input for the semantic driven workflow.
Like all Catena-X data models, this model is available in a machine-readable format on GitHub conformant to [CX-0003].
3.5.3 LICENSE
This Catena-X data model is made available under the terms of the Creative Commons Attribution 4.0 International (CC-BY-4.0) license, which is available at Creative Commons.
3.5.4 IDENTIFIER OF SEMANTIC MODEL
The semantic model has the unique identifier
urn:samm:io.catenax.days_of_supply:2.0.0
This identifier MUST be used by the data provider to define the semantics of the data being transferred.
3.5.5 FORMATS OF SEMANTIC MODEL
3.5.5.1 RDF TURTLE
The RDF turtle file, an instance of the Semantic Aspect Meta Model, is the master for generating additional file formats and serializations. It can be found under the following link:
The open source command line tool of the Eclipse Semantic Modeling Framework is used for generation of other file formats, such as a JSON Schema, AASX for Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin. Submodel Template or a HTML documentation.
3.5.5.2 JSON SCHEMA
A JSON Schema can be generated from the RDF Turtle file. The JSON Schema defines the Value-Only payload of the Asset Administration ShellAsset Administration Shell The AAS is a digital representation of an asset; it is a form of a digital twin. for the APIAPI An API is a way for two or more computer programs to communicate with each other. operation "GetSubmodel".
3.5.5.3 AASX
An AASX file can be generated from the RDF Turtle file. The AASX file defines one of the requested artifacts for a Submodel Template Specification conformant to [SMT].
3.5.6 EXAMPLE DATA
Example JSON payload: Submodel "DaysOfSupply" v2.0.0
The following JSONs provide an example of the value-only serialization of the "Days Of Supply" aspect modelAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). for Days of Supply for one (see example one) and multiple Days of Supply (see example two).
Example 1: Value-only JSON serialization of the with present day values of days of supply - "DoS for one day only".
{
"materialGlobalAssetId": "urn:uuid:48878d48-6f1d-47f5-8ded-a441d0d879df",
"allocatedDaysOfSupply": [
{
"stockLocationBPNA": "BPNA1234567890ZZ",
"lastUpdatedOnDateTime": "2023-04-28T14:23:00.123456+14:00",
"amountOfAllocatedDaysOfSupply": [
{
"date": "2024-01-01T14:23:00+01:00",
"daysOfSupply": 3.51
}
],
"stockLocationBPNS": "BPNS1234567890ZZ"
}
],
"direction": "INBOUND"
}
Example 2: Value-only JSON serialization of the with present day and two additional consecutive dates paired with days of supply values - "DoS for multiple days".
{
"materialGlobalAssetId": "urn:uuid:48878d48-6f1d-47f5-8ded-a441d0d879df",
"allocatedDaysOfSupply": [
{
"stockLocationBPNA": "BPNA1234567890ZZ",
"lastUpdatedOnDateTime": "2023-04-28T14:23:00.123456+14:00",
"amountOfAllocatedDaysOfSupply": [
{
"date": "2024-02-01T14:23:00+01:00",
"daysOfSupply": 3.51
},
{
"date": "2024-02-02T14:23:00+01:00",
"daysOfSupply": 4.25
},
{
"date": "2024-02-03T14:23:00+01:00",
"daysOfSupply": 2.78
}
],
"stockLocationBPNS": "BPNS1234567890ZZ"
}
],
"direction": "INBOUND"
}
4 APPLICATION PROGRAMMING INTERFACES
This section is normative
All APIsAPI An API is a way for two or more computer programs to communicate with each other. required are already covered by dependency standards, namely
- [CX-0002] APIsAPI An API is a way for two or more computer programs to communicate with each other. MUST be implemented by data providers and data consumers.
- [CX-0126] APIsAPI An API is a way for two or more computer programs to communicate with each other. MAY be implemented by data providers and data consumers to ease setting up digital twins.
- [CX-0146] APIsAPI An API is a way for two or more computer programs to communicate with each other. MAY be implemented by data providers and data consumers to better embed the business capabilities into processes in practice.
Configure the provided catalog datasets following the definitions of these standards and consider the section 2 for additional requirements with regard to provisioning including policy usage.
5 PROCESSES
This section is normative
5.1. DELIVERY INFORMATION EXCHANGE
5.1.1 DELIVERY INFORMATION PROCESS
The aim of the Catena-X standard is to enable as much transparency between business partners as possible, provided that the exchange complies with German or EU competition law. The user must be aware that competitively sensitive information from one supplierSupplier In the context of OSim, the producer of goods. or customerCustomer In the context of OSim, the receiver of produced goods from a supplier. must not be shared with others. This means that Delivery Information related to other customersCustomer In the context of OSim, the receiver of produced goods from a supplier. or suppliersSupplier In the context of OSim, the producer of goods. must not be disclosed under any circumstances. The exchange of information must always be direct and unidirectional.
The responsibility for the transport may vary depending on the contractual agreements. This responsibility is defined by the INCOTERM. These are official standards provided by the International Chamber of Commerce (ICC). At the time of writing this standard there are 11 different INCOTERMS.
| Code | Short description | Definition | Place to be specified |
|---|---|---|---|
| EXW | EXWorks | The supplierSupplier In the context of OSim, the producer of goods. makes the goods available at their premises, or at another named place. This term places the maximum obligations on the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. and minimum obligations on the supplierSupplier In the context of OSim, the producer of goods.. | At the factory site or any other place |
| FCA | Free CArrier | The supplierSupplier In the context of OSim, the producer of goods. delivers the goods, cleared for export, at a named place (possibly including the supplierSupplier In the context of OSim, the producer of goods.'s own premises). The goods can be delivered to a carrier nominated by the customerCustomer In the context of OSim, the receiver of produced goods from a supplier., or to another party nominated by the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.. | Location of the supplierSupplier In the context of OSim, the producer of goods. or location of the carrier |
| FAS | Free Alongside Ship | The supplierSupplier In the context of OSim, the producer of goods. delivers when the goods are placed alongside the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s vessel at the named port of shipment. This means that the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. has to bear all costs and risks of loss of or damage to the goods from that moment. | Agreed loading port (suitable only for ship loading) |
| FOB | Free On Board | The supplierSupplier In the context of OSim, the producer of goods. bears all costs and risks up to the point the goods are loaded on board the vessel. The supplierSupplier In the context of OSim, the producer of goods.'s responsibility does not end at that point unless the goods are "appropriated to the contract" that is, they are "clearly set aside or otherwise identified as the contract goods". | Agreed loading port (suitable only for ship loading) |
| CFR | Cost And FReight | The supplierSupplier In the context of OSim, the producer of goods. pays for the carriage of the goods up to the named port of destination. Risk transfers to customerCustomer In the context of OSim, the receiver of produced goods from a supplier. when the goods have been loaded on board the ship in the country of Export. | Agreed port of destination (suitable only for loading ships) |
| CIF | Cost Insurance Freight | The supplierSupplier In the context of OSim, the producer of goods. is responsible for covering the cost, freight, and minimum insurance to transport goods to the named port of destination, with risk transferring to the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. once the goods are loaded onto the shipping vessel. The supplierSupplier In the context of OSim, the producer of goods. handles export customs clearance, but the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. is responsible for import customs clearance, unloading, and any further transportation. | Agreed port of destination (suitable only for loading ships) |
| DAP | Delivered At Place | The supplierSupplier In the context of OSim, the producer of goods. delivers when the goods are placed at the disposal of the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. on the arriving means of transport ready for unloading at the named place of destination. The risk passes from supplierSupplier In the context of OSim, the producer of goods. to customerCustomer In the context of OSim, the receiver of produced goods from a supplier. from the point of destination mentioned in the contract of delivery. | Agreed delivery and destination location (usually destination terminal or customerCustomer In the context of OSim, the receiver of produced goods from a supplier.´s location) |
| DPU | Delivered at Place Unloaded | The supplierSupplier In the context of OSim, the producer of goods. delivers the goods, unloaded, at the named place of destination. The supplierSupplier In the context of OSim, the producer of goods. covers all the costs of transport (export fees, carriage, unloading from main carrier at destination port and destination port charges) and assumes all risk until arrival at the destination port or terminal. | Agreed delivery and destination location (usually destination terminal or customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s location) |
| CPT | Carriage Paid To | The supplierSupplier In the context of OSim, the producer of goods. pays for the carriage of the goods up to the named place of destination. However, the goods are considered to be delivered when the goods have been handed over to the first or main carrier, so that the risk transfers to customerCustomer In the context of OSim, the receiver of produced goods from a supplier. upon handing goods over to that carrier at the place of shipment in the country of Export. | Agreed destination (usually destination terminal or customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s location) |
| CIP | Carriage Insurance Paid | The supplierSupplier In the context of OSim, the producer of goods. is responsible for transporting the goods to a named place and providing insurance for the goods during transit. The risk transfers to the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. once the goods are handed over to the first carrier, but the supplierSupplier In the context of OSim, the producer of goods. must pay transport and insurance costs to the specified destination. This term is suitable for all modes of transport, including containerized and multimodal shipments | Agreed destination (usually destination terminal or customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s location). |
| DDP | Delivered Duty Paid | The supplierSupplier In the context of OSim, the producer of goods. is responsible for delivering the goods to the named place in the country of the customerCustomer In the context of OSim, the receiver of produced goods from a supplier., and pays all costs in bringing the goods to the destination including import duties and taxes. The supplierSupplier In the context of OSim, the producer of goods. is not responsible for unloading. | Agreed delivery and destination location (usually destination terminal or customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s location) |
Table 7: International Trade Administration. Incoterms 2020 (httpsHTTP HTTP is an application-layer protocol for transmitting hypermedia documents (such as HTML). It was designed for communication between web browsers and web servers, but can also be used for other purposes.://www.trade.gov/know-your-incoterms)
The INCOTERMS allow three possible scenarios regarding Delivery Information responsibility:
| Scenario | CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. responsibility | SupplierSupplier In the context of OSim, the producer of goods. responsibility |
|---|---|---|
| 1 | Entire delivery (departure and arrival e.g., INCOTERM EXW) | None |
| 2 | None | Entire delivery (departure and arrival e.g., INCOTERM DDP) |
| 3 | Partial delivery: arrival (e.g., INCOTERM FAS) | Partial delivery: departure (e.g., INCOTERM FAS) |
Table 8: Scenario overview transport responsibilities
The following table provides an overview of the responsibilities per INCOTERM:
| INCOTERM | Responsible for Departure | Responsible for Arrival | Risk Transfer Point |
|---|---|---|---|
| EX WORKS (EXW) | CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | SupplierSupplier In the context of OSim, the producer of goods.'s door |
| FREE CARRIER (FCA) | SupplierSupplier In the context of OSim, the producer of goods. | CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | Named place at port of loading |
| FREE ALONGSIDE SHIP (FAS) | SupplierSupplier In the context of OSim, the producer of goods. | CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | Named placed at port of loading |
| FREE ON BOARD (FOB) | SupplierSupplier In the context of OSim, the producer of goods. | CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | Boarded onto vessel at named port of loading |
| COST AND FREIGHT (CFR) | SupplierSupplier In the context of OSim, the producer of goods. | CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | Arrived at named port of unloading (still boarded) |
| COST, INSURANCE AND FREIGHT (CIF) | SupplierSupplier In the context of OSim, the producer of goods. | CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | Arrived at named port of unloading (still boarded) |
| CARRIAGE PAID TO (CPT) | SupplierSupplier In the context of OSim, the producer of goods. | CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | Handover to carrier at port of unloading |
| CARRIAGE AND INSURANCE PAID TO (CIP) | SupplierSupplier In the context of OSim, the producer of goods. | CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | Handover to carrier at port of unloading |
| DELIVERED AT PLACE UNLOADED (DPU) | SupplierSupplier In the context of OSim, the producer of goods. | CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | Unloaded at named place of customerCustomer In the context of OSim, the receiver of produced goods from a supplier. |
| DELIVERED AT PLACE (DAP) | SupplierSupplier In the context of OSim, the producer of goods. | SupplierSupplier In the context of OSim, the producer of goods. | Available to unloaded at named place of customerCustomer In the context of OSim, the receiver of produced goods from a supplier. |
| DELIVERED DUTY PAID (DDP) | SupplierSupplier In the context of OSim, the producer of goods. | SupplierSupplier In the context of OSim, the producer of goods. | Available to unloaded at named place of customerCustomer In the context of OSim, the receiver of produced goods from a supplier. |
Table 9: Summary of the INCOTERMs with their respective transport responsiblity excluding customs.
More details on each scenario are provided in the following sections.
5.1.1.1 CUSTOMERCustomer In the context of OSim, the receiver of produced goods from a supplier. IS RESPONSIBLE FOR THE WHOLE DELIVERY (E.G. INCOTERM EXW)
5.1.1.1.1 ACTORS AND ROLES
The following actors and roles occur in the described process.
| Actors | Role | Description |
|---|---|---|
| CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. submits an order. They are responsible for organizing the transportation of these parts from the origin to its destination. The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. acts as a data provider, because he is responsible for the transport. | The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. provides critical Delivery Information to the supplierSupplier In the context of OSim, the producer of goods., including estimated pick-up and arrival times, to ensure coordinated preparation and efficient handling of the ordered parts at both ends. |
| SupplierSupplier In the context of OSim, the producer of goods. | The supplierSupplier In the context of OSim, the producer of goods. manufactures parts and makes them available at their origin. The supplierSupplier In the context of OSim, the producer of goods. acts as a data consumer, because the consumer is responsible for the transport. | The supplierSupplier In the context of OSim, the producer of goods. provides necessary information to the customerCustomer In the context of OSim, the receiver of produced goods from a supplier., including details about the availability and readiness of the parts for pick-up, contributing to an effective coordination of the transportation process. |
Table 10: Actors and roles scenario 1
5.1.1.1.2 PROCESS PRESENTATION
In this scenario, the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. is responsible for organizing the pick-up of items from the supplierSupplier In the context of OSim, the producer of goods.'s location (origin) and their transportation to the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s location. For transparency, the supplierSupplier In the context of OSim, the producer of goods. requests Delivery Information from the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.. The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. responds with both the departure times and quantities, ensuring the supplierSupplier In the context of OSim, the producer of goods. knows when to have the items ready for pick up. Additionally, the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. informs the supplierSupplier In the context of OSim, the producer of goods. of the items' estimated arrival times at the destination facility.
| Delivery information | -1 | Today | +1 | +2 | +3 |
|---|---|---|---|---|---|
| Departure | 100 | 500 | 300 | 200 | 500 |
| Arrival | 800 | 100 | 500 | 0 | 300 |
Table 11: Delivery Information example scenario 1
Since the semantic model applies to different scenarios, the mandatory nature of eventTypes cannot be fully addressed in the model. Data MUST be provided according to the following restrictions:
- The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. must provide the departure information and must provide arrival information to give a benefit back to the supplierSupplier In the context of OSim, the producer of goods..
- If there is no confirmed date and time, the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. can use a default estimation for the arrival information (e.g. departure date + 3 days).
There must be a departure information because the supplierSupplier In the context of OSim, the producer of goods. needs to know when the goods will be picked up.
There must be arrival information to give the supplierSupplier In the context of OSim, the producer of goods. more transparency.
5.1.1.2 SUPPLIERSupplier In the context of OSim, the producer of goods. IS RESPONSIBLE FOR THE WHOLE DELIVERY (E.G. INCOTERM DDP)
5.1.1.2.1 ACTORS AND ROLES
| Actors | Role | Description |
|---|---|---|
| CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. submits an order. The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. acts as a data consumer, because the supplierSupplier In the context of OSim, the producer of goods. is responsible for the transport. | The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. submits an order at the supplierSupplier In the context of OSim, the producer of goods. (quantity, location, preferred date). |
| SupplierSupplier In the context of OSim, the producer of goods. | The supplierSupplier In the context of OSim, the producer of goods. manufactures parts and makes them available. They are responsible for organizing the transportation of these parts from the origin to the destination. The supplierSupplier In the context of OSim, the producer of goods. acts as data provider, because he is responsible for the transport. | The supplierSupplier In the context of OSim, the producer of goods. coordinates all aspects of the delivery process, including selecting transportation methods, scheduling shipments, and providing the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. with regular updates on the delivery status and estimated arrival times. |
Table 12: Actors and roles scenario 2
5.1.1.2.2 PROCESS REPRESENTATION
In this case, the supplierSupplier In the context of OSim, the producer of goods. takes on the responsibility of organizing the entire delivery process from their facilities (origin) to the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s destination. This includes arranging for the transportation of the items and ensuring they reach the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s facility. The supplierSupplier In the context of OSim, the producer of goods. must also maintain transparency throughout the process. They inform the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. of the departure times and quantities, ensuring the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. is aware of when to expect the delivery. Furthermore, the supplierSupplier In the context of OSim, the producer of goods. provides updates on the delivery progress, including the estimated arrival times at the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s facility, thus keeping the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. informed at every stage of the delivery process.
Transport information is only provided to the customerCustomer In the context of OSim, the receiver of produced goods from a supplier..
| Delivery information | -1 | Today | +1 | +2 | +3 |
|---|---|---|---|---|---|
| Departure | 200 | 400 | 300 | 200 | 500 |
| Arrival | 600 | 300 | 500 | 10 | 300 |
Table 13: Delivery Information example scenario 2
As the semantic model applies to different scenarios, the mandatoryness of eventTypes can not be fully handled in the model. Data MUST be provided according to the following restrictions:
- The supplierSupplier In the context of OSim, the producer of goods. must provide the estimated arrival information and must provide the departure information.
- If there is no confirmed date and time, the supplierSupplier In the context of OSim, the producer of goods. can use a default estimation for the arrival information (e.g. departure date + 3 days).
There must be an arrival information because the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. needs to know when the goods will be available in the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s factory. There must be departure information, to give the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. more transparency.
5.1.1.3 RESPONSIBILITY FOR THE DELIVERY IS SPLIT BETWEEN SUPPLIERSupplier In the context of OSim, the producer of goods. AND CUSTOMERCustomer In the context of OSim, the receiver of produced goods from a supplier. (E.G. INCOTERM FAS)
5.1.1.3.1 ACTORS AND ROLES
| Actors | Role | Description |
|---|---|---|
| CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. submits an order. The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. is responsible for one half of the delivery. The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. acts as a data provider, because he is responsible for one half of the transport, and as a data consumer, because the supplierSupplier In the context of OSim, the producer of goods. is responsible for the other half of the transport. | The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. coordinates and manages one part of the delivery process, which includes arranging transportation for the latter half of the journey, ensuring the parts are received from the midpoint, and providing necessary information to the supplierSupplier In the context of OSim, the producer of goods.. |
| SupplierSupplier In the context of OSim, the producer of goods. | The supplierSupplier In the context of OSim, the producer of goods. manufactures parts and makes them available. The supplierSupplier In the context of OSim, the producer of goods. is responsible for one half of the delivery. The supplierSupplier In the context of OSim, the producer of goods. acts as a data provider, because he is responsible for one half of the transport, and as a data consumer, because the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. is responsible for the other half of the transport. | The supplierSupplier In the context of OSim, the producer of goods. handles the initial part of the delivery process, including transporting the parts to a designated midpoint. |
Table 14: Actors and roles scenario 3
5.1.1.3.2 PROCESS PRESENTATION
In this case the supplierSupplier In the context of OSim, the producer of goods. is responsible for only one part of the transport (e.g. from departure from its factory (origin) until a middle point) and the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. takes over the responsibility for the restREST An architectural style for designing networked applications. of the transport (e.g. from middle point to its factory (destination)). In this case both customerCustomer In the context of OSim, the receiver of produced goods from a supplier. and supplierSupplier In the context of OSim, the producer of goods. can request Delivery Information of the other party.
Example:
SupplierSupplier In the context of OSim, the producer of goods. A is in charge of the initial part of the transport, handling the pick-up and delivery of items from its location to a designated middle point. CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. A takes over the transport from the middle point, needs specific details about this first leg of the journey. Therefore, CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. A requests critical Delivery Information from SupplierSupplier In the context of OSim, the producer of goods. A, such as departure time, pick-up location, and the quantity of items.
| Delivery information | -1 | Today | +1 | +2 | +3 |
|---|---|---|---|---|---|
| Departure | 100 | 500 | 300 | 200 | 500 |
Table 15: Delivery Information example scenario 3
CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. A assumes responsibility for the transport of goods from a predetermined middle point to its destination. Therefore, to gain transparency, SupplierSupplier In the context of OSim, the producer of goods. A requests Delivery Information from CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. A, such as the estimated arrival times, final destination (e.g. CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. A's factory), and the quantity of goods to be shipped.
| Delivery information | -1 | Today | +1 | +2 | +3 |
|---|---|---|---|---|---|
| Arrival | 800 | 100 | 500 | 0 | 300 |
Table 16: Delivery Information example scenario 4
As the semantic model applies to different scenarios, the mandatoryness of eventTypes can not be fully handled in the model. Data MUST be provided according to the following restrictions:
- The supplierSupplier In the context of OSim, the producer of goods. must provide the departure information.
- The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. must provide the arrival information.
There must be departure information, to give the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. more transparency.
There must be arrival information, to give the supplierSupplier In the context of OSim, the producer of goods. more transparency.
5.2. SHORT-TERM MATERIAL DEMAND EXCHANGE
The Short-Term Material Demand is intended to provide more details and insights about the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s demand. It is not meant to replace regular and legally binding orders or call-offs between partners but to offer supplementary information. Therefore, the Short-Term Material Demand aspect modelAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). provides several categories that may be used to differentiate between different types of demand. The categories originate from the joint use of the aspect modelAspect Model A formal, machine-readable semantic description (expressed with RDF/Turtle) of data accessible from an aspect. Note 1: An Aspect Model must adhere to the Semantic Aspect Meta Model (SAMM) and be compliant with its validity rules. Note 2: Aspect Models are logical data models that can be used to detail a conceptual model to describe the semantics of runtime data related to a concept; elements of an Aspect Model can/should refer to terms of a standardized Business Glossary (if existing). of the Demand and Capacity Standard [CX-0128] and may not necessarily apply. Categories should only be used if they are beneficial for at least one of the partners involved. If in doubt, "Default" should always be used.
The key purpose of the Short-Term Material Demand is to indicate the actual required quantities that are critical for the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s planned production. To do so, it is recommended to use the Categories "Default" or "Series". Quantities deviating from this, e.g. to build up stock or to optimize logistics, should be mapped to "Extraordinary Demand". All other categories should be selected and used after aligning with the respective partner to ensure a mutual understanding and intention of use.
The following chapter should contribute to the understanding by providing different process representations and examples.
5.2.1 ACTORS AND ROLES
The following actors and roles occur in the described processes.
| Actors | Role | Description |
|---|---|---|
| SupplierSupplier In the context of OSim, the producer of goods. | The supplierSupplier In the context of OSim, the producer of goods. acts as the data consumer in this standard. | Is a business partner that supplies items to a customerCustomer In the context of OSim, the receiver of produced goods from a supplier.. As such, a supplierSupplier In the context of OSim, the producer of goods. is interested in detailed information about the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s Short-Term Material Demand. |
| CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. acts as the data provider in this standard. | Is a business partner that procures items from suppliersSupplier In the context of OSim, the producer of goods. and provides information about his Short-Term Material Demand. |
Table 17: Actors and roles Short-Term Material Demand Exchange
5.2.2 PROCESS REPRESENTATIONS
5.2.2.1 SINGLE SOURCING USING A SINGLE CATEGORY
In this most basic example the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. procures materials from a single supplierSupplier In the context of OSim, the producer of goods. to fulfill its demands for a specific material. Also, the call-off or order quantities exactly match the quantities that are required for the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s production on a daily basis.
The following table visualizes the data which may be transferred as Short-Term Material Demand.
Table 18: Single sourcing with one demand category and daily ordering
Another scenario in this context might be that the delivery date stated in the call-off or order does not match the actual expected consumption date for the material.
Table 19: Single sourcing with one demand category and non-daily ordering
The additional information can be e.g. used to smooth out the supplierSupplier In the context of OSim, the producer of goods.'s production and to jointly agree between partners on a split of the total order quantity across different delivery days. The same applies for a shortage case where the supplierSupplier In the context of OSim, the producer of goods. is not able to deliver the ordered quantity on day 1.
5.2.2.2 SINGLE SOURCING USING MULTIPLE CATEGORIES
Additional information about the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s Short-Term Material Demand can be provided via categories. The following example shows a scenario where the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. is signaling that the ordered amount of material on day 2 is partially intended to build up safety stock and is not directly related to a planned consumption.
Table 20: Single sourcing with multiple demand categories to signal stock building
With this additional information the supplierSupplier In the context of OSim, the producer of goods. can distinguish which quantity is the absolute minimum required to fulfill the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s production needs and which is e.g., to build up a safety stock or to replenish stock. In the event of a production bottleneck, the supplierSupplier In the context of OSim, the producer of goods. can suggest stretching the delivery of the additional parts. The supplierSupplier In the context of OSim, the producer of goods. is also informed that this is not a regular increase in demand, which in turn can be used while communicating with its upstream suppliersSupplier In the context of OSim, the producer of goods. and may therefore contribute to reduce the bullwhip effect.
In the same manner, the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. can make use of the categories e.g., to indicate that a partial quantity is attributed to logistical optimizations. This might be e.g. due to fixed container sizes. The following example shows a scenario in which one container always carries a batch of 15 pieces.
Table 21: Single sourcing with multiple demand categories to distinguish quantities for logistical optimizations
5.2.2.3 MULTI-SOURCING WITH MULTIPLE CATEGORIES
A multi-sourcing strategy is a common approach in supply chain management to mitigate supply risks. This means that a customerCustomer In the context of OSim, the receiver of produced goods from a supplier. works with two or more suppliersSupplier In the context of OSim, the producer of goods. to procure equivalent materials. However, to use the "Short-Term Material Demand Exchange" standard, participants must comply with legal restrictions, such as competition laws. Furthermore, it is in the interestsREST An architectural style for designing networked applications. of the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. not to disclose any company secrets about existing business relationships and their extent with
third parties.
Therefore, in case of multi-sourcing, each participant needs to prevent potential prohibited or disadvantageous data leakage during the information provisioning. Any Short-Term Material Demand provided must be partner-specific. In case of multi-sourcing the demand data can be e.g., broken down based on the partner's proportion of the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s total demand volume. Using supplierSupplier In the context of OSim, the producer of goods.-specific material numbers may support the data provisioning system-wise.
In the following example a customerCustomer In the context of OSim, the receiver of produced goods from a supplier. has two suppliersSupplier In the context of OSim, the producer of goods., that are sourced 60% and 40% respectively. Therefore demands need to be split according to the given quota. In addition to the demand directly derived from the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.'s material consumption, the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. orders additional material on Day 1 and Day 2 to build up a safety stock.
Table 22: Multi-sourcing with multiple demand categories to signal stock building
5.3. PLANNED PRODUCTION OUTPUT EXCHANGE
The processes described are intended to serve as guidance and recommendation for the use of the "Planned Production Output Exchange" standard in different scenarios. In the field a combination of several scenarios is common practice. This process description does not claim to be exhaustive, but rather is intended to support the involved parties in finding beneficial and legally acceptable solutions.
5.3.1 ACTORS AND ROLES
The following actors and roles occur in the described processes.
| Actors | Role | Description |
|---|---|---|
| CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. | The customerCustomer In the context of OSim, the receiver of produced goods from a supplier. acts as the data consumer in this standard. | A business partner that procures items from suppliersSupplier In the context of OSim, the producer of goods. and requests information about their planned production output. |
| SupplierSupplier In the context of OSim, the producer of goods. | The supplierSupplier In the context of OSim, the producer of goods. acts as the data provider in this standard. | A business partner that supplies items to customersCustomer In the context of OSim, the receiver of produced goods from a supplier.. As such, a supplierSupplier In the context of OSim, the producer of goods. is responsible for providing consistent and up-to-date Planned Production Output data. |
Table 23: Actors and Roles in Planned Production Output Exchange
5.3.2 PROCESS REPRESENTATIONS
5.3.2.1 SINGLE CUSTOMERCustomer In the context of OSim, the receiver of produced goods from a supplier. SCENARIO
The most straightforward process is described as a relationship between one supplierSupplier In the context of OSim, the producer of goods. and one customerCustomer In the context of OSim, the receiver of produced goods from a supplier. where an item is specifically planned and produced for the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.. There are no third-party customersCustomer In the context of OSim, the receiver of produced goods from a supplier. that procure the same material from the supplierSupplier In the context of OSim, the producer of goods..
The production output is planned by the supplierSupplier In the context of OSim, the producer of goods. on a daily basis so that this data should be provided without further adaptions to the customerCustomer In the context of OSim, the receiver of produced goods from a supplier.. Also having multiple customersCustomer In the context of OSim, the receiver of produced goods from a supplier. may be handled as a single customerCustomer In the context of OSim, the receiver of produced goods from a supplier. scenario, if customerCustomer In the context of OSim, the receiver of produced goods from a supplier.-specific material numbers are used for the production planning in the internal systems of the supplierSupplier In the context of OSim, the producer of goods.. An example where the total Planned Production Output is allocated to a single customerCustomer In the context of OSim, the receiver of produced goods from a supplier. is shown in the table below:
| Day 1 | Day 2 | Day 3 | Sum | |
|---|---|---|---|---|
| Total Planned Production Output | 15 | 15 | 20 | 50 |
| Allocated to CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. A | 15 | 15 | 20 | 50 |
Table 24: Planned Production Output for a Single CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. Scenario
5.3.2.2 MULTIPLE CUSTOMERCustomer In the context of OSim, the receiver of produced goods from a supplier. SCENARIO
To have multiple customersCustomer In the context of OSim, the receiver of produced goods from a supplier. for a specific item as a supplierSupplier In the context of OSim, the producer of goods. is a scenario that requires a proper adjustment of the Planned Production Output data provided by the supplierSupplier In the context of OSim, the producer of goods.. The supplierSupplier In the context of OSim, the producer of goods. must not simply provide the total quantities of the Planned Production Output to both customersCustomer In the context of OSim, the receiver of produced goods from a supplier. since they are not specific. On the one hand, they are not helpful and, on the other hand, they cause a legal issue if they allow customersCustomer In the context of OSim, the receiver of produced goods from a supplier. to draw conclusions about each other. A simplified illustration of the situation where the total Planned Production Output is allocated to different customersCustomer In the context of OSim, the receiver of produced goods from a supplier. is shown in the table below:
| Day 1 | Day 2 | Day 3 | Sum | |
|---|---|---|---|---|
| Total Planned Production Output | 35 | 15 | 85 | 135 |
| Allocated to CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. A | 15 | 15 | 20 | 50 |
| Allocated to CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. B | 20 | 0 | 65 | 85 |
Table 25: Planned Production Output for a Multiple CustomerCustomer In the context of OSim, the receiver of produced goods from a supplier. Scenario
Since sharing data on a horizontal level is critical from a legal perspective, a supplierSupplier In the context of OSim, the producer of goods. must make sure that the data he provides to a customerCustomer In the context of OSim, the receiver of produced goods from a supplier. does not include information that allows conclusions about a competitor. This standard does not and cannot check data for being legally compliant on a semantic and technical level. Therefore, each user must make sure to comply with applicable laws when providing information. For the allocation of Planned Production Output data to a specific partner, it is recommended to evaluate the following proposals:
Derive from orders or call-offs that have been received:
- get orders or call-offs
- calculate quotations based on required amount per day / week
- apply quotation per day or production order
Derive from incoming Short-Term Material Demand [see Chapter 5.2]:
- request latest demand per customerCustomer In the context of OSim, the receiver of produced goods from a supplier. per site
- determine the required end-of-production date for each customerCustomer In the context of OSim, the receiver of produced goods from a supplier. and site
- calculate quotations based on the required amount per day / week
- apply quotations per day or production order
Potential drawbacks: heavyweight computation with external involvement
Derive from scheduled deliveries [see Chapter 5.1]:
- get the estimated time of departure (ETD) for the scheduled deliveries per customerCustomer In the context of OSim, the receiver of produced goods from a supplier. and site
- calculate quotations based on required amount per day
- apply quotation per day or production order
Potential drawbacks: scheduled deliveries might be derived from produced goods (wrong circularity)
5.3.2.3 NON-DAILY BASED PLANNED PRODUCTION OUTPUT
One possible scenario is that production planning is not done on a daily basis. The Planned Production Output is determined by a production order whose estimated date of completion does not necessarily match with the real completion date of the produced items. The example below shows a scenario where the complete production order of a supplierSupplier In the context of OSim, the producer of goods. equals to a total of 45 items planned to be finished on the third day. However, in reality, the production will already start on the first day and will only be finished on day three.
- In total, 45 items are planned as production output for the third day.
- The actual production starts on day one with an output of 15 items per day.
- The total planned quantity will be finished on day three.
| Day 1 | Day 2 | Day 3 | Sum | |
|---|---|---|---|---|
| Planned Production Output | 0 | 0 | 45 | 45 |
| Actual Production Output | 15 | 15 | 15 | 45 |
Table 26: Non-daily-based Planned Production Output Scenario
In this case, the accuracy of the planned production output data provided to the customerCustomer In the context of OSim, the receiver of produced goods from a supplier. is reduced. This loss of granularity and the weakening of the information base can be particularly disadvantageous in the event of a shortage. Hence it is recommended to plan the production output on a daily basis.
However, if this is not possible the data providing supplierSupplier In the context of OSim, the producer of goods. SHOULD consider working with partial completion confirmations for the already finished items that belong to a Planned Production Output. Confirming partially completed production orders lowers on the one hand the remaining planned production quantity and on the other hand increases the available and allocated Item Stock (see [Chapter 5.4]).
This enables the data-consuming customerCustomer In the context of OSim, the receiver of produced goods from a supplier. to be provided with a more accurate and up-to-date representation of the still remaining Planned Production Output quantities as well as with available stock data. In any case, the supplierSupplier In the context of OSim, the producer of goods. must ensure that the information is consistent and plausible.
5.4. ITEM STOCK EXCHANGE
5.4.1 GENERAL INFORMATION ON THE USE OF ITEM STOCK
A prerequisite to build up an Item Stock and allocate it to a specific customerCustomer In the context of OSim, the receiver of produced goods from a supplier. or supplierSupplier In the context of OSim, the producer of goods. is an existing order / call-off (build-to-order). This standard, must not be used in case of building stock without any allocation to a customerCustomer In the context of OSim, the receiver of produced goods from a supplier. or supplierSupplier In the context of OSim, the producer of goods. (build-to-stock).
In contrast to the Demand and Capacity Management standard [CX-0128], this information relates to short-term planning periods. Accordingly, neither long-term planning nor strategic planning is included in the scope. This means that only the current/actual Item Stock quantities are transmitted in this standard.
We distinguish between exactly two scenarios in multi sourcing. On the one hand, the exchange of information from supplierSupplier In the context of OSim, the producer of goods. to customerCustomer In the context of OSim, the receiver of produced goods from a supplier. and, on the other hand, from customerCustomer In the context of OSim, the receiver of produced goods from a supplier. to supplierSupplier In the context of OSim, the producer of goods.. In both scenarios, information must not be shared horizontally under any circumstances. This means that the Item Stock in relation to other customersCustomer In the context of OSim, the receiver of produced goods from a supplier. or suppliersSupplier In the context of OSim, the producer of goods. must not be shared.
The data exchange between the C-X participants refers to the direct business relationship among each other. In the case of consignation, the warehouse is specified via the real location - the customerCustomer In the context of OSim, the receiver of produced goods from a supplier./supplierSupplier In the context of OSim, the producer of goods. site. In this case the allocated stock is not considered as taken and according to our definition as not delivered (have not yet been shipped).