3.38 暂不使用-团单模式-综合批改-团单批改/生成批单请求接口
<p>[TOC]</p>
<p>请求模式：渠道方→华农阿凡达平台</p>
<p>接口描述：团单批改请求接口/团单批单生成接口
根据批改请求表示是否是试算产生不同的结果
<strong>生成批单之前必须进行批单试算</strong>。</p>
<p>测试接口地址：<a href="https://porsche-avatar.chinahuanong.com.cn/avatar/endor/comprehensiveEndorse">https://porsche-avatar.chinahuanong.com.cn/avatar/endor/comprehensiveEndorse</a></p>
<p>生产接口地址：<a href="https://avatar.chinahuanong.com.cn/avatar/endor/comprehensiveEndorse">https://avatar.chinahuanong.com.cn/avatar/endor/comprehensiveEndorse</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>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>endorseInsuredIdBody</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>本次批改类型 <strong>试算or生成批单</strong></td>
<td>transCode</td>
<td>varchar</td>
<td>Y</td>
<td>endorseCalculation-批改试算 </br> endorseCorrect-生成批单</td>
</tr>
<tr>
<td>保单号</td>
<td>policyNo</td>
<td>varchar</td>
<td>Y</td>
<td>所有期次保费总额</td>
</tr>
<tr>
<td>批改申请日期</td>
<td>endorDate</td>
<td>DateTime</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>批改生效日期</td>
<td>validDate</td>
<td>DateTime</td>
<td>CY</td>
<td>针对每个接口，使用接口的API信息</td>
</tr>
<tr>
<td>批改生效小时</td>
<td>validHour</td>
<td>Integer</td>
<td>CY</td>
<td>贯穿保单始终的订单号， 要求必须唯一，会进行幂等检查</td>
</tr>
<tr>
<td>批改类型</td>
<td>endorType</td>
<td>varchar</td>
<td>Y</td>
<td>08-批改人员信息</td>
</tr>
<tr>
<td>批改人员保费计算类型</td>
<td>shortRateID</td>
<td>varchar</td>
<td>CY</td>
<td>1-日比例2-月比例3-短期费率表4-不计批改类型为08时必传</td>
</tr>
<tr>
<td>领款人信息</td>
<td>prpPpayeeVos</td>
<td>object</td>
<td>CY</td>
<td>资金退条件必传</td>
</tr>
<tr>
<td>批改人员清单集合</td>
<td>List<insuredIdList></td>
<td>List</td>
<td>Y</td>
<td>批改类型为08时必传</td>
</tr>
</tbody>
</table>
<h3>领款人信息实体</h3>
<p><code>prpPpayeeVos</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>收款人姓名</td>
<td>payeeName</td>
<td>varchar</td>
<td>CY payeeName</td>
<td></td>
</tr>
<tr>
<td>收款人类型</td>
<td>payeeType</td>
<td>varchar</td>
<td>CY</td>
<td>C-法人 N-自然人</td>
</tr>
<tr>
<td>收款人证件类型</td>
<td>payeeIdType</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>证件号码</td>
<td>payeeId</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>payeeAccountCode</td>
<td>varchar</td>
<td>CY</td>
<td>资金退必传</td>
</tr>
<tr>
<td>银行类型</td>
<td>bankTypeCode</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>开户行地区</td>
<td>bankTypeName</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>开户行地区</td>
<td>openAccountAddress</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>开户行名称</td>
<td>openAccountAddressName</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>支付方式</td>
<td>coinsClaimInd</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>收款账号</td>
<td>account</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>收款账户名称</td>
<td>accountName</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>联行号</td>
<td>bankCode</td>
<td>varchar</td>
<td>CY</td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<p><code>insuredIdList</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>证件类型</td>
<td>idType</td>
<td>varchar</td>
<td>Y</td>
<td>见证件类型码表</td>
</tr>
<tr>
<td>被保险人名称</td>
<td>insuredName</td>
<td>String</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>被保人证件号码</td>
<td>idCode</td>
<td>varchar</td>
<td>Y</td>
<td>针对每个接口，使用接口的API信息</td>
</tr>
<tr>
<td>旧的被保人证件号码</td>
<td>oldIdCode</td>
<td>varchar</td>
<td>CY</td>
<td>人员信息修改（操作类型为U）<strong>必传</strong>旧的被保人证件号</td>
</tr>
<tr>
<td>方案序号</td>
<td>rationNo</td>
<td>varchar</td>
<td>Y</td>
<td>默认1</td>
</tr>
<tr>
<td>生日</td>
<td>birthday</td>
<td>Date</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>性别</td>
<td>sex</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>职业类别代码</td>
<td>occupationCode</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>社保情况</td>
<td>marriage</td>
<td>varchar</td>
<td>CY</td>
<td>01-有社保；02-无社保</td>
</tr>
<tr>
<td>电话号码</td>
<td>phoneNo</td>
<td>varchar</td>
<td>N</td>
<td></td>
</tr>
<tr>
<td>联系地址</td>
<td>addressNo</td>
<td>varchar</td>
<td>N</td>
<td></td>
</tr>
<tr>
<td>证件有效起期</td>
<td>certiStartDate</td>
<td>Date</td>
<td>N</td>
<td></td>
</tr>
<tr>
<td>证件有效止期</td>
<td>certiEndDate</td>
<td>Date</td>
<td>N</td>
<td></td>
</tr>
<tr>
<td>操作类型</td>
<td>flag</td>
<td>varchar</td>
<td>Y</td>
<td>I-批增 D-批减 U-人员信息变更</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>chgPremium</td>
<td>varchar</td>
<td>Y</td>
<td>保费变化量，根据批改被保人可能为负数，保留两位小数，单位为元（示例：-5.00）</td>
</tr>
<tr>
<td>保单号</td>
<td>policyNo</td>
<td>varchar</td>
<td>Y</td>
<td>保单号</td>
</tr>
<tr>
<td>批单号</td>
<td>endorseNo</td>
<td>varchar</td>
<td>CY</td>
<td>批单号，试算流程不返回</td>
</tr>
<tr>
<td>批文</td>
<td>endorContext</td>
<td>varchar</td>
<td>CY</td>
<td>批文，试算流程不返回</td>
</tr>
<tr>
<td>电子批单地址</td>
<td>endorseUrl</td>
<td>varchar</td>
<td>CY</td>
<td>电子批单地址，试算流程不返回</td>
</tr>
<tr>
<td>缴费链接</td>
<td>payUrl</td>
<td>varchar</td>
<td>CY</td>
<td>试算请求，保费变化量大于0时，保司收银台缴费必传</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>