3.23 团单模式-人员信息批改
<p>[TOC]</p>
<p>请求模式：渠道方→华农阿凡达平台</p>
<p>接口描述：人员信息批改(增员、减员、修改人员三合一)</p>
<p>测试接口地址：<a href="https://porsche-avatar.chinahuanong.com.cn/avatar/endor/insuredUpdate">https://porsche-avatar.chinahuanong.com.cn/avatar/endor/insuredUpdate</a></p>
<p>生产接口地址：<a href="https://avatar.chinahuanong.com.cn/avatar/endor/insuredUpdate">https://avatar.chinahuanong.com.cn/avatar/endor/insuredUpdate</a></p>
<h3>请求头</h3>
<p><code>head</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>渠道代码</td>
<td>policySource</td>
<td>varchar</td>
<td>Y</td>
<td>保险公司分配给 渠道方的渠道编码</td>
</tr>
<tr>
<td>请求时间</td>
<td>reqTime</td>
<td>DateTime</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>接口类型</td>
<td>interfaceType</td>
<td>varchar</td>
<td>Y</td>
<td>针对每个接口，使用接口的API信息</td>
</tr>
<tr>
<td>订单号</td>
<td>orderNo</td>
<td>varchar</td>
<td>Y</td>
<td>要求必须唯一，会进行幂等检查</td>
</tr>
<tr>
<td>唯一标识符</td>
<td>uuid</td>
<td>varchar</td>
<td>Y</td>
<td>同orderNo,网络超时失败后原uuid ，会幂等返回结果</td>
</tr>
</tbody>
</table>
<h3>请求体</h3>
<p><code>endorseInsuredIdBody</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>保单号</td>
<td>policyNo</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>批改流水号</td>
<td>posNo</td>
<td>varchar</td>
<td>CY</td>
<td>批改流水号，要求必须唯一，保司需落地幂等(见费且保费变化大于0使用)</td>
</tr>
<tr>
<td>批改申请日期</td>
<td>endorDate</td>
<td>DateTime</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>批改生效日期</td>
<td>validDate</td>
<td>DateTime</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>批改生效小时</td>
<td>validHour</td>
<td>Integer</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>主共方批单号</td>
<td>channelEndorseNo</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>批改人员清单集合</td>
<td>insuredIdList</td>
<td>List</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>新增方案列表</td>
<td>policyProductList</td>
<td>List</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>保费变化量</td>
<td>modPremium</td>
<td>BigDecimal</td>
<td>CY</td>
<td>见费保费变化量为正数时必传</td>
</tr>
<tr>
<td>领款人信息</td>
<td><code>payeeInfo</code></td>
<td><code>Object</code></td>
<td>CY</td>
<td>保司退费时必传</td>
</tr>
<tr>
<td>支付方式</td>
<td>payOfMold</td>
<td>varchar</td>
<td>CY</td>
<td>01-收银台 02-暂收款</td>
</tr>
<tr>
<td>付款账号</td>
<td>oppAct</td>
<td>varchar</td>
<td>CY</td>
<td>预支付必传</td>
</tr>
<tr>
<td>付款账户名称</td>
<td>oppActName</td>
<td>varchar</td>
<td>CY</td>
<td>预支付必传</td>
</tr>
</tbody>
</table>
<h4>人员清单</h4>
<p><code>insuredIdList</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>人员操作类型</td>
<td>flag</td>
<td>varchar</td>
<td>CY</td>
<td>不传默认修改 <br/> I：新增 D：删除 U:修改</td>
</tr>
<tr>
<td>个人凭证号</td>
<td>subPolicyNo</td>
<td>varchar</td>
<td>CY</td>
<td>（特殊渠道使用）</td>
</tr>
<tr>
<td>旧被保人证件号</td>
<td>oldIdCode</td>
<td>varchar</td>
<td>CY</td>
<td>U 必填。<br/>个人凭证号、旧被保人证件号不可同时为空</td>
</tr>
<tr>
<td>批改生效日期</td>
<td>validDate</td>
<td>DateTime</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>姓名</td>
<td>insuredName</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>证件类型</td>
<td>idType</td>
<td>varchar</td>
<td>Y</td>
<td>见证件类型码表</td>
</tr>
<tr>
<td>被保人证件号码</td>
<td>idCode</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>年龄</td>
<td>age</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>性别</td>
<td>sex</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>出生日期</td>
<td>birthday</td>
<td>date</td>
<td>Y</td>
<td>YYYY-MM-DD</td>
</tr>
<tr>
<td>职业类别代码</td>
<td>occupationCode</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>职业等级</td>
<td>jobCode</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>保费变化量</td>
<td>chgPremium</td>
<td>BigDecimal</td>
<td>CY</td>
<td>增人正数，减人负数 (飞鸟鱼、极客使用)</td>
</tr>
<tr>
<td>方案序号</td>
<td>rationNo</td>
<td>String</td>
<td>Y</td>
<td>与核保传入一致</td>
</tr>
<tr>
<td>扩展字段</td>
<td>extensionInfo</td>
<td>Object</td>
<td>CY</td>
<td></td>
</tr>
</tbody>
</table>
<h6>人员清单扩展信息</h6>
<p><code>extensionInfo</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>实际用工单位名称</td>
<td>actualemployerName</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
</tbody>
</table>
<h4>投保方案信息</h4>
<p><code>policyProductList</code></p>
<table>
<thead>
<tr>
<th>字段名称 </th>
<th>字段代码 </th>
<th>类型 </th>
<th>是否必传</th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>方案序号 </td>
<td>rationNo </td>
<td>Integer </td>
<td>Y </td>
<td>必须保证保单下方案序号唯一，建议按最大序号自增</td>
</tr>
<tr>
<td>方案代码 </td>
<td>rationCode </td>
<td>varchar </td>
<td>Y </td>
<td></td>
</tr>
<tr>
<td>操作类型 </td>
<td>endorseFlag </td>
<td>varchar </td>
<td>Y </td>
<td>I：新增 D：删除 U:修改</td>
</tr>
<tr>
<td>每人总保费 </td>
<td>unitSumPremium </td>
<td>varchar </td>
<td>CY </td>
<td>加费后的保费</td>
</tr>
<tr>
<td>每人保额 </td>
<td>unitSumAmount </td>
<td>varchar </td>
<td>Y </td>
<td>每人保额</td>
</tr>
<tr>
<td>方案总保费 </td>
<td>sumPremium </td>
<td>varchar </td>
<td>CY </td>
<td>每人*人数</td>
</tr>
<tr>
<td>方案人数 </td>
<td>insuredCount </td>
<td>Integer </td>
<td>Y </td>
<td>此方案下的被保险人人数</td>
</tr>
<tr>
<td>投保份数 </td>
<td>rationCount </td>
<td>Integer </td>
<td>CY </td>
<td>默认1 </td>
</tr>
<tr>
<td>职业等级 </td>
<td>occupationCode</td>
<td>varchar </td>
<td>N </td>
<td> </td>
</tr>
<tr>
<td>方案责任信息 </td>
<td>insureDutyInfos </td>
<td>List<object></td>
<td>CY </td>
<td>非特殊要求，可以不传 </td>
</tr>
</tbody>
</table>
<h6>方案责任信息</h6>
<p><code>insureDutyInfos</code></p>
<table>
<thead>
<tr>
<th>字段名称 </th>
<th>字段代码 </th>
<th>类型 </th>
<th>是否必传</th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>编码 </td>
<td>kindCode</td>
<td>varchar </td>
<td>Y </td>
<td>条款编码 </td>
</tr>
<tr>
<td>编码 </td>
<td>dutyCode</td>
<td>varchar </td>
<td>Y </td>
<td>责任编码 </td>
</tr>
<tr>
<td>保额 </td>
<td>amount </td>
<td>BigDecimal</td>
<td>CY </td>
<td>责任每人保额，不必传</td>
</tr>
<tr>
<td>保费 </td>
<td>premium </td>
<td>BigDecimal</td>
<td>CY </td>
<td>责任总保费，不必传 </td>
</tr>
<tr>
<td>保费 </td>
<td>unitPremium </td>
<td>BigDecimal</td>
<td>CY </td>
<td>条款每人保费，不必传 </td>
</tr>
<tr>
<td>免赔额 </td>
<td>freeDedAmount </td>
<td>BigDecimal</td>
<td>CY </td>
<td>不必传 </td>
</tr>
<tr>
<td>赔付比例 </td>
<td>deductibleRate </td>
<td>BigDecimal</td>
<td>CY </td>
<td>不必传 </td>
</tr>
</tbody>
</table>
<h4>领款人信息实体</h4>
<p><code>payeeInfo</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>领款人</td>
<td>payeeName</td>
<td>varchar</td>
<td>Y</td>
<td>payeeName</td>
</tr>
<tr>
<td>收款人类型</td>
<td>payeeType</td>
<td>varchar</td>
<td>CY</td>
<td>1-投保人 2-被保人 3-其他</td>
</tr>
<tr>
<td>收款账号</td>
<td>account</td>
<td>varchar</td>
<td>Y</td>
<td>资金退必传</td>
</tr>
<tr>
<td>收款账户名称</td>
<td>accountName</td>
<td>varchar</td>
<td>Y</td>
<td>资金退必传</td>
</tr>
<tr>
<td>开户行联行号</td>
<td>bankType</td>
<td>varchar</td>
<td>CY</td>
<td>开户行联行号和开户行名称必传其一</td>
</tr>
<tr>
<td>开户行名称</td>
<td>bankTypeName</td>
<td>varchar</td>
<td>CY</td>
<td>开户行名称</td>
</tr>
</tbody>
</table>
<h3>响应头</h3>
<p><code>head</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>渠道代码</td>
<td>policySource</td>
<td>varchar</td>
<td>Y</td>
<td>保险公司分配给渠道方的渠道编码</td>
</tr>
<tr>
<td>请求时间</td>
<td>respTime</td>
<td>DateTime</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>接口类型</td>
<td>interfaceType</td>
<td>varchar</td>
<td>Y</td>
<td>针对每个接口，使用接口的API信息</td>
</tr>
<tr>
<td>订单号</td>
<td>orderNo</td>
<td>varchar</td>
<td>Y</td>
<td>贯穿保单始终的订单号，要求必须唯一，会进行幂等检查</td>
</tr>
<tr>
<td>唯一标识符</td>
<td>uuid</td>
<td>varchar</td>
<td>Y</td>
<td>单次请求唯一标识符，任一次请求不允许相同</td>
</tr>
</tbody>
</table>
<h3>响应体</h3>
<p><code>respBody</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>保单号</td>
<td>policyNo</td>
<td>varchar</td>
<td>Y</td>
<td>保单号</td>
</tr>
<tr>
<td>批单号</td>
<td>endorseNo</td>
<td>varchar</td>
<td>CY</td>
<td>批单号（非见费必传）</td>
</tr>
<tr>
<td>电子批单链接</td>
<td>endorseUrl</td>
<td>varchar</td>
<td>Y</td>
<td>（非见费必传）</td>
</tr>
<tr>
<td>人员批改凭证信息</td>
<td>insuredList</td>
<td>varchar</td>
<td>CY</td>
<td>人员新增返回</td>
</tr>
<tr>
<td>处理状态码</td>
<td>dealCode</td>
<td>varchar</td>
<td>Y</td>
<td>处理结果状态码</td>
</tr>
<tr>
<td>处理结果描述</td>
<td>dealDesc</td>
<td>varchar</td>
<td>Y</td>
<td>处理结果描述</td>
</tr>
</tbody>
</table>
<h6>人员批改凭证信息</h6>
<p><code>insuredList</code></p>
<table>
<thead>
<tr>
<th>字段名称 </th>
<th>字段代码 </th>
<th>类型 </th>
<th>是否必传</th>
<th>说明 </th>
</tr>
</thead>
<tbody>
<tr>
<td>证件类型 </td>
<td>idType</td>
<td>varchar </td>
<td>Y </td>
<td>证件类型 </td>
</tr>
<tr>
<td>证件号码 </td>
<td>idCode</td>
<td>varchar </td>
<td>Y </td>
<td>证件号码 </td>
</tr>
<tr>
<td>个人凭证号 </td>
<td>subPolicyNo</td>
<td>varchar </td>
<td>Y </td>
<td>个人凭证号 </td>
</tr>
</tbody>
</table>