DDS Field-Level Mapping: V2 → V4¶

Migration diff showing what changed between V2 (EUDRSubmissionServiceV2) and V4 (EUDRDueDiligenceStatementServiceV4).

Full V4 field reference

For complete type definitions, constraints, and documentation, see DDS V4 API Reference.

Namespace change: http://ec.europa.eu/tracesnt/certificate/eudr/submission/v2 → http://ec.europa.eu/tracesnt/certificate/eudr/due-diligence-statement/v4

Submit Request¶

V2 Field	V4 Field	Change
`operatorType`	`operatorRole`	Renamed; values changed (see Operator Role below)
`statement`	`statement`	Type moved to DDS-specific namespace

Submit Response¶

V2 Field	V4 Field	Change
`ddsIdentifier`	`uuid`	Renamed

Amend Request¶

V2 Field	V4 Field	Change
`ddsIdentifier`	`uuid`	Renamed
`statement`	`statement`	Type moved to DDS-specific namespace

Retract → Withdraw Request¶

V2 Field	V4 Field	Change
`ddsIdentifier`	`uuid`	Renamed; operation renamed from `retractDds` to `withdrawDds`

DueDiligenceStatementBaseType¶

V2 Field	V4 Field	Change
`internalReferenceNumber`	`internalReferenceNumber`	Type `InternalReferenceNumberType`, max length 50
`activityType`	`activityType`	`TRADE` value removed
`operator`	`representedOperator`	Renamed — now only for represented operator when role is representative
`countryOfActivity`	`countryOfActivity`	Type renamed to common namespace
`borderCrossCountry`	`borderCrossCountry`	Type renamed to common namespace
`comment`	`comment`	Unchanged
`commodities`	`commodities`	Type renamed to `DdsCommodityType`
`geoLocationConfidential`	`geoLocationConfidential`	Unchanged
`associatedStatements`	`groupedDeclarations`	Renamed — now uses `GroupedDeclarationsType` with `groupedDeclaration` reference numbers (max 2000)

Operator Role Values¶

V2 Value	V4 Value	Change
`OPERATOR`	`OPERATOR`	Unchanged
`REPRESENTATIVE_OPERATOR`	`REPRESENTATIVE_OPERATOR`	Unchanged
`TRADER`	—	Removed — traders subject to collect-and-keep obligation
`REPRESENTATIVE_TRADER`	—	Removed

Activity Type Values¶

V2 Value	V4 Value	Change
`DOMESTIC`	`DOMESTIC`	Unchanged
`IMPORT`	`IMPORT`	Unchanged
`EXPORT`	`EXPORT`	Unchanged
`TRADE`	—	Removed — traders no longer submit DDS

Operator Identification¶

V2 Field	V4 Field	Change
`referenceNumber`	`operatorReferenceNumber`	Renamed
`operatorAddress`	`operatorAddress`	Type restructured (see Address below)
`email`	`operatorEmail`	Renamed
`phone`	`operatorPhone`	Renamed
—	`operatorName`	New — mandatory in V4

Address Type¶

V2 Field	V4 Field	Change
`name`	—	Removed — moved to `operatorName` at parent level
`country`	`country`	Type moved to common namespace
`street`	`street`	Unchanged
`postalCode`	`postalCode`	Unchanged
`city`	`city`	Unchanged
`fullAddress`	`fullAddress`	Unchanged

Commodity Type¶

V2 Field	V4 Field	Change
`position`	`position`	Unchanged
`descriptors`	`descriptors`	Type moved to common namespace
`hsHeading`	`hsHeading`	Type moved to common namespace; pattern widened from `[0-9]{2,8}` (max 8) to `[0-9]{2,10}` (max 10)
`speciesInfo`	`speciesInfo`	Type moved to DDS namespace
`producers`	`producers`	Type renamed to `DdsProducerType`

Producer Type¶

V2 Field	V4 Field	Change
`position`	`position`	Unchanged
`country`	`country`	Type moved to common namespace
`name`	`name`	Unchanged
`geometryGeojson`	`geometryGeojson`	Unchanged

Status Values¶

V2 Value	V4 Value	Change
`AVAILABLE`	`AVAILABLE`	Unchanged
`SUBMITTED`	`SUBMITTED`	Unchanged
`REJECTED`	`REJECTED`	Unchanged
`CANCELLED`	—	Removed from external status
`WITHDRAWN`	`WITHDRAWN`	Unchanged
`ARCHIVED`	`ARCHIVED`	Unchanged
—	`SUSPENDED`	New — not active in current release
—	`UPDATED`	New — not active in current release
—	`GROUPED`	New — grouped declaration status
—	`OBSOLETE`	New — superseded declaration

New in V4 (No V2 Equivalent)¶

V4 Addition	Context
`getDds` operation	Query by UUID
`getDdsByInternalReference` operation	Query by internal reference
`getDdsByIdentifiers` operation	Defined in the schema, but in V4 it no longer returns content — always faults with `NotFoundException` ("Statement detail access is possible only over UI"); detail retrieval is UI-only
`NotFoundException` fault	For query operations
`operatorName` field	Mandatory operator name
`groupedDeclarations` field	References to previously submitted DDS/SD for grouping
`referenceNumberInfo` field	Optional human-readable reference-number status on overview responses (`OverviewType`)
`summaryAddress` field	Optional `SummaryAddressType` (`name` + `country`) on `EconomicOperatorIdentificationType`
`EudrUserMessage` response header	Optional header (`EudrUserMessageType`, max 2000) carrying EUDR announcements
`GROUPED` status	Grouped declaration lifecycle
`OBSOLETE` status	Superseded declaration
`SUSPENDED` / `UPDATED` status	Not active in current release
`rejectionReason` in response	CA rejection reason
`communicationToOperator` in response	CA message to operator

Removed in V4¶

V2 Item	Reason
`TRADE` activity type	Traders no longer submit DDS
`TRADER` / `REPRESENTATIVE_TRADER` roles	Traders excluded from DDS submission
`ship_man_comp_imo`, `ship_reg_owner_imo`, `remos` identifiers	Removed (maritime/REMOS, not EUDR-relevant). V4 retains 10 types: eori, vat, gln, tin, cbr, cin, duns, comp_num, comp_reg, oni
`CANCELLED` status	Removed from external enumeration
`name` in AddressType	Moved to `operatorName` at parent level