Vervoerderaccount DHL verbinden

Verbind uw DHL-vervoerderaccount veilig om toegang te krijgen tot onderhandelde verzendtarieven en labels rechtstreeks via Zonos te maken.

Aan de slag 

Het proces voor het verbinden van uw DHL-vervoerderaccount valideert uw inloggegevens en zorgt ervoor dat uw account correct is geconfigureerd om tarieven op te halen en verzendlabels te genereren. Wanneer u uw DHL-account verbindt, voert Zonos een testrating uit om te verifiëren dat de verbinding correct werkt voordat uw inloggegevens worden opgeslagen.

Om u te registreren bij DHL Express of via uw Zonos Dashboard in te stellen, volgt u de stappen in deze gids.

Hoe werkt het verbinden van een DHL-vervoerderaccount 

Het verbinden van uw DHL-vervoerderaccount:

• Valideert dat u de juiste inloggegevens voor DHL hebt verstrekt
• Voert een live rating-aanroep uit naar de DHL API om te bevestigen dat de inloggegevens geldig zijn
• Slaat uw verbonden account op in Zonos voor toekomstige verzendingen en labelgeneratie
• Geeft de details van de verbonden account terug, inclusief uw DHL-accountgegevens en rate type

Zodra de verbinding tot stand is gebracht, kan uw DHL-vervoerderaccount worden gebruikt om realtime verzendtarieven op te halen op basis van uw onderhandelde tarieven (indien van toepassing) en DHL-verzendlabels te maken.

Verbind uw DHL-account 

Gebruik de carrierAccountConnect-mutatie om uw DHL-vervoerderaccount te verbinden met uw inloggegevens.

Mutatie

Gebruik deze mutatie om uw DHL-vervoerderaccount te verbinden en uw inloggegevens te valideren.

mutation CarrierAccountConnect($input: CarrierAccountConnectInput!) {
  carrierAccountConnect(input: $input) {
    errors
    carrierAccount {
      credentialProvider
      id
      integrationType
      organization
      rateType
      carrier {
        id
        code
        name
      }
      credentials {
        type
        value
      }
    }
  }
}

Variabelen

De mutatie vereist de DHL-vervoerdercode, rate type, en uw DHL-accountgegevens.

{
  "input": {
    "carrierCode": "DHL",
    "rateType": "NEGOTIATED",
    "credentials": [
      {
        "type": "API_KEY",
        "value": "actual_api_key_value"
      },
      {
        "type": "API_PASSWORD",
        "value": "actual_api_password_value"
      },
      {
        "type": "ACCOUNT_NUMBER",
        "value": "actual_account_number_value"
      }
    ]
  }
}

DHL vereist de volgende soorten verificatiegegevens:

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

U kunt deze referenties vinden in uw DHL-accountportaal of neem contact op met uw DHL-accountmanager.

Responsvoorbeelden

Succesvolle verbinding

Wanneer de referenties geldig zijn en DHL met succes tarieven retourneert:

{
  "data": {
    "carrierAccountConnect": {
      "errors": [],
      "carrierAccount": {
        "credentialProvider": "ORGANIZATION",
        "id": "carrier_account_123",
        "integrationType": "REST",
        "organization": "organization_id",
        "rateType": "NEGOTIATED",
        "carrier": {
          "id": "carrier_123",
          "code": "dhl",
          "name": "DHL"
        },
        "credentials": [
          {
            "type": "API_KEY",
            "value": "actual_api_key_value"
          },
          {
            "type": "API_PASSWORD",
            "value": "actual_api_password_value"
          },
          {
            "type": "ACCOUNT_NUMBER",
            "value": "actual_account_number_value"
          }
        ]
      }
    }
  }
}

Fout: Niet-ondersteund type inloggegevens

Als u een inloggegevens-type opgeeft dat DHL niet ondersteunt:

{
  "data": {
    "carrierAccountConnect": {
      "errors": ["Credential type SITE_ID is not supported by carrier DHL"],
      "carrierAccount": null
    }
  }
}

Fout: Ongeldige inloggegevens

Als de inloggegevens van het juiste type zijn, maar zich niet met DHL kunnen authenticeren:

{
  "data": {
    "carrierAccountConnect": {
      "errors": ["Failed to get rating from DHL API"],
      "carrierAccount": null
    }
  }
}

Wat gebeurt er na de verbinding

• Het account wordt opgeslagen in uw organisatie en gekoppeld aan uw inloggegevens.
• U kunt DHL-verzendtarieven opvragen tegen uw onderhandelde tarieven (indien van toepassing).
• U kunt DHL-verzendlabels aanmaken via de Zonos API.
• Het vervoerderaccount kan worden gebruikt voor meerdere zendingen zonder opnieuw te hoeven verbinden.

Volgende stappen 

• Maak een zending aan - Genereer verzendlabels met uw verbonden DHL-vervoerderaccount
• Bereken landed cost - Krijg nauwkeurige douane- en belastingberekeningen voor internationale zendingen
• Bekijk ondersteunde vervoerders - Zie alle vervoerders en serviceniveaus die beschikbaar zijn via Zonos