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

苏宁保与外部的接口文档


保单回传接口

接口概述

1.当用户在合作方投保成功后,合作方需通过提供的接口地址回传保单信息给星灿保代 2.若推送发生异常,请合作方务必有重试机制

推送地址

环境 请求地址
测试环境 https://ftpgspre.cnsuning.com/ftpgs/trade/iosGatewayService/syncinsure
生产环境 https://mfg.suning.com/ftpgs/trade/iosGatewayService/syncinsure

安全机制

请求报文先Base64转码后用AES加密, 秘钥值由星灿保代提供 响应报文先用AES解密,解密后用Base64解码

请求报文

字段 类型 必传 描述 说明
orderInfo JSON Y 保单信息 JSON格式
type Integer Y 同步类型 1-投保成功 2-核保失败 3-出单失败
proposalNo String Y 投保单号
policyNo String Y 保单号
policyUrl String N 电子保单
orderTime String N 投保时间 yyyy-MM-dd HH:mm:ss
underwriteTime String N 核保时间 yyyy-MM-dd HH:mm:ss
payTime String N 支付时间 yyyy-MM-dd HH:mm:ss
issueTime String Y 出单时间 yyyy-MM-dd HH:mm:ss
insBeginDate String Y 保险起期 yyyy-MM-dd HH:mm:ss
insEndDate String Y 保险止期 yyyy-MM-dd HH:mm:ss
insAmount Integer Y 保额 单位分
totalPremium Integer Y 总保费 单位分
premium Integer N 期缴保费 单位分 期缴保单必传,首期保费
productCode String Y 产品编码
productName String Y 产品名称
paymentMethod Integer Y 缴费方式
paymentTerm String Y 缴费期限
paymentTermUnit String Y 缴费期限单位 详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义")
insurePeriod String Y 保障期限
insurePeriodUnit String Y 保障期限单位 详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义")
benefitFlag Integer Y 受益人标识 1.法定继承人 2.指定
failReason String N 失败原因 核保失败/出单失败 必填
insuranceInfoList JSONArray Y 险种信息
itemCode String Y 险种编码
itemName String Y 险种名称
amount Integer Y 保额 单位分
premium Integer Y 总保费 单位分
masterFlag Integer Y 主险标记 1-主险 0-附加险
dutyInfoList JSONArray N 责任信息
dutyCode String N 责任编码
dutyName String N 责任名称
dutyAmount Integer N 责任保额
holder JSON Y 投保人信息
name String Y 姓名
phone String Y 手机号
cardType Integer Y 证件类型 详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义")
cardNo String Y 证件号
birthDay String Y 出生日期 yyyy-MM-dd
sex Integer Y 性别 1:男 2:女
mail String N 邮箱
province String N 常住省 国标码
city String N 常住市 国标码
address String N 常住地址
zipCode String N 邮编
nationality String N 国籍
cardBeginDate String N 证件有效期起期 yyyy-MM-dd HH:mm:ss
cardEndDate String N 证件有效期止期 yyyy-MM-dd HH:mm:ss
height String N 身高
weight String N 体重
income String N 收入
insuredList JSONArray 被保人信息
name String Y 姓名
phone String N 手机号
cardType Integer Y 证件类型 详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义")
cardNo String Y 证件号
birthDay String Y 出生日期 yyyy-MM-dd
occupationType String N 职业类型
sex Integer Y 性别 1:男 2:女
mail String N 邮箱
insuredRelation String Y 与投保人关系 详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义")
hasSocial String N 有无社保 Y-有 N-无
province String N 常住省
city String N 常住市
address String N 常住地址
zipCode String N 邮编
nationality String N 国籍
cardBeginDate String N 证件有效期起期 yyyy-MM-dd HH:mm:ss
cardEndDate String N 证件有效期止期 yyyy-MM-dd HH:mm:ss
height String N 身高
weight String N 体重
income String N 收入
mainRelation Integer Y 与主被保人关系 详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义")
seqNo Integer Y 被保人序列号 1、2、3、4、5
benefitList JSONArray N 受益人信息 benefitFlag=2时,不为空
name String N 姓名
phone String N 手机号
cardType Integer N 证件类型 详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义")
cardNo String N 证件号
birthDay String N 出生日期 yyyy-MM-dd
occupationType String N 职业类型
sex Integer N 性别 1:男 2:女
province String N 常住省
city String N 常住市
address String N 常住地址
zipCode String N 邮编
benefitRelation Integer N 与被保人关系 详见[通用字段定义](https://www.showdoc.com.cn/snisc/8799604614404574 "通用字段定义")
benefitScale String N 受益比例
bnfNo Integer N 受益人序号 1、2、3、4、5
nationality String N 国籍

请求报文示例

{

    "type": 1,     "proposalNo": "2020030700001",     "policyNo": "2020030756015",     "policyUrl": "http://11.10.11.15:9001/test";,     "orderTime": "2022-03-07 10:00:01",     "underwriteTime": "2022-03-07 10:00:02",     "payTime": "2022-03-07 10:00:03",     "issueTime": "2022-03-07 10:00:04",     "insBeginDate": "2022-03-07 10:00:01",     "insEndDate": "2022-03-07 23:59:59",     "insAmount": 10000000,     "totalPremium": ,     "premium": 35600,     "productCode": "P5001",     "productName": "测试产品名称",     "paymentMethod": 0,     "paymentTerm": "1",     "paymentTermUnit": "Y",     "insurePeriod": "5",     "insurePeriodUnit": "Y",     "benefitFlag": 2,     "failReason": "",     "insuranceInfoList": [{        "itemCode": "T0001",        "itemName": "测试",        "amount": 10000000,        "premium": 35600,        "masterFlag": 1,        "dutyInfoList": [{            "dutyAmount": 50000,            "dutyCode": "C0001",            "dutyName": "测试"        }]     }]     "holder": {        "name": "高圆圆",         "phone": "13000000001",        "cardType": 1,        "cardNo": "320000000000000000",        "birthDay": "1980-08-01",        "sex": 2,        "mail": "gaoyuanyuan@163.com",        "province": "江苏",        "city": "南京",        "address": "徐庄软件园",        "zipCode": "210001",        "nationality": "中国",        "cardBeginDate": "2014-01-19",        "cardEndDate": "2034-01-19",        "height": "165",        "weight": "50",        "income": "1000000",     },     "insuredList": [{        "name": "高圆圆",        "phone": "13000000001",        "cardType": 1,        "cardNo": "320000000000000000",        "birthDay": "1980-08-01",        "occupationType": "艺人",        "sex": 2,        "mail": "gaoyuanyuan@163.com",        "insuredRelation": 1,        "hasSocial": "Y",        "province": "江苏",        "city": "南京",        "address": "徐庄软件园",        "zipCode": "210001",        "nationality": "中国",        "cardBeginDate": "2014-01-19",        "cardEndDate": "2034-01-19",        "height": "165",        "weight": "50",        "income": "1000000",        "maininsuredRelation": 1,        "SeqNo": ""     }],     "benefitList": [{        "name": "陈圆圆",        "phone": "13000000002",        "cardType": 1,        "cardNo": "320000000000000001",        "birthDay": "1981-08-01",        "occupationType": "艺人",        "sex": 2,        "province": "江苏",        "city": "南京",        "address": "徐庄软件园",        "zipCode": "210001",        "benefitRelation": 2,        "benefitScale": "",        "bnfType": 1,        "bnfNo": 1,        "nationality": "中国",     }] }

返回报文

字段 类型 必传 描述 说明
code String Y 处理成功标识 1.接收到推送数据处理成功,返回code=200 2.接收到推送数据处理失败,返回code!=200
message String N 处理失败原因

返回报文示例

{

  "code": "200",   "message": "成功" }

页面列表

ITEM_HTML