OpenEPCIS EUDR Vocabulary

Supports EU Deforestation Regulation 2023/1115 compliance: origin traceability back to the plot of land, harvest dates, species identification, and Due Diligence Statement linking — building on the official GS1 EUDR Standard.

Version 0.9.5https://ref.openepcis.io/extensions/eu/eudr/

TTL JSON-LD Schema SHACL All Artefacts

Community implementation - not official GS1 guidance

This vocabulary builds on GS1 standards (Digital Link, EPCIS 2.0, Web Vocabulary) but extends them with properties not yet defined by GS1. The GS1 DPP Provisional Standard is still under development. Our extensions may be superseded by official GS1 terms as they emerge. Feedback welcome!

About this vocabulary

The EUDR Vocabulary supports EU Deforestation Regulation (EUDR) 2023/1115 compliance. The regulation requires operators to ensure that seven commodities (cattle, cocoa, coffee, oil palm, rubber, soya, wood) and their derived products are deforestation-free and legally harvested, with traceability back to the plot of land where they were produced.

Built on the official GS1 EUDR Standard (provisional), which provides RegulatoryNotification for B2B sharing of Due Diligence Statement reference numbers. We also use GS1 Place with GeoShape for geolocation, Organization, and QuantitativeValue. The GS1 EUDR Standard focuses on B2B messaging and does not define origin master data like harvest dates, species names, or detailed plot information — our extensions fill this gap.

A timber importer can track each shipment back to its specific forest plot (GLN with polygon coordinates), harvest date, species (e.g. Quercus robur), and link it to a Due Diligence Statement reference number in the EU Information System.

Class	Description	Subclass Of
DueDiligenceStatement Due Diligence Statement	A due diligence statement submitted to the EUDR Information System (EUIS) per Article 4.	-
ExemptionDeclaration Exemption Declaration	A structured declaration that specific products (or batches/serials) are exempt from EUDR due diligence obligations, carrying the exemption type, reason code, scope, and effective date range.	-
OriginDetails Origin Details	Container class for geolocation and producer identification information per EUDR Article 9.	-
RiskAssessment Risk Assessment	Risk assessment results per EUDR Article 10.	-

Usage examples

GS1 Regulatory Notification

B2B message sharing Due Diligence Statement reference using official GS1 EUDR Standard.

{
  "@context": "https://ref.gs1.org/standards/eudr/context.jsonld",
  "type": "RegulatoryNotification",
  "messageSender": { "partyGLN": "9521234000006" },
  "messageRecipient": { "partyGLN": "9521234000105" },
  "regulatoryInformation": {
    "regulatoryAct": "EU 2023/1115",
    "regulationType": "DEFORESTATION_REGULATION",
    "regulatoryIdentifier": {
      "regulatoryIdentifierType": "DUE_DILIGENCE_STATEMENT",
      "regulatoryReferenceNumber": "EUIS-2025-DE-00012345",
      "regulatoryVerificationNumber": "VN-2025-DE-00012345",
      "regulatoryInformationProvider": { "partyGLN": "9521234000006" },
      "regulatoryReferenceApplicabilityStartDate": "2025-01-20",
      "regulatoryReferenceApplicabilityEndDate": "2026-01-20",
      "applicableProducts": [{ "gtin": "09521234000020", "hasBatchLotNumber": "BATCH-2025-01" }]
    }
  }
}

Plot of Land with Geolocation

Production plot master data with polygon coordinates for EUDR traceability.

{
  "type": "Place",
  "id": "https://id.gs1.org/414/9521234000099",
  "locationGLN": "9521234000099",
  "physicalLocationName": [{
    "@value": "Sustainable Oak Forest - Plot 47",
    "@language": "en"
  }],
  "geo": {
    "type": "GeoShape",
    "polygon": "[[13.40, 52.51], [13.41, 52.51], [13.41, 52.52], [13.40, 52.52], [13.40, 52.51]]"
  },
  "countryOfOrigin": {
    "type": "Country",
    "countryCode": "DE"
  },
  "areaSize": {
    "type": "AreaMeasurement",
    "value": 4.5,
    "unitCode": "HAR"
  }
}

Timber Product with Origin

Wood product with harvest date, species, and link to production plot.

{
  "@context": "https://ref.openepcis.io/extensions/eu/eudr/eudr-context.jsonld",
  "id": "https://id.gs1.org/01/09521234000020/21/LOG-2025-001",
  "type": "Product",
  "productName": "European Oak Lumber",
  "speciesScientificName": "Quercus robur",
  "speciesCommonName": "European Oak",
  "commodityType": "Wood",
  "harvestDate": "2025-03-15",
  "sourceLocation": {
    "id": "https://id.gs1.org/414/9521234000099"
  },
  "deforestationFreeDate": "2020-12-31",
  "legallyHarvested": true
}

EPCIS Due Diligence Statement Event

EPCIS ObjectEvent with bizStep 'notifying' carrying the DDS reference/verification numbers via gs1:masterDataAvailableFor, per GS1 EUDR Standard §5.2.

{
  "@context": [
    "https://ref.openepcis.io/extensions/eu/eudr/eudr-context.jsonld",
    "https://ref.gs1.org/standards/epcis/epcis-context.jsonld"
  ],
  "type": "ObjectEvent",
  "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" },
  "bizLocation": { "id": "https://id.gs1.org/414/9521234000006" },
  "gs1:masterDataAvailableFor": [{
    "id": "https://id.gs1.org/01/09521234000020/21/LOG-2025-001",
    "productName": { "en": "European Oak Round Wood - Grade A" },
    "countryOfOrigin": { "countryCode": "DE" },
    "harvestDate": "2025-01-15",
    "regulatoryInformation": [{
      "regulationType": "DEFORESTATION_REGULATION",
      "regulatoryAct": "EU 2023/1115",
      "isRegulationCompliant": true,
      "regulatoryIdentifier": [{
        "regulatoryReferenceNumber": "EUIS-2025-DE-00012345",
        "regulatoryVerificationNumber": "VN-2025-DE-00012345",
        "regulatoryIdentifierType": "DUE_DILIGENCE_STATEMENT",
        "regulatoryInformationProvider": "https://id.gs1.org/417/9521234000006",
        "regulatoryReferenceApplicabilityStartDate": "2025-01-20",
        "regulatoryReferenceApplicabilityEndDate": "2026-01-20"
      }]
    }]
  }]
}

Example files

Complete JSON-LD documents shipped with the vocabulary. Click a file to view the raw payload.

Master data & product examples

plot-of-land.jsonld
Location master data for a plot of land using gs1:Place with gs1:GeoShape. EUDR-specific properties use eudr: extensions. Uses GS1 demo prefix 952 (7-digit GCP: 9521234).
regulatory-notification.jsonld
gs1:RegulatoryNotification message per GS1 EUDR Standard. This B2B message shares Due Diligence Statement references between supply chain partners. Structure matches GS1 EUDR-tool output (https://github.com/gs1/EUDR-tool). Uses GS1 demo prefix 952.
timber-derived.jsonld
timber-product.jsonld
Product master data using standard GS1 vocabulary. EUDR-specific properties (species, harvest) use eudr: extensions. Uses GS1 demo prefix 952 (7-digit GCP: 9521234).

EPCIS 2.0 events

due-diligence-statement.jsonld
exemption-declaration.jsonld
A downstream operator (Waldwirtschaft Schmidt GmbH) declares a temporary exemption for a specific batch of European Oak round wood, asserting that the batch originated from already-verified low-risk sources per EUDR Article 2.17 (downstream operator simplified due diligence). The exemption is scoped to batch LOT-2026-Q1-0042 and valid from 2026-04-15 to 2026-07-15.
harvesting.jsonld
origin-declaration.jsonld
processing.jsonld
supply-chain-transfer.jsonld

Quick start

For B2B notifications, use the official GS1 EUDR context. For origin master data (harvest dates, species, plot details), add the OpenEPCIS EUDR context. Use gs1:Place with gs1:GeoShape for production plot geolocation; the plot GLN rides in EPCIS native readPoint / bizLocation rather than a shadow property. Declare the extension via the GS1-Extensions header so an OpenEPCIS EPCIS Repository can activate EUDR-specific validation and query shortcuts.

Context URL

https://ref.openepcis.io/extensions/eu/eudr/eudr-context.jsonld

{
  "@context": "https://ref.openepcis.io/extensions/eu/eudr/eudr-context.jsonld",
  "id": "https://id.gs1.org/01/09521234000020/21/LOG-2025-001",
  "type": "Product",
  "speciesScientificName": "Quercus robur",
  "harvestDate": "2025-03-15",
  "sourceLocation": {
    "id": "https://id.gs1.org/414/9521234000099"
  }
}

Regulatory context

EUDR 2023/1115 — EU Deforestation Regulation requiring due diligence for seven commodity categories
GS1 EUDR Standard — Official GS1 standard for B2B regulatory notifications with DDS reference sharing

Download Artefacts Full Documentation