基础 qianmi.cloudshop.d2p.trade.receive.get(获取云订货(D2P)订单的收款单)

获取云订货(D2P)订单的收款单,同一笔订单可能会有多笔收款单
 用户授权类型
 公共参数
请求地址:
环境 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 必须 receive_id,tid,trade_amount 需要返回的收款单字段,所有字段均可返回
receive_idString 特殊可选 201509221710015707 收款单据编号,特殊可选,与订单编号必传一个,如果同时传入,以传入的收款单号为准
tidString 特殊可选 T20151118131015582 订单编号,特殊可选,与收款单编号必须传一个,如果两个都传,以传入的收款单编号receive_id为准
 请求示例
OpenClient client = new DefaultOpenClient(url, appKey, appSecret);
D2pTradeReceiveGetRequest req = new D2pTradeReceiveGetRequest();
req.setFields("receive_id,member_id,member_nick,pay_amount,pay_gate_code,pay_gate_name,receive_time,pay_bank_code,pay_bank_name,remark,operator,tid,pay_account,pay_status");
req.setTid("T20151118131015582");
D2pTradeReceiveGetResponse response = client.execute(req, accessToken);
$client = new OpenClient;
$client->appKey = appKey;
$client->appSecret = appSecret;
$req = new D2pTradeReceiveGetRequest;
$req->setFields("receive_id,member_id,member_nick,pay_amount,pay_gate_code,pay_gate_name,receive_time,pay_bank_code,pay_bank_name,remark,operator,tid,pay_account,pay_status");
$req->setTid("T20151118131015582");
$res = $client->execute($req, $accessToken);
IOpenClient client = new DefaultOpenClient(url, appKey, appSecret);
D2pTradeReceiveGetRequest req = new D2pTradeReceiveGetRequest();
req.Fields = "receive_id,member_id,member_nick,pay_amount,pay_gate_code,pay_gate_name,receive_time,pay_bank_code,pay_bank_name,remark,operator,tid,pay_account,pay_status";
req.Tid = "T20151118131015582";
D2pTradeReceiveGetResponse response = client.Execute(req, accessToken);
 响应参数
名称 类型 示例值 描述
receive_orders ReceiveOrder[] 收款单信息
 响应示例

JSON数据格式:

 异常示例

JSON数据格式:

 {
    "errorToken": "@@$-ERROR_TOKEN$-@@",
    "code": "33",
    "message": "非法的参数",
    "solution": "请查看根据服务接口对参数格式的要求",
    "subErrors": {
      "subError": [{
          "code": "isv.invalid-paramete:XXXX",
          "message": "参数XXXX无效,格式不对、非法值、越界等"
        }]
  }
 错误码
错误码 错误描述 解决方案
isv.qianmi-cloudshop-d2p-trade-receive-get-service-error:01042001订单不存在请检查参数tid
isv.qianmi-cloudshop-d2p-trade-receive-get-service-error:01049001收款单编号和订单编号不能同时为空请检查参数
 FAQ