获取分销订单详情 | 大麦家礼品代发API

# 获取分销订单详情

接口地址： http://www.damaijia168.com/vv/external/requestKsErp/ksCpsDetail

请求方式： POST

传参方式： JSON

返回格式： JSON

# 请求头参数

参数	类型	必选	值	示例
Authorization	string	是	授权 access_token	1798c6aadec33d1bc2f5b707f1049aefexxxx

# 请求参数

参数	类型	必选	描述
shop_id	string	是	店铺id(可在快手小店获取)
params	Object	是	参数
distributor_id	number	是	分销者id
order_id	number	是	订单id
edition	string	否	版本默认:1(不传默认为1) 1:1.0,2:2.0

# 请求示例

{
    "shop_id": "1213231321",
    "params": {
        "distributor_id": "123",
        "order_id": "211111111111111111"
    }
}

# 请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

Pyton请求代码示例

# 响应参数

名称	类型	示例值	描述
result	integer	1	返回码
data	merchant_order_list_data	{}	订单列表
current_page	long	1	当前页，仅第一次调用返回值有效
page_size	integer	10	一页数据量
total_page	long	10	总页数，仅第一次调用返回值有效
total_size	long	100	总数仅第一次调用返回值有效
begin_time	long	100000	开始时间
end_time	long	200000	结束时间
pcursor	string	157356441188_1	游标，nomore代表分页到底
order_info_list	list	{}	订单列表
pay_time	long	1543843735000	付款时间
oid	long	100011	订单号
seller_id	long	12345	卖家id
seller_nick	string	张三	卖家昵称
express_fee	long	20	运费（单位分）
discount_fee	long	100	折扣价格（单位分）
total_fee	long	1200	货款, 商家维度，不包括运费计算公式为：商品总金额(price * num)- 商家承担(merchant_bear_amount)
status	integer	10	订单状态：[0, "未知状态"], [10, "待付款"], [30, "已付款"], [40, "已发货"], [50, "已签收"], [70, "订单成功"], [80, "订单失败"];
send_time	long	1543843735000	发货时间
refund_time	long	1543843735000	退款时间(只要买家有申请退款行为)
create_time	long	1543843735000	创建时间
update_time	long	1543843735000	更新时间
num	integer	1	sku商品种类数
mobile	string	123456789	收件人手机号（此字段与address 中mobile 意义相同，修改address 中的mobile，此字段值也会被修改）
address	string	{"consignee": "不帅", "mobile": 15000000000, "province_code": 125620, "province": "北京", "city_code": 100000, "city": "北京", "district_code": 123456, "district": "", "address": "" }	{"consignee": "不帅", //收货人姓名 "mobile": 15000000000, //收货人手机 "province_code": 125620, //收货人省份编号 "province": "北京", //收货人省份 "city_code": 100000, //收货人城市编码 "city": "北京", //收货人城市 "district_code": 123456, //收货人区\县编码 "district": "", //收货人区\县 "address": "" //收货人详细地址 }
refund	integer	0	是否申请退款 0未申请 1已申请（包括申请后取消）
remark	string	尽快发货	买家留言
seller_note_list	list	["请给好评","请给好评"]	卖家备注，新备注在前
the_day_of_deliver_goods_time	long	0	发货间隔时间，单位：天
promise_time_stamp_of_delivery	long	1543843735000	仅表示承诺发货时间
order_product_info_list	list	{}	商品品信息列表
id	long	123	id
oid	long	123	订单id
sku_id	long	123	快手商品skuid
rel_sku_id	long	123	服务商商品skuid
sku_desc	string	null	sku描述
sku_nick	string	苹果11-白128g	sku编码，方便商家管理商品的编码，用于库存管理、多渠道销售分析等
item_id	long	123	快手商品id
rel_item_id	long	123	服务商商品id
item_title	string	西瓜	商品名称
item_link_url	string	https://...	商品链接
item_pic_url	string	https://...	商品图片地址
num	long	11	成交数量
original_price	long	1290	商品促销前单价快照以分为单位
discount_fee	long	100	折扣金额
price	long	1190	商品单价快照，以分为单位
create_time	long	1543843735000	毫秒时间戳
update_time	long	1543843735000	毫秒时间戳
refund_id	long	123	退款订单id
refund_status	integer	10	退款状态枚举：[10, "买家仅退款申请"] [11, "买家退货退款申请"] [20, "平台介入-买家仅退款申请"] [21, "平台介入-买家退货退款申请"] [22, "平台介入-已确认退货退款"] [30, "商品回寄信息待买家更新"] [40, "商品回寄信息待卖家确认"] [50, "退款执行中"] [60, "退款成功"] [70, "退款失败"]
item_type	integer	1	1自建商品 2 闪电购商品
refund_list	list	{}	该sku_id下的退款列表
refund_id	long	123	退款id
refund_status	integer	10	退款状态：0-未知状态；10-买家仅退款申请；11-买家退货退款申请；20-平台介入-买家仅退款申请；21-平台介入-买家退货退款申请；22-平台介入-已确认退货退款；30-商品回寄信息待买家更新；40-商品回寄信息待卖家确认；50-退款执行中；60-退款成功；70-退款失败。
prev_info	merchant_order_product_prev_view	{}	订单修改之前的原订单信息
sku_id	long	123	商品sku_id
rel_sku_id	long	123	服务商sku_id
sku_desc	string	sku_desc	sku描述信息
sku_nick	string	苹果11-白128g	sku编码，方便商家管理商品的编码，用于库存管理、多渠道销售分析等
cps_info	merchant_cps_info_view	{}	cps信息，若订单未支付，则无值。
distributor_id	long	123	推广者id
distributor_name	string	推广者1号	推广者昵称
commission_rate	long	100	达人佣金率
estimated_income	long	3455	分销金额
platform_dp_rate	long	100	快手技术服务费的费率。千分比
logistics_info	merchant_logistics_info_view	{}	物流信息（列表接口无此字段）
express_no	string	s_f123	快递单号
express_code	integer	123	快递公司code
activity_type	integer	1	活动类型
cps_type	integer	1	分销类型 0-全部 1-普通订单 2-分销订单
pay_type	integer	1	支付方式 1微信 2支付宝
flag_tag_code	string	grey_flag_tag_order	插旗颜色。red_flag_tag_order：红 grey_flag_tag_order：灰 yellow_flag_tag_order：黄 green_flag_tag_order：绿 blue_flag_tag_order：蓝 purple_flag_tag_order：紫（该字段仅在获取订单详情api中返回，不在获取订单列表（游标方式）api返回）
valid_promise_shipment_time_stamp	long	0	预售发货时间/承诺发货时间（该字段仅在获取订单详情api中返回，不在获取订单列表（游标方式）api返回）
pre_sale	integer	0	0：非预售 1:预售（该字段仅在获取订单详情api中返回，不在获取订单列表（游标方式）api返回）
recv_time	long	0	确认收货时间（该字段仅在获取订单详情api中返回，不在获取订单列表（游标方式）api返回）
co_type	integer	1	区分虚拟订单字段。jd = 1; 券包 = 2; 话费充值 = 3；话费充值小米 = 5; （该字段仅在获取订单详情api中返回，不在获取订单列表（游标方式）api返回）
buyer_nick	string	昵称	买家昵称。(该字段仅在获取订单详情api中返回，不在获取订单列表（游标方式）api返回)
comment_status	integer	0	评价状态。0未评价，1评价(该字段仅在获取订单详情api中返回，不在获取订单列表（游标方式）api返回)
error_msg	String	SUCCESS	错误码描述
deduct_money	int		消耗点券
status	int		状态码，0为成功

# 返回数据

{
   "data": {
   "result": 1,
    "data": {
    "name": "coc233400",
    "sex": "F",
    "head": "https://tx2.a.yximgs.com/uhead/AB/2019/10/28/17/B13123213123.jpg",
    "bigHead": "https://tx2.a.yximgs.com/uhead/AB/2019/10/28/17/B13123213123.jpg",
    "sellerId": 12324213,
    "openId": "f198e29e9d8cea7e14bf57248554ed7a",
    "staffInfo": {
      "staffId": 1400000000032,
      "openId": "f198e29e9d8cea7e14bf57248554ed7a",
      "name": "螃蟹"
    },
  "error_msg": "SUCCESS",
  "deduct_money":4
  
},
  "status": 0
}

# 响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API调用次数不足,请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权

← 5-5_快手-获取分销订单列表 5-7_快手-修改订单规格 →