Skip to content

Change Log

V3 API Changes (post-amendment release)

New in V3

  • Simplified Declaration service: New EUDRSimplifiedDeclarationServiceV3 with 6 operations (submitSd, updateSd, withdrawSd, getSd, getSdByInternalReference, getSdByIdentifiers) for MSPOs, authorised representatives, and Member States (Art 4a(4)).
  • Declaration versioning: getSd and getDds accept an optional version parameter to retrieve a specific version. Responses include a version field.
  • New status values: EudrStatusType now includes SUSPENDED, UPDATED, GROUPED, and OBSOLETE alongside existing values. SUSPENDED and UPDATED are not active in the current release.
  • New event types: EudrEventType includes GROUPED, SUSPENDED, UPDATED, ACCEPTED in addition to existing event types.
  • SD reference number format: 14 characters starting with S (e.g., S26FRNMNBSA96Q), same length as DDS but with the S prefix distinguishing the type.
  • Postal address for SD: Simplified declarations may use postal address instead of GeoJSON geolocation for plots of land.

Changed from V2

  • Namespace: DDS service namespace changed to http://ec.europa.eu/tracesnt/certificate/eudr/due-diligence-statement/v3
  • Endpoint: DDS changed to /tracesnt/ws/EUDRDueDiligenceStatementServiceV3
  • Operator identification: EconomicOperatorIdentificationType replaces the previous operator reference structure. Supports multiple identifier types (EORI, VAT, TIN, etc.).

Breaking changes

  • V2 clients must update their WSDL/XSD bindings to the V3 namespace and endpoint.
  • New enum values in EudrStatusType and EudrEventType may require client-side updates to avoid unmarshalling errors.
  • DDS amend/withdraw responses now return uuid and status (lifecycle status such as AVAILABLE or WITHDRAWN). Previously returned only a status string (SC_200_OK). Response parsing must be updated.
  • Response structure changes in operator and commodity type definitions.

Authentication

  • Current: WS-Security (UsernameToken with PasswordDigest over HTTPS), unchanged from V2.
  • Future: mTLS-based authentication is planned for a subsequent release. The current UsernameToken mechanism will be maintained during a transition period.

Regulatory Background (2025 Amendment)

Simplified Declaration (New Article 4a)

  • Micro or small primary operators submit a one-time simplified declaration (not per-shipment DDS)
  • Information system assigns a declaration identifier upon submission
  • Content requirements defined in new Annex III
  • May use postal address instead of geolocation for plots of land (Art 4a(5))
  • Exemption where equivalent data already in national databases (Art 4a(4))

Downstream Operator & Trader Obligations (New Article 5)

  • Non-SME downstream operators and non-SME traders must register in information system
  • All downstream operators/traders must collect and keep: supplier info, DDS reference numbers or declaration identifiers, buyer info
  • First downstream operator/trader ensures traceability by collecting reference numbers
  • 5-year record retention
  • Notification obligations on non-compliance

Modified Operator Definition (Art 2(15))

  • Operator now explicitly excludes downstream operators
  • Authorised representatives can now submit simplified declarations on behalf of micro/small primary operators (Art 6)
Back to top