POST/settlement/sceneryGetPaymentProof管理后台

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

结算与分配 / 卡·明细·支付· SettlementCardDetailPaymentController#sceneryGetPaymentProof

基本信息

  • 接口状态前端在用 置信度 高
  • 接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/settlement/sceneryGetPaymentProof
  • 请求方式POST
  • Content-Typeapplication/json
  • 暴露渠道管理后台　前缀 /manage-api
  • 名称来源源码注释
  • 调用方已确认在用 · 管理后台（1 个前端）
  • 需求上下文开票方和景区查看付款凭证
  • 维护人 / 最后改动luoli　2024-07-01　最近提交：开票方和景区查看付款凭证
  • 读写数据表settlement_card_detail、settlement_card_detail_payment　反查该表全部接口 →
  • 控制器com.jxxx.dscp.api.controller.settlement.SettlementCardDetailPaymentController#sceneryGetPaymentProof
  • 源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/settlement/SettlementCardDetailPaymentController.java:316
  • 判定依据1 个调用点：dscp-html-manage/src/api/settlement/index.ts

请求参数

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 SettlementCardDetailPaymentRequest
参数名参数值是否必填参数类型描述说明
settlementId…是Long结算id → settlement_card_detail_payment.settlement_id

认证方式

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

响应参数

data 类型 List<SceneryPaymentResponse>
参数名参数值是否必填参数类型描述说明
settlementMerchantName…否String开票商户 → settlement_card_detail_payment.settlement_merchant_name
transferInfo…否List<SettlementCardDetailListResponse>
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＝月度均衡分配计算
ticketPriceInfo…否List<SettlementTicketPriceInfo>门票价格信息 → settlement_card_detail.ticket_price_info
startDate…否Date开始时间
endDate…否Date结束时间
price…否Long门票价
checkNum…否Integer刷卡次数
ticketTotalAmount…否Long门票价总计 <em>门票价总计=门票价乘以实际核销次数</em>
settlementFactor…否Double结算系数 → settlement_card_detail.settlement_factor
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结算明细核对状态 → 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累计门票金额
checkNumSum…否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
invoiceFiles…否List<InvoicePaymentResponse>发票文件 → settlement_card_detail_payment.invoice_files
invoiceName…否String发票文件名称
invoiceFile…否String发票文件url地址
proofFiles…否List<ProofPaymentResponse>付款凭证
proofName…否String凭证文件名称
proofFile…否String凭证文件url地址
settlementCardDetailSplit…否List<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

响应示例

成功响应示例 code=0

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

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表：settlement_card_detail、settlement_card_detail_payment　反查全部引用接口 →
  • SettlementCardDetailPaymentController#sceneryGetPaymentProof
  • SessionUserService#getSessionUser
  • SettlementCardDetailService#queryList（SettlementCardDetailServiceImpl）
  • SettlementCardDetailMapper#queryList
  • BeanUtils.map → SettlementCardDetailSplitListResponse
其它依赖：SessionUserService.getSessionUser、MerchantCache.get
逻辑摘要：查询详情（sessionService.getSessionUser）；查询详情（settlementCardDetailService.getMapper）；查询详情（settlementCardDetailPaymentService.get）；入参与返回值经 BeanUtils 做对象/分页映射
源码内联注释（旧站解析结果）
  • 根据结算单查询结算明细
  • 反查结算商户包含的资源结算明细
  • 设置参数
  • 银行信息
  • 转化对象
旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
调用点证据
  • dscp-html-manage/src/api/settlement/index.ts:100　管理后台 · request
← 旅游卡结算明细-查看发票信息(景区核对)上传打款凭证 →
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写，均来自同一份数据