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 properties should be on the root of the mature harvesting event.

KDE Description Example Value
eventID A URN formatted universally unique ID (UUID) urn:uuid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
eventTime A string value formatted as an ISO datetime 2026-01-01T00:00:00.000Z
bizLocation Facility where the seafood was 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 Audit, internal policy

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

The following certificates are required on the certificationList of the ilmd of the mature harvesting event.

Certification description Certification type
Harvest certification urn:gdst:certType:harvestCert
Human welfare policy standards urn:gdst:certType:humanPolicy
Chain of Custody urn:gdst:certType:harvestCoC
Legal authorization (facility / aquaculture permit) urn:gdst:certType:legalAuth

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": "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 ponds",
                  "cbvmda:productionMethodForFishAndSeafoodCode": "AQUACULTURE",
                  "cbvmda:countryOfOrigin": "US",
                  "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","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)