Abholbestellungen

Erstellen Sie wiederkehrende geplante Abholbestellungen. DPD holt Pakete von Ihrem Standort an bestimmten Tagen und Zeitfenstern ab.

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

---

Felder

Feld	Typ	Länge	Pflichtfeld	Beschreibung
invoicingNumber	String	1–20	Ja	Kundenrechnungsnummer
pickupDate	String	10	Ja	Geplantes Abholdatum (yyyy-MM-dd), muss in der Zukunft liegen
weekDay	Integer	—	Nein	Wochentag (1=Mo … 7=So), wird aus pickupDate berechnet wenn nicht angegeben
fromTime1	String	5	Nein	Morgendliches Zeitfenster Beginn (HH:mm)
toTime1	String	5	Nein	Morgendliches Zeitfenster Ende (HH:mm)
fromTime2	String	5	Nein	Nachmittägliches Zeitfenster Beginn (HH:mm)
toTime2	String	5	Nein	Nachmittägliches Zeitfenster Ende (HH:mm)
address	AddressDTO	—	Ja	Abholadresse
numberOfParcels	Integer	—	Ja	Erwartete Paketanzahl (1–99)
tour	String	0–50	Nein	Tour-/Routenkennung

---

Zeitfenster

Sie können bis zu zwei Zeitfenster angeben (morgens und nachmittags):

Fenster	Felder	Beispiel
Morgens	fromTime1 / toTime1	08:00 / 12:00
Nachmittags	fromTime2 / toTime2	13:00 / 17:00

---

Beispiel

curl -X POST "https://label-print-shipments.dpd.ch/api/v1/pickup-orders?locale=de_CH" \
  -H "Authorization: Bearer <jwt_token>" \
  -H "Content-Type: application/json" \
  -d '[{
    "invoicingNumber": "12345678",
    "pickupDate": "2025-10-31",
    "weekDay": 5,
    "fromTime1": "08:00",
    "toTime1": "12:00",
    "numberOfParcels": 15,
    "address": {
      "name": "Lager A",
      "countryCode": "CH",
      "zipCode": "8000",
      "city": "Zürich",
      "street": "Industriestrasse 45"
    }
  }]'

---

Unterschied zu Abholaufträgen

	Abholbestellungen	Abholaufträge
Häufigkeit	Wiederkehrend (Wochenplan)	Einmalig
Zeitfenster	Bis zu 2 (morgens + nachmittags)	Von DPD festgelegt
Paketlimit	99	999