Aquaculture Module Immature Harvest Event

Immature harvest events refer to immature seafood products being harvested from hatchery facilities.

Examples include:

  • Fingerling/fry tilapia harvested from a hatchery facility to be moved to a growout pond.
  • Immature salmon harvested from a hatchery so that they can be transferred to net pens.

Event Profile

Immature harvest events are identified based on the following event characteristics:

KDE

Value

type

ObjectEvent

action

ADD

bizStep

commissioning

disposition

active

Immature harvest events must have at least one product with a productClassification of developing.

KDE Requirements

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

KDE Description Example Value
bizLocation Facility where the immature animals were 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 available on the ilmd property of the immature harvesting 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) AQUACULTURE
broodstockSource Whether broodstock for the batch is domestic or wild domestic, wild

Certificate Requirements

An immature 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": "ObjectEvent",
              "eventTime": "2026-04-18T01:58:47.3535287+00:00",
              "eventTimeZoneOffset": "+00:00",
              "eventID": "urn:uuid:dab8e014-d69a-430d-b450-e48797c9bd7f",
              "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.0,
                      "uom": "KGM"
                  }
              ],
              "ilmd": {
                  "gdst:broodstockSource": "domestic",
                  "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: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.hatchery",
              "gdst:humanWelfarePolicy": "3P audit",
              "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)