API DPD Label Print Spedizioni

L'API spedizioni consente di integrare i servizi di spedizione DPD nelle proprie applicazioni — creazione di spedizioni, tracciamento, ricerca punti di ritiro e pianificazione dei ritiri.

URL di base: https://label-print-shipments.dpd.ch Versione API: v1 Autenticazione: Token JWT Bearer (vedere Autenticazione)

---

Riferimento API

API	Endpoint	Descrizione
Autenticazione	2	Accesso utente e generazione token JWT
Spedizioni	1	Creare spedizioni con generazione automatica etichette
Tracciamento	1	Dati di tracciamento in tempo reale
Punti di ritiro	3	Cercare e ottenere dettagli dei punti di ritiro DPD
Richieste di ritiro	1	Pianificare ritiri una tantum
Ordini di ritiro	1	Creare pianificazioni di ritiro ricorrenti

---

Avvio rapido

1. Ottenere un token di accesso

curl -X POST "https://label-print-shipments.dpd.ch/api/v1/login" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "il_vostro_utente",
    "password": "la_vostra_password"
  }'

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refreshToken": "..."
}

2. Chiamare gli endpoint API

Includere il token in ogni richiesta:

curl -X GET "https://label-print-shipments.dpd.ch/api/v1/tracking/05305000123456" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

---

Concetti comuni

Validazione degli indirizzi

{
  "name": "Nome azienda",           // obbligatorio, max 35 caratteri
  "countryCode": "CH",              // obbligatorio, codice ISO a 2 lettere
  "zipCode": "8000",                // obbligatorio, max 9 caratteri
  "city": "Zürich",                 // obbligatorio, max 35 caratteri
  "street": "Bahnhofstrasse 1",     // obbligatorio, max 35 caratteri
  "phone": "+41441234567",          // obbligatorio per GB
  "email": "info@azienda.ch"        // obbligatorio per non-CH/LI
}

Requisiti specifici per paese:

• NL: houseNumber obbligatorio
• GB: phone obbligatorio (formato internazionale)
• US/CA: stateCode obbligatorio
• Non-CH/LI: email obbligatorio (eccetto GB)

Codici servizio

Codice	Servizio	Descrizione	Peso max.
PSD	DPD Classic	Consegna nazionale standard	35 kg
PSI	DPD Classic International	Consegna internazionale	20 kg
PL	DPD Express Letter	Servizio lettera express	2 kg
PBOX	DPD ParcelBox	Consegna in locker	5 kg
RET	Servizio reso	Resi	variabile

Lingue supportate

Lingua	Valori locale
Tedesco	de_CH, de_DE
Inglese	en_US, en_GB
Francese	fr_CH, fr_FR
Italiano	it_CH, it_IT