Abholaufträge

Planen Sie eine einmalige Paketabholung von Ihrem Standort. DPD holt die Pakete am gewünschten Datum ab.

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

---

Felder

Feld	Typ	Länge	Pflichtfeld	Beschreibung
invoicingNumber	String	1–20	Ja	Ihre DPD-Kundennummer
pickupDate	String	10	Ja	Gewünschtes Abholdatum (yyyy-MM-dd), muss in der Zukunft liegen
referenceNumber	String	0–50	Nein	Ihre interne Referenznummer
note	String	0–255	Nein	Besondere Abholhinweise
sender	AddressDTO	—	Ja	Adresse, von der abgeholt wird
receiver	AddressDTO	—	Ja	Endbestimmungsadresse
numberOfParcels	Integer	—	Ja	Erwartete Paketanzahl (1–999)
weight	Double	—	Nein	Gesamtgewicht aller Pakete in Gramm
serviceCode	String	2–10	Ja	DPD-Servicecode (z.B. PSD, PSI)

---

Beispiel

curl -X POST "https://label-print-shipments.dpd.ch/api/v1/collection-requests?locale=de_CH" \
  -H "Authorization: Bearer <jwt_token>" \
  -H "Content-Type: application/json" \
  -d '[{
    "invoicingNumber": "12345678",
    "pickupDate": "2025-10-31",
    "serviceCode": "PSD",
    "numberOfParcels": 5,
    "weight": 25000.0,
    "sender": {
      "name": "Absender AG",
      "countryCode": "CH",
      "zipCode": "8000",
      "city": "Zürich",
      "street": "Industriestrasse 25"
    },
    "receiver": {
      "name": "Empfänger GmbH",
      "countryCode": "DE",
      "zipCode": "10115",
      "city": "Berlin",
      "street": "Alexanderplatz 1"
    }
  }]'

---

Statuscodes

Code	Beschreibung
201 Created	Alle Abholaufträge erstellt
207 Multi-Status	Teilerfolg
400 Bad Request	Validierungsfehler
401 Unauthorized	Token fehlt oder ungültig

hinweis

weight wird in Gramm angegeben (z.B. 25000 = 25 kg). pickupDate muss in der Zukunft liegen.