拼多多订单查询接口(按照更新时间段增量同步推广订单信息)
需要授权
1122人使用

按照更新时间段增量同步推广订单信息

接口地址: http://api.tbk.dingdanxia.com/pdd/orderlist 在线测试
请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

signature

string

接口签名,查看创建规则,(可在后台开启或关闭,关闭状态可不需要此参数)

start_update_time

LONG

1587776407

最近24小时内多多进宝商品订单更新时间--查询时间结束。note:此时间为时间戳,指格林威治时间 1970 年01 月 01 日 00 时 00 分 00 秒(北京时间 1970 年 01 月 01 日 08 时 00 分 00 秒)起至现在的总秒数

end_update_time

LONG

1587779867

最近24小时内多多进宝商品订单更新时间--查询时间开始。note:此时间为时间戳,指格林威治时间 1970 年01 月 01 日 00 时 00 分 00 秒(北京时间 1970 年 01 月 01 日 08 时 00 分 00 秒)起至现在的总秒数

page_size

INTEGER

返回的每页结果订单数,默认为100,范围为10到100,建议使用40~50,可以提高成功率,减少超时数量。

page

INTEGER

第几页,从1到10000,默认1,注:使用最后更新时间范围增量同步时,必须采用倒序的分页方式(从最后一页往回取)才能避免漏单问题

返回参数说明

标记

类型

例子

说明

total_count

LONG

请求到的结果数

custom_parameters

STRING

自定义参数

goods_id

LONG

商品ID

goods_name

STRING

商品标题

goods_price

LONG

订单中sku的单件价格,单位为分

goods_quantity

LONG

购买商品的数量

goods_thumbnail_url

STRING

商品缩略图

order_amount

LONG

实际支付金额,单位为分

order_create_time

LONG

订单生成时间,UNIX时间戳

order_group_success_time

LONG

成团时间

order_modify_at

LONG

最后更新时间

order_pay_time

LONG

支付时间

order_sn

STRING

推广订单编号

order_status

INTEGER

订单状态: -1 未支付; 0-已支付;1-已成团;2-确认收货;3-审核成功;4-审核失败(不可提现);5-已经结算;8-非多多进宝商品(无佣金订单)

order_status_desc

STRING

订单状态描述

order_verify_time

LONG

审核时间

p_id

STRING

推广位ID

promotion_amount

LONG

佣金金额,单位为分

promotion_rate

LONG

佣金比例,千分比

cpa_new

INTEGER

是否是 cpa 新用户,1表示是,0表示否

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"total_results": 1,
	"data": [{
		"match_channel": -1,
		"goods_price": 1280,
		"promotion_rate": 100,
		"type": 0,
		"order_status": 4,
		"order_create_time": 1587779788,
		"order_settle_time": 1587780120,
		"order_verify_time": null,
		"order_group_success_time": 1587779799,
		"order_amount": 1280,
		"order_modify_at": 1587780120,
		"auth_duo_id": 8516041,
		"cpa_new": 0,
		"goods_name": "美粮坊手抓饼50片-20片早餐灌煎饼面饼皮原味手抓饼批发家庭装",
		"batch_no": "",
		"goods_quantity": 1,
		"goods_id": 177891541,
		"goods_thumbnail_url": "http://t00img.yangkeduo.com/goods/images/2019-06-10/f5df7b940e11e653631e5532f2e17d2c.jpeg",
		"order_receive_time": null,
		"custom_parameters": "1234",
		"promotion_amount": 128,
		"order_pay_time": 1587779799,
		"group_id": 1106485232476830800,
		"duo_coupon_amount": 1,
		"scene_at_market_fee": 0,
		"order_status_desc": "审核失败",
		"fail_reason": "审核失败原因:订单发生退款",
		"order_id": "43ynqdW2p2JeU+n6cXX9pg==",
		"order_sn": "200425-485232476830887",
		"p_id": "8735184_70977074",
		"zs_duo_id": 0
	}]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。