bootystar

快递下单

POST

/jd-express-order/insert

快递下单

请求参数

Body 参数application/json

sysOrderId

integer <int64>

系统订单id

必需

sender

object (Contract)

寄件人信息

必需

name

string

姓名

必需

mobile

string

电话

必需

fullAddress

string

全量四级地址

必需

receiver

object (Contract)

收件人信息

必需

name

string

姓名

必需

mobile

string

电话

必需

fullAddress

string

全量四级地址

必需

items

array[object (JdExpressOrderItemInsertDTO) {9}]

物品详情

必需

sysOrderItemId

integer <int64>

必需

@Schema(description = "京东快递单id")
系统订单项

name

string

拖寄物描述

必需

<= 200 字符

quantity

integer

件数（包裹数）

必需

weight

number

必需

重量；单位：kg,保留小数点后两位

volume

number

必需

体积：单位：cm³；必填；保留小数点后两位；

length

number

包裹长度

可选

width

number

包裹宽度

可选

hight

number

包裹宽度

可选

remark

string

可选

备注，小哥手持终端上可查看此信息

<= 200 字符

check

boolean

可选

是否进行完整性检查(一个订单号仅能进行一次京东物流配送,若未完全发货, 剩余的商品不能通过该接口再次进行配送)

remark

string

可选

下单备注；此信息显示在面单上，长度1-500；面单上截取前50个字符显示,

示例

{
    "sysOrderId": 0,
    "sender": {
        "name": "string",
        "mobile": "string",
        "fullAddress": "string"
    },
    "receiver": {
        "name": "string",
        "mobile": "string",
        "fullAddress": "string"
    },
    "items": [
        {
            "sysOrderItemId": 0,
            "name": "string",
            "quantity": 0,
            "weight": 0,
            "volume": 0,
            "length": 0,
            "width": 0,
            "hight": 0,
            "remark": "string"
        }
    ],
    "check": true,
    "remark": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/jd-express-order/insert' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sysOrderId": 0,
    "sender": {
        "name": "string",
        "mobile": "string",
        "fullAddress": "string"
    },
    "receiver": {
        "name": "string",
        "mobile": "string",
        "fullAddress": "string"
    },
    "items": [
        {
            "sysOrderItemId": 0,
            "name": "string",
            "quantity": 0,
            "weight": 0,
            "volume": 0,
            "length": 0,
            "width": 0,
            "hight": 0,
            "remark": "string"
        }
    ],
    "check": true,
    "remark": "string"
}'

返回响应

🟢200成功

application/json

Body

code

string

状态码

可选

msg

string

信息

可选

data

object

数据

可选

version

string

版本

可选

timestamp

integer <int64>

时间

可选

sign

string

可选

success

boolean

可选

示例

{
  "code": "",
  "msg": "",
  "data": {},
  "version": "v231225",
  "timestamp": 0,
  "sign": "",
  "success": false
}

jd物流是否可用

取消订单