平台标准资金资金流水查询

系统相关界面

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

请求地址

环境	服务地址(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

long

内部店铺编码；传入后按该店铺查询

externalShopCode

string

外部店铺编码；未传 shopCode 时可按该字段解析店铺

startTime

string

流水发生开始时间，格式示例：2025-06-01 00:00:00

endTime

string

流水发生结束时间，格式示例：2025-06-30 23:59:59

reconciliationStartDate

string

对账开始日期，格式示例：2025-06-01 00:00:00

reconciliationEndDate

string

对账结束日期，格式示例：2025-06-30 23:59:59

platformTypeList

array

平台类型编码列表

accountTypeList

array

账户类型列表

accountIdList

array

账户ID列表

classifyCodeList

array

收支分类编码列表

subCategoryIdList

array

收支子分类ID列表

statClassifyCodeList

array

统计口径分类编码列表

statSubCategoryIdList

array

统计口径子分类ID列表

incomeExpenseDirection

int

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

billNoList

array

资金流水单号列表

orderNoList

array

订单号列表

relatedOrderNoList

array

关联订单号列表

docNo

string

单据编号

docNoList

array

单据编号列表

financeDocNoList

array

财务凭证号列表

dataId

string

单条流水数据ID

fundDataIdList

array

资金流水数据ID列表

remark

string

备注关键字

manualSplit

int

是否人工拆分：0-否，1-是

isOffset

int

是否抵消：0-否，1-是

confirmed

int

是否确认：0-待确认，1-已确认

isRelatedDoc

int

是否关联业务单据：0-否，1-是

isRelatedFinanceDoc

int

是否关联财务凭证：0-否，1-是

source

int

数据来源：0-系统，1-账单

incomeExpenseObjectIdList

array

收支对象ID列表

affiliatedCompanyName

string

归属公司名称

affiliatedCompanyCodeList

array

归属公司编码列表

platformOrderNoList

array

平台订单号列表

dataProcessStatus

string

数据处理状态

pageNo

int

页码，从1开始

必填

pageSize

int

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

必填

请求示例

示例一：按店铺和流水发生时间查询第一页资金流水

{
  "externalShopCode": "shop_001",
  "startTime": "2025-06-01 00:00:00",
  "endTime": "2025-06-30 23:59:59",
  "pageNo": 1,
  "pageSize": 20
}

示例二：按资金流水单号查询

{
  "billNoList": ["FB202506010001", "FB202506010002"],
  "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

流水发生时间，时间戳毫秒值

categoryCode

string

收支分类编码

categoryCodeName

string

收支分类编码名称

statCategoryGroupName

string

统计分类分组名称

statCategoryName

string

统计分类名称

statSubCategoryName

string

统计子分类名称

categoryId

long

收支分类ID

categoryName

string

收支分类名称

subCategoryId

long

收支子分类ID

subCategoryName

string

收支子分类名称

amount

number

流水金额

incomeExpenseDirection

int

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

incomeExpenseDirectionName

string

收支方向名称

billNo

string

资金流水单号

orderNo

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

收支对象ID

incomeExpenseObjectName

string

收支对象名称

ascriptionCompanyCode

string

归属公司编码

ascriptionCompanyName

string

归属公司名称

reconciliationDate

long

对账日期，时间戳毫秒值

dataProcessStatus

string

数据处理状态

dataProcessRemark

string

数据处理备注

dataId

string

资金流水数据ID

creator

string

创建人

batchNo

string

批次号

bizKey

string

业务唯一键

created

long

创建时间，时间戳毫秒值

modified

long

修改时间，时间戳毫秒值

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,
      "categoryCode": "SR",
      "categoryCodeName": "收入",
      "statCategoryGroupName": "货款",
      "statCategoryName": "销售收入",
      "statSubCategoryName": "订单收入",
      "categoryId": 300001,
      "categoryName": "收入",
      "subCategoryId": 300101,
      "subCategoryName": "订单收入",
      "amount": 128.50,
      "incomeExpenseDirection": 1,
      "incomeExpenseDirectionName": "收入",
      "billNo": "FB202506010001",
      "orderNo": "P202506010001",
      "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": "示例公司",
      "reconciliationDate": 1751212800000,
      "dataProcessStatus": "SUCCESS",
      "dataProcessRemark": "",
      "dataId": "FUND_DATA_202506010001",
      "creator": "system",
      "batchNo": "BATCH20250601",
      "bizKey": "DY_133477_FB202506010001",
      "created": 1751269510000,
      "modified": 1751269510000,
      "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	检查 startTime 和 endTime 的先后顺序
对账开始日期不能晚于对账结束日期	50	检查 reconciliationStartDate 和 reconciliationEndDate 的先后顺序
店铺不存在	500	检查 shopCode 或 externalShopCode 是否属于当前授权公司
标准资金流水查询失败	500	联系管理员或根据 traceId 排查

系统相关界面​

请求地址​

公共参数​

请求头​

API接口地址​

请求参数​

请求示例​

响应参数​

响应示例​

异常示例​

错误码解释​

系统相关界面

请求地址

公共参数

请求头

API接口地址

请求参数

请求示例

响应参数

响应示例

异常示例

错误码解释