全部
淘宝
拼多多
抖音
京东
快手
当当
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 未授权店铺 根据返回链接进行扫码授权