Seafood Module Commissioning Event

Commissiong events capture the creation of new traceable products within the supply chain. The seafood module extends the commissioning event with additional KDEs required for seafood products.

Event Profile

Seafood commissioning events are identified by the following event characteristics:

KDE

Value

type

ObjectEvent

action

ADD

bizStep

commissioning

disposition

active

Seafood commissioning events must have at least one product with a productClassification of seafood.

KDE Requirements

The following properties are required on the root of a seafood commissioning event.

KDE Description Example Value
eventID A URN formatted universally unique ID (UUID) urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
action The action says how an event relates to the lifecycle of the entity being described. ADD means the entity in question has been created or added to. OBSERVE means the entity in question has not been changed. DELETE means the entity in question has been removed from or destroyed altogether ADD, DELETE, OBSERVE
disposition The disposition field of an event specifies the business condition of the event's objects, subsequent to the event. The disposition is assumed to hold true until another event indicates a change of disposition. A full list of disposition values and their definitions is available in the EPCIS Core Business Vocabulary active
eventTime A string value formatted as an ISO datetime 2026-01-01T00:00:00.000Z
bizLocation Facility where the immature animals were harvested; validated as a GLN with related master data urn:epc:id:gln:1234567890123
informationProvider A URN formatted PGLN or GDST party identifier urn:epc:sgln:08600031303.0.0, urn:gdst:example.org:party:example_prefix.0
productOwner A URN formatted PGLN or GDST party identifier urn:epc:sgln:08600031303.0.0, urn:gdst:example.org:party:example_prefix.0
readPoint A readPoint object with an id property equal to a geo formatted coordinate pair geo:37.860236,-123.144697
humanWelfarePolicy Indicates whether a human welfare policy applies. Must be one of the allowed values (see below). none, 3P, internal policy

Instance Lot Master Data (ILMD) Requirements

The following KDEs are required on the ilmd property of a seafood commissioning event.

KDE Description Example Value
productionMethodForFishAndSeafoodCode Code for how the seafood was produced; must match a value from the GS1 code list ProductionMethodForFishAndSeafoodCode (version 15) MARINE_FISHERY, AQUACULTURE

Certificate Requirements

The following certificates are required in the certificationList of the ilmd property on a seafood commissioning event.

Certification description Certification type
Harvest certification urn:gdst:certType:harvestCert
Human welfare policy standards urn:gdst:certType:humanPolicy

Certificates are required to have the following properties

Certificate Property Description Example Value
certificationType A URN formatted string defining the type of certificte urn:gdst:certType:harvestCert
certificationAgency The name of the certificate program owner WHO
certificationStandard The name of the standard associated with the certificate WHO Human Decency Policy
certificationValue An additional descriptor of the certificate if there are different quality values for the certificate Quality class 4
certificationIdentification The ID of the certificate 0987654321

Full JSON Example

{
              "@context": [
                  "https://ref.gs1.org/standards/epcis/epcis-context.jsonld",
                  {
                      "gdst": "https://traceability-dialogue.org/epcis"
                  }
              ],
              "type": "ObjectEvent",
              "eventTime": "2026-04-19T01:58:39.4957023+00:00",
              "eventTimeZoneOffset": "+00:00",
              "eventID": "urn:uuid:a2cab12a-7c7d-419e-9349-9e2462163dbc",
              "epcList": [],
              "action": "ADD",
              "bizStep": "commissioning",
              "disposition": "active",
              "readPoint": {
                  "id": "geo:37.7749,-122.4194"
              },
              "bizLocation": {
                  "id": "urn:gdst:example.org:location:loc:solution.hatchery"
              },
              "quantityList": [
                  {
                      "epcClass": "urn:gdst:example.org:product:lot:class:solution.fryling.lot1",
                      "quantity": 1000,
                      "uom": "KGM"
                  }
              ],
              "ilmd": {
                  "cbvmda:productionMethodForFishAndSeafoodCode": "AQUACULTURE",
                  "cbvmda:certificationList": {
                      "certification": [
                          {
                              "gdst:certificationType": "urn:gdst:certType:harvestCert",
                              "certificationAgency": "Harvest Agency",
                              "certificationStandard": "Harvest Certificate Standard",
                              "certificationValue": "ghi789",
                              "certificationIdentification": "HARV-0003"
                          },
                          {
                              "gdst:certificationType": "urn:gdst:certType:humanPolicy",
                              "certificationAgency": "Human Policy Agency",
                              "certificationStandard": "Human Welfare Policy Standard",
                              "certificationValue": "pqr678",
                              "certificationIdentification": "HUMN-0006"
                          }
                  ]
              }
              },
              "gdst:productOwner": "urn:gdst:example.org:party:solution.hatchery",
              "gdst:humanWelfarePolicy": "3p",
              "cbvmda:informationProvider": "urn:gdst:example.org:party:solution.hatchery"
          }


How did we do?

Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)