3.14 团单模式-人员信息批改试算
<p>[TOC]</p>
<p>请求模式:渠道方→鸿雁平台</p>
<p>接口描述:人员信息批改(增员、减员、修改人员三合一)</p>
<p>测试接口地址:<a href="https://hermesgyb.zhlic.net/avatar/endor/insuredUpdateCal">https://hermesgyb.zhlic.net/avatar/endor/insuredUpdateCal</a></p>
<p>生产接口地址:<a href="https://gyb.zhlic.net/avatar/endor/insuredUpdateCal">https://gyb.zhlic.net/avatar/endor/insuredUpdateCal</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>单次请求唯一标识符,任一次请求不允许相同</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>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>insuredIdList</td>
<td>List</td>
<td>Y</td>
<td>批改人员清单集合</td>
</tr>
</tbody>
</table>
<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>
</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>modPremium</td>
<td>BigDecimal</td>
<td>Y</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>