Submit DDS
โถStep 13: Submit the DDS to EU TRACES
The step the chain exists for: file the record's current version with EU
TRACES. POST /regulations/eudr/dds/{{ddsdf_record_id}}/submit with
mode: "submit" runs the pre-submission gate, then dispatches an
asynchronous filing task and returns 202 Accepted with a
dds_record_task. The bytes are filed by the worker; poll the task
(step 14) to watch pending โ processing โ completed.
โถRequest body
The body is optional โ a bare POST defaults to mode: "submit". It can
also finalise every TRACES-required field in one call (merge-patched onto
the current version before the gate runs), so no separate PATCH is
needed:
| Field | Notes |
|---|---|
mode | submit (default), validate (dry-run), or manual (record an external filing) |
activity_type | DOMESTIC | IMPORT | EXPORT |
country_of_activity | EU-27 + XI only; the EU Member State where the activity takes place (falls back to operator.country); the entry/exit country is the separate optional country_of_entry_or_exit, which falls back to it |
internal_reference_number | Caller's own reference (โค 35 chars); auto-generated when unset |
operator / commodity / comment | Same editable blocks as Update DDS Record |
โถThe pre-submission gate
Submit files only the compliant supply base โ non-compliant plots are
auto-excluded, not blocked. It then checks a set of blockers and returns
422 PRE_SUBMISSION_BLOCKED with details.blockers[] if any fail. The
common ones for a first integration:
| Blocker | Clear it by |
|---|---|
authorization_missing | Record an authorisation for the current version (step 12) |
operator_incomplete | Complete the operator block (TRACES-mandatory fields) via Update DDS Record |
plots_missing_screening | Run full-resolution deforestation screening on the included plots |
See Submit DDS for every mode, blocker, and the live TRACES acceptance pre-flight.
โถErrors
| Status | Code | Cause |
|---|---|---|
| 400 | BAD_REQUEST | Body failed validation โ unknown/identity key, country_of_activity outside EU-27+XI |
| 404 | NOT_FOUND | Record / current version not visible |
| 409 | CONFLICT | Version already submitted, mid-submission, or another task in flight |
| 422 | PRE_SUBMISSION_BLOCKED | A gate failed; details.blockers[] lists them |
โ Step 14: Wait For Submit Task.
Required scope:
eudr:write