基础 qianmi.cloudshop.trades.sold.get(查询卖家在电商云中所有已卖出的订单(即将下线))

查询卖家在云商城(D2C)和云订货(D2P)中所有的已卖出的订单集合(只能获取到三个月以内的交易信息)。
1.返回的数据结果是以订单的创建时间倒序排列的。
2.返回的数据结果只包含了订单的部分数据,可通过qianmi.cloudshop.trade.fullinfo.get获取订单详情。
3.可以通过调用D2C、D2P批量获取订单接口只获取当前系统中的订单。
4.订单结构中site字段标识系统来源,1:云订货(D2P),2:云商城(D2C)。
 用户授权类型
 公共参数
请求地址:
环境 HTTP请求地址 HTTPS请求地址
正式环境 http://gw.api.qianmi.com/api https://api.qianmi.com/api
系统级请求参数:
名称 类型 是否必须 描述
methodString 必须 API接口名称
access_tokenString 可选 用户登录授权以后,QMOP颁发给应用的授权信息,详细介绍请点击这里,当前API的用户授权类型标明:"需要授权",则此参数必传,"不需要授权",则此参数不需要传。
formatString 必须 指定响应格式,目前支持格式为json
appKeyString 必须 分配给应用的AppKey
vString 必须 API协议版本,当前可选值:1.1
signString 必须 API输入参数签名结果
timestampString 必须 请求时间戳,时区为GMT+8(北京时间),格式:"yyyy-MM-dd HH:mm:ss",例如"2012-12-20 10:20:35",开放平台允许客户端请求的最大时间误差为10分钟
 业务参数
名称 类型 是否必须 示例值 默认值 描述
fieldsField List 必须 trade交易结构中的所有字段均可返回,多个字段用”,”分隔,请按需获取,获取order所有字段只需要传orders,如只需要部分字段,请按以下格式:order.oid,order.price
start_createdString 可选 2014-08-12 12:20:20 查询交易的创建开始时间,格式:yyyy-MM-dd HH:mm:ss,只能查询三个月之内的交易信息
end_createdString 可选 2014-08-12 12:20:20 查询交易创建的结束时间,格式:yyyy-MM-dd HH:mm:ss
buyer_nickString 可选 C100000121212 买家会员编号
page_sizeNumber 可选 50 每页条数,取值范围:大于0的整数,最大100,默认50
page_noNumber 可选 0 当前页码,从0开始,整数
pay_statusString 可选 0 订单支付状态, -1:全部, 0:未支付, 1:已支付, 2:已退款,4:部分退款
deliver_statusString 可选 0 订单发货状态, -1:全部, 0:未发货, 1:已发货, 2:已退货,3:部分发货,4:部分退货
complete_statusString 可选 0 订单完成状态, -1:全部, 0:进行中, 1:已完成, 2:已作废
 请求示例
OpenClient client = new DefaultOpenClient(url, appKey, appSecret);
TradesSoldGetRequest req = new TradesSoldGetRequest();
req.setFields("seller_nick,tid,payment,post_fee,num,orders,discount_fee,status,total_fee,timeout_action_time,reciver_name,reciver_state,reciver_city,reciver_district,reciver_address,reciver_zip,reciver_mobile,reciver_phone,created,modified,pay_time");
TradesSoldGetResponse response = client.execute(req, accessToken);
$client = new OpenClient;
$client->appKey = appKey;
$client->appSecret = appSecret;
$req = new TradesSoldGetRequest;
$req->setFields("seller_nick,tid,payment,post_fee,num,orders,discount_fee,status,total_fee,timeout_action_time,reciver_name,reciver_state,reciver_city,reciver_district,reciver_address,reciver_zip,reciver_mobile,reciver_phone,created,modified,pay_time");
$res = $client->execute($req, $accessToken);
IOpenClient client = new DefaultOpenClient(url, appKey, appSecret);
TradesSoldGetRequest req = new TradesSoldGetRequest();
req.Fields = "seller_nick,tid,payment,post_fee,num,orders,discount_fee,status,total_fee,timeout_action_time,reciver_name,reciver_state,reciver_city,reciver_district,reciver_address,reciver_zip,reciver_mobile,reciver_phone,created,modified,pay_time,consign_time,end_time,buyer_message,buyer_nick,area_id,ship_type_id,ship_type_name,sender_address,pay_order_no,pay_type_id,pay_type_name,pay_gate_code,pay_gate_name,pay_bank_code,total_trade_fee,invoice_flag";
TradesSoldGetResponse response = client.Execute(req, accessToken);
 响应参数
名称 类型 示例值 描述
trades Trade[] 查询到的交易信息。trade、order中包含的具体数据以入参fields为准
total_results Number 220 查询得到的交易信息总数
 响应示例

JSON数据格式:

 异常示例

JSON数据格式:

 {
    "errorToken": "@@$-ERROR_TOKEN$-@@",
    "code": "33",
    "message": "非法的参数",
    "solution": "请查看根据服务接口对参数格式的要求",
    "subErrors": {
      "subError": [{
          "code": "isv.invalid-paramete:XXXX",
          "message": "参数XXXX无效,格式不对、非法值、越界等"
        }]
  }
 错误码
错误码 错误描述 解决方案
isv.qianmi-cloudshop-trades-sold-get-service-error:00039003无效的交易状态请参考输入参数中对交易状态的定义重新设置交易状态。交易状态可以不设置,默认查询所有
isv.qianmi-cloudshop-trades-sold-get-service-error:00039004开始日期需在当前日期之前3个月内请确认开始日期是否在当前日期之前3个月内。开始日期可以不设置,默认为当前日期之前三个月
isv.qianmi-cloudshop-trades-sold-get-service-error:00039005结束日期不能早于开始日期请确认结束日期是否早于开始日期。结束日期可以不设置,默认为当前日期
isv.qianmi-cloudshop-trades-sold-get-service-error:00039006日期格式不正确,应符合yyyy-MM-dd HH:mm:ss请按照正确的日期格式重新设置开始日期或结束日期
 FAQ