Aquaculture Module Mature Harvest Event

Mature harvesting events record market-ready seafood being harvested from an aquaculture facility.

Event Profile

Mature harvesting events are identified by the following characteristics:

KDE

Value

type

TransformationEvent

bizStep

commissioning

disposition

active

Mature harvesting events must have at least one output product with a productClassification of mature.

KDE Requirements

The following KDEs are required on the root of a mature harvesting event, in addition to the Core and Seafood requirements.

KDE Description Example Value
bizLocation Facility where the seafood was harvested; validated as a GLN with related master data urn:epc:id:gln:1234567890123
readPoint A readPoint object with an id property equal to a geo formatted coordinate pair geo:37.860236,-123.144697
informationProvider A URN formatted PGLN or GDST party identifier urn:epc:id:sgln:08600031303.0.0, urn:gdst:example.org:party:example_prefix.0
productOwner A URN formatted PGLN or GDST party identifier urn:epc:id:sgln:08600031303.0.0, urn:gdst:example.org:party:example_prefix.0
humanWelfarePolicy Indicates whether a human welfare policy was in place during the event internal policy, 3P audit, none

Instance Lot Master Data (ILMD) Requirements

The following properties should be on the ilmd property of the mature harvesting event.

KDE Description Example Value
productionMethodForFishAndSeafoodCode Code specifying how the seafood was cultivated; must match a value from the GS1 code list ProductionMethodForFishAndSeafoodCode (version 15) (valid list code)
aquacultureMethod Farming method from FAO’s Aquaculture Methods and Practices (e.g. extensive, semi-intensive, intensive). Reference: FAO aquaculture methods extensive, semi-intensive, intensive

Certificate Requirements

| A mature harvest event must carry at least one complete certificate in its certificationList, either on the event or in the ilmd. GDST 2.0 does not name certification types in its normative event profiles; the controlled list of supported values is maintained in the Certification Types article.

Certificates are required to have the following properties

Certificate Property Description Example Value
certificationType A URN formatted string defining the type of certificate 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": "TransformationEvent",
              "eventTime": "2026-04-19T00:19:05.0678733+00:00",
              "eventTimeZoneOffset": "+00:00",
              "eventID": "urn:uuid:7def0e4c-e444-41e1-9dc5-428f643aa8a4",
              "inputQuantityList": [
                  {
                      "epcClass": "urn:gdst:example.org:product:lot:class:solution.fryling.lot1",
                      "quantity": 1000.0,
                      "uom": "KGM"
                  },
                  {
                      "epcClass": "urn:gdst:example.org:product:lot:class:solution.feed.lot1",
                      "quantity": 5000.0,
                      "uom": "KGM"
                  }
              ],
              "outputQuantityList": [
                  {
                      "epcClass": "urn:gdst:example.org:product:lot:class:solution.farmedfish.lot1",
                      "quantity": 6000.0,
                      "uom": "KGM"
                  }
              ],
              "bizStep": "commissioning",
              "disposition": "active",
              "readPoint": {
                  "id": "geo:37.7749,-122.4194"
              },
              "bizLocation": {
                  "id": "urn:gdst:example.org:location:loc:solution.fishfarm"
              },
              "ilmd": {
                  "gdst:aquacultureMethod": "intensive",
                  "cbvmda:productionMethodForFishAndSeafoodCode": "AQUACULTURE",
                  "cbvmda:certificationList": {
                      "certification": [
                          {
                              "gdst:certificationType": "urn:gdst:certType:harvestCoC",
                              "certificationAgency": "CoC Agency",
                              "certificationStandard": "Generic Chain of Custody Standard",
                              "certificationValue": "abc123",
                              "certificationIdentification": "COC-0001"
                          },
                          {
                              "gdst:certificationType": "urn:gdst:certType:humanPolicy",
                              "certificationAgency": "Human Policy Agency",
                              "certificationStandard": "Human Welfare Policy Standard",
                              "certificationValue": "pqr678",
                              "certificationIdentification": "HUMN-0006"
                          },
                          {
                              "gdst:certificationType": "urn:gdst:certType:harvestCert",
                              "certificationAgency": "Harvest Agency",
                              "certificationStandard": "Harvest Certificate Standard",
                              "certificationValue": "ghi789",
                              "certificationIdentification": "HARV-0003"
                          },
                          {
                              "gdst:certificationType": "urn:gdst:certType:legalAuth",
                              "certificationAgency": "Legal Auth Agency",
                              "certificationStandard": "Legal Authorization Standard",
                              "certificationValue": "mno345",
                              "certificationIdentification": "LEGL-0005"
                          }
                    ]
                  }
              },
              "gdst:productOwner": "urn:gdst:example.org:party:solution.fishfarm",
              "gdst:humanWelfarePolicy": "3P audit",
              "cbvmda:informationProvider": "urn:gdst:example.org:party:solution.fishfarm"
          }


How did we do?

Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)