渠道保险平台接口弘康

1、目录1引言51.1文档概述52概述52.1交互模式52.2接口列表72.3数据类型72.4报文格式82.4.1请求报文82.4.2返回报文103接口定义 .123.1核保请求123.1.1请求数据123.1.2请求报文示例153.1.3返回数据173.1.4返回报文示例173.2核保确认183.2.1请求数据183.2.2请求报文示例183.2.3返回数据193.2.4返回报文示例203.3状态. 213.3.1请求数据213.3.2请求报文示例213.3.3返回数据213.3.4返回报文示例223.4保单价值. 233.4.1请求数据233.4.2请求报文示例233.4.3返回数据233.4

2、.4返回报文示例243.5退保费用核算253.5.1请求数据253.5.2请求报文示例253.5.3返回数据263.5.4返回报文示例263.6退保请求273.6.1请求数据273.6.2请求报文示例283.6.3返回数据293.6.4返回报文示例293.7退保回调303.7.1请求数据303.7.2请求报文示例313.7.3返回数据323.7.4返回报文示例323.8保单确认通知（回访）323.8.1请求数据323.8.2请求报文示例323.8.3返回数据333.8.4返回报文示例333.9风险测评接口333.25.1 请求数据333.25.2 请求报文示例343.25.3 返回数据343.

3、25.4 返回报文示例343.10资产文件同步353.10.1文件格式说明353.10.2压缩包文件353.10.3数据文件363.10.4签名校验文件363.10.5文件内容说明373.10.6保险类型编码374地区编码 .384.1北京384.2上海384.3. 384.4重庆384.1河北394.2山西394.3内. 394.4广西404.5辽宁414.6吉林414.7黑龙江424.8江苏424.9浙江434.10. 434.11福建444.12江西444.13山东454.14河南454.15. 464.16湖南464.17. 474.18海南474.19. 484.20. 484.21

4、云南494.22. 504.23陕西504.24. 504.25. 514.26青海514.27. 525订单状态 .526通用字段定义 .537第支付机构/编码 .587.1第支付机构编码587.2编码598附录 .591 引言1.1文档概述本文档目的是保险公司与销售平台（简称：）之间的保险销售接口协议、报文格式，便于销售平台与保险公司进行网络保险销售的接入与开发。2 概述2.1交互模式属性说明请求从平台发起请求，保险公司侧接收到请求报文后，在规定的时间内（建议值为5 秒）进行业务处理，处理完成后将结果返回。如果超时未能接收到返回消息，网络销售平台将启动重发机制， 进行重发， 每次重发间隔增

5、大， 建议最多重发三次。对接保险公司请求消息业务处理（核保、出单申请）响应消息后续处理交互协议HTTP/HTTPS数据格式XML 标准格式传参方式POSTGET 参数POST 参数整个 XML 报文应答模式支持同步与异步安全机制1、报文加密机制：按照与保险公司约定的 KEY，对整个 XML 报文 BASE64 编码后，进行 MD5 生成一个摘要，规则如下：Sign=Md5(Base64(xml) + key);测试环境 KEY：1234562、用户卡信息加密规则：采用 AES 加密方式，测试环境密钥：0123456789ABCDEF2.2接口列表2.3数据类型类型说明字符 String文本信息

6、，标明最大的长度，该长度是按单字节进行计算BooleanTrue or false时间 Datetime2014-04-22 16:45:00枚举 Enum01,02数值 Num123接口名称类型发起方描述核保请求01将投保信息传送给保险公司进行核保，将核保结果返回投保确认04用户在对已核投保单进行确认后，将确认信息发送给保险公司，保险公司接受出单请求，将出单结果反馈到平台。状态06通过open_id已在人寿投保的保单信息保单价值 07通过 open_id，order_id保单的详细信息退保费用核算08将用户输入的赎回或退保金额等给弘康，扣除相应的手续费后，返回可以实际到帐的金额退保请求09将

7、退保给进行审核，将退保结果同步或者异步返回退保回调12对过去的退保信息审核完成后，将本次的审核结果返回给（只适用于异步模式）2.4报文格式2.4.1 请求报文请求报文包括主动发起的报文以及保险公司主动发起的报文（如核保、出单异步模式下的回调）。请求报文的报文头是固定的，请求与保险公司请求头信息略有不同。发起请求报文头信息如下：发起请求报文示例：No.字段字段名类型必传备注1RequestType类型枚举Y见 2.2类型2UUID唯一标识字符Y3ComId保险公司编码枚举Y4SourceId方编码枚举Y5SendTime时间时间Yyyyy-MM-dd HH:mm:ss6JDSerial流水号字符

8、Y订单号7ComSerial保险公司流水号字符N保险公司发起时，必填8Asyn是否异步接口N缺省值 false，表示同步9ReturnUrl回调 Url字符N10ProductCode险种编码字符N报文块说明部分以<?xml version="1.0" encoding="UTF-8"?>为格式根节点以<PackageList>为起始标记，以</PackageList>为结束标记。可以包含多个<Package>节点报文根以<Package>为起始标记，以</Package>为结束标记

9、报文头以<Header>为起始标记，以</Header>为结束标记报文体以<Request>或<Response>为起始标记，以</Request>或</Response>为结束标记。(渠道请求用<Request>，保险公司请求用<Callback>，应答方用<Response>)保险公司发起请求报文头信息如下：No.字段字段名类型必传备注1RequestType类型枚举Y见 2.2类型2UUID唯一标识字符Y3ComId保险公司编码枚举Y4SourceId方编码枚举Y5SendTime

10、时间时间Y6JDSerial流水号字符Y订单号<?xml version="1.0" encoding="UTF-8"?><PackageList><Package><Header><RequestType>01</RequestType><UUID>78</UUID><ComId>123456</ComId><SourceId></SourceId><SendTime>2014-04-22 18:0

11、0:00</SendTime><JDSerial>1234567890</JDSerial><ComSerial></ComSerial><Asyn>false</Asyn><ReturnUrl></ReturnUrl><ProductCode>123456</ProductCode></Header><Request></Request></Package></PackageList>保险公司发起请求报

12、文示例：2.4.2 返回报文请求返回报文包括发起保险公司响应的报文，也包括保险公司发起回复的报文。两者的报文头格式相同。对于异步请求的返回报文，仅包括数据头部分；对于同步请求的返回报文，可能还包括一些业务反馈。返回报文头信息如下：No.字段字段名类型必传备注1RequestType类型枚举Y见 2.2类型<?xml version="1.0" encoding="UTF-8"?><PackageList><Package><Header><RequestType>01</RequestTy

13、pe><UUID>78</UUID><ComId>123456</ComId><SourceId></SourceId><SendTime>2014-04-22 18:00:00</SendTime><JDSerial>1234567890</JDSerial><ComSerial></ComSerial></Header><Callback></Callback></Package></Pa

14、ckageList>7ComSerial保险公司流水号字符N返回报文示例：<?xml version="1.0" encoding="UTF-8"?><PackageList><Package><Header><RequestType>01</RequestType><UUID>78</UUID><ComId>123456</ComId><SourceId></SourceId><SendTime&g

15、t;2014-04-22 18:00:00</SendTime><JDSerial>1234567890</JDSerial><ComSerial></ComSerial><ResponseCode>0</ResponseCode><ResponseInfo></ResponseInfo></Header><Response></Response></Package>2UUID唯一标识字符Y3ComId保险公司编码枚举Y4SourceId方

16、编码枚举Y5SendTime时间时间Y6JDSerial流水号字符Y订单号7ComSerial保险公司流水号字符N8ResponseCode应答返回码字符Y0 表示，1 表示处理中，其他表示失败或异常9ResponseInfo应答返回信息字符N3 接口定义3.1核保请求由方发起，调取核保接口。之后返回信息到方。3.1.1 请求数据订单信息（Order）：险种信息（Item）：No.字段字段名类型必传备注No.字段字段名类型必传备注1OrderId订单号字符Y订单号2TotalMoney总保费数值Y=实际保费×投保份数。以分为3InsuranceNum保险份数数值Y本期值为 1，下期如

17、果输入份数，再变更值。即使多被保人，仍然填写 14InsuranceBeginDate保险起期时间Yyyyy-MM-dd HH:mm:ss保险生效起始时间，在生效类型 2空；在生效类型为 4 时，填写用户自定义的生效日期5InsuranceEndDate保险止期时间Yyyyy-MM-dd HH:mm:ss保险生效截止时间，在生效类型为 4 时， 且保险公司指定了保障期间时，系统计 算出截止日期，并填入，其它情况为空6InsurancePeriod保险期限字符N保障期间，如果保险公司发布险种时指 定了保障期间，系统填入值。格式为 xxD， 最后一位为，格式为：D-天 Y-年 W-周 M-月，否则

18、为空7Pin用户账户名字符N</PackageList>投保人信息（HolderInfo）：No.字段字段名类型必传备注1HolderName投保人字符Y2Holder投保人电子邮件字符Y3HolderCardType投保人证件类型字符Y4HolderCardNo投保人证件号字符Y5HolderBirthday投保人出生日期字符Y6HolderSex投保人数值Y7HolderMobile投保人号字符Y8ResidentProvince常住地区-省字符Y1MerchantCode商家代码字符Y商家编码2ProductCode保险公司险种代码数值N保险公司定义的险种代码3Product

19、Name名称数值Y保险公司签约险种名称4ItemIdID时间Y的 ID，SKU5Amount保额数值N6ActualPremium实际保费数值Y=一口价×折扣率。以分为，在一口价上进行折扣后的价格，也就是实际价格7DiscountRate折扣率数值N该险种打折情况，输入8 代表 8 折， 但是数据和交互时，格式为万分之一，八折就是 80008Premium一口价数值Y发布险种时的价格，也可以理解成市场价，所有涉及到钱的字段，都是以分为，以下字段同。多被保人情况下， 如果一个保单，该值为保费之和，否则为单被保人保费9QnResult问卷字符json 串被保人信息（InsuredInfo

20、）：受益人信息（BenefitInfo）：No.字段字段名类型必传备注1BenefitName受益人字符N2Benefit受益人电子邮件字符N3BenefitCardType受益人证件类型字符N4BenefitCardNo受益人证件号字符N5BenefitBirthday受益人出生日期字符N6BenefitSex受益人数值NNo.字段字段名类型必传备注1InsuredName被保人字符N2Insured被保人电子邮件字符N3InsuredCardType被保人证件类型字符N4InsuredCardNo被保人证件号字符N5InsuredBirthday被保人出生日期字符N6InsuredSex被

21、保人数值N7InsuredMobile被保人号字符N8ResidentProvince常住地区-省字符N9ResidentCity常住地区-市字符N10InsuredAddress被保人地址字符N11InsuredZip被保人字符N12InsuredRelation与投保人关系数值Y9ResidentCity常住地区-市字符Y10HolderAddress投保人地址字符Y11HolderZip投保人字符Y12ServiceArea投保人服务区编码字符N3.1.2 请求报文示例<Request><Order><Pin>flysolo</Pin>&l

22、t;OrderId>123456</OrderId><TotalMoney>100</TotalMoney><InsuranceNum>3</InsuranceNum><InsuranceBeginDate>2014-04-22 16:45:00</InsuranceBeginDate><InsuranceEndDate>2014-04-22 16:45:00</InsuranceEndDate><InsurancePeriod></InsurancePeriod

23、><Item><MerchantCode>123123</MerchantCode><ProductCode></ProductCode><ProductName></ProductName><ItemId>123</ItemId><Amount>100</Amount><ActualPremium>90</ActualPremium><DiscountRate>80</DiscountRate><Pre

24、mium>60</Premium><!-Map<大类, Map<题号,List<>>> ->7BenefitMobile受益人号字符N8ResidentProvince常住地区-省字符N9ResidentCity常住地区-市字符N10BenefitAddress受益人地址字符N11BenefitZip受益人字符N12BenefitRelation与被保人关系字符Y13BenefitScale受益比例N<QnResult>"risk":"qus01":"填空"

25、,"新华","第一题填完","qus03":"错","qus02":"d","c","b","health":"qus01":"d","c","b"</QnResult></Item></Order><ApplyInfo><!- 投保人信息 -><HolderInfo>

26、;<HolderName>张三</HolderName><Holder>zhangshan</Holder><HolderCardType>1</HolderCardType></HolderInfo><!- 被保人信息 -><InsuredList><InsuredInfo><InsuredRelation>0</InsuredRelation><!如果被保人与投保人关系是本人，则下面被保人信息不填 -><InsuredName&g

27、t;李四</InsuredName><Insured>lisi</Insured><BenefitList><BenefitInfo><BenefitRelation>1</BenefitRelation><!如果受益人与被保人关系是法定，则下面受益人信息不填-><BenefitScale><BenefitScale><BenefitName><BenefitName><Benefit><Benefit><BenefitC

28、ardType><BenefitCardType></BenefitInfo></BenefitList></InsuredInfo></InsuredList>3.1.3 返回数据3.1.4 返回报文示例<Response><Proposal><OrderId>123456</OrderId><ProposalNo>123456789</ProposalNo><TotalMoney>100</TotalMoney><Under

29、WriteFlag>true</UnderWriteFlag><UnderWriteCode>0</UnderWriteCode><UnderWriteInfo>核保</UnderWriteInfo></Proposal>No.字段字段名类型必传备注1OrderId订单号字符Y订单号2ProposalNo投保单号字符Y投保单号3TotalMoney总保费金额Y4UnderWriteFlag是否核保通过Ytrue 通过，false 失败5UnderWriteCode核保返回码数值Y6UnderWriteInfo核保返回

30、信息字符Y<OtherInfo>根据保险公司对险种的定义自动生成</OtherInfo></ApplyInfo></Request>3.2核保确认3.2.1 请求数据支付信息(Payment)：投保单信息(Proposal)：3.2.2 请求报文示例<Request><!- 支付信息 -><Payment><!订单号(必填) -><OrderId>226105456209291</OrderId><!支付号(必填) -><PayId>574987741

31、3468</PayId><!- 支付时间(必填) ->字段名称类型大小必传备注ProposalNo投保单号字符NTotalPremium总保费数值Y以分为字段名称类型大小必传备注OrderId订单号字符YPayId支付单号字符YPayTime支付时间时间Yyyyy-MM-dd HH:mm:ssPayAmount支付金额数值Y以分为PayEnum支付枚举字符Y比如：203 代表快钱BankCode编码字符Y如：ABC，CMBCardNo字符YAES 加理HolderName持卡人字符YAES 加理BankAccount行字符Y例如：招商JDAccountId账户 ID字符

32、N</Response>3.2.3 返回数据保单信息（Policy）:字段名称类型大小必传备注OrderId订单号字符YProposalNo投保单号字符N出必传PolicyNo保单号字符Y保险公司生成保险合同单号TotalPremium总保费数值Y以分为IsSuccess出单是否YIssuedInfo出单信息字符YPolicyUrl电子保单 URL字符NAccountDate账务日期时间N同出单请求中相应字段，<PayTime> 2014-04-01 01:20:00</PayTime><!- 支付金额(必填) -><PayAmount&g

33、t;20000</PayAmount><PayEnum>204</PayEnum><BankCode>CMB</BankCode><CardNo>AFF345345A4G3Y4J6K41A35S4Y6JK1</CardNo><HolderName>JJ3H45LHAIUSDFGJO45H6NSKDFOJHJHS9F8UAG=AGJL09</HolderName><BankAccount>招商</BankAccount><JDAccountId>1234

34、35345</JDAccountId></Payment><!- 投保单信息 -><Proposal><!- 投保单号(必填) -><ProposalNo>554789894</ProposalNo><!- 总保费(必填) -><TotalPremium>20000</TotalPremium></Proposal></Request>3.2.4 返回报文示例<Response><!- 保单信息 -><Policy>

35、<!- 订单号(必填) -><OrderId>226105456209291</OrderId><!- 保单号(非必填) -><PolicyNo>498797646</PolicyNo><!- 投保单号(必填) -><ProposalNo>46487646</ProposalNo><!- 总保费(必填) -><TotalPremium>20000</TotalPremium><!- 出单是否(必填) -><IsSuccess>t

36、rue</IsSuccess><!- 出单失败信息(非必填) -><IssuedInfo></IssuedInfo><!- 电子保单地址(非必填) -><PolicyUrl></PolicyUrl><!- 账务日期(非必填) -><AccountDate>2012-01-01</AccountDate><IssuedTime>2012-01-01 12:23:23</IssuedTime></Policy></Response>

37、我们只截取 yyyy-MM-dd部分IssuedTime出单时间时间N保险公司出单时间yyyy-MM-dd HH:mm:ss3.3状态3.3.1 请求数据订单信息（Order）：3.3.2 请求报文示例3.3.3 返回数据订单信息（Order）：字段名称类型大小必传备注OrderId订单号字符YStatus状态枚举Y见 5 订单状态PolicyNo保单号字符N出必传ProposalNo投保单号字符N核保必传TotalPremium总保费数值N以分为, 有订单必传InsBeginDate保险起期时间Nyyyy-MM-dd HH:mm:ss, 有订单必传InsEndDate保险止期时间Nyyyy-

38、MM-dd HH:mm:ssInsPeriod保险期限数值N天数为ApplyNum总份数数值N有订单必传MerchantCode商家代码字符N有订单必传AccountDate账务日期时间N同出单请求中相应字段，我们<Request><!- 订单信息 -><Order><!保单号(必填) -><OrderId>226105456209291</OrderId></Order></Request>字段名称类型大小必传备注OrderId订单号字符Y3.3.4 返回报文示例<Response>&

39、lt;!- 订单信息 -><Order><!订单号(必填) -><OrderId>226105456209291</OrderId><!- 状态(必填) -><Status></Status><!- 保单号(非必填) -><PolicyNo></PolicyNo><!- 投保单号(非必填) -><ProposalNo></ProposalNo><!- 总保费(非必填) -><TotalPremium>20000

40、</TotalPremium><!- 邮递费(非必填) -><PostFee></PostFee><!- 保险起期(非必填) -><InsBeginDate></InsBeginDate><!- 保险止期(非必填) -><InsEndDate></InsEndDate><!- 保险期限(非必填) -><InsPeriod>365</InsPeriod><!- 份数(非必填) -><ApplyNum>1</App

41、lyNum><!商家编码(非必填) -><MerchantCode></MerchantCode>只截取 yyyy-MM-dd 部分IssuedTime出单时间时间N保险公司出单时间3.4保单价值3.4.1 请求数据订单信息（Order）：3.4.2请求报文示例3.4.3返回数据保单信息（PolicyValue）：<Request><!- 订单信息 -><Order><!- 保单号(必填) -><PolicyNo>124411110011</PolicyNo><OrderId

42、>12313123</OrderId></Order></Request>字段名称类型大小必传备注PolicyNo保单号字符YOrderId订单号字符Y<!- 账务日期(非必填) -><AccountDate>2012-01-01</AccountDate><!- 出单时间(非必填) -><IssuedTime>2012-01-01 11:20:00</IssuedTime></Order></Response>3.4.4 返回报文示例<Respons

43、e><!- 保单价值 -><PolicyValue><!订单号 -><OrderId>1111111111111</OrderId><PolicyNo>1111111111111</PolicyNo><!- 是否部分退保(必填) -><IsPartWithdraw>false/IsPartWithdraw><!- 保单实际价值(必填) -><PolicyValue>1000000</PolicyValue><!- 是否可冲正(必填)

44、-><IsReversal>true</IsReversal><! 是否必须退保(必填) -><IsMustCancel>true</IsMustCancel><! 保单状态(必填) ->字段名称类型大小必传备注OrderId订单号字符YPolicyNo保单号字符YIsPartWithdraw是否部分支取Y支持部分领取即 用户可以输入领取金额；不支持，将不 用户输入金额。IsMustCancel全额情况下是否必须退保Y全额下，是否要求用户必须退保，这样用户全额领取后，即保单就注销了PolicyValue保单账户现金价

45、值金钱Y保单包括的实际价值IsReversal是否可冲正Y可冲正：犹豫期内，或意健险生效期前，未产生过价值变化，原款原路退还；不可冲正：发生过价值变化；PolicyStatus保单状态枚举Y1 有效/2 无效3.5退保费用核算3.5.1 请求数据退保费用核算信息（RefundCharge）3.5.2 请求报文示例<?xml version="1.0" encoding="UTF-8"?><PackageList><Package><Header></Header><Request>&

46、lt;RefundCharge><OrderId>12313123</OrderId>No.字段字段名类型必传备注1OrderId订单号字符Y2PolicyNo保单号字符Y3WithdrawMoney用户输入的支取金额金额N分4IsCancelPolicy是否用户选择为退保N5IsWithdrawAll是否全部领取Y<PolicyStatus>1</PolicyStatus></PolicyValue></Response>3.5.3返回数据3.5.4返回报文示例<?xml version="1.0&

47、quot; encoding="UTF-8"?><PackageList><Package><Header>No.字段字段名类型必传备注1OrderId订单号字符Y2WithdrawMoney退保金额金额Y3Fee手续费金额N4AvailableMoney实际可支取金额金额N5PolicyValue保单账户现金价值金额Y6IsCancelPolicy是否为退保N7IsSuccess是否Y8Message确认告知信息或失败的信息字符N<PolicyNo>123131313123</PolicyNo><Wi

48、thdrawMoney></WithdrawMoney><IsCancelPolicy>false</IsCancelPolicy><IsWithdrawAll>true</IsWithdrawAll></RefundCharge></Request></Package></PackageList>3.6退保请求3.6.1 请求数据退保请求订单信息（RefundOrder）No.字段字段名类型必传备注1OrderId订单号字符Y2RefundNo退保单号字符Y3PolicyNo保单

49、号字符N分4PolicyValue保单账户现金价值字符N5WithdrawMoney退保金额金额Y</Header><Response><RefundCharge><OrderId>1231312313123</OrderId><WithdrawMoney></WithdrawMoney><Fee></Fee><AvailableMoney></AvailableMoney><PolicyValue></PolicyValue><Is

50、CancelPolicy>false</IsCancelPolicy><IsSuccess>true</IsSuccess><Message></Message></RefundCharge></Response></Package></PackageList>3.6.2 请求报文示例<Request><!- 退保订单信息 -><RefundOrder><!订单号(必填) -><OrderId>226105456209291</OrderId><!- 退保订单号(必填) -><RefundNo