DOCS

Koppelen via API

StartpaginaWereldwijde ecommerce Fulfillment Vervoerders Koppelen via API

DHL-vervoerdersaccount koppelen

Koppel uw DHL-vervoerdersaccount veilig om onderhandelde verzendtarieven te gebruiken en labels rechtstreeks via Zonos aan te maken.

Aan de slag 

Het koppelproces voor uw DHL-vervoerdersaccount valideert uw inloggegevens en zorgt dat uw account correct is geconfigureerd om tarieven op te halen en verzendlabels te genereren. Wanneer u uw DHL-account koppelt, voert Zonos een test rating call uit om te verifiëren dat de koppeling werkt voordat uw inloggegevens worden opgeslagen.

Volg voor registratie bij DHL Express of setup via uw Zonos Dashboard de stappen in deze gids.

Hoe de DHL-vervoerdersaccountkoppeling werkt 

Het koppelen van uw DHL-vervoerdersaccount:

  • Valideert dat u de juiste credential types voor DHL heeft opgegeven
  • Voert een live rating call uit naar de DHL API om te bevestigen dat de inloggegevens geldig zijn
  • Slaat uw gekoppelde account op in Zonos voor toekomstige tariefberekening en labelcreatie
  • Retourneert de details van het gekoppelde account, inclusief uw DHL-accountinformatie en rate type

Eenmaal gekoppeld kunt u uw DHL-vervoerdersaccount gebruiken om real-time verzendtarieven op basis van uw onderhandelde tarieven (indien van toepassing) op te halen en DHL-verzendlabels aan te maken.

Uw DHL-account koppelen 

Gebruik de carrierAccountConnect-mutatie om uw DHL-vervoerdersaccount met uw inloggegevens te koppelen.

Mutatie

Gebruik deze mutatie om uw DHL-vervoerdersaccount te koppelen en uw inloggegevens te valideren.

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}

Variabelen

De mutatie vereist de DHL vervoerder code, rate type en uw DHL-accountinloggegevens.

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 vereist de volgende credential types:

  • API_KEY - Uw DHL API-sleutel
  • API_PASSWORD - Uw DHL API-wachtwoord
  • ACCOUNT_NUMBER - Uw DHL-accountnummer

U vindt deze inloggegevens in uw DHL-accountportaal of via uw DHL-accountvertegenwoordiger.

Voorbeeldresponses

Succesvolle koppeling

Wanneer inloggegevens geldig zijn en DHL succesvol tarieven retourneert:

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}

Fout: Niet-ondersteund credential type

Als u een credential type opgeeft dat DHL niet ondersteunt:

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}

Fout: Ongeldige inloggegevens

Als de inloggegevens geldige types zijn maar niet succesvol authenticeren bij DHL:

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

Wat gebeurt er na koppeling

Zodra uw DHL-vervoerdersaccount succesvol is gekoppeld:

  • Het account wordt opgeslagen in uw organisatie en gekoppeld aan uw inloggegevens
  • U kunt DHL-verzendtarieven ophalen met uw onderhandelde tarieven (indien van toepassing)
  • U kunt DHL-verzendlabels aanmaken via de Zonos API
  • Het vervoerdersaccount kan voor meerdere zendingen worden gebruikt zonder opnieuw te koppelen

Volgende stappen 

Na het koppelen van uw DHL-vervoerdersaccount:

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

CarrierAccountConnectInput

MUTATIONS

carrierAccountConnect

Boek een demo

Was deze pagina nuttig?

Krijg ondersteuning·Juridische documenten·© 2026 Zonos
Op deze pagina:
  • DHL-vervoerdersaccount koppelen
  • Aan de slag
  • Hoe de DHL-vervoerdersaccountkoppeling werkt
  • Uw DHL-account koppelen
  • Volgende stappen