Seafood Module Receiving Event

Receiving events capture the receipt of one or more products that have been transported from one physical location to another. The seafood receiving event applies to seafood products being received at a land facility after being shipped from another land facility. More specific movements of products, such as a landing or transshipment of products, or defined in the wildcaught module.

Event Profile

A seafood receiving event is identified by the following event characteristics

KDE

Value

type

ObjectEvent

action

OBSERVE

bizStep

receiving

The seafood receiving 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 properties are required on the root of the seafood receiving 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
eventTime A string value formatted as an ISO datetime 2026-01-01T00:00:00.000Z
eventTimeZoneOffset The time zone offset in effect at the time and place the event occurred, expressed as an offset from UTC. The purpose of eventTimeZoneOffset is to provide additional business context about the event, namely to identify what time zone offset was in effect at the time and place the event was captured. "+00:00"
bizLocation A URN formatted GLN or GDST location identifier validated as a GLN with related master data urn:epc:id:gln:1234567890123, urn:gdst:example.org:location:loc:examplePrefix.0
informationProvider 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

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 source 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-19T05:58:39.4957023+00:00",
              "eventTimeZoneOffset": "+00:00",
              "eventID": "urn:uuid:7a9efc42-d773-41af-88df-3f4919f50dcc",
              "epcList": [],
              "action": "OBSERVE",
              "bizStep": "receiving",
              "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.wildfish.lot2",
                      "quantity": 9876,
                      "uom": "KGM"
                  }
              ],
              "sourceList": [
                  {
                      "type": "location",
                      "source": "urn:gdst:example.org:location:loc:solution.port"
                  },
                  {
                      "type": "owning_party",
                      "source": "urn:gdst:example.org:party:solution.processor"
                  }
              ],
              "destinationList": [
                  {
                      "type": "location",
                      "destination": "urn:gdst:example.org:location:loc:solution.processorplant"
                  },
                  {
                      "type": "owning_party",
                      "destination": "urn:gdst:example.org:party:solution.processor"
                  }
              ],
              "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)