Spedizioni

Creare una o più spedizioni in una singola richiesta. L'API valida tutti i campi, genera i numeri di pacco, arricchisce i dati di instradamento e restituisce etichette PDF.

Endpoint: POST /api/v1/shipments Autenticazione: Token JWT Bearer obbligatorio

---

Campi principali della spedizione

Campo	Tipo	Lunghezza	Obbligatorio	Descrizione
invoicingNumber	String	1–20	Sì	Numero di fatturazione cliente
numberOfParcels	Integer	—	Sì	Numero totale di pacchi (1–99)
serviceCode	String	—	Sì	Codice servizio DPD (PSD, PSI, PL, PBOX, RET)
parcelShopId	String	—	Condizionale	Richiesto per consegne in punto di ritiro
shipmentNote	String	0–255	No	Nota sulla spedizione

Campi indirizzo (mittente / destinatario / reso)

Campo	Tipo	Lunghezza	Obbligatorio	Note
name	String	1–35	Sì	Nome azienda o persona
countryCode	String	2	Sì	ISO 3166-1 alpha-2
stateCode	String	2	Condizionale	Obbligatorio per US/CA
zipCode	String	1–9	Sì	Codice postale
city	String	1–35	Sì	Città
street	String	1–35	Sì	Nome e numero civico
houseNumber	String	0–8	Condizionale	Obbligatorio per NL
phone	String	0–30	Condizionale	Obbligatorio per GB — formato +CCNNNNNNN
email	String	0–50	Condizionale	Obbligatorio per non-CH/LI (eccetto GB)

Opzioni di stampa

Campo	Tipo	Descrizione
labelFormat	String	A4 o A6 (predefinito: A4)
labelStartPosition	Integer	Posizione etichetta sul foglio A4 (1–4)

---

Risposta

201 Created — tutte le spedizioni create:

{
  "tracingId": "TRACE-123",
  "success": [
    { "id": 1, "parcelNumber": "05305000123456", "label": "PDF-codificato-base64..." }
  ],
  "failed": []
}

Codice	Descrizione
201 Created	Tutte le spedizioni create
207 Multi-Status	Successo parziale
400 Bad Request	Richiesta non valida
401 Unauthorized	Token mancante o non valido