SD Field-Level Mapping: V3 → V4
Migration diff showing what changed between V3 and V4 for the Simplified Declaration service.
Full V4 field reference
For complete type definitions, constraints, and documentation, see the
SD V4 API Reference.
Namespace changes:
.../simplified-declaration/v3 → .../simplified-declaration/v4
.../eudr/common/v3 → .../eudr/common/v4
.../tracesnt/body/v3 → .../tracesnt/body/v4 (base header namespace .../sanco/tracesnt/base/v4 unchanged)
SD
SimplifiedDeclarationBaseType
| V3 Field |
V4 Field |
Change |
internalReferenceNumber (type ReferenceNumberType, max 14) |
internalReferenceNumber (type InternalReferenceNumberType, max 50) |
Type widened — mandatory in both versions; max length increased from 14 to 50 |
SdOperatorRoleType (submitSd operatorRole)
| V3 Values |
V4 Values |
Change |
MICRO_OPERATOR, REPRESENTATIVE_MSPO |
MICRO_OPERATOR, REPRESENTATIVE_MSPO, MEMBER_STATE |
New MEMBER_STATE value for Member State submission under Article 4a(4) |
All other SD commodity and producer fields are unchanged from V3.
Common model (eudr-common)
OverviewType (returned by all overview get* operations)
| V4 Field |
Change |
referenceNumberInfo |
New — optional human-readable reference-number status ("Under system analysis" / "Under Competent Authority review (Article 17)" / "Assigned") |
EconomicOperatorIdentificationType
| V4 Field |
Change |
summaryAddress |
New — optional SummaryAddressType (name, country) for summary display |
New common types
| Type |
Purpose |
SummaryAddressType |
Abbreviated address (name, country) used by summaryAddress |
EudrUserMessageType |
User-facing message (max 2000) returned in SOAP response headers |
Operation behaviour
| Operation |
V3 |
V4 |
getSdByIdentifiers |
Returns full declaration content |
Returns NotFoundException ("Declaration detail access is possible only over UI") |