Collection Requests

Schedule a one-time parcel collection from your location. DPD will pick up the parcels on the requested date within a specified time window.

Endpoint: POST /api/v1/collection-requests Auth: Bearer JWT token required

---

Request

Query parameter: locale (optional) — localise error messages (e.g., de_CH, en_US, fr_CH, it_CH)

Body: List<CollectionRequestDTO>

Fields

Field	Type	Length	Required	Description
id	Long	—	Optional	Request identifier for tracking in response
invoicingNumber	String	1–20	Mandatory	Your DPD customer billing number
pickupDate	String	10	Mandatory	Requested pickup date (yyyy-MM-dd), must be a future date
referenceNumber	String	0–50	Optional	Your internal reference number
note	String	0–255	Optional	Special collection instructions
sender	AddressDTO	—	Mandatory	Address where parcels will be collected
receiver	AddressDTO	—	Mandatory	Final destination address
requester	AddressDTO	—	Optional	Person requesting the collection (defaults to receiver)
numberOfParcels	Integer	—	Mandatory	Expected number of parcels (1–999)
weight	Double	—	Optional	Total weight of all parcels in grams
serviceCode	String	2–10	Mandatory	DPD service code (e.g., PSD, PSI)
clientSoftware	String	0–50	Optional	Your application name
clientVersion	String	0–20	Optional	Your application version

---

Example

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"
      }
    }
  ]'

---

Response

201 Created — all requests created:

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

207 Multi-Status — partial success:

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

Status codes:

Code	Description
201 Created	All collection requests created
207 Multi-Status	Some succeeded, some failed
400 Bad Request	Validation error
401 Unauthorized	Missing or invalid token

---

Notes

• pickupDate must be a future date; past dates are rejected
• weight is in grams (e.g., 25000 = 25 kg)
• Address validation follows the same country-specific rules as Shipments (NL house number, GB phone, non-CH/LI email, etc.)