基础 qianmi.cloudshop.d2p.return.list.get(查询云分销退货单列表(只能获取到三个月以内的退单信息))
查询云分销退货单列表(只能获取到三个月以内的退单信息)
1. 返回的数据结果是以退货单的创建时间倒序排列的
1. 返回的数据结果是以退货单的创建时间倒序排列的
用户授权类型
公共参数
请求地址:
系统级请求参数:
环境 | HTTP请求地址 | HTTPS请求地址 | 正式环境 | http://gw.api.qianmi.com/api | https://api.qianmi.com/api |
---|
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
method | String | 必须 | API接口名称 |
access_token | String | 可选 | 用户登录授权以后,QMOP颁发给应用的授权信息,详细介绍请点击这里,当前API的用户授权类型标明:"需要授权",则此参数必传,"不需要授权",则此参数不需要传。 |
format | String | 必须 | 指定响应格式,目前支持格式为json |
appKey | String | 必须 | 分配给应用的AppKey |
v | String | 必须 | API协议版本,当前可选值:1.1 |
sign | String | 必须 | API输入参数签名结果 |
timestamp | String | 必须 | 请求时间戳,时区为GMT+8(北京时间),格式:"yyyy-MM-dd HH:mm:ss",例如"2012-12-20 10:20:35",开放平台允许客户端请求的最大时间误差为10分钟 |
业务参数
名称 | 类型 | 是否必须 | 示例值 | 默认值 | 描述 |
---|---|---|---|---|---|
fields | Field List | 必须 | rid,flow_state | returnOrder交易结构中的所有字段均可返回,多个字段用”,”分隔,请按需获取,获取returnItem所有字段只需要传return_items,如只需要部分字段,请按以下格式:return_item.oid,return_item.price | |
flow_state | String | 可选 | COMPLETED | 已创建(INIT),已取消(VOID),已拒绝(REFUSE),已审核(AUDIT),已收货(RECEIVED),已退款(REFUNDED),已完成(COMPLETED),不传默认查全部 | |
buyer_code | String | 可选 | A121212 | 买家编号 | |
start_create | String | 必须 | 2014-08-12 12:20:20 | 查询退单的创建开始时间,格式:yyyy-MM-dd HH:mm:ss,只能查询三个月之内的交易信息 | |
end_created | String | 必须 | 2014-08-12 12:20:20 | 查询退单创建的结束时间,格式:yyyy-MM-dd HH:mm:ss | |
page_size | Number | 可选 | 10 | 50 | 每页条数,取值范围:大于0的整数,最大100,默认50 |
page_no | Number | 可选 | 2 | 0 | 当前页码,从0开始,整数 |
tid | String | 可选 | TP2003171340326565 | 订单号 |
请求示例
OpenClient client = new DefaultOpenClient(url, appKey, appSecret); D2pReturnListGetRequest req = new D2pReturnListGetRequest(); req.setFields("rid"); D2pReturnListGetResponse response = client.execute(req, accessToken);
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
total_results | Number | 12 | 退单数量 |
响应示例
异常示例
{ "errorToken": "@@$-ERROR_TOKEN$-@@", "code": "33", "message": "非法的参数", "solution": "请查看根据服务接口对参数格式的要求", "subErrors": { "subError": [{ "code": "isv.invalid-paramete:XXXX", "message": "参数XXXX无效,格式不对、非法值、越界等" }] }
错误码
API工具
FAQ