3.15 团单模式-人员信息批改

<p>[TOC]</p> <p>请求模式：渠道方→鸿雁平台</p> <p>接口描述：人员信息批改(增员、减员、修改人员三合一)</p> <p>测试接口地址：<a href="https://hermesgyb.zhlic.net/avatar/endor/insuredUpdate">https://hermesgyb.zhlic.net/avatar/endor/insuredUpdate</a></p> <p>生产接口地址：<a href="https://gyb.zhlic.net/avatar/endor/insuredUpdate">https://gyb.zhlic.net/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>insuredIdList</td> <td>List</td> <td>Y</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> </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>不传默认修改 &lt;br/&gt; 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 必填。&lt;br/&gt;个人凭证号、旧被保人证件号不可同时为空</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>chgPremium</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>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>