标准资金账单查询

系统相关界面

"界面路径：【业务数据】/【标准资金账单】"

请求地址

环境	服务地址(HTTP/HTTPS)
V2正式环境（推荐）	https://gw.superboss.cc/router
V2测试环境	https://gw3.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

kmerp.account.standard.fund.bill.flow.query

必填

请求参数

全部展开

参数名

类型

描述

必填

默认值

shopCode

string

店铺编码

timeType

string

时间类型：OCCURRENCE_TIME-发生时间，CREATE_TIME-创建时间，UPDATE_TIME-更新时间，RECONCILIATION_DATE-对账日期

必填

timeStart

string

查询开始时间，格式：yyyy-MM-dd HH:mm:ss

必填

timeEnd

string

查询结束时间，格式：yyyy-MM-dd HH:mm:ss；不能早于 timeStart

必填

pageNo

int

页码，从1开始

pageSize

int

每页条数，取值范围：1-500

请求示例

{
  "shopCode": "133477",
  "timeType": "OCCURRENCE_TIME",
  "timeStart": "2025-06-01 00:00:00",
  "timeEnd": "2025-06-30 23:59:59",
  "pageNo": 1,
  "pageSize": 20
}

响应参数

全部展开

参数名

类型

描述

必填

success

boolean

示例：true

traceId

string

链路追踪ID

total

long

符合查询条件的总条数

pageNo

int

当前页码

pageSize

int

当前分页大小

list

array

当前页资金流水明细列表

long

资金流水主键ID

platformCode

string

平台编码

platformName

string

平台名称

shopId

long

店铺ID

shopShortTitle

string

店铺简称

shopTitle

string

店铺名称

shopCode

string

店铺编码

externalShopCode

string

对账店铺编码

accountType

int

账户类型

accountTypeName

string

账户类别

accountId

long

账户ID

accountName

string

资金账户

occurredAt

long

发生时间，时间戳毫秒值

ruleId

long

数据清洗规则ID

categoryCode

string

收支分类编码

categoryCodeName

string

分类

statCategoryGroupName

string

统计分类

statCategoryName

string

统计类别

statSubCategoryName

string

统计子类别

categoryId

long

分类ID

categoryName

string

类别

subCategoryId

long

子类别ID

subCategoryName

string

子类别

amount

number

金额

beWrittenOffAmount

number

待核销单据金额

fullLinkWriteOffStatus

int

全链路核销状态：0-未核销，1-已核销

incomeExpenseDirection

int

收支方向：1-收入，2-支出

incomeExpenseDirectionName

string

收支方向

billNo

string

关联账务流水号

orderNo

string

平台订单号

platformSubOrderNo

string

平台子订单号

relatedOrderNo

string

关联订单号

docNo

string

关联业务单据

isDocNoName

string

是否关联业务单据

isFinanceDocumentNoName

string

是否关联财务单据

financeDocumentNo

string

关联财务单据

remark

string

账单备注

belongId

long

归属记录ID

isOffset

int

是否抵消

isOffsetName

string

是否可抵消

isSplit

int

是否拆分

isSplitName

string

是否手动拆分

confirmed

int

是否确认

confirmedName

string

是否确认

source

int

数据来源

sourceName

string

来源方式

incomeExpenseObjectId

long

收支对象编码

incomeExpenseObjectName

string

收支对象

ascriptionCompanyCode

string

内部组织编码

ascriptionCompanyName

string

内部组织

platformProductId

string

平台商品ID

platformSkuId

string

平台SKUID

platformProductCode

string

平台商品编码

platformSkuCode

string

平台SKU编码

platformProductName

string

平台商品名称

reconciliationDate

long

对账日期，时间戳毫秒值

dataProcessStatus

string

数据处理状态

dataProcessRemark

string

数据处理备注

dataStatus

int

数据状态：0-已废弃，1-正常

dataStatusName

string

数据状态

dataId

string

资金数据ID

creator

string

创建人

dataRange

int

账期，例如：20250601

originalAccount

string

原始资金账户

productId

string

商品ID

productName

string

商品名称

statSubCategoryId

long

统计子分类ID

batchNo

string

批次号

bizKey

string

业务唯一键

reconRecordNo

long

差异记录单号

businessModified

long

业务修改时间，时间戳毫秒值

reconciliationCycleYear

int

对账周期年份

reconciliationCycleMonth

int

对账周期月份

reconciliationCycleDay

int

对账周期日期

adjustmentDataId

long

调账关联数据ID

taxVerifyStatus

int

涉税核验状态：0-未执行涉税任务，1-核验不一致，2-核验一致，3-涉税账单未出

taxVerifyStatusName

string

涉税核验状态

taxQuarter

string

涉税季度，例如：2026Q2

created

long

创建时间，时间戳毫秒值

modified

long

数据更新时间，时间戳毫秒值

companyId

long

公司ID

canSplit

boolean

是否允许拆分

canModifyCategory

boolean

是否允许修改分类

响应示例

{
  "traceId": "4759439536627124977",
  "list": [
    {
      "id": 100001,
      "platformCode": "DY",
      "platformName": "抖音",
      "shopId": 133477,
      "shopShortTitle": "测试店铺",
      "shopTitle": "测试店铺旗舰店",
      "shopCode": "133477",
      "externalShopCode": "shop_001",
      "accountType": 1,
      "accountTypeName": "货款账户",
      "accountId": 200001,
      "accountName": "抖音货款账户",
      "occurredAt": 1751269510000,
      "ruleId": 600001,
      "categoryCode": "SR",
      "categoryCodeName": "收入",
      "statCategoryGroupName": "货款",
      "statCategoryName": "销售收入",
      "statSubCategoryName": "订单收入",
      "categoryId": 300001,
      "categoryName": "收入",
      "subCategoryId": 300101,
      "subCategoryName": "订单收入",
      "amount": 128.50,
      "beWrittenOffAmount": 28.50,
      "fullLinkWriteOffStatus": 0,
      "incomeExpenseDirection": 1,
      "incomeExpenseDirectionName": "收入",
      "billNo": "FB202506010001",
      "orderNo": "P202506010001",
      "platformSubOrderNo": "P202506010001-1",
      "relatedOrderNo": "R202506010001",
      "docNo": "DOC202506010001",
      "isDocNoName": "已关联",
      "isFinanceDocumentNoName": "未关联",
      "financeDocumentNo": "",
      "remark": "平台结算入账",
      "belongId": 400001,
      "isOffset": 0,
      "isOffsetName": "否",
      "isSplit": 0,
      "isSplitName": "否",
      "confirmed": 1,
      "confirmedName": "已确认",
      "source": 1,
      "sourceName": "账单",
      "incomeExpenseObjectId": 500001,
      "incomeExpenseObjectName": "平台",
      "ascriptionCompanyCode": "COMPANY001",
      "ascriptionCompanyName": "示例公司",
      "platformProductId": "PRODUCT_10001",
      "platformSkuId": "SKU_10001",
      "platformProductCode": "PRODUCT_CODE_10001",
      "platformSkuCode": "SKU_CODE_10001",
      "platformProductName": "示例商品",
      "reconciliationDate": 1751212800000,
      "dataProcessStatus": "SUCCESS",
      "dataProcessRemark": "",
      "dataStatus": 1,
      "dataStatusName": "正常",
      "dataId": "FUND_DATA_202506010001",
      "creator": "system",
      "dataRange": 20250601,
      "originalAccount": "抖音货款账户",
      "productId": "10001",
      "productName": "示例商品",
      "statSubCategoryId": 310101,
      "batchNo": "BATCH20250601",
      "bizKey": "DY_133477_FB202506010001",
      "reconRecordNo": 700001,
      "businessModified": 1751269510000,
      "reconciliationCycleYear": 2025,
      "reconciliationCycleMonth": 6,
      "reconciliationCycleDay": 30,
      "adjustmentDataId": 800001,
      "taxVerifyStatus": 2,
      "taxVerifyStatusName": "涉税核验一致",
      "taxQuarter": "2025Q2",
      "created": 1751269510000,
      "modified": 1751269510000,
      "companyId": 900001,
      "canSplit": true,
      "canModifyCategory": true
    }
  ],
  "total": 1,
  "pageNo": 1,
  "pageSize": 20,
  "success": true
}

异常示例

{
  "traceId": "4071991477422416710",
  "msg": "每页条数必须在1到500之间",
  "code": "50",
  "success": false
}

错误码解释

错误信息	错误码	解决方案
请求参数不能为空	400	检查请求体是否为空
公司ID不能为空	403	检查 session 是否有效，确认 access_token 是否属于有效授权公司
页码必须大于0	50	传入 pageNo 时必须从 1 开始
每页条数必须在1到500之间	50	传入 pageSize 时必须在 1 到 500 之间
时间类型不能为空	50	传入 timeType
时间类型不合法	50	timeType 必须为 OCCURRENCE_TIME、CREATE_TIME、UPDATE_TIME 或 RECONCILIATION_DATE，并注意大小写
查询开始时间不能为空 / 查询结束时间不能为空	50	同时传入 timeStart 和 timeEnd
查询开始时间格式必须为yyyy-MM-dd HH:mm:ss / 查询结束时间格式必须为yyyy-MM-dd HH:mm:ss	50	检查 timeStart 和 timeEnd 的格式
查询开始时间不能晚于查询结束时间	50	检查 timeStart 和 timeEnd 的先后顺序
店铺不存在	400	检查 shopCode 或 externalShopCode 是否属于当前授权公司
标准资金流水查询失败	500	联系管理员或根据 traceId 排查

系统相关界面​

请求地址​

公共参数​

请求头​

API接口地址​

请求参数​

请求示例​

响应参数​

响应示例​

异常示例​

错误码解释​

系统相关界面

请求地址

公共参数

请求头

API接口地址

请求参数

请求示例

响应参数

响应示例

异常示例

错误码解释