Seafood Module Shipping Event

Shipping events capture the shipment of one or more products that have been transported from one physical location to another. The seafood shipping event applies to seafood products being shipped from a land facility to another land facility. More specific movements of products, such as transshipment of products, are defined in the wildcaught module.

Event Profile

Seafood shipping events are identified by the following event characteristics.

KDE

Value

type

ObjectEvent

action

OBSERVE

disposition

in_transit

bizStep

shipping

The seafood shipping event applies to land-based movements of seafood products. The source location and destination locations must have a locationClassification of land facility and at least one product must have a productClassification of seafood.

KDE Requirements

The following KDEs are required on the root of a seafood shipping event, in addition to the Core requirements.

KDE Description Example Value
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

Certificate Requirements

A seafood shipping event must carry at least one complete certificate in its certificationList. 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 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

Source List Requirements

Both owning_party and location must be set on the source list. The source list is an array property of objects that have a type and source property. Entries in sourceList tie the shipment to originating locations and product owners.

KDE Description Example Value
type Indicates what is identified by the value, typically the owning party or location urn:epcglobal:cbv:sdt:owning_party, urn:epcglobal:cbv:sdt:location
source Either a PGLN or GDST party identifier to indicate the owning party or a GLN or GDST location identifier to indicate the location. urn:epc:id:sgln:08600031303.0.0, urn:gdst:example.org:party:example_prefix.0, urn:gdst:example.org:location:loc:example_prefix.0

Example

[
              {
                  "type": "urn:epcglobal:cbv:sdt:owning_party",
                  "source": "urn:gdst:traceability-solution.com:party:0048000.vessel_owner"
              },
              {
                  "type": "urn:epcglobal:cbv:sdt:location",
                  "source": "urn:gdst:traceability-solution.com:location:loc:0048000.fishing_vessel"
              }
          ]

Destination List Requirements

Both the owning_party and location must be set on the destination list. The destination list is an array property of objects that have a type and destination property. Entries in destinationList tie the shipment to destination locations and product owners.

KDE Description Example Value
type Indicates what is identified by the value, typically the owning party or location urn:epcglobal:cbv:sdt:owning_party, urn:epcglobal:cbv:sdt:location
destination Either a PGLN or GDST party identifier to indicate the owning party or a GLN or GDST location identifier to indicate the location. urn:epc:id:sgln:08600031303.0.0, urn:gdst:example.org:party:example_prefix.0, urn:gdst:example.org:location:loc:example_prefix.0

Example

[
              {
                  "type": "urn:epcglobal:cbv:sdt:owning_party",
                  "destination": "urn:gdst:traceability-solution.com:party:0048000.port_operator"
              },
              {
                  "type": "urn:epcglobal:cbv:sdt:location",
                  "destination": "urn:gdst:traceability-solution.com:location:loc:0048000.port"
              }
          ]

Full JSON Example

{
              "@context": [
                  "https://ref.gs1.org/standards/epcis/epcis-context.jsonld",
                  {
                      "gdst": "https://traceability-dialogue.org/epcis"
                  }
              ],
              "type": "ObjectEvent",
              "eventTime": "2026-04-19T06:58:39.4957023+00:00",
              "eventTimeZoneOffset": "+00:00",
              "eventID": "urn:uuid:aad823fb-e55f-46a6-8142-948dccfff6f8",
              "epcList": [],
              "action": "OBSERVE",
              "bizStep": "shipping",
              "disposition": "in_transit",
              "readPoint": {
                  "id": "geo:37.7749,-122.4194"
              },
              "bizLocation": {
                  "id": "urn:gdst:example.org:location:loc:solution.processorplant"
              },
              "quantityList": [
                  {
                      "epcClass": "urn:gdst:example.org:product:lot:class:solution.processedfish.final1",
                      "quantity": 15876.0,
                      "uom": "KGM"
                  }
              ],
              "sourceList": [
                  {
                      "type": "location",
                      "source": "urn:gdst:example.org:location:loc:solution.processorplant"
                  },
                  {
                      "type": "owning_party",
                      "source": "urn:gdst:example.org:party:solution.processor"
                  }
              ],
              "destinationList": [
                  {
                      "type": "location",
                      "destination": "urn:gdst:example.org:location:loc:solution.importerwarehouse"
                  },
                  {
                      "type": "owning_party",
                      "destination": "urn:gdst:example.org:party:solution.importer"
                  }
              ],
              "cbvmda:certificationList": {
                  "certification": [
                        {
                          "gdst:certificationType": "urn:gdst:certType:harvestCoC",
                          "certificationAgency": "CoC Agency",
                          "certificationStandard": "Generic Chain of Custody Standard",
                          "certificationValue": "abc123",
                          "certificationIdentification": "COC-0001"
                        }
                  ]
              },
              "cbvmda:informationProvider": "urn:gdst:example.org:party:solution.processor"
          }


How did we do?

Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)