拼多多开放平台免审核调用：获取拼多多订单列表查询接口

pdd.order.list.get

订单列表查询接口（根据成交时间）

更新时间：2023-08-14 14:21:54

¥基础API必须用户授权

根据成交时间查询订单列表（只能获取到成交时间三个月以内的交易信息） 注：虚拟订单充值手机号信息无法通过此接口获取，请联系虚拟类目运营人员。

拼多多自定义API操作 API：pinduoduo.custom测试

公共参数

请求地址（目前只提供正式环境，暂无沙箱环境）

环境	HTTP地址	HTTPS地址
正式环境	http://gw-api.pinduoduo.com/api/router	https://gw-api.pinduoduo.com/api/router

公共请求参数

参数名称	参数类型	是否必填	参数描述
type	String	必填	API接口名称
client_id	String	必填	POP分配给应用的client_id
access_token	String	非必填	通过code获取的access_token
timestamp	String	必填	UNIX时间戳，单位秒，需要与拼多多服务器时间差值在10分钟内
data_type	String	非必填	响应格式，即返回数据的格式，JSON或者XML（二选一），默认JSON，注意是大写
version	String	非必填	API协议版本号，默认为V1，可不填
sign	String	必填	API输入参数签名结果，签名算法参考开放平台接入指南第三部分底部。

请求参数说明

点击收起

参数接口	参数类型	是否必填	说明
end_confirm_at	LONG	必填	必填，成交时间结束时间的时间戳，指格林威治时间 1970 年 01 月 01 日 00 时 00 分 00 秒(北京时间 1970 年 01 月 01 日 08 时 00 分 00 秒)起至现在的总秒数 PS：开始时间结束时间间距不超过 24 小时
order_status	INTEGER	必填	发货状态，1：待发货，2：已发货待签收，3：已签收 5：全部
page	INTEGER	必填	返回页码 默认 1，页码从 1 开始 PS：当前采用分页返回，数量和页数会一起传，如果不传，则采用 默认值
page_size	INTEGER	必填	返回数量，默认 100。最大 100
refund_status	INTEGER	必填	售后状态 1：无售后或售后关闭，2：售后处理中，3：退款中，4： 退款成功 5：全部
start_confirm_at	LONG	必填	必填，成交时间开始时间的时间戳，指格林威治时间 1970 年 01 月 01 日 00 时 00 分 00 秒(北京时间 1970 年 01 月 01 日 08 时 00 分 00 秒)起至现在的总秒数
trade_type	INTEGER	非必填	订单类型 0-普通订单 ，1- 定金订单
use_has_next	BOOLEAN	非必填	是否启用has_next的分页方式，如果指定true,则返回的结果中不包含总记录数，但是会新增一个是否存在下一页的的字段，通过此种方式获取增量交易，效率在原有的基础上有80%的提升。

返回参数说明

点击收起

参数接口	参数类型	例子	说明
order_list_get_response	OBJECT	1	请求response
has_next	BOOLEAN		是否存在下一页
order_list	OBJECT[]	1	订单信息列表
address 加密	STRING	1	详细地址
address_mask	STRING		详细地址（打码）
after_sales_status	INTEGER	1	售后状态 0：无售后 2：买家申请退款，待商家处理 3：退货退款，待商家处理 4：商家同意退款，退款中 5：平台同意退款，退款中 6：驳回退款，待买家处理 7：已同意退货退款,待用户发货 8：平台处理中 9：平台拒绝退款，退款关闭 10：退款成功 11：买家撤销 12：买家逾期未处理，退款失败 13：买家逾期，超过有效期 14：换货补寄待商家处理 15：换货补寄待用户处理 16：换货补寄成功 17：换货补寄失败 18：换货补寄待用户确认完成 21：待商家同意维修 22：待用户确认发货 24：维修关闭 25：维修成功 27：待用户确认收货 31：已同意拒收退款，待用户拒收 32：补寄待商家发货
bonded_warehouse	STRING		保税仓名称
buyer_memo	STRING	1	买家留言信息
capital_free_discount	DOUBLE	1	团长免单金额，单位：元
card_info_list	OBJECT[]	1	卡号信息列表
card_no 加密	STRING	1	卡号
mask_password 加密	STRING	1	卡密
cat_id_1	LONG	1	商品一级分类
cat_id_2	LONG	1	商品二级分类
cat_id_3	LONG	1	商品三级分类
cat_id_4	LONG	1	商品四级分类
city	STRING	1	城市
city_id	INTEGER	1	城市编码
confirm_status	INTEGER	1	成交状态：0：未成交、1：已成交、2：已取消
confirm_time	STRING	1	成交时间
consolidate_info	OBJECT		集运信息
consolidate_type	INTEGER		集运类型 0-中国香港集运、1-中国新疆中转、2-哈萨克斯坦集运、3-中国西藏中转、5-日本集运、6-中国台湾集运、7-韩国集运、8-新加坡集运、9-马来西亚集运、10-泰国集运
country	STRING	1	国家或地区
country_id	INTEGER	1	国家或地区编码
created_time	STRING	1	订单创建时间
delivery_home_value	DOUBLE	1	送货入户费用 单位：元
delivery_install_value	DOUBLE	1	送货入户并安装费用 单位：元
delivery_one_day	INTEGER		是否当日发货，1-是，0-否
discount_amount	DOUBLE	1	折扣金额，单位：元，折扣金额=平台优惠+商家优惠+团长免单优惠金额
duoduo_wholesale	INTEGER	1	是否多多批发，1-是，0-否
extra_delivery_list	OBJECT[]		订单多包裹发货时使用的其他发货快递信息
logistics_id	INTEGER		快递公司编号
tracking_number	STRING		快递运单号
free_sf	INTEGER	1	是否顺丰包邮，1-是 0-否
gift_delivery_list	OBJECT[]		赠品额外运单列表
logistics_id	INTEGER		快递ID
tracking_number	STRING		运单号
gift_list	OBJECT[]		赠品列表
goods_count	INTEGER		赠品数量
goods_id	LONG		赠品id
goods_img	STRING		赠品图片
goods_name	STRING		赠品名称
goods_price	DOUBLE		赠品销售价格
goods_spec	STRING		赠品规格
outer_goods_id	STRING		商家外部商品编码
outer_id	STRING		商家外部sku编码
sku_id	LONG		赠品规格编码
goods_amount	DOUBLE	1	商品金额，单位：元，商品金额=商品销售价格*商品数量-订单改价折扣金额
group_order_id	LONG		团id
group_role	INTEGER		团身份。0-团员，1-团长
group_status	INTEGER	1	成团状态：0：拼团中、1：已成团、2：团失败
home_delivery_type	INTEGER	1	送货入户并安装服务 0-不支持送货，1-送货入户不安装，2-送货入户并安装
home_install_value	DOUBLE	1	上门安装费用 单位：元
inner_transaction_id 加密	STRING	1	支付申报订单号（多多国际清关请使用此字段，单号以XP开头）
invoice_status	INTEGER	1	发票申请,1代表有 0代表无
is_lucky_flag	INTEGER	1	是否是抽奖订单，1-非抽奖订单，2-抽奖订单
is_pre_sale	INTEGER	1	是否为预售商品 1表示是 0表示否
is_stock_out	INTEGER	1	是否缺货 0-无缺货处理 1： 有缺货处理
item_list	OBJECT[]	1	订单商品列表
goods_count	INTEGER	1	商品数量
goods_id	STRING	1	商品编码
goods_img	STRING	1	商品图片
goods_name	STRING	1	商品名称
goods_price	DOUBLE	1	商品单件 单价：元
goods_spec	STRING	1	商品规格
outer_goods_id	STRING	1	商品维度外部编码，注意：编辑商品后必须等待商品审核通过后方可生效，订单中商品信息为交易快照的商品信息。
outer_id	STRING	1	sku维度商家外部编码，注意：编辑商品后必须等待商品审核通过后方可生效，订单中商品信息为交易快照的商品信息。
sku_id	STRING	1	商品sku编码
last_ship_time	STRING	1	订单承诺发货时间
logistics_id	LONG	1	快递公司在拼多多的代码
mkt_biz_type	INTEGER	1	市场业务类型，0-普通订单，1-拼内购订单
only_support_replace	INTEGER	1	只换不修，1:是，0:否
order_change_amount	DOUBLE		订单改价折扣金额，单位元
order_depot_info	OBJECT	1	仓库信息
depot_code	STRING	1	仓库编码
depot_id	LONG	1	仓库id
depot_name	STRING	1	仓库名称
depot_type	INTEGER	1	仓库类型，1：自有仓 2：订阅仓 两者都不是则传空
ware_id	LONG	1	货品id
ware_name	STRING	1	货品名称
ware_sn	STRING	1	货品编码
ware_sub_info_list	OBJECT[]	1	子货品列表（组合货品才会有子货品信息）
ware_id	LONG	1	子货品id
ware_name	STRING	1	子货品名称
ware_quantity	LONG	1	子货品数量
ware_sn	STRING	1	子货品编码
ware_type	INTEGER	1	货品类型（0：普通货品:1：组合货品）
order_sn	STRING	1	订单编号
order_status	INTEGER	1	订单状态
order_tag_list	OBJECT[]		订单标签列表，no_trace_delivery=无痕发货，only_support_replace=只换不修，duoduo_wholesale=多多批发，return_freight_payer=退货包运费，free_sf=顺丰包邮，support_nationwide_warranty=全国联保，self_contained=门店自提，delivery_one_day=当日发货，oversea_tracing=全球购溯源，distributional_sale=分销订单，open_in_festival=不打烊，region_black_delay_shipping=发货时间可延迟，same_city_distribution=同城配送，has_subsidy_postage=补贴运费红包，has_sf_express_service=顺丰加价，community_group=小区团购，has_ship_additional=加运费发顺丰，ship_additional_order=加运费补差价订单，conso_order=集运订单，allergy_refund=过敏包退，professional_appraisal=专业鉴定，ship_hold=暂停发货
name	STRING	return_freight_payer	标签名称
value	INTEGER	1	是否有标签：0=无标签，1=有标签
pay_amount	DOUBLE	1	支付金额，单位：元，支付金额=商品金额-折扣金额+邮费+服务费
pay_no 加密	STRING	1	支付单号
pay_time	STRING	1	支付时间
pay_type	STRING	1	支付方式，枚举值：QQ,WEIXIN,ALIPAY,LIANLIANPAY
platform_discount	DOUBLE	1	平台优惠金额，单位：元
postage	DOUBLE	1	邮费，单位：元
pre_sale_time	STRING	1	预售时间
promise_delivery_time	STRING		承诺送达时间
province	STRING	1	省份
province_id	INTEGER	1	省份编码
receive_time	STRING	1	确认收货时间
receiver_address 加密	STRING	1	收件人地址，不拼接省市区。订单状态为待发货状态，且订单未被风控打标的情况下返回密文数据；其余情况返回空字符串。
receiver_address_mask	STRING		收件人地址（打码）
receiver_name 加密	STRING	1	收件人姓名。订单状态为待发货状态，且订单未被风控打标的情况下返回密文数据；其余情况返回空字符串。
receiver_name_mask	STRING		收件人姓名（打码）
receiver_phone 加密	STRING	1	收件人电话。订单状态为待发货状态，且订单未被风控打标的情况下返回密文数据；其余情况返回空字符串。
receiver_phone_mask	STRING		收件人手机号（打码）
refund_status	INTEGER	1	售后状态
remark	STRING	1	订单备注
remark_tag	INTEGER	1	订单备注标记，1-红色，2-黄色，3-绿色，4-蓝色，5-紫色
remark_tag_name	STRING	红色	订单备注标记名称
resend_delivery_list	OBJECT[]		补寄额外运单列表
logistics_id	INTEGER		快递ID
tracking_number	STRING		运单号
return_freight_payer	INTEGER	1	退货包运费，1:是，0:否
risk_control_status	INTEGER		订单审核状态（0-正常订单， 1-审核中订单）
self_contained	INTEGER		是否门店自提，1-是，0-否
seller_discount	DOUBLE	1	商家优惠金额，单位：元
service_fee_detail	OBJECT[]		服务费明细列表，sf_express_fee=顺丰加价服务
service_fee	DOUBLE		服务费金额，单位：元
service_name	STRING		服务费类型
ship_additional_link_order	STRING		关联的加运费发顺丰的补差价订单
ship_additional_origin_order	STRING		加运费补差价订单的原单
shipping_time	STRING	1	发货时间
shipping_type	INTEGER		创建交易时的物流方式(1-预约配送)
step_order_info	OBJECT	1	{ "step_discount_amount":4, "advanced_paid_fee":1, "step_paid_fee":1.1, "step_trade_status":2 }
advanced_paid_fee	DOUBLE	1	已付定金 单位：元
step_discount_amount	DOUBLE	1	膨胀金额 单位：元
step_paid_fee	DOUBLE	1	分阶段已付金额 单位：元
step_trade_status	INTEGER	1	定金订单状态：step_trade_status 枚举：0-定金未付尾款未付、1-定金已付尾款未付、2-定金已付尾款已付
stock_out_handle_status	INTEGER	1	缺货处理状态 -1:无缺货处理 0: 缺货待处理 1缺货已处理
support_nationwide_warranty	INTEGER	1	全国联保，1:是，0:否
town	STRING	1	区，乡镇
town_id	INTEGER	1	区县编码
tracking_number	STRING	1	快递单号
trade_type	INTEGER	1	订单类型 0-普通订单 ，1- 定金订单
updated_at	STRING	1	订单的更新时间
urge_shipping_time	STRING		催发货时间
yyps_date	STRING		预约配送日期
yyps_time	STRING		预约配送时段
duo_duo_pay_reduction	DOUBLE		多多支付立减金额，单位：元
total_count	INTEGER	1	订单总数

请求示例

点击收起

JAVA

CURL

1

package com.pdd.pop.sdk.http.demo;

2

​

3

import com.pdd.pop.sdk.common.util.JsonUtil;

4

import com.pdd.pop.sdk.http.api.pop.request.PddOrderListGetRequest;

5

import com.pdd.pop.sdk.http.api.pop.response.PddOrderListGetResponse;

6

import com.pdd.pop.sdk.http.PopClient;

7

import com.pdd.pop.sdk.http.PopHttpClient;

8

​

9

public class PopClientDemo {

10

​

11

    public static void main(String[] args) throws Exception {

12

​

13

        String clientId = "your clientId";

14

        String clientSecret = "your clientSecret";

15

        String accessToken = "your accessToken";

16

        PopClient client = new PopHttpClient(clientId, clientSecret);

17

​

18

        PddOrderListGetRequest request = new PddOrderListGetRequest();

19

        request.setEndConfirmAt(1L);

20

        request.setOrderStatus(1);

21

        request.setPage(1);

22

        request.setPageSize(1);

23

        request.setRefundStatus(1);

24

        request.setStartConfirmAt(1L);

25

        request.setTradeType(1);

26

        request.setUseHasNext(true);

27

        PddOrderListGetResponse response = client.syncInvoke(request, accessToken);

28

        System.out.println(JsonUtil.transferToJson(response));

29

    }

30

}

31

​

响应示例

点击收起

1

{

2

  "order_list_get_response": {

3

    "has_next": false,

4

    "order_list": [

5

      {

6

        "address": "1",

7

        "address_mask": "str",

8

        "after_sales_status": 1,

9

        "bonded_warehouse": "str",

10

        "buyer_memo": "1",

11

        "capital_free_discount": 1.0,

12

        "card_info_list": [

13

          {

14

            "card_no": "1",

15

            "mask_password": "1"

16

          }

17

        ],

18

        "cat_id_1": 1,

19

        "cat_id_2": 1,

20

        "cat_id_3": 1,

21

        "cat_id_4": 1,

22

        "city": "1",

23

        "city_id": 1,

24

        "confirm_status": 1,

25

        "confirm_time": "1",

26

        "consolidate_info": {

27

          "consolidate_type": 0

28

        },

29

        "country": "1",

30

        "country_id": 1,

31

        "created_time": "1",

32

        "delivery_home_value": 1.0,

33

        "delivery_install_value": 1.0,

34

        "delivery_one_day": 0,

35

        "discount_amount": 1.0,

36

        "duo_duo_pay_reduction": 0.0,

37

        "duoduo_wholesale": 1,

38

        "extra_delivery_list": [

39

          {

40

            "logistics_id": 0,

41

            "tracking_number": "str"

42

          }

43

        ],

44

        "free_sf": 1,

45

        "gift_delivery_list": [

46

          {

47

            "logistics_id": 0,

48

            "tracking_number": "str"

49

          }

50

        ],

51

        "gift_list": [

52

          {

53

            "goods_count": 0,

54

            "goods_id": 0,

55

            "goods_img": "str",

56

            "goods_name": "str",

57

            "goods_price": 0.0,

58

            "goods_spec": "str",

59

            "outer_goods_id": "str",

60

            "outer_id": "str",

61

            "sku_id": 0

62

          }

63

        ],

64

        "goods_amount": 1.0,

65

        "group_order_id": 0,

66

        "group_role": 0,

67

        "group_status": 1,

68

        "home_delivery_type": 1,

69

        "home_install_value": 1.0,

70

        "inner_transaction_id": "1",

71

        "invoice_status": 1,

72

        "is_lucky_flag": 1,

73

        "is_pre_sale": 1,

74

        "is_stock_out": 1,

75

        "item_list": [

76

          {

77

            "goods_count": 1,

78

            "goods_id": "1",

79

            "goods_img": "1",

80

            "goods_name": "1",

81

            "goods_price": 1.0,

82

            "goods_spec": "1",

83

            "outer_goods_id": "1",

84

            "outer_id": "1",

85

            "sku_id": "1"

86

          }

87

        ],

88

        "last_ship_time": "1",

89

        "logistics_id": 1,

90

        "mkt_biz_type": 1,

91

        "only_support_replace": 1,

92

        "order_change_amount": 0.0,

93

        "order_depot_info": {

94

          "depot_code": "1",

95

          "depot_id": 1,

96

          "depot_name": "1",

97

          "depot_type": 1,

98

          "ware_id": 1,

99

          "ware_name": "1",

100

          "ware_sn": "1",

101

          "ware_sub_info_list": [

102

            {

103

              "ware_id": 1,

104

              "ware_name": "1",

105

              "ware_quantity": 1,

106

              "ware_sn": "1"

107

            }

108

          ],

109

          "ware_type": 1

110

        },

111

        "order_sn": "1",

112

        "order_status": 1,

113

        "order_tag_list": [

114

          {

115

            "name": "return_freight_payer",

116

            "value": 1

117

          }

118

        ],

119

        "pay_amount": 1.0,

120

        "pay_no": "1",

121

        "pay_time": "1",

122

        "pay_type": "1",

123

        "platform_discount": 1.0,

124

        "postage": 1.0,

125

        "pre_sale_time": "1",

126

        "promise_delivery_time": "str",

127

        "province": "1",

128

        "province_id": 1,

129

        "receive_time": "1",

130

        "receiver_address": "1",

131

        "receiver_address_mask": "str",

132

        "receiver_name": "1",

133

        "receiver_name_mask": "str",

134

        "receiver_phone": "1",

135

        "receiver_phone_mask": "str",

136

        "refund_status": 1,

137

        "remark": "1",

138

        "remark_tag": 1,

139

        "remark_tag_name": "红色",

140

        "resend_delivery_list": [

141

          {

142

            "logistics_id": 0,

143

            "tracking_number": "str"

144

          }

145

        ],

146

        "return_freight_payer": 1,

147

        "risk_control_status": 0,

148

        "self_contained": 0,

149

        "seller_discount": 1.0,

150

        "service_fee_detail": [

151

          {

152

            "service_fee": 0.0,

153

            "service_name": "str"

154

          }

155

        ],

156

        "ship_additional_link_order": "str",

157

        "ship_additional_origin_order": "str",

158

        "shipping_time": "1",

159

        "shipping_type": 0,

160

        "step_order_info": {

161

          "advanced_paid_fee": 1.0,

162

          "step_discount_amount": 1.0,

163

          "step_paid_fee": 1.0,

164

          "step_trade_status": 1

165

        },

166

        "stock_out_handle_status": 1,

167

        "support_nationwide_warranty": 1,

168

        "town": "1",

169

        "town_id": 1,

170

        "tracking_number": "1",

171

        "trade_type": 1,

172

        "updated_at": "1",

173

        "urge_shipping_time": "str",

174

        "yyps_date": "str",

175

        "yyps_time": "str"

176

      }

177

    ],

178

    "total_count": 1

179

  }

180

}

异常示例

点击收起

JSON

XML

1

​

2

{

3

  "error_response": {

4

    "error_msg": "公共参数错误:type",

5

    "sub_msg": "",

6

    "sub_code": null,

7

    "error_code": 10001,

8

    "request_id": "15440104776643887"

9

  }

10

}

相关权限包

点击收起

拥有此接口的权限包	可获得/可申请此权限包的应用类型
订单信息查询权限包	打单、进销存、虚拟商家后台系统、企业ERP、商家后台系统、订单处理、电子凭证商家后台系统、跨境企业ERP报关版

返回错误码说明

点击收起

主错误码	主错误描述	子错误码	子错误描述	解决办法
10000	参数错误	10000	参数错误	参数值有误，按照文档要求填写请求参数
10001	公共参数错误	10001	公共参数错误	请检查请求的公共参数
10016	client下线或者clientId不正确	10016	client下线或者clientId不正确	请核查您的client_id是否正确
10017	type不正确	10017	type不正确	检查type是否正确
10018	target_client_id下线或者target_client_id不正确	10018	target_client_id下线或者target_client_id不正确	检查target_client_id 是否正确
10019	access_token已过期	10019	access_token已过期	刷新access_token或者重新授权再次获取access_token
20004	签名sign校验失败	20004	签名sign校验失败	请按照接入指南第三部分指导，生成签名
20005	ip无权访问接口，请加入ip白名单	20005	ip无权访问接口，请加入ip白名单	把ip白名单加入白名单
20031	用户没有授权访问此接口	20031	用户没有授权访问此接口	您创建的应用中不包含此接口，请查看API文档，了解相关权限包
20032	access_token或client_id错误	20032	access_token或client_id错误	检查access_token或client_id
20034	接口处于下线状态	20034	接口处于下线状态	检查接口状态
20035	接口不属于当前网关	20035	接口不属于当前网关	判断调用网关url 是否正确
21001	请求参数错误	21001	请求参数错误	业务参数输入错误
21002	请求参数不能为空	21002	请求参数不能为空	检查业务参数必填是否已填
30000	没有调用此target接口权限	30000	没有调用此target接口权限	检查是否获得调用此target接口权限
30001	client_id和partner_id不匹配	30001	client_id和partner_id不匹配	检查partner_id是否正确
50000	系统内部错误	50000	系统内部错误	系统内部错误，请加群联系相关负责人
50002	业务系统内部异常	50002	业务系统内部异常	请加群联系相关负责人
52001	网关业务服务错误	52001	网关业务服务错误	联系技术支持解决
52002	网关系统内部异常	52002	网关系统内部异常	联系技术支持解决
52004	请求body 太大	52004	请求body 太大	检查请求体是否过大
52101	当前接口被限流，请稍后重试	52101	当前接口被限流，请稍后重试	当前接口被限流，请稍后重试
52102	当前接口暂时不可用，请稍后重试	52102	当前接口暂时不可用，请稍后重试	当前接口被降级，请稍后重试
52103	服务暂时不可用，请稍后重试	52103	服务暂时不可用，请稍后重试	当前接口被降级，请稍后重试
70031	调用过于频繁，请调整调用频率	70031	调用过于频繁，请调整调用频率	调用过于频繁，请调整调用频率
70032	当前请求被禁止调用	70032	当前请求被禁止调用	当前请求被禁止调用
70033	当前接口因系统维护，暂时下线，请稍后再试！	70033	当前接口因系统维护，暂时下线，请稍后再试！	当前接口因系统维护，暂时下线，请稍后再试！
70034	当前用户或应用存在风险，禁止调用！	70034	当前用户或应用存在风险，禁止调用！	当前用户或应用存在风险，禁止调用！
70035	当前用户或应用存在风险，禁止调用。请联系ddjb@pinduoduo.com	70035	当前用户或应用存在风险，禁止调用。请联系ddjb@pinduoduo.com	当前用户或应用存在风险，禁止调用。请联系ddjb@pinduoduo.com
70036	应用处于测试状态，调用次数被限制	70036	应用处于测试状态，调用次数被限制	应用处于测试状态，调用次数达到上限被限制
50001	业务服务错误