Sign in
latestOpenAPI 3.0.12026-08-20112309904.6 KB

466169815b78

EUDR - Customers - DDS

Update a customer DDS for an inbound product

Updates an existing customer Due Diligence Statement (DDS) identified by ddsId. The payload must contain all required customer, activity, and product measure fields.

Use Cases:

  • Update compliance statements
  • Modify due diligence information
  • Correct DDS data before submission

Required permission: access_public_products and UPDATE on the DDS

put/public/v2/eudr/customers/customer-dds/{ddsId}

Path parameters

ddsIdinteger required

ID of the customer DDS to update.

Request body

eoriNumberstring required

EORI number of the customer.

customerNamestring required

Name of the customer as stated on the DDS.

customerCitystring required

City of the customer as stated on the DDS.

customerPostalCodestring required

Postal code of the customer as stated on the DDS.

customerStreetstring required

Street of the customer as stated on the DDS.

customerCountryIdinteger required

ID of the customer's home country (see /countries endpoint).

operatorType'RepresentativeOperator' | 'Operator' | 'Trader'

Public operator type. RepresentativeOperator is the only supported value. Operator and Trader are deprecated and retained only for legacy data.

activityType'Import' | 'Export' | 'Domestic' | 'Trade' required

Public activity type.

countryOfActivityIdinteger nullable

ID of the country where the economic activity is taking place (see /countries endpoint).

netWeightInKgnumber required

Net weight of the product in kg.

quantitynumber nullable

Product quantity (additional info).

unitstring nullable

Unit of the quantity (e.g. kg, t, m3).

Example request

{
  "eoriNumber": "EU123456789",
  "customerName": "Acme GmbH",
  "customerCity": "Vienna",
  "customerPostalCode": "1010",
  "customerStreet": "Main Street 1",
  "customerCountryId": 14,
  "operatorType": "RepresentativeOperator",
  "activityType": "Import",
  "countryOfActivityId": 14,
  "originRequestReferences": {
    "reference": [
      "PO-2025-001",
      "PO-2025-002"
    ],
    "type": "PurchaseOrder"
  },
  "netWeightInKg": 100.5,
  "quantity": 10,
  "unit": "kg"
}

Response

Customer DDS updated successfully.

idinteger required

DDS ID

activeboolean required

Active status

referenceNumberstring nullable

Reference number

verificationNumberstring nullable

Verification number

datestring date-time required

DDS date

archivedboolean required

Archived

archiveDatestring date-time nullable

Archive date

eoriNumberstring required

EORI number of the customer

customerNamestring required

Name of the customer as stated on the DDS

customerCitystring required

City of the customer as stated on the DDS

customerPostalCodestring required

Postal code of the customer as stated on the DDS

customerStreetstring required

Street of the customer as stated on the DDS

state'New' | 'Submitting' | 'Submitted' | 'SubmissionError' | 'Available' | 'Rejected' | 'Cancelled' | 'Withdrawn' | 'Archived' | 'Suspended' | 'Updated' | 'Grouped' | 'Obsolete' required

Public customer DDS state.

operatorType'RepresentativeOperator' | 'Operator' | 'Trader' required

Public operator type. RepresentativeOperator is the only supported value. Operator and Trader are deprecated and retained only for legacy data.

activityType'Import' | 'Export' | 'Domestic' | 'Trade' required

Public activity type.

productNamestring required

Product name label

productDescriptionstring required

Product description label

netWeightInKgnumber required

Net Weight in Kg

quantitynumber nullable

Product quantity (additional info)

unitstring nullable

Quantity unit

hsCodestring required

HS code

Example response

{
  "origins": [
    {
      "country": {
        "id": 14,
        "name": "Austria",
        "countryCode": "AT"
      },
      "dds": {
        "id": 201,
        "active": true,
        "referenceNumber": "EU-REF-12345",
        "netWeightInKg": 100.5
      },
      "request": {
        "status": "[\"Requested\",\"Answered\"]",
        "references": [
          {
            "referenceType": "PurchaseOrder"
          }
        ]
      },
      "dfCheckResult": {
        "status": "[\"Negligible\",\"NotRequired\"]"
      },
      "legalityCheck": {
        "status": "[\"Negligible\",\"NotRequired\"]"
      }
    }
  ],
  "eoriNumber": "EU123456789",
  "customerName": "Acme GmbH",
  "customerCity": "Vienna",
  "customerPostalCode": "1010",
  "customerStreet": "Main Street 1",
  "customerCountry": {
    "id": 14,
    "name": "Austria",
    "countryCode": "AT"
  },
  "state": "Available",
  "operatorType": "RepresentativeOperator",
  "activityType": "Import",
  "countryOfActivity": {
    "id": 14,
    "name": "Austria",
    "countryCode": "AT"
  },
  "originRequestReferences": {
    "ddsId": 456,
    "reference": "PO-2025-001",
    "type": "PurchaseOrder"
  },
  "productName": "Wooden Table",
  "productDescription": "Oak wood table, 2m x 1m",
  "netWeightInKg": 100.5,
  "quantity": 10,
  "unit": "kg",
  "hsCode": "440799"
}