📥 Download as PDF

DDS Field-Level Mapping: V1 → V3

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

Full V3 field reference

For complete type definitions, see DDS V3 API Reference.

---

Submit Request

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

---

Submit Response

V1 Field	V3 Field	Change
ddsIdentifier	uuid	Renamed

---

Amend Request

V1 Field	V3 Field	Change
ddsIdentifier	uuid	Renamed
statement	statement	Type restructured

---

Retract → Withdraw Request

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

---

Operator Role Values

V1 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

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

---

Operator Identification

V1 Field	V3 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 V3 (was inside nameAndAddress in V1)

---

Address Type

V1 (base:NameAndAddressType)	V3 (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

---

GoodsMeasure Type

V1 Field	V3 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

---

ScientificName Type

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

---

Statement Payload (DueDiligenceStatementBaseType)

V1 Field	V3 Field	Change
internalReferenceNumber (max 50)	internalReferenceNumber (max 35)	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 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)

---

Commodity / Producer

V1 Field	V3 Field	Change
position	position	Unchanged
descriptors	descriptors	GoodsMeasure restructured
hsHeading	hsHeading	Unchanged
speciesInfo	speciesInfo	ScientificName max length increased; moved to DDS namespace
producers	producers	Unchanged structure

---

Status Values

V1 Value	V3 Value	Change
AVAILABLE	AVAILABLE	Unchanged
SUBMITTED	SUBMITTED	Unchanged
REJECTED	REJECTED	Unchanged
CANCELLED	—	Removed
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 V1 Equivalent)

V3 Addition	Context
getDds operation	Query by UUID (replaces getDdsInfo)
getDdsByInternalReference operation	Query by internal reference
getDdsByIdentifiers operation	Query by reference + verification number
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
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

---

Removed in V3

V1 Item	Reason
EUDRSubmissionServiceV1	Merged into EUDRDueDiligenceStatementServiceV3
EUDRRetrievalServiceV1	Merged into EUDRDueDiligenceStatementServiceV3
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). V3 retains 10 types: eori, vat, gln, tin, cbr, cin, duns, comp_num, comp_reg, oni
CANCELLED status	Removed from external enumeration