- 开放平台使用说明
- 其他资料
- 包裹接口
- 非包裹结构
- 数据模型
查询运单
开发中
Test environment
https://test-oms.hanjinexp.com/openapi/customer/
Test environment
https://test-oms.hanjinexp.com/openapi/customer/
POST
https://test-oms.hanjinexp.com/openapi/customer/
最后修改时间：2025-12-16 12:35:39
责任人：未设置
请求参数
Authorization
Bearer Token
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************or
Body 参数application/json必填
示例
{
"num_type": 1,
"num": "CS1298738912739131"
}请求示例代码
Shell
HTTP
Python
Java
PHP
Go
C
C#
JavaScript
Swift
请求示例请求示例
Shell
HTTP
Python
Java
curl --location --request POST 'https://test-oms.hanjinexp.com/openapi/customer/query_order/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"num_type": 1,
"num": "CS1298738912739131"
}'返回响应
🟢200成功响应-对象
application/json
Body
示例
{
"code": 200,
"success": true,
"detail": "操作成功",
"data": {
"customer_order_num": "40",
"service_code": "P10006",
"order_remark": "veniam nostrud",
"is_confirm_label": false,
"ship_date": "2025-12-13",
"need_track": "Y",
"is_overseas_return": true,
"is_signature": true,
"shipper_info": {
"full_name": "Allen Jin Gned",
"first_name": "Allen",
"middle_name": "Jin",
"last_name": "Gned",
"company": "company_name",
"phone": "+1 12345678",
"mobile": "+1 102345678",
"email": "contact_email",
"country": "US",
"postcode": "90001",
"province": "CA",
"city": "Los Angeles",
"region": "region",
"street": "street",
"house_no": "13",
"address": "尹街79090号",
"tax_id": "TAX12345678",
"creds_type": "PCCC",
"creds_id": "P12345678910",
"creds_issuing_code": "code",
"creds_issuing_name": "name",
"creds_issuing_date": "2021-12-13",
"creds_birthday": "1985-12-12"
},
"consignee_info": {
"full_name": "Allen Jin Gned",
"first_name": "Allen",
"middle_name": "Jin",
"last_name": "Gned",
"company": "company_name",
"phone": "+1 12345678",
"mobile": "+1 102345678",
"email": "contact_email",
"country": "US",
"postcode": "90001",
"province": "CA",
"city": "Los Angeles",
"region": "region",
"street": "street",
"house_no": "13",
"address": "义巷172号",
"tax_id": "TAX12345678",
"creds_type": "PCCC",
"creds_id": "P12345678910",
"creds_issuing_code": "code",
"creds_issuing_name": "name",
"creds_issuing_date": "2021-12-13",
"creds_birthday": "1985-12-12"
},
"return_info": {
"full_name": "Allen Jin Gned",
"first_name": "Allen",
"middle_name": "Jin",
"last_name": "Gned",
"company": "company_name",
"phone": "+1 12345678",
"mobile": "+1 102345678",
"email": "contact_email",
"country": "US",
"postcode": "90001",
"province": "CA",
"city": "Los Angeles",
"region": "region",
"street": "street",
"house_no": "13",
"address": "谏巷9号",
"tax_id": "TAX12345678",
"creds_type": "PCCC",
"creds_id": "P12345678910",
"creds_issuing_code": "code",
"creds_issuing_name": "name",
"creds_issuing_date": "2021-12-13",
"creds_birthday": "1985-12-12"
},
"parcel_list": [
{
"parcel_num": "47",
"weight": 0.001,
"length": null,
"width": "0.1",
"height": "0.1",
"item_list": [
{
"sale_currency": "USD",
"sale_price": 1.567,
"brand": "Nike",
"model": "B125",
"name": "bag",
"sku": "SKU-12124",
"remark": "H-A-0001",
"desc": "书包",
"import_declared": "bag",
"export_declared": "书包",
"export_hscode": "3926 9033",
"import_hscode": "3926 9033",
"desc_en": "Purple",
"export_price": 1.112,
"export_price_currency": "CNY",
"import_price": 1.145,
"sale_link": "https://punctual-cassava.org",
"length": 0.23,
"width": 2.6,
"height": 3.6,
"weight": 1.678,
"qty": 1,
"material": "nylon",
"uses": "Personal use",
"manuacture_name": "manuFacture_name",
"manufacture_address": "nanshan qianhai 888",
"manufacture_postcode": "518000",
"manufacture_city": "shenzhen",
"manufacture_state": "guangdong",
"manufacture_country": "CN",
"manufacture_code": "62",
"manufacture_mid": "70",
"manuacture_country": "CN",
"import_price_currency": "USD"
},
{
"sale_currency": "USD",
"sale_price": 1.567,
"brand": "Nike",
"model": "B125",
"name": "bag",
"sku": "SKU-12124",
"remark": "H-A-0001",
"desc": "书包",
"import_declared": "bag",
"export_declared": "书包",
"export_hscode": "3926 9033",
"import_hscode": "3926 9033",
"desc_en": "Purple",
"export_price": 1.112,
"export_price_currency": "CNY",
"import_price": 1.145,
"sale_link": "https://punctual-cassava.org",
"length": 0.23,
"width": 2.6,
"height": 3.6,
"weight": 1.678,
"qty": 1,
"material": "nylon",
"uses": "Personal use",
"manuacture_name": "manuFacture_name",
"manufacture_address": "nanshan qianhai 888",
"manufacture_postcode": "518000",
"manufacture_city": "shenzhen",
"manufacture_state": "guangdong",
"manufacture_country": "CN",
"manufacture_code": "13",
"manufacture_mid": "39",
"manuacture_country": "CN",
"import_price_currency": "USD"
}
]
},
{
"parcel_num": "65",
"weight": 0.001,
"length": null,
"width": "0.1",
"height": "0.1",
"item_list": [
{
"sale_currency": "USD",
"sale_price": 1.567,
"brand": "Nike",
"model": "B125",
"name": "bag",
"sku": "SKU-12124",
"remark": "H-A-0001",
"desc": "书包",
"import_declared": "bag",
"export_declared": "书包",
"export_hscode": "3926 9033",
"import_hscode": "3926 9033",
"desc_en": "Purple",
"export_price": 1.112,
"export_price_currency": "CNY",
"import_price": 1.145,
"sale_link": "https://punctual-cassava.org",
"length": 0.23,
"width": 2.6,
"height": 3.6,
"weight": 1.678,
"qty": 1,
"material": "nylon",
"uses": "Personal use",
"manuacture_name": "manuFacture_name",
"manufacture_address": "nanshan qianhai 888",
"manufacture_postcode": "518000",
"manufacture_city": "shenzhen",
"manufacture_state": "guangdong",
"manufacture_country": "CN",
"manufacture_code": "45",
"manufacture_mid": "49",
"manuacture_country": "CN",
"import_price_currency": "USD"
},
{
"sale_currency": "USD",
"sale_price": 1.567,
"brand": "Nike",
"model": "B125",
"name": "bag",
"sku": "SKU-12124",
"remark": "H-A-0001",
"desc": "书包",
"import_declared": "bag",
"export_declared": "书包",
"export_hscode": "3926 9033",
"import_hscode": "3926 9033",
"desc_en": "Purple",
"export_price": 1.112,
"export_price_currency": "CNY",
"import_price": 1.145,
"sale_link": "https://punctual-cassava.org",
"length": 0.23,
"width": 2.6,
"height": 3.6,
"weight": 1.678,
"qty": 1,
"material": "nylon",
"uses": "Personal use",
"manuacture_name": "manuFacture_name",
"manufacture_address": "nanshan qianhai 888",
"manufacture_postcode": "518000",
"manufacture_city": "shenzhen",
"manufacture_state": "guangdong",
"manufacture_country": "CN",
"manufacture_code": "39",
"manufacture_mid": "21",
"manuacture_country": "CN",
"import_price_currency": "USD"
}
]
}
],
"tax_info": {
"mode": "2",
"type": "IOSS",
"num": "13545646132",
"company": "Company Name",
"country": "US",
"address": "address address 12345"
}
}
}🔴500服务器无法连接
🟠401认证失败
修改于 2025-12-16 12:35:39