DHL Express Mobile 数据 API：运单、运费、揽收

DHL Express · 出行

DHL Express Mobile 是德国邮政敦豪集团（Deutsche Post DHL Group）旗下时效国际快递 DHL Express 的官方 Android 客户端，面向收发 Express 快件的个人与小商家。登录后首页把入境 To Me 与出境 From Me 运单分开，报价发货流程可比较 Express 产品、下 ClickFlow 运单或预约上门揽收、维护地址簿和已绑定的 Express 账号，并进入 MyBill；游客仍可用验证码查询单票运单。On Demand Delivery 让收件人改派，已送达件可查看电子签收证明。应用提供英语、德语、法语、墨西哥西班牙语、巴西葡萄牙语和阿拉伯语，覆盖德国、美国、印度、阿联酋、法国、巴西和墨西哥等市场，在全球时效快递市场与 UPS、FedEx 以及澳大利亚邮政、新邮政等国家邮政并列。

空运运单检查点把 airWayBill、status 和 eddDate 钉在 checkpoints 时间线上，节点带 date、time 与 location；仍可改派时给出 oddLink，或回落到按需改派的 link。出境 From Me 行补充 receiverName、originCountry、toBePickedUp 与 pendingPickupBooking；入境 To Me 行以 userId 加 mobileNo/email 以及可选 postCd/ctyNm 取值。报价卡片按始发/目的地和 packages 返回 productName、productPrice、productCode 与 chargeableWeight，带上 customerAccNo 则切到账号运价；包装目录给出 box_title 与 packageTyCd。

揽收窗口带出 bookingNo、puDate、readyTime 和 closeTime。已绑定 Express 账号列出 accountNo 与 localImp；地址簿保存 addLn1、ctyNm、postCd、taxID 和 EORINumber。ClickFlow 下单返回 shipmentId（卡支付还有 hostedCheckoutId）；已送达件的电子签收 PDF 落在 data；通知收件箱带 awbNumber、actionRequired 与 mngDlvryURL；MyBill SSO 交出 loginURL。TMS 与电商平台把入境 airWayBill/eddDate 接到同一条 To Me 时间线，发货台把 productPrice 对上客户看到的报价，仓库日历写入揽收窗口，计费在询价前核对 accountNo——openData Studio 把这套字段变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

loginV2 登录

POST /v1/express/session osint

在新密码策略开启时（loginV2）签发登录会话的 access_token、refresh_token 与 client_id。

认证方式： Authorization 头携带应用 API 密钥。此时尚无用户令牌；请求体带 username 与 password。

username
password
user_info
country
language
appVersion
access_token
refresh_token
client_id
expires_in
accessToken
refreshToken
clientId
countryCd
statusCode
responseDetail
userId
userEmail
userMobileNo

POST /v1/express/session HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Authorization: <app-api-key>
transactionId: ANDROID-6.1.1-0001

{
  "username": "[email protected]",
  "password": "<password>",
  "user_info": {
    "country": "DE",
    "language": "en",
    "appVersion": "6.1.1"
  }
}

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "rt-7f21c9...",
  "client_id": "cid-88421",
  "expires_in": 3600,
  "accessToken": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refreshToken": "rt-7f21c9...",
  "clientId": "cid-88421",
  "countryCd": "DE",
  "statusCode": "100",
  "responseDetail": {
    "userId": "u-100200",
    "userEmail": "[email protected]",
    "userMobileNo": "+491701234567",
    "userFirstName": "Alex",
    "userLastName": "Keller"
  }
}

跟踪运单

POST /v1/shipments/track opendata

水合跟踪详情页：单票 airWayBill 的检查点时间线，以及 status、eddDate/eddTime、eta、oddLink 与 servicePointUrl。

认证方式： Authorization 中的应用 API 密钥。游客提交运单查询；登录会话附上 authentication.token（access_token）。

airWayBill
countryCode
languageCd
addShipmentToODD
moreDetails
iv
captchaVerificationData
captchaText
postCd
ctyNm
sbNm
checkpoints
date
time
description
location
counter
totalPieces
pIds
status
eddDate
eddTime
eta
oddLink
servicePointUrl

POST /v1/shipments/track HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Authorization: <app-api-key>
transactionId: ANDROID-6.1.1-0001

{
  "airWayBill": "1234567890",
  "countryCode": "DE",
  "languageCd": "en",
  "addShipmentToODD": "N",
  "moreDetails": "Y",
  "iv": "",
  "captchaVerificationData": {
    "captchaText": "AB12",
    "token": "<captcha-token>"
  }
}

[
  {
    "airWayBill": "1234567890",
    "status": "Transit",
    "eddDate": "2026-10-14",
    "eddTime": "18:00",
    "eta": "2026-10-14T16:30:00",
    "oddLink": "https://example.invalid/odd/session/abc",
    "servicePointUrl": "https://example.invalid/locator/de/berlin",
    "checkpoints": [
      {
        "date": "2026-10-12",
        "time": "09:14",
        "description": "Shipment picked up",
        "location": "Frankfurt, DE",
        "counter": 1,
        "id": "cp-1",
        "totalPieces": 1,
        "pIds": [
          "pid-1"
        ]
      }
    ]
  }
]

列出 From Me 运单

POST /v1/shipments/outbound opendata

分页拉取登录首页 From Me（出境）列表：airWayBill、收件人、状态、预计送达以及揽收/自送标记。

认证方式：应用 API 密钥，外加 authentication.token（access_token）与 authentication.login（client_id）。需要已登录会话。未登录时 From Me 列表直接报错。

offset
limit
searchTerm
status
shipmentType
_id
id
airWayBill
receiver
receiverName
shipmentCreatedDate
eddDate
eddTime
location
destinationCity
originCountry
destinationCountry
readStatus
weight
pieces
contents
type
referenceNo
puDate
dropOff
toBePickedUp
pendingPickupBooking

POST /v1/shipments/outbound HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Authorization: <app-api-key>
transactionId: ANDROID-6.1.1-0001

{
  "offset": 0,
  "limit": 20,
  "searchTerm": "",
  "status": "",
  "shipmentType": "N",
  "authentication": {
    "provider": "express",
    "token": "<access_token>",
    "login": "<client_id>"
  }
}

{
  "shipments": [
    {
      "_id": "sh-1001",
      "id": "1234567890",
      "airWayBill": "1234567890",
      "receiver": "Maria Lopez",
      "receiverName": "Maria Lopez",
      "status": "Transit",
      "shipmentCreatedDate": "2026-10-10",
      "eddDate": "2026-10-14",
      "eddTime": "18:00",
      "location": "Mexico City",
      "destinationCity": "Mexico City",
      "originCountry": "DE",
      "destinationCountry": "MX",
      "readStatus": "N",
      "weight": "2.4",
      "pieces": 1,
      "contents": "Documents",
      "type": "ClickFlow",
      "referenceNo": "PO-4419",
      "puDate": "2026-10-10",
      "dropOff": "N",
      "toBePickedUp": "Y",
      "pendingPickupBooking": "N"
    }
  ],
  "totalCount": 1
}

列出 To Me 运单

POST /v1/shipments/inbound opendata

为登录首页分页拉取入境 To Me 运单，键为 userId 加 mobileNo/email，以及可选的默认地址 postCd/ctyNm/sbNm。

认证方式：应用 API 密钥，外加 authentication.token（access_token）与 authentication.login（client_id）。需要已登录会话。 To Me 列表要求已登录用户。

mobileNo
email
userId
offset
limit
languageCode
countryCode
postCd
ctyNm
sbNm
shipmentId
_id
airWayBill
sender
senderName
receiver
receiverName
status
eddDate
eddTime
location
isNCCheckpoint
description
checkpoints
totalCount

POST /v1/shipments/inbound HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Authorization: <app-api-key>
transactionId: ANDROID-6.1.1-0001

{
  "mobileNo": "+491701234567",
  "email": "[email protected]",
  "userId": "u-100200",
  "offset": 0,
  "limit": 20,
  "languageCode": "en",
  "countryCode": "DE",
  "postCd": "60311",
  "ctyNm": "Frankfurt",
  "sbNm": "",
  "authentication": {
    "provider": "express",
    "token": "<access_token>",
    "login": "<client_id>"
  }
}

{
  "shipments": [
    {
      "_id": "ib-2002",
      "id": "0987654321",
      "airWayBill": "0987654321",
      "sender": "Acme GmbH",
      "senderName": "Acme GmbH",
      "receiver": "Alex Keller",
      "receiverName": "Alex Keller",
      "status": "Out for delivery",
      "eddDate": "2026-10-13",
      "eddTime": "12:00",
      "location": "Frankfurt",
      "isNCCheckpoint": "N",
      "description": "Out for delivery",
      "checkpoints": []
    }
  ],
  "totalCount": 1
}

查询 Express 运费

POST /v1/quotes/express openfinance

按始发/目的地、包装与 declatedValue 返回费率选择器使用的 Express 产品报价（productName、productPrice、productCode、eddDate）。

认证方式：应用 API 密钥。游客取柜台公开价；登录会话可带 customerAccNo 取账号运价。

countryCode
rdTm
bkgDtm
dimensionWeight
originCountryCode
originCity
originZip
destinationCountryCode
destinationCity
destinationZip
langCd
currency
declatedValue
customerAccNo
isDocument
packages
promocode
productName
productPrice
productBasePrice
productCode
productLocalCode
eddDate
eddTime
netPrice
chargeableWeight
deliveryOptions

POST /v1/quotes/express HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Authorization: <app-api-key>
transactionId: ANDROID-6.1.1-0001

{
  "countryCode": "DE",
  "rdTm": "10:00:00",
  "bkgDtm": "2026-10-12T09:00:00",
  "dimensionWeight": "KG",
  "packageCount": "2.4",
  "publishDate": "12/10/2026",
  "isDutiable": false,
  "originCountryCode": "DE",
  "originCity": "Frankfurt",
  "originZip": "60311",
  "originSuburb": "",
  "destinationCountryCode": "US",
  "destinationCity": "New York",
  "destinationZip": "10001",
  "destinationSuburb": "",
  "langCd": "en",
  "currency": "EUR",
  "declatedValue": "150.00",
  "customerAccNo": null,
  "isDocument": false,
  "shipmentCategory": "PACKAGE",
  "type": "QUOTE",
  "packages": [
    {
      "weight": "2.4",
      "length": "30",
      "width": "20",
      "height": "15"
    }
  ],
  "isPromocodeValid": "N",
  "promocode": ""
}

{
  "deliveryOptions": [
    {
      "productName": "EXPRESS WORLDWIDE",
      "productPrice": "86.40",
      "productBasePrice": "79.00",
      "currency": "EUR",
      "productCode": "P",
      "productLocalCode": "WPX",
      "eddDate": "2026-10-14",
      "eddTime": "18:00",
      "netPrice": "86.40",
      "chargeableWeight": "2.4",
      "volumetricWeight": "2.0",
      "deliveryOptionServiceDetails": [],
      "addonServices": []
    }
  ]
}

列出包装类型

POST /v1/catalog/packages opendata

返回发货流程使用的分国家包装目录（box_title、packageTyCd、metric/imperial 尺寸、isDocument）。

认证方式：应用 API 密钥。用户令牌可选；目录按 countryCode 与 langCd 取值。

countryCode
langCd
shipmentCategory
id
box_title
maxQuantityOfPackaging
active
customizable
isDocument
shipmentType
countryCd
metric
imperial
packageTyCd
cost
label

POST /v1/catalog/packages HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Authorization: <app-api-key>
transactionId: ANDROID-6.1.1-0001

{
  "countryCode": "DE",
  "langCd": "en",
  "shipmentCategory": "ALL"
}

[
  {
    "id": 12,
    "box_title": "Small box",
    "maxQuantityOfPackaging": "10",
    "active": "Y",
    "customizable": "N",
    "isDocument": "N",
    "shipmentType": "PACKAGE",
    "countryCd": "DE",
    "metric": "{\"length\":\"30\",\"width\":\"20\",\"height\":\"15\",\"dimensionWeight\":\"KG\"}",
    "imperial": "{\"length\":\"12\",\"width\":\"8\",\"height\":\"6\",\"dimensionWeight\":\"LB\"}",
    "packageTyCd": "BOX",
    "shipmentCategory": "PACKAGE",
    "cost": "0",
    "label": "Small"
  }
]

预约上门揽收

POST /v1/pickups/book opendata

预约上门揽收时段，返回确认页使用的 bookingNo、puStatus、puDate、readyTime 与 closeTime。

认证方式：应用 API 密钥。游客预约时段；登录用户附上 authentication.token 与 userId。

puDate
readyTime
closeTime
puCutOffTime
accNumber
companyNm
name
addLn1
ctryCd
ctyNm
postCd
email
mobilePhoneNo
noPieces
dimensionWeight
packageWeight
userId
userConsentAgreement
totalShipmentWeight
totalPackagePieces
bookingNo
puStatus

POST /v1/pickups/book HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Authorization: <app-api-key>
transactionId: ANDROID-6.1.1-0001

{
  "puDate": "20261013",
  "readyTime": "10:00:00",
  "closeTime": "16:00:00",
  "puCutOffTime": "15:00:00",
  "accNumber": "123456789",
  "companyNm": "Keller Studio",
  "name": "Alex Keller",
  "addLn1": "Friedrich-Ebert-Anlage 49",
  "ctryCd": "DE",
  "ctyNm": "Frankfurt",
  "postCd": "60308",
  "email": "[email protected]",
  "mobilePhoneNo": "+491701234567",
  "noPieces": "1",
  "dimensionWeight": "KG",
  "packageWeight": "2.4",
  "userId": "u-100200",
  "userConsentAgreement": null,
  "totalShipmentWeight": "2.4",
  "totalPackagePieces": "1",
  "authentication": {
    "provider": "express",
    "token": "<access_token>",
    "login": "<client_id>"
  }
}

{
  "bookingNo": "BK-2026-88421",
  "puStatus": "BOOKED",
  "puDate": "20261013",
  "readyTime": "10:00:00",
  "closeTime": "16:00:00",
  "accNumber": "123456789",
  "name": "Alex Keller",
  "ctyNm": "Frankfurt",
  "postCd": "60308"
}

列出已预约揽收

POST /v1/pickups opendata

返回登录用户已预约的揽收（bookingNo、puDate、readyTime、closeTime、accNumber），供预约历史列表使用。

认证方式：应用 API 密钥，外加 authentication.token（access_token）与 authentication.login（client_id）。需要已登录会话。需要已登录的 userId。

mobileNo
email
userId
countryCode
_id
bookingNo
puStatus
puDate
readyTime
closeTime
accNumber
companyNm
name
addLn1
ctryCd
ctyNm
postCd
noPieces
packageWeight

POST /v1/pickups HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Authorization: <app-api-key>
transactionId: ANDROID-6.1.1-0001

{
  "mobileNo": "+491701234567",
  "email": "[email protected]",
  "userId": "u-100200",
  "countryCode": "DE",
  "authentication": {
    "provider": "express",
    "token": "<access_token>",
    "login": "<client_id>"
  }
}

[
  {
    "_id": "pu-3003",
    "bookingNo": "BK-2026-88421",
    "puStatus": "BOOKED",
    "puDate": "20261013",
    "readyTime": "10:00:00",
    "closeTime": "16:00:00",
    "accNumber": "123456789",
    "companyNm": "Keller Studio",
    "name": "Alex Keller",
    "addLn1": "Friedrich-Ebert-Anlage 49",
    "ctryCd": "DE",
    "ctyNm": "Frankfurt",
    "postCd": "60308",
    "email": "[email protected]",
    "mobilePhoneNo": "+491701234567",
    "noPieces": "1",
    "packageWeight": "2.4"
  }
]

列出 Express 账号
POST /v1/accounts/express openfinance
返回资料上绑定的 Express 账号（accountNo、localImp），供账号运价与揽收计费使用。
认证方式：应用 API 密钥，外加 authentication.token（access_token）与 authentication.login（client_id）。需要已登录会话。 parameters 为空，由会话识别用户。
- _id
- accountNo
- localImp
```
POST /v1/accounts/express HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Authorization: <app-api-key>
transactionId: ANDROID-6.1.1-0001

{
  "authentication": {
    "provider": "express",
    "token": "<access_token>",
    "login": "<client_id>"
  }
}
```
```
[
  {
    "_id": "acc-1",
    "accountNo": "123456789",
    "localImp": "N"
  }
]
```

列出地址簿

POST /v1/addresses osint

返回登录地址簿（addLn1、ctyNm、postCd、ctryCd、nickName、taxID），供发货、揽收和强制地址跟踪使用。

认证方式：应用 API 密钥，外加 authentication.token（access_token）与 authentication.login（client_id）。需要已登录会话。请求体 userId 来自已登录资料。

userId
_id
userObjID
nickName
name
companyNm
addLn1
addLn2
addLn3
ctryCd
ctryNm
ctyNm
ctryDivNm
sbNm
postCd
isDefault
isResidentialAddress
lat
lgtd
shippingEmail
phoneNo
phoneNoCtryCd
taxID
EORINumber

POST /v1/addresses HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Authorization: <app-api-key>
transactionId: ANDROID-6.1.1-0001

{
  "userId": "u-100200",
  "authentication": {
    "provider": "express",
    "token": "<access_token>",
    "login": "<client_id>"
  }
}

[
  {
    "_id": "addr-1",
    "userObjID": "u-100200",
    "nickName": "Office",
    "name": "Alex Keller",
    "companyNm": "Keller Studio",
    "addLn1": "Friedrich-Ebert-Anlage 49",
    "addLn2": "",
    "addLn3": "",
    "ctryCd": "DE",
    "ctryNm": "Germany",
    "ctyNm": "Frankfurt",
    "ctryDivNm": "Hessen",
    "sbNm": "",
    "postCd": "60308",
    "isDefault": "Y",
    "isResidentialAddress": "N",
    "lat": "50.1109",
    "lgtd": "8.6821",
    "shippingEmail": "[email protected]",
    "phoneNo": "+491701234567",
    "phoneNoCtryCd": "DE",
    "taxID": "",
    "EORINumber": ""
  }
]

列出运单通知

POST /v1/alerts/shipments opendata

返回通知收件箱中的运单提醒（awbNumber、shipmentStatus、actionRequired、mngDlvryURL）。

认证方式：应用 API 密钥，外加 authentication.token（access_token）与 authentication.login（client_id）。需要已登录会话。请求体为 {userId}。

userId
id
awbNumber
shipmentType
shipmentStatus
actionRequired
countryCd
createdDt
content
readStatus
isActive
ackDeliveryStatus
mngDlvryURL

POST /v1/alerts/shipments HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Authorization: <app-api-key>
transactionId: ANDROID-6.1.1-0001

{
  "userId": "u-100200",
  "authentication": {
    "provider": "express",
    "token": "<access_token>",
    "login": "<client_id>"
  }
}

[
  {
    "id": "n-9001",
    "awbNumber": "0987654321",
    "shipmentType": "IB",
    "shipmentStatus": "Out for delivery",
    "actionRequired": "Y",
    "countryCd": "DE",
    "createdDt": "20261013",
    "content": "Your shipment is out for delivery",
    "readStatus": "N",
    "isActive": "Y",
    "ackDeliveryStatus": "N",
    "mngDlvryURL": "https://example.invalid/odd/session/abc"
  }
]

获取按需改派链接

POST /v1/delivery/options opendata

在跟踪结果没有 oddLink 时返回按需改派 URL（link），用于更改派送。

认证方式：应用 API 密钥。登录调用附加 authentication.token；游客仍可用 email/mobileNo 提交 airway_bill_number。

airway_bill_number
countryCode
email
mobileNo
postCd
ctyNm
sbNm
link

POST /v1/delivery/options HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Authorization: <app-api-key>
transactionId: ANDROID-6.1.1-0001

{
  "airway_bill_number": "0987654321",
  "countryCode": "DE",
  "email": "[email protected]",
  "mobileNo": "+491701234567",
  "postCd": "60308",
  "ctyNm": "Frankfurt",
  "sbNm": "",
  "authentication": {
    "provider": "express",
    "token": "<access_token>",
    "login": "<client_id>"
  }
}

{
  "link": "https://example.invalid/odd/session/abc"
}

获取电子签收证明

POST /v1/shipments/epod opendata

按 shipmentId 与最早检查点的 pickUpDate/pickUpTime 返回已送达运单的电子签收 PDF（data）。

认证方式：应用 API 密钥，外加 authentication.token（access_token）与 authentication.login（client_id）。需要已登录会话。提交 shipmentId、pickUpDate 与 pickUpTime。

shipmentId
pickUpDate
pickUpTime
statusCode
data

POST /v1/shipments/epod HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Authorization: <app-api-key>
transactionId: ANDROID-6.1.1-0001

{
  "shipmentId": "1234567890",
  "pickUpDate": "2026-10-12",
  "pickUpTime": "09:14",
  "authentication": {
    "provider": "express",
    "token": "<access_token>",
    "login": "<client_id>"
  }
}

{
  "statusCode": 200,
  "data": "JVBERi0xLjQKJdP..."
}

创建 ClickFlow 运单

POST /v1/shipments opendata

为账号 ClickFlow 创建运单并返回 shipmentId；卡支付还会返回 hostedCheckoutId 与支付网关的 partialRedirectUrl。

认证方式：应用 API 密钥，外加 authentication.token / authentication.login。账号 ClickFlow 在请求体带 transactionID；游客走非账号下单。

type
referenceNo
shipmentCreatedDate
shippingDate
bkgDtm
rdTm
dutiable
productName
productCode
productLocalCode
productPrice
declaredValue
declaredValueCurrency
eddDate
eddTime
totalPackages
totalPackagePieces
totalShipmentWeight
weightUOM
shipmentAccntNo
sender
senderAddress1
senderCtyNm
senderZip
senderCtryCd
receiver
receiverAddress1
receiverCtyNm
receiverZip
receiverCtryCd
isSchedulePickup
shipmentId
hostedCheckoutId
partialRedirectUrl
shipmentAttachments
statusCode

POST /v1/shipments HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Authorization: <app-api-key>
transactionId: ANDROID-6.1.1-0001

{
  "type": "ClickFlow",
  "referenceNo": "PO-4419",
  "shipmentCreatedDate": "2026-10-12",
  "shippingDate": "2026-10-12",
  "bkgDtm": "2026-10-12T09:00:00",
  "rdTm": "10:00:00",
  "dutiable": "N",
  "productName": "EXPRESS WORLDWIDE",
  "productCode": "P",
  "productLocalCode": "WPX",
  "productPrice": "86.40",
  "declaredValue": "150.00",
  "declaredValueCurrency": "EUR",
  "eddDate": "2026-10-14",
  "eddTime": "18:00",
  "totalPackages": "1",
  "totalPackagePieces": "1",
  "totalShipmentWeight": "2.400",
  "weightUOM": "kg",
  "shipmentAccntNo": "123456789",
  "sender": "Alex Keller",
  "senderCompany": "Keller Studio",
  "senderEmail": "[email protected]",
  "senderAddress1": "Friedrich-Ebert-Anlage 49",
  "senderCtyNm": "Frankfurt",
  "senderZip": "60308",
  "senderCtryCd": "DE",
  "senderMobilePhoneNo": "+491701234567",
  "receiver": "Maria Lopez",
  "receiverCompany": "",
  "receiverAddress1": "Paseo de la Reforma 222",
  "receiverCtyNm": "Mexico City",
  "receiverZip": "06600",
  "receiverCtryCd": "MX",
  "isSchedulePickup": "Y",
  "transactionID": "ANDROID-6.1.1-0001",
  "authentication": {
    "provider": "express",
    "token": "<access_token>",
    "login": "<client_id>"
  }
}

{
  "statusCode": "200",
  "shipmentId": "sh-88421",
  "hostedCheckoutId": "hc-1001",
  "partialRedirectUrl": "https://example.invalid/payment-redirect",
  "shipmentAttachments": []
}

获取 MyBill SSO 登录 URL

POST /v1/billing/sso openfinance

在 statusCode 为 200 时返回应用内浏览器打开的 MyBill 账单 SSO URL（loginURL）。

认证方式：应用 API 密钥，外加 authentication.token / authentication.login。侧栏 SSO 请求体为空；MyBill 登录页提交 languageCode、countryCode、email、加密 password 与 iv。

languageCode
countryCode
email
password
iv
statusCode
loginURL

POST /v1/billing/sso HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Authorization: <app-api-key>
transactionId: ANDROID-6.1.1-0001

{
  "languageCode": "en",
  "countryCode": "DE",
  "email": "[email protected]",
  "password": "<encrypted>",
  "iv": "<iv64>",
  "authentication": {
    "provider": "express",
    "token": "<access_token>",
    "login": "<client_id>"
  }
}

{
  "statusCode": "200",
  "loginURL": "https://example.invalid/billing/sso?token=abc"
}

数据类别

登录令牌
运单检查点
出境 From Me 运单
入境 To Me 运单
Express 产品运费
包装类型目录
预约揽收
Express 账号
地址簿
运单通知
按需改派链接
电子签收证明
已创建的 ClickFlow 运单
MyBill SSO 链接

数据使用场景与案例

入境可视订阅
TMS 或电商平台分页拉取 toMeListing 的 airWayBill、status 与 eddDate，再补全 checkpoints（date、time、location），让收件人看到与应用 To Me 时间线相同的轨迹。
出境费率卡
发货台把始发/目的地和包装发到 getRatesV3，把 productName、productPrice、productCode 与 eddDate 对上客户在预约揽收前看到的报价。
揽收日历同步
运营把 userScheduledPickups 的 bookingNo、puDate、readyTime、closeTime、accNumber 写入仓库日历，避免快递员重复预约。
账号与协议运价匹配
计费在调用 getRatesV3 前核对 userAccNos（accountNo、localImp），让 customerAccNo 落到协议 Express 运价而不是柜台公开价。

常见问题

DHL Express Mobile 如何鉴权？

每次请求在 Authorization 头携带应用 API 密钥。登录接口返回 access_token、refresh_token 与 client_id；之后的已登录调用附上 authentication.token 与 authentication.login。游客仍可用验证码跟踪运单、查询 Express 报价，不必带用户令牌。

运单跟踪返回哪些字段？

跟踪接口返回 checkpoints（date、time、description、location、counter），以及 status、eddDate、eddTime、eta、oddLink、servicePointUrl。请求键是 airWayBill；强制地址登记时还可带 postCd/ctyNm/sbNm。

不发货也能询价吗？

可以。报价接口接收 originCountryCode、destinationCountryCode、packages 与 declatedValue，返回 productName、productPrice、productCode、currency 与 eddDate。包装目录先列出 box_title 与 packageTyCd。登录后带上 customerAccNo 会切到已绑定 Express 账号的协议运价。

这些是公开的开发者 API 吗？

不是。它们是应用在 Express 发货、跟踪与账单流程里使用的第一方接口。用户范围的列表（From Me、To Me、揽收、账号、地址、通知、电子签收）需要登录后的 access_token；游客跟踪与游客报价不需要。

与 DHL Express Mobile 相似的应用

UPS — UPS 官方 Android 客户端，提供 1Z 跟踪、运费报价与 My Choice 改派。
FedEx — FedEx 移动客户端，覆盖时效空运单、预约揽收与派送管理跳转。
J&T Express Indonesia — 印尼包裹客户端，提供运单跟踪、预约揽收与自助点地图。
Australia Post — 澳大利亚国家邮政 Android 客户端，覆盖国内包裹、跟踪与网点查询。
Nova Poshta — 乌克兰包裹网络客户端，提供条码跟踪与网点自取。
Delhivery — 印度快递收件应用，提供入境运单状态与派送说明。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

DHL Express Mobile 数据 API：运单、运费、揽收

应用截图

API 端点一览

loginV2 登录

跟踪运单

列出 From Me 运单

列出 To Me 运单

查询 Express 运费

列出包装类型

预约上门揽收

列出已预约揽收

列出 Express 账号

列出地址簿

列出运单通知

获取按需改派链接

获取电子签收证明

创建 ClickFlow 运单

获取 MyBill SSO 登录 URL

数据类别

数据使用场景与案例

入境可视订阅

出境费率卡

揽收日历同步

账号与协议运价匹配

常见问题

与 DHL Express Mobile 相似的应用

更多出行类应用

99 Motorista e Entregador

Amazon Flex

Australia Post

Borzo: Courier Delivery App

相关主题

需要集成这个 App 的数据 API？

DHL Express Mobile 数据 API：运单、运费、揽收

应用截图

API 端点一览

loginV2 登录

跟踪运单

列出 From Me 运单

列出 To Me 运单

查询 Express 运费

列出包装类型

预约上门揽收

列出已预约揽收

列出 Express 账号

列出地址簿

列出运单通知

获取按需改派链接

获取电子签收证明

创建 ClickFlow 运单

获取 MyBill SSO 登录 URL

数据类别

数据使用场景与案例

入境可视订阅

出境费率卡

揽收日历同步

账号与协议运价匹配

常见问题

相关应用

与 DHL Express Mobile 相似的应用

更多出行类应用

99 Motorista e Entregador

Amazon Flex

Australia Post

Borzo: Courier Delivery App

相关主题

需要集成这个 App 的数据 API？