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

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