3.24 批增责任结果回调通知接口
<p>[TOC]</p>
<p>请求模式：保司→渠道方</p>
<p>接口描述：目前用于魔方的产品升级</p>
<p>测试接口地址：渠道方地址</p>
<p>生产接口地址：渠道方地址</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>posNo</td>
<td>varchar</td>
<td>Y</td>
<td>批改流水号，保司需落地幂等</td>
</tr>
<tr>
<td>批单号</td>
<td>endorNo</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>批改状态</td>
<td>status</td>
<td>Integer</td>
<td>Y</td>
<td>0-失败 1-成功</td>
</tr>
<tr>
<td>描述</td>
<td>message</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>电子批单地址</td>
<td>endorUrl</td>
<td>varchar</td>
<td>CY</td>
<td>status为1-成功时必传</td>
</tr>
<tr>
<td>批改生效时间</td>
<td>effectiveTime</td>
<td>varchar</td>
<td>CY</td>
<td>status为1-成功时必传，yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td>批改核批时间</td>
<td>approveTime</td>
<td>varchar</td>
<td>CY</td>
<td>status为1-成功时必传，yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td>批改类型</td>
<td>endorType</td>
<td>Integer</td>
<td>CY</td>
<td>0-批减 1-批增, status为1-成功时必传</td>
</tr>
<tr>
<td>批改保费</td>
<td>endorPremium</td>
<td>BigDecimal</td>
<td>CY</td>
<td>status为1-成功时必传</td>
</tr>
<tr>
<td>分期信息</td>
<td>paymentPlanList</td>
<td>List<object></td>
<td>CY</td>
<td>status为1-成功时必传</td>
</tr>
</tbody>
</table>
<p><code>paymentPlanList</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>期次</td>
<td>nTms</td>
<td>Integer</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>保费变化量</td>
<td>nPayablePrm</td>
<td>BigDecimal</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>批改后保费</td>
<td>nEndPayablePrm</td>
<td>BigDecimal</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>交费开始时间</td>
<td>tPayBgnTm</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>宽限期截止时间</td>
<td>tPayEndTm</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>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;avatarEndorseBody&quot;: {
&quot;applyNo&quot;: &quot;MARS167137105451680170&quot;,
&quot;approveTime&quot;: &quot;2022-12-18 21:45:02&quot;,
&quot;effectiveTime&quot;: &quot;2023-01-19 00:00:00&quot;,
&quot;endorNo&quot;: &quot;2634220000532524_001&quot;,
&quot;endorPremium&quot;: 913.00,
&quot;endorType&quot;: 1,
&quot;endorUrl&quot;: &quot;hermesgyb.zhlic.net/avatar/elec/download?data=SfY8bs1j2cbgfAWZrXSUKXBPvA/CWd23i524nm9lypY=&amp;sign=5FEE2229CA3EF5A0699C814FF99C2895&quot;,
&quot;message&quot;: &quot;policyNo:批改成功&quot;,
&quot;paymentPlanList&quot;: [
{
&quot;endTime&quot;: &quot;2023-02-19 06:00:00&quot;,
&quot;payno&quot;: 2,
&quot;premium&quot;: 83.00,
&quot;startTime&quot;: &quot;2023-01-19 00:00:00&quot;
},
{
&quot;endTime&quot;: &quot;2023-03-19 06:00:00&quot;,
&quot;payno&quot;: 3,
&quot;premium&quot;: 83.00,
&quot;startTime&quot;: &quot;2023-02-19 00:00:00&quot;
},
{
&quot;endTime&quot;: &quot;2023-04-19 06:00:00&quot;,
&quot;payno&quot;: 4,
&quot;premium&quot;: 83.00,
&quot;startTime&quot;: &quot;2023-03-19 00:00:00&quot;
},
{
&quot;endTime&quot;: &quot;2023-05-19 06:00:00&quot;,
&quot;payno&quot;: 5,
&quot;premium&quot;: 83.00,
&quot;startTime&quot;: &quot;2023-04-19 00:00:00&quot;
},
{
&quot;endTime&quot;: &quot;2023-06-19 06:00:00&quot;,
&quot;payno&quot;: 6,
&quot;premium&quot;: 83.00,
&quot;startTime&quot;: &quot;2023-05-19 00:00:00&quot;
},
{
&quot;endTime&quot;: &quot;2023-07-19 06:00:00&quot;,
&quot;payno&quot;: 7,
&quot;premium&quot;: 83.00,
&quot;startTime&quot;: &quot;2023-06-19 00:00:00&quot;
},
{
&quot;endTime&quot;: &quot;2023-08-19 06:00:00&quot;,
&quot;payno&quot;: 8,
&quot;premium&quot;: 83.00,
&quot;startTime&quot;: &quot;2023-07-19 00:00:00&quot;
},
{
&quot;endTime&quot;: &quot;2023-09-19 06:00:00&quot;,
&quot;payno&quot;: 9,
&quot;premium&quot;: 83.00,
&quot;startTime&quot;: &quot;2023-08-19 00:00:00&quot;
},
{
&quot;endTime&quot;: &quot;2023-10-19 06:00:00&quot;,
&quot;payno&quot;: 10,
&quot;premium&quot;: 83.00,
&quot;startTime&quot;: &quot;2023-09-19 00:00:00&quot;
},
{
&quot;endTime&quot;: &quot;2023-11-19 06:00:00&quot;,
&quot;payno&quot;: 11,
&quot;premium&quot;: 83.00,
&quot;startTime&quot;: &quot;2023-10-19 00:00:00&quot;
},
{
&quot;endTime&quot;: &quot;2023-12-19 06:00:00&quot;,
&quot;payno&quot;: 12,
&quot;premium&quot;: 83.00,
&quot;startTime&quot;: &quot;2023-11-19 00:00:00&quot;
}
],
&quot;policyNo&quot;: &quot;2634220000532524&quot;,
&quot;status&quot;: 1
},
&quot;head&quot;: {
&quot;interfaceType&quot;: &quot;endorDutyCall&quot;,
&quot;orderNo&quot;: &quot;T202212182144146294162&quot;,
&quot;policySource&quot;: &quot;PHN_ZAZX&quot;,
&quot;reqTime&quot;: 1671371102835,
&quot;uuid&quot;: &quot;c3e34048-389e-473c-bf40-5668612f945b&quot;
}
}
</code></pre>
<h4>返回</h4>
<pre><code class="language-json">{
&quot;head&quot;: {
&quot;interfaceType&quot;: &quot;endorDutyCall&quot;,
&quot;orderNo&quot;: &quot;T202212182144146294162&quot;,
&quot;policySource&quot;: &quot;PHN_ZAZX&quot;,
&quot;respTime&quot;: &quot;2022-12-18 21:45:03&quot;,
&quot;reqTime&quot;: 1671371102835,
&quot;uuid&quot;: &quot;c3e34048-389e-473c-bf40-5668612f945b&quot;
},
&quot;respBody&quot;: {
&quot;dealCode&quot;: &quot;1&quot;,
&quot;dealDesc&quot;: &quot;处理成功&quot;
}
}
</code></pre>