文档
测试

有赞原始账单明细

POST
请求地址/router

请求地址

|环境|服务地址(HTTP/HTTPS)| |-|-| |V2正式环境(推荐)| https://gw.superboss.cc/router| **2022年4月1日**以后申请的APP Key,统一使用V2正式环境的请求地址:**https://gw.superboss.cc/router**

公共参数

调用任何一个API都必须传入的参数,目前支持的公共参数有: | 参数名称 | 参数类型 | 是否必须 | 参数描述 | | --- | --- | --- | --- | | method | string | 是 | API接口名称 | | appKey | string | 是 | 分配给应用的AppKey | | timestamp | string | 是 | 时间戳,时区为GMT+8,例如:2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟 | | format | string | 否 | 响应格式。默认为json格式,可选值:json | | version | string | 是 | API协议版本 可选值:1.0 | | sign\_method | string | 否 | 签名的摘要算法(默认 hmac),可选值为:hmac,md5,hmac-sha256。 | | sign | string | 是 | 签名 | | session | string | 是 | 授权会话信息 (即access_token,由系统分配) |

请求头

参数名
类型
描述
必填
Content-Type
string
application/x-www-form-urlencoded;charset=UTF-8
必填

API接口地址

参数名
类型
描述
必填
method
string
kmzk.platform.source.bill.list
必填

请求参数

参数名
类型
描述
必填
shopId
long
店铺id
必填
pageNo
integer
页码 取值范围:大于零的整数。默认值为1
必填
pageSize
integer
每页条数 取值范围:大于零的整数;最大值:500;默认值:20
必填
dataUpdateTimeStart
long
数据修改时间开始 毫秒值时间戳
可选
dataUpdateTimeEnd
long
数据修改时间结束 毫秒值时间戳
可选
billingTimeStart
long
账单日期时间开始 毫秒值时间戳
可选
billingTimeEnd
long
账单日期时间结束 毫秒值时间戳
可选

响应参数

参数名
类型
描述
traceId
string
示例:2779681989393635611
list
array
账单列表
content
object
账单内容
acquire_no
string
收单号,用于查询关联信息,示例:2304281453382622720176
account_type
string
变动账户类型,示例:店铺余额
amount
string
金额,单位元,示例:122.88
account_balance
string
账户余额,单位元,示例:71708.14
trade_from
string
交易来源地,示例:儿康堂育儿
create_time
string
创建时间,示例:2023-05-13 18:54:44
trade_channel
string
交易渠道,示例:网店
accountName
string
智库账单项目,示例:有赞-订单入账
biz_type
string
类型,示例:订单入账
change_money
string
变动账户金额,单位元,示例:122.88
pay_method
string
支付方式,示例:微信支付
account_owner
string
账务主体,展示本店铺名称,示例:儿康堂育儿
settle_time
string
入账时间,示例:2023-05-13 18:54:44
finish_time
string
结束时间,示例:2023-04-28 14:53:38
tid
string
有赞订单号,E开头+年月日时分秒+随机数,长度24位字母和数字组合,示例:E20230428145337054200091
user_no
string
商户号,示例:180731213415000000
account_type_code
string
变动账户类型code,示例:BALANCE
inout
int
收入支出,示例:1
relation_no
string
关联单号,示例:E20230428145337054200091
biz_type_code
string
类型,示例:SETTLEMENT
account_log_no
string
自增流水号,示例:230513185444000083
pay_water_no
string
支付流水号,示例:2304281453390000790176
desc
string
描述,示例:【皮皮宝】儿康堂药食同源儿童草本饮料孩子娇嫩的脾胃皮皮宝呵护
total
int
总条数,示例:37666
success
boolean
示例:true