- 开放平台使用说明
- 其他资料
- 包裹接口
- 非包裹结构
- 数据模型
下单接口
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 16:23:48
责任人：未设置
请求参数
Authorization
Bearer Token
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************or
Body 参数application/json必填
示例
{
"customer_order_num": "string",
"service_code": "P10006",
"order_remark": "string",
"is_confirm_label": false,
"ship_date": "2025-12-13",
"need_track": "Y",
"is_overseas_return": false,
"is_signature": false,
"shipper_info": {
"address_num": "AD101312464"
},
"consignee_info": {
"address_num": "AD101312464"
},
"return_info": {
"address_num": "AD101312464"
},
"handover_info": {
"address_num": "AD101312464"
},
"pickup_info": {
"address_num": "AD101312464"
},
"parcel_list": [
{
"parcel_num": "string",
"weight": 0.001,
"length": "0.1",
"width": "0.1",
"height": "0.1",
"item_list": [
{
"export_declared": "书包",
"export_hscode": "3926 9033",
"export_price": 0.001,
"export_price_currency": "CNY",
"import_declared": "bag",
"import_hscode": "3926 9033",
"import_price": 1.145,
"import_price_currency": "USD",
"sku": "SKU-12124",
"sale_price": 0.001,
"sale_currency": "USD",
"sale_link": "https://punctual-cassava.org",
"qty": 1,
"weight": 0.001,
"remark": "H-A-0001",
"name": "bag",
"desc": "书包",
"desc_en": "Purple",
"length": 0.01,
"width": 0.01,
"height": 0.01,
"material": "nylon",
"uses": "Personal use",
"brand": "Nike",
"model": "B125",
"manuacture_country": "CN",
"manuacture_name": "manuFacture_name",
"manufacture_code": "string",
"manufacture_mid": "string",
"manufacture_country": "CN",
"manufacture_state": "guangdong",
"manufacture_city": "shenzhen",
"manufacture_postcode": "518000",
"manufacture_address": "nanshan qianhai 888"
}
]
}
],
"tax_info": {
"mode": "2",
"type": "IOSS",
"num": "13545646132",
"company": "Company Name",
"country": "US",
"address": "address address 12345"
}
}请求示例代码
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/order_create/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"customer_order_num": "string",
"service_code": "P10006",
"order_remark": "string",
"is_confirm_label": false,
"ship_date": "2025-12-13",
"need_track": "Y",
"is_overseas_return": false,
"is_signature": false,
"shipper_info": {
"address_num": "AD101312464"
},
"consignee_info": {
"address_num": "AD101312464"
},
"return_info": {
"address_num": "AD101312464"
},
"handover_info": {
"address_num": "AD101312464"
},
"pickup_info": {
"address_num": "AD101312464"
},
"parcel_list": [
{
"parcel_num": "string",
"weight": 0.001,
"length": "0.1",
"width": "0.1",
"height": "0.1",
"item_list": [
{
"export_declared": "书包",
"export_hscode": "3926 9033",
"export_price": 0.001,
"export_price_currency": "CNY",
"import_declared": "bag",
"import_hscode": "3926 9033",
"import_price": 1.145,
"import_price_currency": "USD",
"sku": "SKU-12124",
"sale_price": 0.001,
"sale_currency": "USD",
"sale_link": "https://punctual-cassava.org",
"qty": 1,
"weight": 0.001,
"remark": "H-A-0001",
"name": "bag",
"desc": "书包",
"desc_en": "Purple",
"length": 0.01,
"width": 0.01,
"height": 0.01,
"material": "nylon",
"uses": "Personal use",
"brand": "Nike",
"model": "B125",
"manuacture_country": "CN",
"manuacture_name": "manuFacture_name",
"manufacture_code": "string",
"manufacture_mid": "string",
"manufacture_country": "CN",
"manufacture_state": "guangdong",
"manufacture_city": "shenzhen",
"manufacture_postcode": "518000",
"manufacture_address": "nanshan qianhai 888"
}
]
}
],
"tax_info": {
"mode": "2",
"type": "IOSS",
"num": "13545646132",
"company": "Company Name",
"country": "US",
"address": "address address 12345"
}
}'返回响应
🟢200成功响应-对象
application/json
Body
示例
{
"code": 200,
"success": true,
"detail": "操作成功",
"data": {
"customer_order_num": "CS19287389172391",
"order_num": "HGE25102983123",
"tracking_num": "42023871237189237913",
"service_code": "P10006",
"order_remark": "test",
"create_time": "2025-12-15 15:09:05",
"weight": "1.234"
}
}🔴500服务器无法连接
🟠401认证失败
修改于 2025-12-16 16:23:48