xiaodian.trade.sold.get

  • 免费
  • 需要授权
  • 结果不加密
查询卖家已卖出的交易数据(最近一年)(预计2021.10.31下线,请接入xiaodian.trade.sold.encrypted.get)

公共参数

名称 类型 必选 描述
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

输入参数

名称 类型 必选 描述 示例值
Params
Object 查询条件参数,格式如下: 
     { 
              startCreated: String 订单创建时间开始,格式:yyyy-MM-dd HH:mm:ss,与endCreated配对使用 
              endCreated: String 订单创建时间结束,格式:yyyy-MM-dd HH:mm:ss,与startCreated配对使用
              startUpdated: String 订单最后更新时间开始,格式:yyyy-MM-dd HH:mm:ss,与endUpdated配对使用 
              endUpdated: String 订单最后更新时间结束,格式:yyyy-MM-dd HH:mm:ss,与startUpdated配对使用 
              orderStatus: String 交易状态,默认查询所有交易状态的数据,除了默认值外每次只能查询一种状态,非必填参数,取值:ORDER_CREATED - 已下单,ORDER_CANCELLED - 订单取消,ORDER_PAID - 已支付,ORDER_SHIPPED - 已发货,ORDER_RECEIVED - 已收货,ORDER_COMPLETED - 订单完成,ORDER_CLOSED - 订单关闭 
              page: Int 页码,大于零的整数,默认1,非必填 
              pageSize: Int 每页条数,大于零的整数,默认值:10;最大值:50,非必填 
              startOrderId:Long 起始id 非必填 
              orderBy:String 排序类型,值为 ASC 或 DESC 非必填 
          }
          平台目前提供两种查询条件和两种翻页方式,可按需求自行组合使用:
     查询条件:
         1:startCreated + endCreated + orderStatus ,以订单创建时间和订单状态翻页查询
         2:startUpdated + endUpdated + orderStatus ,以订单修改时间和订单状态翻页查询
     翻页方式:
         A:page + pageSize。每页pageSize条记录,查询第page页的记录,page与pagesize的乘积不能超过5000
         B:startOrderId + orderBy + pageSize,查询订单ID值大于(orderBy=ASC)或小于(orderBy=DESC)startOrderId,的pageSize条记录,无总量限制
     必须一种查询条件和一种翻页方式组合使用:
    

返回参数

名称 类型 描述 默认值
result
Object 搜索整体结果
data
Object 订单搜索返回结果
hasNext
Boolean 是否存在下一页 true
openApiOrderDetailResDtos
Object[] 搜索到的交易信息列表,返回的Trade和Order中包含的具体信息为入参fields请求的字段信息
openApiOrderDetailResDtos_object
Object 单笔订单信息
buyerAccountId
String 买家账户ID,是用户登录的账号,唯一 山甲
buyerName
String 买家昵称,是用户自己设置的,不唯一 山甲
buyerUserId
Number 买家ID 106482509
createdStr
String 订单创建时间,格式:yyyy-MM-dd HH:mm:ss 2017-11-28 12:10:17
isRate
Boolean 订单是否已经评价 false
itemOrderInfos
Object[] 商家级订单列表
itemOrderInfos_object
Object 商品级订单
img
String 商品图片URL(相对路径) /mlcdn/c45406/171128_2de073jfj5ki4ld9behj7ccaaiagh_673x725.jpg
imgUrl
String 商品图片URL(绝对路径) http://s2.mogucdn.com/mlcdn/c45406/171128_2de073jfj5ki4ld9behj7ccaaiagh_673x725.jpg
itemCode
String 商品code
itemId
String 商品ID 1llsd02
itemOrderId
Number 商品级订单Id 72654239552509
nowPrice
Number 商品现价,需除以100 1
number
Number 商品数量 1
orderStatus
String 订单子状态,取值可以参考店铺级订单orderStatus取值 ORDER_SHIPPED
price
Number 商品原价 1
refundStatus
String 退款状态,取值如下: 
     RETURN_GOODS_REQUESTED:买家发起退货,等待卖家同意 
     RETURN_GOODS_AGREED:卖家同意,等待买家退货 
     RETURN_GOODS_SHIPPED:买家发货,等待卖家收货 
     REFUND_REQUESTED:买家发起退款,等待卖家同意 
     REFUND_OR_RETURN_DEAL_AGREED:买卖家协商一致,等待资金退款 
     REFUND_OR_RETURN_SELLER_REFUSED:买家退款或退货被卖家拒绝 
     RETURN_GOODS_SELLER_DECLARE_NOT_RECEIVED:买家发货后,卖家未收到货 
     EFUND_COMPLETED:退款完成; REFUND_CANCELLED:退款取消
skuAttributes
Object[] 商品sku描述
skuAttributes_object
Object 商品扩展属性
key
String 属性key 颜色
value
String 属性value 金色
skuCode
String 商品skuCode
skuId
String 商品skuId 1xgfhl8
title
String 商品名称 测试普通商品
sellerFinal
Number 卖家实收,单位:分
supplyPrice
Number 供货价,单位:分
extraMap
Object 额外信息
actorId
Number 主播id
actorName
String 主播名
number
Number 包含的商品级订单数量 2
orderStatus
String 订单状态,取值如下: 
     ORDER_CREATED: 已下单 
     ORDER_CANCELLED: 订单取消 
     ORDER_PAID: 已支付 
     ORDER_SHIPPED: 已发货 
     ORDER_RECEIVED: 已收货 
     ORDER_COMPLETED: 订单完成 
     ORDER_CLOSED: 订单关闭 
 注:部分发货状态不在主状态,订单主状态还是待发货
ORDER_SHIPPED
orderTags
String 订单标签
payOrderId
Number 支付级订单ID 72654239532509
payTimeStr
String 订单支付时间,格式:yyyy-MM-dd HH:mm:ss 2017-11-28 12:10:37
platformPromotionAmount
Number 平台优惠(分) 0
processResponseDTO
Object 订票流程标签
inputTag
String 入口标识 0
itemTag
String 商品标 0
itemTypeTag
String 商品类目标 0
marketTag
String 市场标 8
sellerTag
String 卖家标 0
userTag
String 买家标 0
promotionAmount
Number 支付级优惠(分) 0
receiveTimeStr
String 订单收货时间,格式:yyyy-MM-dd HH:mm:ss 1970-01-01 08:00:00
receiverAddress
String 收货地址 零零落落零零落落了
receiverArea
String 收货人区 西湖区
receiverCity
String 收货人城市 杭州市
receiverMobile
String 收货人手机 18202773577
receiverName
String 收货人姓名 啦啦啦
receiverPhone
String 收货人联系电话 18202773577
receiverProvince
String 收货人省份 浙江省
receiverZip
String 收货人邮编
sellerAccountId
String 卖家账户ID 好人老三
sellerName
String 卖家昵称 好人老三
sellerUserId
Number 卖家ID 93820149
shipExpense
String 运费(分) 0
shipExpressId
String 快递编号 987654321
shipExpressName
String 快递公司名 tiantian
shipTimeStr
String 订单发货时间,格式:yyyy-MM-dd HH:mm:ss 2017-11-28 12:16:40
shipType
Number 发货类型,取值如下: 
     0 - 快递 
     1 - 小店卖家直接发货 
     2 - 海淘-转运 
     3 - 海淘-商业快件 
     4 - 虚拟交易 
     5 - 保税仓 
0
shopOrderId
Number 店铺级订单ID 72654239542509
shopOrderPrice
Number 订单价格(分),商品订单价格之和- 店铺优惠+shipExpense(运费) + tariff(关税)。 含运费和关税,需除以100 2
shopOrderType
String 订单市场类型,包括:MOGUJIE_MARKET、DEFAULT_MARKET、GO_MARKET。 MOGUJIE_MARKET
shopPromotionAmount
Number  店铺优惠(分) 0
stageStatus
String 多阶段订单的状态,目前包括:UN_PRE_PAY、WAITING_TAIL_PAY_OPEN、UN_TAIL_PAY、TAIL_PAY_SUCCESS ORDER_SHIPPED
extraMap
Object 跨境专用,其他无需关心,这个结构是Map, 包含的Key有: 
     idCardCode(身份证编号) 
     idCardName(身份证名称) 
     idCardMobile(身份证手机号) 
     payChannelCode(支付企业编码) 
     paymentNo(交易支付流水号) 
     tariff(关税) 
     declareNo(地方版支付报关流水号) 
     declareNoZS(总署版支付报关流水号) 
     identityCheck(跨境订单中订购人和支付人身份是否一致,T:一致;F:不一致,空为未校验)
modifyPrice
Number 店铺单改价差额, shopOrderPrice这是店铺单的实付价格,货款价格-店铺级别优惠+运费+关税, 如果出参中的shopOrderPrice为2,modifyPrice为1,则改价前的价格为3; 如果出参中的shopOrderPrice为70,modifyPrice为-10,则改价前的价格为60
buyerFinalPrice
Number 买家实付金额
totalNum
Number 搜索到的交易订单总数 7
status
Object 查询结果状态表示
code
String 状态码 0000000
msg
String 查询结果描述 调用成功

请求参数示例

1).
"Params": { "startCreated":"2018-08-08 12:00:00", "endCreated":"2018-08-08 19:00:00", "startUpdated":null, "endUpdated":null, "orderStatus":"ORDER_CREATED", "page":"1", "pageSize":"5" }

返回示例

1).
{ "result": { "data": { "hasNext": true, "openApiOrderDetailResDtos": [ { "buyerAccountId": "xx", "buyerName": "xx", "buyerUserId": 117602449, "createdStr": "2016-11-01 11:01:02", "isRate": false, "itemOrderInfos": [ { "img": "/p2/161028/126947059_31dkih6109aaa3akgf677lb2bh922_1024x819.jpg", "imgUrl": "http://s11.mogucdn.com/p2/161028/126947059_31dkih6109aaa3akgf677lb2bh922_1024x819.jpg", "itemCode": "", "itemId": "1k4bcye", "itemOrderId": 28705208422449, "nowPrice": 10, "number": 1, "price": 100, "refundStatus": "", "skuAttributes": [ { "key": "颜色", "value": "金色" }, { "key": "尺码", "value": "均码" } ], "skuCode": "", "skuId": "1o5o97s", "title": "测试商家审单" } ], "number": 1, "orderStatus": "ORDER_PAID", "orderTags": [ "WAREHOUSE" ], "payOrderId": 28705208402449, "payTimeStr": "2016-11-01 11:01:15", "platformPromotionAmount": 0, "processResponseDTO": { "inputTag": "0", "itemTag": "0", "itemTypeTag": "WAREHOUSE", "marketTag": "8", "sellerTag": "0", "userTag": "0" }, "promotionAmount": 0, "receiveTimeStr": "1970-01-01 08:00:00", "receiverAddress": "xxxxxxxxxxxxx", "receiverArea": "江干区", "receiverCity": "杭州市", "receiverMobile": "13706514233", "receiverName": "xxx", "receiverPhone": "13706xxx4233", "receiverProvince": "xxx省", "receiverZip": "310000", "sellerAccountId": "x朋", "sellerName": "x朋", "sellerUserId": 126947059, "shipExpense": "0", "shipExpressId": "", "shipExpressName": "", "shipTimeStr": "1970-01-01 08:00:00", "shipType": 0, "shopOrderId": 28705208412449, "shopOrderPrice": 10, "shopOrderType": "MOGUJIE_MARKET", "shopPromotionAmount": 0, "stageStatus": "ORDER_PAID" } ], "totalNum": 4 } }, "status": { "code": "0000000", "msg": "调用成功" } }

异常示例

1).
{ "result": {}, "status": { "code": "1200001", "msg": "该参数无结果值" } }