DOCS
홈글로벌 이커머스 Fulfillment 운송사 API를 통해 연결

DHL Carrier Account 연결

DHL carrier account를 안전하게 연결하여 negotiated shipping rates에 액세스하고 Zonos를 통해 직접 label을 생성하세요.

시작하기 

DHL carrier account 연결 프로세스는 credential을 validation하고 account가 rate 조회 및 shipping label 생성을 위해 올바르게 구성되었는지 확인합니다. DHL account를 연결하면 Zonos가 test rating call을 수행하여 credential을 저장하기 전에 연결이 올바르게 작동하는지 verification합니다.

DHL Express에 등록하거나 Zonos Dashboard를 통해 설정하려면 이 가이드의 단계를 따르세요.

DHL carrier account 연결 작동 방식 

DHL carrier account 연결:

  • DHL에 올바른 credential type을 제공했는지 validation
  • credential이 유효한지 확인하기 위해 DHL API에 live rating call 수행
  • 향후 shipment rating 및 label creation을 위해 연결된 account를 Zonos에 저장
  • DHL account 정보 및 rate type을 포함한 연결된 account 세부 정보 반환

연결되면 DHL carrier account를 사용하여 negotiated rate(해당하는 경우)를 기반으로 real-time shipping rate를 얻고 DHL shipping label을 생성할 수 있습니다.

DHL account 연결 

carrierAccountConnect mutation을 사용하여 credential으로 DHL carrier account를 연결합니다.

Mutation

이 mutation을 사용하여 DHL carrier account를 연결하고 credential을 validation합니다.

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}

Variables

mutation에는 DHL carrier code, rate type 및 DHL account credential이 필요합니다.

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에는 다음 credential type이 필요합니다:

  • API_KEY - DHL API key
  • API_PASSWORD - DHL API password
  • ACCOUNT_NUMBER - DHL account number

이 credential은 DHL account portal에서 찾거나 DHL account 담당자에게 문의할 수 있습니다.

응답 예시

연결 성공

credential이 유효하고 DHL이 rate를 성공적으로 반환하면:

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}

Error: 지원되지 않는 credential type

DHL이 지원하지 않는 credential type을 제공하면:

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}

Error: 잘못된 credential

credential type은 유효하지만 DHL과 authentication에 실패하면:

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

연결 후 발생하는 일

DHL carrier account가 성공적으로 연결되면:

  • account가 organization에 저장되고 credential에 연결됩니다
  • negotiated rate(해당하는 경우)를 사용하여 DHL shipping rate를 조회할 수 있습니다
  • Zonos API를 통해 DHL shipping label을 생성할 수 있습니다
  • 재연결 없이 여러 shipment에 carrier account를 사용할 수 있습니다

다음 단계 

DHL carrier account를 연결한 후:

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

CarrierAccountConnectInput

MUTATIONS

carrierAccountConnect

이 페이지가 도움이 되었나요?

지원 받기·법적 문서·© 2026 Zonos
이 페이지에서:
  • DHL Carrier Account 연결
  • DHL carrier account 연결 작동 방식
  • DHL account 연결