DOCS

Anslut via API

Anslut DHL-transportörskonto

Anslut säkert ert DHL-transportörskonto för att få åtkomst till förhandlade fraktpriser och skapa etiketter direkt via Zonos.

Kom igång 

Anslutningsprocessen för DHL-transportörskonto validerar era uppgifter och säkerställer att ert konto är korrekt konfigurerat för att hämta priser och generera fraktetiketter. När ni ansluter ert DHL-konto utför Zonos ett testprisanrop för att verifiera att anslutningen fungerar korrekt innan era uppgifter lagras.

För att registrera er hos DHL Express eller ställa in via ert Zonos Dashboard, följ stegen i den här guiden.

Hur anslutning av DHL-transportörskonto fungerar 

När ni ansluter ert DHL-transportörskonto:

  • Valideras att ni har angett rätt typ av uppgifter för DHL
  • Görs ett liveprisanrop till DHL API för att bekräfta att uppgifterna är giltiga
  • Lagras ert anslutna konto i Zonos för framtida fraktprissättning och etikettskapande
  • Returneras uppgifterna för det anslutna kontot, inklusive er DHL-kontoinformation och pristyp

När anslutningen är klar kan ert DHL-transportörskonto användas för att hämta realtidsfraktpriser baserade på era förhandlade priser (om tillämpligt) och skapa DHL-fraktetiketter.

Anslut ert DHL-konto 

Använd mutationen carrierAccountConnect för att ansluta ert DHL-transportörskonto med era uppgifter.

Mutation

Använd den här mutationen för att ansluta ert DHL-transportörskonto och validera era uppgifter.

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

Mutationen kräver DHL-transportörskoden, pristypen och era DHL-kontouppgifter.

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 kräver följande typer av uppgifter:

  • API_KEY - Er DHL API-nyckel
  • API_PASSWORD - Ert DHL API-lösenord
  • ACCOUNT_NUMBER - Ert DHL-kontonummer

Ni hittar dessa uppgifter i er DHL-kontoportal eller genom att kontakta er DHL-kontoansvarige.

Exempel på svar

Lyckad anslutning

När uppgifterna är giltiga och DHL returnerar priser framgångsrikt:

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}

Fel: Typ av uppgift som inte stöds

Om ni anger en typ av uppgift som DHL inte stöder:

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}

Fel: Ogiltiga uppgifter

Om uppgifterna är giltiga typer men inte autentiseras framgångsrikt med DHL:

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

Vad som händer efter anslutning

När ert DHL-transportörskonto har anslutits framgångsrikt:

  • Kontot lagras i er organisation och kopplas till era uppgifter
  • Ni kan hämta DHL-fraktpriser med era förhandlade priser (när tillämpligt)
  • Ni kan skapa DHL-fraktetiketter via Zonos API
  • Transportörskontot kan användas över flera sändningar utan att ansluta igen

Nästa steg 

Efter att ni har anslutit ert DHL-transportörskonto:

GraphQL API ReferenceTypes, inputs, and operations used in this guide
Boka en demo

Var den här sidan till hjälp?