5.31 普通保单批改接口
<p>[TOC]</p>
<p>请求模式：渠道方→华农阿凡达平台</p>
<p>接口描述：用于批改保单投保人、被保人、保费保额、标的等信息</p>
<p>测试接口地址：<a href="https://porsche-avatar.chinahuanong.com.cn/avatar/endor/endorseInfo">https://porsche-avatar.chinahuanong.com.cn/avatar/endor/endorseInfo</a></p>
<p>生产接口地址：<a href="https://avatar.chinahuanong.com.cn/avatar/endor/endorseInfo">https://avatar.chinahuanong.com.cn/avatar/endor/endorseInfo</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>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>endorseBody</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>保单号</td>
<td>policyNo</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>批改流水号</td>
<td>posNo</td>
<td>varchar</td>
<td>Y</td>
<td>批改流水号，要求必须唯一，保司需落地幂等</td>
</tr>
<tr>
<td>批改申请时间</td>
<td>endorseTime</td>
<td>date</td>
<td>Y</td>
<td>yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td>批改生效时间</td>
<td>validDate</td>
<td>date</td>
<td>Y</td>
<td>yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td>保额</td>
<td>amount</td>
<td>BigDecimal</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>modAmount</td>
<td>BigDecimal</td>
<td>Y</td>
<td>会校验传入的保额变化量和 最终保额变化值是否一致(无变化量传0)</td>
</tr>
<tr>
<td>保费变化量</td>
<td>modPremium</td>
<td>BigDecimal</td>
<td>Y</td>
<td>会校验传入的保费变化量和 最终保费变化值是否一致(无变化量传0)</td>
</tr>
<tr>
<td>投保人信息</td>
<td><code>holderInfo</code></td>
<td><code>Object</code></td>
<td>CY</td>
<td>投保人信息，对象</td>
</tr>
<tr>
<td>被保人信息</td>
<td><code>insuredInfos</code></td>
<td><code>List&lt;InsuredInfo&gt;</code></td>
<td>CY</td>
<td>被保人的集合，对于非特殊要求，<br>一个集合下只能有一条数据</td>
</tr>
<tr>
<td>标的信息</td>
<td><code>targetInfoDtos</code></td>
<td><code>List&lt;TargetInfoDto&gt;</code></td>
<td>CY</td>
<td>针对不同的险种，标的信息不同</td>
</tr>
<tr>
<td>领款人信息</td>
<td><code>payeeInfo</code></td>
<td><code>Object</code></td>
<td>CY</td>
<td>保司退费时必传</td>
</tr>
<tr>
<td>被申请人详情列表</td>
<td><a href="#被申请人详情列表">respondentList</a></td>
<td>List</td>
<td>CY</td>
<td></td>
</tr>
</tbody>
</table>
<h4>投保人信息</h4>
<p><code>holderInfo</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>字段类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>名称</td>
<td>name</td>
<td>varchar</td>
<td>Y</td>
<td>根据类型，名称不同</td>
</tr>
<tr>
<td>证件类型</td>
<td>idType</td>
<td>varchar</td>
<td>Y</td>
<td>见证件类型码表</td>
</tr>
<tr>
<td>证件号码</td>
<td>idCode</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>性别</td>
<td>gender</td>
<td>varchar</td>
<td>Y</td>
<td>见码表</td>
</tr>
<tr>
<td>出生日期</td>
<td>birthday</td>
<td>date</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>证件有效起期</td>
<td>certiStartDate</td>
<td>date</td>
<td>CY</td>
<td>实名登记必传</td>
</tr>
<tr>
<td>证件有效止期</td>
<td>certiEndDate</td>
<td>date</td>
<td>CY</td>
<td>实名登记必传</td>
</tr>
<tr>
<td>手机号</td>
<td>mobile</td>
<td>varchar</td>
<td>CY</td>
<td>根据不同需求传入不同要求</td>
</tr>
<tr>
<td>邮箱</td>
<td>email</td>
<td>varchar</td>
<td>CY</td>
<td>根据不同需求传入不同要求</td>
</tr>
<tr>
<td>省</td>
<td>province</td>
<td>varchar</td>
<td>CY</td>
<td>企业时必传，国标码</td>
</tr>
<tr>
<td>市</td>
<td>city</td>
<td>varchar</td>
<td>CY</td>
<td>企业时必传，国标码</td>
</tr>
<tr>
<td>区</td>
<td>district</td>
<td>varchar</td>
<td>CY</td>
<td>企业时必传，国标码</td>
</tr>
<tr>
<td>详细地址</td>
<td>address</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>人员类型</td>
<td>type</td>
<td>varchar</td>
<td>Y</td>
<td>见码表</td>
</tr>
<tr>
<td>联系人地址</td>
<td>unitResidence</td>
<td>varchar</td>
<td>CY</td>
<td>企业时必传</td>
</tr>
<tr>
<td>联系人</td>
<td>linkerName</td>
<td>varchar</td>
<td>CY</td>
<td>企业时必传</td>
</tr>
<tr>
<td>联系人电话</td>
<td>linkerPhone</td>
<td>varchar</td>
<td>CY</td>
<td>企业时必传</td>
</tr>
<tr>
<td>行业类型(大类)</td>
<td>industryType1</td>
<td>varchar</td>
<td>CY</td>
<td>企业时必传 见码表</td>
</tr>
<tr>
<td>经营范围</td>
<td>businessScope</td>
<td>varchar</td>
<td>CY</td>
<td>信用险企业投保必传，这个责任险是非必传的</td>
</tr>
<tr>
<td>单位性质</td>
<td>unitType</td>
<td>varchar</td>
<td>CY</td>
<td>企业时必传 见码表</td>
</tr>
<tr>
<td>职业大类</td>
<td>occupationGrade</td>
<td>varchar</td>
<td>CY</td>
<td>保证保险标的必传</td>
</tr>
<tr>
<td>职业细类</td>
<td>occupationType</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>职业代码（工种）</td>
<td>occupationCode</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>扩展信息</td>
<td>extensionInfo</td>
<td>Object</td>
<td>CY</td>
<td>扩展信息</td>
</tr>
</tbody>
</table>
<h5>投保联系人扩展信息</h5>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>字段类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>联系人证件号</td>
<td>linkerIdentifyNo</td>
<td>varchar</td>
<td>N</td>
<td>企业必传</td>
</tr>
<tr>
<td>联系人证件类型</td>
<td>linkerIdentifyType</td>
<td>varchar</td>
<td>N</td>
<td>企业必传 证件类型 编码</td>
</tr>
<tr>
<td>公司地址</td>
<td>companyAddress</td>
<td>varchar</td>
<td>N</td>
<td>企业必传</td>
</tr>
<tr>
<td>就读学校</td>
<td>schoolName</td>
<td>varchar</td>
<td>N</td>
<td>就读学校</td>
</tr>
</tbody>
</table>
<h4>被保人信息</h4>
<p><code>insuredInfo</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>字段类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>字段名称</td>
<td>字段代码</td>
<td>类型</td>
<td>是否必传</td>
<td>说明</td>
</tr>
<tr>
<td>操作类型</td>
<td>flag</td>
<td>varchar</td>
<td>CY</td>
<td>I-批增 D-删除 U-修改（通过证件类型和证件号码匹配）</td>
</tr>
<tr>
<td>名称</td>
<td>name</td>
<td>varchar</td>
<td>Y</td>
<td>根据类型，名称不同</td>
</tr>
<tr>
<td>证件类型</td>
<td>idType</td>
<td>varchar</td>
<td>Y</td>
<td>见证件类型码表</td>
</tr>
<tr>
<td>证件号码</td>
<td>idCode</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>性别</td>
<td>gender</td>
<td>varchar</td>
<td>Y</td>
<td>见码表</td>
</tr>
<tr>
<td>出生日期</td>
<td>birthday</td>
<td>date</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>证件有效起期</td>
<td>certiStartDate</td>
<td>date</td>
<td>CY</td>
<td>实名登记必传</td>
</tr>
<tr>
<td>证件有效止期</td>
<td>certiEndDate</td>
<td>date</td>
<td>CY</td>
<td>实名登记必传</td>
</tr>
<tr>
<td>手机号</td>
<td>mobile</td>
<td>varchar</td>
<td>CY</td>
<td>根据不同需求传入不同要求</td>
</tr>
<tr>
<td>邮箱</td>
<td>email</td>
<td>varchar</td>
<td>CY</td>
<td>根据不同需求传入不同要求</td>
</tr>
<tr>
<td>省</td>
<td>province</td>
<td>varchar</td>
<td>CY</td>
<td>天气险必传、企业时必传，国标码</td>
</tr>
<tr>
<td>市</td>
<td>city</td>
<td>varchar</td>
<td>CY</td>
<td>天气险必传、企业时必传，国标码</td>
</tr>
<tr>
<td>区</td>
<td>district</td>
<td>varchar</td>
<td>CY</td>
<td>天气险必传、企业时必传，国标码</td>
</tr>
<tr>
<td>详细地址</td>
<td>address</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>人员类型</td>
<td>type</td>
<td>varchar</td>
<td>Y</td>
<td>见码表</td>
</tr>
<tr>
<td>和投保人关系</td>
<td>relType</td>
<td>Integer</td>
<td>Y</td>
<td>指被保人是投保人的： 1：本人 2：配偶 3：父母 4：子女 0：其他。</td>
</tr>
<tr>
<td>是否参加社保</td>
<td>hasSocial</td>
<td>Boolean</td>
<td>CY</td>
<td>当产品与被保人有无社保存在关系时必传。 当有社保时，传true。 当无社保时，传false。</td>
</tr>
<tr>
<td>联系人地址</td>
<td>unitResidence</td>
<td>varchar</td>
<td>CY</td>
<td>企业时必传</td>
</tr>
<tr>
<td>联系人</td>
<td>linkerName</td>
<td>varchar</td>
<td>CY</td>
<td>企业时必传</td>
</tr>
<tr>
<td>联系人电话</td>
<td>linkerPhone</td>
<td>varchar</td>
<td>CY</td>
<td>企业时必传</td>
</tr>
<tr>
<td>行业类型(大类)</td>
<td>industryType1</td>
<td>varchar</td>
<td>CY</td>
<td>企业时必传 见码表</td>
</tr>
<tr>
<td>经营范围</td>
<td>businessScope</td>
<td>varchar</td>
<td>CY</td>
<td>信用险企业投保必传，这个责任险是非必传的</td>
</tr>
<tr>
<td>单位性质</td>
<td>unitType</td>
<td>varchar</td>
<td>CY</td>
<td>企业时必传 见码表</td>
</tr>
<tr>
<td>职业大类</td>
<td>occupationGrade</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>职业细类</td>
<td>occupationType</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>职业代码（工种）</td>
<td>occupationCode</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>扩展信息</td>
<td>extensionInfo</td>
<td>Object</td>
<td>CY</td>
<td>扩展信息</td>
</tr>
</tbody>
</table>
<h5>被保人信息扩展信息</h5>
<p><code>extensionInfo</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>字段类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>字段名称</td>
<td>字段代码</td>
<td>类型</td>
<td>是否必传</td>
<td>说明</td>
</tr>
<tr>
<td>就读学校</td>
<td>schoolName</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>联系人证件号</td>
<td>linkerIdentifyNo</td>
<td>varchar</td>
<td>N</td>
<td>企业必传</td>
</tr>
<tr>
<td>联系人证件类型</td>
<td>linkerIdentifyType</td>
<td>varchar</td>
<td>N</td>
<td>企业必传 证件类型 编码</td>
</tr>
<tr>
<td>公司地址</td>
<td>companyAddress</td>
<td>varchar</td>
<td>N</td>
<td>企业必传</td>
</tr>
</tbody>
</table>
<h4>领款人信息实体</h4>
<p><code>payeeInfo</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>Y</td>
<td>payeeName</td>
</tr>
<tr>
<td>收款人类型</td>
<td>payeeType</td>
<td>varchar</td>
<td>CY</td>
<td>1-投保人 2-被保人 3-其他</td>
</tr>
<tr>
<td>收款账号</td>
<td>account</td>
<td>varchar</td>
<td>Y</td>
<td>资金退必传</td>
</tr>
<tr>
<td>收款账户名称</td>
<td>accountName</td>
<td>varchar</td>
<td>Y</td>
<td>资金退必传</td>
</tr>
<tr>
<td>开户行联行号</td>
<td>bankType</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>
</tbody>
</table>
<h4>标的信息</h4>
<p><code>TargetInfoDto</code></p>
<p>> ###### <strong>1770 诉讼财产保全责任保险标的信息</strong></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>字段类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>责任险保单基础</td>
<td>liabilityInsuranceBase</td>
<td>varchar</td>
<td>Y</td>
<td>1：事故发生制 2：索赔提出制</td>
</tr>
<tr>
<td>是否填写风险问询表</td>
<td>isFillInRiskInquiry</td>
<td>varchar</td>
<td>Y</td>
<td>1：是 0：否</td>
</tr>
<tr>
<td>风险问询表号</td>
<td>riskInquiryformno</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>保全方式</td>
<td>preserveWay</td>
<td>varchar</td>
<td>Y</td>
<td>01：查封 02：扣押 03：冻结 99：其他</td>
</tr>
<tr>
<td>保全标的</td>
<td>preserveUnderlying</td>
<td>varchar</td>
<td>Y</td>
<td>1000：房产、土地 0100：机器设备、存货 0010：股票、债券 1100：银行存款 0001：其他</td>
</tr>
<tr>
<td>诉讼案件类型</td>
<td>litigationType</td>
<td>varchar</td>
<td>Y</td>
<td>01：经济纠纷02：婚姻继承纠纷03：人身损害赔偿04：知识产权纠纷05：不动产纠纷06：其他07：机动车交通事故责任纠纷08：民间借贷纠纷09：金融借款合同纠纷10：劳动争议、人事争议11：建设工程合同纠纷12：买卖合同纠纷13：物权纠纷14：委托合同纠纷</td>
</tr>
<tr>
<td>诉讼状态</td>
<td>litigationStatus</td>
<td>varchar</td>
<td>Y</td>
<td>01：前02：中</td>
</tr>
<tr>
<td>申请人</td>
<td>proposer</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>申请人诉讼角色</td>
<td>litigationRole</td>
<td>varchar</td>
<td>Y</td>
<td>01：一审被告02：一审原告03：其他</td>
</tr>
<tr>
<td>委托律所</td>
<td>entrustLawFirms</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>被申请人</td>
<td>respondent</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>法院名称</td>
<td>courtName</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>保全标的描述</td>
<td>preserveUnderlyingDescribe</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>当前保全资产总价值</td>
<td>preserveTotalValue</td>
<td>BigDecimal</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>报告起始日期</td>
<td>reportStartDate</td>
<td>Date</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>报告终止日期</td>
<td>reportEndDate</td>
<td>Date</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>追溯起期</td>
<td>backStartDate</td>
<td>Date</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>追溯止期</td>
<td>backEndDate</td>
<td>Date</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>追溯期限(天数)</td>
<td>backDays</td>
<td>Integer</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>保全财产</td>
<td>fieldAA</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>立案号</td>
<td>fieldAD</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
</tbody>
</table>
<h5>被申请人详情列表</h5>
<p><code>respondentList</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>字段类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>操作类型</td>
<td>flag</td>
<td>varchar</td>
<td>Y</td>
<td>I-批增 D-删除 U-修改</td>
</tr>
<tr>
<td>证件类型</td>
<td>idType</td>
<td>varchar</td>
<td>Y</td>
<td>见证件类型码表密文投保传 99:其他明文投保传 6:统一社会信用编码</td>
</tr>
<tr>
<td>被申请人姓名</td>
<td>name</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>被申请人证件号码</td>
<td>idCode</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>被申请人联系方式</td>
<td>mobile</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
</tbody>
</table>
<h3>响应头</h3>
<p><code>respHead</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>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>