3.29 签约/解约状态同步接口(保司微信收银台缴费场景使用)
<p>[TOC]</p>
<p>请求模式:华农阿凡达平台→渠道方</p>
<p>接口描述:通知渠道方响应的签约状态信息</p>
<h3>请求头</h3>
<p><code>payTypeHead</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>payTypeBody</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>签/解保单信息</td>
<td>contractPolicys</td>
<td>List<ContractPolicy></td>
<td>Y</td>
<td>签约保单信息</td>
</tr>
<tr>
<td>结果状态</td>
<td>dealCode</td>
<td>varchar</td>
<td>Y</td>
<td>0-失败,1-成功 标识该次签约/解约动作成功or失败</td>
</tr>
<tr>
<td>结果描述</td>
<td>dealDesc</td>
<td>varchar</td>
<td>Y</td>
<td>成功、失败的结果描述</td>
</tr>
<tr>
<td>签/解保单信息</td>
<td>contractPolicys</td>
<td>List<ContractPolicy></td>
<td>Y</td>
<td>签约保单信息</td>
</tr>
</tbody>
</table>
<p><code>contractPolicys</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>CY</td>
<td>签约保单信息</td>
</tr>
<tr>
<td>保单号</td>
<td>policyNo</td>
<td>varchar</td>
<td>CY</td>
<td>0-失败,1-成功 标识该次签约/解约动作成功or失败</td>
</tr>
<tr>
<td>保单生效时间</td>
<td>effectTime</td>
<td>DateTime</td>
<td>Y</td>
<td>成功、失败的结果描述</td>
</tr>
<tr>
<td>保单失效时间</td>
<td>invalidTime</td>
<td>DateTime</td>
<td>Y</td>
<td>签约保单信息</td>
</tr>
<tr>
<td>签约状态</td>
<td>payType</td>
<td>varchar</td>
<td>Y</td>
<td>动作:1. 签约,2. 解约</td>
</tr>
<tr>
<td>签/解约时间</td>
<td>payDate</td>
<td>varchar</td>
<td>Y</td>
<td>针对对应场景,签约时间和解约时间</td>
</tr>
<tr>
<td>签约</td>
<td>changeType</td>
<td>varchar</td>
<td>CY</td>
<td>(微信)解约成功必传 DELETE--解约</td>
</tr>
<tr>
<td>签约协议号</td>
<td>contractCode</td>
<td>varchar</td>
<td>CY</td>
<td>(微信)解约成功必传</td>
</tr>
<tr>
<td>委托代扣协议号</td>
<td>contractId</td>
<td>varchar</td>
<td>CY</td>
<td>(微信)解约成功必传</td>
</tr>
<tr>
<td>协议解约方式</td>
<td>contractTerminationMode</td>
<td>varchar</td>
<td>CY</td>
<td>(微信)解约成功必传 1:有效期过自动解约(预留功能)2:用户主动解约 3:商户API解约 4:商户平台解约 5:注销(用户微信账户注销) 7:用户联系客服发起的解约</td>
</tr>
<tr>
<td>操作时间</td>
<td>operateTime</td>
<td>Date</td>
<td>CY</td>
<td>(微信)解约成功必传 yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td>签约模板id</td>
<td>planId</td>
<td>varchar</td>
<td>CY</td>
<td>(微信)解约成功必传</td>
</tr>
<tr>
<td>请求序列号</td>
<td>requestSerial</td>
<td>varchar</td>
<td>CY</td>
<td>(微信)解约成功必传</td>
</tr>
<tr>
<td>返回状态码</td>
<td>returnCode</td>
<td>varchar</td>
<td>CY</td>
<td>(微信)解约成功必传 SUCCESS/FAIL</td>
</tr>
<tr>
<td>返回信息,如非空,为错误原因</td>
<td>returnMsg</td>
<td>varchar</td>
<td>CY</td>
<td>(微信)解约成功必传 如:签名失败 等。</td>
</tr>
<tr>
<td>签名</td>
<td>sign</td>
<td>varchar</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>CY</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>proposalNo</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<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>