下单接口
开发中
POST
/order/create
请求参数
Query 参数
Body 参数application/json必填
示例
{
"waybillCode": "JDW100672131893",
"customerCode": "KH20000002811",
"customerDeptCode": "FBU200000028110001",
"customerOrderCode": "452469-1",
"salesPlat": "JD.com",
"salesPlatOrderCode": "452469-1",
"unitOfWeight": "KG",
"unitOfDimension": "CM",
"referenceNumbers": [
"SO20250000301"
],
"serviceCode": "01",
"shipper": {
"name": "Jacky",
"companyName": "JDL corp",
"phoneNumber": "11512391123",
"phoneNumberExtension": "332",
"postalCode": "14414",
"addressLines": [
"8233 Lake Rd"
],
"country": "US",
"stateOrProvince": "NY",
"city": "New York",
"district": "Port Melbourne",
"town": "Well Village",
"houseNumber": "22",
"taxId": [
{
"taxIdNumber": "101321111310",
"taxIdType": "IOSS"
}
]
},
"recipient": {
"name": "Jacky",
"companyName": "JDL corp",
"phoneNumber": "11512391123",
"phoneNumberExtension": "332",
"postalCode": "14414",
"addressLines": [
"8233 Lake Rd"
],
"country": "US",
"stateOrProvince": "NY",
"city": "New York",
"district": "Port Melbourne",
"town": "Well Village",
"houseNumber": "22",
"accessPointCode": "NOE12",
"accessPointName": "NOE12-1332 POINT"
},
"packages": [
{
"weight": 1.5,
"width": 1,
"length": 2,
"height": 2.55,
"packageCode": "JDW100672131893-1-1-",
"commodities": [
{
"declaredValue": 100.0,
"currencyCode": "USD",
"commodityCode": "FG001",
"customerCommodityCode": "SKU001",
"weight": 1.5,
"width": 20.5,
"length": 30.5,
"height": 10.5,
"unitOfWeight": "KG",
"unitOfDimension": "CM",
"quantity": 2,
"name": "手机",
"enName": "Mobile Phone",
"hsCode": "8517.12.00",
"countryOfOrigin": "CN",
"unCode": "UN1234",
"isCharged": 1,
"isMagnetic": 0,
"isFragile": 1,
"isPowder": 0,
"isLiquid": 0
}
]
}
],
"customsDetail": {
"invoiceDate": "2025-08-18",
"invoiceNumber": "INV20250818001",
"termsOfTrade": "DDU"
},
"valueAddedService": {
"cod": {
"value": 100.0,
"currencyCode": "USD"
},
"insurance": {
"value": 100.0,
"currencyCode": "USD"
},
"signatureService": 1
},
"additionalInfo": [
{
"key": "CUSTOM_FIELD",
"value": "CUSTOM_VALUE"
}
]
}请求示例代码
Shell
HTTP
Python
Java
PHP
Go
C
C#
JavaScript
Swift
Dart
Objective-C
Ruby
OCaml
R
请求示例请求示例
Shell
HTTP
Python
Java
curl --location '/order/create?app_key=undefined&msg_name=undefined&pin=undefined×tamp=undefined&md5_content=undefined&sign=undefined' \
--header 'Content-Type: application/json' \
--data '{
"waybillCode": "JDW100672131893",
"customerCode": "KH20000002811",
"customerDeptCode": "FBU200000028110001",
"customerOrderCode": "452469-1",
"salesPlat": "JD.com",
"salesPlatOrderCode": "452469-1",
"unitOfWeight": "KG",
"unitOfDimension": "CM",
"referenceNumbers": [
"SO20250000301"
],
"serviceCode": "01",
"shipper": {
"name": "Jacky",
"companyName": "JDL corp",
"phoneNumber": "11512391123",
"phoneNumberExtension": "332",
"postalCode": "14414",
"addressLines": [
"8233 Lake Rd"
],
"country": "US",
"stateOrProvince": "NY",
"city": "New York",
"district": "Port Melbourne",
"town": "Well Village",
"houseNumber": "22",
"taxId": [
{
"taxIdNumber": "101321111310",
"taxIdType": "IOSS"
}
]
},
"recipient": {
"name": "Jacky",
"companyName": "JDL corp",
"phoneNumber": "11512391123",
"phoneNumberExtension": "332",
"postalCode": "14414",
"addressLines": [
"8233 Lake Rd"
],
"country": "US",
"stateOrProvince": "NY",
"city": "New York",
"district": "Port Melbourne",
"town": "Well Village",
"houseNumber": "22",
"accessPointCode": "NOE12",
"accessPointName": "NOE12-1332 POINT"
},
"packages": [
{
"weight": 1.5,
"width": 1,
"length": 2,
"height": 2.55,
"packageCode": "JDW100672131893-1-1-",
"commodities": [
{
"declaredValue": 100.0,
"currencyCode": "USD",
"commodityCode": "FG001",
"customerCommodityCode": "SKU001",
"weight": 1.5,
"width": 20.5,
"length": 30.5,
"height": 10.5,
"unitOfWeight": "KG",
"unitOfDimension": "CM",
"quantity": 2,
"name": "手机",
"enName": "Mobile Phone",
"hsCode": "8517.12.00",
"countryOfOrigin": "CN",
"unCode": "UN1234",
"isCharged": 1,
"isMagnetic": 0,
"isFragile": 1,
"isPowder": 0,
"isLiquid": 0
}
]
}
],
"customsDetail": {
"invoiceDate": "2025-08-18",
"invoiceNumber": "INV20250818001",
"termsOfTrade": "DDU"
},
"valueAddedService": {
"cod": {
"value": 100.0,
"currencyCode": "USD"
},
"insurance": {
"value": 100.0,
"currencyCode": "USD"
},
"signatureService": 1
},
"additionalInfo": [
{
"key": "CUSTOM_FIELD",
"value": "CUSTOM_VALUE"
}
]
}'返回响应
🟢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-05-07 08:11:33