Zum Hauptinhalt springen
GET
Get Order by ID

Autorisierungen

Authorization
string
header
erforderlich

API key generated in Settings > API Keys. Include as Authorization: Bearer <key>.

Pfadparameter

id
string<uuid>
erforderlich

Abfrageparameter

fields
string

Comma-separated list of the resource's top-level keys to return (per element for a list), e.g. id,name; omit for the full body. Top-level only; whitespace is trimmed and duplicates count once. fields never adds keys: a selected optional key that is absent on a row stays absent. 400 when passed more than once, when empty, or when it names an unknown key (the error names it and lists the allowed ones).

Antwort

Order details including lines and DDS references

id
string
erforderlich

UUID of the order.

supplier
object
erforderlich
orderNumber
string
erforderlich

Your order number, unique per company — the key batch imports upsert on.

orderDate
string | null
erforderlich

Order date (ISO 8601, UTC), or null.

deliveryDate
string | null
erforderlich

Delivery date (ISO 8601, UTC), or null when not known. When the lines carry their own dates (lines[].deliveryDate), the earliest of them.

orderType
string
erforderlich

purchase (inbound from a supplier) or sale (outbound to a customer).

lines
object[]
erforderlich

The order lines.

totalVolume
number
erforderlich

Sum of all order line quantities

ddsReferences
object[]
erforderlich

The TRACES referenceNumber / verificationNumber pairs of the live DDS statements linked to this order. A withdrawn or rejected statement is not listed; an archived one stays.

status
enum<string>
erforderlich

Derived EUDR status of the order, recomputed on every read (never stored). notRelevant: no line carries an EUDR-relevant article AND no line's article awaits the manual EUDR check (lines[].article.needsManualCheck) — such a line counts as EUDR-relevant below until a person resolves the check. done: every EUDR-relevant line is covered by a submitted, validated or grouped DDS linked to THIS order that declares the line's article FOR THE ORDER'S SUPPLIER with enough remaining volume (the article's quantity over all orders of that supplier linked to that DDS does not exceed its declared volume; an order of another supplier linked by hand stays open). open: otherwise — including after a quantity increase beyond the declared volume, an article change, or a withdrawn/rejected DDS.

Verfügbare Optionen:
open,
done,
notRelevant