Sendungen

Erstellen Sie eine oder mehrere Sendungen in einer einzigen Anfrage. Die API validiert alle Felder, generiert Paketnummern, reichert Routing-Daten an und gibt PDF-Etiketten zurück.

Endpunkt: POST /api/v1/shipments Authentifizierung: Bearer JWT-Token erforderlich

---

Anfrage

Content-Type: application/json Body: Array von Sendungsobjekten

[
  {
    "invoicingNumber": "12345678",
    "serviceCode": "PSD",
    "sender": { },
    "receiver": { },
    "parcelInfo": [ ],
    "customsData": { },
    "printOptions": { }
  }
]

Sendungs-Hauptfelder

Feld	Typ	Länge	Pflichtfeld	Beschreibung
invoicingNumber	String	1–20	Ja	Kundenrechnungsnummer
numberOfParcels	Integer	—	Ja	Gesamtpakete (1–99)
serviceCode	String	—	Ja	DPD-Servicecode (PSD, PSI, PL, PBOX, RET)
mpsId	String	—	Nein	Master-Sendungs-ID zur Gruppierung
customerReferenceNumber1–4	String	0–35	Nein	Kundenreferenzfelder
shipmentNote	String	0–255	Nein	Sendungsnotiz
parcelShopId	String	—	Bedingt	Erforderlich für Paketshop-Lieferdienste

Adressfelder (Absender / Empfänger / Rücksendung)

Feld	Typ	Länge	Pflichtfeld	Hinweise
name	String	1–35	Ja	Firmen- oder Personenname
countryCode	String	2	Ja	ISO 3166-1 Alpha-2
stateCode	String	2	Bedingt	Pflichtfeld für US/CA
zipCode	String	1–9	Ja	Postleitzahl
city	String	1–35	Ja	Stadt
street	String	1–35	Ja	Strassenname und Hausnummer
houseNumber	String	0–8	Bedingt	Pflichtfeld für NL
phone	String	0–30	Bedingt	Pflichtfeld für GB — Format +LLNNNNNNN
email	String	0–50	Bedingt	Pflichtfeld für Nicht-CH/LI (ausser GB)
eori	String	0–22	Bedingt	Pflichtfeld für GB/NO international
language	String	2	Nein	ISO 639-1 (DE, EN, FR, IT)

Druckoptionen

Feld	Typ	Pflichtfeld	Beschreibung
labelFormat	String	Nein	A4 oder A6 (Standard: A4)
labelStartPosition	Integer	Nein	Etikettenposition auf A4-Blatt (1–4)

---

Antwort

201 Created – alle Sendungen erfolgreich erstellt:

{
  "tracingId": "TRACE-123",
  "success": [
    {
      "id": 1,
      "parcelNumber": "05305000123456",
      "label": "base64-kodiertes-PDF..."
    }
  ],
  "failed": []
}

207 Multi-Status – Teilerfolg:

{
  "tracingId": "TRACE-456",
  "success": [],
  "failed": [
    {
      "id": 2,
      "fieldErrors": {
        "receiver.email": ["REQUIRED_FOR_INTERNATIONAL"]
      }
    }
  ]
}

Code	Beschreibung
201 Created	Alle Sendungen erfolgreich erstellt
207 Multi-Status	Teilerfolg
400 Bad Request	Ungültige Anfrage
401 Unauthorized	Token fehlt oder ungültig