获取订单详情

---

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

---

请求方式： POST

---

传参方式： JSON

---

返回格式： JSON

---

请求头参数

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

请求参数

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

请求示例

{
    "shop_id": "321321312321",
    "params": {
        "oid": "32132131231213"
        
    }
}

请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

Pyton请求代码示例

响应参数

名称	类型	示例值	描述
result	integer	1	返回码，1成功
error_msg	string	success	错误信息
data	order_detail	{}	订单详情
order_base_info	order_base_info	{}	订单基础信息
oid	long	20210987654327	订单id
pay_time	long	1543843735000	付款时间
buyer_image	string	https://tx2.a.yximgs.com/uhead/a_b/2019/10/28/17/b13123213123.jpg	买家图像
buyer_open_id	string	1234567	买家id
buyer_nick	string	赵四	买家昵称
seller_open_id	string	12098765	卖家id
seller_nick	string	张三	卖家昵称
express_fee	long	10	运费
discount_fee	long	200	促销减价、折扣价格
total_fee	long	1200	子订单商品总价
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	更新时间
remark	string	买家留言	买家留言
the_day_of_deliver_goods_time	long	0	发货间隔时间，单位：天
promise_time_stamp_of_delivery	long	1543843735000	非预售商品承诺发货时间点,即订单支付时间+承诺发货时间间隔
activity_type	integer	1	活动类型
cps_type	integer	1	分销类型 0-全部 1-普通订单 2-分销订单
valid_promise_shipment_time_stamp	long	1543843735000	预售发货时间/承诺发货时间
pre_sale	integer	0	预售：pre_sale 0：非预售 1:预售
recv_time	long	1543843735000	收货时间
co_type	integer	0	UNKNOWN = 0; JD = 1; RECHARGE_MOBILE = 2; // 券包 COUPON_PACKAGE = 3； // 话费充值 MI = 5; // 小米 CROSS_BORDER = 8; // 跨境
comment_status	integer	1	评价状态： 0未评价，1评价
pay_type	integer	1	支付方式，1=微信；2=支付宝
order_item_info	order_item_info	{}	订单商品信息
sku_id	long	120987654	快手商品skuid
rel_sku_id	long	1209876543	服务商商品skuid
sku_desc	string	水果	sku描述
sku_nick	string	12098765	sku编码
item_id	long	10987654	商品id
rel_item_id	long	120987766	服务商商品id
item_title	string	西瓜	商品名称
item_link_url	string	https://...	商品链接
item_pic_url	string	https://...	商品图片地址
num	integer	1	sku数量
original_price	long	1209	商品促销前单价快照 以分为单位
discount_fee	long	100	折扣金额
price	long	1109	商品单价快照，以分为单位
item_type	integer	1	1自建商品 2 闪电购商品
item_prev_info	order_item_prev_info	{}	sku修改之前原商品信息
goods_code	string	123	外部货品编码
warehouse_code	string	111	快手仓库编码
order_item_id	long	123	订单商品id，原有的id历史字段。商品id请使用item_id
good_store_code	long	13211212321	电子凭证券码库id
service_info	service_info	{}	服务信息
service_rule	string	{}	服务标签
freight	boolean	true	是否使用运费险
freight_provider_type	integer	1	运费险提供者类型
first_order_guarantee	boolean	true	首单保障
instant_delivery	integer	1	急速发货 1是 0否
instant_refund	boolean	true	急速退款
compensate_fake	compensate_fake	{}	假一赔n
times	integer	9	赔付倍数
desc	string	1	假一赔n描述
link	string	1	假一赔n链接
service_rule_info	service_rule_info_d_to	{}	服务规则
deposit_rule	string	1	保证金 0 未交 1 已交
refund_rule	string	1	退款规则 1 7日无理由退换货 2 3 协商退款
deliver_goods_interval_time	long	111111	发货间隔时间（单位：秒）
the_day_of_deliver_goods_time	long	1111	发货间隔天数
sale_flag	boolean	true	预售标志,true: 非预售,false: 预售
promise_delivery_time	long	12	承诺发货时间(单位为s),24/48/72小时,-1表示不承诺
delivery_method	string	logistics	发货方式 logistics：物流配送（默认） certificate：电子凭证
support_verification	integer	1	是否支持核销 0：不支持 1：支持 -1：未设置
cert_merchant_code	string	ks	电子凭证码商
cert_expire_type	integer	11	电子凭证有效期类型
cert_start_time	long	12121	电子凭证起始时间
cert_end_time	long	23232	电子凭证截止时间
cert_exp_days	long	22	电子凭证有效天数
order_refund_list	order_refund_info[]	[]	订单退款信息，按照创建时间逆序，最新的在第一个
refund_id	long	10987654	退款id
refund_status	integer	10	退款状态 枚举：[10, "买家仅退款申请"] [11, "买家退货退款申请"] [20, "平台介入-买家仅退款申请"] [21, "平台介入-买家退货退款申请"] [22, "平台介入-已确认退货退款"] [30, "商品回寄信息待买家更新"] [40, "商品回寄信息待卖家确认"] [50, "退款执行中"] [60, "退款成功"] [70, "退款失败"]
order_logistics_info	order_logistics_info[]	[]	订单物流信息
express_no	string	s_f10987654321	快递单号
express_code	integer	1234098765	快递公司code
order_note	order_note	{}	订单备注，按照创建时间正序，最新的在最后一个
seller_note	string[]	[]	卖家备注
order_address	order_address_info	{}	订单地址信息
consignee	string	里斯	收货人名称
encrypted_consignee	string	abcdef	收货人名称加密
desensitise_consignee	string	里*	收货人脱敏
mobile	string	18765432136	收货人手机
encrypted_mobile	string	abcdef	手机号加密
desensitise_mobile	string	187****2136	手机号脱敏
province_code	long	123455	收货省份编码
province	string	北京	收货省
city_code	long	120987	收货城市编码
city	string	北京	收货城市
district_code	long	10000	收货街道编码
district	string	上地	收货街道
address	string	快手	详细地址
encrypted_address	string	abcdef	详细地址加密
desensitise_address	string	快*	详细地址脱敏
recharge_account	recharge_account_d_to	{}	虚拟商品充值信息
account	string	13455443333	手机号
account_type	integer	1	账号类型 1 手机号 2 Qq号 3 微信号
account_type_desc	string	手机号	账号类型说明
order_flag	order_flag_code	{}	订单插旗
flag	string[]	[]	插旗颜色
deduct_money	int		消耗点券
status	int		状态码，0为成功

返回数据

{
   "data": {
   "result": 1,
  "data": {
    "pay_time": 1543843735000,
    "oid": 100011,
    "seller_id": 12345,
    "seller_nick": "张三",
    "express_fee": 20,
    "discount_fee": 100,
    "total_fee": 1200,
    "status": 10,
    "send_time": 1543843735000,
    "refund_time": 1543843735000,
    "create_time": 1543843735000,
    "update_time": 1543843735000,
    "num": 1,
    "mobile": "123456789",
    "address": "{\"consignee\": \"不帅\",   \"mobile\": 15000000000,   \"province_code\": 125620,   \"province\": \"北京\",   \"city_code\": 100000,   \"city\": \"北京\",   \"district_code\": 123456,   \"district\": \"\",   \"address\": \"\" }",
    "refund": 0,
    "remark": "尽快发货",
    "seller_note_list": [
      "请给好评",
      "请给好评"
    ],
    "the_day_of_deliver_goods_time": 0,
    "promise_time_stamp_of_delivery": 1543843735000,
    "order_product_info_list": [
      {
        "id": 123,
        "oid": 123,
        "sku_id": 123,
        "rel_sku_id": 123,
        "sku_desc": "null",
        "sku_nick": "苹果11-白128g",
        "item_id": 123,
        "rel_item_id": 123,
        "item_title": "西瓜",
        "item_link_url": "https://...",
        "item_pic_url": "https://...",
        "num": 11,
        "original_price": 1290,
        "discount_fee": 100,
        "price": 1190,
        "create_time": 1543843735000,
        "update_time": 1543843735000,
        "refund_id": 123,
        "refund_status": 10,
        "item_type": 1,
        "refund_list": [
          {
            "refund_id": 123,
            "refund_status": 10
          }
        ],
        "prev_info": {
          "sku_id": 123,
          "rel_sku_id": 123,
          "sku_desc": "sku_desc",
          "sku_nick": "苹果11-白128g"
        },
        "cps_info": {
          "distributor_id": 123,
          "distributor_name": "推广者1号",
          "commission_rate": 100,
          "estimated_income": 3455,
          "platform_dp_rate": 100
        }
      }
    ],
    "logistics_info": {
      "express_no": "s_f123",
      "express_code": 123
    },
    "activity_type": 1,
    "cps_type": 1,
    "pay_type": 1,
    "flag_tag_code": "grey_flag_tag_order",
    "valid_promise_shipment_time_stamp": 0,
    "pre_sale": 0,
    "recv_time": 0,
    "co_type": 1
  },
  "error_msg": "SUCCESS",
  "deduct_money":4
  
},
  "status": 0
}
  

响应代码

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