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