3.13 团单模式-承保接口
<p>[TOC]</p>
<p>请求模式:渠道方→鸿雁平台</p>
<p>接口描述:团单承保</p>
<p>测试接口地址:<a href="https://hermesgyb.zhlic.net/avatar/general/groupPolicyOrder">https://hermesgyb.zhlic.net/avatar/general/groupPolicyOrder</a></p>
<p>生产接口地址:<a href="https://gyb.zhlic.net/avatar/general/groupPolicyOrder">https://gyb.zhlic.net/avatar/general/groupPolicyOrder</a></p>
<h3>请求头</h3>
<p><code>avatarPolicyHead</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>avatarPolicyBody</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>总保费</td>
<td>sumPremium</td>
<td>BigDecimal</td>
<td>Y</td>
<td>所有期次保费总额</td>
</tr>
<tr>
<td>保费</td>
<td>periodPremium</td>
<td>BigDecimal</td>
<td>Y</td>
<td>当期保费</td>
</tr>
<tr>
<td>缴费保费</td>
<td>payPremium</td>
<td>BigDecimal</td>
<td>Y</td>
<td>缴费使用的保费</td>
</tr>
<tr>
<td>缴费时间</td>
<td>payDate</td>
<td>DateTime</td>
<td>Y</td>
<td>付款时间</td>
</tr>
<tr>
<td>投保单信息</td>
<td>proposalOrders</td>
<td>List<ProposalOrder></td>
<td>Y</td>
<td>投保单相关信息</td>
</tr>
<tr>
<td>流水号</td>
<td>serialNum</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
</tbody>
</table>
<p><code>proposalOrder</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>
</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>policyOrders</td>
<td>List</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>
<p><code>policyOrder</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>Y</td>
<td>保单信息的唯一标识</td>
</tr>
<tr>
<td>电子保单下载地址</td>
<td>elecPolicyUrl</td>
<td>varchar</td>
<td>Y</td>
<td>电子保单信息</td>
</tr>
<tr>
<td>被保人证件号</td>
<td>insuredIdCode</td>
<td>varchar</td>
<td>N</td>
<td>被保人证件号</td>
</tr>
<tr>
<td>生效时间</td>
<td>effectiveTime</td>
<td>varchar</td>
<td>Y</td>
<td>生效时间</td>
</tr>
<tr>
<td>失效时间</td>
<td>expireTime</td>
<td>varchar</td>
<td>Y</td>
<td>失效时间</td>
</tr>
<tr>
<td>承保时间</td>
<td>insureTime</td>
<td>varchar</td>
<td>Y</td>
<td>承保时间</td>
</tr>
<tr>
<td>总保费</td>
<td>sumPremium</td>
<td>BigDecimal</td>
<td>Y</td>
<td>总保费</td>
</tr>
</tbody>
</table>
<h3>报文示例</h3>
<h4>请求</h4>
<pre><code class="language-json">{
&quot;avatarPolicyHead&quot;: {
&quot;policySource&quot;: &quot;HN_ZY&quot;,
&quot;reqTime&quot;: &quot;2022-12-19 02:04:12&quot;,
&quot;interfaceType&quot;: &quot;groupPolicyOrder&quot;,
&quot;orderNo&quot;: &quot;HNPN000000000000120276&quot;,
&quot;uuid&quot;: &quot;5660d315d5e6452c802c4f0bca2c3519&quot;
},
&quot;avatarPolicyBody&quot;: {
&quot;sumPremium&quot;: 7720.00,
&quot;periodPremium&quot;: 20.00,
&quot;payPremium&quot;: 7720.00,
&quot;payDate&quot;: &quot;2022-12-19 02:04:12&quot;,
&quot;proposalOrders&quot;: [
{
&quot;proposalNo&quot;: &quot;Y00270313220001558856&quot;
}
],
&quot;serialNum&quot;: &quot;984f7c4e696b421c910c8f42169ec339&quot;
}
}
</code></pre>
<h4>返回</h4>
<pre><code class="language-json">{
&quot;head&quot;: {
&quot;interfaceType&quot;: &quot;groupPolicyOrder&quot;,
&quot;orderNo&quot;: &quot;HNPN000000000000120276&quot;,
&quot;policySource&quot;: &quot;HN_ZY&quot;,
&quot;respTime&quot;: 1671386652870,
&quot;uuid&quot;: &quot;5660d315d5e6452c802c4f0bca2c3519&quot;
},
&quot;respBody&quot;: {
&quot;dealCode&quot;: &quot;1&quot;,
&quot;dealDesc&quot;: &quot;成功&quot;,
&quot;policyOrders&quot;: [
{
&quot;effectiveTime&quot;: &quot;2022-12-20 00:00:00&quot;,
&quot;elecPolicyUrl&quot;: &quot;https://avatar.chinahuanong.com.cn/avatar/elec/download?data=FeRygPLHQTxVbewhQMMc2GEbKrOyyMW5rsij4mWX4wA=&amp;sign=56E0FD15E978C3A583E1A9CEF4833AFE&quot;,
&quot;expireTime&quot;: &quot;2023-01-20 00:00:00&quot;,
&quot;insureTime&quot;: &quot;2022-12-19 01:35:50&quot;,
&quot;policyNo&quot;: &quot;X00270313220001558858&quot;,
&quot;proposalNo&quot;: &quot;Y00270313220001558856&quot;,
&quot;sumPremium&quot;: 7720.00
}
]
}
}
</code></pre>