跳转至

AppBenefitController 接口分析文档

概述信息

属性 值
模块 app-eform-server
包路径 com.sinosoft.sss.controller.app
基础路径 /benefit
Controller类 AppBenefitController
状态 活跃
接口数量 9个
作者 zhaoxiaobo
创建时间 2018年9月21日
类描述 受益人相关操作控制器，负责受益人信息的增删改查及校验

接口列表总览

序号 接口方法（锚点链接） HTTP方法 路径 参数 返回类型 接口使用说明 状态
1 initBenefitList GET/POST /initBenefitList Map clientMap Map 初始化受益人列表 活跃
2 addOrUpdateOneBenefit GET/POST /addOrUpdateOneBenefit Map clientMap Map 添加或更新受益人 活跃
3 getOneBenefiInfo GET/POST /getOneBenefiInfo String prtNum, String BenefNo, String customerNo, String customerFlag, String oldInsFlag Map 查询getOneBenefiInfo 活跃
4 deleteBenefit GET/POST /deleteBenefit String PrtNum, String InsuredNo, String benefitNoList Map 删除受益人 活跃
5 checkBenef GET/POST /checkBenef String prtNum, String addType, String customerNo, String customerFlag Map 检查受益人 活跃
6 revert GET/POST /revert String prtNum, String insuredNo Map 处理revert 活跃
7 cancel GET/POST /cancel String prtNum Map 取消 活跃
8 addBenefits GET/POST /addBenefits Map data ApiResultVO 添加受益人 活跃
9 saveBenefFDFlag GET/POST /saveBenefFDFlag String prtNum, String flag ApiResultVO 保存saveBenefFDFlag 活跃

接口详情

initBenefitList

  • 路径: /initBenefitList
  • HTTP方法: GET/POST
  • 参数: Map<String,String> clientMap - 受益人相关字段
  • 返回类型: Map<String,Object>
  • 状态: 活跃
  • 接口使用说明: 初始化受益人列表

代码片段: 

@RequestMapping("/initBenefitList")
@ResponseBody
public Map<String,Object> initBenefitList(@RequestParam Map<String,String> clientMap){
    return appBenefitServiceInter.initBenefitList(clientMap);
}

Mermaid逻辑流程图:

graph TD A[接收clientMap] --> B[调用appBenefitServiceInter.initBenefitList] B --> C[查询受益人列表] C --> D[返回受益人数据]

业务逻辑描述: 根据客户信息初始化受益人列表，查询并返回所有已保存的受益人信息。

涉及模块: AppBenefitServiceInter

addOrUpdateOneBenefit

  • 路径: /addOrUpdateOneBenefit
  • HTTP方法: GET/POST
  • 参数: Map<String,String> clientMap - 受益人信息
  • 返回类型: Map<String,String>
  • 状态: 活跃
  • 接口使用说明: 新增或修改单个受益人

代码片段: 

@RequestMapping("/addOrUpdateOneBenefit")
@ResponseBody
public Map<String,String> addOrUpdateOneBenefit(@RequestParam Map<String,String> clientMap){
    return appBenefitServiceInter.addOrUpdateOneBenefit(clientMap);
}

Mermaid逻辑流程图:

graph TD A[接收clientMap] --> B[校验受益人信息] B --> C[调用appBenefitServiceInter.addOrUpdateOneBenefit] C --> D[保存或更新受益人] D --> E[返回操作结果]

业务逻辑描述: 新增或修改单个受益人信息，包含姓名、电话、证件号码等多字段校验，支持TR系列改造记录。

涉及模块: AppBenefitServiceInter

getOneBenefiInfo

  • 路径: /getOneBenefiInfo
  • HTTP方法: GET/POST
  • 参数: String prtNum, String BenefNo, String customerNo, String customerFlag, String oldInsFlag
  • 返回类型: Map<String,Object>
  • 状态: 活跃
  • 接口使用说明: 获取单个受益人信息

代码片段: 

@RequestMapping("/getOneBenefiInfo")
@ResponseBody
public Map<String,Object> getOneBenefiInfo(String prtNum, String BenefNo, String customerNo, String customerFlag, String oldInsFlag){
    return appBenefitServiceInter.getOneBenefiInfo(prtNum, BenefNo, customerNo, customerFlag, oldInsFlag);
}

Mermaid逻辑流程图:

graph TD A[接收多个参数] --> B[调用appBenefitServiceInter.getOneBenefiInfo] B --> C[查询单个受益人详情] C --> D[返回受益人信息]

业务逻辑描述: 根据投保单号、受益人序号、客户号等条件查询并返回单个受益人的详细信息。

涉及模块: AppBenefitServiceInter

deleteBenefit

  • 路径: /deleteBenefit
  • HTTP方法: GET/POST
  • 参数: String PrtNum, String InsuredNo, String benefitNoList
  • 返回类型: Map<String,Object>
  • 状态: 活跃
  • 接口使用说明: 删除受益人

代码片段: 

@RequestMapping("/deleteBenefit")
@ResponseBody
public Map<String,Object> deleteBenefit(String PrtNum, String InsuredNo, String benefitNoList){
    return appBenefitServiceInter.deleteBenefit(PrtNum, InsuredNo, benefitNoList);
}

Mermaid逻辑流程图:

graph TD A[接收PrtNum, InsuredNo, benefitNoList] --> B[调用appBenefitServiceInter.deleteBenefit] B --> C[删除受益人记录] C --> D[返回删除结果]

业务逻辑描述: 删除指定受益人，支持按受益人序号批量删除，删除前会进行业务规则校验。

涉及模块: AppBenefitServiceInter

checkBenef

  • 路径: /checkBenef
  • HTTP方法: GET/POST
  • 参数: String prtNum, String addType, String customerNo, String customerFlag
  • 返回类型: Map<String,String>
  • 状态: 活跃
  • 接口使用说明: 整单受益人校验

代码片段: 

@RequestMapping("/checkBenef")
@ResponseBody
public Map<String,String> checkBenef(String prtNum, String addType, String customerNo, String customerFlag){
    return appBenefitServiceInter.checkBenef(prtNum, addType, customerNo, customerFlag);
}

Mermaid逻辑流程图:

graph TD A[接收校验参数] --> B[调用appBenefitServiceInter.checkBenef] B --> C[执行整单校验规则] C --> D[返回校验结果]

业务逻辑描述: 对整单受益人进行业务规则校验，包括受益人数量限制、比例校验、与被保人关系校验等。

涉及模块: AppBenefitServiceInter

revert

  • 路径: /revert
  • HTTP方法: GET/POST
  • 参数: String prtNum, String insuredNo
  • 返回类型: Map<String,String>
  • 状态: 活跃
  • 接口使用说明: 受益人恢复操作

代码片段: 

@RequestMapping("/revert")
@ResponseBody
public Map<String,String> revert(String prtNum, String insuredNo){
    return appBenefitServiceInter.revert(prtNum, insuredNo);
}

Mermaid逻辑流程图:

graph TD A[接收prtNum, insuredNo] --> B[调用appBenefitServiceInter.revert] B --> C[恢复已删除的受益人] C --> D[返回恢复结果]

业务逻辑描述: 恢复已删除的受益人记录，将受益人状态重新置为有效。

涉及模块: AppBenefitServiceInter

cancel

  • 路径: /cancel
  • HTTP方法: GET/POST
  • 参数: String prtNum - 投保单号
  • 返回类型: Map<String,String>
  • 状态: 活跃
  • 接口使用说明: 清空受益人

代码片段: 

@RequestMapping("/cancel")
@ResponseBody
public Map<String,String> cancel(String prtNum){
    return appBenefitServiceInter.cancel(prtNum);
}

Mermaid逻辑流程图:

graph TD A[接收prtNum] --> B[调用appBenefitServiceInter.cancel] B --> C[清空所有受益人] C --> D[返回清空结果]

业务逻辑描述: 清空指定保单的所有受益人信息，通常用于重新录入或变更受益人场景。

涉及模块: AppBenefitServiceInter

addBenefits

  • 路径: /addBenefits
  • HTTP方法: GET/POST
  • 参数: Map<String,Object> data - 受益人数据
  • 返回类型: ApiResultVO
  • 状态: 活跃
  • 接口使用说明: 批量新增法定受益人

代码片段: 

@RequestMapping("/addBenefits")
@ResponseBody
public ApiResultVO addBenefits(@RequestBody Map<String,Object> data){
    return appBenefitServiceInter.addBenefits(data);
}

Mermaid逻辑流程图:

graph TD A[接收data] --> B[校验法定受益人规则] B --> C[调用appBenefitServiceInter.addBenefits] C --> D[批量保存受益人] D --> E[返回保存结果]

业务逻辑描述: 批量新增法定受益人，仅适用于北京机构，按法定继承顺序自动分配受益比例。

涉及模块: AppBenefitServiceInter

saveBenefFDFlag

  • 路径: /saveBenefFDFlag
  • HTTP方法: GET/POST
  • 参数: String prtNum, String flag - 投保单号、法定代表标识
  • 返回类型: ApiResultVO
  • 状态: 活跃
  • 接口使用说明: 保存受益人法定代表标识

代码片段: 

@RequestMapping("/saveBenefFDFlag")
@ResponseBody
public ApiResultVO saveBenefFDFlag(String prtNum, String flag){
    return appBenefitServiceInter.saveBenefFDFlag(prtNum, flag);
}

Mermaid逻辑流程图:

graph TD A[接收prtNum, flag] --> B[调用appBenefitServiceInter.saveBenefFDFlag] B --> C[保存法定代表人标识] C --> D[返回保存结果]

业务逻辑描述: 保存受益人的法定代表人标识，用于区分法定代表人和指定受益人。

涉及模块: AppBenefitServiceInter

接口统计

  • 接口总数: 9个
  • 活跃接口: 9个
  • 被注释接口: 0个
  • 生成时间: 2026-03-23 17:57