8.4 雇主多方案批改
<p>[TOC]</p>
<p>请求模式：渠道方→华农阿凡达平台</p>
<p>接口描述：多方案批改</p>
<p>测试接口地址：<a href="https://porsche-avatar.chinahuanong.com.cn/avatar/endor/multiTargetUpdate">https://porsche-avatar.chinahuanong.com.cn/avatar/endor/multiTargetUpdate</a></p>
<p>生产接口地址：<a href="https://avatar.chinahuanong.com.cn/avatar/endor/multiTargetUpdate">https://avatar.chinahuanong.com.cn/avatar/endor/multiTargetUpdate</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>格式为：yyyy-MM-dd HH:mm:ss。</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>body</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>quotationList</td>
<td>List</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>批改人员清单集合</td>
<td>insuredIdList</td>
<td>List</td>
<td>Y</td>
<td>批改清单</td>
</tr>
</tbody>
</table>
<h4>询价单信息集合</h4>
<p><code>quotationList</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>询价单号</td>
<td>quotationNo</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>单位保费</td>
<td>unitSumPremium</td>
<td>BigDecimal</td>
<td>Y</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>I：新增 D：删除</td>
</tr>
<tr>
<td>询价单号</td>
<td>quotationNo</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>批改生效日期</td>
<td>validDate</td>
<td>DateTime</td>
<td>Y</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>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>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>
<tr>
<td>询价单信息</td>
<td>quotationInfos</td>
<td>varchar</td>
<td>CY</td>
<td>成功传</td>
</tr>
</tbody>
</table>
<p><code>quotationInfos</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>询价单号</td>
<td>quotationNo</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>日保费</td>
<td>dailyPremium</td>
<td>BigDecimal</td>
<td>CY</td>
<td>询价单日保费</td>
</tr>
</tbody>
</table>
<h3>示例报文</h3>
<h4>请求</h4>
<pre><code class="language-json">{
&quot;body&quot;: {
&quot;policyNo&quot;: &quot;X33001701240000029001&quot;,
&quot;endorDate&quot;: &quot;2024-07-09&quot;,
&quot;quotationList&quot;: [
{
&quot;quotationNo&quot;: &quot;Q3300170124000001073&quot;,
&quot;unitSumPremium&quot;: 140.16
},
{
&quot;quotationNo&quot;: &quot;Q3300170124000001074&quot;,
&quot;unitSumPremium&quot;: 140.16
}
],
&quot;insuredIdList&quot;: [
{
&quot;quotationNo&quot;: &quot;Q3300170124000001073&quot;,
&quot;flag&quot;: &quot;I&quot;,
&quot;validDate&quot;: &quot;2024-07-12 00:00:00&quot;,
&quot;chgPremium&quot;: &quot;140.16&quot;,
&quot;insuredName&quot;: &quot;测试7&quot;,
&quot;idType&quot;: &quot;1&quot;,
&quot;idCode&quot;: &quot;123123&quot;,
&quot;age&quot;: &quot;34&quot;,
&quot;sex&quot;: &quot;1&quot;,
&quot;birthday&quot;: &quot;1990-01-01&quot;
},
{
&quot;quotationNo&quot;: &quot;Q3300170124000001074&quot;,
&quot;flag&quot;: &quot;I&quot;,
&quot;validDate&quot;: &quot;2024-07-12 00:00:00&quot;,
&quot;chgPremium&quot;: &quot;140.16&quot;,
&quot;insuredName&quot;: &quot;测试8&quot;,
&quot;idType&quot;: &quot;1&quot;,
&quot;idCode&quot;: &quot;456456&quot;,
&quot;age&quot;: &quot;34&quot;,
&quot;sex&quot;: &quot;1&quot;,
&quot;birthday&quot;: &quot;1990-01-01&quot;
},
{
&quot;quotationNo&quot;: &quot;Q3300170124000001074&quot;,
&quot;flag&quot;: &quot;D&quot;,
&quot;validDate&quot;: &quot;2024-07-12 00:00:00&quot;,
&quot;chgPremium&quot;: &quot;-140.16&quot;,
&quot;birthday&quot;: &quot;2003-11-14&quot;,
&quot;occupationCode&quot;: &quot;1701001&quot;,
&quot;idCode&quot;: &quot;110101200311140398&quot;,
&quot;sex&quot;: &quot;1&quot;,
&quot;idType&quot;: 1,
&quot;insuredName&quot;: &quot;被保险人1&quot;,
&quot;age&quot;: 20
}
]
},
&quot;head&quot;: {
&quot;policySource&quot;: &quot;PHN_FNY&quot;,
&quot;reqTime&quot;: &quot;{{date}}&quot;,
&quot;interfaceType&quot;: &quot;groupPolicyOrder&quot;,
&quot;orderNo&quot;: &quot;{{$guid}}&quot;,
&quot;uuid&quot;: &quot;{{$guid}}&quot;
}
}</code></pre>
<h4>响应</h4>
<pre><code class="language-json">{
&quot;head&quot;: {
&quot;interfaceType&quot;: &quot;groupPolicyOrder&quot;,
&quot;orderNo&quot;: &quot;63afbc58-ee6b-4cee-affa-602c301b2d6c&quot;,
&quot;policySource&quot;: &quot;PHN_FNY&quot;,
&quot;respTime&quot;: 1720522036469,
&quot;uuid&quot;: &quot;bff50891-bbf9-4d1c-88a0-347640b474d1&quot;
},
&quot;respBody&quot;: {
&quot;dealCode&quot;: &quot;1&quot;,
&quot;dealDesc&quot;: &quot;成功&quot;,
&quot;endorContext&quot;: &quot;方案1，雇员人数由3人变更为3人。\n 增加的雇员资料为：\n 1.雇员姓名：测试8，证件类型：居民户口簿，证件号码：456456，生效时间：2024-07-12 00:00:00。\n 删除的雇员资料为：\n 1.雇员姓名：被保险人1，证件类型：居民户口簿，证件号码：110101200311140398，生效时间：2024-07-12 00:00:00。\n方案3（新增），雇员人数由0人变更为1人。\n 增加的雇员资料为：\n 1.雇员姓名：测试7，证件类型：居民户口簿，证件号码：123123，生效时间：2024-07-12 00:00:00。\n&quot;,
&quot;endorseNo&quot;: &quot;X33001701240000029001_001&quot;,
&quot;endorseUrl&quot;: &quot;https://porsche-avatar.chinahuanong.com.cn/avatar/elec/download?data=1iI0BFmFG6JnJKY478n7lyaENcJiraHgfPqkBU7cDyk=&amp;sign=FA3767CDB8901D595A9B49C110361CCC&quot;,
&quot;policyNo&quot;: &quot;X33001701240000029001&quot;,
&quot;quotationInfos&quot;: [{
&quot;dailyPremium&quot;: 0.38,
&quot;quotationNo&quot;: &quot;Q3300170124000001073&quot;,
&quot;sumPremium&quot;: 140.16
}, {
&quot;dailyPremium&quot;: 0.38,
&quot;quotationNo&quot;: &quot;Q3300170124000001074&quot;,
&quot;sumPremium&quot;: 140.16
}]
}
}</code></pre>