EUDR Event Types

This page documents the EPCIS event types used for EUDR compliance. We support two complementary patterns:

1. EPCIS Traceability Events - Standard supply chain visibility (harvesting, shipping, transformation)
2. V1.11 Compliance Events - GS1 Germany Guideline pattern for EUDR data sharing (bizStep: "notifying")

Event Overview

EPCIS Traceability Events (Standard Pattern)

V1.11 Compliance Events (GS1 Germany Guideline)

EPCIS Traceability Events

Harvesting Event

Records the creation/harvesting of a commodity at the plot of land. Uses sensor data to capture GPS coordinates and masterDataAvailableFor for product/location master data per GS1 Germany EUDR Guideline V1.11.

{
  "@context": [
    "https://ref.openepcis.io/extensions/eu/eudr/eudr-context.jsonld",
    "https://ref.gs1.org/standards/epcis/epcis-context.jsonld"
  ],
  "type": "ObjectEvent",
  "eventID": "urn:uuid:550e8400-e29b-41d4-a716-446655440020",
  "eventTime": "2025-01-15T08:30:00.000Z",
  "eventTimeZoneOffset": "+01:00",
  "action": "ADD",
  "bizStep": "commissioning",
  "disposition": "active",
  "epcList": [
    "https://id.gs1.org/01/09521234000020/21/LOG-2025-001"
  ],
  "readPoint": {
    "id": "https://id.gs1.org/414/9521234000099"
  },
  "sensorElementList": [
    {
      "sensorMetadata": {
        "time": "2025-01-15T08:30:00.000Z",
        "deviceID": "https://id.gs1.org/8004/9521234000006-GPS-001"
      },
      "sensorReport": [
        {
          "type": "gs1:Latitude",
          "value": 52.515,
          "uom": "DD"
        },
        {
          "type": "gs1:Longitude",
          "value": 13.405,
          "uom": "DD"
        }
      ]
    }
  ],
  "masterDataAvailableFor": [
    {
      "id": "https://id.gs1.org/01/09521234000020/21/LOG-2025-001",
      "eudr:commodityType": "Wood",
      "eudr:timberProductType": "RoundWood",
      "eudr:speciesScientificName": "Quercus robur",
      "eudr:speciesCommonName": "European Oak",
      "gs1:harvestDate": "2025-01-15",
      "countryOfOrigin": "DE",
      "eudr:originDetails": "https://id.gs1.org/414/9521234000099"
    },
    {
      "id": "https://id.gs1.org/414/9521234000099",
      "locationGLN": "9521234000099",
      "physicalLocationName": "Sustainable Oak Forest - Plot 47",
      "geo": {
        "polygon": "[[13.40, 52.51], [13.41, 52.51], [13.41, 52.52], [13.40, 52.52], [13.40, 52.51]]"
      },
      "countryCode": "DE",
      "eudr:forestManagementUnit": "FMU-DE-2024-00123",
      "eudr:areaHectares": 2.5
    }
  ]
}

Key Fields (V1.11 Pattern):

• action: ADD - creating new commodity
• bizStep: commissioning - first capture in supply chain
• epcList: Simple string array of product identifiers
• sensorElementList: GPS coordinates captured at harvest
• masterDataAvailableFor: Top-level array with full product and location master data (bare strings inside, no gs1: prefix)

Processing/Transformation Event

Records the transformation of commodities into derived products. Uses masterDataAvailableFor for all product master data.

{
  "@context": [
    "https://ref.openepcis.io/extensions/eu/eudr/eudr-context.jsonld",
    "https://ref.gs1.org/standards/epcis/epcis-context.jsonld"
  ],
  "type": "TransformationEvent",
  "eventID": "urn:uuid:550e8400-e29b-41d4-a716-446655440030",
  "eventTime": "2025-02-15T14:00:00.000Z",
  "bizStep": "commissioning",
  "disposition": "active",
  "inputEPCList": [
    "https://id.gs1.org/01/09521234000020/21/LOG-2025-001",
    "https://id.gs1.org/01/09521234000020/21/LOG-2025-002"
  ],
  "outputEPCList": [
    "https://id.gs1.org/01/09521234000037/21/TABLE-2025-001"
  ],
  "readPoint": {
    "id": "https://id.gs1.org/414/9521234000105"
  },
  "masterDataAvailableFor": [
    {
      "id": "https://id.gs1.org/01/09521234000020/21/LOG-2025-001",
      "eudr:commodityType": "Wood",
      "eudr:timberProductType": "RoundWood",
      "eudr:speciesScientificName": "Quercus robur",
      "countryOfOrigin": "DE"
    },
    {
      "id": "https://id.gs1.org/01/09521234000020/21/LOG-2025-002",
      "eudr:commodityType": "Wood",
      "eudr:timberProductType": "RoundWood",
      "eudr:speciesScientificName": "Quercus robur",
      "countryOfOrigin": "DE"
    },
    {
      "id": "https://id.gs1.org/01/09521234000037/21/TABLE-2025-001",
      "eudr:commodityType": "Wood",
      "eudr:timberProductType": "Furniture",
      "eudr:speciesScientificName": "Quercus robur",
      "eudr:transformationDate": "2025-02-15",
      "countryOfOrigin": "DE"
    },
    {
      "id": "https://id.gs1.org/414/9521234000105",
      "locationGLN": "9521234000105",
      "physicalLocationName": "M\u00f6belwerkstatt Weber - Furniture Workshop",
      "countryCode": "DE"
    }
  ]
}

Key Fields (V1.11 Pattern):

• inputEPCList: Simple string array of source commodities
• outputEPCList: Simple string array of derived products
• readPoint: Processing facility location
• masterDataAvailableFor: Full master data for inputs, outputs, and location (bare strings)

Supply Chain Transfer Events

Records ownership changes as commodities move through the supply chain.

Shipping Event:

{
  "@context": "https://ref.gs1.org/standards/epcis/epcis-context.jsonld",
  "type": "ObjectEvent",
  "eventTime": "2025-01-25T09:00:00.000Z",
  "action": "OBSERVE",
  "bizStep": "shipping",
  "disposition": "in_transit",
  "epcList": [
    {
      "@id": "https://id.gs1.org/01/09521234000020/21/LOG-2025-001"
    },
    {
      "@id": "https://id.gs1.org/01/09521234000020/21/LOG-2025-002"
    }
  ],
  "sourceList": [
    {
      "type": "urn:epcglobal:cbv:sdt:owning_party",
      "source": "https://id.gs1.org/417/9521234000006"
    }
  ],
  "destinationList": [
    {
      "type": "urn:epcglobal:cbv:sdt:owning_party",
      "destination": "https://id.gs1.org/417/9521234000105"
    }
  ],
  "bizTransactionList": [
    {
      "type": "urn:epcglobal:cbv:btt:po",
      "bizTransaction": "urn:epcglobal:cbv:bt:9521234000105:PO-2025-001"
    },
    {
      "type": "urn:epcglobal:cbv:btt:desadv",
      "bizTransaction": "urn:epcglobal:cbv:bt:9521234000006:DESADV-2025-001"
    }
  ]
}

Receiving Event:

{
  "@context": "https://ref.gs1.org/standards/epcis/epcis-context.jsonld",
  "type": "ObjectEvent",
  "eventTime": "2025-01-26T14:00:00.000Z",
  "action": "OBSERVE",
  "bizStep": "receiving",
  "disposition": "in_progress",
  "epcList": [
    {
      "@id": "https://id.gs1.org/01/09521234000020/21/LOG-2025-001"
    },
    {
      "@id": "https://id.gs1.org/01/09521234000020/21/LOG-2025-002"
    }
  ],
  "sourceList": [
    {
      "type": "urn:epcglobal:cbv:sdt:owning_party",
      "source": "https://id.gs1.org/417/9521234000006"
    }
  ],
  "destinationList": [
    {
      "type": "urn:epcglobal:cbv:sdt:owning_party",
      "destination": "https://id.gs1.org/417/9521234000105"
    }
  ],
  "bizTransactionList": [
    {
      "type": "urn:epcglobal:cbv:btt:po",
      "bizTransaction": "urn:epcglobal:cbv:bt:9521234000105:PO-2025-001"
    },
    {
      "type": "urn:epcglobal:cbv:btt:recadv",
      "bizTransaction": "urn:epcglobal:cbv:bt:9521234000105:RECADV-2025-001"
    }
  ]
}

V1.11 Compliance Events

Per GS1 Germany EUDR Guideline V1.11, use bizStep: "notifying" and persistentDisposition: { "set": ["subject_to_regulation"] } for EUDR compliance data sharing.

Origin Declaration Event

Shares origin and geolocation data for EUDR compliance between supply chain partners. Per GS1 Germany EUDR Guideline V1.11, uses masterDataAvailableFor with regulatoryInformation nested inside the product entry.

{
  "@context": [
    "https://ref.openepcis.io/extensions/common/core/dpp-core-context.jsonld",
    "https://ref.openepcis.io/extensions/eu/eudr/eudr-context.jsonld",
    "https://ref.gs1.org/standards/epcis/epcis-context.jsonld"
  ],
  "type": "ObjectEvent",
  "eventID": "urn:uuid:550e8400-e29b-41d4-a716-446655440025",
  "eventTime": "2025-01-20T10:00:00.000Z",
  "eventTimeZoneOffset": "+01:00",
  "action": "OBSERVE",
  "bizStep": "notifying",
  "persistentDisposition": {
    "set": [
      "subject_to_regulation"
    ]
  },
  "readPoint": {
    "id": "https://id.gs1.org/414/9521234000006"
  },
  "quantityList": [
    {
      "epcClass": "https://id.gs1.org/01/09521234000020/10/BATCH-2025-01",
      "quantity": 850,
      "uom": "KGM"
    }
  ],
  "bizTransactionList": [
    {
      "type": "urn:epcglobal:cbv:btt:desadv",
      "bizTransaction": "urn:epcglobal:cbv:bt:9521234000006:DESADV-2025-001"
    },
    {
      "type": "urn:epcglobal:cbv:btt:po",
      "bizTransaction": "urn:epcglobal:cbv:bt:9521234000006:PO-2025-001"
    }
  ],
  "sourceList": [
    {
      "type": "urn:epcglobal:cbv:sdt:owning_party",
      "source": "https://id.gs1.org/417/9521234000006"
    }
  ],
  "destinationList": [
    {
      "type": "urn:epcglobal:cbv:sdt:owning_party",
      "destination": "https://id.gs1.org/417/9521234000105"
    }
  ],
  "masterDataAvailableFor": [
    {
      "id": "https://id.gs1.org/01/09521234000020/10/BATCH-2025-01",
      "hasBatchLotNumber": "BATCH-2025-01",
      "eudr:commodityType": "Wood",
      "eudr:timberProductType": "RoundWood",
      "eudr:speciesScientificName": "Quercus robur",
      "gs1:harvestDateStart": "2025-01-10",
      "gs1:harvestDateEnd": "2025-01-15",
      "gs1:customsCommodityCode": "4403",
      "countryOfOrigin": "DE",
      "netWeight": {
        "value": "850",
        "unitCode": "KGM"
      },
      "eudr:originDetails": "https://id.gs1.org/414/9521234000099",
      "regulatoryInformation": [
        {
          "regulationType": "DEFORESTATION_REGULATION",
          "regulatoryAct": "EU 2023/1115",
          "regulatoryIdentifierType": "DUE_DILIGENCE_STATEMENT",
          "regulatoryReferenceNumber": "EUIS-2025-DE-00012345"
        }
      ]
    },
    {
      "id": "https://id.gs1.org/414/9521234000099",
      "locationGLN": "9521234000099",
      "physicalLocationName": "Sustainable Oak Forest - Plot 47",
      "geo": {
        "polygon": "[[13.40, 52.51], [13.41, 52.51], [13.41, 52.52], [13.40, 52.52], [13.40, 52.51]]"
      },
      "countryCode": "DE",
      "eudr:forestManagementUnit": "FMU-DE-2024-00123",
      "eudr:areaHectares": 2.5
    },
    {
      "id": "https://id.gs1.org/417/9521234000006",
      "organizationName": "Waldwirtschaft Schmidt GmbH",
      "partyGLN": "9521234000006",
      "countryCode": "DE",
      "dpp:eoriNumber": "DE123456789012345"
    }
  ]
}

Key Fields (V1.11 Pattern):

• bizStep: "notifying" - standard CBV value for regulatory notification
• persistentDisposition: { "set": ["subject_to_regulation"] } - marks product as EUDR-regulated
• masterDataAvailableFor: Top-level array with product, location, and organization master data
• regulatoryInformation: Nested inside the product entry (bare strings, no gs1: prefix)
• Location master data includes geolocation polygon for plot of land

Due Diligence Notification Event

Communicates the Due Diligence Statement reference number after filing with EUIS. Per GS1 Germany EUDR Guideline V1.11, uses masterDataAvailableFor with regulatoryInformation nested inside the product entry using bare strings.

{
  "@context": [
    "https://ref.openepcis.io/extensions/eu/eudr/eudr-context.jsonld",
    "https://ref.gs1.org/standards/epcis/epcis-context.jsonld"
  ],
  "type": "ObjectEvent",
  "eventID": "urn:uuid:550e8400-e29b-41d4-a716-446655440021",
  "eventTime": "2025-01-20T10:00:00.000Z",
  "eventTimeZoneOffset": "+01:00",
  "action": "OBSERVE",
  "bizStep": "notifying",
  "persistentDisposition": {
    "set": [
      "subject_to_regulation"
    ]
  },
  "epcList": [
    "https://id.gs1.org/01/09521234000020/21/LOG-2025-001"
  ],
  "readPoint": {
    "id": "https://id.gs1.org/414/9521234000006"
  },
  "bizTransactionList": [
    {
      "type": "urn:epcglobal:cbv:btt:cert",
      "bizTransaction": "https://example.com/eudr/due-diligence/LOG-2025-001.pdf"
    }
  ],
  "masterDataAvailableFor": [
    {
      "id": "https://id.gs1.org/01/09521234000020/21/LOG-2025-001",
      "eudr:commodityType": "Wood",
      "eudr:timberProductType": "RoundWood",
      "eudr:speciesScientificName": "Quercus robur",
      "eudr:speciesCommonName": "European Oak",
      "gs1:harvestDate": "2025-01-15",
      "countryOfOrigin": "DE",
      "eudr:deforestationFreeDate": "2025-01-15",
      "eudr:legallyHarvested": true,
      "eudr:originDetails": "https://id.gs1.org/414/9521234000099",
      "regulatoryInformation": [
        {
          "regulationType": "DEFORESTATION_REGULATION",
          "regulatoryAct": "EU 2023/1115",
          "regulatoryIdentifierType": "DUE_DILIGENCE_STATEMENT",
          "regulatoryReferenceNumber": "EUIS-2025-DE-00012345",
          "regulatoryReferenceApplicabilityStartDate": "2025-01-20",
          "eudr:riskLevel": "Low",
          "eudr:verificationMethod": "On-site inspection combined with satellite imagery analysis"
        }
      ]
    },
    {
      "id": "https://id.gs1.org/414/9521234000099",
      "locationGLN": "9521234000099",
      "physicalLocationName": "Sustainable Oak Forest - Plot 47",
      "geo": {
        "polygon": "[[13.40, 52.51], [13.41, 52.51], [13.41, 52.52], [13.40, 52.52], [13.40, 52.51]]"
      },
      "countryCode": "DE",
      "eudr:forestManagementUnit": "FMU-DE-2024-00123",
      "eudr:areaHectares": 2.5
    },
    {
      "id": "https://id.gs1.org/417/9521234000006",
      "organizationName": "Waldwirtschaft Schmidt GmbH",
      "partyGLN": "9521234000006",
      "countryCode": "DE",
      "eudr:fscCertification": "https://fsc.org/en/certificate/FSC-C123456"
    }
  ]
}

Reference Tables

Risk Levels

Timber Product Types

Business Transaction Types

Best Practices

1. Use both patterns - EPCIS traceability for supply chain visibility, V1.11 events for EUDR compliance sharing
2. Always link to master data using masterDataAvailableFor
3. Capture geolocation at harvest using sensor reports in commissioning events
4. Use V1.11 pattern (bizStep: "notifying") when sharing EUDR compliance data with partners
5. Include EUIS reference after filing with EU system via gs1:regulatoryIdentifier
6. Link transformation events to maintain full traceability to source commodities
7. Use GS1 demo prefix 952 (7-digit GCP: 9521234) for all test/demo data