DOCS
HjemGlobal e-handel Oppfyllelse Transportører Koble til via API

Koble DHL-transportørkontoen

Koble DHL-transportørkontoen din sikkert for å få tilgang til forhandlede fraktpriser og opprette etiketter direkte gjennom Zonos.

Kom i gang 

Prosessen for å koble DHL-transportørkontoen validerer legitimasjonsbetegnelsene dine og sikrer at kontoen din er riktig konfigurert for å hente priser og generere fraktetiketter. Når du kobler DHL-kontoen din, utfører Zonos et test-rating-kall for å verifisere at tilkoblingen fungerer korrekt før du lagrer legitimasjonsbetegnelsene dine.

For å registrere deg med DHL Express eller konfigurere gjennom Zonos Dashboard, følg trinnene i denne veiledningen.

Hvordan DHL-transportørkontotilkobling fungerer 

Når du kobler DHL-transportørkontoen:

  • Validerer at du har oppgitt de riktige legitimasjonstypene for DHL
  • Gjør et live rating-kall til DHL API for å bekrefte at legitimasjonsbetegnelsene er gyldige
  • Lagrer den tilkoblede kontoen din i Zonos for fremtidig frakt-rating og etikettoppretting
  • Returnerer detaljer om den tilkoblede kontoen, inkludert DHL-kontoinformasjonen og tariffen din

Når den er koblet til, kan DHL-transportørkontoen din brukes til å få sanntidsfraktpriser basert på dine forhandlede priser (hvis aktuelt) og opprette DHL-fraktetiketter.

Koble til DHL-kontoen din 

Bruk carrierAccountConnect-mutasjonen for å koble DHL-transportørkontoen din med legitimasjonsbetegnelsene dine.

Mutasjon

Bruk denne mutasjonen til å koble DHL-transportørkontoen din og validere legitimasjonsbetegnelsene dine.

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}

Variabler

Mutasjonen krever DHL-transportørkoden, tarifftypen og DHL-kontolegitimasjonen din.

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 krever følgende legitimasjonstyper:

  • API_KEY - Din DHL API-nøkkel
  • API_PASSWORD - Ditt DHL API-passord
  • ACCOUNT_NUMBER - Ditt DHL-kontonummer

Du finner disse legitimasjonsbetegnelsene i DHL-kontoportalen din eller ved å kontakte DHL-kontorepresentanten din.

Eksempler på svar

Vellykket tilkobling

Når legitimasjonsbetegnelsene er gyldige og DHL returnerer priser:

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}

Feil: Legitimasjonstype som ikke støttes

Hvis du oppgir en legitimasjonstype som DHL ikke støtter:

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}

Feil: Ugyldige legitimasjonsbetegnelser

Hvis legitimasjonsbetegnelsene er gyldige typer, men ikke autentiserer vellykket med DHL:

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

Hva skjer etter tilkobling

Når DHL-transportørkontoen din er vellykket tilkoblet:

  • Kontoen lagres i organisasjonen din og er knyttet til legitimasjonsbetegnelsene dine
  • Du kan hente DHL-fraktpriser ved hjelp av forhandlede priser dine (hvis aktuelt)
  • Du kan opprette DHL-fraktetiketter gjennom Zonos API
  • Transportørkontoen kan brukes på tvers av flere forsendelser uten å koble til igjen

Neste trinn 

Etter at du har koblet DHL-transportørkontoen din:

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

CarrierAccountConnectInput

MUTATIONS

carrierAccountConnect

Var denne siden nyttig?

Få støtte·Juridiske dokumenter·© 2026 Zonos
På denne siden:
  • Koble DHL-transportørkontoen
  • Kom i gang
  • Hvordan DHL-transportørkontotilkobling fungerer
  • Koble til DHL-kontoen din
  • Neste trinn