Ordini di ritiro

Creare ordini di ritiro pianificati e ricorrenti. DPD ritirerà i pacchi dal vostro indirizzo nei giorni e nelle fasce orarie specificati.

Endpoint: POST /api/v1/pickup-orders Autenticazione: Token JWT Bearer obbligatorio

---

Richiesta

Parametro di query: locale (facoltativo) — es. de_CH, en_US, fr_CH, it_CH

Corpo: List<PickupOrderDTO>

Campi

Campo	Tipo	Lunghezza	Obbligatorio	Descrizione
invoicingNumber	String	1–20	Obbligatorio	Numero di fatturazione cliente
pickupDate	String	10	Obbligatorio	Data di ritiro pianificata (yyyy-MM-dd), deve essere futura
weekDay	Integer	—	Facoltativo	Giorno della settimana (1=Lun … 7=Dom). Calcolato automaticamente da pickupDate se omesso
fromTime1	String	5	Facoltativo	Inizio fascia oraria mattutina (HH:mm)
toTime1	String	5	Facoltativo	Fine fascia oraria mattutina (HH:mm)
fromTime2	String	5	Facoltativo	Inizio fascia oraria pomeridiana (HH:mm)
toTime2	String	5	Facoltativo	Fine fascia oraria pomeridiana (HH:mm)
address	AddressDTO	—	Obbligatorio	Indirizzo del luogo di ritiro
numberOfParcels	Integer	—	Obbligatorio	Numero di pacchi previsto (1–99)
tour	String	0–50	Facoltativo	Identificatore tour/percorso
clientSoftware	String	0–50	Facoltativo	Nome dell'applicazione client
clientVersion	String	0–20	Facoltativo	Versione dell'applicazione client

---

Fasce orarie

È possibile specificare fino a due fasce orarie (mattina e pomeriggio). Lasciare vuoti i campi del pomeriggio per una singola fascia continua.

Fascia	Campi	Esempio
Mattina	fromTime1 / toTime1	08:00 / 12:00
Pomeriggio	fromTime2 / toTime2	13:00 / 17:00

---

Esempio

curl -X POST "https://label-print-shipments.dpd.ch/api/v1/pickup-orders?locale=it_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",
      "fromTime2": "13:00",
      "toTime2": "17:00",
      "numberOfParcels": 15,
      "address": {
        "name": "Magazzino Sede A",
        "countryCode": "CH",
        "zipCode": "6900",
        "city": "Lugano",
        "street": "Via Industria 45",
        "phone": "+41441234567",
        "email": "magazzino@azienda.ch",
        "reference": "WAREHOUSE-A"
      },
      "tour": "TOUR-TI-SUD",
      "clientSoftware": "Customer App",
      "clientVersion": "4.0.0"
    }
  ]'

---

Risposta

201 Created — tutti gli ordini creati:

{
  "tracingId": "TRACE-321",
  "success": [
    { "id": 1, "tracingId": "123456789" }
  ],
  "failed": []
}

207 Multi-Status — successo parziale con errori a livello di campo:

{
  "tracingId": "TRACE-322",
  "success": [],
  "failed": [
    {
      "id": 1,
      "fieldErrors": {
        "numberOfParcels": ["MAX_99"],
        "address.countryCode": ["REQUIRED"]
      }
    }
  ]
}

Codici di stato:

Codice	Descrizione
201 Created	Tutti gli ordini di ritiro creati
207 Multi-Status	Alcuni riusciti, altri falliti
400 Bad Request	Errore di validazione
401 Unauthorized	Token mancante o non valido

---

Differenza con le richieste di ritiro

	Ordini di ritiro	Richieste di ritiro
Frequenza	Ricorrente (piano settimanale)	Una tantum
Fasce orarie	Fino a 2 (mattina + pomeriggio)	Definite da DPD
Limite pacchi	99	999
Campo peso	Non richiesto	Facoltativo (grammi)