全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
查询卖家已卖出的交易数据(根据第几页)
接口地址: http://api.vv-tool.com/tool/erps/pdd-order-list
接口介绍: 查询卖家已卖出的交易数据(根据第几页)点击查看详情
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 扣账户余额
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 必填 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
owner_id | string | 必填 | 店铺 owner_id |
order_status | INTEGER | 非必填 | 发货状态,1:待发货,2:已发货待签收,3:已签收 5:全部 |
refund_status | INTEGER | 非必填 | 售后状态 1:无售后或售后关闭,2:售后处理中,3:退款中,4: 退款成功 5:全部 |
start_confirm_at | LONG | 非必填 | 必填,成交时间开始时间的时间戳,指格林威治时间 1970 年 01 月 01 日 00 时 00 分 00 秒(北京时间 1970 年 01 月 01 日 08 时 00 分 00 秒)起至现在的总秒数 |
end_confirm_at | LONG | 非必填 | 必填,成交时间结束时间的时间戳,指格林威治时间 1970 年 01 月 01 日 00 时 00 分 00 秒(北京时间 1970 年 01 月 01 日 08 时 00 分 00 秒)起至现在的总秒数 PS:开始时间结束时间间距不超过 24 小时 |
page | INTEGER | 非必填 | 返回页码 默认 1,页码从 1 开始 PS:当前采用分页返回,数量和页数会一起传,如果不传,则采用 默认值 |
page_size | INTEGER | 非必填 | 返回数量,默认 100。最大 100 |
trade_type | INTEGER | 非必填 | 订单类型 0-普通订单 ,1- 定金订单 |
vvtype | INT | false | 增强版 1,不传默认 1,普通版 2,专业版 3 |
vttype | INT | false | 字段类型:1.全部基础字段,2.需要冷门字段 不传或者传错系统默认是 1 |
请求示例
owner_id:221213
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
order_list_get_response | OBJECT | 1 | 请求 response |
order_list | OBJECT[] | 1 | 订单信息列表 |
delivery_install_value | DOUBLE | 1 | 送货入户并安装费用 单位:元 |
delivery_home_value | DOUBLE | 1 | 送货入户费用 单位:元 |
home_install_value | DOUBLE | 1 | 上门安装费用 单位:元 |
card_info_list | OBJECT[] | 1 | 卡号信息列表 |
card_no | STRING | 1 | 卡号 |
mask_password | STRING | 1 | 卡密 |
free_sf | INTEGER | 1 | 是否顺丰包邮,1-是 0-否 |
confirm_status | INTEGER | 1 | 成交状态:0:未成交、1:已成交、2:已取消 |
group_status | INTEGER | 1 | 成团状态:0:拼团中、1:已成团、2:团失败 |
return_freight_payer | INTEGER | 1 | 退货包运费,1:是,0:否 |
home_delivery_type | INTEGER | 1 | 送货入户并安装服务 0-不支持送货,1-送货入户不安装,2-送货入户并安装 |
step_order_info | OBJECT | 1 | { "step_discount_amount":4, "advanced_paid_fee":1, "step_paid_fee":1.1, "step_trade_status":2 } |
step_trade_status | INTEGER | 1 | 定金订单状态:step_trade_status 枚举:0-定金未付尾款未付、1-定金已付尾款未付、2-定金已付尾款已付 |
step_paid_fee | DOUBLE | 1 | 分阶段已付金额 单位:元 |
advanced_paid_fee | DOUBLE | 1 | 已付定金 单位:元 |
step_discount_amount | DOUBLE | 1 | 膨胀金额 单位:元 |
trade_type | INTEGER | 1 | 订单类型 0-普通订单 ,1- 定金订单 |
order_sn | STRING | 1 | 订单编号 |
capital_free_discount | DOUBLE | 1 | 团长免单金额,单位:元 |
seller_discount | DOUBLE | 1 | 商家优惠金额,单位:元 |
platform_discount | DOUBLE | 1 | 平台优惠金额,单位:元 |
item_list | OBJECT[] | 1 | 订单商品列表 |
goods_price | DOUBLE | 1 | 商品单件 单价:元 |
goods_name | STRING | 1 | 商品名称 |
outer_goods_id | STRING | 1 | 商品维度外部编码,注意:编辑商品后必须等待商品审核通过后方可生效,订单中商品信息为交易快照的商品信息。 |
outer_id | STRING | 1 | sku 维度商家外部编码,注意:编辑商品后必须等待商品审核通过后方可生效,订单中商品信息为交易快照的商品信息。 |
sku_id | STRING | 1 | 商品 sku 编码 |
goods_id | STRING | 1 | 商品编码 |
goods_count | INTEGER | 1 | 商品数量 |
goods_spec | STRING | 1 | 商品规格 |
goods_img | STRING | 1 | 商品图片 |
remark | STRING | 1 | 订单备注 |
last_ship_time | STRING | 1 | 订单承诺发货时间 |
updated_at | STRING | 1 | 订单的更新时间 |
refund_status | INTEGER | 1 | 售后状态 |
is_lucky_flag | INTEGER | 1 | 是否是抽奖订单,1-非抽奖订单,2-抽奖订单 |
order_status | INTEGER | 1 | 订单状态 |
shipping_time | STRING | 1 | 发货时间 |
tracking_number | STRING | 1 | 快递单号 |
logistics_id | LONG | 1 | 快递公司在拼多多的代码 |
pay_type | STRING | 1 | 支付方式,枚举值:QQ,WEIXIN,ALIPAY,LIANLIANPAY |
pay_no | STRING | 1 | 支付单号 |
postage | DOUBLE | 1 | 邮费,单位:元 |
discount_amount | DOUBLE | 1 | 折扣金额,单位:元,折扣金额 = 平台优惠 + 商家优惠 + 团长免单优惠金额 |
goods_amount | DOUBLE | 1 | 商品金额,单位:元,商品金额 = 商品销售价格*商品数量-订单改价折扣金额 |
pay_amount | DOUBLE | 1 | 支付金额,单位:元,支付金额 = 商品金额-折扣金额 + 邮费 |
receiver_phone | STRING | 1 | 收件人电话。订单状态为待发货状态,且订单未被风控打标的情况下返回密文数据;其余情况返回空字符串。 |
address | STRING | 1 | 详细地址 |
town | STRING | 1 | 区,乡镇 |
city | STRING | 1 | 城市 |
province | STRING | 1 | 省份 |
country | STRING | 1 | 国家或地区 |
created_time | STRING | 1 | 订单创建时间 |
receiver_name | STRING | 1 | 收件人姓名。订单状态为待发货状态,且订单未被风控打标的情况下返回密文数据;其余情况返回空字符串。 |
confirm_time | STRING | 1 | 成交时间 |
receive_time | STRING | 1 | 确认收货时间 |
town_id | INTEGER | 1 | 区县编码 |
city_id | INTEGER | 1 | 城市编码 |
province_id | INTEGER | 1 | 省份编码 |
country_id | INTEGER | 1 | 国家或地区编码 |
is_stock_out | INTEGER | 1 | 是否缺货 0-无缺货处理 1: 有缺货处理 |
stock_out_handle_status | INTEGER | 1 | 缺货处理状态 -1:无缺货处理 0: 缺货待处理 1 缺货已处理 |
cat_id_4 | LONG | 1 | 商品四级分类 |
cat_id_3 | LONG | 1 | 商品三级分类 |
cat_id_2 | LONG | 1 | 商品二级分类 |
cat_id_1 | LONG | 1 | 商品一级分类 |
inner_transaction_id | STRING | 1 | 支付申报订单号(多多国际清关请使用此字段,单号以 XP 开头) |
buyer_memo | STRING | 1 | 买家留言信息 |
invoice_status | INTEGER | 1 | 发票申请,1 代表有 0 代表无 |
pre_sale_time | STRING | 1 | 预售时间 |
is_pre_sale | INTEGER | 1 | 是否为预售商品 1 表示是 0 表示否 |
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:补寄待商家发货 |
only_support_replace | INTEGER | 1 | 只换不修,1:是,0:否 |
support_nationwide_warranty | INTEGER | 1 | 全国联保,1:是,0:否 |
pay_time | STRING | 1 | 支付时间 |
order_depot_info | OBJECT | 1 | 仓库信息 |
depot_id | LONG | 1 | 仓库 id |
depot_name | STRING | 1 | 仓库名称 |
depot_code | STRING | 1 | 仓库编码 |
ware_id | LONG | 1 | 货品 id |
ware_name | STRING | 1 | 货品名称 |
ware_type | INTEGER | 1 | 货品类型(0:普通货品:1:组合货品) |
ware_sn | STRING | 1 | 货品编码 |
ware_sub_info_list | OBJECT[] | 1 | 子货品列表(组合货品才会有子货品信息) |
depot_type | INTEGER | 1 | 仓库类型,1:自有仓 2:订阅仓 两者都不是则传空 |
receiver_address | STRING | 1 | 收件人地址,不拼接省市区。订单状态为待发货状态,且订单未被风控打标的情况下返回密文数据;其余情况返回空字符串。 |
self_contained | INTEGER | 是否门店自提,1-是,0-否 | |
risk_control_status | INTEGER | 订单审核状态(0-正常订单, 1-审核中订单) | |
shipping_type | INTEGER | 创建交易时的物流方式(1-预约配送) | |
yyps_date | STRING | 预约配送日期 | |
yyps_time | STRING | 预约配送时段 | |
urge_shipping_time | STRING | 催发货时间 | |
delivery_one_day | INTEGER | 是否当日发货,1-是,0-否 | |
bonded_warehouse | STRING | 保税仓名称 | |
order_change_amount | DOUBLE | 订单改价折扣金额,单位元 | |
remark_tag | INTEGER | 1 | 订单备注标记,1-红色,2-黄色,3-绿色,4-蓝色,5-紫色 |
remark_tag_name | STRING | 红色 | 订单备注标记名称 |
duoduo_wholesale | INTEGER | 1 | 是否多多批发,1-是,0-否 |
mkt_biz_type | INTEGER | 1 | 市场业务类型,0-普通订单,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= 分销订单 | |
name | STRING | return_freight_payer | 标签名称 |
value | INTEGER | 1 | 是否有标签:0= 无标签,1= 有标签 |
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 | 赠品规格编码 | |
extra_delivery_list | OBJECT[] | 订单多包裹发货时使用的其他发货快递信息 | |
tracking_number | STRING | 快递运单号 | |
logistics_id | INTEGER | 快递公司编号 | |
receiver_name_mask | STRING | 收件人姓名(打码) | |
receiver_phone_mask | STRING | 收件人手机号(打码) | |
address_mask | STRING | 详细地址(打码) | |
receiver_address_mask | STRING | 收件人地址(打码) | |
total_count | INTEGER | 1 | 订单总数 |
has_next | BOOLEAN | 是否存在下一页 | |
withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 3860,
"time": 1638433143,
"data": {
"order_list": [
{
"order_sn": "210814-5574439732323325",
"delivery_install_value": "",
"delivery_home_value": "",
"home_install_value": "",
"free_sf": 0,
"confirm_status": 1,
"group_status": 1,
"return_freight_payer": 0,
"home_delivery_type": 0,
"trade_type": 0,
"capital_free_discount": "0",
"seller_discount": "0",
"platform_discount": "0",
"remark": "123",
"last_ship_time": "2021-08-16 00:12:29",
"updated_at": "2021-08-16 10:07:09",
"refund_status": 1,
"is_lucky_flag": 1,
"order_status": 1,
"shipping_time": "2021-08-14 03:23:54",
"tracking_number": "123213",
"logistics_id": "121",
"pay_type": "",
"pay_no": "",
"postage": "0",
"discount_amount": "0",
"goods_amount": "9",
"pay_amount": "9",
"receiver_phone": null,
"address": null,
"town": null,
"city": null,
"province": null,
"country": "中国",
"created_time": "2021-08-14 00:12:18",
"receiver_name": null,
"confirm_time": "2021-08-14 00:12:29",
"receive_time": "",
"town_id": 0,
"city_id": 0,
"province_id": 0,
"country_id": 0,
"is_stock_out": 0,
"stock_out_handle_status": -1,
"cat_id_4": 0,
"cat_id_3": 17407,
"cat_id_2": 17297,
"cat_id_1": 17285,
"inner_transaction_id": "",
"buyer_memo": "",
"invoice_status": 0,
"pre_sale_time": "",
"is_pre_sale": 0,
"after_sales_status": 10,
"only_support_replace": 0,
"support_nationwide_warranty": 0,
"pay_time": "2021-08-14 00:12:29",
"order_depot_info": "",
"receiver_address": null,
"self_contained": 0,
"risk_control_status": 0,
"shipping_type": 0,
"yyps_date": "",
"yyps_time": "",
"urge_shipping_time": "",
"delivery_one_day": 0,
"bonded_warehouse": "",
"order_change_amount": "0",
"remark_tag": 1,
"remark_tag_name": "红色",
"duoduo_wholesale": 0,
"mkt_biz_type": 0,
"print_status": 1,
"receiver_phone": "MTUdsadfsfTg=",
"address": "JUU4JUI0JUEyJUU1JfasdasfsadasU5JTgxJTkz",
"town": "双沟",
"city": "徐州市",
"province": "江苏省",
"country": null,
"created_time": "2021-11-27 17:34:23",
"receiver_name": "JUU1JUJDJUdasdasdsg5",
"goods": [
{
"id": 417,
"order_sn": "210814-55743242141095",
"goods_price": "9",
"goods_name": "无香型竹浆手帕纸单包迷你便携式竹浆本色不漂白餐巾纸",
"outer_goods_id": "",
"outer_id": "",
"sku_id": "913614791765",
"goods_id": "2679572246569",
"goods_count": 1,
"goods_spec": "",
"goods_img": "https://img.pddpic.com/gaudit-image/2021-08-07/a364163f16cdadb3d24b4945056fa754.jpeg",
"goods_weight": "",
"goods_bulk": ""
},
{
"id": 420,
"order_sn": "210814-5532424095",
"goods_price": "9",
"goods_name": "无香型竹浆手帕纸单包迷你便携式竹浆本色不漂白餐巾纸",
"outer_goods_id": "",
"outer_id": "",
"sku_id": "913614796765",
"goods_id": "267957246569",
"goods_count": 1,
"goods_spec": "",
"goods_img": "https://img.pddpic.com/gaudit-image/2021-08-07/a364163f16cdadb3d24b4945056fa754.jpeg",
"goods_weight": "",
"goods_bulk": ""
}
]
}
],
"total_count": 58,
"withholding_money": 1
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |