POST/distributeAmount/previewCalc管理后台

预览计算（不保存），每月数据独立展示

结算与分配 / 金额· DistributeAmountController#previewCalc

接口状态前端在用置信度高
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/distributeAmount/previewCalc
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台　前缀 /manage-api
名称来源源码注释
调用方已确认在用 · 管理后台（1 个前端）
需求上下文feat：新增结算分配功能
维护人 / 最后改动jacobxu666　2026-06-23　最近提交：feat：新增结算分配功能
读写数据表—
控制器com.jxxx.dscp.api.controller.distribute.DistributeAmountController#previewCalc
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/distribute/DistributeAmountController.java:70
判定依据1 个调用点：dscp-html-manage/src/api/card/distributeAmount/index.ts

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

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

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

Body 类型 DistributeAmountCalcRequest

参数名	参数值	是否必填	参数类型	描述说明
year	…	是	Integer	Min value = 2020, message = "年份不合法" Max value = 2099, message = "年份不合法"
month	…	否	Integer
months	…	否	List<Integer>	多月批量计算（可选，优先于 month）
cardModelIds	…	否	List<Long>	指定卡种ID列表（可选，为空时计算全部三类卡）
ratio	…	否	Integer	分润比例（可选，百分比整数，如 80 表示 80%，默认 80）
calcMode	…	否	String	计算模式：ratio（按比例，默认）/ fixed（固定金额）
fixedAmount	…	否	Long	固定金额（单位：分），calcMode 为 fixed 时使用

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

data 类型 List<Map<String, Object>>

参数名	参数值	是否必填	参数类型	描述说明
未解析到返回结构

无示例

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

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

其它依赖：DistributeAmountService.previewCalc

逻辑摘要：调用 isNotEmpty（CollUtil.isNotEmpty）；调用 previewCalc（distributeAmountService.previewCalc）

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

调用点证据