3.11 退保退费通知接口
<p>请求模式：渠道→鸿雁平台</p>
<p>接口描述：退保退费信息通知，渠道方发起的退保通知保司端</p>
<p>测试接口地址：<a href="https://hermesgyb.zhlic.net/avatar/refund/surrenderRefundNotice">https://hermesgyb.zhlic.net/avatar/refund/surrenderRefundNotice</a></p>
<p>生产接口地址：<a href="https://gyb.zhlic.net/avatar/refund/surrenderRefundNotice">https://gyb.zhlic.net/avatar/refund/surrenderRefundNotice</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>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>surrenderReqDate</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>refundPlanDtoList</td>
<td>List</td>
<td>Y</td>
<td>每一期次的退费信息</td>
</tr>
</tbody>
</table>
<p><code>refundPlanDtoList</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>期次</td>
<td>payNo</td>
<td>Integer</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>本期退保保费</td>
<td>premium</td>
<td>Integer</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>退费时间</td>
<td>poaDate</td>
<td>Date</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>退费类型</td>
<td>poaType</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>退费包号</td>
<td>poaCode</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>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>