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

苏宁保与外部的接口文档


核保请求

接口概述

交易类型:01 适用于先核保、后出单模式的大多数险种在线投保。星灿将投保信息传送给保险公司进行核保,保险公司将核保结果同步返回。核保成功后,用户才可以支付保费。

请求数据

订单信息(Order):
No. 字段 字段名 类型 必传 备注
1 OrderId 订单号 字符 Y 苏宁保险订单号
2 TotalPremium 总保费 数值 Y 投保时需要支付的金额。以分为单位。
3 ApplyNum 保险份数 数值 Y 常规险种默认1,即使多被保人,仍然填写1
4 InsBeginDate 保险起期 时间 N yyyy-MM-dd HH:mm:ss 保险生效起始时间,常规险种为投保成功后次日0时。可根据保司产品规则额外设置,或者让用户自定义生效日期
5 InsEndDate 保险止期 时间 N yyyy-MM-dd HH:mm:ss 保险生效截止时间,根据产品保障期间,系统计算出截止日期
6 InsPeriod 保险期限 字符 N 保障期间,如果保险公司发布险种时指定了保障期间,系统填入值。格式为xxD,最后一位为单位,格式为:D-天Y-年W-周M-月,否则为空
7 AccountNo 苏宁易付宝户头号 字符 N
8 IsPostPolicy 是否需要纸质保单 枚举 N 0:不需要;1:需要
9 IsPostInvoice 是否需要发票 枚举 N 0:不需要;1:需要
10 PostEmail 保单投送Email 字符 N
11 PostAddress 快递邮寄地址 字符 N
12 PurchaseChannel 购买渠道 字符 N 1:PC;2:手机
险种信息(Item):
No. 字段 字段名 类型 必传 备注
1 MerchantCode 商家代码 字符 Y 默认RE5106,代表星灿保代
2 ProductCode 保险公司险种代码 数值 Y 保险公司定义的险种代码
3 ProductName 产品名称 数值 Y 保险公司签约险种名称
4 Amount 保额 数值 N 以分为单位
5 receiveAge 领取年龄 数值 N 10-100数字,用于年金险
投保人信息(HolderInfo):
No. 字段 字段名 类型 必传 备注
1 HolderName 投保人姓名 字符 Y
2 HolderEmail 投保人电子邮件 字符 N
3 HolderCardType 投保人证件类型 字符 Y 详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义")
4 HolderCardNo 投保人证件号 字符 Y
5 HolderBirthday 投保人出生日期 字符 Y
6 HolderSex 投保人性别 数值 N 1:男 2:女
7 HolderMobile 投保人手机号 字符 Y
8 ResidentProvince 常住地区-省 字符 N
9 ResidentCity 常住地区-市 字符 N
10 HolderAddress 投保人地址 字符 N 如前端配置省市,则该字段传值:XX省XX市;如前端配置详细地址,则该字段传值 :XX省 XX市 XX区 门牌号;如无需用户填写,该字段为空
11 HolderZip 投保人邮编 字符 N
12 ServiceArea 投保人服务区编码 字符 N
被保人信息(InsuredInfo):
No. 字段 字段名 类型 必传 备注
1 InsuredName 被保人姓名 字符 N
2 InsuredEmail 被保人电子邮件 字符 N
3 InsuredCardType 被保人证件类型 字符 N 详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义")
4 InsuredCardNo 被保人证件号 字符 N
5 InsuredBirthday 被保人出生日期 字符 N
6 InsuredSex 被保人性别 数值 N 1:男 2:女
7 InsuredMobile 被保人手机号 字符 N
8 ResidentProvince 常住地区-省 字符 N
9 ResidentCity 常住地区-市 字符 N
10 InsuredAddress 被保人地址 字符 N 如前端配置省市,则该字段传值:XX省XX市;如前端配置详细地址,则该字段传值 :XX省 XX市 XX区 门牌号;如无需用户填写,该字段为空
11 InsuredZip 被保人邮编 字符 N
12 InsuredRelation 与投保人关系 数值 Y 详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义")
13 MaininsuredRelation 与主被保人关系 数值 Y 详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义")
受益人信息(BenefitInfo):
No. 字段 字段名 类型 必传 备注
1 BenefitName 受益人姓名 字符 N
2 BenefitEmail 受益人电子邮件 字符 N
3 BenefitCardType 受益人证件类型 字符 N 详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义")
4 BenefitCardNo 受益人证件号 字符 N
5 BenefitBirthday 受益人出生日期 字符 N
6 BenefitSex 受益人性别 数值 N 1:男 2:女
7 BenefitMobile 受益人手机号 字符 N
8 ResidentProvince 常住地区-省 字符 N 国标码
9 ResidentCity 常住地区-市 字符 N 国标码
10 BenefitAddress 受益人地址 字符 N
11 BenefitZip 受益人邮编 字符 N
12 BenefitRelation 与被保人关系 字符 Y 详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义")
13 BenefitScale 受益比例 N 单位是%
其他信息(OtherInfo):
No. 字段 字段名 类型 必传 备注
1 extends1 隧道字段1 字符 Y code编码以及value值见[隧道字段定义](https://www.showdoc.com.cn/snisc/8802357225017605 "隧道字段定义")
2 extends2 隧道字段2 字符 N 如果是上一年保单到期,引导续保的保单,则该字段会传关联的上一年保单号。格式为:[{"code":"OriginalPolicyNo","value":"IH1100012908024267"}]
3 extends3 隧道字段3 字符 N 如果是期缴保单,则该字段会传年化保费的值,以分为单位。格式为:[{"code":"insYearFee","value":"42900"}]
4 extends4 隧道字段4 字符 N 如果是赠险保单,且赠险产品有采购价格(非0元),则该字段会传采购保费,以分为单位。格式为:[{"code":"purchasePrice","value":2000}]
5 extends5 隧道字段5 字符 N
6 extends6 隧道字段6 字符 N
7 extends7 隧道字段7 字符 N
8 extends8 隧道字段8 字符 N
9 extends9 隧道字段9 字符 N

请求报文示例

<Request>

    <Order>         <AccountNo>000000235645</AccountNo>         <OrderId>20151106235615</OrderId>         <TotalPremium>100</TotalPremium>         <ApplyNum>3</ApplyNum>         <InsBeginDate>2015-11-06 16:45:00</InsBeginDate>         <InsEndDate>2016-11-06 16:45:00</InsEndDate>         <InsPeriod></InsPeriod> <IsPostPolicy>1</IsPostPolicy> <IsPostInvoice>1</IsPostInvoice> <PostEmail>2321@qq.com</PostEmail> <PostAddress>江苏省南京市XXXX</PostAddress> <PurchaseChannel>1</PurchaseChannel>         <Item>             <MerchantCode>123123</MerchantCode>             <ProductCode>XXX</ProductCode>             <ProductName>XXX</ProductName>             <Amount>100</Amount>             < receiveAge >55</ receiveAge >         </Item>     </Order>     <ApplyInfo>         <!-- 投保人信息 -->         <HolderInfo>             <HolderName>张三</HolderName>             <HolderEmail>zhangsd@suning.com</HolderEmail>             <HolderCardType>1</HolderCardType>         </HolderInfo>         <!-- 被保人信息 -->         <InsuredList>             <InsuredInfo>                 <InsuredRelation>0</InsuredRelation>                 <!—如果被保人与投保人关系是本人,则下面被保人信息不填 -->                 <InsuredName>李四</InsuredName>                 <InsuredEmail>lisi@ suning.com </InsuredEmail> <MaininsuredRelation >1</ MaininsuredRelation>                 <BenefitList>     <BenefitInfo> <BenefitRelation>1</BenefitRelation> <!—如果受益人与被保人关系是法定,则下面受益人信息不填 --> <BenefitScale></BenefitScale> <BenefitName></BenefitName> <BenefitEmail></BenefitEmail> <BenefitCardType></BenefitCardType> </BenefitInfo> </BenefitList>             </InsuredInfo>         </InsuredList>         <OtherInfo>             <extends1>[{"code":"P015","value":"0"},{"code":"P012","value":"江苏省南京市 玄武区徐庄软件园苏宁总部"}]</extends1>         </OtherInfo>      </ApplyInfo> </Request>

返回数据

投保单信息(Proposal):
No. 字段 字段名 类型 必传 备注
1 OrderId 订单号 字符 Y 苏宁保险订单号
2 ProposalNo 投保单号 字符 Y 投保单号
3 TotalMoney 总保费 金额 Y

返回报文示例

&lt;Response&gt;

     <Proposal>              <OrderId>20151106235615</OrderId>              <ProposalNo>123456789</ProposalNo>              <TotalMoney>100</TotalMoney>      </Proposal> </Response>

附件

[趸交短险核保请求和返回报文.txt](https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=f1d6adc5711923661e99eeadbbe26854 "[趸交短险核保请求和返回报文.txt")

[赠险核保请求和返回报文.txt](https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=2eecfe62f655718ca19311662ef7737e "[赠险核保请求和返回报文.txt")

[期缴产品核保请求和返回报文.txt](https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=769343dcbf80f23dd5ff5d3cdd29b615 "[期缴产品核保请求和返回报文.txt")

[续保核保请求和返回报文.txt](https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=0d5666f407e81cbd2ceade8cd82cdc14 "[续保核保请求和返回报文.txt")

页面列表

ITEM_HTML