Wild Catch Module Transshipping (Shipping) Event

Transshipment events capture the transfer of products from one vessel to another priot to landing. In these events, both the source and destination locations are different vessels.Transshipments are represented as two events: a shipping event from the originating vessel and a receiving event the destination vessel.This article describes the transshipping shipping event.

Event Profile

A transshipping shipping event is identified by the following event characteristics:

KDE

Value

type

ObjectEvent

action

OBSERVE

bizStep

Shipping

disposition

in_transit

A transshipment shipping event must have a source location with a locationClassification of vessel and a destination location with a locationClassification of vessel.

KDE Requirements

The following KDEs are required on the root of the transshipping shipping 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 Event location identifier for the vessel from which the seafood was transshipped; 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
readPoint A readPoint object with an id property equal to a geo formatted coordinate pair geo:37.860236,-123.144697
unloadingPort A UN/LOCODE string identifying the port where an in-port transshipment occurred. Required only for in-port transshipments. USLA2

Source List Requirements

Both the 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 transshipment to the originating vessel and product owner.

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 transshipment to the receiving vessel and product owner.

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"
              }
          ]

Certificate Requirements

The following certificates are required on the certificationList on the transshipment shipping event.

Certification Certification Type
Chain of Custody urn:gdst:certType:harvestCoC
Human Welfare Policy urn:gdst:certType:humanyPolicy
Legal Authorization urn:gdst:certType:fishingAuth

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": "ObjectEvent",
              "eventTime": "2026-04-17T22:58:47.3535287+00:00",
              "eventTimeZoneOffset": "+00:00",
              "eventID": "urn:uuid:3b853be6-e180-4a47-a09d-c9b41bcbce15",
              "epcList": [],
              "action": "OBSERVE",
              "bizStep": "shipping",
              "disposition": "in_transit",
              "readPoint": {
                  "id": "geo:37.7749,-122.4194"
              },
              "bizLocation": {
                  "id": "urn:gdst:example.org:location:loc:solution.vessel1"
              },
              "quantityList": [
                  {
                      "epcClass": "urn:gdst:example.org:product:lot:class:solution.wildfish.lot2",
                      "quantity": 9876.0,
                      "uom": "KGM"
                  }
              ],
              "sourceList": [
                  {
                      "type": "location",
                      "source": "urn:gdst:example.org:location:loc:solution.vessel1"
                  },
                  {
                      "type": "owning_party",
                      "source": "urn:gdst:example.org:party:solution.fisherman"
                  }
              ],
              "destinationList": [
                  {
                      "type": "location",
                      "destination": "urn:gdst:example.org:location:loc:solution.vessel2"
                  },
                  {
                      "type": "owning_party",
                      "destination": "urn:gdst:example.org:party:solution.processor"
                  }
              ],
              "cbvmda:unloadingPort": "PORTSD",
              "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:transshipmentAuth",
                          "certificationAgency": "Transshipment Auth Agency",
                          "certificationStandard": "Transshipment Authorization Standard",
                          "certificationValue": "stu901",
                          "certificationIdentification": "TRANS-0007"
                      }
                  ]
              },
              "cbvmda:informationProvider": "urn:gdst:example.org:party:solution.fisherman"
          }


How did we do?

Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)