闲管家开放平台
  1. 订单
闲管家开放平台
  • 接入说明
  • 代码示例
  • 用户
    • 授权商家账号(服务商)
      POST
    • 创建商家账号(服务商)-废弃
      POST
    • 删除商家账号(服务商)
      POST
    • 查询商家账号(服务商)
      POST
    • 授权闲鱼店铺(服务商)
      POST
    • 删除闲鱼店铺(服务商)
      POST
    • 查询闲鱼店铺
      POST
    • 查询商家地址
      POST
  • 商品
    • 查询商品类目
      POST
    • 查询商品属性
      POST
    • 查询商品列表
      POST
    • 查询商品详情
      POST
    • 查询商品规格
      POST
    • 创建商品(单个)
      POST
    • 创建商品(批量)
      POST
    • 上架商品
      POST
    • 下架商品
      POST
    • 编辑商品
      POST
    • 编辑库存
      POST
    • 删除商品
      POST
  • 订单
    • 查询订单列表
      POST
    • 查询订单详情
      POST
    • 订单卡密列表
      POST
    • 订单物流发货
      POST
    • 订单取消交易
      POST
  • 推送
    • 商品回调通知
    • 商品推送通知
    • 订单推送通知
  • 资金
    • 查询钱包账户余额(服务商)
    • 订购ERP专业版(服务商)
  • 其他
    • 查询快递公司
  • 严选
    • 获取品牌列表
    • 获取机型列表
    • 获取机型类目
    • 获取报告类目
  1. 订单

订单物流发货

POST
/api/open/order/ship

新版接口变更说明#

新增字段:
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
默认值:
{{appid}}
seller_id
integer 
可选
商家ID(仅商务对接传入,自研/第三方ERP对接忽略即可)
默认值:
{{seller_id}}
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"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST '/api/open/order/ship?appid=&seller_id={{seller_id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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"
}'

返回响应

🟢200成功
application/json
Body
code
enum<integer> <int32>
必需
枚举值:
0
msg
enum<string> 
必需
枚举值:
ok
data
object 
可选
示例
{
  "code": 0,
  "msg": "ok",
  "data": {}
}
🟢200失败
修改于 2025-05-10 07:54:20
上一页
订单卡密列表
下一页
订单取消交易
Built with