3.10 退保通知接口
<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>refundNoticeBody</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>Y</td>
<td></td>
</tr>
<tr>
<td>退保类型</td>
<td>refundType</td>
<td>varchar</td>
<td>Y</td>
<td>退保类型（核心返回类型）<br> 0-正常退：以下除外的所有场景 <br>1-全额退：非犹豫期内，倒签情况下的保费全退场景 <br>2-犹豫期内退保：批改生效日期和批改日期均在犹豫期内的退保场景 <br>3-当期退：通过通融退接口退保且除第一期保费外其他期次整期退保的场景 <br>4-未生效退保：保单未起保发起的退保场景 <br>5-脱保退保 <br><del>6-满期后退保</del> <br> <del>87-理赔解约退保</del></td>
</tr>
<tr>
<td>退保生效时间</td>
<td>refundEffectTime</td>
<td>DateTime</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>核批通知时间</td>
<td>undwrtEndDate</td>
<td>DateTime</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>退保保费</td>
<td>refundPremium</td>
<td>BigDecimal</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>缴费计划信息</td>
<td>installmentsDetails</td>
<td>List<Object></td>
<td>Y</td>
<td>每一期次的缴费信息</td>
</tr>
<tr>
<td>退保批单</td>
<td>refundEleUrl</td>
<td>varchar</td>
<td>CY</td>
<td>退保批单链接</td>
</tr>
</tbody>
</table>
<p><code>installmentsDetail</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>期次</td>
<td>num</td>
<td>Integer</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>本期应收金额</td>
<td>paymentAmount</td>
<td>Integer</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>本期退款金额</td>
<td>refundAmount</td>
<td>Integer</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>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;interfaceType&quot;: &quot;refundNotice&quot;,
&quot;orderNo&quot;: &quot;T202212061421334356257&quot;,
&quot;policySource&quot;: &quot;PHN_ZAZX&quot;,
&quot;reqTime&quot;: 1671174972039,
&quot;uuid&quot;: &quot;d33fc78d-c44a-4f7d-8866-35682656b515&quot;
},
&quot;refundNoticeBody&quot;: {
&quot;endorseNo&quot;: &quot;X00272634220121341579_001&quot;,
&quot;installmentsDetails&quot;: [
{
&quot;num&quot;: 1,
&quot;paymentAmount&quot;: 121.00,
&quot;refundAmount&quot;: 121.00
},
{
&quot;num&quot;: 2,
&quot;paymentAmount&quot;: 121.00,
&quot;refundAmount&quot;: 0.00
},
{
&quot;num&quot;: 3,
&quot;paymentAmount&quot;: 121.00,
&quot;refundAmount&quot;: 0.00
},
{
&quot;num&quot;: 4,
&quot;paymentAmount&quot;: 121.00,
&quot;refundAmount&quot;: 0.00
},
{
&quot;num&quot;: 5,
&quot;paymentAmount&quot;: 121.00,
&quot;refundAmount&quot;: 0.00
},
{
&quot;num&quot;: 6,
&quot;paymentAmount&quot;: 121.00,
&quot;refundAmount&quot;: 0.00
},
{
&quot;num&quot;: 7,
&quot;paymentAmount&quot;: 121.00,
&quot;refundAmount&quot;: 0.00
},
{
&quot;num&quot;: 8,
&quot;paymentAmount&quot;: 121.00,
&quot;refundAmount&quot;: 0.00
},
{
&quot;num&quot;: 9,
&quot;paymentAmount&quot;: 121.00,
&quot;refundAmount&quot;: 0.00
},
{
&quot;num&quot;: 10,
&quot;paymentAmount&quot;: 121.00,
&quot;refundAmount&quot;: 0.00
},
{
&quot;num&quot;: 11,
&quot;paymentAmount&quot;: 121.00,
&quot;refundAmount&quot;: 0.00
},
{
&quot;num&quot;: 12,
&quot;paymentAmount&quot;: 121.00,
&quot;refundAmount&quot;: 0.00
}
],
&quot;policyNo&quot;: &quot;X00272634220121341579&quot;,
&quot;refundEffectTime&quot;: 1670342400000,
&quot;refundPremium&quot;: 121.00,
&quot;refundType&quot;: &quot;2&quot;
}
}
</code></pre>
<h4>返回</h4>
<pre><code class="language-json">{
&quot;head&quot;: {
&quot;interfaceType&quot;: &quot;refundNotice&quot;,
&quot;orderNo&quot;: &quot;T202212061421334356257&quot;,
&quot;policySource&quot;: &quot;PHN_ZAZX&quot;,
&quot;respTime&quot;: &quot;2022-12-16 15:16:13&quot;,
&quot;reqTime&quot;: 1671174972039,
&quot;uuid&quot;: &quot;d33fc78d-c44a-4f7d-8866-35682656b515&quot;
},
&quot;respBody&quot;: {
&quot;dealCode&quot;: &quot;1&quot;,
&quot;policyNo&quot;: &quot;X00272634220121341579&quot;,
&quot;dealDesc&quot;: &quot;处理成功&quot;
}
}</code></pre>