对账核销应收账单
系统相关界面
"界面路径:【智库】----【对账核销】----【应收账单明细】----【账单明细查询】"
请求地址
| 环境 | 服务地址(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.receivable.bill.detail
必填
请求参数
全部展开
参数名
类型
描述
必填
shopId
long
店铺ID
必填
checkStatus
integer
核销状态 1-已核销 0-未核销
billType
integer
账单类型 0-到账 1-出账
checkDateStart
long
核销日期开始时间 毫秒值时间戳
checkDateEnd
long
核销日期结束时间 毫秒值时间戳
billDateStart
long
账单日期开始时间 毫秒值时间戳
billDateEnd
long
账单日期结束时间 毫秒值时间戳
billTimeStart
long
订单日期开始时间 毫秒值时间戳
billTimeEnd
long
订单日期结束时间 毫秒值时间戳
alipayOrderNo
string
账单编号
tid
string
平台订单号
checkWay
integer
核销方式 0-系统核销 1-人工核销 2-强制核销
consignStatus
integer
订单是否发货 0-未发货 1-已发货
diffFeeStart
BigDecimal
差额开始
diffFeeEnd
BigDecimal
差额结束
incomeStatus
integer
是否关联订单 1-关联 0-未关联
pageNo
integer
页码 取值范围:大于零的整数。默认值为1
必填
pageSize
integer
每页条数 取值范围:大于零的整数;最大值:500;默认值:20
必填
响应参数
全部展开
参数名
类型
描述
必填
list
array
列表
必填
alipayOrderNo
string
账单编号
billDate
long
账单日期 毫秒时间戳
billDateStr
string
账单日期文本
tid
string
平台订单号
shopUniId
string
店铺唯一ID
shopName
string
店铺名称
billType
integer
账单类型
billTypeStr
string
账单类型文本
accountId
string
账单项目ID
accountIdStr
string
账户项目文本
billAmount
double
账单金额
diffFee
double
差额
consignStatus
integer
订单发货状态
consignStatusStr
string
订单发货状态文本
status
string
订单平台状态
checkStatus
integer
核销状态
checkStatusStr
string
核销状态文本
checkDate
long
核销日期 毫秒时间戳
checkDateStr
string
核销日期文本
checkId
string
核销单号
checkWay
integer
核销方式
checkWayStr
string
核销方式文本
checkUser
string
核销账号
remark
string
备注
success
boolean
是否成功
必填
traceId
string
请求跟踪ID
必填
total
long
总数
必填
pageNo
integer
页码
必填
pageSize
integer
每页条数
必填
summary
object
汇总信息
unRelationNum
integer
未关联账单/订单数
numTotal
integer
账单/订单数
writtenOffNum
integer
已核销账单/订单数
unWrittenOffNum
integer
未核销账单/订单数
relationNum
integer
关联账单/订单数
响应示例
{
"summary" : {
"unRelationNum" : 98,
"numTotal" : 98,
"writtenOffNum" : 1,
"unWrittenOffNum" : 97,
"relationNum" : 0
},
"traceId" : "5104086129328951560",
"pageSize" : 20,
"list" : [ {
"pt" : 38,
"pageSize" : 20,
"pid" : "10438_10438_900029341_T200P4771289810610505529_4771289810610505529_1470715162225732591_0_2025-09-30 21:25:33_160763.97",
"tid" : "4771289810610505529",
"checkDateStr" : "2025-10-23 11:17:40",
"pageNo" : 1,
"alipayOrderNo" : "1470715162225732591",
"diffFee" : 0.00,
"billDate" : 1759238733000,
"consignStatus" : 0,
"accountId" : "交易付款",
"checkUser" : "超级管理员",
"accountIdStr" : "交易付款",
"shopName" : "斑斑测试",
"remark" : "元力萃胀气贴婴儿新生儿防肠胀气贴小儿宝宝肚脐排气贴",
"billAmount" : 242.00,
"checkStatus" : 2,
"billDateStr" : "2025-09-30 21:25:33",
"checkWay" : 2,
"shopUniId" : "10438_900029341",
"billType" : 0,
"incomeStatus" : 0,
"checkDate" : 1761189460627,
"userId" : 10438,
"checkWayStr" : "强制核销",
"checkStatusStr" : "已核销",
"billTypeStr" : "到账",
"checkId" : "20251023-4771289810610505529"
}, {
"pt" : 38,
"pageSize" : 20,
"pid" : "10438_10438_900029341_T200P4770121537219545744_4770121537219545744_1470690882889409931_0_2025-09-30 09:50:45_159470.2",
"tid" : "4770121537219545744",
"checkDateStr" : "-",
"pageNo" : 1,
"alipayOrderNo" : "1470690882889409931",
"diffFee" : 0.00,
"billDate" : 1759197045000,
"consignStatus" : 0,
"accountId" : "交易付款",
"accountIdStr" : "交易付款",
"shopName" : "斑斑测试",
"remark" : "元力萃胀气贴婴儿新生儿防肠胀气贴小儿宝宝肚脐排气贴",
"billAmount" : 187.00,
"checkStatus" : 0,
"billDateStr" : "2025-09-30 09:50:45",
"checkWay" : -1,
"shopUniId" : "10438_900029341",
"billType" : 0,
"incomeStatus" : 0,
"userId" : 10438,
"checkStatusStr" : "未核销",
"billTypeStr" : "到账",
"checkId" : "-"
}],
"total" : 98,
"pageNo" : 1,
"success" : true
}