Simplified Declaration (SD) — V3 API Reference¶
Service: EUDRSimplifiedDeclarationServiceV3
Namespace: http://ec.europa.eu/tracesnt/certificate/eudr/simplified-declaration/v3
Endpoint: /tracesnt/ws/EUDRSimplifiedDeclarationServiceV3
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, 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 not in available status or is subject to a customs lock.
- 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 or is subject to a customs lock.
- 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.
- 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¶
Retrieve full SD content by providing the declaration identifier and verification number. The verification number is a security number assigned by the Information System to ensure additional security of data. This operation is available only to non-SME operators (standard operators, micro/small primary operators, authorised representatives, and Member States). SME downstream operators do not have access to this operation.
- Request:
GetSdByIdentifiersRequest(Type:GetSdByIdentifiersRequestType) - Response:
GetSdByIdentifiersResponse(Type:GetSdByIdentifiersResponseType) - Faults:
NotFoundException
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 or is subject to a customs lock. Grouped declarations cannot be added, modified or removed on update: submitting a statement that contains groupedDeclarations is rejected with the EUDR-GROUPING-NOT-ALLOWED-ON-AMEND error. Grouping can only be set on the initial submission.
| 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 or subject to a customs lock.
| 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¶
Request to retrieve full SD content by providing the declaration identifier and verification number — the security number assigned by the Information System to ensure additional security of data.
| Field | Type | Required | Description |
|---|---|---|---|
referenceAndVerificationNumber |
ReferenceAndVerificationNumberType |
Yes | — |
GetSdByIdentifiersResponseType¶
Response containing the full SD statement payload retrieved by declaration identifier and verification number.
| Field | Type | Required | Description |
|---|---|---|---|
statement |
SimplifiedDeclarationBaseType |
Yes | — |
SimplifiedDeclarationBaseType¶
Core payload of a Simplified Declaration pursuant to 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 |
ReferenceNumberType |
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. 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 | For the purposes of the grouping function, the group head must be a complete declaration in its own right: it must list the relevant commodities or products being placed on the market or exported from it, with their quantities, HS codes and other data elements. Because the group head is the reference used towards customs and competent authorities and first downstream operators and traders, its content must reflect what is actually being placed on the market. The geolocation that is carried by the individual member declarations, which the group head references and represents under Art 8a(3); it does not need to be repeated on the head. Responsibility for entering correct data about the relevant commodities and products, including the quantities in the group head submission rests with the operator. The Information System does not automatically reconcile the group head's products and quantities from the group the members. |
SdReferenceType¶
Reference to a previously submitted Simplified Declaration for grouping. Only SD references are accepted; DDS references are rejected. The referenced SD receives GROUPED status and cannot be individually withdrawn or updated while the referencing grouped declaration is active.
| Field | Type | Required | Description |
|---|---|---|---|
referenceNumber |
ReferenceNumberType |
Yes | Reference number of the SD to be grouped. |
verificationNumber |
VerificationNumberType |
Yes | Verification number of the SD to be grouped — ensures additional security of data. |
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 or postal address(es), unlike DDS which requires GeoJSON geolocation. |
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 |
No | 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 |
— |
REPRESENTATIVE_MSPO |
— |
MEMBER_STATE |
Member State authority |
Constraints: Base: string
Common Types¶
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 | — |
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 | — |
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 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¶
| Field | Type | Required | Description |
|---|---|---|---|
percentageEstimationOrDeviation |
DecimalThreePrecType |
No | Percentage estimate or deviation |
netWeight |
DecimalSixteenTotalSixPrecType |
No | This is mandatory if activity type is IMPORT/EXPORT. 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 |
— |
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