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

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

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

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



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

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

请求参数、 调用方式 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

多用户版专用参数

返回参数说明

标记

类型

例子

说明

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-已完结

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-是

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"total_results": 1,
	"data": [{
		"orderSource": "wap",
		"orderSn": "20031487300984",
		"settled": 0,
		"commissionEnterTime": 31507200000,
		"pid": "123456",
		"orderSubStatusName": "已失效",
		"isPrepay": 0,
		"orderTime": 1584150966000,
		"newCustomer": 2,
		"detailList": [{
			"commissionTotalCost": "239.00",
			"commCode": "330",
			"sizeId": "6918661798570873620",
			"goodsCount": 1,
			"commissionRate": "11.00",
			"orderSource": "wap",
			"goodsId": "6918661798452982548",
			"goodsThumb": "https://a.vpimg4.com/upload/merchandise/pdcvop/00100319/10000547/960169153-1971527585845714944-1971527585845714946-1_750x750_50.jpg",
			"commission": "26.29",
			"commName": "自营|女下装",
			"goodsName": "【2020春新款】荧光磨白破洞小脚翻边休闲牛仔裤",
			"status": 0
		}],
		"commission": "26.29",
		"channelTag": "123456",
		"selfBuy": 0,
		"status": 0,
		"lastUpdateTime": 1584235759000
	}]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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