xiaodian.trade.queryOrderByBuyerId

  • 免费
  • 无需授权

API功能描述(支持get和post)

根据买家用户id查询买家订单信息

公共参数

名称 类型 必选 描述
app_key Long 接入时申请的app_key
method String 接口名称
access_token String Oauth2.0授权获得的access_token
sign String 对 API 调用参数(除sign外)进行 md5 加密获得。参数的顺序为字母表的顺序
timestamp Long 时间戳,使用Unix时间戳格式
format String 响应格式。默认为json格式,固定
sign_method String 参数的加密方法选择,当前只支持Md5
version String API协议版本,固定值为:1.0

输入参数

名称 类型 必选 描述 示例值
queryBuyerOrderReqDto Object 查询对象
startCreated String 订单开始创建时间比如2020-04-27 11:00:00"
endCreated String 订单结束创建时间比如2020-05-27 11:00:00"
orderStatus String 订单状态all--全部 created--待付款 unshipped--待发货 unreceived--待收货 refund_orders--售后 received_and_completed--待评价 ungroup--拼团中
buyerUserId Number 买家用户ID(buyerUserId和unionId必须至少填一个,优先使用buyerUserId)
unionId String 买家unionId(buyerUserId和unionId必须至少填一个,优先使用buyerUserId)
pageNum Number 当前分页页码
pageSize Number 每页的记录数不能超过30

返回参数

名称 类型 描述 默认值
status Object 状态
code String 状态编码 0000000
msg String 错误信息 调用成功
result Object 返回结果
data Object[] 返回数据
data_object Object 返回数据订单对象
buyerFinalPrice Number 买家实付(分为单位)
payOrderId Number 支付订单id
orderStatus String 订单状态,包括: ORDER_CREATED": "已下单", ORDER_CANCELLED": "订单取消", ORDER_PAID": "已支付", ORDER_SHIPPED": "已发货", ORDER_RECEIVED": "已收货", ORDER_COMPLETED": "订单完成", ORDER_CLOSED": "订单关闭"  
receiverProvince String 收件人地址省
receiverCity String 收件人地址城市
marketType String 市场类型(INDEPENDENCE_MARKET表示小程序)
orderUrl String 订单B端URL
receiverPhone String 收件人电话
itemOrders Object[] 商品级别订单数组
itemOrders_object Object 商品级别订单
img String 商品主图
refundViewStatusDesc String 退款展示状态
itemOrderId Number 商品级别订单id
title String 商品标题
orderTags String 订单标记
nowPrice Number 商品价格(分为单位)
number Number 数量
itemId Number 商品id
skuAttributes Object[] SKU对象数组
skuAttributes_object Object SKU对象
value String SKU的key
key String SKU的value
price Number 商品原价
stockId Number 库存id
itemUrl String 商品B端URL
refundId Number 退款单ID
shipExpressNameRemark String 物流描述
receiverZip String 收货人邮编
created Number 订单创建时间
receiverName String 收件人姓名
receiverMobile String 收件人电话
receiverArea String 收件人地区
remainTime Number 超时时间
shopOrderPriceRemark String 店铺级订单价格文案 含运费、关税
multiPackage Boolean 是否是打包卖
expiredTime Number 订单超时时间
receiverAddress String 收件人地址
shopOrderId Number 店铺级别订单id
shopOrderPrice Number 店铺级订单价格 含运费、关税(单位是分)
buyerItemOrderPrice Number 商品级订单总价(单位是分)
buyerUserId Number 买家用户id
success Boolean 是否成功 true

请求参数示例

1).
{ "queryBuyerOrderReqDto":{ "startCreated":"2020-02-01 11:00:00", "endCreated":"2020-04-25 11:00:00", "orderStatus":"all", "buyerUserId":1515467013, "pageNum":1, "pageSize":30 } }

返回示例

1).
{ "status": { "code": "0000000", "msg": "调用成功" }, "result": { "data": { "hasNext": true, "buyerOrderList": [ { "buyerFinalPrice": 3700, "payOrderId": 80185748507013, "orderStatus": "ORDER_CLOSED", "promotionInfoList": [], "receiverProvince": "浙江省", "receiverCity": "杭州市", "marketType": "INDEPENDENCE_MARKET", "orderUrl": "https://www.realshark.com/trades/order/detail.html?orderId=80185748517013", "receiverPhone": "13632591071", "itemOrders": [ { "itemIdStr": "1qmj0ko", "img": "/mlcdn/65397a/200417_6d01d6ad4fhfh41ihk6g8h84h42i2_850x850.jpg", "httpsImg": "https://s5.mogucdn.com/mlcdn/65397a/200417_6d01d6ad4fhfh41ihk6g8h84h42i2_850x850.jpg", "refundViewStatusDesc": "退款完成", "orderStatus": "ORDER_CLOSED", "itemOrderId": 80185748527013, "title": "快鱼小黄人联名童休闲T恤夏装圆领短袖上衣", "orderTags": [], "nowPrice": 2900, "number": 1, "itemId": 804979640, "skuAttributes": [ { "value": "白色", "key": "颜色" }, { "value": "120", "key": "尺码" } ], "price": 2900, "stockId": 1377604142, "itemExtraInfo": {}, "itemUrl": "https://www.realshark.com/goods/tradeList/detail.html?itemId=1qmj0ko", "refundId": 300335583 } ], "shipExpressNameRemark": "默认快递", "pintuanInfo": { "pintuanStatus": "" }, "receiverZip": "310013", "created": 1587705285, "receiverName": "丁来佳", "receiverMobile": "13632591071", "receiverArea": "西湖区", "remainTime": 1797995, "sellerUserId": 1515316033, "shopOrderPriceRemark": "含运费:¥8.00", "multiPackage": false, "expiredTime": 1592889292, "orderTags": [], "receiverAddress": "古墩路97号 浙商财富中心A座", "shopOrderId": 80185748517013, "shopOrderPrice": 3700, "buyerItemOrderPrice": 2900, "buyerUserId": 1515467013, "extraInfo": { "outId": "" } }, { "buyerFinalPrice": 9900, "payOrderId": 80177282207013, "orderStatus": "ORDER_CLOSED", "promotionInfoList": [], "receiverProvince": "浙江省", "receiverCity": "杭州市", "marketType": "INDEPENDENCE_MARKET", "orderUrl": "https://www.realshark.com/trades/order/detail.html?orderId=80177282217013", "receiverPhone": "13632591071", "itemOrders": [ { "itemIdStr": "1qmhdso", "img": "/mlcdn/65397a/191218_843h2kdh080i4kf50kc018gh20019_800x800.jpg", "httpsImg": "https://s5.mogucdn.com/mlcdn/65397a/191218_843h2kdh080i4kf50kc018gh20019_800x800.jpg", "refundViewStatusDesc": "退款完成", "itemCode": "10J5001", "orderStatus": "ORDER_CLOSED", "itemOrderId": 80177282227013, "title": "快鱼新款系带抽绳连帽夹克女士短款宽松薄款上衣休闲大众SPM", "orderTags": [], "nowPrice": 9900, "number": 1, "itemId": 804941552, "skuAttributes": [ { "value": "粉红色", "key": "颜色" }, { "value": "M", "key": "尺码" } ], "price": 9900, "stockId": 1377438281, "itemExtraInfo": {}, "itemUrl": "https://www.realshark.com/goods/tradeList/detail.html?itemId=1qmhdso", "refundId": 300320406, "skuCode": "10J50011105" } ], "shipExpressNameRemark": "默认快递", "pintuanInfo": { "pintuanStatus": "" }, "receiverZip": "310013", "created": 1585756019, "receiverName": "丁来佳", "receiverMobile": "13632591071", "receiverArea": "西湖区", "remainTime": -151272, "sellerUserId": 1515316033, "shopOrderPriceRemark": "包邮", "multiPackage": false, "expiredTime": 1590940025, "orderTags": [], "receiverAddress": "古墩路97号 浙商财富中心A座", "shopOrderId": 80177282217013, "shopOrderPrice": 9900, "buyerItemOrderPrice": 9900, "buyerUserId": 1515467013, "extraInfo": { "outId": "" } } ] } }, "success": true }

异常示例