POST/settlement/querySettlementCardDetailSplitPage管理后台

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

结算与分配 / 卡·明细· SettlementCardDetailController#querySettlementCardDetailSplitPage

基本信息

  • 接口状态前端在用 置信度 高
  • 接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/settlement/querySettlementCardDetailSplitPage
  • 请求方式POST
  • Content-Typeapplication/json
  • 暴露渠道管理后台　前缀 /manage-api
  • 名称来源源码注释
  • 调用方已确认在用 · 管理后台（1 个前端）
  • 需求上下文feat:新增结算明细按区间价格拆分查询接口
  • 维护人 / 最后改动Miracle　2024-07-01　最近提交：feat:新增结算明细按区间价格拆分查询接口
  • 读写数据表settlement_card_detail、settlement_card_detail_payment　反查该表全部接口 →
  • 控制器com.jxxx.dscp.api.controller.settlement.SettlementCardDetailController#querySettlementCardDetailSplitPage
  • 源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/settlement/SettlementCardDetailController.java:133
  • 判定依据1 个调用点：dscp-html-manage/src/api/settlement/index.ts

请求参数

分页字段来自 AbstractPageRequest：pageNo（不是 pageNum）· pageSize · orderBy

Header 请求参数

参数名参数值是否必填参数类型描述说明
无（渠道统一鉴权头见《认证方式》）

Query 请求参数

参数名参数值是否必填参数类型描述说明
无

路径参数及说明

参数名参数值是否必填参数类型描述说明
无

Body 请求参数

Body 类型 SettlementCardDetailPageRequest
参数名参数值是否必填参数类型描述说明
pageNo…否Integer当前页面
pageSize…否Integer每页记录数
orderBy…否String排序语句
id…否Long结算id → settlement_card_detail_payment.id
settlementId…是Long结算id → settlement_card_detail_payment.settlement_id
sceneryName…否String资源名称 → settlement_card_detail.scenery_name
settlementVerifyStatus…否SettlementVerifyStatus结算明细核对状态 → settlement_card_detail.settlement_verify_status 0＝待核对 1＝已确认 2＝已拒绝
settlementMerchantId…否Long结算商户id → settlement_card_detail_payment.settlement_merchant_id
exportType…否Integer1.待平台审核状态和已经作废状态下的结算信息的导出，2.景区核对详情导出，3.系统核算详情导出
keywords…否String关键字

认证方式

需登录态：Authorization: Bearer <token>（多租户另带 tenant-id）；30002 会话失效需重登。详见全局公共参数。

响应参数

data 类型 PageInfo<SettlementCardDetailSplitListResponse>
参数名参数值是否必填参数类型描述说明
list…否List<T><SettlementCardDetailSplitListResponse>分页数据集合（元素结构见下一行）
id…否Longid → settlement_card_detail_payment.id
settlementId…否Long结算单id → settlement_card_detail_payment.settlement_id
cardModelName…否String卡种名称
settlementPeriod…否String结算起止时间
sceneryName…否String资源名称 → settlement_card_detail.scenery_name
settlementWay…否SettlementWay结算方式 → settlement_card_detail.settlement_way 1＝按刷卡次数 2＝买断 3＝分成 4＝按分配金额统一计算 5＝月度均衡分配计算
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结算明细核对状态 → settlement_card_detail.settlement_verify_status 0＝待核对 1＝已确认 2＝已拒绝
settlementMerchantId…否Long结算商户id（即开票方） → settlement_card_detail_payment.settlement_merchant_id
settlementMerchantName…否String结算商户（即开票方） → settlement_card_detail_payment.settlement_merchant_name
verifyUserId…否Long核对人id → settlement_card_detail.verify_user_id
verifyUserName…否String核对人姓名
verifyTime…否Date核对时间 → settlement_card_detail.verify_time
ticketTotalAmountSum…否Long累计刷卡次数
paymentBank…否SettlementCardDetailPayment旅游卡结算明细付款信息
id…否Longid → settlement_card_detail_payment.id
settlementId…否Long结算单id → settlement_card_detail_payment.settlement_id
settlementMerchantId…否Long结算商户id（即开票方） → settlement_card_detail_payment.settlement_merchant_id
isInvoice…否Boolean是否开票 → settlement_card_detail_payment.is_invoice
invoiceFiles…否String发票链接，逗号分隔 → settlement_card_detail_payment.invoice_files
isPaid…否Boolean是否打款 → settlement_card_detail_payment.is_paid
paymentProofFiles…否String付款凭证，逗号分隔 → settlement_card_detail_payment.payment_proof_files
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
createdTime…否Date创建时间 → settlement_card_detail_payment.created_time
updatedTime…否Date修改时间 → settlement_card_detail_payment.updated_time
paymentAmountActual…否Long实际打款金额，单位为分 → settlement_card_detail_payment.payment_amount_actual
remark…否String备注 → settlement_card_detail_payment.remark
total…否Long数据总数

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "list": "[]",
    "id": "1",
    "settlementId": "1",
    "cardModelName": "\"string\"",
    "settlementPeriod": "\"string\"",
    "sceneryName": "\"string\"",
    "settlementWay": "1",
    "sectionStartDate": "\"2026-01-01 00:00:00\"",
    "sectionEndDate": "\"2026-01-01 00:00:00\"",
    "sectionPrice": "1",
    "sectionCheckNum": "1",
    "sectionTicketTotalAmount": "1"
  }
}
示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表：settlement_card_detail、settlement_card_detail_payment　反查全部引用接口 →
  • SettlementCardDetailController#querySettlementCardDetailSplitPage
  • SessionUserService#isMerchant
  • SessionUserService#getSessionUser
  • SessionUserService#isShop
  • SettlementCardDetailService#queryPage（SettlementCardDetailServiceImpl）
  • SettlementCardDetailMapper#queryPage
  • BeanUtils.map → SettlementCardDetailQuery
  • BeanUtils.map → SettlementCardDetailSplitListResponse
其它依赖：SessionUserService.isMerchant、SessionUserService.getSessionUser、SessionUserService.isShop
逻辑摘要：调用 isMerchant（sessionService.isMerchant）；查询详情（sessionService.getSessionUser）；调用 isShop（sessionService.isShop）；入参与返回值经 BeanUtils 做对象/分页映射
源码内联注释（旧站解析结果）
  • 设置其他查询条件
  • 结算商户的数据
  • 商铺的数据
  • 设置参数
  • 银行信息
旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
调用点证据
  • dscp-html-manage/src/api/settlement/index.ts:45　管理后台 · request
← 旅游卡结算明细-分页查询旅游卡结算明细-拒绝 →
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写，均来自同一份数据