结算 settlement

模块 settlement：共 39 个接口 —— 25 个被前端调用（在用），14 个未被调用（含 0 个开放/回调/内部）。用下方筛选可只看“在用/未使用”，或在右栏目录按名称过滤。

SettlementCardCheckDetailController 1/2 在用

ANY /settlement/exportSettlementCardCheckDetailPage 未使用管理后台 #

导出结算刷卡明细 · SettlementCardCheckDetailController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardCheckDetailController#exportSettlementCardCheckDetailPage
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	ANY

调用链路 & 涉及数据表

涉及数据表settlement_card_check_detail

ControllerSettlementCardCheckDetailController#exportSettlementCardCheckDetailPage

转换BeanUtils.map → SettlementCardCheckDetailQuery

ServiceEstimationCardCheckDetailService#queryList （SettlementCardCheckDetailServiceImpl）

MapperSettlementCardCheckDetailMapper#selectList ⇒ 表 settlement_card_check_detail

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/exportSettlementCardCheckDetailPage
uat	https://dscp-uat.hn12301.net/manage-api/settlement/exportSettlementCardCheckDetailPage
pro	https://dscp-uat.hn12301.net/manage-api/settlement/exportSettlementCardCheckDetailPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HttpServletResponse

请求体类型：HttpServletResponse（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

ANY /settlement/exportSettlementCardCheckDetailPage

响应示例

（void，无响应体）

处理逻辑

逻辑摘要列表查询（settlementCardCheckDetailService.queryList）；调用 write（ExcelUtils.write）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件
组装导出数据
序号

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /settlement/querySettlementCardCheckDetailPage 在用管理后台 #

旅游卡结算刷卡明细-分页查询 · SettlementCardCheckDetailController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardCheckDetailController#querySettlementCardCheckDetailPage
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_check_detail

ControllerSettlementCardCheckDetailController#querySettlementCardCheckDetailPage

转换BeanUtils.map → SettlementCardCheckDetailQuery

ServiceEstimationCardCheckDetailService#queryPage （SettlementCardCheckDetailServiceImpl）

MapperSettlementCardCheckDetailMapper#selectPage ⇒ 表 settlement_card_check_detail

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/querySettlementCardCheckDetailPage
uat	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardCheckDetailPage
pro	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardCheckDetailPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardCheckDetailPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
settlementDetailId	Long	是	必填	`settlement_card_check_detail`.`settlement_detail_id`	结算明细id
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<SettlementCardCheckDetailResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
cardModelName	String	—	所属卡种
sceneryName	String	`settlement_card_check_detail`.`scenery_name`	景区名称
touristName	String	`settlement_card_check_detail`.`tourist_name`	持卡人姓名
touristPhone	String	`settlement_card_check_detail`.`tourist_phone`	持卡人手机
cardNumber	String	`settlement_card_check_detail`.`card_number`	旅游卡卡号
checkTime	Date	`settlement_card_check_detail`.`check_time`	刷卡时间
checkerId	Long	`settlement_card_check_detail`.`checker_id`	核销人id
checkerName	String	—	核销人

示例

请求示例（自动生成，仅结构参考）

POST /settlement/querySettlementCardCheckDetailPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "settlementDetailId": 1,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "cardModelName": "",
        "sceneryName": "",
        "touristName": "",
        "touristPhone": "13800000000",
        "cardNumber": "",
        "checkTime": "2026-01-01 12:00:00",
        "checkerId": 1,
        "checkerName": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（settlementCardCheckDetailService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage querySettlementCardCheckDetailPage exact

SettlementCardController 13/16 在用

POST /settlement/afreshSettlementCard 未使用管理后台 #

旅游卡结算单-重新结算 · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#afreshSettlementCard
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detailsettlement_card_check_detailsettlement_cardcard_resource_rule

ControllerSettlementCardController#afreshSettlementCard

转换BeanUtils.map → SettlementCardDetail ⇒ 表 settlement_card_detail

转换BeanUtils.map → SettlementCardCheckDetail ⇒ 表 settlement_card_check_detail

ServiceSettlementCardService#get （SettlementCardServiceImpl）

MapperSettlementCardMapper#selectById ⇒ 表 settlement_card

ServiceCardResourceRuleService#queryList （CardResourceRuleServiceImpl）

MapperCardResourceRuleMapper#selectList ⇒ 表 card_resource_rule

ServiceSettlementCardDetailService#get （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#selectById ⇒ 表 settlement_card_detail

ServiceSettlementCardService#update （SettlementCardServiceImpl）

MapperSettlementCardMapper#updateById ⇒ 表 settlement_card

ServiceSettlementCardDetailService#update （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#updateById ⇒ 表 settlement_card_detail

ServiceEstimationCardCheckDetailService#delete （SettlementCardCheckDetailServiceImpl）

MapperSettlementCardCheckDetailMapper#deleteById ⇒ 表 settlement_card_check_detail

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 5

ChaosTransactionTemplate.executeSettlementHandlerCache.getCardModelCache.getSessionUserService.getSessionIdEstimationCardCheckDetailService.addList

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/afreshSettlementCard
uat	https://dscp-uat.hn12301.net/manage-api/settlement/afreshSettlementCard
pro	https://dscp-uat.hn12301.net/manage-api/settlement/afreshSettlementCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardAfreshRequest

字段	类型	必填	取值/校验	表 / 列	说明
settlementId	Long	是	必填	`settlement_card_detail`.`settlement_id`	结算单id
settlementDetailId	Long	是	必填	`settlement_card_check_detail`.`settlement_detail_id`	结算明细id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/afreshSettlementCard

{
  "body": {
    "settlementId": 1,
    "settlementDetailId": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志settlement / 重新结算

逻辑摘要调用 execute（newTransactionTemplate.execute）；查询详情（settlementCardService.get）；调用 beginOfMonth（DateUtil.beginOfMonth）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

重新结算
查询出结算单
查询卡种资源结算规则
查询结算明细
计算各资源结算明细
修改结算单
.createdBy(sessionService.getSessionId())
修改结算明细和刷卡明细

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /settlement/calcSettlementCard 在用管理后台 #

旅游卡结算单-计算数据 · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#calcSettlementCard
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card

ControllerSettlementCardController#calcSettlementCard

ServiceSettlementCardService#update （SettlementCardServiceImpl）

MapperSettlementCardMapper#updateById ⇒ 表 settlement_card

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

SettlementCardService.mustGet

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/calcSettlementCard
uat	https://dscp-uat.hn12301.net/manage-api/settlement/calcSettlementCard
pro	https://dscp-uat.hn12301.net/manage-api/settlement/calcSettlementCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`settlement_card`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/calcSettlementCard

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志settlement / 计算结算单

逻辑摘要调用 mustGet（settlementCardService.mustGet）；更新（settlementCardService.update）

内联注释

查询结算单
校验结算单状态
修改结算单状态
处理异常

前端调用方

dscp-html-manage calcSettlementCard exact

POST /settlement/deleteSettlementCard 在用管理后台 #

旅游卡结算单-删除 · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#deleteCarriage
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detailsettlement_cardsettlement_card_check_detailsettlement_card_detail_paymentsettlement_card_log

ControllerSettlementCardController#deleteCarriage

MapperSettlementCardDetailService.getMapper#selectList ⇒ 表 settlement_card_detail

ServiceSettlementCardService#delete （SettlementCardServiceImpl）

MapperSettlementCardMapper#deleteById ⇒ 表 settlement_card

ServiceSettlementCardDetailService#delete （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#deleteById ⇒ 表 settlement_card_detail

ServiceEstimationCardCheckDetailService#delete （SettlementCardCheckDetailServiceImpl）

MapperSettlementCardCheckDetailMapper#deleteById ⇒ 表 settlement_card_check_detail

ServiceSettlementCardDetailPaymentService#delete （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#deleteById ⇒ 表 settlement_card_detail_payment

ServiceSettlementCardLogService#add （SettlementCardLogServiceImpl）

MapperSettlementCardLogMapper#insert ⇒ 表 settlement_card_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

SessionUserService.getSessionUserSessionUserService.getSessionId

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/deleteSettlementCard
uat	https://dscp-uat.hn12301.net/manage-api/settlement/deleteSettlementCard
pro	https://dscp-uat.hn12301.net/manage-api/settlement/deleteSettlementCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`settlement_card_detail`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/deleteSettlementCard

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志settlement / 删除结算单

逻辑摘要删除（settlementCardService.delete）；删除（settlementCardDetailService.delete）；查询详情（settlementCardDetailService.getMapper）

前端调用方

dscp-html-manage deleteSettlementCard exact

POST /settlement/getInvoiceSettlementCard 在用管理后台 #

旅游卡结算单-详情(开票方) · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#getInvoiceSettlementCard
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表merchant_financesettlement_cardsettlement_card_detail_payment

ControllerSettlementCardController#getInvoiceSettlementCard

MapperMerchantFinanceService.getMapper#selectOne ⇒ 表 merchant_finance

ServiceSettlementCardService#get （SettlementCardServiceImpl）

MapperSettlementCardMapper#selectById ⇒ 表 settlement_card

ServiceSettlementCardDetailPaymentService#get （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#selectById ⇒ 表 settlement_card_detail_payment

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

SessionUserService.getSessionUserMerchantCache.get

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/getInvoiceSettlementCard
uat	https://dscp-uat.hn12301.net/manage-api/settlement/getInvoiceSettlementCard
pro	https://dscp-uat.hn12301.net/manage-api/settlement/getInvoiceSettlementCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`merchant_finance`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　SettlementCardInfoResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`merchant_finance`.`id`	id
cardModelName	String		`settlement_card`.`card_model_name`	卡种名称
settlementPeriod	String		—	结算起止时间
totalAmount	Long		`settlement_card`.`total_amount`	实际结算金额，单位为分
profit	Long		`settlement_card`.`profit`	单张卡分润金额，单位为分
issueNum	Integer		`settlement_card`.`issue_num`	卡种发行量
checkNum	Long		`settlement_card`.`check_num`	累计刷卡次数
settlementStatus	SettlementStatus	1待景区核对2待平台核算3待平台审核4待开票5待平台打款6已完成9已作废	`settlement_card`.`settlement_status`	结算状态(Enum:SettlementStatus)，1待付款2已付款3作废
settlementFiles	String		`settlement_card`.`settlement_files`	审批单文件列表
settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户名称
merchantFinance	MerchantFinance		`settlement_card_detail_payment`.`merchant_finance`	结算商户网银信息
merchantFinance.id	Long		`merchant_finance`.`id`	主键，财务信息ID
merchantFinance.shopId	Long		`merchant_finance`.`shop_id`	所属商铺id
merchantFinance.merchantId	Long		`merchant_finance`.`merchant_id`	所属商户id
merchantFinance.ebankType	EbankType	11商户结算、2销售结算2销售结算	`merchant_finance`.`ebank_type`	网银类型(merchant.EbankType)，1商户结算、2销售结算
merchantFinance.name	String		`merchant_finance`.`name`	账户名称
merchantFinance.bank	String		`merchant_finance`.`bank`	开户银行
merchantFinance.bankAccount	String		`merchant_finance`.`bank_account`	开户账号
merchantFinance.isDeleted	Boolean		`merchant_finance`.`is_deleted`	是否删除
merchantFinance.createdBy	String		`merchant_finance`.`created_by`	创建人id
merchantFinance.createdTime	Date		`merchant_finance`.`created_time`	创建时间
merchantFinance.updatedBy	String		`merchant_finance`.`updated_by`	更新人id
merchantFinance.updatedTime	Date		`merchant_finance`.`updated_time`	修改时间
statisticData	Map<String, Object>		—	统计数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/getInvoiceSettlementCard

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "cardModelName": "",
    "settlementPeriod": "",
    "totalAmount": 0,
    "profit": 0,
    "issueNum": 0,
    "checkNum": 0,
    "settlementStatus": "1",
    "settlementFiles": "",
    "settlementMerchantName": "",
    "merchantFinance": {
      "id": 1,
      "shopId": 1,
      "merchantId": 1,
      "ebankType": "1",
      "name": "",
      "bank": "",
      "bankAccount": "",
      "isDeleted": false,
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00"
    },
    "statisticData": ""
  }
}

处理逻辑

逻辑摘要查询详情（settlementCardService.get）；查询详情（sessionService.getSessionUser）；查询详情（merchantFinanceService.getMapper）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

查询结算商户信息
根据状态做不同的查询银行信息
如果是待开票

前端调用方

dscp-html-manage getInvoiceSettlementCard exact

POST /settlement/getSettlementCard 在用管理后台 #

旅游卡结算单-详情 · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#getSettlementCard
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card

ControllerSettlementCardController#getSettlementCard

ServiceSettlementCardService#get （SettlementCardServiceImpl）

MapperSettlementCardMapper#selectById ⇒ 表 settlement_card

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/getSettlementCard
uat	https://dscp-uat.hn12301.net/manage-api/settlement/getSettlementCard
pro	https://dscp-uat.hn12301.net/manage-api/settlement/getSettlementCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`settlement_card`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　SettlementCardInfoResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`settlement_card`.`id`	id
cardModelName	String		`settlement_card`.`card_model_name`	卡种名称
settlementPeriod	String		—	结算起止时间
totalAmount	Long		`settlement_card`.`total_amount`	实际结算金额，单位为分
profit	Long		`settlement_card`.`profit`	单张卡分润金额，单位为分
issueNum	Integer		`settlement_card`.`issue_num`	卡种发行量
checkNum	Long		`settlement_card`.`check_num`	累计刷卡次数
settlementStatus	SettlementStatus	1待景区核对2待平台核算3待平台审核4待开票5待平台打款6已完成9已作废	`settlement_card`.`settlement_status`	结算状态(Enum:SettlementStatus)，1待付款2已付款3作废
settlementFiles	String		`settlement_card`.`settlement_files`	审批单文件列表
settlementMerchantName	String		—	结算商户名称
merchantFinance	MerchantFinance		—	结算商户网银信息
merchantFinance.id	Long		`settlement_card`.`id`	主键，财务信息ID
merchantFinance.shopId	Long		—	所属商铺id
merchantFinance.merchantId	Long		—	所属商户id
merchantFinance.ebankType	EbankType	11商户结算、2销售结算2销售结算	—	网银类型(merchant.EbankType)，1商户结算、2销售结算
merchantFinance.name	String		—	账户名称
merchantFinance.bank	String		—	开户银行
merchantFinance.bankAccount	String		—	开户账号
merchantFinance.isDeleted	Boolean		—	是否删除
merchantFinance.createdBy	String		`settlement_card`.`created_by`	创建人id
merchantFinance.createdTime	Date		`settlement_card`.`created_time`	创建时间
merchantFinance.updatedBy	String		`settlement_card`.`updated_by`	更新人id
merchantFinance.updatedTime	Date		`settlement_card`.`updated_time`	修改时间
statisticData	Map<String, Object>		—	统计数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/getSettlementCard

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "cardModelName": "",
    "settlementPeriod": "",
    "totalAmount": 0,
    "profit": 0,
    "issueNum": 0,
    "checkNum": 0,
    "settlementStatus": "1",
    "settlementFiles": "",
    "settlementMerchantName": "",
    "merchantFinance": {
      "id": 1,
      "shopId": 1,
      "merchantId": 1,
      "ebankType": "1",
      "name": "",
      "bank": "",
      "bankAccount": "",
      "isDeleted": false,
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00"
    },
    "statisticData": ""
  }
}

处理逻辑

逻辑摘要查询详情（settlementCardService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage getSettlementCard exact

POST /settlement/getSettlementCardIssueNum 在用管理后台 #

旅游卡结算单-查询结算周期内卡种发行量 · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#getSettlementCardIssueNum
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card

ControllerSettlementCardController#getSettlementCardIssueNum

MapperCardService.getMapper#count ⇒ 表 card

ServiceCardService#count （CardServiceImpl）

MapperCardMapper#selectCount ⇒ 表 card

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/getSettlementCardIssueNum
uat	https://dscp-uat.hn12301.net/manage-api/settlement/getSettlementCardIssueNum
pro	https://dscp-uat.hn12301.net/manage-api/settlement/getSettlementCardIssueNum	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardIssueNumGetRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModelId	Long	是	必填	`card`.`card_model_id`	卡种id
settlementPeriod	Date[]	是	必填	—	结算起止时间

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　Long　（scalar）

标量/Map/外部类型：Long

示例

请求示例（自动生成，仅结构参考）

POST /settlement/getSettlementCardIssueNum

{
  "body": {
    "cardModelId": 1,
    "settlementPeriod": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": 0
}

处理逻辑

逻辑摘要查询详情（cardService.getMapper）；调用 count（cardService.count）

前端调用方

dscp-html-manage getSettlementCardIssueNum exact

POST /settlement/platformAudit 在用管理后台 #

旅游卡结算单-平台审核 · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#platformAudit
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detailsettlement_cardsettlement_card_log

ControllerSettlementCardController#platformAudit

MapperSettlementCardDetailService.getMapper#selectList ⇒ 表 settlement_card_detail

ServiceSettlementCardService#update （SettlementCardServiceImpl）

MapperSettlementCardMapper#updateById ⇒ 表 settlement_card

ServiceSettlementCardLogService#add （SettlementCardLogServiceImpl）

MapperSettlementCardLogMapper#insert ⇒ 表 settlement_card_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

SessionUserService.isPlatformUserSessionUserService.getSessionUserSessionUserService.getSessionId

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/platformAudit
uat	https://dscp-uat.hn12301.net/manage-api/settlement/platformAudit
pro	https://dscp-uat.hn12301.net/manage-api/settlement/platformAudit	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardAuditRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`settlement_card_detail`.`id`	id
isPass	Boolean	是	必填	—	是否审核通过
settlementFiles	List<String>	否	可选(@MvcOptional)	`settlement_card`.`settlement_files`	审批单文件列表

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/platformAudit

{
  "body": {
    "id": 1,
    "isPass": false,
    "settlementFiles": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志settlement / 平台审核

逻辑摘要调用 isPlatformUser（sessionService.isPlatformUser）；查询详情（settlementCardDetailService.getMapper）；更新（settlementCardService.update）

内联注释

校验权限

前端调用方

dscp-html-manage platformAudit exact

POST /settlement/queryInvoiceSettlementCardPage 在用管理后台 #

旅游卡结算单-分页查询（开票方） · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#queryInvoiceSettlementCardPage
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card

ControllerSettlementCardController#queryInvoiceSettlementCardPage

转换BeanUtils.map → SettlementCardQuery

转换BeanUtils.map → PageParam

MapperSettlementCardService.getMapper#queryPage ⇒ 表 settlement_card

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

SettlementCardService.applyWrapper

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/queryInvoiceSettlementCardPage
uat	https://dscp-uat.hn12301.net/manage-api/settlement/queryInvoiceSettlementCardPage
pro	https://dscp-uat.hn12301.net/manage-api/settlement/queryInvoiceSettlementCardPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
merchantId	Long			—	商户id
shopId	Long			—	商铺id
settlementNo	String	否	可选(@MvcOptional)	`settlement_card`.`settlement_no`	结算单号
cardModelName	String	否	可选(@MvcOptional)	`settlement_card`.`card_model_name`	卡种名称
settlementStatus	SettlementStatus	否	1待景区核对2待平台核算3待平台审核4待开票5待平台打款6已完成9已作废	`settlement_card`.`settlement_status`	结算状态
createdTimeRange	Date[]	否	可选(@MvcOptional)	—	创建时间
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<SettlementCardPageResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`settlement_card`.`id`	id
settlementNo	String		`settlement_card`.`settlement_no`	结算单号
cardModelId	Long		`settlement_card`.`card_model_id`	卡种编号
cardModelName	String		`settlement_card`.`card_model_name`	卡种名称
startTime	Date		`settlement_card`.`start_time`	开始时间
endTime	Date		`settlement_card`.`end_time`	结束时间
sceneryNum	Integer		`settlement_card`.`scenery_num`	结算景区数量
totalAmount	Long		`settlement_card`.`total_amount`	结算总金额，单位为分
settlementStatus	SettlementStatus	1待景区核对2待平台核算3待平台审核4待开票5待平台打款6已完成9已作废	`settlement_card`.`settlement_status`	结算状态(Enum:SettlementStatus)，1待付款2已付款3作废
createdTime	Date		`settlement_card`.`created_time`	创建时间
profit	Long		`settlement_card`.`profit`	分润金额，单位为分
issueNum	Integer		`settlement_card`.`issue_num`	结算周期内卡种发行量
distributeTotalAmount	Long		`settlement_card`.`distribute_total_amount`	可分配总金额，单位为分
isDistributeTotal	Boolean		`settlement_card`.`is_distribute_total`	是否按分配总额
paymentAmountActualTotal	Long		—	实际打款金额，单位为分

示例

请求示例（自动生成，仅结构参考）

POST /settlement/queryInvoiceSettlementCardPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "merchantId": 1,
    "shopId": 1,
    "settlementNo": "",
    "cardModelName": "",
    "settlementStatus": "1",
    "createdTimeRange": "2026-01-01 12:00:00",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "settlementNo": "",
        "cardModelId": 1,
        "cardModelName": "",
        "startTime": "2026-01-01 12:00:00",
        "endTime": "2026-01-01 12:00:00",
        "sceneryNum": 0,
        "totalAmount": 0,
        "settlementStatus": "1",
        "createdTime": "2026-01-01 12:00:00",
        "profit": 0,
        "issueNum": 0,
        "distributeTotalAmount": 0,
        "isDistributeTotal": false,
        "paymentAmountActualTotal": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 applyWrapper（settlementCardService.applyWrapper）；查询详情（settlementCardService.getMapper）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryInvoiceSettlementCardPage exact

POST /settlement/queryPlatformSettlementCardPage 未使用管理后台 #

旅游卡结算单-分页查询（平台用户） · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#queryPlatformSettlementCardPage
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card

ControllerSettlementCardController#queryPlatformSettlementCardPage

转换BeanUtils.map → SettlementCardQuery

ServiceSettlementCardService#queryPage （SettlementCardServiceImpl）

MapperSettlementCardMapper#selectPage ⇒ 表 settlement_card

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/queryPlatformSettlementCardPage
uat	https://dscp-uat.hn12301.net/manage-api/settlement/queryPlatformSettlementCardPage
pro	https://dscp-uat.hn12301.net/manage-api/settlement/queryPlatformSettlementCardPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
merchantId	Long			—	商户id
shopId	Long			—	商铺id
settlementNo	String	否	可选(@MvcOptional)	`settlement_card`.`settlement_no`	结算单号
cardModelName	String	否	可选(@MvcOptional)	`settlement_card`.`card_model_name`	卡种名称
settlementStatus	SettlementStatus	否	1待景区核对2待平台核算3待平台审核4待开票5待平台打款6已完成9已作废	`settlement_card`.`settlement_status`	结算状态
createdTimeRange	Date[]	否	可选(@MvcOptional)	—	创建时间
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<SettlementCardPageResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`settlement_card`.`id`	id
settlementNo	String		`settlement_card`.`settlement_no`	结算单号
cardModelId	Long		`settlement_card`.`card_model_id`	卡种编号
cardModelName	String		`settlement_card`.`card_model_name`	卡种名称
startTime	Date		`settlement_card`.`start_time`	开始时间
endTime	Date		`settlement_card`.`end_time`	结束时间
sceneryNum	Integer		`settlement_card`.`scenery_num`	结算景区数量
totalAmount	Long		`settlement_card`.`total_amount`	结算总金额，单位为分
settlementStatus	SettlementStatus	1待景区核对2待平台核算3待平台审核4待开票5待平台打款6已完成9已作废	`settlement_card`.`settlement_status`	结算状态(Enum:SettlementStatus)，1待付款2已付款3作废
createdTime	Date		`settlement_card`.`created_time`	创建时间
profit	Long		`settlement_card`.`profit`	分润金额，单位为分
issueNum	Integer		`settlement_card`.`issue_num`	结算周期内卡种发行量
distributeTotalAmount	Long		`settlement_card`.`distribute_total_amount`	可分配总金额，单位为分
isDistributeTotal	Boolean		`settlement_card`.`is_distribute_total`	是否按分配总额
paymentAmountActualTotal	Long		—	实际打款金额，单位为分

示例

请求示例（自动生成，仅结构参考）

POST /settlement/queryPlatformSettlementCardPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "merchantId": 1,
    "shopId": 1,
    "settlementNo": "",
    "cardModelName": "",
    "settlementStatus": "1",
    "createdTimeRange": "2026-01-01 12:00:00",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "settlementNo": "",
        "cardModelId": 1,
        "cardModelName": "",
        "startTime": "2026-01-01 12:00:00",
        "endTime": "2026-01-01 12:00:00",
        "sceneryNum": 0,
        "totalAmount": 0,
        "settlementStatus": "1",
        "createdTime": "2026-01-01 12:00:00",
        "profit": 0,
        "issueNum": 0,
        "distributeTotalAmount": 0,
        "isDistributeTotal": false,
        "paymentAmountActualTotal": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（settlementCardService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /settlement/queryScenerySettlementCardPage 在用管理后台 #

旅游卡结算单-分页查询（景区核对方） · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#queryScenerySettlementCardPage
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card

ControllerSettlementCardController#queryScenerySettlementCardPage

转换BeanUtils.map → SettlementCardQuery

转换BeanUtils.map → PageParam

MapperSettlementCardService.getMapper#queryPage ⇒ 表 settlement_card

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

SettlementCardService.applyWrapper

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/queryScenerySettlementCardPage
uat	https://dscp-uat.hn12301.net/manage-api/settlement/queryScenerySettlementCardPage
pro	https://dscp-uat.hn12301.net/manage-api/settlement/queryScenerySettlementCardPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
merchantId	Long			—	商户id
shopId	Long			—	商铺id
settlementNo	String	否	可选(@MvcOptional)	`settlement_card`.`settlement_no`	结算单号
cardModelName	String	否	可选(@MvcOptional)	`settlement_card`.`card_model_name`	卡种名称
settlementStatus	SettlementStatus	否	1待景区核对2待平台核算3待平台审核4待开票5待平台打款6已完成9已作废	`settlement_card`.`settlement_status`	结算状态
createdTimeRange	Date[]	否	可选(@MvcOptional)	—	创建时间
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<SettlementCardPageResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`settlement_card`.`id`	id
settlementNo	String		`settlement_card`.`settlement_no`	结算单号
cardModelId	Long		`settlement_card`.`card_model_id`	卡种编号
cardModelName	String		`settlement_card`.`card_model_name`	卡种名称
startTime	Date		`settlement_card`.`start_time`	开始时间
endTime	Date		`settlement_card`.`end_time`	结束时间
sceneryNum	Integer		`settlement_card`.`scenery_num`	结算景区数量
totalAmount	Long		`settlement_card`.`total_amount`	结算总金额，单位为分
settlementStatus	SettlementStatus	1待景区核对2待平台核算3待平台审核4待开票5待平台打款6已完成9已作废	`settlement_card`.`settlement_status`	结算状态(Enum:SettlementStatus)，1待付款2已付款3作废
createdTime	Date		`settlement_card`.`created_time`	创建时间
profit	Long		`settlement_card`.`profit`	分润金额，单位为分
issueNum	Integer		`settlement_card`.`issue_num`	结算周期内卡种发行量
distributeTotalAmount	Long		`settlement_card`.`distribute_total_amount`	可分配总金额，单位为分
isDistributeTotal	Boolean		`settlement_card`.`is_distribute_total`	是否按分配总额
paymentAmountActualTotal	Long		—	实际打款金额，单位为分

示例

请求示例（自动生成，仅结构参考）

POST /settlement/queryScenerySettlementCardPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "merchantId": 1,
    "shopId": 1,
    "settlementNo": "",
    "cardModelName": "",
    "settlementStatus": "1",
    "createdTimeRange": "2026-01-01 12:00:00",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "settlementNo": "",
        "cardModelId": 1,
        "cardModelName": "",
        "startTime": "2026-01-01 12:00:00",
        "endTime": "2026-01-01 12:00:00",
        "sceneryNum": 0,
        "totalAmount": 0,
        "settlementStatus": "1",
        "createdTime": "2026-01-01 12:00:00",
        "profit": 0,
        "issueNum": 0,
        "distributeTotalAmount": 0,
        "isDistributeTotal": false,
        "paymentAmountActualTotal": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 applyWrapper（settlementCardService.applyWrapper）；查询详情（settlementCardService.getMapper）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryScenerySettlementCardPage exact

POST /settlement/querySettlementCardCalcDetailPage 在用管理后台 #

旅游卡结算单-计算明细分页查询 · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#querySettlementCardCalcDetailPage
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerSettlementCardController#querySettlementCardCalcDetailPage

转换BeanUtils.map → SettlementCardAddRequest

转换BeanUtils.map → SettlementCardDetailListResponse

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

CacheService.get

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/querySettlementCardCalcDetailPage
uat	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardCalcDetailPage
pro	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardCalcDetailPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardCalcDetailQueryRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardModelId	Long	是	必填	—	卡种id
settlementPeriod	Date[]	是	必填	—	结算起止时间

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<SettlementCardDetailListResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		—	id
settlementId	Long		—	结算单id
cardModelName	String		—	卡种名称
settlementPeriod	String		—	结算起止时间
sceneryName	String		—	资源名称
settlementWay	SettlementWay	1按刷卡次数2买断3分成4按分配金额统一计算5月度均衡分配计算	—	结算方式(枚举:card.SettlementWay)
ticketPriceInfo	List<SettlementTicketPriceInfo>		—	门票价格信息
ticketPriceInfo[].startDate	Date		—	开始时间
ticketPriceInfo[].endDate	Date		—	结束时间
ticketPriceInfo[].price	Long		—	门票价
ticketPriceInfo[].checkNum	Integer		—	刷卡次数
ticketPriceInfo[].ticketTotalAmount	Long		—	门票价总计 <em>门票价总计=门票价乘以实际核销次数</em>
ticketPriceInfo[].settlementFactor	Double		—	结算系数
ticketPriceInfo[].settlementAmount	Long		—	结算金额
settlementFactor	Double		—	结算系数
settlementAmount	Long		—	结算金额，单位为分
increaseAmount	Long		—	增加金额，单位为分
decreaseAmount	Long		—	扣减金额，单位为分
settlementAmountActual	Long		—	实际结算金额，单位为分
settlementVerifyStatus	SettlementVerifyStatus	0待核对1已确认2已拒绝	—	结算明细核对状态(枚举:settlement.SettlementVerifyStatus)
settlementMerchantId	Long		—	结算商户id（即开票方）
settlementMerchantName	String		—	结算商户（即开票方）
verifyUserId	Long		—	核对人id
verifyUserName	String		—	核对人姓名
verifyTime	Date		—	核对时间
ticketTotalAmountSum	Long		—	累计门票金额
checkNumSum	Long		—	累计刷卡次数
paymentBank	SettlementCardDetailPayment		—	旅游卡结算明细付款信息
paymentBank.id	Long		—	id
paymentBank.settlementId	Long		—	结算单id
paymentBank.settlementMerchantId	Long		—	结算商户id（即开票方）
paymentBank.isInvoice	Boolean		—	是否开票
paymentBank.invoiceFiles	String		—	发票链接，逗号分隔
paymentBank.isPaid	Boolean		—	是否打款
paymentBank.paymentProofFiles	String		—	付款凭证，逗号分隔
paymentBank.settlementMerchantName	String		—	结算商户名称
paymentBank.merchantFinance	String		—	开户名称
paymentBank.merchantEbank	String		—	开户行
paymentBank.merchantEbankAccount	String		—	银行账号
paymentBank.createdTime	Date		—	创建时间
paymentBank.updatedTime	Date		—	修改时间
paymentBank.paymentAmountActual	Long		—	实际打款金额，单位为分
paymentBank.remark	String		—	备注

示例

请求示例（自动生成，仅结构参考）

POST /settlement/querySettlementCardCalcDetailPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardModelId": 1,
    "settlementPeriod": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "settlementId": 1,
        "cardModelName": "",
        "settlementPeriod": "",
        "sceneryName": "",
        "settlementWay": "1",
        "ticketPriceInfo": [
          {
            "startDate": "2026-01-01 12:00:00",
            "endDate": "2026-01-01 12:00:00",
            "price": 0,
            "checkNum": 0,
            "ticketTotalAmount": 0,
            "settlementFactor": 0,
            "settlementAmount": 0
          }
        ],
        "settlementFactor": 0,
        "settlementAmount": 0,
        "increaseAmount": 0,
        "decreaseAmount": 0,
        "settlementAmountActual": 0,
        "settlementVerifyStatus": "0",
        "settlementMerchantId": 1,
        "settlementMerchantName": "",
        "verifyUserId": 1,
        "verifyUserName": "",
        "verifyTime": "2026-01-01 12:00:00",
        "ticketTotalAmountSum": 0,
        "checkNumSum": 0,
        "paymentBank": {
          "id": 1,
          "settlementId": 1,
          "settlementMerchantId": 1,
          "isInvoice": false,
          "invoiceFiles": "",
          "isPaid": false,
          "paymentProofFiles": "",
          "settlementMerchantName": "",
          "merchantFinance": "",
          "merchantEbank": "",
          "merchantEbankAccount": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00",
          "paymentAmountActual": 0,
          "remark": ""
        }
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要查询详情（cacheService.get）；调用 formatDate（DateUtil.formatDate）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

获取缓存中的数据

前端调用方

dscp-html-manage querySettlementCardCalcDetailPage exact

POST /settlement/querySettlementCardCheckCalcDetailPage 在用管理后台 #

旅游卡结算单-计算明细分页查询 · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#querySettlementCardCheckCalcDetailPage
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerSettlementCardController#querySettlementCardCheckCalcDetailPage

转换BeanUtils.map → SettlementCardAddRequest

转换BeanUtils.map → SettlementCardCheckDetailResponse

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

CacheService.getCheckerCache.get

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/querySettlementCardCheckCalcDetailPage
uat	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardCheckCalcDetailPage
pro	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardCheckCalcDetailPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardCheckCalcDetailQueryRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardModelId	Long	是	必填	—	卡种id
settlementPeriod	Date[]	是	必填	—	结算起止时间
id	Long	是	必填	—	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<SettlementCardCheckDetailResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
cardModelName	String	—	所属卡种
sceneryName	String	—	景区名称
touristName	String	—	持卡人姓名
touristPhone	String	—	持卡人手机
cardNumber	String	—	旅游卡卡号
checkTime	Date	—	刷卡时间
checkerId	Long	—	核销人id
checkerName	String	—	核销人

示例

请求示例（自动生成，仅结构参考）

POST /settlement/querySettlementCardCheckCalcDetailPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardModelId": 1,
    "settlementPeriod": "",
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "cardModelName": "",
        "sceneryName": "",
        "touristName": "",
        "touristPhone": "13800000000",
        "cardNumber": "",
        "checkTime": "2026-01-01 12:00:00",
        "checkerId": 1,
        "checkerName": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要查询详情（cacheService.get）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

获取缓存中的数据

前端调用方

dscp-html-manage querySettlementCardCheckCalcDetailPage exact

POST /settlement/querySettlementCardPage 在用管理后台 #

旅游卡结算单-分页查询（合） · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#querySettlementCardPage
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card

ControllerSettlementCardController#querySettlementCardPage

转换BeanUtils.map → SettlementCardQuery

转换BeanUtils.map → PageParam

MapperSettlementCardService.getMapper#queryPage ⇒ 表 settlement_card

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

SettlementCardService.applyWrapper

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/querySettlementCardPage
uat	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardPage
pro	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
merchantId	Long			—	商户id
shopId	Long			—	商铺id
settlementNo	String	否	可选(@MvcOptional)	`settlement_card`.`settlement_no`	结算单号
cardModelName	String	否	可选(@MvcOptional)	`settlement_card`.`card_model_name`	卡种名称
settlementStatus	SettlementStatus	否	1待景区核对2待平台核算3待平台审核4待开票5待平台打款6已完成9已作废	`settlement_card`.`settlement_status`	结算状态
createdTimeRange	Date[]	否	可选(@MvcOptional)	—	创建时间
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<SettlementCardPageResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`settlement_card`.`id`	id
settlementNo	String		`settlement_card`.`settlement_no`	结算单号
cardModelId	Long		`settlement_card`.`card_model_id`	卡种编号
cardModelName	String		`settlement_card`.`card_model_name`	卡种名称
startTime	Date		`settlement_card`.`start_time`	开始时间
endTime	Date		`settlement_card`.`end_time`	结束时间
sceneryNum	Integer		`settlement_card`.`scenery_num`	结算景区数量
totalAmount	Long		`settlement_card`.`total_amount`	结算总金额，单位为分
settlementStatus	SettlementStatus	1待景区核对2待平台核算3待平台审核4待开票5待平台打款6已完成9已作废	`settlement_card`.`settlement_status`	结算状态(Enum:SettlementStatus)，1待付款2已付款3作废
createdTime	Date		`settlement_card`.`created_time`	创建时间
profit	Long		`settlement_card`.`profit`	分润金额，单位为分
issueNum	Integer		`settlement_card`.`issue_num`	结算周期内卡种发行量
distributeTotalAmount	Long		`settlement_card`.`distribute_total_amount`	可分配总金额，单位为分
isDistributeTotal	Boolean		`settlement_card`.`is_distribute_total`	是否按分配总额
paymentAmountActualTotal	Long		—	实际打款金额，单位为分

示例

请求示例（自动生成，仅结构参考）

POST /settlement/querySettlementCardPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "merchantId": 1,
    "shopId": 1,
    "settlementNo": "",
    "cardModelName": "",
    "settlementStatus": "1",
    "createdTimeRange": "2026-01-01 12:00:00",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "settlementNo": "",
        "cardModelId": 1,
        "cardModelName": "",
        "startTime": "2026-01-01 12:00:00",
        "endTime": "2026-01-01 12:00:00",
        "sceneryNum": 0,
        "totalAmount": 0,
        "settlementStatus": "1",
        "createdTime": "2026-01-01 12:00:00",
        "profit": 0,
        "issueNum": 0,
        "distributeTotalAmount": 0,
        "isDistributeTotal": false,
        "paymentAmountActualTotal": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 applyWrapper（settlementCardService.applyWrapper）；查询详情（settlementCardService.getMapper）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage querySettlementCardPage exact

POST /settlement/submitSettlementCard 在用管理后台 #

旅游卡结算单-提交 · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#submitSettlementCard
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detailsettlement_card_check_detailmerchant_financecard_resource_rulesettlement_cardsettlement_card_detail_paymentsettlement_card_log

ControllerSettlementCardController#submitSettlementCard

转换BeanUtils.map → SettlementCardDetailCalcRequest

转换BeanUtils.map → SettlementCardDetail ⇒ 表 settlement_card_detail

转换BeanUtils.map → SettlementCardCheckDetail ⇒ 表 settlement_card_check_detail

MapperMerchantFinanceService.getMapper#selectOne ⇒ 表 merchant_finance

ServiceCardResourceRuleService#queryList （CardResourceRuleServiceImpl）

MapperCardResourceRuleMapper#selectList ⇒ 表 card_resource_rule

ServiceSettlementCardService#add （SettlementCardServiceImpl）

MapperSettlementCardMapper#insert ⇒ 表 settlement_card

ServiceSettlementCardDetailService#add （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#insert ⇒ 表 settlement_card_detail

ServiceSettlementCardDetailPaymentService#get （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#selectById ⇒ 表 settlement_card_detail_payment

ServiceSettlementCardDetailPaymentService#add （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#insert ⇒ 表 settlement_card_detail_payment

ServiceSettlementCardLogService#add （SettlementCardLogServiceImpl）

MapperSettlementCardLogMapper#insert ⇒ 表 settlement_card_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 8

CacheService.getChaosTransactionTemplate.executeCardModelCache.getSettlementHandlerCache.getSessionUserService.getSessionIdEstimationCardCheckDetailService.addListMerchantCache.getSessionUserService.getSessionUser

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/submitSettlementCard
uat	https://dscp-uat.hn12301.net/manage-api/settlement/submitSettlementCard
pro	https://dscp-uat.hn12301.net/manage-api/settlement/submitSettlementCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModelId	Long	是	必填	`settlement_card_detail`.`card_model_id`	卡种id
profit	Long	是	必填	`settlement_card`.`profit`	单张卡分润金额，单位为分
issueNum	Integer	是	必填	`settlement_card`.`issue_num`	结算周期内卡种发行量
isDistributeTotal	Boolean	是	必填	`settlement_card`.`is_distribute_total`	是否按分配总额
settlementPeriod	Date[]	是	必填	—	结算起止时间

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/submitSettlementCard

{
  "body": {
    "cardModelId": 1,
    "profit": 0,
    "issueNum": 0,
    "isDistributeTotal": false,
    "settlementPeriod": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志settlement / 提交结算单

逻辑摘要查询详情（cacheService.get）；调用 execute（newTransactionTemplate.execute）；调用 beginOfMonth（DateUtil.beginOfMonth）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

// 获取缓存中的数据
if (cache == null) {
throw ResCode.SYS_FAIL.toException("结算明细已过期，请重新计算");
}
设置结算周期，按月度计算
查询卡种资源结算规则
计算各资源结算明细
合并相同结算方式的结果，重新计算系数和金额

前端调用方

dscp-html-manage submitSettlementCard exact

POST /settlement/testSettlementCardCalc 未使用管理后台 #

旅游卡结算单-计算测试 · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#testSettlementCardCalc
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detailsettlement_card_check_detailcard_resource_rule

ControllerSettlementCardController#testSettlementCardCalc

转换BeanUtils.map → SettlementCardDetailCalcRequest

转换BeanUtils.map → SettlementCardDetail ⇒ 表 settlement_card_detail

转换BeanUtils.map → SettlementCardCheckDetail ⇒ 表 settlement_card_check_detail

ServiceCardResourceRuleService#queryList （CardResourceRuleServiceImpl）

MapperCardResourceRuleMapper#selectList ⇒ 表 card_resource_rule

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

CardModelCache.getSettlementHandlerCache.getSessionUserService.getSessionId

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/testSettlementCardCalc
uat	https://dscp-uat.hn12301.net/manage-api/settlement/testSettlementCardCalc
pro	https://dscp-uat.hn12301.net/manage-api/settlement/testSettlementCardCalc	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModelId	Long	是	必填	`settlement_card_detail`.`card_model_id`	卡种id
profit	Long	是	必填	—	单张卡分润金额，单位为分
issueNum	Integer	是	必填	—	结算周期内卡种发行量
isDistributeTotal	Boolean	是	必填	—	是否按分配总额
settlementPeriod	Date[]	是	必填	—	结算起止时间

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/testSettlementCardCalc

{
  "body": {
    "cardModelId": 1,
    "profit": 0,
    "issueNum": 0,
    "isDistributeTotal": false,
    "settlementPeriod": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要调用 beginOfMonth（DateUtil.beginOfMonth）；调用 endOfMonth（DateUtil.endOfMonth）；列表查询（cardResourceRuleService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置结算周期，按月度计算
查询卡种资源结算规则
计算各资源结算明细
新增结算单
新增结算明细
清空临时id
新增结算核销明细
处理异常

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /settlement/uploadInvoice 在用管理后台 #

上传发票 · SettlementCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardController#uploadInvoice
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detail_paymentsettlement_card_detailsettlement_cardsettlement_card_log

ControllerSettlementCardController#uploadInvoice

ServiceSettlementCardDetailPaymentService#get （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#selectById ⇒ 表 settlement_card_detail_payment

ServiceSettlementCardDetailPaymentService#update （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#updateById ⇒ 表 settlement_card_detail_payment

ServiceSettlementCardDetailService#queryList （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#selectList ⇒ 表 settlement_card_detail

ServiceSettlementCardService#update （SettlementCardServiceImpl）

MapperSettlementCardMapper#updateById ⇒ 表 settlement_card

ServiceSettlementCardLogService#add （SettlementCardLogServiceImpl）

MapperSettlementCardLogMapper#insert ⇒ 表 settlement_card_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 5

ChaosTransactionTemplate.executeSettlementCardDetailService.updateListSessionUserService.getSessionUserMerchantCache.getSessionUserService.getSessionId

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/uploadInvoice
uat	https://dscp-uat.hn12301.net/manage-api/settlement/uploadInvoice
pro	https://dscp-uat.hn12301.net/manage-api/settlement/uploadInvoice	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementUploadInvoiceRequest

字段	类型	必填	取值/校验	表 / 列	说明
settlementId	Long	是	必填	`settlement_card_detail_payment`.`settlement_id`	结算单id
settlementMerchantId	Long	是	必填	`settlement_card_detail_payment`.`settlement_merchant_id`	结算商户id（即开票方）
settlementMerchantName	String	是	必填	`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户名称
merchantFinance	String	是	必填	`settlement_card_detail_payment`.`merchant_finance`	开户名称
merchantEbank	String	是	必填	`settlement_card_detail_payment`.`merchant_ebank`	开户行
merchantEbankAccount	String	是	必填	`settlement_card_detail_payment`.`merchant_ebank_account`	银行账号
paymentAmountActual	Long			`settlement_card_detail_payment`.`payment_amount_actual`	实际打款金额，单位为分
remark	String			`settlement_card_detail_payment`.`remark`	备注
invoiceFiles	List<String>	否	可选(@MvcOptional)	`settlement_card_detail_payment`.`invoice_files`	发票文件列表
paymentProofFiles	List<String>	否	可选(@MvcOptional)	`settlement_card_detail_payment`.`payment_proof_files`	付款凭证，逗号分隔

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/uploadInvoice

{
  "body": {
    "settlementId": 1,
    "settlementMerchantId": 1,
    "settlementMerchantName": "",
    "merchantFinance": "",
    "merchantEbank": "",
    "merchantEbankAccount": "",
    "paymentAmountActual": 0,
    "remark": "",
    "invoiceFiles": "",
    "paymentProofFiles": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志settlement / 上传发票

逻辑摘要查询详情（settlementCardDetailPaymentService.get）；调用 execute（newTransactionTemplate.execute）；更新（settlementCardDetailPaymentService.update）

内联注释

1.上传发票
2.修改结算单明细表上传发票状态
3.查询结算单所有结算明细，判断是否已全部上传发票
修改结算单状态为待平台打款
回滚事务
处理异常

前端调用方

dscp-html-manage uploadInvoice exact

SettlementCardDetailController 4/5 在用

POST /settlement/checkSettlementDetail 在用管理后台 #

旅游卡结算明细-景区核对/重新核对 · SettlementCardDetailController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardDetailController#checkSettlementDetail
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detailsettlement_cardsettlement_card_log

ControllerSettlementCardDetailController#checkSettlementDetail

ServiceSettlementCardDetailService#update （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#updateById ⇒ 表 settlement_card_detail

ServiceSettlementCardDetailService#queryList （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#selectList ⇒ 表 settlement_card_detail

ServiceSettlementCardService#update （SettlementCardServiceImpl）

MapperSettlementCardMapper#updateById ⇒ 表 settlement_card

ServiceSettlementCardLogService#add （SettlementCardLogServiceImpl）

MapperSettlementCardLogMapper#insert ⇒ 表 settlement_card_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 4

SessionUserService.getSessionUserChaosTransactionTemplate.executeSettlementCardDetailService.mustGetSessionUserService.getSessionId

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/checkSettlementDetail
uat	https://dscp-uat.hn12301.net/manage-api/settlement/checkSettlementDetail
pro	https://dscp-uat.hn12301.net/manage-api/settlement/checkSettlementDetail	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardDetailCheckRequest

字段	类型	必填	取值/校验	表 / 列	说明
userId	Long			—	用户id
settlementDetailId	Long	是	必填	—	结算明细id
isConfirm	Boolean	是	必填	—	是否确认

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/checkSettlementDetail

{
  "body": {
    "userId": 1,
    "settlementDetailId": 1,
    "isConfirm": false
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志settlement / 核对结算明细

逻辑摘要查询详情（sessionService.getSessionUser）；调用 execute（newTransactionTemplate.execute）；调用 mustGet（settlementCardDetailService.mustGet）

内联注释

查询结算明细
更新结算明细核对状态
查询结算单所有结算明细，判断是否已全部核对
修改结算单状态为待平台核算
回滚事务
处理异常

前端调用方

dscp-html-manage checkSettlementDetail exact

ANY /settlement/exportSettlementCardDetailSplitPage 未使用管理后台 #

导出结算明细（拆分模式） · SettlementCardDetailController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardDetailController#exportSettlementCardDetailSplitPage
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	ANY

调用链路 & 涉及数据表

涉及数据表settlement_card_detailsettlement_card_detail_payment

ControllerSettlementCardDetailController#exportSettlementCardDetailSplitPage

转换BeanUtils.map → SettlementCardDetailQuery

ServiceSettlementCardDetailService#queryList （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#selectList ⇒ 表 settlement_card_detail

ServiceSettlementCardDetailPaymentService#get （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#selectById ⇒ 表 settlement_card_detail_payment

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

SessionUserService.isMerchantSessionUserService.getSessionUserSessionUserService.isShop

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/exportSettlementCardDetailSplitPage
uat	https://dscp-uat.hn12301.net/manage-api/settlement/exportSettlementCardDetailSplitPage
pro	https://dscp-uat.hn12301.net/manage-api/settlement/exportSettlementCardDetailSplitPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HttpServletResponse

请求体类型：HttpServletResponse（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

ANY /settlement/exportSettlementCardDetailSplitPage

响应示例

（void，无响应体）

处理逻辑

逻辑摘要调用 isMerchant（sessionService.isMerchant）；查询详情（sessionService.getSessionUser）；调用 isShop（sessionService.isShop）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件
结算商户的数据
商铺的数据
设置参数
银行信息
根据不同的情况导出不同的内容 //TODO 666
组装导出数据
序号

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /settlement/querySettlementCardDetailPage 在用管理后台 #

旅游卡结算明细-分页查询 · SettlementCardDetailController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardDetailController#querySettlementCardDetailPage
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detail

ControllerSettlementCardDetailController#querySettlementCardDetailPage

转换BeanUtils.map → SettlementCardDetailQuery

ServiceSettlementCardDetailService#queryPage （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#selectPage ⇒ 表 settlement_card_detail

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

SessionUserService.isMerchantSessionUserService.getSessionUserSessionUserService.isShop

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/querySettlementCardDetailPage
uat	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardDetailPage
pro	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardDetailPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardDetailPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
id	Long			`settlement_card_detail`.`id`	结算id
settlementId	Long	是	必填	`settlement_card_detail`.`settlement_id`	结算id
sceneryName	String	否	可选(@MvcOptional)	`settlement_card_detail`.`scenery_name`	资源名称
settlementVerifyStatus	SettlementVerifyStatus	否	0待核对1已确认2已拒绝	`settlement_card_detail`.`settlement_verify_status`	结算明细核对状态(枚举:settlement.SettlementVerifyStatus)
settlementMerchantId	Long			`settlement_card_detail`.`settlement_merchant_id`	结算商户id
exportType	Integer			—	1.待平台审核状态和已经作废状态下的结算信息的导出，2.景区核对详情导出，3.系统核算详情导出
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<SettlementCardDetailListResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`settlement_card_detail`.`id`	id
settlementId	Long		`settlement_card_detail`.`settlement_id`	结算单id
cardModelName	String		—	卡种名称
settlementPeriod	String		—	结算起止时间
sceneryName	String		`settlement_card_detail`.`scenery_name`	资源名称
settlementWay	SettlementWay	1按刷卡次数2买断3分成4按分配金额统一计算5月度均衡分配计算	`settlement_card_detail`.`settlement_way`	结算方式(枚举:card.SettlementWay)
ticketPriceInfo	List<SettlementTicketPriceInfo>		`settlement_card_detail`.`ticket_price_info`	门票价格信息
ticketPriceInfo[].startDate	Date		—	开始时间
ticketPriceInfo[].endDate	Date		—	结束时间
ticketPriceInfo[].price	Long		—	门票价
ticketPriceInfo[].checkNum	Integer		—	刷卡次数
ticketPriceInfo[].ticketTotalAmount	Long		—	门票价总计 <em>门票价总计=门票价乘以实际核销次数</em>
ticketPriceInfo[].settlementFactor	Double		`settlement_card_detail`.`settlement_factor`	结算系数
ticketPriceInfo[].settlementAmount	Long		`settlement_card_detail`.`settlement_amount`	结算金额
settlementFactor	Double		`settlement_card_detail`.`settlement_factor`	结算系数
settlementAmount	Long		`settlement_card_detail`.`settlement_amount`	结算金额，单位为分
increaseAmount	Long		`settlement_card_detail`.`increase_amount`	增加金额，单位为分
decreaseAmount	Long		`settlement_card_detail`.`decrease_amount`	扣减金额，单位为分
settlementAmountActual	Long		`settlement_card_detail`.`settlement_amount_actual`	实际结算金额，单位为分
settlementVerifyStatus	SettlementVerifyStatus	0待核对1已确认2已拒绝	`settlement_card_detail`.`settlement_verify_status`	结算明细核对状态(枚举:settlement.SettlementVerifyStatus)
settlementMerchantId	Long		`settlement_card_detail`.`settlement_merchant_id`	结算商户id（即开票方）
settlementMerchantName	String		—	结算商户（即开票方）
verifyUserId	Long		`settlement_card_detail`.`verify_user_id`	核对人id
verifyUserName	String		—	核对人姓名
verifyTime	Date		`settlement_card_detail`.`verify_time`	核对时间
ticketTotalAmountSum	Long		—	累计门票金额
checkNumSum	Long		—	累计刷卡次数
paymentBank	SettlementCardDetailPayment		—	旅游卡结算明细付款信息
paymentBank.id	Long		`settlement_card_detail`.`id`	id
paymentBank.settlementId	Long		`settlement_card_detail`.`settlement_id`	结算单id
paymentBank.settlementMerchantId	Long		`settlement_card_detail`.`settlement_merchant_id`	结算商户id（即开票方）
paymentBank.isInvoice	Boolean		`settlement_card_detail`.`is_invoice`	是否开票
paymentBank.invoiceFiles	String		—	发票链接，逗号分隔
paymentBank.isPaid	Boolean		`settlement_card_detail`.`is_paid`	是否打款
paymentBank.paymentProofFiles	String		—	付款凭证，逗号分隔
paymentBank.settlementMerchantName	String		—	结算商户名称
paymentBank.merchantFinance	String		—	开户名称
paymentBank.merchantEbank	String		—	开户行
paymentBank.merchantEbankAccount	String		—	银行账号
paymentBank.createdTime	Date		`settlement_card_detail`.`created_time`	创建时间
paymentBank.updatedTime	Date		`settlement_card_detail`.`updated_time`	修改时间
paymentBank.paymentAmountActual	Long		—	实际打款金额，单位为分
paymentBank.remark	String		—	备注

示例

请求示例（自动生成，仅结构参考）

POST /settlement/querySettlementCardDetailPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "id": 1,
    "settlementId": 1,
    "sceneryName": "",
    "settlementVerifyStatus": "0",
    "settlementMerchantId": 1,
    "exportType": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "settlementId": 1,
        "cardModelName": "",
        "settlementPeriod": "",
        "sceneryName": "",
        "settlementWay": "1",
        "ticketPriceInfo": [
          {
            "startDate": "2026-01-01 12:00:00",
            "endDate": "2026-01-01 12:00:00",
            "price": 0,
            "checkNum": 0,
            "ticketTotalAmount": 0,
            "settlementFactor": 0,
            "settlementAmount": 0
          }
        ],
        "settlementFactor": 0,
        "settlementAmount": 0,
        "increaseAmount": 0,
        "decreaseAmount": 0,
        "settlementAmountActual": 0,
        "settlementVerifyStatus": "0",
        "settlementMerchantId": 1,
        "settlementMerchantName": "",
        "verifyUserId": 1,
        "verifyUserName": "",
        "verifyTime": "2026-01-01 12:00:00",
        "ticketTotalAmountSum": 0,
        "checkNumSum": 0,
        "paymentBank": {
          "id": 1,
          "settlementId": 1,
          "settlementMerchantId": 1,
          "isInvoice": false,
          "invoiceFiles": "",
          "isPaid": false,
          "paymentProofFiles": "",
          "settlementMerchantName": "",
          "merchantFinance": "",
          "merchantEbank": "",
          "merchantEbankAccount": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00",
          "paymentAmountActual": 0,
          "remark": ""
        }
      }
    ],
    "total": 0
  }
}

处理逻辑

内联注释

设置其他查询条件
结算商户的数据
商铺的数据

前端调用方

dscp-html-manage querySettlementCardDetailPage exact

POST /settlement/querySettlementCardDetailSplitPage 在用管理后台 #

旅游卡结算明细-分页查询（拆分模式） · SettlementCardDetailController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardDetailController#querySettlementCardDetailSplitPage
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detailsettlement_card_detail_payment

ControllerSettlementCardDetailController#querySettlementCardDetailSplitPage

转换BeanUtils.map → SettlementCardDetailQuery

ServiceSettlementCardDetailService#queryPage （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#selectPage ⇒ 表 settlement_card_detail

ServiceSettlementCardDetailPaymentService#get （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#selectById ⇒ 表 settlement_card_detail_payment

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

SessionUserService.isMerchantSessionUserService.getSessionUserSessionUserService.isShop

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/querySettlementCardDetailSplitPage
uat	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardDetailSplitPage
pro	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardDetailSplitPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardDetailPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
id	Long			`settlement_card_detail`.`id`	结算id
settlementId	Long	是	必填	`settlement_card_detail`.`settlement_id`	结算id
sceneryName	String	否	可选(@MvcOptional)	`settlement_card_detail`.`scenery_name`	资源名称
settlementVerifyStatus	SettlementVerifyStatus	否	0待核对1已确认2已拒绝	`settlement_card_detail`.`settlement_verify_status`	结算明细核对状态(枚举:settlement.SettlementVerifyStatus)
settlementMerchantId	Long			`settlement_card_detail`.`settlement_merchant_id`	结算商户id
exportType	Integer			—	1.待平台审核状态和已经作废状态下的结算信息的导出，2.景区核对详情导出，3.系统核算详情导出
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<SettlementCardDetailSplitListResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`settlement_card_detail`.`id`	id
settlementId	Long		`settlement_card_detail`.`settlement_id`	结算单id
cardModelName	String		—	卡种名称
settlementPeriod	String		—	结算起止时间
sceneryName	String		`settlement_card_detail`.`scenery_name`	资源名称
settlementWay	SettlementWay	1按刷卡次数2买断3分成4按分配金额统一计算5月度均衡分配计算	`settlement_card_detail`.`settlement_way`	结算方式(枚举:card.SettlementWay)
sectionStartDate	Date		—	区间开始时间
sectionEndDate	Date		—	区间结束时间
sectionPrice	Long		—	区间门票价
sectionCheckNum	Integer		—	区间刷卡次数
sectionTicketTotalAmount	Long		—	区间门票价总计 <em>门票价总计=门票价乘以实际核销次数</em>
sectionSettlementFactor	Double		—	区间结算系数
sectionSettlementAmount	Long		—	区间结算金额
settlementFactor	Double		`settlement_card_detail`.`settlement_factor`	结算系数
settlementAmount	Long		`settlement_card_detail`.`settlement_amount`	结算金额，单位为分
increaseAmount	Long		`settlement_card_detail`.`increase_amount`	增加金额，单位为分
decreaseAmount	Long		`settlement_card_detail`.`decrease_amount`	扣减金额，单位为分
settlementAmountActual	Long		`settlement_card_detail`.`settlement_amount_actual`	实际结算金额，单位为分
settlementVerifyStatus	SettlementVerifyStatus	0待核对1已确认2已拒绝	`settlement_card_detail`.`settlement_verify_status`	结算明细核对状态(枚举:settlement.SettlementVerifyStatus)
settlementMerchantId	Long		`settlement_card_detail`.`settlement_merchant_id`	结算商户id（即开票方）
settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户（即开票方）
verifyUserId	Long		`settlement_card_detail`.`verify_user_id`	核对人id
verifyUserName	String		—	核对人姓名
verifyTime	Date		`settlement_card_detail`.`verify_time`	核对时间
ticketTotalAmountSum	Long		—	累计刷卡次数
paymentBank	SettlementCardDetailPayment		—	旅游卡结算明细付款信息
paymentBank.id	Long		`settlement_card_detail`.`id`	id
paymentBank.settlementId	Long		`settlement_card_detail`.`settlement_id`	结算单id
paymentBank.settlementMerchantId	Long		`settlement_card_detail`.`settlement_merchant_id`	结算商户id（即开票方）
paymentBank.isInvoice	Boolean		`settlement_card_detail`.`is_invoice`	是否开票
paymentBank.invoiceFiles	String		`settlement_card_detail_payment`.`invoice_files`	发票链接，逗号分隔
paymentBank.isPaid	Boolean		`settlement_card_detail`.`is_paid`	是否打款
paymentBank.paymentProofFiles	String		`settlement_card_detail_payment`.`payment_proof_files`	付款凭证，逗号分隔
paymentBank.settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户名称
paymentBank.merchantFinance	String		`settlement_card_detail_payment`.`merchant_finance`	开户名称
paymentBank.merchantEbank	String		`settlement_card_detail_payment`.`merchant_ebank`	开户行
paymentBank.merchantEbankAccount	String		`settlement_card_detail_payment`.`merchant_ebank_account`	银行账号
paymentBank.createdTime	Date		`settlement_card_detail`.`created_time`	创建时间
paymentBank.updatedTime	Date		`settlement_card_detail`.`updated_time`	修改时间
paymentBank.paymentAmountActual	Long		`settlement_card_detail_payment`.`payment_amount_actual`	实际打款金额，单位为分
paymentBank.remark	String		`settlement_card_detail_payment`.`remark`	备注

示例

请求示例（自动生成，仅结构参考）

POST /settlement/querySettlementCardDetailSplitPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "id": 1,
    "settlementId": 1,
    "sceneryName": "",
    "settlementVerifyStatus": "0",
    "settlementMerchantId": 1,
    "exportType": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "settlementId": 1,
        "cardModelName": "",
        "settlementPeriod": "",
        "sceneryName": "",
        "settlementWay": "1",
        "sectionStartDate": "2026-01-01 12:00:00",
        "sectionEndDate": "2026-01-01 12:00:00",
        "sectionPrice": 0,
        "sectionCheckNum": 0,
        "sectionTicketTotalAmount": 0,
        "sectionSettlementFactor": 0,
        "sectionSettlementAmount": 0,
        "settlementFactor": 0,
        "settlementAmount": 0,
        "increaseAmount": 0,
        "decreaseAmount": 0,
        "settlementAmountActual": 0,
        "settlementVerifyStatus": "0",
        "settlementMerchantId": 1,
        "settlementMerchantName": "",
        "verifyUserId": 1,
        "verifyUserName": "",
        "verifyTime": "2026-01-01 12:00:00",
        "ticketTotalAmountSum": 0,
        "paymentBank": {
          "id": 1,
          "settlementId": 1,
          "settlementMerchantId": 1,
          "isInvoice": false,
          "invoiceFiles": "",
          "isPaid": false,
          "paymentProofFiles": "",
          "settlementMerchantName": "",
          "merchantFinance": "",
          "merchantEbank": "",
          "merchantEbankAccount": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00",
          "paymentAmountActual": 0,
          "remark": ""
        }
      }
    ],
    "total": 0
  }
}

处理逻辑

内联注释

设置其他查询条件
结算商户的数据
商铺的数据
设置参数
银行信息

前端调用方

dscp-html-manage querySettlementCardDetailSplitPage exact

POST /settlement/rejectedSettlementDetai 在用管理后台 #

旅游卡结算明细-拒绝 · SettlementCardDetailController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardDetailController#rejectedSettlementDetai
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detailsettlement_card_log

ControllerSettlementCardDetailController#rejectedSettlementDetai

ServiceSettlementCardDetailService#get （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#selectById ⇒ 表 settlement_card_detail

ServiceSettlementCardDetailService#update （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#updateById ⇒ 表 settlement_card_detail

ServiceSettlementCardLogService#add （SettlementCardLogServiceImpl）

MapperSettlementCardLogMapper#insert ⇒ 表 settlement_card_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

SessionUserService.getSessionUserSessionUserService.getSessionId

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/rejectedSettlementDetai
uat	https://dscp-uat.hn12301.net/manage-api/settlement/rejectedSettlementDetai
pro	https://dscp-uat.hn12301.net/manage-api/settlement/rejectedSettlementDetai	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`settlement_card_detail`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/rejectedSettlementDetai

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志settlement / 拒绝结算明细

逻辑摘要查询详情（sessionService.getSessionUser）；查询详情（settlementCardDetailService.get）；更新（settlementCardDetailService.update）

内联注释

更新结算明细核对状态为拒绝

前端调用方

dscp-html-manage rejectedSettlementDetai exact

SettlementCardDetailPaymentController 6/7 在用

ANY /settlement/exportSettlementCardDetailPaymentPage 未使用管理后台 #

导出打款列表 · SettlementCardDetailPaymentController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardDetailPaymentController#exportSettlementCardDetailPaymentPage
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	ANY

调用链路 & 涉及数据表

涉及数据表settlement_card_detail_payment

ControllerSettlementCardDetailPaymentController#exportSettlementCardDetailPaymentPage

转换BeanUtils.map → SettlementCardDetailPaymentQuery

ServiceSettlementCardDetailPaymentService#queryList （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#selectList ⇒ 表 settlement_card_detail_payment

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/exportSettlementCardDetailPaymentPage
uat	https://dscp-uat.hn12301.net/manage-api/settlement/exportSettlementCardDetailPaymentPage
pro	https://dscp-uat.hn12301.net/manage-api/settlement/exportSettlementCardDetailPaymentPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HttpServletResponse

请求体类型：HttpServletResponse（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

ANY /settlement/exportSettlementCardDetailPaymentPage

响应示例

（void，无响应体）

处理逻辑

逻辑摘要列表查询（settlementCardDetailPaymentService.queryList）；调用 write（ExcelUtils.write）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

组装导出数据
序号

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /settlement/invoiceGetPaymentInvoice 在用管理后台 #

旅游卡结算明细-查看发票信息(开票方) · SettlementCardDetailPaymentController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardDetailPaymentController#invoiceGetPaymentInvoice
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detail_paymentsettlement_card_detail

ControllerSettlementCardDetailPaymentController#invoiceGetPaymentInvoice

ServiceSettlementCardDetailPaymentService#get （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#selectById ⇒ 表 settlement_card_detail_payment

ServiceSettlementCardDetailService#queryList （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#selectList ⇒ 表 settlement_card_detail

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

SessionUserService.getSessionUserMerchantCache.get

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/invoiceGetPaymentInvoice
uat	https://dscp-uat.hn12301.net/manage-api/settlement/invoiceGetPaymentInvoice
pro	https://dscp-uat.hn12301.net/manage-api/settlement/invoiceGetPaymentInvoice	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardDetailPaymentRequest

字段	类型	必填	取值/校验	表 / 列	说明
settlementId	Long	是	必填	`settlement_card_detail_payment`.`settlement_id`	结算id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　SceneryPaymentResponse　（object）

字段	类型	取值/校验	表 / 列	说明
settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	开票商户
transferInfo	List<SettlementCardDetailListResponse>		—
transferInfo[].id	Long		`settlement_card_detail_payment`.`id`	id
transferInfo[].settlementId	Long		`settlement_card_detail_payment`.`settlement_id`	结算单id
transferInfo[].cardModelName	String		—	卡种名称
transferInfo[].settlementPeriod	String		—	结算起止时间
transferInfo[].sceneryName	String		`settlement_card_detail`.`scenery_name`	资源名称
transferInfo[].settlementWay	SettlementWay	1按刷卡次数2买断3分成4按分配金额统一计算5月度均衡分配计算	`settlement_card_detail`.`settlement_way`	结算方式(枚举:card.SettlementWay)
transferInfo[].ticketPriceInfo	List<SettlementTicketPriceInfo>		`settlement_card_detail`.`ticket_price_info`	门票价格信息
ticketPriceInfo[].startDate	Date		—	开始时间
ticketPriceInfo[].endDate	Date		—	结束时间
ticketPriceInfo[].price	Long		—	门票价
ticketPriceInfo[].checkNum	Integer		—	刷卡次数
ticketPriceInfo[].ticketTotalAmount	Long		—	门票价总计 <em>门票价总计=门票价乘以实际核销次数</em>
ticketPriceInfo[].settlementFactor	Double		`settlement_card_detail`.`settlement_factor`	结算系数
ticketPriceInfo[].settlementAmount	Long		`settlement_card_detail`.`settlement_amount`	结算金额
transferInfo[].settlementFactor	Double		`settlement_card_detail`.`settlement_factor`	结算系数
transferInfo[].settlementAmount	Long		`settlement_card_detail`.`settlement_amount`	结算金额，单位为分
transferInfo[].increaseAmount	Long		`settlement_card_detail`.`increase_amount`	增加金额，单位为分
transferInfo[].decreaseAmount	Long		`settlement_card_detail`.`decrease_amount`	扣减金额，单位为分
transferInfo[].settlementAmountActual	Long		`settlement_card_detail`.`settlement_amount_actual`	实际结算金额，单位为分
transferInfo[].settlementVerifyStatus	SettlementVerifyStatus	0待核对1已确认2已拒绝	`settlement_card_detail`.`settlement_verify_status`	结算明细核对状态(枚举:settlement.SettlementVerifyStatus)
transferInfo[].settlementMerchantId	Long		`settlement_card_detail_payment`.`settlement_merchant_id`	结算商户id（即开票方）
transferInfo[].settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户（即开票方）
transferInfo[].verifyUserId	Long		`settlement_card_detail`.`verify_user_id`	核对人id
transferInfo[].verifyUserName	String		—	核对人姓名
transferInfo[].verifyTime	Date		`settlement_card_detail`.`verify_time`	核对时间
transferInfo[].ticketTotalAmountSum	Long		—	累计门票金额
transferInfo[].checkNumSum	Long		—	累计刷卡次数
transferInfo[].paymentBank	SettlementCardDetailPayment		—	旅游卡结算明细付款信息
paymentBank.id	Long		`settlement_card_detail_payment`.`id`	id
paymentBank.settlementId	Long		`settlement_card_detail_payment`.`settlement_id`	结算单id
paymentBank.settlementMerchantId	Long		`settlement_card_detail_payment`.`settlement_merchant_id`	结算商户id（即开票方）
paymentBank.isInvoice	Boolean		`settlement_card_detail_payment`.`is_invoice`	是否开票
paymentBank.invoiceFiles	String		`settlement_card_detail_payment`.`invoice_files`	发票链接，逗号分隔
paymentBank.isPaid	Boolean		`settlement_card_detail_payment`.`is_paid`	是否打款
paymentBank.paymentProofFiles	String		`settlement_card_detail_payment`.`payment_proof_files`	付款凭证，逗号分隔
paymentBank.settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户名称
paymentBank.merchantFinance	String		`settlement_card_detail_payment`.`merchant_finance`	开户名称
paymentBank.merchantEbank	String		`settlement_card_detail_payment`.`merchant_ebank`	开户行
paymentBank.merchantEbankAccount	String		`settlement_card_detail_payment`.`merchant_ebank_account`	银行账号
paymentBank.createdTime	Date		`settlement_card_detail_payment`.`created_time`	创建时间
paymentBank.updatedTime	Date		`settlement_card_detail_payment`.`updated_time`	修改时间
paymentBank.paymentAmountActual	Long		`settlement_card_detail_payment`.`payment_amount_actual`	实际打款金额，单位为分
paymentBank.remark	String		`settlement_card_detail_payment`.`remark`	备注
invoiceFiles	List<InvoicePaymentResponse>		`settlement_card_detail_payment`.`invoice_files`	发票文件
invoiceFiles[].invoiceName	String		—	发票文件名称
invoiceFiles[].invoiceFile	String		—	发票文件url地址
proofFiles	List<ProofPaymentResponse>		—	付款凭证
proofFiles[].proofName	String		—	凭证文件名称
proofFiles[].proofFile	String		—	凭证文件url地址
settlementCardDetailSplit	List<SettlementCardDetailSplitListResponse>		—
settlementCardDetailSplit[].id	Long		`settlement_card_detail_payment`.`id`	id
settlementCardDetailSplit[].settlementId	Long		`settlement_card_detail_payment`.`settlement_id`	结算单id
settlementCardDetailSplit[].cardModelName	String		—	卡种名称
settlementCardDetailSplit[].settlementPeriod	String		—	结算起止时间
settlementCardDetailSplit[].sceneryName	String		`settlement_card_detail`.`scenery_name`	资源名称
settlementCardDetailSplit[].settlementWay	SettlementWay	1按刷卡次数2买断3分成4按分配金额统一计算5月度均衡分配计算	`settlement_card_detail`.`settlement_way`	结算方式(枚举:card.SettlementWay)
settlementCardDetailSplit[].sectionStartDate	Date		—	区间开始时间
settlementCardDetailSplit[].sectionEndDate	Date		—	区间结束时间
settlementCardDetailSplit[].sectionPrice	Long		—	区间门票价
settlementCardDetailSplit[].sectionCheckNum	Integer		—	区间刷卡次数
settlementCardDetailSplit[].sectionTicketTotalAmount	Long		—	区间门票价总计 <em>门票价总计=门票价乘以实际核销次数</em>
settlementCardDetailSplit[].sectionSettlementFactor	Double		—	区间结算系数
settlementCardDetailSplit[].sectionSettlementAmount	Long		—	区间结算金额
settlementCardDetailSplit[].settlementFactor	Double		`settlement_card_detail`.`settlement_factor`	结算系数
settlementCardDetailSplit[].settlementAmount	Long		`settlement_card_detail`.`settlement_amount`	结算金额，单位为分
settlementCardDetailSplit[].increaseAmount	Long		`settlement_card_detail`.`increase_amount`	增加金额，单位为分
settlementCardDetailSplit[].decreaseAmount	Long		`settlement_card_detail`.`decrease_amount`	扣减金额，单位为分
settlementCardDetailSplit[].settlementAmountActual	Long		`settlement_card_detail`.`settlement_amount_actual`	实际结算金额，单位为分
settlementCardDetailSplit[].settlementVerifyStatus	SettlementVerifyStatus	0待核对1已确认2已拒绝	`settlement_card_detail`.`settlement_verify_status`	结算明细核对状态(枚举:settlement.SettlementVerifyStatus)
settlementCardDetailSplit[].settlementMerchantId	Long		`settlement_card_detail_payment`.`settlement_merchant_id`	结算商户id（即开票方）
settlementCardDetailSplit[].settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户（即开票方）
settlementCardDetailSplit[].verifyUserId	Long		`settlement_card_detail`.`verify_user_id`	核对人id
settlementCardDetailSplit[].verifyUserName	String		—	核对人姓名
settlementCardDetailSplit[].verifyTime	Date		`settlement_card_detail`.`verify_time`	核对时间
settlementCardDetailSplit[].ticketTotalAmountSum	Long		—	累计刷卡次数
settlementCardDetailSplit[].paymentBank	SettlementCardDetailPayment		—	旅游卡结算明细付款信息
paymentBank.id	Long		`settlement_card_detail_payment`.`id`	id
paymentBank.settlementId	Long		`settlement_card_detail_payment`.`settlement_id`	结算单id
paymentBank.settlementMerchantId	Long		`settlement_card_detail_payment`.`settlement_merchant_id`	结算商户id（即开票方）
paymentBank.isInvoice	Boolean		`settlement_card_detail_payment`.`is_invoice`	是否开票
paymentBank.invoiceFiles	String		`settlement_card_detail_payment`.`invoice_files`	发票链接，逗号分隔
paymentBank.isPaid	Boolean		`settlement_card_detail_payment`.`is_paid`	是否打款
paymentBank.paymentProofFiles	String		`settlement_card_detail_payment`.`payment_proof_files`	付款凭证，逗号分隔
paymentBank.settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户名称
paymentBank.merchantFinance	String		`settlement_card_detail_payment`.`merchant_finance`	开户名称
paymentBank.merchantEbank	String		`settlement_card_detail_payment`.`merchant_ebank`	开户行
paymentBank.merchantEbankAccount	String		`settlement_card_detail_payment`.`merchant_ebank_account`	银行账号
paymentBank.createdTime	Date		`settlement_card_detail_payment`.`created_time`	创建时间
paymentBank.updatedTime	Date		`settlement_card_detail_payment`.`updated_time`	修改时间
paymentBank.paymentAmountActual	Long		`settlement_card_detail_payment`.`payment_amount_actual`	实际打款金额，单位为分
paymentBank.remark	String		`settlement_card_detail_payment`.`remark`	备注

示例

请求示例（自动生成，仅结构参考）

POST /settlement/invoiceGetPaymentInvoice

{
  "body": {
    "settlementId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "settlementMerchantName": "",
    "transferInfo": [
      {
        "id": 1,
        "settlementId": 1,
        "cardModelName": "",
        "settlementPeriod": "",
        "sceneryName": "",
        "settlementWay": "1",
        "ticketPriceInfo": [
          {
            "startDate": "2026-01-01 12:00:00",
            "endDate": "2026-01-01 12:00:00",
            "price": 0,
            "checkNum": 0,
            "ticketTotalAmount": 0,
            "settlementFactor": 0,
            "settlementAmount": 0
          }
        ],
        "settlementFactor": 0,
        "settlementAmount": 0,
        "increaseAmount": 0,
        "decreaseAmount": 0,
        "settlementAmountActual": 0,
        "settlementVerifyStatus": "0",
        "settlementMerchantId": 1,
        "settlementMerchantName": "",
        "verifyUserId": 1,
        "verifyUserName": "",
        "verifyTime": "2026-01-01 12:00:00",
        "ticketTotalAmountSum": 0,
        "checkNumSum": 0,
        "paymentBank": {
          "id": 1,
          "settlementId": 1,
          "settlementMerchantId": 1,
          "isInvoice": false,
          "invoiceFiles": "",
          "isPaid": false,
          "paymentProofFiles": "",
          "settlementMerchantName": "",
          "merchantFinance": "",
          "merchantEbank": "",
          "merchantEbankAccount": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00",
          "paymentAmountActual": 0,
          "remark": ""
        }
      }
    ],
    "invoiceFiles": [
      {
        "invoiceName": "",
        "invoiceFile": ""
      }
    ],
    "proofFiles": [
      {
        "proofName": "",
        "proofFile": ""
      }
    ],
    "settlementCardDetailSplit": [
      {
        "id": 1,
        "settlementId": 1,
        "cardModelName": "",
        "settlementPeriod": "",
        "sceneryName": "",
        "settlementWay": "1",
        "sectionStartDate": "2026-01-01 12:00:00",
        "sectionEndDate": "2026-01-01 12:00:00",
        "sectionPrice": 0,
        "sectionCheckNum": 0,
        "sectionTicketTotalAmount": 0,
        "sectionSettlementFactor": 0,
        "sectionSettlementAmount": 0,
        "settlementFactor": 0,
        "settlementAmount": 0,
        "increaseAmount": 0,
        "decreaseAmount": 0,
        "settlementAmountActual": 0,
        "settlementVerifyStatus": "0",
        "settlementMerchantId": 1,
        "settlementMerchantName": "",
        "verifyUserId": 1,
        "verifyUserName": "",
        "verifyTime": "2026-01-01 12:00:00",
        "ticketTotalAmountSum": 0,
        "paymentBank": {
          "id": 1,
          "settlementId": 1,
          "settlementMerchantId": 1,
          "isInvoice": false,
          "invoiceFiles": "",
          "isPaid": false,
          "paymentProofFiles": "",
          "settlementMerchantName": "",
          "merchantFinance": "",
          "merchantEbank": "",
          "merchantEbankAccount": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00",
          "paymentAmountActual": 0,
          "remark": ""
        }
      }
    ]
  }
}

处理逻辑

逻辑摘要查询详情（sessionService.getSessionUser）；查询详情（settlementCardDetailPaymentService.get）；调用 isNotEmpty（StrUtil.isNotEmpty）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

反查结算商户包含的资源结算明细
设置参数
银行信息
转化对象

前端调用方

dscp-html-manage invoiceGetPaymentInvoice exact

POST /settlement/invoiceGetPaymentProof 在用管理后台 #

旅游卡结算明细-查看付款凭证(开票方) · SettlementCardDetailPaymentController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardDetailPaymentController#invoiceGetPaymentProof
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detail_paymentsettlement_card_detail

ControllerSettlementCardDetailPaymentController#invoiceGetPaymentProof

ServiceSettlementCardDetailPaymentService#get （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#selectById ⇒ 表 settlement_card_detail_payment

ServiceSettlementCardDetailService#queryList （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#selectList ⇒ 表 settlement_card_detail

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

SessionUserService.getSessionUserMerchantCache.get

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/invoiceGetPaymentProof
uat	https://dscp-uat.hn12301.net/manage-api/settlement/invoiceGetPaymentProof
pro	https://dscp-uat.hn12301.net/manage-api/settlement/invoiceGetPaymentProof	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardDetailPaymentRequest

字段	类型	必填	取值/校验	表 / 列	说明
settlementId	Long	是	必填	`settlement_card_detail_payment`.`settlement_id`	结算id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　SceneryPaymentResponse　（object）

字段	类型	取值/校验	表 / 列	说明
settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	开票商户
transferInfo	List<SettlementCardDetailListResponse>		—
transferInfo[].id	Long		`settlement_card_detail_payment`.`id`	id
transferInfo[].settlementId	Long		`settlement_card_detail_payment`.`settlement_id`	结算单id
transferInfo[].cardModelName	String		—	卡种名称
transferInfo[].settlementPeriod	String		—	结算起止时间
transferInfo[].sceneryName	String		`settlement_card_detail`.`scenery_name`	资源名称
transferInfo[].settlementWay	SettlementWay	1按刷卡次数2买断3分成4按分配金额统一计算5月度均衡分配计算	`settlement_card_detail`.`settlement_way`	结算方式(枚举:card.SettlementWay)
transferInfo[].ticketPriceInfo	List<SettlementTicketPriceInfo>		`settlement_card_detail`.`ticket_price_info`	门票价格信息
ticketPriceInfo[].startDate	Date		—	开始时间
ticketPriceInfo[].endDate	Date		—	结束时间
ticketPriceInfo[].price	Long		—	门票价
ticketPriceInfo[].checkNum	Integer		—	刷卡次数
ticketPriceInfo[].ticketTotalAmount	Long		—	门票价总计 <em>门票价总计=门票价乘以实际核销次数</em>
ticketPriceInfo[].settlementFactor	Double		`settlement_card_detail`.`settlement_factor`	结算系数
ticketPriceInfo[].settlementAmount	Long		`settlement_card_detail`.`settlement_amount`	结算金额
transferInfo[].settlementFactor	Double		`settlement_card_detail`.`settlement_factor`	结算系数
transferInfo[].settlementAmount	Long		`settlement_card_detail`.`settlement_amount`	结算金额，单位为分
transferInfo[].increaseAmount	Long		`settlement_card_detail`.`increase_amount`	增加金额，单位为分
transferInfo[].decreaseAmount	Long		`settlement_card_detail`.`decrease_amount`	扣减金额，单位为分
transferInfo[].settlementAmountActual	Long		`settlement_card_detail`.`settlement_amount_actual`	实际结算金额，单位为分
transferInfo[].settlementVerifyStatus	SettlementVerifyStatus	0待核对1已确认2已拒绝	`settlement_card_detail`.`settlement_verify_status`	结算明细核对状态(枚举:settlement.SettlementVerifyStatus)
transferInfo[].settlementMerchantId	Long		`settlement_card_detail_payment`.`settlement_merchant_id`	结算商户id（即开票方）
transferInfo[].settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户（即开票方）
transferInfo[].verifyUserId	Long		`settlement_card_detail`.`verify_user_id`	核对人id
transferInfo[].verifyUserName	String		—	核对人姓名
transferInfo[].verifyTime	Date		`settlement_card_detail`.`verify_time`	核对时间
transferInfo[].ticketTotalAmountSum	Long		—	累计门票金额
transferInfo[].checkNumSum	Long		—	累计刷卡次数
transferInfo[].paymentBank	SettlementCardDetailPayment		—	旅游卡结算明细付款信息
paymentBank.id	Long		`settlement_card_detail_payment`.`id`	id
paymentBank.settlementId	Long		`settlement_card_detail_payment`.`settlement_id`	结算单id
paymentBank.settlementMerchantId	Long		`settlement_card_detail_payment`.`settlement_merchant_id`	结算商户id（即开票方）
paymentBank.isInvoice	Boolean		`settlement_card_detail_payment`.`is_invoice`	是否开票
paymentBank.invoiceFiles	String		`settlement_card_detail_payment`.`invoice_files`	发票链接，逗号分隔
paymentBank.isPaid	Boolean		`settlement_card_detail_payment`.`is_paid`	是否打款
paymentBank.paymentProofFiles	String		`settlement_card_detail_payment`.`payment_proof_files`	付款凭证，逗号分隔
paymentBank.settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户名称
paymentBank.merchantFinance	String		`settlement_card_detail_payment`.`merchant_finance`	开户名称
paymentBank.merchantEbank	String		`settlement_card_detail_payment`.`merchant_ebank`	开户行
paymentBank.merchantEbankAccount	String		`settlement_card_detail_payment`.`merchant_ebank_account`	银行账号
paymentBank.createdTime	Date		`settlement_card_detail_payment`.`created_time`	创建时间
paymentBank.updatedTime	Date		`settlement_card_detail_payment`.`updated_time`	修改时间
paymentBank.paymentAmountActual	Long		`settlement_card_detail_payment`.`payment_amount_actual`	实际打款金额，单位为分
paymentBank.remark	String		`settlement_card_detail_payment`.`remark`	备注
invoiceFiles	List<InvoicePaymentResponse>		`settlement_card_detail_payment`.`invoice_files`	发票文件
invoiceFiles[].invoiceName	String		—	发票文件名称
invoiceFiles[].invoiceFile	String		—	发票文件url地址
proofFiles	List<ProofPaymentResponse>		—	付款凭证
proofFiles[].proofName	String		—	凭证文件名称
proofFiles[].proofFile	String		—	凭证文件url地址
settlementCardDetailSplit	List<SettlementCardDetailSplitListResponse>		—
settlementCardDetailSplit[].id	Long		`settlement_card_detail_payment`.`id`	id
settlementCardDetailSplit[].settlementId	Long		`settlement_card_detail_payment`.`settlement_id`	结算单id
settlementCardDetailSplit[].cardModelName	String		—	卡种名称
settlementCardDetailSplit[].settlementPeriod	String		—	结算起止时间
settlementCardDetailSplit[].sceneryName	String		`settlement_card_detail`.`scenery_name`	资源名称
settlementCardDetailSplit[].settlementWay	SettlementWay	1按刷卡次数2买断3分成4按分配金额统一计算5月度均衡分配计算	`settlement_card_detail`.`settlement_way`	结算方式(枚举:card.SettlementWay)
settlementCardDetailSplit[].sectionStartDate	Date		—	区间开始时间
settlementCardDetailSplit[].sectionEndDate	Date		—	区间结束时间
settlementCardDetailSplit[].sectionPrice	Long		—	区间门票价
settlementCardDetailSplit[].sectionCheckNum	Integer		—	区间刷卡次数
settlementCardDetailSplit[].sectionTicketTotalAmount	Long		—	区间门票价总计 <em>门票价总计=门票价乘以实际核销次数</em>
settlementCardDetailSplit[].sectionSettlementFactor	Double		—	区间结算系数
settlementCardDetailSplit[].sectionSettlementAmount	Long		—	区间结算金额
settlementCardDetailSplit[].settlementFactor	Double		`settlement_card_detail`.`settlement_factor`	结算系数
settlementCardDetailSplit[].settlementAmount	Long		`settlement_card_detail`.`settlement_amount`	结算金额，单位为分
settlementCardDetailSplit[].increaseAmount	Long		`settlement_card_detail`.`increase_amount`	增加金额，单位为分
settlementCardDetailSplit[].decreaseAmount	Long		`settlement_card_detail`.`decrease_amount`	扣减金额，单位为分
settlementCardDetailSplit[].settlementAmountActual	Long		`settlement_card_detail`.`settlement_amount_actual`	实际结算金额，单位为分
settlementCardDetailSplit[].settlementVerifyStatus	SettlementVerifyStatus	0待核对1已确认2已拒绝	`settlement_card_detail`.`settlement_verify_status`	结算明细核对状态(枚举:settlement.SettlementVerifyStatus)
settlementCardDetailSplit[].settlementMerchantId	Long		`settlement_card_detail_payment`.`settlement_merchant_id`	结算商户id（即开票方）
settlementCardDetailSplit[].settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户（即开票方）
settlementCardDetailSplit[].verifyUserId	Long		`settlement_card_detail`.`verify_user_id`	核对人id
settlementCardDetailSplit[].verifyUserName	String		—	核对人姓名
settlementCardDetailSplit[].verifyTime	Date		`settlement_card_detail`.`verify_time`	核对时间
settlementCardDetailSplit[].ticketTotalAmountSum	Long		—	累计刷卡次数
settlementCardDetailSplit[].paymentBank	SettlementCardDetailPayment		—	旅游卡结算明细付款信息
paymentBank.id	Long		`settlement_card_detail_payment`.`id`	id
paymentBank.settlementId	Long		`settlement_card_detail_payment`.`settlement_id`	结算单id
paymentBank.settlementMerchantId	Long		`settlement_card_detail_payment`.`settlement_merchant_id`	结算商户id（即开票方）
paymentBank.isInvoice	Boolean		`settlement_card_detail_payment`.`is_invoice`	是否开票
paymentBank.invoiceFiles	String		`settlement_card_detail_payment`.`invoice_files`	发票链接，逗号分隔
paymentBank.isPaid	Boolean		`settlement_card_detail_payment`.`is_paid`	是否打款
paymentBank.paymentProofFiles	String		`settlement_card_detail_payment`.`payment_proof_files`	付款凭证，逗号分隔
paymentBank.settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户名称
paymentBank.merchantFinance	String		`settlement_card_detail_payment`.`merchant_finance`	开户名称
paymentBank.merchantEbank	String		`settlement_card_detail_payment`.`merchant_ebank`	开户行
paymentBank.merchantEbankAccount	String		`settlement_card_detail_payment`.`merchant_ebank_account`	银行账号
paymentBank.createdTime	Date		`settlement_card_detail_payment`.`created_time`	创建时间
paymentBank.updatedTime	Date		`settlement_card_detail_payment`.`updated_time`	修改时间
paymentBank.paymentAmountActual	Long		`settlement_card_detail_payment`.`payment_amount_actual`	实际打款金额，单位为分
paymentBank.remark	String		`settlement_card_detail_payment`.`remark`	备注

示例

请求示例（自动生成，仅结构参考）

POST /settlement/invoiceGetPaymentProof

{
  "body": {
    "settlementId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "settlementMerchantName": "",
    "transferInfo": [
      {
        "id": 1,
        "settlementId": 1,
        "cardModelName": "",
        "settlementPeriod": "",
        "sceneryName": "",
        "settlementWay": "1",
        "ticketPriceInfo": [
          {
            "startDate": "2026-01-01 12:00:00",
            "endDate": "2026-01-01 12:00:00",
            "price": 0,
            "checkNum": 0,
            "ticketTotalAmount": 0,
            "settlementFactor": 0,
            "settlementAmount": 0
          }
        ],
        "settlementFactor": 0,
        "settlementAmount": 0,
        "increaseAmount": 0,
        "decreaseAmount": 0,
        "settlementAmountActual": 0,
        "settlementVerifyStatus": "0",
        "settlementMerchantId": 1,
        "settlementMerchantName": "",
        "verifyUserId": 1,
        "verifyUserName": "",
        "verifyTime": "2026-01-01 12:00:00",
        "ticketTotalAmountSum": 0,
        "checkNumSum": 0,
        "paymentBank": {
          "id": 1,
          "settlementId": 1,
          "settlementMerchantId": 1,
          "isInvoice": false,
          "invoiceFiles": "",
          "isPaid": false,
          "paymentProofFiles": "",
          "settlementMerchantName": "",
          "merchantFinance": "",
          "merchantEbank": "",
          "merchantEbankAccount": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00",
          "paymentAmountActual": 0,
          "remark": ""
        }
      }
    ],
    "invoiceFiles": [
      {
        "invoiceName": "",
        "invoiceFile": ""
      }
    ],
    "proofFiles": [
      {
        "proofName": "",
        "proofFile": ""
      }
    ],
    "settlementCardDetailSplit": [
      {
        "id": 1,
        "settlementId": 1,
        "cardModelName": "",
        "settlementPeriod": "",
        "sceneryName": "",
        "settlementWay": "1",
        "sectionStartDate": "2026-01-01 12:00:00",
        "sectionEndDate": "2026-01-01 12:00:00",
        "sectionPrice": 0,
        "sectionCheckNum": 0,
        "sectionTicketTotalAmount": 0,
        "sectionSettlementFactor": 0,
        "sectionSettlementAmount": 0,
        "settlementFactor": 0,
        "settlementAmount": 0,
        "increaseAmount": 0,
        "decreaseAmount": 0,
        "settlementAmountActual": 0,
        "settlementVerifyStatus": "0",
        "settlementMerchantId": 1,
        "settlementMerchantName": "",
        "verifyUserId": 1,
        "verifyUserName": "",
        "verifyTime": "2026-01-01 12:00:00",
        "ticketTotalAmountSum": 0,
        "paymentBank": {
          "id": 1,
          "settlementId": 1,
          "settlementMerchantId": 1,
          "isInvoice": false,
          "invoiceFiles": "",
          "isPaid": false,
          "paymentProofFiles": "",
          "settlementMerchantName": "",
          "merchantFinance": "",
          "merchantEbank": "",
          "merchantEbankAccount": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00",
          "paymentAmountActual": 0,
          "remark": ""
        }
      }
    ]
  }
}

处理逻辑

内联注释

根据结算单查询结算明细
反查结算商户包含的资源结算明细
设置参数
银行信息
转化对象

前端调用方

dscp-html-manage invoiceGetPaymentProof exact

POST /settlement/querySettlementCardDetailPaymentPage 在用管理后台 #

旅游卡结算商户的支付信息 - 打款列表（平台方） · SettlementCardDetailPaymentController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardDetailPaymentController#querySettlementCardDetailPaymentPage
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detail_payment

ControllerSettlementCardDetailPaymentController#querySettlementCardDetailPaymentPage

转换BeanUtils.map → SettlementCardDetailPaymentQuery

ServiceSettlementCardDetailPaymentService#queryPage （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#selectPage ⇒ 表 settlement_card_detail_payment

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/querySettlementCardDetailPaymentPage
uat	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardDetailPaymentPage
pro	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardDetailPaymentPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardDetailPaymentPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
settlementId	Long	是	必填	`settlement_card_detail_payment`.`settlement_id`	结算id
settlementMerchantName	String	否	可选(@MvcOptional)	`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户名称
isInvoice	Boolean	否	可选(@MvcOptional)	`settlement_card_detail_payment`.`is_invoice`	是否开票
isPaid	Boolean	否	可选(@MvcOptional)	`settlement_card_detail_payment`.`is_paid`	是否打款

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<SettlementCardDetailPaymentPageResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`settlement_card_detail_payment`.`id`	ID
settlementId	Long	`settlement_card_detail_payment`.`settlement_id`	结算单id
cardModelName	String	—	所属卡种
settlementPeriod	String	—	结算起止时间
settlementAmountActual	Long	—	结算金额
settlementMerchantId	Long	`settlement_card_detail_payment`.`settlement_merchant_id`	结算商户id（即开票方）
isPaid	Boolean	`settlement_card_detail_payment`.`is_paid`	是否打款
proofList	List<ProofPaymentResponse>	—	卡款凭证集合
proofList[].proofName	String	—	凭证文件名称
proofList[].proofFile	String	—	凭证文件url地址
isInvoice	Boolean	`settlement_card_detail_payment`.`is_invoice`	是否上传发票
invoiceList	List<InvoicePaymentResponse>	—	发票文件集合
invoiceList[].invoiceName	String	—	发票文件名称
invoiceList[].invoiceFile	String	—	发票文件url地址
settlementMerchantName	String	`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户名称
merchantFinance	String	`settlement_card_detail_payment`.`merchant_finance`	开户名称
merchantEbank	String	`settlement_card_detail_payment`.`merchant_ebank`	开户行
merchantEbankAccount	String	`settlement_card_detail_payment`.`merchant_ebank_account`	银行账号
paymentAmountActual	Long	`settlement_card_detail_payment`.`payment_amount_actual`	实际打款金额，单位为分
remark	String	`settlement_card_detail_payment`.`remark`	备注

示例

请求示例（自动生成，仅结构参考）

POST /settlement/querySettlementCardDetailPaymentPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "settlementId": 1,
    "settlementMerchantName": "",
    "isInvoice": false,
    "isPaid": false
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "settlementId": 1,
        "cardModelName": "",
        "settlementPeriod": "",
        "settlementAmountActual": 0,
        "settlementMerchantId": 1,
        "isPaid": false,
        "proofList": [
          {
            "proofName": "",
            "proofFile": ""
          }
        ],
        "isInvoice": false,
        "invoiceList": [
          {
            "invoiceName": "",
            "invoiceFile": ""
          }
        ],
        "settlementMerchantName": "",
        "merchantFinance": "",
        "merchantEbank": "",
        "merchantEbankAccount": "",
        "paymentAmountActual": 0,
        "remark": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（settlementCardDetailPaymentService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage querySettlementCardDetailPaymentPage exact

POST /settlement/sceneryGetPaymentInvoice 在用管理后台 #

旅游卡结算明细-查看发票信息(景区核对) · SettlementCardDetailPaymentController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardDetailPaymentController#sceneryGetPaymentInvoice
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detailsettlement_card_detail_payment

ControllerSettlementCardDetailPaymentController#sceneryGetPaymentInvoice

MapperSettlementCardDetailService.getMapper#queryList ⇒ 表 settlement_card_detail

ServiceSettlementCardDetailPaymentService#get （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#selectById ⇒ 表 settlement_card_detail_payment

ServiceSettlementCardDetailService#queryList （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#selectList ⇒ 表 settlement_card_detail

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

SessionUserService.getSessionUserMerchantCache.get

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/sceneryGetPaymentInvoice
uat	https://dscp-uat.hn12301.net/manage-api/settlement/sceneryGetPaymentInvoice
pro	https://dscp-uat.hn12301.net/manage-api/settlement/sceneryGetPaymentInvoice	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardDetailPaymentRequest

字段	类型	必填	取值/校验	表 / 列	说明
settlementId	Long	是	必填	`settlement_card_detail`.`settlement_id`	结算id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<SceneryPaymentResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	开票商户
transferInfo	List<SettlementCardDetailListResponse>		—
transferInfo[].id	Long		`settlement_card_detail`.`id`	id
transferInfo[].settlementId	Long		`settlement_card_detail`.`settlement_id`	结算单id
transferInfo[].cardModelName	String		—	卡种名称
transferInfo[].settlementPeriod	String		—	结算起止时间
transferInfo[].sceneryName	String		`settlement_card_detail`.`scenery_name`	资源名称
transferInfo[].settlementWay	SettlementWay	1按刷卡次数2买断3分成4按分配金额统一计算5月度均衡分配计算	`settlement_card_detail`.`settlement_way`	结算方式(枚举:card.SettlementWay)
transferInfo[].ticketPriceInfo	List<SettlementTicketPriceInfo>		`settlement_card_detail`.`ticket_price_info`	门票价格信息
ticketPriceInfo[].startDate	Date		—	开始时间
ticketPriceInfo[].endDate	Date		—	结束时间
ticketPriceInfo[].price	Long		—	门票价
ticketPriceInfo[].checkNum	Integer		—	刷卡次数
ticketPriceInfo[].ticketTotalAmount	Long		—	门票价总计 <em>门票价总计=门票价乘以实际核销次数</em>
ticketPriceInfo[].settlementFactor	Double		`settlement_card_detail`.`settlement_factor`	结算系数
ticketPriceInfo[].settlementAmount	Long		`settlement_card_detail`.`settlement_amount`	结算金额
transferInfo[].settlementFactor	Double		`settlement_card_detail`.`settlement_factor`	结算系数
transferInfo[].settlementAmount	Long		`settlement_card_detail`.`settlement_amount`	结算金额，单位为分
transferInfo[].increaseAmount	Long		`settlement_card_detail`.`increase_amount`	增加金额，单位为分
transferInfo[].decreaseAmount	Long		`settlement_card_detail`.`decrease_amount`	扣减金额，单位为分
transferInfo[].settlementAmountActual	Long		`settlement_card_detail`.`settlement_amount_actual`	实际结算金额，单位为分
transferInfo[].settlementVerifyStatus	SettlementVerifyStatus	0待核对1已确认2已拒绝	`settlement_card_detail`.`settlement_verify_status`	结算明细核对状态(枚举:settlement.SettlementVerifyStatus)
transferInfo[].settlementMerchantId	Long		`settlement_card_detail`.`settlement_merchant_id`	结算商户id（即开票方）
transferInfo[].settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户（即开票方）
transferInfo[].verifyUserId	Long		`settlement_card_detail`.`verify_user_id`	核对人id
transferInfo[].verifyUserName	String		—	核对人姓名
transferInfo[].verifyTime	Date		`settlement_card_detail`.`verify_time`	核对时间
transferInfo[].ticketTotalAmountSum	Long		—	累计门票金额
transferInfo[].checkNumSum	Long		—	累计刷卡次数
transferInfo[].paymentBank	SettlementCardDetailPayment		—	旅游卡结算明细付款信息
paymentBank.id	Long		`settlement_card_detail`.`id`	id
paymentBank.settlementId	Long		`settlement_card_detail`.`settlement_id`	结算单id
paymentBank.settlementMerchantId	Long		`settlement_card_detail`.`settlement_merchant_id`	结算商户id（即开票方）
paymentBank.isInvoice	Boolean		`settlement_card_detail`.`is_invoice`	是否开票
paymentBank.invoiceFiles	String		`settlement_card_detail_payment`.`invoice_files`	发票链接，逗号分隔
paymentBank.isPaid	Boolean		`settlement_card_detail`.`is_paid`	是否打款
paymentBank.paymentProofFiles	String		`settlement_card_detail_payment`.`payment_proof_files`	付款凭证，逗号分隔
paymentBank.settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户名称
paymentBank.merchantFinance	String		`settlement_card_detail_payment`.`merchant_finance`	开户名称
paymentBank.merchantEbank	String		`settlement_card_detail_payment`.`merchant_ebank`	开户行
paymentBank.merchantEbankAccount	String		`settlement_card_detail_payment`.`merchant_ebank_account`	银行账号
paymentBank.createdTime	Date		`settlement_card_detail`.`created_time`	创建时间
paymentBank.updatedTime	Date		`settlement_card_detail`.`updated_time`	修改时间
paymentBank.paymentAmountActual	Long		`settlement_card_detail_payment`.`payment_amount_actual`	实际打款金额，单位为分
paymentBank.remark	String		`settlement_card_detail_payment`.`remark`	备注
invoiceFiles	List<InvoicePaymentResponse>		`settlement_card_detail_payment`.`invoice_files`	发票文件
invoiceFiles[].invoiceName	String		—	发票文件名称
invoiceFiles[].invoiceFile	String		—	发票文件url地址
proofFiles	List<ProofPaymentResponse>		—	付款凭证
proofFiles[].proofName	String		—	凭证文件名称
proofFiles[].proofFile	String		—	凭证文件url地址
settlementCardDetailSplit	List<SettlementCardDetailSplitListResponse>		—
settlementCardDetailSplit[].id	Long		`settlement_card_detail`.`id`	id
settlementCardDetailSplit[].settlementId	Long		`settlement_card_detail`.`settlement_id`	结算单id
settlementCardDetailSplit[].cardModelName	String		—	卡种名称
settlementCardDetailSplit[].settlementPeriod	String		—	结算起止时间
settlementCardDetailSplit[].sceneryName	String		`settlement_card_detail`.`scenery_name`	资源名称
settlementCardDetailSplit[].settlementWay	SettlementWay	1按刷卡次数2买断3分成4按分配金额统一计算5月度均衡分配计算	`settlement_card_detail`.`settlement_way`	结算方式(枚举:card.SettlementWay)
settlementCardDetailSplit[].sectionStartDate	Date		—	区间开始时间
settlementCardDetailSplit[].sectionEndDate	Date		—	区间结束时间
settlementCardDetailSplit[].sectionPrice	Long		—	区间门票价
settlementCardDetailSplit[].sectionCheckNum	Integer		—	区间刷卡次数
settlementCardDetailSplit[].sectionTicketTotalAmount	Long		—	区间门票价总计 <em>门票价总计=门票价乘以实际核销次数</em>
settlementCardDetailSplit[].sectionSettlementFactor	Double		—	区间结算系数
settlementCardDetailSplit[].sectionSettlementAmount	Long		—	区间结算金额
settlementCardDetailSplit[].settlementFactor	Double		`settlement_card_detail`.`settlement_factor`	结算系数
settlementCardDetailSplit[].settlementAmount	Long		`settlement_card_detail`.`settlement_amount`	结算金额，单位为分
settlementCardDetailSplit[].increaseAmount	Long		`settlement_card_detail`.`increase_amount`	增加金额，单位为分
settlementCardDetailSplit[].decreaseAmount	Long		`settlement_card_detail`.`decrease_amount`	扣减金额，单位为分
settlementCardDetailSplit[].settlementAmountActual	Long		`settlement_card_detail`.`settlement_amount_actual`	实际结算金额，单位为分
settlementCardDetailSplit[].settlementVerifyStatus	SettlementVerifyStatus	0待核对1已确认2已拒绝	`settlement_card_detail`.`settlement_verify_status`	结算明细核对状态(枚举:settlement.SettlementVerifyStatus)
settlementCardDetailSplit[].settlementMerchantId	Long		`settlement_card_detail`.`settlement_merchant_id`	结算商户id（即开票方）
settlementCardDetailSplit[].settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户（即开票方）
settlementCardDetailSplit[].verifyUserId	Long		`settlement_card_detail`.`verify_user_id`	核对人id
settlementCardDetailSplit[].verifyUserName	String		—	核对人姓名
settlementCardDetailSplit[].verifyTime	Date		`settlement_card_detail`.`verify_time`	核对时间
settlementCardDetailSplit[].ticketTotalAmountSum	Long		—	累计刷卡次数
settlementCardDetailSplit[].paymentBank	SettlementCardDetailPayment		—	旅游卡结算明细付款信息
paymentBank.id	Long		`settlement_card_detail`.`id`	id
paymentBank.settlementId	Long		`settlement_card_detail`.`settlement_id`	结算单id
paymentBank.settlementMerchantId	Long		`settlement_card_detail`.`settlement_merchant_id`	结算商户id（即开票方）
paymentBank.isInvoice	Boolean		`settlement_card_detail`.`is_invoice`	是否开票
paymentBank.invoiceFiles	String		`settlement_card_detail_payment`.`invoice_files`	发票链接，逗号分隔
paymentBank.isPaid	Boolean		`settlement_card_detail`.`is_paid`	是否打款
paymentBank.paymentProofFiles	String		`settlement_card_detail_payment`.`payment_proof_files`	付款凭证，逗号分隔
paymentBank.settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户名称
paymentBank.merchantFinance	String		`settlement_card_detail_payment`.`merchant_finance`	开户名称
paymentBank.merchantEbank	String		`settlement_card_detail_payment`.`merchant_ebank`	开户行
paymentBank.merchantEbankAccount	String		`settlement_card_detail_payment`.`merchant_ebank_account`	银行账号
paymentBank.createdTime	Date		`settlement_card_detail`.`created_time`	创建时间
paymentBank.updatedTime	Date		`settlement_card_detail`.`updated_time`	修改时间
paymentBank.paymentAmountActual	Long		`settlement_card_detail_payment`.`payment_amount_actual`	实际打款金额，单位为分
paymentBank.remark	String		`settlement_card_detail_payment`.`remark`	备注

示例

请求示例（自动生成，仅结构参考）

POST /settlement/sceneryGetPaymentInvoice

{
  "body": {
    "settlementId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "settlementMerchantName": "",
      "transferInfo": [
        {
          "id": 1,
          "settlementId": 1,
          "cardModelName": "",
          "settlementPeriod": "",
          "sceneryName": "",
          "settlementWay": "1",
          "ticketPriceInfo": [
            {
              "startDate": "2026-01-01 12:00:00",
              "endDate": "2026-01-01 12:00:00",
              "price": 0,
              "checkNum": 0,
              "ticketTotalAmount": 0,
              "settlementFactor": 0,
              "settlementAmount": 0
            }
          ],
          "settlementFactor": 0,
          "settlementAmount": 0,
          "increaseAmount": 0,
          "decreaseAmount": 0,
          "settlementAmountActual": 0,
          "settlementVerifyStatus": "0",
          "settlementMerchantId": 1,
          "settlementMerchantName": "",
          "verifyUserId": 1,
          "verifyUserName": "",
          "verifyTime": "2026-01-01 12:00:00",
          "ticketTotalAmountSum": 0,
          "checkNumSum": 0,
          "paymentBank": {
            "id": 1,
            "settlementId": 1,
            "settlementMerchantId": 1,
            "isInvoice": false,
            "invoiceFiles": "",
            "isPaid": false,
            "paymentProofFiles": "",
            "settlementMerchantName": "",
            "merchantFinance": "",
            "merchantEbank": "",
            "merchantEbankAccount": "",
            "createdTime": "2026-01-01 12:00:00",
            "updatedTime": "2026-01-01 12:00:00",
            "paymentAmountActual": 0,
            "remark": ""
          }
        }
      ],
      "invoiceFiles": [
        {
          "invoiceName": "",
          "invoiceFile": ""
        }
      ],
      "proofFiles": [
        {
          "proofName": "",
          "proofFile": ""
        }
      ],
      "settlementCardDetailSplit": [
        {
          "id": 1,
          "settlementId": 1,
          "cardModelName": "",
          "settlementPeriod": "",
          "sceneryName": "",
          "settlementWay": "1",
          "sectionStartDate": "2026-01-01 12:00:00",
          "sectionEndDate": "2026-01-01 12:00:00",
          "sectionPrice": 0,
          "sectionCheckNum": 0,
          "sectionTicketTotalAmount": 0,
          "sectionSettlementFactor": 0,
          "sectionSettlementAmount": 0,
          "settlementFactor": 0,
          "settlementAmount": 0,
          "increaseAmount": 0,
          "decreaseAmount": 0,
          "settlementAmountActual": 0,
          "settlementVerifyStatus": "0",
          "settlementMerchantId": 1,
          "settlementMerchantName": "",
          "verifyUserId": 1,
          "verifyUserName": "",
          "verifyTime": "2026-01-01 12:00:00",
          "ticketTotalAmountSum": 0,
          "paymentBank": {
            "id": 1,
            "settlementId": 1,
            "settlementMerchantId": 1,
            "isInvoice": false,
            "invoiceFiles": "",
            "isPaid": false,
            "paymentProofFiles": "",
            "settlementMerchantName": "",
            "merchantFinance": "",
            "merchantEbank": "",
            "merchantEbankAccount": "",
            "createdTime": "2026-01-01 12:00:00",
            "updatedTime": "2026-01-01 12:00:00",
            "paymentAmountActual": 0,
            "remark": ""
          }
        }
      ]
    }
  ]
}

处理逻辑

逻辑摘要查询详情（sessionService.getSessionUser）；查询详情（settlementCardDetailService.getMapper）；查询详情（settlementCardDetailPaymentService.get）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

根据结算单查询结算明细
反查结算商户包含的资源结算明细
设置参数
银行信息
转化对象

前端调用方

dscp-html-manage sceneryGetPaymentInvoice exact

POST /settlement/sceneryGetPaymentProof 在用管理后台 #

旅游卡结算明细-查看付款凭证信息(景区核对) · SettlementCardDetailPaymentController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardDetailPaymentController#sceneryGetPaymentProof
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detailsettlement_card_detail_payment

ControllerSettlementCardDetailPaymentController#sceneryGetPaymentProof

MapperSettlementCardDetailService.getMapper#queryList ⇒ 表 settlement_card_detail

ServiceSettlementCardDetailPaymentService#get （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#selectById ⇒ 表 settlement_card_detail_payment

ServiceSettlementCardDetailService#queryList （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#selectList ⇒ 表 settlement_card_detail

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

SessionUserService.getSessionUserMerchantCache.get

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/sceneryGetPaymentProof
uat	https://dscp-uat.hn12301.net/manage-api/settlement/sceneryGetPaymentProof
pro	https://dscp-uat.hn12301.net/manage-api/settlement/sceneryGetPaymentProof	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardDetailPaymentRequest

字段	类型	必填	取值/校验	表 / 列	说明
settlementId	Long	是	必填	`settlement_card_detail`.`settlement_id`	结算id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<SceneryPaymentResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	开票商户
transferInfo	List<SettlementCardDetailListResponse>		—
transferInfo[].id	Long		`settlement_card_detail`.`id`	id
transferInfo[].settlementId	Long		`settlement_card_detail`.`settlement_id`	结算单id
transferInfo[].cardModelName	String		—	卡种名称
transferInfo[].settlementPeriod	String		—	结算起止时间
transferInfo[].sceneryName	String		`settlement_card_detail`.`scenery_name`	资源名称
transferInfo[].settlementWay	SettlementWay	1按刷卡次数2买断3分成4按分配金额统一计算5月度均衡分配计算	`settlement_card_detail`.`settlement_way`	结算方式(枚举:card.SettlementWay)
transferInfo[].ticketPriceInfo	List<SettlementTicketPriceInfo>		`settlement_card_detail`.`ticket_price_info`	门票价格信息
ticketPriceInfo[].startDate	Date		—	开始时间
ticketPriceInfo[].endDate	Date		—	结束时间
ticketPriceInfo[].price	Long		—	门票价
ticketPriceInfo[].checkNum	Integer		—	刷卡次数
ticketPriceInfo[].ticketTotalAmount	Long		—	门票价总计 <em>门票价总计=门票价乘以实际核销次数</em>
ticketPriceInfo[].settlementFactor	Double		`settlement_card_detail`.`settlement_factor`	结算系数
ticketPriceInfo[].settlementAmount	Long		`settlement_card_detail`.`settlement_amount`	结算金额
transferInfo[].settlementFactor	Double		`settlement_card_detail`.`settlement_factor`	结算系数
transferInfo[].settlementAmount	Long		`settlement_card_detail`.`settlement_amount`	结算金额，单位为分
transferInfo[].increaseAmount	Long		`settlement_card_detail`.`increase_amount`	增加金额，单位为分
transferInfo[].decreaseAmount	Long		`settlement_card_detail`.`decrease_amount`	扣减金额，单位为分
transferInfo[].settlementAmountActual	Long		`settlement_card_detail`.`settlement_amount_actual`	实际结算金额，单位为分
transferInfo[].settlementVerifyStatus	SettlementVerifyStatus	0待核对1已确认2已拒绝	`settlement_card_detail`.`settlement_verify_status`	结算明细核对状态(枚举:settlement.SettlementVerifyStatus)
transferInfo[].settlementMerchantId	Long		`settlement_card_detail`.`settlement_merchant_id`	结算商户id（即开票方）
transferInfo[].settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户（即开票方）
transferInfo[].verifyUserId	Long		`settlement_card_detail`.`verify_user_id`	核对人id
transferInfo[].verifyUserName	String		—	核对人姓名
transferInfo[].verifyTime	Date		`settlement_card_detail`.`verify_time`	核对时间
transferInfo[].ticketTotalAmountSum	Long		—	累计门票金额
transferInfo[].checkNumSum	Long		—	累计刷卡次数
transferInfo[].paymentBank	SettlementCardDetailPayment		—	旅游卡结算明细付款信息
paymentBank.id	Long		`settlement_card_detail`.`id`	id
paymentBank.settlementId	Long		`settlement_card_detail`.`settlement_id`	结算单id
paymentBank.settlementMerchantId	Long		`settlement_card_detail`.`settlement_merchant_id`	结算商户id（即开票方）
paymentBank.isInvoice	Boolean		`settlement_card_detail`.`is_invoice`	是否开票
paymentBank.invoiceFiles	String		`settlement_card_detail_payment`.`invoice_files`	发票链接，逗号分隔
paymentBank.isPaid	Boolean		`settlement_card_detail`.`is_paid`	是否打款
paymentBank.paymentProofFiles	String		`settlement_card_detail_payment`.`payment_proof_files`	付款凭证，逗号分隔
paymentBank.settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户名称
paymentBank.merchantFinance	String		`settlement_card_detail_payment`.`merchant_finance`	开户名称
paymentBank.merchantEbank	String		`settlement_card_detail_payment`.`merchant_ebank`	开户行
paymentBank.merchantEbankAccount	String		`settlement_card_detail_payment`.`merchant_ebank_account`	银行账号
paymentBank.createdTime	Date		`settlement_card_detail`.`created_time`	创建时间
paymentBank.updatedTime	Date		`settlement_card_detail`.`updated_time`	修改时间
paymentBank.paymentAmountActual	Long		`settlement_card_detail_payment`.`payment_amount_actual`	实际打款金额，单位为分
paymentBank.remark	String		`settlement_card_detail_payment`.`remark`	备注
invoiceFiles	List<InvoicePaymentResponse>		`settlement_card_detail_payment`.`invoice_files`	发票文件
invoiceFiles[].invoiceName	String		—	发票文件名称
invoiceFiles[].invoiceFile	String		—	发票文件url地址
proofFiles	List<ProofPaymentResponse>		—	付款凭证
proofFiles[].proofName	String		—	凭证文件名称
proofFiles[].proofFile	String		—	凭证文件url地址
settlementCardDetailSplit	List<SettlementCardDetailSplitListResponse>		—
settlementCardDetailSplit[].id	Long		`settlement_card_detail`.`id`	id
settlementCardDetailSplit[].settlementId	Long		`settlement_card_detail`.`settlement_id`	结算单id
settlementCardDetailSplit[].cardModelName	String		—	卡种名称
settlementCardDetailSplit[].settlementPeriod	String		—	结算起止时间
settlementCardDetailSplit[].sceneryName	String		`settlement_card_detail`.`scenery_name`	资源名称
settlementCardDetailSplit[].settlementWay	SettlementWay	1按刷卡次数2买断3分成4按分配金额统一计算5月度均衡分配计算	`settlement_card_detail`.`settlement_way`	结算方式(枚举:card.SettlementWay)
settlementCardDetailSplit[].sectionStartDate	Date		—	区间开始时间
settlementCardDetailSplit[].sectionEndDate	Date		—	区间结束时间
settlementCardDetailSplit[].sectionPrice	Long		—	区间门票价
settlementCardDetailSplit[].sectionCheckNum	Integer		—	区间刷卡次数
settlementCardDetailSplit[].sectionTicketTotalAmount	Long		—	区间门票价总计 <em>门票价总计=门票价乘以实际核销次数</em>
settlementCardDetailSplit[].sectionSettlementFactor	Double		—	区间结算系数
settlementCardDetailSplit[].sectionSettlementAmount	Long		—	区间结算金额
settlementCardDetailSplit[].settlementFactor	Double		`settlement_card_detail`.`settlement_factor`	结算系数
settlementCardDetailSplit[].settlementAmount	Long		`settlement_card_detail`.`settlement_amount`	结算金额，单位为分
settlementCardDetailSplit[].increaseAmount	Long		`settlement_card_detail`.`increase_amount`	增加金额，单位为分
settlementCardDetailSplit[].decreaseAmount	Long		`settlement_card_detail`.`decrease_amount`	扣减金额，单位为分
settlementCardDetailSplit[].settlementAmountActual	Long		`settlement_card_detail`.`settlement_amount_actual`	实际结算金额，单位为分
settlementCardDetailSplit[].settlementVerifyStatus	SettlementVerifyStatus	0待核对1已确认2已拒绝	`settlement_card_detail`.`settlement_verify_status`	结算明细核对状态(枚举:settlement.SettlementVerifyStatus)
settlementCardDetailSplit[].settlementMerchantId	Long		`settlement_card_detail`.`settlement_merchant_id`	结算商户id（即开票方）
settlementCardDetailSplit[].settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户（即开票方）
settlementCardDetailSplit[].verifyUserId	Long		`settlement_card_detail`.`verify_user_id`	核对人id
settlementCardDetailSplit[].verifyUserName	String		—	核对人姓名
settlementCardDetailSplit[].verifyTime	Date		`settlement_card_detail`.`verify_time`	核对时间
settlementCardDetailSplit[].ticketTotalAmountSum	Long		—	累计刷卡次数
settlementCardDetailSplit[].paymentBank	SettlementCardDetailPayment		—	旅游卡结算明细付款信息
paymentBank.id	Long		`settlement_card_detail`.`id`	id
paymentBank.settlementId	Long		`settlement_card_detail`.`settlement_id`	结算单id
paymentBank.settlementMerchantId	Long		`settlement_card_detail`.`settlement_merchant_id`	结算商户id（即开票方）
paymentBank.isInvoice	Boolean		`settlement_card_detail`.`is_invoice`	是否开票
paymentBank.invoiceFiles	String		`settlement_card_detail_payment`.`invoice_files`	发票链接，逗号分隔
paymentBank.isPaid	Boolean		`settlement_card_detail`.`is_paid`	是否打款
paymentBank.paymentProofFiles	String		`settlement_card_detail_payment`.`payment_proof_files`	付款凭证，逗号分隔
paymentBank.settlementMerchantName	String		`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户名称
paymentBank.merchantFinance	String		`settlement_card_detail_payment`.`merchant_finance`	开户名称
paymentBank.merchantEbank	String		`settlement_card_detail_payment`.`merchant_ebank`	开户行
paymentBank.merchantEbankAccount	String		`settlement_card_detail_payment`.`merchant_ebank_account`	银行账号
paymentBank.createdTime	Date		`settlement_card_detail`.`created_time`	创建时间
paymentBank.updatedTime	Date		`settlement_card_detail`.`updated_time`	修改时间
paymentBank.paymentAmountActual	Long		`settlement_card_detail_payment`.`payment_amount_actual`	实际打款金额，单位为分
paymentBank.remark	String		`settlement_card_detail_payment`.`remark`	备注

示例

请求示例（自动生成，仅结构参考）

POST /settlement/sceneryGetPaymentProof

{
  "body": {
    "settlementId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "settlementMerchantName": "",
      "transferInfo": [
        {
          "id": 1,
          "settlementId": 1,
          "cardModelName": "",
          "settlementPeriod": "",
          "sceneryName": "",
          "settlementWay": "1",
          "ticketPriceInfo": [
            {
              "startDate": "2026-01-01 12:00:00",
              "endDate": "2026-01-01 12:00:00",
              "price": 0,
              "checkNum": 0,
              "ticketTotalAmount": 0,
              "settlementFactor": 0,
              "settlementAmount": 0
            }
          ],
          "settlementFactor": 0,
          "settlementAmount": 0,
          "increaseAmount": 0,
          "decreaseAmount": 0,
          "settlementAmountActual": 0,
          "settlementVerifyStatus": "0",
          "settlementMerchantId": 1,
          "settlementMerchantName": "",
          "verifyUserId": 1,
          "verifyUserName": "",
          "verifyTime": "2026-01-01 12:00:00",
          "ticketTotalAmountSum": 0,
          "checkNumSum": 0,
          "paymentBank": {
            "id": 1,
            "settlementId": 1,
            "settlementMerchantId": 1,
            "isInvoice": false,
            "invoiceFiles": "",
            "isPaid": false,
            "paymentProofFiles": "",
            "settlementMerchantName": "",
            "merchantFinance": "",
            "merchantEbank": "",
            "merchantEbankAccount": "",
            "createdTime": "2026-01-01 12:00:00",
            "updatedTime": "2026-01-01 12:00:00",
            "paymentAmountActual": 0,
            "remark": ""
          }
        }
      ],
      "invoiceFiles": [
        {
          "invoiceName": "",
          "invoiceFile": ""
        }
      ],
      "proofFiles": [
        {
          "proofName": "",
          "proofFile": ""
        }
      ],
      "settlementCardDetailSplit": [
        {
          "id": 1,
          "settlementId": 1,
          "cardModelName": "",
          "settlementPeriod": "",
          "sceneryName": "",
          "settlementWay": "1",
          "sectionStartDate": "2026-01-01 12:00:00",
          "sectionEndDate": "2026-01-01 12:00:00",
          "sectionPrice": 0,
          "sectionCheckNum": 0,
          "sectionTicketTotalAmount": 0,
          "sectionSettlementFactor": 0,
          "sectionSettlementAmount": 0,
          "settlementFactor": 0,
          "settlementAmount": 0,
          "increaseAmount": 0,
          "decreaseAmount": 0,
          "settlementAmountActual": 0,
          "settlementVerifyStatus": "0",
          "settlementMerchantId": 1,
          "settlementMerchantName": "",
          "verifyUserId": 1,
          "verifyUserName": "",
          "verifyTime": "2026-01-01 12:00:00",
          "ticketTotalAmountSum": 0,
          "paymentBank": {
            "id": 1,
            "settlementId": 1,
            "settlementMerchantId": 1,
            "isInvoice": false,
            "invoiceFiles": "",
            "isPaid": false,
            "paymentProofFiles": "",
            "settlementMerchantName": "",
            "merchantFinance": "",
            "merchantEbank": "",
            "merchantEbankAccount": "",
            "createdTime": "2026-01-01 12:00:00",
            "updatedTime": "2026-01-01 12:00:00",
            "paymentAmountActual": 0,
            "remark": ""
          }
        }
      ]
    }
  ]
}

处理逻辑

内联注释

根据结算单查询结算明细
反查结算商户包含的资源结算明细
设置参数
银行信息
转化对象

前端调用方

dscp-html-manage sceneryGetPaymentProof exact

POST /settlement/uploadProof 在用管理后台 #

上传打款凭证 · SettlementCardDetailPaymentController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardDetailPaymentController#uploadProof
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_detail_paymentsettlement_card_detailsettlement_cardsettlement_card_log

ControllerSettlementCardDetailPaymentController#uploadProof

ServiceSettlementCardDetailPaymentService#get （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#selectById ⇒ 表 settlement_card_detail_payment

ServiceSettlementCardDetailPaymentService#update （SettlementCardDetailPaymentServiceImpl）

MapperSettlementCardDetailPaymentMapper#updateById ⇒ 表 settlement_card_detail_payment

ServiceSettlementCardDetailService#queryList （SettlementCardDetailServiceImpl）

MapperSettlementCardDetailMapper#selectList ⇒ 表 settlement_card_detail

ServiceSettlementCardService#update （SettlementCardServiceImpl）

MapperSettlementCardMapper#updateById ⇒ 表 settlement_card

ServiceSettlementCardLogService#add （SettlementCardLogServiceImpl）

MapperSettlementCardLogMapper#insert ⇒ 表 settlement_card_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 5

ChaosTransactionTemplate.executeSettlementCardDetailService.updateListSessionUserService.getSessionUserMerchantCache.getSessionUserService.getSessionId

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/uploadProof
uat	https://dscp-uat.hn12301.net/manage-api/settlement/uploadProof
pro	https://dscp-uat.hn12301.net/manage-api/settlement/uploadProof	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementUploadInvoiceRequest

字段	类型	必填	取值/校验	表 / 列	说明
settlementId	Long	是	必填	`settlement_card_detail_payment`.`settlement_id`	结算单id
settlementMerchantId	Long	是	必填	`settlement_card_detail_payment`.`settlement_merchant_id`	结算商户id（即开票方）
settlementMerchantName	String	是	必填	`settlement_card_detail_payment`.`settlement_merchant_name`	结算商户名称
merchantFinance	String	是	必填	`settlement_card_detail_payment`.`merchant_finance`	开户名称
merchantEbank	String	是	必填	`settlement_card_detail_payment`.`merchant_ebank`	开户行
merchantEbankAccount	String	是	必填	`settlement_card_detail_payment`.`merchant_ebank_account`	银行账号
paymentAmountActual	Long			`settlement_card_detail_payment`.`payment_amount_actual`	实际打款金额，单位为分
remark	String			`settlement_card_detail_payment`.`remark`	备注
invoiceFiles	List<String>	否	可选(@MvcOptional)	`settlement_card_detail_payment`.`invoice_files`	发票文件列表
paymentProofFiles	List<String>	否	可选(@MvcOptional)	`settlement_card_detail_payment`.`payment_proof_files`	付款凭证，逗号分隔

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/uploadProof

{
  "body": {
    "settlementId": 1,
    "settlementMerchantId": 1,
    "settlementMerchantName": "",
    "merchantFinance": "",
    "merchantEbank": "",
    "merchantEbankAccount": "",
    "paymentAmountActual": 0,
    "remark": "",
    "invoiceFiles": "",
    "paymentProofFiles": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志settlement / 上传打款凭证

逻辑摘要查询详情（settlementCardDetailPaymentService.get）；调用 execute（newTransactionTemplate.execute）；更新（settlementCardDetailPaymentService.update）

内联注释

1.上传凭证文件
2.修改结算单明细表上传凭证状态
3.查询结算单所有结算明细，判断是否已全部上传凭证
修改结算单状态为已完成
回滚事务
处理异常

前端调用方

dscp-html-manage uploadProof exact

SettlementCardLogController 1/6 在用

POST /settlement/addSettlementCardLog 未使用管理后台 #

旅游卡结算单-新增 · SettlementCardLogController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardLogController#addSettlementCardLog
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_log

ControllerSettlementCardLogController#addSettlementCardLog

转换BeanUtils.map → SettlementCardLog ⇒ 表 settlement_card_log

ServiceSettlementCardLogService#add （SettlementCardLogServiceImpl）

MapperSettlementCardLogMapper#insert ⇒ 表 settlement_card_log

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/addSettlementCardLog
uat	https://dscp-uat.hn12301.net/manage-api/settlement/addSettlementCardLog
pro	https://dscp-uat.hn12301.net/manage-api/settlement/addSettlementCardLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardLogAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/addSettlementCardLog

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志settlement / 新增结算日志

逻辑摘要新增（settlementCardLogService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /settlement/deleteSettlementCardLog 未使用管理后台 #

旅游卡结算单-删除 · SettlementCardLogController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardLogController#deleteSettlementCardLog
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_log

ControllerSettlementCardLogController#deleteSettlementCardLog

ServiceSettlementCardLogService#delete （SettlementCardLogServiceImpl）

MapperSettlementCardLogMapper#deleteById ⇒ 表 settlement_card_log

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/deleteSettlementCardLog
uat	https://dscp-uat.hn12301.net/manage-api/settlement/deleteSettlementCardLog
pro	https://dscp-uat.hn12301.net/manage-api/settlement/deleteSettlementCardLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`settlement_card_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/deleteSettlementCardLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志settlement / 删除结算日志

逻辑摘要删除（settlementCardLogService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /settlement/getSettlementCardLog 未使用管理后台 #

旅游卡结算单-详情 · SettlementCardLogController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardLogController#getSettlementCardLog
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_log

ControllerSettlementCardLogController#getSettlementCardLog

ServiceSettlementCardLogService#get （SettlementCardLogServiceImpl）

MapperSettlementCardLogMapper#selectById ⇒ 表 settlement_card_log

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/getSettlementCardLog
uat	https://dscp-uat.hn12301.net/manage-api/settlement/getSettlementCardLog
pro	https://dscp-uat.hn12301.net/manage-api/settlement/getSettlementCardLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`settlement_card_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　SettlementCardLogResponse　（object）

字段	类型	表 / 列	说明
id	Long	`settlement_card_log`.`id`	id
settlementId	Long	`settlement_card_log`.`settlement_id`	结算Id
merchantId	Long	`settlement_card_log`.`merchant_id`	所属商户
merchantName	String	—	所属商户
shopId	Long	`settlement_card_log`.`shop_id`	所属商铺
shopName	String	—	所属商铺
operatorIp	String	`settlement_card_log`.`operator_ip`	操作人ip
operatorContent	String	`settlement_card_log`.`operator_content`	操作内容
createdBy	Long	`settlement_card_log`.`created_by`	创建人(Inject:AuthId)
createdName	String	—	创建人(Inject:AuthId)
createdTime	Date	`settlement_card_log`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /settlement/getSettlementCardLog

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "settlementId": 1,
    "merchantId": 1,
    "merchantName": "",
    "shopId": 1,
    "shopName": "",
    "operatorIp": "",
    "operatorContent": "",
    "createdBy": 0,
    "createdName": "",
    "createdTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（settlementCardLogService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /settlement/querySettlementCardLogList 未使用管理后台 #

旅游卡结算单-列表查询 · SettlementCardLogController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardLogController#querySettlementCardLogList
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_log

ControllerSettlementCardLogController#querySettlementCardLogList

转换BeanUtils.map → SettlementCardLogQuery

ServiceSettlementCardLogService#queryList （SettlementCardLogServiceImpl）

MapperSettlementCardLogMapper#selectList ⇒ 表 settlement_card_log

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/querySettlementCardLogList
uat	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardLogList
pro	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardLogList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardLogListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<SettlementCardLogResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`settlement_card_log`.`id`	id
settlementId	Long	`settlement_card_log`.`settlement_id`	结算Id
merchantId	Long	`settlement_card_log`.`merchant_id`	所属商户
merchantName	String	—	所属商户
shopId	Long	`settlement_card_log`.`shop_id`	所属商铺
shopName	String	—	所属商铺
operatorIp	String	`settlement_card_log`.`operator_ip`	操作人ip
operatorContent	String	`settlement_card_log`.`operator_content`	操作内容
createdBy	Long	`settlement_card_log`.`created_by`	创建人(Inject:AuthId)
createdName	String	—	创建人(Inject:AuthId)
createdTime	Date	`settlement_card_log`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /settlement/querySettlementCardLogList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "settlementId": 1,
      "merchantId": 1,
      "merchantName": "",
      "shopId": 1,
      "shopName": "",
      "operatorIp": "",
      "operatorContent": "",
      "createdBy": 0,
      "createdName": "",
      "createdTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（settlementCardLogService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /settlement/querySettlementCardLogPage 在用管理后台 #

旅游卡结算单-分页查询 · SettlementCardLogController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardLogController#querySettlementCardLogPage
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_log

ControllerSettlementCardLogController#querySettlementCardLogPage

转换BeanUtils.map → SettlementCardLogQuery

ServiceSettlementCardLogService#queryPage （SettlementCardLogServiceImpl）

MapperSettlementCardLogMapper#selectPage ⇒ 表 settlement_card_log

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/querySettlementCardLogPage
uat	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardLogPage
pro	https://dscp-uat.hn12301.net/manage-api/settlement/querySettlementCardLogPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardLogPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字
settlementId	Long			`settlement_card_log`.`settlement_id`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<SettlementCardLogResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`settlement_card_log`.`id`	id
settlementId	Long	`settlement_card_log`.`settlement_id`	结算Id
merchantId	Long	`settlement_card_log`.`merchant_id`	所属商户
merchantName	String	—	所属商户
shopId	Long	`settlement_card_log`.`shop_id`	所属商铺
shopName	String	—	所属商铺
operatorIp	String	`settlement_card_log`.`operator_ip`	操作人ip
operatorContent	String	`settlement_card_log`.`operator_content`	操作内容
createdBy	Long	`settlement_card_log`.`created_by`	创建人(Inject:AuthId)
createdName	String	—	创建人(Inject:AuthId)
createdTime	Date	`settlement_card_log`.`created_time`	创建时间

示例

请求示例（自动生成，仅结构参考）

POST /settlement/querySettlementCardLogPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": "",
    "settlementId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "settlementId": 1,
        "merchantId": 1,
        "merchantName": "",
        "shopId": 1,
        "shopName": "",
        "operatorIp": "",
        "operatorContent": "",
        "createdBy": 0,
        "createdName": "",
        "createdTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（settlementCardLogService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage querySettlementCardLogPage exact

POST /settlement/updateSettlementCardLog 未使用管理后台 #

旅游卡结算单-更新 · SettlementCardLogController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementCardLogController#updateSettlementCardLog
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表settlement_card_log

ControllerSettlementCardLogController#updateSettlementCardLog

转换BeanUtils.map → SettlementCardLog ⇒ 表 settlement_card_log

ServiceSettlementCardLogService#update （SettlementCardLogServiceImpl）

MapperSettlementCardLogMapper#updateById ⇒ 表 settlement_card_log

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/updateSettlementCardLog
uat	https://dscp-uat.hn12301.net/manage-api/settlement/updateSettlementCardLog
pro	https://dscp-uat.hn12301.net/manage-api/settlement/updateSettlementCardLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementCardLogUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`settlement_card_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/updateSettlementCardLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志settlement / 更新结算日志

逻辑摘要更新（settlementCardLogService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

SettlementOldCardController 0/3 在用

POST /settlement/exportOldCardSettlement 未使用管理后台 #

导出结算数据 · SettlementOldCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementOldCardController#exportSettlement
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerSettlementOldCardController#exportSettlement

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

SettlementOldCardService.exportSettlement

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/exportOldCardSettlement
uat	https://dscp-uat.hn12301.net/manage-api/settlement/exportOldCardSettlement
pro	https://dscp-uat.hn12301.net/manage-api/settlement/exportOldCardSettlement	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HttpServletResponse

请求体类型：HttpServletResponse（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /settlement/exportOldCardSettlement

响应示例

（void，无响应体）

处理逻辑

逻辑摘要调用 exportSettlement（settlementOldCardService.exportSettlement）

内联注释

xuchao: 先写入内存缓冲区，确保Excel数据完整
设置响应头后一次性输出

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /settlement/oldCardModels 未使用管理后台 #

获取卡种列表 · SettlementOldCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementOldCardController#getCardModels
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_model

ControllerSettlementOldCardController#getCardModels

ServiceSettlementOldCardService#getCardModels （SettlementOldCardServiceImpl）

MapperCardModelMapper#selectList ⇒ 表 card_model

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/oldCardModels
uat	https://dscp-uat.hn12301.net/manage-api/settlement/oldCardModels
pro	https://dscp-uat.hn12301.net/manage-api/settlement/oldCardModels	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OldCardModelDTO>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
value	Long	—	卡种ID
label	String	—	卡种名称

示例

请求示例（自动生成，仅结构参考）

POST /settlement/oldCardModels

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "value": 0,
      "label": ""
    }
  ]
}

处理逻辑

逻辑摘要查询详情（settlementOldCardService.getCardModels）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /settlement/queryOldCardSettlement 未使用管理后台 #

查询结算数据 · SettlementOldCardController

基本信息

控制器	com.jxxx.dscp.api.controller.settlement.SettlementOldCardController#querySettlement
所属模块	结算 `settlement`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_model

ControllerSettlementOldCardController#querySettlement

ServiceSettlementOldCardService#querySettlement （SettlementOldCardServiceImpl）

MapperCardModelMapper#selectBatchIds ⇒ 表 card_model

MapperSettlementOldCardMapper#querySettlementData

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/settlement/queryOldCardSettlement
uat	https://dscp-uat.hn12301.net/manage-api/settlement/queryOldCardSettlement
pro	https://dscp-uat.hn12301.net/manage-api/settlement/queryOldCardSettlement	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SettlementOldCardQueryRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModelIds	List<Long>	是	必填	—	卡种ID列表
startDate	String	是	必填	—	开始日期
endDate	String	是	必填	—	结束日期
shareAmount	BigDecimal			—	分成金额（导出时使用）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OldCardSettlementQueryResult　（object）

字段	类型	表 / 列	说明
columns	List<OldCardColumnDTO>	—	动态列定义
columns[].key	String	—	列key
columns[].label	String	—	列标签
list	List<Map<String, Object>>	—	数据列表
total	Integer	—	总数
activationCount	OldCardActivationStats	—	激活量统计
activationCount.total	Integer	—	总激活量
activationCount.details	List<OldCardActivationCount>	—	各卡种激活量明细
details[].id	Long	`card_model`.`id`	卡种ID
details[].name	String	`card_model`.`name`	卡种名称
details[].count	Integer	—	激活数量

示例

请求示例（自动生成，仅结构参考）

POST /settlement/queryOldCardSettlement

{
  "body": {
    "cardModelIds": "",
    "startDate": "2026-01-01 12:00:00",
    "endDate": "2026-01-01 12:00:00",
    "shareAmount": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "columns": [
      {
        "key": "",
        "label": ""
      }
    ],
    "list": "",
    "total": 0,
    "activationCount": {
      "total": 0,
      "details": [
        {
          "id": 1,
          "name": "",
          "count": 0
        }
      ]
    }
  }
}

处理逻辑

逻辑摘要调用 querySettlement（settlementOldCardService.querySettlement）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）