核保请求
接口概述
交易类型: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 |
返回报文示例
<Response>
<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")