dmpdruckraum

Auftrag anlegen

Lektion 2 von 5 · ca. 4 Min.

Ein Aufruf legt Auftrag, Datei und Auftragsnummer in einem Schritt an. Derselbe partnerRef liefert immer denselben Auftrag zurück.

Schritt für Schritt

  1. Erzeugen Sie eine eindeutige partnerRef (1–120 Zeichen A–Z a–z 0–9 . _ : -).
  2. Füllen Sie customer (E-Mail, Name, Organisation), product (hint, Format), quantity, delivery und file (url, name, mime, size, sha256).
  3. Senden Sie POST /api/partner/requests — 201 heißt neu angelegt, 200 heißt: gab es schon, unverändert zurückgegeben.
  4. Merken Sie sich number (Auftragsnummer) und status aus der Antwort.

Feldregeln

  • product.hint: flyer, poster, brochure, business-card, letterhead, sticker, banner, name-tag, campaign oder other.
  • quantity: Ganzzahl 1–1 000 000; wishDate: YYYY-MM-DD oder null.
  • delivery.mode: abholung oder lieferung (dann ist delivery.address Pflicht).
  • file.url: HTTPS, Port 443, Host freigegeben; file.size und file.sha256 müssen exakt passen; höchstens 100 MB.
  • source.system ist Pflicht; publication und link sind optional und werden im Staff-Bereich angezeigt.

Auftrag anlegen (curl)

curl -sS https://www.druck-s.de/api/partner/requests \
  -H "Authorization: Bearer $DRUCK_S_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "partnerRef": "bestellung-2026-0042",
    "customer": { "email": "anna@example.org", "name": "Anna Muster", "organisation": "Quartierszentrum" },
    "product": { "hint": "poster", "label": "Plakat A2", "widthMm": 420, "heightMm": 594, "bleedMm": 3, "sides": 1 },
    "quantity": 10,
    "wishDate": "2026-11-20",
    "delivery": { "mode": "abholung", "address": null },
    "file": { "url": "https://files.example.org/plakat.pdf", "name": "plakat.pdf",
              "mime": "application/pdf", "size": 2048, "sha256": "<64 hex>" },
    "source": { "system": "beispiel-partner" }
  }'
# 201 {"request":{"id":"…","number":"091126-004","status":"RECEIVED","partnerRef":"bestellung-2026-0042",…}}