Submit DDS

Step 11: 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/{{fac_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 12) to watch pending โ†’ processing โ†’ completed.

A tagged facility record files the plots resolved beneath the tagged facilities (via their supply sheds). Everything else matches the plot path.

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:

FieldNotes
modesubmit (default), validate (dry-run), or manual (record an external filing)
activity_typeDOMESTIC | IMPORT | EXPORT
country_of_activityEU-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_numberCaller's own reference (โ‰ค 35 chars); auto-generated when unset
operator / commodity / commentSame 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:

BlockerClear it by
authorization_missingRecord an authorisation for the current version (step 10)
operator_incompleteComplete the operator block (TRACES-mandatory fields) via Update DDS Record
plots_missing_screeningRun full-resolution deforestation screening on the included plots

See Submit DDS for every mode, blocker, and the live TRACES acceptance pre-flight.

Errors

StatusCodeCause
400BAD_REQUESTBody failed validation โ€” unknown/identity key, country_of_activity outside EU-27+XI
404NOT_FOUNDRecord / current version not visible
409CONFLICTVersion already submitted, mid-submission, or another task in flight
422PRE_SUBMISSION_BLOCKEDA gate failed; details.blockers[] lists them

โ†’ Step 12: Wait For Submit Task.

Required scope: eudr:write