# Auftrag anlegen

> POST /api/partner/requests — idempotent über partnerRef; Datei per HTTPS-URL mit Größe und SHA-256.

Kurs: Partner-Schnittstelle (API) (Für Partnersysteme und Entwickler) · Quelle: https://www.druck-s.de/hilfe/partner/auftrag-anlegen

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)

```bash
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",…}}
```