3.23 批增责任接口
<p>[TOC]</p>
<p>请求模式：渠道方→鸿雁平台</p>
<p>接口描述：目前用于魔方的产品升级</p>
<p>测试接口地址：<a href="https://hermesgyb.zhlic.net/avatar/endor/endorseDuty">https://hermesgyb.zhlic.net/avatar/endor/endorseDuty</a></p>
<p>生产接口地址：<a href="https://gyb.zhlic.net/avatar/endor/endorseDuty">https://gyb.zhlic.net/avatar/endor/endorseDuty</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>avatarEndorseBody</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>endorType</td>
<td>varchar</td>
<td>Y</td>
<td>0-批减 1-批增（不传默认批增）</td>
</tr>
<tr>
<td>批改流水号</td>
<td>posNo</td>
<td>varchar</td>
<td>Y</td>
<td>批改流水号，保司需落地幂等</td>
</tr>
<tr>
<td>产品编码</td>
<td>productNo</td>
<td>varchar</td>
<td>Y</td>
<td>产品编码，需要保险公司自己记录映射关系。对于一个产品，产品编码必定存在且唯一。</td>
</tr>
<tr>
<td>批改请求时间</td>
<td>posReqTime</td>
<td>varchar</td>
<td>Y</td>
<td>格式为：yyyy-MM-dd。</td>
</tr>
<tr>
<td>批改生效期次</td>
<td>periodNum</td>
<td>Integer</td>
<td>CY</td>
<td>升级方案生效期次，不传时，根据批改生效时间确定期次</td>
</tr>
<tr>
<td>批改生效时间</td>
<td>posEffectTime</td>
<td>varchar</td>
<td>CY</td>
<td>格式为：yyyy-MM-dd。批改生效时间不传，批改生效期次 = 批改申请日对应期次+1</td>
</tr>
<tr>
<td>批改期次保费变化量(增量)</td>
<td>productPremium</td>
<td>BigDecimal</td>
<td>Y</td>
<td><b style='color:red'>批增</b>：批改时校验传入批增期次保费 <br><font color='red'> 批减</font>：批减：钩子批改期次保费(全量)</td>
</tr>
<tr>
<td>新方案号</td>
<td>newPlanCode</td>
<td>varchar</td>
<td>CY</td>
<td>批改后的方案号</td>
</tr>
<tr>
<td>虚拟新方案号</td>
<td>xnNewPlanCode</td>
<td>varchar</td>
<td>N</td>
<td></td>
</tr>
<tr>
<td>险种责任的集合信息</td>
<td>riskList</td>
<td>List</td>
<td>CY</td>
<td>本次新增的责任列表，有可选责任必传，没有可选责任可以不传</td>
</tr>
<tr>
<td>批改期次全量保费（批改后保费）</td>
<td>periodFullPremium</td>
<td>BigDecimal</td>
<td>CY</td>
<td><b style='color:red'>批增</b>：批改期次全量保费 periodFullPremium = productPremium+升级前保费(productPremium,periodFullPremium必传其一) <br><font color='red'>批减</font>：批减：钩子批改期次保费(全量)</td>
</tr>
</tbody>
</table>
<h4>险种责任的集合信息</h4>
<p><code>riskList</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>条款代码</td>
<td>itemCode</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>责任代码</td>
<td>kindCode</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>posNo</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>
<h3>报文示例</h3>
<h4>请求</h4>
<pre><code class="language-json">{
&quot;head &quot;: {
&quot;policySource&quot;: &quot;PHN_ZAZX&quot;,
&quot;orderNo&quot;: &quot;T202212182144146294162&quot;,
&quot;reqTime&quot;: &quot;2022-12-18 21:45: 01&quot;,
&quot;uuid&quot;: &quot;00a4022e-28b9-4ad4-b496-d290e7ec699b&quot;,
&quot;interfaceType &quot;: &quot;endorseDuty&quot;
},
&quot;avatarEndorseBody &quot;: {
&quot;policyNo&quot;: &quot;X00272634220000532524&quot; ,
&quot;posNo&quot;: &quot;MARS167137105451680170&quot;,
&quot;productNo&quot;: &quot;PDC00030 &quot;,
&quot;posReqTime&quot;: &quot;2022-12-18 21: 45: 01 &quot;,
&quot;productPremium&quot;: 82.01,
&quot;newPlanCode&quot;: &quot;PDCA000802 &quot;,
&quot;riskList&quot;: [
{
&quot;itemCode&quot;: &quot;Z26112&quot;,
&quot;kindCode&quot;: &quot;0006&quot;
},
{
&quot;itemCode&quot;: &quot;Z26112&quot;,
&quot;kindCode&quot;: &quot;0007&quot;
},
{
&quot;itemCode&quot;: &quot;Z26112&quot;,
&quot;kindCode&quot;: &quot;0119&quot;
},
{
&quot;itemCode&quot;: &quot;Z26112&quot;,
&quot;kindCode&quot;: &quot;0003&quot;
},
{
&quot;itemCode&quot;: &quot;Z26112&quot;,
&quot;kindCode&quot;: &quot;0118&quot;
}
],
&quot;periodNum &quot;: &quot;&quot;
}
}
</code></pre>
<h4>返回</h4>
<pre><code class="language-json">{
&quot;head&quot;: {
&quot;interfaceType&quot;: &quot;endorseDuty&quot;,
&quot;orderNo&quot;: &quot;T202212182144146294162&quot;,
&quot;policySource&quot;: &quot;PHN_ZAZX&quot;,
&quot;reqTime&quot;: 1671371101000,
&quot;uuid&quot;: &quot;00a4022e-28b9-4ad4-b496-d290e7ec699b&quot;
},
&quot;respBody&quot;: {
&quot;dealCode&quot;: &quot;1&quot;,
&quot;dealDesc&quot;: &quot;成功&quot;,
&quot;posNo&quot;: &quot;MARS167137105451680170&quot;
}
}
</code></pre>