POST/cardResourceRule/updateCardSettlementRule管理后台

设置结算规则

旅游卡 / 资源规则· CardResourceRuleController#updateCardSettlementRule

基本信息

接口状态前端在用置信度高
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/cardResourceRule/updateCardSettlementRule
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台　前缀 /manage-api
名称来源源码注释
调用方已确认在用 · 管理后台（1 个前端）
需求上下文结算规则设置
维护人 / 最后改动luoli　2024-06-17　最近提交：结算规则设置
读写数据表card_resource_rule　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.card.CardResourceRuleController#updateCardSettlementRule
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/card/CardResourceRuleController.java:334
判定依据1 个调用点：dscp-html-manage/src/api/card/index.ts

请求参数

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 CardSettlementRuleRequest

参数名	参数值	是否必填	参数类型	描述说明
id	…	是	Long	ID，主键 → card_resource_rule.id
ticketPriceModel	…	否	TicketPriceModel	签约门票定价方式 → card_resource_rule.ticket_price_model 1＝统一定价 2＝周期定价
ticketUniformPrice	…	否	Long	签约门票价 → card_resource_rule.ticket_uniform_price
ticketPeriodPrice	…	否	List<TicketPeriodPrice>	签约门票周期价 → card_resource_rule.ticket_period_price
price	…	否	Long	门票价
startDate	…	否	Date	开始时间
endDate	…	否	Date	结束时间
ticketPeriodBasePrice	…	否	Long	签约门票周期基础定价 → card_resource_rule.ticket_period_base_price
settlementWay	…	否	SettlementWay	结算方式 → card_resource_rule.settlement_way 1＝按刷卡次数 2＝买断 3＝分成 4＝按分配金额统一计算 5＝月度均衡分配计算
ladderFlag	…	否	Boolean	是否阶梯计算
checkSettlementType	…	否	CheckSettlementType	刷卡次数结算方式 → card_resource_rule.check_settlement_type 1＝签约计价 2＝阶梯计价 3＝阈值计价
settlementPriceOnce	…	否	Long	单次入园结算金额 → card_resource_rule.settlement_price_once
settlementPriceLadder	…	否	List<SettlementLadderPrice>	阶梯入园结算金额 → card_resource_rule.settlement_price_ladder
minCheckNum	…	否	Integer	最小入园次数
maxCheckNum	…	否	Integer	最大入园次数
settlementPriceOnce	…	否	Long	单次入园结算金额 → card_resource_rule.settlement_price_once
calcCheckNum	…	否	Integer	计算核销次数 -- 临时字段
settlementPriceBuyout	…	否	Long	结算周期买断金额 → card_resource_rule.settlement_price_buyout
cardSaleShare	…	否	Long	销售卡分成，元每张 → card_resource_rule.card_sale_share
minSaleFlag	…	否	Boolean	是否设置保底分成售卡张数 → card_resource_rule.min_sale_flag
maxSaleFlag	…	否	Boolean	是否设置上限分成售卡张数 → card_resource_rule.max_sale_flag
minSaleNum	…	否	Integer	保底分成售卡张数 → card_resource_rule.min_sale_num
maxSaleNum	…	否	Integer	上限分成售卡张数 → card_resource_rule.max_sale_num
minCostFlag	…	否	Boolean	是否有最低保本单价 → card_resource_rule.min_cost_flag
minCostPrice	…	否	Integer	最低保本单价 → card_resource_rule.min_cost_price
belowMinCostWay	…	否	BelowCostSettlementWay	平均单价未达保本单价时结算方式 → card_resource_rule.below_min_cost_way 1＝按保本单价补充金额 2＝按实际金额计算
aboveMinCostWay	…	否	AboveCostSettlementWay	平均单价高于保本单价时结算方式 → card_resource_rule.above_min_cost_way 1＝按保本单价计算金额 2＝按实际金额计算
monthShareTicketPrice	…	否	Long	月度均衡分配结算签约门票价 <em>结算方式为月度均衡分配计算时，签约门票价取该值</em> → card_resource_rule.month_share_ticket_price
isSettlementPlayNum	…	是	Boolean	是否设置单张卡结算入园次数上限 → card_resource_rule.is_settlement_play_num
settlementPlayNum	…	否	Integer	单张卡结算时入园次数上限 → card_resource_rule.settlement_play_num
settlementMerchantId	…	是	Long	结算商户id（即开票方） → card_resource_rule.settlement_merchant_id

认证方式

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

响应参数

参数名	参数值	是否必填	参数类型	描述说明
void —— 不返回业务数据（外层包装见全局公共参数）

响应示例

成功响应示例 code=0

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

示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要

涉及数据表：card_resource_rule　反查全部引用接口 →

CardResourceRuleController#updateCardSettlementRule
CardResourceRuleService#update（CardResourceRuleServiceImpl）
CardResourceRuleMapper#update
BeanUtils.map → CardResourceRule ⇒ 表 card_resource_rule

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

操作日志：card / 更新结算规则

旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

调用点证据

dscp-html-manage/src/api/card/index.ts:215　管理后台 · request