DDS Field-Level Mapping: V1 → V4¶

Migration diff showing what changed between V1 (separate Submission + Retrieval services) and V4 (unified DDS service).

Full V4 field reference

For complete type definitions, see DDS V4 API Reference.

Submit Request¶

V1 Field	V4 Field	Change
`operatorType`	`operatorRole`	Renamed; values reduced (see Operator Role below)
`statement`	`statement`	Type restructured (see below)

V1 Field	V4 Field	Change
`ddsIdentifier`	`uuid`	Renamed

V1 Field	V4 Field	Change
`ddsIdentifier`	`uuid`	Renamed
`statement`	`statement`	Type restructured

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

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

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

V1 Field	V4 Field	Change
`referenceNumber`	`operatorReferenceNumber`	Renamed
`nameAndAddress`	`operatorAddress`	Restructured — V1 combined `base:NameAndAddressType` replaced by structured `AddressType` with separate fields
`email`	`operatorEmail`	Renamed
`phone`	`operatorPhone`	Renamed
—	`operatorName`	New — mandatory in V4 (was inside nameAndAddress in V1)

V1 (`base:NameAndAddressType`)	V4 (`eudrCommon:AddressType`)	Change
Combined name+address	—	Removed — split into separate fields
—	`country`	New — explicit country field
—	`street`	New — explicit street field
—	`postalCode`	New — explicit postal code field
—	`city`	New — explicit city field
—	`fullAddress`	New — optional non-structured address

V1 Field	V4 Field	Change
`volume` (`DecimalThreePrecType`)	—	Removed
`netWeight` (`DecimalThreePrecType`)	`netWeight` (`DecimalSixteenTotalSixPrecType`)	Type changed — 3 fraction → 16 total / 6 fraction (0–9999999999.999999)
`supplementaryUnit` (`nonNegativeInteger`)	`supplementaryUnit` (`DecimalSixteenTotalSixPrecType`)	Type changed — integer → decimal 16/6
`supplementaryUnitQualifier` (enum, 60+ values)	`supplementaryUnitQualifier` (`string`, 3-4 chars)	Type changed — fixed enumeration → free-text
—	`percentageEstimationOrDeviation` (`DecimalThreePrecType`)	New

V1	V4	Change
`ScientificNameType` (max 100)	`ScientificNameType` (max 200)	Max length increased from 100 to 200

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

V1 Field	V4 Field	Change
`position`	`position`	Unchanged
`descriptors`	`descriptors`	GoodsMeasure restructured
`hsHeading`	`hsHeading`	Pattern widened from `[0-9]{2,8}` (max 8) to `[0-9]{2,10}` (max 10)
`speciesInfo`	`speciesInfo`	ScientificName max length increased; moved to DDS namespace
`producers`	`producers`	Unchanged structure

V1 Value	V4 Value	Change
`AVAILABLE`	`AVAILABLE`	Unchanged
`SUBMITTED`	`SUBMITTED`	Unchanged
`REJECTED`	`REJECTED`	Unchanged
`CANCELLED`	—	Removed
`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

V4 Addition	Context
`getDds` operation	Query by UUID (replaces `getDdsInfo`)
`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
`percentageEstimationOrDeviation`	Deviation percentage in GoodsMeasure
`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
Simplified Declaration (SD) service	Entirely new service for micro/small primary operators

V1 Item	Reason
`EUDRSubmissionServiceV1`	Merged into `EUDRDueDiligenceStatementServiceV4`
`EUDRRetrievalServiceV1`	Merged into `EUDRDueDiligenceStatementServiceV4`
`TRADE` activity type	Traders no longer submit DDS
`TRADER` / `REPRESENTATIVE_TRADER` roles	Traders excluded from DDS submission
`volume` in GoodsMeasure	Removed — use netWeight or supplementaryUnit
`nameAndAddress` combined type	Replaced by structured `operatorAddress` + `operatorName`
`SupplementaryUnitQualifier` enum (60+ values)	Replaced by free-text string (3-4 chars)
`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