唯品会订单查询api接口,获取订单列表信息(时间筛选版)
需要授权
15504人使用

获取订单列表信息,最大查询时间区间建议不超过1小时

如果调用接口出现 user has no union auth,requestId:genByGoodsIdWithOauth

下载“唯享客”app登录即可



查看详细说明
接口地址: http://api.tbk.dingdanxia.com/vip/order_details2 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

page

Integer

1

页码

pageSize

Integer

页面大小:默认20

orderTimeStart

Long

订单时间起始 时间戳 单位毫秒

orderTimeEnd

Long

订单时间结束 时间戳 单位毫秒

status

Short

订单状态:0-不合格,1-待定,2-已完结,该参数不设置默认代表全部状态

updateTimeStart

Long

更新时间-起始 时间戳 单位毫秒

updateTimeEnd

Long

下单时间-结束 时间戳 单位毫秒

access_token

String

多用户版专用参数

vip_auth_id

String

多联盟账号,切换授权参数

返回参数说明

标记

类型

例子

说明

orderSn

String

订单号

status

Short

订单状态:0-不合格,1-待定,2-已完结

newCustomer

Short

新老客:0-待定,1-新客,2-老客

channelTag

String

渠道标识

orderTime

Long

下单时间 时间戳 单位毫秒

signTime

Long

签收时间 时间戳 单位毫秒

settledTime

Long

结算时间 时间戳 单位毫秒

detailList

List<OrderDetailInfo>

商品明细

L goodsId

String

商品id

L goodsName

String

商品名称

L goodsThumb

String

商品缩略图

L goodsCount

Integer

商品数量

L commissionTotalCost

String

商品计佣金额

L commissionRate

String

商品佣金比例

L commission

String

商品佣金金额

L commCode

String

佣金编码:对应商品二级分类

L commName

String

佣金方案名称

L orderSource

String

订单来源

L afterSaleInfo

List<AfterSaleDetailInfo>

商品售后信息

L afterSaleChangedCommission

String

商品佣金售后变动:仅在订单完结之后发生售后时返回,无售后时为空

L afterSaleChangedGoodsCount

Integer

商品数量售后变动:仅在订单完结之后发生售后时返回,无售后时为空

L afterSaleSn

String

商品售后单号,无售后时为空

L afterSaleStatus

Integer

商品售后状态:1-售后中,2-售后完成,3-售后取消,无售后时为空

L afterSaleType

Integer

售后类型:1-退货,2-换货,无售后时为空

L afterSaleFinishTime

Long

售后完成时间,时间戳,单位:毫秒,无售后时为空

L sizeId

String

商品尺码:2019.01.01之后可用

L status

Short

商品状态:0-不合格,1-待定,2-已完结

L goodsFinalPrice

String

商品成交价(元,保留两位小数,商品成交价上线之后的订单才有该值)

L brandStoreSn

String

品牌编号

L brandStoreName

String

品牌名称

L spuId

String

商品spuId

lastUpdateTime

Long

订单上次更新时间 时间戳 单位毫秒

settled

Short

订单结算状态 0-未结算,1-已结算

selfBuy

Integer

是否自推自买 0-否,1-是

orderSubStatusName

String

订单子状态:流转状态-支持状态:(已下单、已付款、已签收、待结算、已结算、已失效

commission

String

商品总佣金:单位元

afterSaleChangeCommission

String

售后订单佣金变动:仅在订单完结之后发生售后行为时返回

afterSaleChangeGoodsCount

Integer

售后订单总商品数量变动:仅在订单完结之后发生售后行为时返回

commissionEnterTime

Long

入账时间,时间戳,单位毫秒

orderSource

String

订单来源

pid

String

推广PID:目前等同于channelTag

isPrepay

Integer

是否预付订单:0-否,1-是

statParam

String

自定义统计参数

totalCost

String

订单支付金额:单位元

orderTrackReason

Integer

订单归因方式:0-常规推广,1-惊喜红包,2-锁粉,3-超级红包

isSplit

Integer

订单拆单标识: 0-否,1-是

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"total_results": 1,
	"data": [{
		"isSplit": 0,
		"orderSource": "wap",
		"orderSn": "21033012779787",
		"settled": 0,
		"commissionEnterTime": 31507200000,
		"pid": "123456",
		"orderTrackReason": 0,
		"orderSubStatusName": "已下单",
		"isPrepay": 0,
		"statParam": "78910",
		"orderTime": 1617079230000,
		"newCustomer": 2,
		"detailList": [{
			"commissionTotalCost": "359.00",
			"sizeId": "6918663362518347928",
			"commissionRate": "0.00",
			"orderSource": "wap",
			"goodsId": "6918663350057259160",
			"goodsFinalPrice": "359.00",
			"brandStoreSn": "10000721",
			"brandStoreName": "斯凯奇",
			"commCode": "384271",
			"goodsCount": 1,
			"goodsThumb": "https://a.vpimg3.com/upload/merchandise/pdcvis/618313/2020/1217/170/da4d5a87-abb0-4c05-8961-3a5547a4b601_750x750_50.jpg",
			"commission": "0.00",
			"commName": "自营|运动鞋",
			"spuId": "SPU-080D92B880280167",
			"goodsName": "【春季爆款】斯凯奇女鞋明星同款经典熊猫鞋老爹鞋女休闲鞋",
			"status": 1
		}],
		"commission": "0.0",
		"appKey": "d1057433",
		"channelTag": "123456",
		"selfBuy": 1,
		"totalCost": "359.0",
		"status": 1,
		"lastUpdateTime": 1617079233000
	}]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。