DDS Field-Level Mapping: V2 → V3¶

Migration diff showing what changed between V2 (EUDRSubmissionServiceV2) and V3 (EUDRDueDiligenceStatementServiceV3).

Full V3 field reference

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

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

Submit Request¶

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

Submit Response¶

V2 Field	V3 Field	Change
`ddsIdentifier`	`uuid`	Renamed

Amend Request¶

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

Retract → Withdraw Request¶

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

DueDiligenceStatementBaseType¶

V2 Field	V3 Field	Change
`internalReferenceNumber`	`internalReferenceNumber`	Max length reduced from 50 to 35
`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	V3 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	V3 Value	Change
`DOMESTIC`	`DOMESTIC`	Unchanged
`IMPORT`	`IMPORT`	Unchanged
`EXPORT`	`EXPORT`	Unchanged
`TRADE`	—	Removed — traders no longer submit DDS

Operator Identification¶

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

Address Type¶

V2 Field	V3 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	V3 Field	Change
`position`	`position`	Unchanged
`descriptors`	`descriptors`	Type moved to common namespace
`hsHeading`	`hsHeading`	Type moved to common namespace
`speciesInfo`	`speciesInfo`	Type moved to DDS namespace
`producers`	`producers`	Type renamed to `DdsProducerType`

Producer Type¶

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

Status Values¶

V2 Value	V3 Value	Change
`AVAILABLE`	`AVAILABLE`	Unchanged
`SUBMITTED`	`SUBMITTED`	Unchanged
`REJECTED`	`REJECTED`	Unchanged
`CANCELLED`	—	Removed from external status
`WITHDRAWN`	`WITHDRAWN`	Unchanged
`ARCHIVED`	`ARCHIVED`	Unchanged
—	`DRAFT`	New
—	`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 V3 (No V2 Equivalent)¶

V3 Addition	Context
`getDds` operation	Query by UUID
`getDdsByInternalReference` operation	Query by internal reference
`getDdsByIdentifiers` operation	Query by reference + verification number
`NotFoundException` fault	For query operations
`operatorName` field	Mandatory operator name
`groupedDeclarations` field	References to previously submitted DDS/SD for grouping
`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 V3¶

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). V3 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