Passa al contenuto principale

Problemi comuni

Risposte rapide ai problemi di integrazione più frequenti.

Autenticazione​

401 Unauthorized ad ogni richiesta​

Causa: Il token è assente, scaduto o malformato.

Soluzione:

  1. Verificare che l'intestazione sia corretta: Authorization: Bearer <token> (con la parola Bearer)
  2. Verificare se il token è scaduto — usare /api/v1/login-extended per vedere il campo expireAt
  3. Effettuare nuovamente l'accesso con /api/v1/login per ottenere un nuovo token

Il token scade troppo rapidamente​

Soluzione: Contattare il proprio referente DPD per regolare la durata di vita (TTL) del token.

Spedizioni​

400 Bad Request — errore di validazione​

Causa: Un campo obbligatorio è assente o non supera la validazione.

Soluzione: Verificare l'oggetto fieldErrors nella risposta:

{
  "fieldErrors": {
    "receiver.email": ["REQUIRED_FOR_INTERNATIONAL"],
    "receiver.countryCode": ["NOT_SUPPORTED"]
  }
}

Requisiti comuni:

  • email richiesto per tutte le destinazioni non-CH/LI (eccetto GB)
  • phone richiesto per GB (formato internazionale: +44...)
  • houseNumber richiesto per NL
  • stateCode richiesto per US/CA

L'etichetta è vuota o non viene stampata​

Soluzione: Impostare labelFormat esplicitamente:

  • "A4" — stampanti da ufficio standard
  • "A6" — stampanti per etichette termiche

Punti di ritiro​

Risultati vuoti nella ricerca per indirizzo​

Soluzione:

  1. Fornire sia zipCode che city
  2. Rimuovere i filtri di servizio o tipo
  3. Impostare hideClosed: false

Tracciamento​

404 Not Found per numero di pacco​

Soluzione:

  1. Verificare il numero di pacco dalla risposta di creazione spedizione (success[].parcelNumber)
  2. Attendere qualche minuto dopo la creazione
  3. Verificare il formato del numero (es. 05305000123456)

Ancora bloccato?​

Contattare il supporto DPD fornendo:

  • Il tracingId dalla risposta API
  • L'endpoint chiamato e l'ora approssimativa della richiesta
  • Il proprio ambiente di integrazione (dev/staging/production)