3.20 投诉退结果通知接口
<p>[TOC]</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><code>policySource</code></td>
<td><code>varchar</code></td>
<td>Y</td>
<td>保险公司分配给<br/>渠道方的渠道编码</td>
</tr>
<tr>
<td>请求时间</td>
<td><code>reqTime</code></td>
<td><code>DateTime</code></td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>接口类型</td>
<td><code>interfaceType</code></td>
<td><code>varchar</code></td>
<td>Y</td>
<td>针对每个接口，使用接口的<code>API</code>信息</td>
</tr>
<tr>
<td>订单号</td>
<td><code>orderNo</code></td>
<td><code>varchar</code></td>
<td>Y</td>
<td>贯穿保单始终的订单号，<br/>要求必须唯一，会进行幂等检查</td>
</tr>
<tr>
<td>唯一标识符</td>
<td><code>uuid</code></td>
<td><code>varchar</code></td>
<td>Y</td>
<td>单次请求唯一标识符，任一次请求不允许相同</td>
</tr>
</tbody>
</table>
<h3>请求体</h3>
<p><code>secondRefundReq</code></p>
<table>
<thead>
<tr>
<th>字段代码</th>
<th>字段名称</th>
<th>字段类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>policyNo</td>
<td>保单号</td>
<td>String</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>endorNo</td>
<td>批改号</td>
<td>String</td>
<td>N</td>
<td></td>
</tr>
<tr>
<td>refundTime</td>
<td>退费次数</td>
<td>Integer</td>
<td>N</td>
<td>TODO 不传或传2为二次退费, 传3为三次退费, 以此类推</td>
</tr>
<tr>
<td>secondRefundReqDate</td>
<td>二次退费申请时间</td>
<td>String</td>
<td>Y</td>
<td>yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td>secondSurrenderStatus</td>
<td>二次退保状态</td>
<td>Integer</td>
<td>Y</td>
<td>1-退保成功，2-退保失败</td>
</tr>
<tr>
<td>secondApproveTime</td>
<td>二次退保核批通过时间</td>
<td>String</td>
<td>N</td>
<td>yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td>secondRefundAmount</td>
<td>二次退费金额</td>
<td>BigDecimal</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>secondRefundOwner</td>
<td>退款方</td>
<td>Integer</td>
<td>Y</td>
<td>1-保司 2-渠道</td>
</tr>
<tr>
<td>installmentList</td>
<td>分期信息</td>
<td>List</td>
<td>Y</td>
<td></td>
</tr>
</tbody>
</table>
<p><code>installmentList</code></p>
<table>
<thead>
<tr>
<th>字段代码</th>
<th>字段名称</th>
<th>字段类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>payNo</td>
<td>期次</td>
<td>Integer</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>amount</td>
<td>本期退费金额</td>
<td>BigDecimal</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>dutyList</td>
<td>责任信息</td>
<td>List<object></td>
<td>N</td>
<td></td>
</tr>
</tbody>
</table>
<p><code>dutyList</code></p>
<table>
<thead>
<tr>
<th>字段代码</th>
<th>字段名称</th>
<th>类型</th>
<th>是否必传</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>dutyId</td>
<td>责任id</td>
<td>String</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>amount</td>
<td>退费金额</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>secondRefundResp</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;head&quot;: {
&quot;interfaceType&quot;: &quot;proposalOrder&quot;,
&quot;orderNo&quot;: &quot;QS221219154313290T12K25&quot;,
&quot;policySource&quot;: &quot;HN_HT_QNW&quot;,
&quot;reqTime&quot;: &quot;2022-12-19 15: 44: 21&quot;,
&quot;uuid&quot;: &quot;b5c9c977-8ba0-4ade-93c7-914ad0147342&quot;
},
&quot;secondRefundReq&quot;:{
&quot;policyNo&quot;:&quot;12345&quot;,
&quot;secondRefundReqDate&quot;:&quot;2021-05-10 12:00:00&quot;,
&quot;secondSurrenderStatus&quot;:1,
&quot;secondRefundPremium&quot;:22.2,
&quot;secondRefundOwner&quot;:2,
&quot;installmentList&quot;:[
{
&quot;payNo&quot;:2,
&quot;amount&quot;:22.2,
}
]
}
}
</code></pre>
<h4>返回</h4>
<pre><code class="language-json">{
&quot;secondRefundResp&quot;: {
&quot;dealCode&quot;: &quot;1&quot;,
&quot;dealDesc&quot;: &quot;成功&quot;
},
&quot;head&quot;: {
&quot;interfaceType&quot;: &quot;proposalOrder&quot;,
&quot;orderNo&quot;: &quot;QS221219154313290T12K25&quot;,
&quot;policySource&quot;: &quot;HN_HT_QNW&quot;,
&quot;respTime&quot;: 1671435862121,
&quot;uuid&quot;: &quot;b5c9c977-8ba0-4ade-93c7-914ad0147342&quot;
}
}</code></pre>