下单接口
开发中
POST
/openapi/jd/order/create
请求参数
Query 参数
Header 参数
Body 参数application/json必填
示例
{
"body": {
"customerCode": "KH20000010767-111",
"customerDeptCode": "KH20000010767-111",
"customerOrderCode": "HanJintest260623003-111",
"customsDetail": {
"invoiceDate": "",
"invoiceNumber": "",
"termsOfTrade": ""
},
"packages": [
{
"commodities": [
{
"countryOfOrigin": "CN",
"currencyCode": "USD",
"customerCommodityCode": "test20260424",
"declaredValue": 5,
"enName": "pen",
"height": 0.0,
"hsCode": "",
"isCharged": 0,
"isLiquid": 0,
"isMagnetic": 0,
"isPowder": 0,
"length": 0.0,
"name": "钢笔",
"quantity": 1,
"unCode": "",
"unitOfDimension": "CM",
"unitOfWeight": "KG",
"weight": 0.1,
"width": 0.0
}
],
"height": 1.0,
"length": 10.0,
"packageCode": "HanJintest260623003",
"weight": 0.1,
"width": 1.0
}
],
"recipient": {
"accessPointCode": "",
"accessPointName": "",
"addressLines": [
"15661 Canon Ln",
"",
""
],
"city": "Chino Hills",
"companyName": "cai",
"country": "US",
"emailAddress": "",
"houseNumber": "",
"name": "cai",
"phoneNumber": "6061234566",
"phoneNumberExtension": "",
"postalCode": "91709",
"stateOrProvince": "CA"
},
"referenceNumbers": [
"JDW101221869443-111",
""
],
"salesPlatOrderCode": "others",
"serviceCode": "P10047",
"shipper": {
"addressLines": [
"Lô 4 đường số 15 KCN tân đức",
"",
""
],
"city": "Long An",
"companyName": "JDL",
"country": "VN",
"emailAddress": "",
"houseNumber": "",
"name": "ping",
"phoneNumber": "0970000000",
"postalCode": "17727",
"stateOrProvince": "Long An"
},
"unitOfDimension": "CM",
"unitOfWeight": "KG",
"valueAddedService": {
"signatureService": 0
},
"waybillCode": "JDW101221869443-111"
},
"query_params": {
"path": [
"/order/create"
],
"app_key": [
"146466c3d5fb4c76a0388b008dfbfc90"
],
"sign": [
"E507FF10BCE44DEEC06AC21595B928DB"
],
"timestamp": [
"2026-06-23 07:16:57"
]
}
}请求示例代码
Shell
HTTP
Python
Java
PHP
Go
C
C#
JavaScript
Swift
Dart
Objective-C
Ruby
OCaml
R
请求示例请求示例
Shell
HTTP
Python
Java
curl --location '/openapi/jd/order/create?path=%2Forder%2Fcreate&app_key=×tamp=&sign=undefined&md5_content=undefined&msg_name=Service_Provider_Standard' \
--header 'Accept-Language: en' \
--header 'Content-Type: application/json' \
--data '{
"body": {
"customerCode": "KH20000010767-111",
"customerDeptCode": "KH20000010767-111",
"customerOrderCode": "HanJintest260623003-111",
"customsDetail": {
"invoiceDate": "",
"invoiceNumber": "",
"termsOfTrade": ""
},
"packages": [
{
"commodities": [
{
"countryOfOrigin": "CN",
"currencyCode": "USD",
"customerCommodityCode": "test20260424",
"declaredValue": 5,
"enName": "pen",
"height": 0.0,
"hsCode": "",
"isCharged": 0,
"isLiquid": 0,
"isMagnetic": 0,
"isPowder": 0,
"length": 0.0,
"name": "钢笔",
"quantity": 1,
"unCode": "",
"unitOfDimension": "CM",
"unitOfWeight": "KG",
"weight": 0.1,
"width": 0.0
}
],
"height": 1.0,
"length": 10.0,
"packageCode": "HanJintest260623003",
"weight": 0.1,
"width": 1.0
}
],
"recipient": {
"accessPointCode": "",
"accessPointName": "",
"addressLines": [
"15661 Canon Ln",
"",
""
],
"city": "Chino Hills",
"companyName": "cai",
"country": "US",
"emailAddress": "",
"houseNumber": "",
"name": "cai",
"phoneNumber": "6061234566",
"phoneNumberExtension": "",
"postalCode": "91709",
"stateOrProvince": "CA"
},
"referenceNumbers": [
"JDW101221869443-111",
""
],
"salesPlatOrderCode": "others",
"serviceCode": "P10047",
"shipper": {
"addressLines": [
"Lô 4 đường số 15 KCN tân đức",
"",
""
],
"city": "Long An",
"companyName": "JDL",
"country": "VN",
"emailAddress": "",
"houseNumber": "",
"name": "ping",
"phoneNumber": "0970000000",
"postalCode": "17727",
"stateOrProvince": "Long An"
},
"unitOfDimension": "CM",
"unitOfWeight": "KG",
"valueAddedService": {
"signatureService": 0
},
"waybillCode": "JDW101221869443-111"
},
"query_params": {
"path": [
"/order/create"
],
"app_key": [
"146466c3d5fb4c76a0388b008dfbfc90"
],
"sign": [
"E507FF10BCE44DEEC06AC21595B928DB"
],
"timestamp": [
"2026-06-23 07:16:57"
]
}
}'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"code": 1000,
"message": "收件人地址不完整",
"errorCode": "E001",
"data": {
"waybillCode": "JDW100672131893",
"masterTrackingNumber": "1Z999AA1234567890",
"packages": [
{
"packageCode": "JDW100672131893-1-1-",
"trackingNumber": "1234567890",
"documents": [
{
"docType": "LABEL",
"format": "PDF",
"content": "JVBERi0xLjQNCiWio4+TDQo2IDAgb2JqDQo8PC9Gb250IDw8L0ZOVDAgMyAwIFIgL0ZOVDEgNCAwIFIgL...."
}
]
}
]
}
}修改于 2026-06-23 08:00:06