Forbind DHL-transportørkonto

Sikre forbindelsen til din DHL-transportørkonto for at få adgang til forhandlede fragtpriser og oprette labels direkte gennem Zonos.

Kom i gang 

Processen med at forbinde din DHL-transportørkonto validerer dine legitimationsoplysninger og sikrer, at din konto er korrekt konfigureret til at hente priser og generere fragtlabels. Når du forbinder din DHL-konto, foretager Zonos en testopkald for at verificere, at forbindelsen fungerer korrekt, før dine legitimationsoplysninger gemmes.

For at registrere dig hos DHL Express eller opsætte via dit Zonos Dashboard, følg trinene i denne vejledning.

Hvordan DHL-transportørkontoen fungerer 

Ved at forbinde din DHL-transportørkonto:

• Valideres, at du har angivet de korrekte legitimationsoplysninger for DHL
• Gennemføres et live ratingopkald til DHL API'et for at bekræfte, at legitimationsoplysningerne er gyldige
• Din tilsluttede konto gemmes i Zonos til fremtidig vurdering af forsendelser og oprettelse af labels
• Kontoens oplysninger, inklusive din DHL-konto og rate-typen, returneres

Når den er forbundet, kan din DHL-transportørkonto bruges til at hente realtidsfragtpriser baseret på dine forhandlede priser (hvis relevant) og oprette DHL-fragtlabels.

Forbind din DHL-konto 

Brug mutation carrierAccountConnect til at forbinde din DHL-transportørkonto med dine legitimationsoplysninger.

Mutation

Brug denne mutation til at forbinde din DHL-transportørkonto og validere dine legitimationsoplysninger.

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-fraktkode, rate type, og dine DHL-kontooplysninger.

{
  "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ølgende legitimationsoplysninger:

• API_KEY - Din DHL API-nøgle
• API_PASSWORD - Din DHL API-adgangskode
• ACCOUNT_NUMBER - Din DHL-kontonummer

Du kan finde disse legitimationsoplysninger i din DHL-kontoportal eller ved at kontakte din DHL-kontoansvarlige.

Eksempler på svar

Succesfuld forbindelse

Når legitimationsoplysningerne er gyldige, og DHL returnerer taksterne med succes:

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

Fejl: Ikke understøttet legitimationsoplysningstype

Hvis du angiver en legitimationsoplysningstype, som DHL ikke understøtter:

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

Fejl: Ugyldige legitimationsoplysninger

Hvis legitimationsoplysningerne er gyldige, men ikke autentificeres hos DHL:

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

Hvad sker der efter tilslutning

Når din DHL-transportørkonto er tilsluttet.

• Kontoen gemmes i din organisation og er tilknyttet dine legitimationsoplysninger
• Du kan hente DHL-fragtpriser ved hjælp af dine forhandlede priser (når det er relevant)
• Du kan oprette DHL-fraktetiketter gennem Zonos API
• Kontoen kan bruges til flere forsendelser uden at skulle oprette forbindelsen igen

Næste skridt 

Efter tilslutning af din DHL-transportørkonto:

• Opret en forsendelse - Generér fragtetiketter ved hjælp af din tilsluttede DHL-transportørkonto
• Beregn landed cost - Få nøjagtige told- og afgiftsberegninger for internationale forsendelser
• Se understøttede transportører - Se alle transportører og serviceniveauer tilgængelige gennem Zonos