All Categories > GDST 2.0 > Modules > Core Module > Core Module Master Data

Core Module Master Data

Updated 2 hours ago by John Heggelund

The core modules defines the minimal KDE requirements for master data elements. All master data elements are based on the GS1 Web Vocabulary, with some extensions from the Core Business Vocabulary Master Data Attributes (cbvmda).

Locations

GS1 Web Vocabulary Type: gs1:Place

Location KDE Requirements

KDE	Description	Example Value
globalLocationNumber	A URN formatted GLN or GDST location identifier that uniquely identifies the location.	`urn:epc:id:gln:1234567890123`, `urn:gdst:example.org:location:loc:examplePrefix.0`
name	The name of the facility expressed as an array of rdf:langStrings	`{ "@language": "en-US", "@value": "321 Cannery Row" }`
address	A gs1:Address	`{ "@type": "gs1:PostalAddress", "streetAddress": [ { "@language": "en-US", "@value": "321 Cannery Row" } ], "addressLocality": [ { "@language": "en-US", "@value": "San Francisco" } ], "addressRegion": [ { "@language": "en-US", "@value": "CA" } ], "postalCode": "94111", "countryCode": "US" }`
geo	Either a gs1:GeoCoordinates gs1:GeoShape	`{ "@type":"gs1:GeoShape", "polygon":"37.7749 -122.4194 37.7749 -122.418 37.776 -122.418 37.776 -122.4194 37.7749 -122.4194" }` `{ "@type": "gs1:GeoCoordinates", "latitude": { "@value": 37.7749, "@type": "xsd:float" }, "longitude": { "@value": -122.4194, "@type": "xsd:float" } }`
locationClassification	A standardized classification assigned to a physical location that identifies the operational role or function of that location within a supply chain for the purpose of determining applicable traceability requirements.	`[ { "type": "gdst", "value": "land facility" } ]`

Locations are only required to provide EITHER an address, geoCoordinates, or a geofence. Only one method for identifying the physical location of the entity is required, not all three.

Location JSON Example

{
              "@context": {
                  "cbvmda": "urn:epcglobal:cbvmda:mda",
                  "xsd": "http://www.w3.org/2001/XMLSchema#",
                  "gs1": "http://gs1.org/voc/",
                  "@vocab": "http://gs1.org/voc/",
                  "gdst": "https://traceability-dialogue.org/vocab"
              },
              "gdst:locationClassification": [
                  {
                      "type": "gdst",
                      "value": "land facility"
                  }
              ],
              "@type": "gs1:Place",
              "globalLocationNumber": "urn:gdst:example.org:location:loc:solution.port",
              "name": [
                  {
                      "@language": "en-US",
                      "@value": "Port"
                  }
              ],
              "address": {
                  "@type": "gs1:PostalAddress",
                  "streetAddress": [
                      {
                          "@language": "en-US",
                          "@value": "123 Port St"
                      }
                  ],
                  "addressLocality": [
                      {
                          "@language": "en-US",
                          "@value": "San Francisco"
                      }
                  ],
                  "addressRegion": [
                      {
                          "@language": "en-US",
                          "@value": "CA"
                      }
                  ],
                  "postalCode": "94111",
                  "countryCode": "US"
              }
          }

Products

GS1 Web Vocabulary Type: gs1:Product

Product KDE Requirements

KDE	Description	Example Value
gtin	A GTIN or GDST product type identifier that uniquely identifies the product.	`urn:gdst:example.org:product:class:solution.wildfish`, `urn:epc:idpat:sgtin:08600031303.00`
productName	A consumer friendly short description of the product suitable for compact presentation, formatted as an rdf:langstring.	`{ "productName": [ { "@language": "en-US", "@value": "Wild Yellowfin Tuna" } ] }`
productClassification	A standardized classification assigned to a product that identifies the commodity, product category, or product type for the purpose of determining traceability requirements.	`{ "gdst:productClassification": [ { "type": "gdst", "value": "seafood" } ] }`

Product JSON Example

{
              "@context": {
                  "cbvmda": "urn:epcglobal:cbvmda:mda",
                  "xsd": "http://www.w3.org/2001/XMLSchema#",
                  "gs1": "http://gs1.org/voc/",
                  "@vocab": "http://gs1.org/voc/",
                  "gdst": "https://traceability-dialogue.org/vocab"
              },
              "gdst:productClassification": [
                  {
                      "type": "gdst",
                      "value": "seafood"
                  }
              ],
              "@type": "gs1:Product",
              "gtin": "urn:gdst:example.org:product:class:solution.wildfish",
              "productName": [
                  {
                      "@language": "en-US",
                      "@value": "Wild Yellowfin Tuna"
                  }
              ]
          }

Trading Party

GS1 Web Vocabulary Type: gs1:Organization

Trading Party KDE Requirements

KDE

Description

Example Value

globalLocationNumber

A PGLN or GDST trading party identifier that uniquely identifies the trading party.

urn:epc:id:sgln:08600031303.0.0, urn:gdst:example.org:party:example_prefix.0

organizationName

The name of the organization formatted as an rdf:langString

{
              "organizationName": [
                  {
                      "@language": "en-US",
                      "@value": "Fish Farm Co."
                  }
              ]
          }

Trading Party JSON Example

{
              "@context": {
                  "cbvmda": "urn:epcglobal:cbvmda:mda",
                  "xsd": "http://www.w3.org/2001/XMLSchema#",
                  "gs1": "http://gs1.org/voc/",
                  "@vocab": "http://gs1.org/voc/",
                  "gdst": "https://traceability-dialogue.org/vocab"
              },
              "@type": "gs1:Organization",
              "globalLocationNumber": "urn:gdst:example.org:party:solution.fishfarm",
              "cbvmda:informationProvider": "urn:gdst:example.org:party:solution.fishfarm",
              "organizationName": [
                  {
                      "@language": "en-US",
                      "@value": "Fish Farm Co."
                  }
              ]
          }

How did we do?

(opens in a new tab)