对账核销应收订单
系统相关界面
"界面路径:【智库】----【对账核销】----【应收订单明细】----【全部应收订单】"
请求地址
| 环境 | 服务地址(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.detail
必填
请求参数
全部展开
参数名
类型
描述
必填
shopId
long
店铺ID
必填
checkStatus
integer
核销状态 1-已核销 0-未核销
incomeTypes
string
应收类型 0-付款 1-发货后退款, 7-发货前退款, 99-应收调整 分隔符为逗号
checkDateStart
long
核销日期开始时间 毫秒值时间戳
checkDateEnd
long
核销日期结束时间 毫秒值时间戳
billTimeStart
long
单据日期开始时间 毫秒值时间戳
billTimeEnd
long
单据日期结束时间 毫秒值时间戳
billDateStart
long
账单日期开始时间 毫秒值时间戳
billDateEnd
long
账单日期结束时间 毫秒值时间戳
tid
string
平台订单号
sid
string
系统订单号
amountDiffStart
BigDecimal
差额开始
amountDiffEnd
BigDecimal
差额结束
checkWay
integer
核销方式 0-系统核销 1-人工核销 2-强制核销
billStatus
integer
有无应收账单 1 有 0 无
authorIds
string
达人id
sysStatus
string
订单系统状态 WAIT_BUYER_PAY-待付款,WAIT_AUDIT-待审核,WAIT_FINANCE_AUDIT-待财审,WAIT_EXPRESS_PRINT-待打印快递单,WAIT_PACKAGE-待包装,WAIT_WEIGHT-待称重,WAIT_SEND_GOODS-待发货,WAIT_DEST_SEND_GOODS-待供销商发货,SELLER_SEND_GOODS-卖家已发货,FINISHED-交易成功,CANCEL-交易作废,CLOSED-交易关闭,2-未解决,12-解决中,9-已解决,10-已作废,11-已合并 分隔符为逗号
status
string
订单平台状态 WAIT_BUYER_PAY-待付款,WAIT_SEND_GOODS-待发货,SELLER_CONSIGNED_PART-部分发货,SELLER_SEND_GOODS-已发货,FINISHED-交易成功,CLOSED-交易关闭 分隔符为逗号
remark
string
核销备注
pageNo
integer
页码 取值范围:大于零的整数。默认值为1
必填
pageSize
integer
每页条数 取值范围:大于零的整数;最大值:500;默认值:20
必填
响应参数
全部展开
参数名
类型
描述
必填
list
array
列表
必填
sid
string
系统订单号
billTimeStr
string
单据日期文本
billTime
long
单据日期 毫秒时间戳
payTimeStr
string
支付日期文本
payTime
long
支付日期 毫秒时间戳
tid
string
平台订单号
shopName
string
店铺名称
orderType
string
订单类型
orderTypeStr
string
订单类型文本
incomeType
integer
应收类型
incomeTypeStr
string
应收类型文本 应收调整/付款等
incomeTypeOri
integer
调用关联明细需要用到-billType
incomeAmount
double
应收金额
diffFee
double
差额费用
billStatus
integer
账单状态 0-无账单 1-有账单
billStatusStr
string
账单状态文本 无账单/有账单
orderStatus
string
订单系统状态
sysOrderTag
string
系统订单标签
authorId
string
达人id
authorName
string
达人名称
remark
string
核销备注
checkStatus
integer
核销状态
checkStatusStr
string
核销状态文本 已核销/未核销
checkDate
long
核 销日期 毫秒时间戳
checkDateStr
string
核销日期文本
checkId
string
核销单号
checkWay
integer
核销方式 0-系统核销 1-人工核销
checkWayStr
string
核销方式文本 系统核销/人工核销
checkUser
string
核销账号
updTime
long
更新时间 毫秒时间戳
modified
long
修改时间 毫秒时间戳
created
long
创建时间 毫秒时间戳
shopName
string
店铺名称
shopUniId
string
店铺唯一ID
userId
long
用户ID
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" : 6,
"numTotal" : 6,
"writtenOffNum" : 6,
"unWrittenOffNum" : 0,
"relationNum" : 0
},
"traceId" : "5094981541538806195",
"pageSize" : 20,
"list" : [{
"orderType" : "fixed",
"pt" : 38,
"payTime" : 1758771614000,
"pageSize" : 20,
"pid" : "10438_10438_900029341_0_5518025558584363_689755435604480",
"tid" : "689755435604480",
"billStatusStr" : "无账单",
"checkDateStr" : "2025-10-23 11:04:16",
"pageNo" : 1,
"updTime" : 1761188656553,
"modified" : 1758771614000,
"incomeTypeStr" : "付款",
"incomeChange" : 0,
"incomeType" : 0,
"created" : 1758771614000,
"diffFee" : 0.00,
"wTid" : "689755435604480",
"checkUser" : "超级管理员",
"payTimeStr" : "2025-09-25 11:40:14",
"status" : "已发货",
"sysOrderTag" : "商品搭配替换成功,需要开票,快销订单,缺货发货,修改商品",
"orderStatus" : "卖家已发货",
"shopName" : "斑斑测试",
"sid" : "5518025558584363",
"checkStatus" : 1,
"sysStatus" : "卖家已发货",
"incomeTypeOri" : 0,
"billStatus" : 0,
"orderTypeStr" : "平台",
"checkWay" : 1,
"shopUniId" : "10438_900029341",
"incomeAmount" : 100.00,
"billTimeStr" : "2025-09-29 22:11:57",
"checkDate" : 1761188656553,
"userId" : 10438,
"checkWayStr" : "人工核销",
"checkStatusStr" : "已核销",
"billTime" : 1759155117000,
"endTime" : 946656000000,
"checkId" : "20251023-689755435604480"
}],
"total" : 6,
"pageNo" : 1,
"success" : true
}