5.2 出单通知接口(华农收银台代收出单回调接口)
<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>格式为:yyyy-MM-dd HH:mm:ss。</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>policyNotice</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>投保单号</td>
<td>proposalNo</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>保单号</td>
<td>policyNo</td>
<td>varchar</td>
<td>CY</td>
<td>状态码为1时必传</td>
</tr>
<tr>
<td>上一年保单号</td>
<td>parentPolicyNo</td>
<td>varchar</td>
<td>CY</td>
<td>状态码为1时且续保必传</td>
</tr>
<tr>
<td>出单时间</td>
<td>policyCreateTime</td>
<td>DateTime</td>
<td>CY</td>
<td>状态码为1时必传</td>
</tr>
<tr>
<td>保单生效时间</td>
<td>effectTime</td>
<td>DateTime</td>
<td>CY</td>
<td>状态码为1时必传</td>
</tr>
<tr>
<td>保单失效时间</td>
<td>invalidTime</td>
<td>DateTime</td>
<td>CY</td>
<td>状态码为1时必传</td>
</tr>
<tr>
<td>电子保单下载地址</td>
<td>elecPolicyUrl</td>
<td>varchar</td>
<td>CY</td>
<td>状态码为1时必传电子保单信息</td>
</tr>
<tr>
<td>电子保函下载地址</td>
<td>eletterPolicyUrl</td>
<td>varchar</td>
<td>CY</td>
<td>状态码为1时必传电子保函信息</td>
</tr>
<tr>
<td>电子保函下载地址列表</td>
<td>eletterPolicyList</td>
<td>List</td>
<td>CY</td>
<td>电子保函信息List</td>
</tr>
<tr>
<td>分期信息</td>
<td>paymentPlanList</td>
<td>List<object></td>
<td>CY</td>
<td>状态码为1时必传</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>
<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>payno</td>
<td>Integer</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>保费</td>
<td>premium</td>
<td>BigDecimal</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>交费开始时间</td>
<td>startTime</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>宽限期截止时间</td>
<td>endTime</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>缴费状态</td>
<td>payFlag</td>
<td>varchar</td>
<td>CY</td>
<td>0:未缴费 2:已缴费</td>
</tr>
<tr>
<td>支付时间</td>
<td>payTime</td>
<td>DateTime</td>
<td>CY</td>
<td>yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td>支付方式</td>
<td>payMode</td>
<td>varchar</td>
<td>Y</td>
<td>0000:线下转账,0001:微信支付</td>
</tr>
<tr>
<td>支付账户开户行联行号</td>
<td>payeeBankCode</td>
<td>varchar</td>
<td>CY</td>
<td>线下支付必传</td>
</tr>
<tr>
<td>支付账户开户行名称</td>
<td>payeeBankName</td>
<td>varchar</td>
<td>CY</td>
<td>线下支付必传</td>
</tr>
<tr>
<td>支付账户</td>
<td>payeeAccountCode</td>
<td>varchar</td>
<td>CY</td>
<td>线下支付必传</td>
</tr>
<tr>
<td>支付账户名称</td>
<td>payeeAccountName</td>
<td>varchar</td>
<td>CY</td>
<td>线下支付必传</td>
</tr>
<tr>
<td>收款账户</td>
<td>subAccNum</td>
<td>varchar</td>
<td>CY</td>
<td>线下支付必传</td>
</tr>
<tr>
<td>收款账户名称</td>
<td>subAccName</td>
<td>varchar</td>
<td>CY</td>
<td>线下支付必传</td>
</tr>
<tr>
<td>收款账户银行开户行号</td>
<td>subAccBankNo</td>
<td>varchar</td>
<td>CY</td>
<td>线下支付必传</td>
</tr>
<tr>
<td>收款账户开户行名称</td>
<td>subAccBankName</td>
<td>varchar</td>
<td>CY</td>
<td>线下支付必传</td>
</tr>
</tbody>
</table>
<h5>电子保函下载地址列表</h5>
<p><code>eletterPolicyList</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>字段类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>名称</td>
<td><code>eletterPolicyName</code></td>
<td><code>varchar</code></td>
<td>CY</td>
<td>保函名称</td>
</tr>
<tr>
<td>地址</td>
<td><code>eletterPolicyUrl</code></td>
<td><code>varchar</code></td>
<td>CY</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>
<tr>
<td>保单号</td>
<td>policyNo</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;paySucc&quot;,
&quot;orderNo&quot;: &quot;P2212181104155571815&quot;,
&quot;policySource&quot;: &quot;HN_NY&quot;,
&quot;reqTime&quot;: 1671332732548,
&quot;uuid&quot;: &quot;ae841fcc-9518-40d4-bb25-f758eb3ecc9f&quot;
},
&quot;policyNotice&quot;: {
&quot;dealCode&quot;: &quot;1&quot;,
&quot;effectTime&quot;: 1671379200000,
&quot;elecPolicyUrl&quot;: &quot;https://avatar.chinahuanong.com.cn/avatar/elec/download?data=Kj85jWzKjBTWFj0m6bHDl3ETkCqjdIfyMGX6PkyqBFo=&amp;sign=B6563D46E87489BAD07EF44CF4EBAA3A&quot;,
&quot;invalidTime&quot;: 1702915200000,
&quot;policyNo&quot;: &quot;X51012740220000024784&quot;,
&quot;proposalNo&quot;: &quot;Y51012740220000025171&quot;
}
}
</code></pre>
<h4>返回</h4>
<pre><code class="language-json">{
&quot;head&quot;: {
&quot;interfaceType&quot;: &quot;policyOrder&quot;,
&quot;orderNo&quot;: &quot;P2212181104155571815&quot;,
&quot;policySource&quot;: &quot;HN_NY&quot;,
&quot;reqTime&quot;: 1671332732672,
&quot;uuid&quot;: &quot;HN_NY4505_1671332732672&quot;
},
&quot;respBody&quot;: {
&quot;policyNo&quot;: &quot;X51012740220000024784&quot;,
&quot;dealCode&quot;: &quot;1&quot;,
&quot;dealDesc&quot;: &quot;处理成功&quot;
}
}
</code></pre>