订单物流发货

新版接口变更说明

新增字段：
express_name

注意事项：
1：该接口中的信息需要按实填入，否则将可能导致发货失败或无法在闲鱼中查看物流信息；
2：寄件方信息可通过以下三种方式传入；

组合1：ship_name ship_mobile ship_district_id ship_address；

组合2：ship_name ship_mobile ship_prov_name ship_city_name ship_area_name ship_address；

组合3：如以上参数均不传入，则需要用户在闲管家后台填写默认发货地址；

以上条件均不满足则发货信息为空，将可能存在发货失败等情况；

请求参数

Query 参数

appid

integer

必需

开放平台的AppKey

默认值:

timestamp

integer

可选

当前时间戳（单位秒，5分钟内有效）

默认值:

seller_id

integer

可选

商家ID（仅商务对接传入，自研/第三方ERP对接忽略即可）

默认值:

sign

string

必需

签名MD5值（参考签名说明）

默认值:

Body 参数application/json

order_no

string

闲鱼订单号

必需

示例值:

2226688164543566229

正则匹配:

/^\d{19,}$/

ship_name

string

寄件方姓名

可选

示例值:

张三

ship_mobile

string

寄件方号码

可选

示例值:

13800138000

正则匹配:

/^1([3456789]\d{9})$/

ship_district_id

integer <int32>

寄件方所在地区ID

可选

如果没有传入该参数，则必传省市区

示例值:

440305

ship_prov_name

string

寄件方所在省份

可选

如果没有传入ship_district_id，则必传该参数

示例值:

广东省

ship_city_name

string

寄件方所在城市

可选

如果没有传入ship_district_id，则必传该参数

示例值:

深圳市

ship_area_name

string

寄件方所在地区

可选

如果没有传入ship_district_id，则必传该参数

示例值:

南山区

ship_address

string

寄件方详细地址

可选

示例值:

侨香路某某大厦A栋301室

waybill_no

string

快递单号

必需

示例值:

SF428948923411

正则匹配:

/^\w{10,}$/

express_code

string

快递公司代码

必需

可通过快递公司列表接口查询

示例值:

shunfeng

express_name

string

快递公司名称

必需

注意：当 express_code 传入 other 时，请传入实际快递公司名称

示例值:

顺丰速运

示例

{
    "order_no": "1339920336328048683",
    "ship_name": "张三",
    "ship_mobile": "13800138000",
    "ship_district_id": 440305,
    "ship_prov_name": "广东省",
    "ship_city_name": "深圳市",
    "ship_area_name": "南山区",
    "ship_address": "侨香路西丽街道丰泽园仓储中心",
    "waybill_no": "25051016899982",
    "express_name": "其他",
    "express_code": "qita"
}

application/json

Body

code

enum<integer> <int32>

必需

枚举值:

msg

enum<string>

必需

枚举值:

data

object

可选

示例

成功示例异常示例

{
    "code": 0,
    "msg": "ok",
    "data": {}
}

新版接口变更说明#

请求参数

返回响应

新版接口变更说明