星灿保代保险平台接口文档

苏宁保与外部的接口文档


预核保请求

<h2>接口概述</h2> <p>交易类型:14 在上一年保单到期前,保险公司对该保单是否可以续保,可先进行预核保,预核保通过即允许用户续保,将通过短信、push、微信消息、电话等方式,引导用户进行次年投保。该接口非必须。</p> <h2>请求数据</h2> <h5>订单信息(Order):</h5> <table> <thead> <tr> <th style="text-align: left;">No.</th> <th style="text-align: left;">字段</th> <th style="text-align: left;">字段名</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">必传</th> <th style="text-align: left;">备注</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">1</td> <td style="text-align: left;">OrderId</td> <td style="text-align: left;">订单号</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">苏宁保险订单号</td> </tr> <tr> <td style="text-align: left;">2</td> <td style="text-align: left;">OriginalPolicyNo</td> <td style="text-align: left;">原保单号</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">待续保的订单的保单号</td> </tr> <tr> <td style="text-align: left;">3</td> <td style="text-align: left;">TotalPremium</td> <td style="text-align: left;">总保费</td> <td style="text-align: left;">数值</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">上一年保单投保时支付的金额。以分为单位。</td> </tr> <tr> <td style="text-align: left;">4</td> <td style="text-align: left;">ApplyNum</td> <td style="text-align: left;">保险份数</td> <td style="text-align: left;">数值</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">常规险种默认1,即使多被保人,仍然填写1</td> </tr> <tr> <td style="text-align: left;">5</td> <td style="text-align: left;">OriginalInsBeginDate</td> <td style="text-align: left;">原保单保险起期</td> <td style="text-align: left;">时间</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">6</td> <td style="text-align: left;">OriginalInsEndDate</td> <td style="text-align: left;">原保单保险止期</td> <td style="text-align: left;">时间</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">7</td> <td style="text-align: left;">RenewalInsBeginDate</td> <td style="text-align: left;">续保单保险起期</td> <td style="text-align: left;">时间</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">8</td> <td style="text-align: left;">RenewalInsEndDate</td> <td style="text-align: left;">续保单保险止期</td> <td style="text-align: left;">时间</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">yyyy-MM-dd HH:mm:ss</td> </tr> </tbody> </table> <h5>险种信息(Item):</h5> <table> <thead> <tr> <th style="text-align: left;">No.</th> <th style="text-align: left;">字段</th> <th style="text-align: left;">字段名</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">必传</th> <th style="text-align: left;">备注</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">1</td> <td style="text-align: left;">MerchantCode</td> <td style="text-align: left;">商家代码</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">默认RE5106,代表星灿保代</td> </tr> <tr> <td style="text-align: left;">2</td> <td style="text-align: left;">ProductCode</td> <td style="text-align: left;">保险公司险种代码</td> <td style="text-align: left;">数值</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">保险公司定义的险种代码</td> </tr> <tr> <td style="text-align: left;">3</td> <td style="text-align: left;">ProductName</td> <td style="text-align: left;">产品名称</td> <td style="text-align: left;">数值</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">保险公司签约险种名称</td> </tr> <tr> <td style="text-align: left;">4</td> <td style="text-align: left;">Amount</td> <td style="text-align: left;">保额</td> <td style="text-align: left;">数值</td> <td style="text-align: left;">N</td> <td style="text-align: left;">以分为单位</td> </tr> </tbody> </table> <h5>投保人信息(HolderInfo):</h5> <table> <thead> <tr> <th style="text-align: left;">No.</th> <th style="text-align: left;">字段</th> <th style="text-align: left;">字段名</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">必传</th> <th style="text-align: left;">备注</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">1</td> <td style="text-align: left;">HolderName</td> <td style="text-align: left;">投保人姓名</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">2</td> <td style="text-align: left;">HolderEmail</td> <td style="text-align: left;">投保人电子邮件</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">3</td> <td style="text-align: left;">HolderCardType</td> <td style="text-align: left;">投保人证件类型</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">详见<a href="https://www.showdoc.com.cn/snisc/8799604614404574" title="通用字段定义">通用字段定义</a></td> </tr> <tr> <td style="text-align: left;">4</td> <td style="text-align: left;">HolderCardNo</td> <td style="text-align: left;">投保人证件号</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">5</td> <td style="text-align: left;">HolderBirthday</td> <td style="text-align: left;">投保人出生日期</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">6</td> <td style="text-align: left;">HolderSex</td> <td style="text-align: left;">投保人性别</td> <td style="text-align: left;">数值</td> <td style="text-align: left;">N</td> <td style="text-align: left;">1:男 2:女</td> </tr> <tr> <td style="text-align: left;">7</td> <td style="text-align: left;">HolderMobile</td> <td style="text-align: left;">投保人手机号</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">8</td> <td style="text-align: left;">ResidentProvince</td> <td style="text-align: left;">常住地区-省</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;">国标码</td> </tr> <tr> <td style="text-align: left;">9</td> <td style="text-align: left;">ResidentCity</td> <td style="text-align: left;">常住地区-市</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;">国标码</td> </tr> <tr> <td style="text-align: left;">10</td> <td style="text-align: left;">HolderAddress</td> <td style="text-align: left;">投保人地址</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">11</td> <td style="text-align: left;">HolderZip</td> <td style="text-align: left;">投保人邮编</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">12</td> <td style="text-align: left;">ServiceArea</td> <td style="text-align: left;">投保人服务区编码</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> </tbody> </table> <h5>被保人信息(InsuredInfo):</h5> <table> <thead> <tr> <th style="text-align: left;">No.</th> <th style="text-align: left;">字段</th> <th style="text-align: left;">字段名</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">必传</th> <th style="text-align: left;">备注</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">1</td> <td style="text-align: left;">InsuredName</td> <td style="text-align: left;">被保人姓名</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">2</td> <td style="text-align: left;">InsuredEmail</td> <td style="text-align: left;">被保人电子邮件</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">3</td> <td style="text-align: left;">InsuredCardType</td> <td style="text-align: left;">被保人证件类型</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;">详见<a href="https://www.showdoc.com.cn/snisc/8799604614404574" title="通用字段定义">通用字段定义</a></td> </tr> <tr> <td style="text-align: left;">4</td> <td style="text-align: left;">InsuredCardNo</td> <td style="text-align: left;">被保人证件号</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">5</td> <td style="text-align: left;">InsuredBirthday</td> <td style="text-align: left;">被保人出生日期</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">6</td> <td style="text-align: left;">InsuredSex</td> <td style="text-align: left;">被保人性别</td> <td style="text-align: left;">数值</td> <td style="text-align: left;">N</td> <td style="text-align: left;">1:男 2:女</td> </tr> <tr> <td style="text-align: left;">7</td> <td style="text-align: left;">InsuredMobile</td> <td style="text-align: left;">被保人手机号</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">8</td> <td style="text-align: left;">ResidentProvince</td> <td style="text-align: left;">常住地区-省</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;">国标码</td> </tr> <tr> <td style="text-align: left;">9</td> <td style="text-align: left;">ResidentCity</td> <td style="text-align: left;">常住地区-市</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;">国标码</td> </tr> <tr> <td style="text-align: left;">10</td> <td style="text-align: left;">InsuredAddress</td> <td style="text-align: left;">被保人地址</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">11</td> <td style="text-align: left;">InsuredZip</td> <td style="text-align: left;">被保人邮编</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">12</td> <td style="text-align: left;">InsuredRelation</td> <td style="text-align: left;">与投保人关系</td> <td style="text-align: left;">数值</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">详见<a href="https://www.showdoc.com.cn/snisc/8799604614404574" title="通用字段定义">通用字段定义</a></td> </tr> </tbody> </table> <h5>受益人信息(BenefitInfo):</h5> <table> <thead> <tr> <th style="text-align: left;">No.</th> <th style="text-align: left;">字段</th> <th style="text-align: left;">字段名</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">必传</th> <th style="text-align: left;">备注</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">1</td> <td style="text-align: left;">BenefitName</td> <td style="text-align: left;">受益人姓名</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">2</td> <td style="text-align: left;">BenefitEmail</td> <td style="text-align: left;">受益人电子邮件</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">3</td> <td style="text-align: left;">BenefitCardType</td> <td style="text-align: left;">受益人证件类型</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;">详见<a href="https://www.showdoc.com.cn/snisc/8799604614404574" title="通用字段定义">通用字段定义</a></td> </tr> <tr> <td style="text-align: left;">4</td> <td style="text-align: left;">BenefitCardNo</td> <td style="text-align: left;">受益人证件号</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">5</td> <td style="text-align: left;">BenefitBirthday</td> <td style="text-align: left;">受益人出生日期</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">6</td> <td style="text-align: left;">BenefitSex</td> <td style="text-align: left;">受益人性别</td> <td style="text-align: left;">数值</td> <td style="text-align: left;">N</td> <td style="text-align: left;">1:男 2:女</td> </tr> <tr> <td style="text-align: left;">7</td> <td style="text-align: left;">BenefitMobile</td> <td style="text-align: left;">受益人手机号</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">8</td> <td style="text-align: left;">ResidentProvince</td> <td style="text-align: left;">常住地区-省</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;">国标码</td> </tr> <tr> <td style="text-align: left;">9</td> <td style="text-align: left;">ResidentCity</td> <td style="text-align: left;">常住地区-市</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;">国标码</td> </tr> <tr> <td style="text-align: left;">10</td> <td style="text-align: left;">BenefitAddress</td> <td style="text-align: left;">受益人地址</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">11</td> <td style="text-align: left;">BenefitZip</td> <td style="text-align: left;">受益人邮编</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">12</td> <td style="text-align: left;">BenefitRelation</td> <td style="text-align: left;">与被保人关系</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;">详见<a href="https://www.showdoc.com.cn/snisc/8799604614404574" title="通用字段定义">通用字段定义</a></td> </tr> <tr> <td style="text-align: left;">13</td> <td style="text-align: left;">BenefitScale</td> <td style="text-align: left;">受益比例</td> <td style="text-align: left;"></td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> </tbody> </table> <h5>其他信息(OtherInfo):</h5> <p>隧道字段定义:(code编码以及value值见<a href="https://www.showdoc.com.cn/snisc/8802357225017605" title="隧道字段定义">隧道字段定义</a>)</p> <table> <thead> <tr> <th style="text-align: left;">No.</th> <th style="text-align: left;">字段</th> <th style="text-align: left;">字段名</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">必传</th> <th style="text-align: left;">备注</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">1</td> <td style="text-align: left;">extends1</td> <td style="text-align: left;">隧道字段1</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">Y</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">2</td> <td style="text-align: left;">extends2</td> <td style="text-align: left;">隧道字段2</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">3</td> <td style="text-align: left;">extends3</td> <td style="text-align: left;">隧道字段3</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">4</td> <td style="text-align: left;">extends4</td> <td style="text-align: left;">隧道字段4</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">5</td> <td style="text-align: left;">extends5</td> <td style="text-align: left;">隧道字段5</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">6</td> <td style="text-align: left;">extends6</td> <td style="text-align: left;">隧道字段6</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">7</td> <td style="text-align: left;">extends7</td> <td style="text-align: left;">隧道字段7</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">8</td> <td style="text-align: left;">extends8</td> <td style="text-align: left;">隧道字段8</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> <tr> <td style="text-align: left;">9</td> <td style="text-align: left;">extends9</td> <td style="text-align: left;">隧道字段9</td> <td style="text-align: left;">字符</td> <td style="text-align: left;">N</td> <td style="text-align: left;"></td> </tr> </tbody> </table> <h2>请求报文示例</h2> <pre><code>&lt;Request&gt;</code></pre> <p>    <Order>         <OriginalPolicyNo>000000235645</OriginalPolicyNo>         <OrderId>20151106235615</OrderId>         <TotalPremium>100</TotalPremium>         <ApplyNum>3</ApplyNum>         <OriginalInsBeginDate>2015-11-06 16:45:00</OriginalInsBeginDate>         <OriginalInsEndDate>2016-11-06 16:45:00</OriginalInsEndDate></p> <RenewalInsBeginDate>2016-11-06 16:45:00</RenewalInsBeginDate> <p>        <RenewalInsEndDate>2017-11-06 16:45:00</RenewalInsEndDate>         <Item>             <MerchantCode>123123</MerchantCode>             <ProductCode>XXX</ProductCode>             <ProductName>XXX</ProductName>             <Amount>100</Amount>         </Item>         <OriginalProduct>             <MerchantCode>123123</MerchantCode>             <ProductCode>XXX</ProductCode>             <ProductName>XXX</ProductName>             <Amount>100</Amount>         </OriginalProduct>     </Order>     <ApplyInfo>         <HolderInfo>             <HolderName>张三</HolderName>             <a href="mailto:HolderEmail>zhangsd@suning.com</HolderEmail">HolderEmail>zhangsd@suning.com</HolderEmail</a>             <HolderCardType>1</HolderCardType>         </HolderInfo>         <InsuredList>             <InsuredInfo>                 <InsuredRelation>0</InsuredRelation>                 &lt;!—如果被保人与投保人关系是本人,则下面被保人信息不填 --&gt;                 <InsuredName>李四</InsuredName>                 <InsuredEmail>lisi@ suning.com </InsuredEmail>                 <BenefitList>                 <BenefitInfo></p> <BenefitRelation>1</BenefitRelation> <pre><code> &lt;!—如果受益人与被保人关系是法定,则下面受益人信息不填 --&gt; &lt;BenefitScale&gt;&lt;/BenefitScale&gt; &lt;BenefitName&gt;&lt;/BenefitName&gt; &lt;BenefitEmail&gt;&lt;/BenefitEmail&gt; &lt;BenefitCardType&gt;&lt;/BenefitCardType&gt;</code></pre> <p>                </BenefitInfo>                </BenefitList>             </InsuredInfo>         </InsuredList>         <OtherInfo>             <extends1>[{&quot;code&quot;:&quot;P015&quot;,&quot;value&quot;:&quot;0&quot;},{&quot;code&quot;:&quot;P012&quot;,&quot;value&quot;:&quot;江苏省南京市 玄武区徐庄软件园苏宁总部&quot;}]</extends1>         </OtherInfo>     </ApplyInfo> </Request></p> <h2>返回数据</h2> <h5>理赔信息(ClaimInfo):</h5> <table> <thead> <tr> <th style="text-align: left;">No</th> <th style="text-align: left;">字段</th> <th style="text-align: left;">字段名</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">必传</th> <th style="text-align: left;">备注</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">1</td> <td style="text-align: left;">isClaim</td> <td style="text-align: left;">是否有理赔记录</td> <td style="text-align: left;">数值</td> <td style="text-align: left;">N</td> <td style="text-align: left;">1是;0否</td> </tr> </tbody> </table> <h2>返回报文示例</h2> <pre><code>&lt; Response &gt;</code></pre> <p>         &lt; Proposal &gt;                     &lt; isClaim &gt;1&lt;/ isClaim &gt;          &lt;/ Proposal &gt; &lt;/ Response &gt;</p>

页面列表

ITEM_HTML