Anslut DHL-transportörkonto

Säkert ansluta ditt DHL-transportörkonto för att få tillgång till förhandlade fraktpriser och skapa etiketter direkt via Zonos.

Kom igång 

Processen för anslutning av DHL-transportörkontot verifierar dina uppgifter och säkerställer att ditt konto är korrekt konfigurerat för att hämta priser och skapa fraktetiketter. När du ansluter ditt DHL-konto utför Zonos ett testberäkningsanrop för att verifiera att anslutningen fungerar korrekt innan dina uppgifter lagras.

För att registrera dig hos DHL Express eller sätta upp via din Zonos instrumentpanel, följ stegen i denna handledning.

Hur DHL-kontots anslutning fungerar 

Anslutningen av DHL-kontot:

• Validerar att du har angett korrekta autentiseringsuppgifter för DHL
• Gör ett live-beräkningsanrop mot DHL:s API för att bekräfta att uppgifterna är giltiga
• Sparar ditt anslutna konto i Zonos för framtida fraktberäkningar och skapande av fraktetiketter
• Returnerar detaljerna för det anslutna kontot, inklusive din DHL-kontoinformation och rate-typ

När det är anslutet kan ditt DHL-konto användas för att få realtidsfraktpriser baserade på dina förhandlade priser (om tillämpligt) och skapa DHL-fraktetiketter.

Anslut ditt DHL-konto 

Använd mutationen carrierAccountConnect för att ansluta ditt DHL-konto med dina uppgifter.

Mutation

Använd denna mutation för att ansluta ditt DHL-konto och verifiera dina uppgifter.

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

Variabler

Mutationen kräver DHL-transportörkod, rate typ, och dina DHL-kontouppgifter.

{
  "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 kräver följande referenstyper:

• API_KEY - Din DHL API-nyckel
• API_PASSWORD - Ditt DHL API-lösenord
• ACCOUNT_NUMBER - Ditt DHL-kontonummer

Du kan hitta dessa uppgifter i DHL:s kontoportal eller genom att kontakta din DHL-kundansvarige.

Exempel på svar

Framgångsrik anslutning

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

{
  "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"
          }
        ]
      }
    }
  }
}

Fel: Typ av behörighet som inte stöds

Om du anger en behörighetstyp som DHL inte stöder:

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

Fel: Ogiltiga inloggningsuppgifter

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

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

Vad händer efter anslutning

• Kontot lagras i din organisation och kopplas till dina inloggningsuppgifter
• Du kan hämta DHL-fraktpriser med dina förhandlade priser (när det är tillämpligt)
• Du kan skapa DHL-fraktetiketter via Zonos API
• Kontot för leverantören kan användas för flera försändelser utan att ansluta igen

Nästa steg 

• Skapa en försändelse - Generera fraktetiketter med ditt anslutna DHL-leverantörskonto
• Beräkna landed cost - Få exakta tull- och skatteberäkningar för internationella försändelser
• Visa stödda leverantörer - Se alla leverantörer och tjänstenivåer som finns tillgängliga genom Zonos