Product Master Data

The Master Data module serves as the foundational product model data repository. It defines the product passport fields that remain static across all instances of the same product, production line, or product family. These fields typically include attributes such as product type, specifications, bill of materials, and other core characteristics that do not change from one unit to another. By centralizing and standardizing this information, the Master Data module ensures consistency between all instances of the same line.

Datamodel

Field	Type	Description
id	String (UUID)	Internal Unique identifier
name	String	Name of the product master data
meta	Json	Additional metadata - Static DPP Page Display Data
ecosystem	Enum	Ecosystem type (e.g., SSI, CatenaX)
payload	Json	Initial DPP Data
organization	Organization	Linked organization
productPassports	ProductPassport[]	Linked product passports
createdAt	DateTime	Creation timestamp
updatedAt	DateTime	Last update timestamp

Create

To create a product master data, the following endpoint can be used:

Example request

POST {{baseUrl}}/core/master-data?organizationId={{organizationId}}
DATA
{
  "name": "<string - name of the product master data>",
  "meta": {
    "displayConfig": {
      "sections": [
        {
          "name": "<string - name of the section>",
          "display": "<string - display type of the section>"
        }
      ]
    }
  },
  "ecosystem": "<string - ecosystem type, e.g., SSI, CatenaX>",
  "payload": {
    "createWalletParams": {
            "profileId": "{{profile-id}}",
            "name": "ice-tea",
            "tags": [],
            "settings": {
                "displayConfig": {
                    "title": "ICE Tea",
                    "subtitle": "<string>",
                    "description": "<string>",
                    "slogan": "<string>",
                    "imageUrl": "<string>",
                    "logo": "<string>",
                    "primaryColor": "<string>",
                    "secondaryColor": "<string>"
                }
            }
        },
        "createDPPCredentialsParams": [
            {
                "templateId": "{{template-product-id}}",
                "data": {
                    "title": "Ice-T-shirt",
                    "size": {
                        "length": 90,
                        "width": 200
                    }   
                }
            }
        ]
  },
}

Right after creation, the can be used to create a product passport based on the product master data.