---
title: "EUDR Event Types"
description: "EPCIS event types for EU Deforestation Regulation compliance"
canonical_url: "https://openepcis.io/docs/digital-product-passport/eudr/event-types"
last_updated: "2026-07-02T20:31:49.891Z"
---

<alert type="info">

**Masterdata and events** — `masterDataAvailableFor` is GS1 Web Vocabulary (no `gs1:` prefix needed). It is used to carry **lot- or serial-level masterdata** alongside an event: production batch, declaration references, incident records, regulatory citations. It must **not** carry **GTIN-level masterdata** (product name, generic specifications) — those live on the resolver, POSTed once via `POST /products/{gtin}`. Extension vocabularies (`battery:`, `eudr:`, `textile:`, `electronics:`) keep their prefix; they are declared in the document's `@context`.

</alert>

# 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)

<table>
<thead>
  <tr>
    <th>
      Event
    </th>
    
    <th>
      Type
    </th>
    
    <th>
      Action
    </th>
    
    <th>
      bizStep
    </th>
    
    <th>
      Purpose
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Harvesting
    </td>
    
    <td>
      ObjectEvent
    </td>
    
    <td>
      ADD
    </td>
    
    <td>
      <code>
        commissioning
      </code>
    </td>
    
    <td>
      Record commodity creation at production plot
    </td>
  </tr>
  
  <tr>
    <td>
      Shipping
    </td>
    
    <td>
      ObjectEvent
    </td>
    
    <td>
      OBSERVE
    </td>
    
    <td>
      <code>
        shipping
      </code>
    </td>
    
    <td>
      Record dispatch to next supply chain partner
    </td>
  </tr>
  
  <tr>
    <td>
      Receiving
    </td>
    
    <td>
      ObjectEvent
    </td>
    
    <td>
      OBSERVE
    </td>
    
    <td>
      <code>
        receiving
      </code>
    </td>
    
    <td>
      Confirm receipt of goods
    </td>
  </tr>
  
  <tr>
    <td>
      Processing
    </td>
    
    <td>
      TransformationEvent
    </td>
    
    <td>
      -
    </td>
    
    <td>
      <code>
        commissioning
      </code>
    </td>
    
    <td>
      Transform commodities into derived products
    </td>
  </tr>
</tbody>
</table>

### V1.11 Compliance Events (GS1 Germany Guideline)

<table>
<thead>
  <tr>
    <th>
      Event
    </th>
    
    <th>
      Type
    </th>
    
    <th>
      Action
    </th>
    
    <th>
      bizStep
    </th>
    
    <th>
      persistentDisposition
    </th>
    
    <th>
      Purpose
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Origin Declaration
    </td>
    
    <td>
      ObjectEvent
    </td>
    
    <td>
      OBSERVE
    </td>
    
    <td>
      <code>
        notifying
      </code>
    </td>
    
    <td>
      <code>
        subject_to_regulation
      </code>
    </td>
    
    <td>
      Share origin/geolocation data for EUDR
    </td>
  </tr>
  
  <tr>
    <td>
      Due Diligence Notification
    </td>
    
    <td>
      ObjectEvent
    </td>
    
    <td>
      OBSERVE
    </td>
    
    <td>
      <code>
        notifying
      </code>
    </td>
    
    <td>
      <code>
        subject_to_regulation
      </code>
    </td>
    
    <td>
      Communicate DDS reference number
    </td>
  </tr>
</tbody>
</table>

---

## 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.

```json
{
  "@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.

```json
{
  "@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:**

```json
{
  "@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:**

```json
{
  "@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](https://www.gs1-germany.de/branchen-themen/nachhaltigkeit/eu-deforestation-regulation-eudr/), 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.

```json
{
  "@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.

```json
{
  "@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

<table>
<thead>
  <tr>
    <th>
      Level
    </th>
    
    <th>
      When to Use
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        eudr:Negligible
      </code>
    </td>
    
    <td>
      Derived from already-verified low-risk sources
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        eudr:Low
      </code>
    </td>
    
    <td>
      Low-risk country, verified documentation
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        eudr:Standard
      </code>
    </td>
    
    <td>
      Standard due diligence required
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        eudr:High
      </code>
    </td>
    
    <td>
      Enhanced verification and monitoring needed
    </td>
  </tr>
</tbody>
</table>

### Timber Product Types

<table>
<thead>
  <tr>
    <th>
      Type
    </th>
    
    <th>
      Description
    </th>
    
    <th>
      HS Code
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        eudr:RoundWood
      </code>
    </td>
    
    <td>
      Raw logs
    </td>
    
    <td>
      4403
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        eudr:SawnWood
      </code>
    </td>
    
    <td>
      Processed lumber
    </td>
    
    <td>
      4407
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        eudr:Plywood
      </code>
    </td>
    
    <td>
      Layered wood panels
    </td>
    
    <td>
      4412
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        eudr:Veneer
      </code>
    </td>
    
    <td>
      Thin wood sheets
    </td>
    
    <td>
      4408
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        eudr:WoodPellets
      </code>
    </td>
    
    <td>
      Compressed wood fuel
    </td>
    
    <td>
      4401
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        eudr:WoodChips
      </code>
    </td>
    
    <td>
      Wood chips and particles
    </td>
    
    <td>
      4401
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        eudr:Pulp
      </code>
    </td>
    
    <td>
      Wood pulp for paper
    </td>
    
    <td>
      47xx
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        eudr:Paper
      </code>
    </td>
    
    <td>
      Paper products
    </td>
    
    <td>
      48xx
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        eudr:Furniture
      </code>
    </td>
    
    <td>
      Finished furniture
    </td>
    
    <td>
      94xx
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        eudr:Charcoal
      </code>
    </td>
    
    <td>
      Wood charcoal
    </td>
    
    <td>
      4402
    </td>
  </tr>
</tbody>
</table>

### Business Transaction Types

<table>
<thead>
  <tr>
    <th>
      Type
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        urn:epcglobal:cbv:btt:po
      </code>
    </td>
    
    <td>
      Purchase Order
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        urn:epcglobal:cbv:btt:desadv
      </code>
    </td>
    
    <td>
      Despatch Advice
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        urn:epcglobal:cbv:btt:recadv
      </code>
    </td>
    
    <td>
      Receiving Advice
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        urn:epcglobal:cbv:btt:cert
      </code>
    </td>
    
    <td>
      Certificate/Document
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        urn:epcglobal:cbv:btt:prodorder
      </code>
    </td>
    
    <td>
      Production Order
    </td>
  </tr>
</tbody>
</table>

## 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