SIMP - Wild Harvest

In this scenario, we will cover a single large vessel. In SIMP, a large vessel is considered a vessel that is either more than 12 meters long or 20 metric tons. Below we give an example EPCIS XML that will include Master Data, a Fishing Event, a Transshipment Event, and an Offload Event. Then we will take the EPCIS data and show how it can be converted into PGA Record(s) for filing a SIMP report.

Personally Identifying Data is not required to fill out a SIMP report; contact information can be organization-based. It is GDST's recommendation that non-personally identifying contact information is provided for the farm such as a general position at the farm company to communicate with, a general email for the farm, and the phone number for the farm company that is not a personal phone number.

Required KDEs

In order to fill out a SIMP report for a Wild Harvest scenario we will need the following KDEs:

  • PG05.ScientificSpeciesCode - Scientific Name - Pulled from Master Data
  • PG06.CountryCode - Catching Country - Pulled from the Country of Origin in the ILMD data of the Fishing Event
  • PG06.GeographicLocation - FAO Zone - Pulled from the Vessel Catch information in the ILMD data for the Fishing Event
  • PG06.ProcessingStartDate - Offload / Landing Date - Pulled from the Event Time of the Offload Event.
  • PG06.ProcessingTypeCode - Fishing Method - Pulled from the Vessel Catch information in the ILMD data for the Fishing Event
  • PG14.LPCONumber - IFTP Number - Pulled from the Master Data of the Vessel / Party. In this example, we will pull it from the Master Data of the Vessel Owning Party.
  • PG19.EntityName - First Receiver Business Name - Pulled from Master Data for Owning Party of the BizLocation of the event with the disposition of "entering_commerce".
  • PG19 & PG20 - First Receiver Address - Pulled from Master Data for the BizLocation of the event with the disposition of "entering_commerce".
  • PG21.IndividualName - First Receiver Contact Name - Pulled from Master Data for the BizLocation of the event with the disposition of "entering_commerce".
  • PG21.IndividualTelephone - First Receiver Contact Email - Pulled from Master Data for the BizLocation of the event with the disposition of "entering_commerce".
  • PG21.IndividualEmail - First Receiver Contact Phone - Pulled from Master Data for the BizLocation of the event with the disposition of "entering_commerce".
  • PG31VCR.NetWeight - Product Net Weight - Pulled from the Net Weight recorded for the Product in the Offload Event
  • PG06.ProcessingDescription - Product Form - Pulled from the Product Form of the Master Data of the Offloaded product.
  • PG31VCR.CountryCode - Vessel Flag - Pulled from Master Data for BizLocation of the Fishing Event or from the Vessel Catch information in the ILMD data of the Fishing Event
  • PG31VNM.VesselName - Vessel Name - Pulled from Master Data for BizLocation of the Fishing Event or from the Vessel Catch information in the ILMD data of the Fishing Event
  • PG32.RoutingCountryCodex - Transshipment Location Country Code - Pulled from Read Point geo-coordinates of the Transshipment Event.
  • PG32.RoutingCountryCodex - Offload Country - Pulled from Master Data for the BizLocation of the Offload Event. This attribute is not used in this example because there is a Transshipment that occurs.

This documentation is not meant to serve as a guide for SIMP and is just meant to be an example of converting GDST EPCIS XML into SIMP Records. For further documentation on SIMP please see here.

There are attributes required by SIMP that are not part of the GDST guidance. Here are recommendations on how these attributes could be recorded in EPCIS in order to meet SIMP requirements.

  • IFTP Number - This can be recorded as an additional attribute either in the Party or Location master data. The recommended CBV attribute is urn:gdst:iftp.

Fishing Event

Here is the Example XML for the GDST EPCIS data. This event data will contain a Fishing Event, Transshipment, and Offload Event.

{
"@context": [
"https://ref.gs1.org/standards/epcis/epcis-context.jsonld",
{
"xsi": "http://www.w3.org/2001/XMLSchema-instance"
},
{
"sbdh": "http://www.unece.org/cefact/namespaces/StandardBusinessDocumentHeader"
},
{
"gdst": "https://traceability-dialogue.org/epcis/"
}
],
"type": "EPCISDocument",
"creationDate": "2001-12-17T09:30:47.0000000+00:00",
"schemaVersion": "2.0",
"sender": "test",
"receiver": "test",
"instanceIdentifier": "9999",
"epcisBody": {
"eventList": [
{
"type": "ObjectEvent",
"eventTime": "2020-01-27T18:00:00.0000000+00:00",
"eventTimeZoneOffset": "+00:00",
"eventID": "urn:uuid:fbe739d8-33b0-4aa9-a473-ac227c0caebd",
"epcList": [],
"action": "ADD",
"bizStep": "commissioning",
"disposition": "active",
"bizLocation": {
"id": "urn:gdst:traceability-solution.com:location:loc:0b4e59bb-29ba-4edd-8e51-7e8d1a96dce7.47797660-9355-4f8c-8867-c98ee1e8b684"
},
"quantityList": [
{
"epcClass": "urn:gdst:traceability-solution.com:product:lot:class:0b4e59bb-29ba-4edd-8e51-7e8d1a96dce7.yft.lot123",
"quantity": 10000.0,
"uom": "KGM"
}
],
"ilmd": {
"cbvmda:countryOfOrigin": "US",
"cbvmda:certificationList": {
"certification": [
{
"gdst:certificationType": "urn:gdst:certType:catch_certificate",
"certificationAgency": "DFO",
"certificationStandard": "NM6",
"certificationValue": "SIMP.LPCO.2",
"certificationIdentification": "10161781"
}
]
},
"cbvmda:vesselCatchInformationList": {
"cbvmda:vesselCatchInformation": {
"cbvmda:catchArea": "urn:gdst:fao:77",
"cbvmda:fishingGearTypeCode": "urn:gdst:gear:1.2"
}
},
"cbvmda:productionMethodCode": "MARINE_FISHERY"
},
"cbvmda:informationProvider": "urn:gdst:traceability-solution.com:party:0b4e59bb-29ba-4edd-8e51-7e8d1a96dce7",
"gdst:productOwner": "urn:gdst:traceability-solution.com:party:0b4e59bb-29ba-4edd-8e51-7e8d1a96dce7"
}
]
}
}

TransShipment Event

{
"@context": [
"https://ref.gs1.org/standards/epcis/epcis-context.jsonld",
{
"xsi": "http://www.w3.org/2001/XMLSchema-instance"
},
{
"sbdh": "http://www.unece.org/cefact/namespaces/StandardBusinessDocumentHeader"
},
{
"gdst": "https://traceability-dialogue.org/epcis/"
}
],
"type": "EPCISDocument",
"creationDate": "2001-12-17T09:30:47.0000000+00:00",
"schemaVersion": "2.0",
"sender": "test",
"receiver": "test",
"instanceIdentifier": "9999",
"epcisBody": {
"eventList": [
{
"type": "ObjectEvent",
"eventTime": "2020-01-27T18:00:00.0000000+00:00",
"eventTimeZoneOffset": "+00:00",
"eventID": "urn:uuid:10d7e633-3014-425f-a652-caa8619945aa",
"epcList": [],
"action": "ADD",
"bizStep": "urn:gdst:bizstep:transshipment",
"disposition": "urn:gdst:disposition:entering_commerce",
"bizLocation": {
"id": "urn:gdst:traceability-solution.com:location:loc:0048000.jimmystender001"
},
"quantityList": [
{
"epcClass": "urn:gdst:traceability-solution.com:product:lot:class:0b4e59bb-29ba-4edd-8e51-7e8d1a96dce7.yft.lot123",
"quantity": 10000.0,
"uom": "KGM"
}
],
"sourceList": [
{
"type": "owning_party",
"source": "urn:gdst:traceability-solution.com:party:0b4e59bb-29ba-4edd-8e51-7e8d1a96dce7"
}
],
"destinationList": [
{
"type": "owning_party",
"destination": "urn:gdst:traceability-solution.com:party:0048000.000001"
}
],
"cbvmda:informationProvider": "urn:gdst:traceability-solution.com:party:0048000.000001",
"gdst:productOwner": "urn:gdst:traceability-solution.com:party:0b4e59bb-29ba-4edd-8e51-7e8d1a96dce7"
}
]
}
}

Offload Event

{
"@context": [
"https://ref.gs1.org/standards/epcis/epcis-context.jsonld",
{
"xsi": "http://www.w3.org/2001/XMLSchema-instance"
},
{
"sbdh": "http://www.unece.org/cefact/namespaces/StandardBusinessDocumentHeader"
},
{
"gdst": "https://traceability-dialogue.org/epcis/"
}
],
"type": "EPCISDocument",
"creationDate": "2001-12-17T09:30:47.0000000+00:00",
"schemaVersion": "2.0",
"sender": "test",
"receiver": "test",
"instanceIdentifier": "9999",
"epcisBody": {
"eventList": [
{
"type": "ObjectEvent",
"eventTime": "2020-01-27T18:00:00.0000000+00:00",
"eventTimeZoneOffset": "+00:00",
"eventID": "urn:uuid:cf3f488f-9506-47ce-b902-3dc573447956",
"epcList": [],
"action": "OBSERVE",
"bizStep": "urn:gdst:bizstep:offloading",
"disposition": "active",
"bizLocation": {
"id": "urn:gdst:traceability-solution.com:location:loc:0048000.sdport"
},
"quantityList": [
{
"epcClass": "urn:gdst:traceability-solution.com:product:lot:class:0b4e59bb-29ba-4edd-8e51-7e8d1a96dce7.yft.lot123",
"quantity": 10000.0,
"uom": "KGM"
}
],
"cbvmda:informationProvider": "urn:gdst:traceability-solution.com:party:0048000.000001",
"gdst:productOwner": "urn:gdst:traceability-solution.com:party:0048000.000001"
}
]
}
}

Example Wild Harvest SIMP Report

Now that we have the EPCIS data, the PGA Record(s) will look like this:

PG01001NMFSIMY
PG02
PG05
YFT
PG06HCFUSPAC 01272020 TRW NRD
PG142NM41234567890
PG19BY Jimmy's Processings Co.
3165 Pacific Hwy
PG20 San Diego
CA US92101
PG21BY Joe Smith +1.999-999-9999
joe@triunionsf.com
PG31VCRUS KG 10000
PG31VNMBING Ship
PG3213 US

Important Notes

  • The FAO Zone 77 is translated into the NMFS Geographic Regin 'PAC'
  • The 'Country of Origin' in the ILMD data for the Fishing Event is not required by GDST. This is added in order to populate the PG06.CountryCode field because the catching country is required.
  • The 'Product Form' on the Product Definition for the Yellow Tuna is translated into the NMFS Processing Description 'NRD' for the PG06.Processing Description field.W
  • The PG32.CountryCode is supposed the be territorial waters where the Transshipment took place. This can be deduced by taking the GDST Transshipment Location At-Sea Geo Coordinates and translating those into the Territorial Water.


How did we do?


Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)