Simplified Declaration (SD) — V4 API Reference¶
Service: EUDRSimplifiedDeclarationServiceV4
Namespace: http://ec.europa.eu/tracesnt/certificate/eudr/simplified-declaration/v4
Endpoint: /tracesnt/ws/EUDRSimplifiedDeclarationServiceV4
Security: WS-Security (UsernameToken over HTTPS)
Overview¶
EUDR Simplified Declaration (SD) service for micro or small primary operators pursuant to Regulation. A simplified declaration is a one-time submission in the Information System by micro or small primary operators, containing the information set out in Annex III of the EUDR Amendment Regulation 2025/2650, submitted before placing relevant products on the market or exporting them. It replaces the per-shipment due diligence statement for eligible operators. A micro or small primary operator is an operator who is a natural person or micro/small undertaking established in a low-risk country, who places on market or exports relevant products they themselves produced in that country. Upon submission, the Information System assigns a declaration identifier which accompanies relevant products through the supply chain in place of a DDS reference number.
Operations¶
submitSd¶
Submit a new Simplified Declaration. This is a one-time submission — micro or small primary operators submit a single simplified declaration covering all relevant products they produce, rather than a per-shipment due diligence statement. The declaration remains valid indefinitely unless major changes occur. Accepts optional SD-only references for grouping; DDS references are rejected. Referenced declarations receive GROUPED status. Role: MSPO (micro or small primary operator) or authorised representative acting for MSPO. Returns the declaration identifier assigned by the Information System.
- Request:
SubmitSdRequest(Type:SubmitSdRequestType) - Response:
SubmitSdResponse(Type:SubmitSdResponseType) - Faults:
BusinessRulesValidationException,PermissionDeniedException
updateSd¶
Update an existing Simplified Declaration. The SD may be updated following major changes to the information provided. Re-triggers risk profiling — the identification of risks of non-compliance based on risk criteria for the purpose of assigning a risk status. Blocked if the SD is under active checks by competent authorities or not in available status.
- Request:
UpdateSdRequest(Type:UpdateSdRequestType) - Response:
UpdateSdResponse(Type:SdModificationResponseType) - Faults:
BusinessRulesValidationException,PermissionDeniedException,NotFoundException
withdrawSd¶
Withdraw a Simplified Declaration. Blocked if the SD is not in available status — a lifecycle state assigned when the SD has been associated to a grouped declaration. Also blocked if the SD is under active checks by competent authorities.
- Request:
WithdrawSdRequest(Type:WithdrawSdRequestType) - Response:
WithdrawSdResponse(Type:SdModificationResponseType) - Faults:
BusinessRulesValidationException,PermissionDeniedException,NotFoundException
getSd¶
Retrieve SD overview (status, declaration identifier, and verification number) by providing the UUID assigned by the Information System. A declaration that does not exist, one whose verification number does not match, and one the caller is not allowed to see all return the same NotFoundException (EUDR_WEBSERVICE_SD_NOT_FOUND_OR_NO_ACCESS), so the response does not reveal whether the declaration exists. When a version number is given, that historical version of the declaration is returned.
- Request:
GetSdRequest(Type:GetSdRequestType) - Response:
GetSdResponse(Type:SdOverviewResponseType) - Faults:
NotFoundException
getSdByInternalReference¶
Retrieve SD overview (status, declaration identifier, and verification number) by providing the internal reference number assigned by the operator's own system.
- Request:
GetSdByInternalReferenceRequest(Type:GetSdByInternalReferenceRequestType) - Response:
GetSdByInternalReferenceResponse(Type:SdOverviewResponseType) - Faults:
NotFoundException
getSdByIdentifiers¶
Discontinued as an API operation. The getSdByIdentifiers API operation has been discontinued. This feature is now available exclusively through our web application UI and only to the non-SME Downstream Operator or Trader role.
- Request:
GetSdByIdentifiersRequest(Type:GetSdByIdentifiersRequestType) - Response:
GetSdByIdentifiersResponse(Type:GetSdByIdentifiersResponseType) - Faults:
NotFoundException,PermissionDeniedException
Types¶
SubmitSdRequestType¶
Initial submission of a Simplified Declaration pursuant to Regulation. A simplified declaration is a one-time submission by micro or small primary operators, containing the information set out in Annex III, submitted before placing relevant products on the market or exporting them. Replaces the per-shipment due diligence statement for eligible operators. The declaration remains valid indefinitely unless major changes occur. Accepts optional SD-only references for grouping; DDS references are rejected. The Information System assigns a declaration identifier upon successful submission.
| Field | Type | Required | Description |
|---|---|---|---|
operatorRole |
SdOperatorRoleType |
Yes | — |
statement |
SimplifiedDeclarationBaseType |
Yes | — |
SubmitSdResponseType¶
Response containing the declaration identifier — the unique identifier assigned by the Information System to the micro or small primary operator upon submission of a simplified declaration. Accompanies relevant products through the supply chain in place of a DDS reference number.
| Field | Type | Required | Description |
|---|---|---|---|
sdIdentifier |
UuidType |
Yes | — |
UpdateSdRequestType¶
Update a Simplified Declaration. Re-triggers risk profiling. Blocked if the SD is not in available status.
| Field | Type | Required | Description |
|---|---|---|---|
sdIdentifier |
UuidType |
Yes | — |
statement |
SimplifiedDeclarationBaseType |
Yes | — |
WithdrawSdRequestType¶
Withdraw a Simplified Declaration. Blocked if the SD is not in available status — a lifecycle state assigned when associated to a grouped declaration. Also blocked if under active checks by competent authorities.
| Field | Type | Required | Description |
|---|---|---|---|
sdIdentifier |
UuidType |
Yes | — |
SdModificationResponseType¶
Response for update/withdraw operations, containing the resulting SD lifecycle status.
| Field | Type | Required | Description |
|---|---|---|---|
uuid |
UuidType |
Yes | — |
version |
integer |
No | — |
status |
EudrStatusType |
Yes | — |
GetSdRequestType¶
Request to retrieve SD overview by one or more UUIDs and optional version number.
| Field | Type | Required | Description |
|---|---|---|---|
uuidAndVersionNumberList |
UuidAndVersionNumberType |
Yes | — |
GetSdByInternalReferenceRequestType¶
Request to retrieve SD overview by the internal reference number from the operator's own system.
| Field | Type | Required | Description |
|---|---|---|---|
internalReference |
InternalReferenceNumberType |
Yes | — |
SdOverviewResponseType¶
Response containing SD overview information: UUID, internal reference, declaration identifier, verification number, lifecycle status, and optional rejection reason or communication from competent authority.
| Field | Type | Required | Description |
|---|---|---|---|
sdOverviewList |
OverviewType |
No | — |
GetSdByIdentifiersRequestType¶
Retrieving full SD content over the API is no longer supported. Declaration detail access is possible only over the UI. This type is retained in the schema only to preserve API contract compatibility.
| Field | Type | Required | Description |
|---|---|---|---|
referenceAndVerificationNumber |
ReferenceAndVerificationNumberType |
Yes | — |
GetSdByIdentifiersResponseType¶
Response type retained only for binding compatibility. It is never populated: retrieving SD content over the API is no longer supported and the operation always returns a NotFoundException. Detail retrieval is available only over the UI.
| Field | Type | Required | Description |
|---|---|---|---|
statement |
SimplifiedDeclarationBaseType |
Yes | — |
SimplifiedDeclarationBaseType¶
Core payload of a Simplified Declaration pursuant to the Regulation. Contains the information set out in Annex III for micro or small primary operators established in a low-risk country. Unlike the DDS, this is a one-time submission covering all relevant products the operator produces, rather than a per-shipment declaration. Relevant commodities: cattle, cocoa, coffee, oil palm, rubber, soya and wood. Products must be deforestation-free: produced on land not deforested after 31 Dec 2020; for wood, harvested without inducing forest degradation after 31 Dec 2020.
| Field | Type | Required | Description |
|---|---|---|---|
internalReferenceNumber |
InternalReferenceNumberType |
Yes | Operator defined reference. If not provided, generated by the Information System. |
activityType |
ActivityType |
Yes | The type of commercial activity: IMPORT (release for free circulation), EXPORT, or DOMESTIC (placing on the market). (Box 2) |
representedOperator |
EconomicOperatorIdentificationType |
No | The represented micro or small primary operator on whose behalf the authorised representative is acting (Box 3). Required when operatorRole is REPRESENTATIVE_MSPO or MS under article 4a4. Identified by standard ID. |
countryOfActivity |
EuropeanCountryType |
No | EU Member State where the economic activity takes place (Box 4). Must be a low-risk country for MSPO eligibility. |
borderCrossCountry |
EuropeanCountryType |
No | Country of entry (for IMPORT activity) or country of exit (for EXPORT activity) at the customs territory border (Box 4). |
comment |
EditorialCommentType |
No | Editorial comment for the competent authority (Box 5). |
commodities |
SdCommodityType |
Yes | Relevant commodities and products declared in this SD. Corresponds to Boxes 6, 9 to 16. |
geoLocationConfidential |
boolean |
Yes | If TRUE, geolocation data is confidential and not disclosed down the supply chain to downstream operators and traders. If FALSE, geolocation data can be disclosed to anyone down the supply chain. |
groupedDeclarations |
GroupedDeclarationsType |
No | List of previously submitted SDs referenced by this declaration for grouping. Each reference includes a declaration identifier. |
SdCommodityType¶
A commodity entry in the Simplified Declaration, representing a relevant commodity or relevant product. Includes HS code classification, commercial description, and producer location data.
| Field | Type | Required | Description |
|---|---|---|---|
position |
long |
No | Ordinal position of this commodity within the SD. |
descriptors |
CommercialDescriptionType |
Yes | Commercial description and quantity measures for this commodity. |
hsHeading |
HSHeadingType |
Yes | Box 10: commodity code from the Harmonized Commodity Description and Coding System (HS), plus the (optional) corresponding quantity information. 2 to 10 digit code. |
producers |
SdProducerType |
No | Producers of this commodity with location information. For SD, location may be provided as GeoJSON geometry, postal address(es), or a country specific cadastral identifier. |
SdProducerType¶
Producer information for a Simplified Declaration. Includes country of production and location data. Unlike DDS producers which require GeoJSON geolocation, SD producers may provide either GeoJSON geometry or postal address(es).
| Field | Type | Required | Description |
|---|---|---|---|
producerPosition |
long |
No | Ordinal position of this producer within the commodity. |
producerCountry |
CountryType |
Yes | Country of production: the country where the relevant commodity was produced. ISO 3166-1 alpha-2 code. |
producerName |
string (max 500) |
No | Name of the producer (natural or legal person). |
producerLocation |
SdProducerLocationType |
Yes | — |
SdProducerLocationType¶
Choice between GeoJSON geometry, address-based location(s), or cadastral identifier for SD producers. For Simplified Declarations, micro or small primary operators may provide either geolocation as GeoJSON, postal address(es), or a cadastral identifier as an alternative. This contrasts with DDS where GeoJSON geolocation is mandatory.
| Field | Type | Required | Description |
|---|---|---|---|
geometryGeojson |
base64Binary |
Choice | GeoJSON geometry (base64 encoded) representing the geolocation of the plot of land. Must contain lat/long coordinates with minimum 6 decimal digits. Supported types: Point, MultiPoint, Polygon, MultiPolygon, GeometryCollection. |
postalAddress |
SdProducerPostalAddressType |
Choice | Postal address(es) of the production location. Alternative to GeoJSON geolocation for micro or small primary operators. |
cadastralIdentifier |
string (max 80) |
Choice | Cadastral identifier(s) referencing the plot(s) of land in a national land registry. Maximum 80 characters each. |
SdProducerPostalAddressType¶
Postal address of a production location for SD producers. Used as an alternative to GeoJSON geolocation for micro or small primary operators.
| Field | Type | Required | Description |
|---|---|---|---|
producerStreet |
StreetAndNumberType |
Yes | Street name and number of the production location. |
producerPostalCode |
PostalCodeType |
Yes | Postal code of the production location. |
producerCity |
CityType |
Yes | City of the production location. |
SdOperatorRoleType¶
Roles permitted for SD submission. MICRO_OPERATOR: a micro or small primary operator — an operator who is a natural person or micro/small undertaking, irrespective of legal form, established in a low-risk country, who places on market or exports relevant products they themselves produced in that country. REPRESENTATIVE_MSPO: an authorised representative acting on behalf of a micro or small primary operator under written mandate.
| Value | Description |
|---|---|
MICRO_OPERATOR |
N/A |
REPRESENTATIVE_MSPO |
N/A |
MEMBER_STATE |
Member State authority acting under article 4a4 |
Constraints: Base: string
Common Types¶
SummaryAddressType¶
| Field | Type | Required | Description |
|---|---|---|---|
name |
string (max 200) |
No | — |
country |
CountryType |
No | — |
UuidAndVersionNumberType¶
| Field | Type | Required | Description |
|---|---|---|---|
uuid |
UuidType |
Yes | — |
versionNumber |
integer |
No | — |
AddressType¶
| Field | Type | Required | Description |
|---|---|---|---|
country |
CountryType |
Yes | — |
street |
StreetAndNumberType |
Yes | — |
postalCode |
PostalCodeType |
Yes | — |
city |
CityType |
Yes | — |
fullAddress |
NonStructuredAddressType |
No | — |
EconomicOperatorIdentificationType¶
| Field | Type | Required | Description |
|---|---|---|---|
operatorReferenceNumber |
EconomicOperatorReferenceNumberType |
No | — |
operatorAddress |
AddressType |
No | — |
summaryAddress |
SummaryAddressType |
No | — |
operatorEmail |
EmailType |
No | — |
operatorPhone |
PhoneType |
No | — |
operatorName |
string (max 200) |
Yes | — |
EconomicOperatorReferenceNumberType¶
| Field | Type | Required | Description |
|---|---|---|---|
identifierType |
IdentifierTypeType |
Yes | — |
identifierValue |
IdentifierValueType |
Yes | — |
GroupedDeclarationsType¶
| Field | Type | Required | Description |
|---|---|---|---|
groupedDeclaration |
ReferenceNumberType |
Yes | — |
ReferenceAndVerificationNumberType¶
| Field | Type | Required | Description |
|---|---|---|---|
referenceNumber |
ReferenceNumberType |
Yes | — |
verificationNumber |
VerificationNumberType |
Yes | — |
OverviewType¶
| Field | Type | Required | Description |
|---|---|---|---|
uuid |
UuidType |
Yes | — |
internalReferenceNumber |
InternalReferenceNumberType |
Yes | — |
referenceNumber |
ReferenceNumberType |
No | — |
referenceNumberInfo |
string |
No | Human-readable status message about the reference number, populated in every lifecycle state: - Under system analysis: while the automated risk analysis has not concluded and no reference number is assigned yet. - Under Competent Authority review (Article 17): when the submission was profiled as high risk and is pending manual review. - Assigned (status AVAILABLE): once the reference number is released; the actual value is returned in the referenceNumber element and this field carries the accompanying informational text (DDS or SD variant). Optional and non-structured; intended for display alongside referenceNumber. Backwards compatible (minOccurs=0). |
verificationNumber |
VerificationNumberType |
No | — |
status |
EudrStatusType |
Yes | — |
rejectionReason |
RejectionReasonType |
No | — |
communicationToOperator |
CommunicationToOperatorType |
No | — |
date |
dateTime |
No | — |
updatedBy |
UpdatedByType |
No | — |
version |
integer |
No | — |
CommunicationToOperatorType¶
Communication sent by CA to Operator
| Field | Type | Required | Description |
|---|---|---|---|
date |
dateTime |
Yes | Creation or amend/update date. |
content |
string (max 1000) |
Yes | Message content. |
CommercialDescriptionType¶
This type allows you to express one single commercial description and associate it with individual quantitative metrics.
| Field | Type | Required | Description |
|---|---|---|---|
descriptionOfGoods |
string (max 150) |
Yes | Single commercial description. |
goodsMeasure |
GoodsMeasureType |
Yes | Units of measurement combinations for the declared commodity |
GoodsMeasureType¶
For Import or Export activities, providing the Net Mass in kg is mandatory. For Domestic activities, at least one measurement unit must be provided: Net Mass in kg or Supplementary Units. When a supplementary unit quantity is used, the corresponding supplementary unit type, e.g. m3, must also be selected.
| Field | Type | Required | Description |
|---|---|---|---|
percentageEstimationOrDeviation |
DecimalThreePrecType |
No | Percentage estimate or deviation |
netWeight |
DecimalSixteenTotalSixPrecType |
No | The weight must be provided in Kg. |
supplementaryUnit |
DecimalSixteenTotalSixPrecType |
No | The number of units, when a manufactured product is quantified in this way. |
supplementaryUnitQualifier |
SupplementaryUnitQualifierType |
No | This field must be provided if the value is provided in supplementaryUnit field. It represents the type of the numberofUnits field. |
EudrStatusType¶
Universal lifecycle status for EUDR documents
| Value | Description |
|---|---|
SUBMITTED |
— |
AVAILABLE |
— |
REJECTED |
— |
WITHDRAWN |
— |
CANCELLED |
Declaration cancelled by the operator before availability |
ARCHIVED |
— |
SUSPENDED |
Not active in current release |
UPDATED |
Not active in current release |
GROUPED |
— |
OBSOLETE |
— |
Constraints: Base: string
ReferenceNumberType¶
Constraints: Base: string, Max length: 14
InternalReferenceNumberType¶
Constraints: Base: string, Max length: 50
CountryType¶
ISO 3166-1 alpha-2 codes
Constraints: Base: string, Pattern: [a-zA-Z]{2}
StreetAndNumberType¶
Constraints: Base: string, Max length: 300, Min length: 1
NonStructuredAddressType¶
Constraints: Base: string, Max length: 250, Min length: 1
UuidType¶
Universally unique identifier (UUID).
Constraints: Base: string, Pattern: [0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}
VerificationNumberType¶
Verification number
Constraints: Base: string, Max length: 35, Min length: 5
ActivityType¶
| Value | Description |
|---|---|
DOMESTIC |
— |
IMPORT |
— |
EXPORT |
— |
Constraints: Base: string
PostalCodeType¶
Constraints: Base: string, Max length: 80, Min length: 1
CityType¶
Constraints: Base: string, Max length: 200, Min length: 1
EmailType¶
Constraints: Base: string, Pattern: [a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}, Max length: 200
PhoneType¶
Constraints: Base: string, Max length: 50
EditorialCommentType¶
A version of a SD may have an editorial comment associated to it, with an explanation for the CA (Box 5)
Constraints: Base: string, Max length: 2000
UpdatedByType¶
Constraints: Base: string, Max length: 200, Min length: 1
RejectionReasonType¶
Rejection reason of the DDS
Constraints: Base: string, Max length: 1000, Min length: 0
IdentifierTypeType¶
| Value | Description |
|---|---|
eori |
Economic Operators Registration and Identification number (EORI) |
vat |
VAT identification number (VATIN) |
gln |
Global location number |
tin |
Tax Identification Number (TIN) |
cbr |
Central Business Register (CBR) |
cin |
Company Identification Number (CIN) |
duns |
The nine-digit D-U-N-S Number (DUNS) |
comp_num |
National company number (NCN) |
comp_reg |
Registration number in official national company register (NCR) |
oni |
Other National Identifier (ONI) |
Constraints: Base: string
IdentifierValueType¶
Constraints: Base: string, Max length: 80
SupplementaryUnitQualifierType¶
Constraints: Base: string, Max length: 4, Min length: 3
DecimalThreePrecType¶
Decimal type with precision three
Constraints: Base: decimal
DecimalSixteenTotalSixPrecType¶
Decimal number with a total of 16 and 6 fraction digits
Constraints: Base: decimal
HSHeadingType¶
Commodity code from the Harmonized Commodity Description and Coding System
Constraints: Base: string, Pattern: [0-9]{2,10}, Max length: 10, Min length: 2
EuropeanCountryType¶
| Value | Description |
|---|---|
AT |
Austria |
BE |
Belgium |
BG |
Bulgaria |
CY |
Cyprus |
CZ |
Czech Republic |
DE |
Germany |
DK |
Denmark |
EE |
Estonia |
ES |
Spain |
FI |
Finland |
FR |
France |
GR |
Greece |
HR |
Croatia |
HU |
Hungary |
IE |
Ireland |
IT |
Italy |
LT |
Lithuania |
LU |
Luxembourg |
LV |
Latvia |
MT |
Malta |
NL |
Netherlands |
PL |
Poland |
PT |
Portugal |
RO |
Romania |
SE |
Sweden |
SI |
Slovenia |
SK |
Slovakia (Slovak Republic) |
XI |
United Kingdom (Northern Ireland) |
Constraints: Base: string