DOCS

Connetti tramite API

HomeEcommerce globale Fulfillment Carrier Connetti tramite API

Connetti l'account carrier DHL

Connetti in modo sicuro il tuo account carrier DHL per accedere a tariffe di spedizione negoziate e creare etichette direttamente tramite Zonos.

Inizia 

Il processo di connessione dell'account carrier DHL convalida le tue credenziali e garantisce che il tuo account sia configurato correttamente per recuperare le tariffe e generare le etichette di spedizione. Quando connetti il tuo account DHL, Zonos esegue una chiamata di rating di prova per verificare che la connessione funzioni correttamente prima di memorizzare le tue credenziali.

Per registrarti con DHL Express o configurare l'account tramite il tuo Zonos Dashboard, segui i passaggi in questa guida.

Come funziona la connessione dell'account carrier DHL 

Connettere il tuo account carrier DHL:

  • Convalida che tu abbia fornito i tipi di credenziali corretti per DHL
  • Esegue una chiamata di rating live all'API DHL per confermare che le credenziali siano valide
  • Memorizza il tuo account connesso in Zonos per il rating delle spedizioni e la creazione di etichette future
  • Restituisce i dettagli dell'account connesso, incluse le informazioni del tuo account DHL e il tipo di tariffa

Una volta connesso, il tuo account carrier DHL può essere usato per ottenere tariffe di spedizione in tempo reale basate sulle tue tariffe negoziate (se applicabili) e creare etichette di spedizione DHL.

Connetti il tuo account DHL 

Usa la mutation carrierAccountConnect per connettere il tuo account carrier DHL con le tue credenziali.

Mutation

Usa questa mutation per connettere il tuo account carrier DHL e convalidare le tue credenziali.

1mutation CarrierAccountConnect($input: CarrierAccountConnectInput!) {
2 carrierAccountConnect(input: $input) {
3 errors
4 carrierAccount {
5 credentialProvider
6 id
7 integrationType
8 organization
9 rateType
10 carrier {
11 id
12 code
13 name
14 }
15 credentials {
16 type
17 value
18 }
19 }
20 }
21}

Variabili

La mutation richiede il codice carrier DHL, il tipo di tariffa e le credenziali del tuo account DHL.

1{
2 "input": {
3 "carrierCode": "DHL",
4 "rateType": "NEGOTIATED",
5 "credentials": [
6 {
7 "type": "API_KEY",
8 "value": "actual_api_key_value"
9 },
10 {
11 "type": "API_PASSWORD",
12 "value": "actual_api_password_value"
13 },
14 {
15 "type": "ACCOUNT_NUMBER",
16 "value": "actual_account_number_value"
17 }
18 ]
19 }
20}

DHL richiede i seguenti tipi di credenziali:

  • API_KEY - La tua chiave API DHL
  • API_PASSWORD - La tua password API DHL
  • ACCOUNT_NUMBER - Il tuo numero di account DHL

Puoi trovare queste credenziali nel portale del tuo account DHL o contattando il tuo referente dell'account DHL.

Esempi di risposta

Connessione riuscita

Quando le credenziali sono valide e DHL restituisce le tariffe con successo:

1{
2 "data": {
3 "carrierAccountConnect": {
4 "errors": [],
5 "carrierAccount": {
6 "credentialProvider": "ORGANIZATION",
7 "id": "carrier_account_123",
8 "integrationType": "REST",
9 "organization": "organization_id",
10 "rateType": "NEGOTIATED",
11 "carrier": {
12 "id": "carrier_123",
13 "code": "dhl",
14 "name": "DHL"
15 },
16 "credentials": [
17 {
18 "type": "API_KEY",
19 "value": "actual_api_key_value"
20 },
21 {
22 "type": "API_PASSWORD",
23 "value": "actual_api_password_value"
24 },
25 {
26 "type": "ACCOUNT_NUMBER",
27 "value": "actual_account_number_value"
28 }
29 ]
30 }
31 }
32 }
33}

Errore: tipo di credenziale non supportato

Se fornisci un tipo di credenziale che DHL non supporta:

1{
2 "data": {
3 "carrierAccountConnect": {
4 "errors": [
5 "Credential type SITE_ID is not supported by carrier DHL"
6 ],
7 "carrierAccount": null
8 }
9 }
10}

Errore: credenziali non valide

Se le credenziali sono di tipi validi ma non si autenticano correttamente con DHL:

1{
2 "data": {
3 "carrierAccountConnect": {
4 "errors": [
5 "Failed to get rating from DHL API"
6 ],
7 "carrierAccount": null
8 }
9 }
10}

Cosa succede dopo la connessione

Una volta che il tuo account carrier DHL è connesso con successo:

  • L'account viene memorizzato nella tua organizzazione e collegato alle tue credenziali
  • Puoi recuperare le tariffe di spedizione DHL usando le tue tariffe negoziate (quando applicabili)
  • Puoi creare etichette di spedizione DHL tramite l'API Zonos
  • L'account carrier può essere usato per più spedizioni senza doverlo riconnettere

Prossimi passi 

Dopo aver connesso il tuo account carrier DHL:

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

CarrierAccountConnectInput

MUTATIONS

carrierAccountConnect

Prenota una demo

Questa pagina è stata utile?

Ottieni supporto·Documenti legali·© 2026 Zonos
In questa pagina:
  • Connetti l'account carrier DHL
  • Inizia
  • Come funziona la connessione dell'account carrier DHL
  • Connetti il tuo account DHL
  • Prossimi passi