Abholaufträge

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

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

---

Anfrage

Abfrageparameter: locale (optional) — lokalisiert Fehlermeldungen (z.B. de_CH, en_US, fr_CH, it_CH)

Body: List<CollectionRequestDTO>

Felder

Feld	Typ	Länge	Pflichtfeld	Beschreibung
id	Long	—	Nein	Auftragskennung zur Nachverfolgung in der Antwort
invoicingNumber	String	1–20	Ja	Ihre DPD-Kundenrechnungsnummer
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 die Pakete abgeholt werden
receiver	AddressDTO	—	Ja	Endbestimmungsadresse
requester	AddressDTO	—	Nein	Person, die die Abholung anfordert (Standard: Empfänger)
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)
clientSoftware	String	0–50	Nein	Name Ihrer Anwendung
clientVersion	String	0–20	Nein	Version Ihrer Anwendung

---

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": "Sender Company AG",
        "countryCode": "CH",
        "zipCode": "8000",
        "city": "Zürich",
        "street": "Industriestrasse 25",
        "phone": "+41441234567"
      },
      "receiver": {
        "name": "Receiver GmbH",
        "countryCode": "DE",
        "zipCode": "10115",
        "city": "Berlin",
        "street": "Alexanderplatz 1"
      }
    }
  ]'

---

Antwort

201 Created — alle Aufträge erstellt:

{
  "tracingId": "TRACE-789",
  "success": [
    { "id": 1, "referenceNumber": "CR-20251031-001" }
  ],
  "failed": []
}

207 Multi-Status — Teilerfolg:

{
  "tracingId": "TRACE-790",
  "success": [],
  "failed": [
    {
      "id": 1,
      "fieldErrors": {
        "pickupDate": ["MUST_BE_FUTURE_DATE"]
      }
    }
  ]
}

Statuscodes:

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

---

Hinweise

• pickupDate muss in der Zukunft liegen; vergangene Daten werden abgelehnt
• weight wird in Gramm angegeben (z.B. 25000 = 25 kg)
• Die Adressvalidierung folgt denselben länderspezifischen Regeln wie bei Sendungen (NL-Hausnummer, GB-Telefon, Nicht-CH/LI-E-Mail usw.)