核心業(yè)務(wù)系統(tǒng)水滴定制產(chǎn)品需求-核心續(xù)期部分需求規(guī)格說(shuō)明書(shū)

1、<核心業(yè)務(wù)系統(tǒng)><水滴定制產(chǎn)品需求-核心續(xù)期部分>需求規(guī)格說(shuō)明書(shū)需求編號(hào)：11146需求分析人員：樊佳樂(lè)需求類(lèi)型：q新業(yè)務(wù)系統(tǒng) q功能改進(jìn) q故障問(wèn)題 q咨詢?cè)u(píng)估 q其他文檔狀態(tài)：待確認(rèn)完成日期：2021/03/26用戶確認(rèn)人員：用戶確認(rèn)時(shí)間：目錄需求評(píng)審記錄I1. 整體業(yè)務(wù)說(shuō)明12. 業(yè)務(wù)流程13. 核心接口通用規(guī)則13.1 通用規(guī)則13.2 接口調(diào)用方式13.3 報(bào)文格式13.4 接口列表24. 長(zhǎng)期險(xiǎn)鎖單接口24.1 處理邏輯24.2 業(yè)務(wù)規(guī)則24.3 請(qǐng)求信息主體參數(shù)34.4 請(qǐng)求報(bào)文示例34.1 響應(yīng)信息主體參數(shù)34.2 響應(yīng)報(bào)文示例35. 長(zhǎng)期險(xiǎn)扣費(fèi)同步接口

2、45.1 處理邏輯45.2 請(qǐng)求信息主體參數(shù)45.3 請(qǐng)求報(bào)文示例45.4 響應(yīng)信息主體參數(shù)55.5 響應(yīng)報(bào)文示例56. 異常碼及描述57. 需求變更記錄68. 業(yè)務(wù)原始需求69. 需求與應(yīng)用環(huán)境的對(duì)應(yīng)610. 關(guān)聯(lián)模塊說(shuō)明6關(guān)于本文檔主 題關(guān)于核心系統(tǒng)中針對(duì)水滴定制產(chǎn)品需求-核心續(xù)期部分說(shuō)明說(shuō) 明適用對(duì)象項(xiàng)目經(jīng)理、模塊負(fù)責(zé)人、模塊開(kāi)發(fā)人員修訂歷史版 本章 節(jié)類(lèi) 型日 期作 者說(shuō) 明1.0C2021-03-26樊佳樂(lè)說(shuō)明：類(lèi)型創(chuàng)建（C）、修改（U）、刪除（D）、增加（A）；需求評(píng)審記錄評(píng)審建議評(píng)審人評(píng)審日期用戶簽字確認(rèn)：本文件包含保密內(nèi)容，本文件并具有著作權(quán)。未經(jīng)雙方書(shū)面同意，任何一方都不得復(fù)

3、制或通過(guò)任何方式傳播，無(wú)論是電子格式、紙張格式、影印格式或其他任何格式，也不得存儲(chǔ)在任何性質(zhì)的檢索系統(tǒng)中。1. 整體業(yè)務(wù)說(shuō)明核心系統(tǒng)針對(duì)水滴側(cè)產(chǎn)品新增<長(zhǎng)期險(xiǎn)鎖單接口>及<長(zhǎng)期險(xiǎn)扣費(fèi)同步接口>以完成水滴側(cè)產(chǎn)品續(xù)期繳費(fèi)及狀態(tài)同步至保司的功能。2. 業(yè)務(wù)流程3. 核心接口通用規(guī)則3.1 通用規(guī)則(1) 業(yè)務(wù)規(guī)則校驗(yàn)：對(duì)于業(yè)務(wù)規(guī)則校驗(yàn)不通過(guò)的，返回錯(cuò)誤返回類(lèi)型及錯(cuò)誤描述。(2) 日期格式：如無(wú)特殊約定，本系統(tǒng)日期格式統(tǒng)一為“yyyy-MM-dd”。(3) 金額格式，如無(wú)特殊約定，以人民幣分為單位，最大精度為分?jǐn)?shù)，如無(wú)小數(shù)部分可為整數(shù)，如10.01、10均合法。(4) 接口文件

4、統(tǒng)一使用UTF-8編碼。(5) 各系統(tǒng)在設(shè)計(jì)時(shí)，應(yīng)確保若在保持原報(bào)文節(jié)點(diǎn)位置不變的情況下，增加新節(jié)點(diǎn)不會(huì)影響系統(tǒng)原正常運(yùn)行。(6) 節(jié)點(diǎn)含義見(jiàn)表，如果節(jié)點(diǎn)屬性非空沒(méi)有標(biāo)識(shí)N或?yàn)榭?，即不需要傳值，?jié)點(diǎn)值留空或不傳這個(gè)節(jié)點(diǎn)均可。3.2 接口調(diào)用方式接口對(duì)接方式為restful，報(bào)文格式為 XML。3.3 報(bào)文格式報(bào)文塊說(shuō)明聲明部分以<?xml version="1.0" encoding="UTF-8"?>為格式聲明根節(jié)點(diǎn)請(qǐng)求報(bào)文以<SINO_API_CALL_REQUEST>為起始標(biāo)記，以</SINO_API_CALL_REQ

5、UEST>為結(jié)束標(biāo)記。響應(yīng)報(bào)文以<SINO_API_CALL_RESPONSE>為起始標(biāo)記，以</SINO_API_CALL_RESPONSE>為結(jié)束標(biāo)記報(bào)文頭請(qǐng)求報(bào)文以<REQUEST_HEAD>為起始標(biāo)記，以</REQUEST_HEAD>為結(jié)束標(biāo)記響應(yīng)報(bào)文以<RESPONSE_HEAD>為起始標(biāo)記，以</RESPONSE_HEAD>為結(jié)束標(biāo)記報(bào)文體根據(jù)不同的接口類(lèi)型，有不同的起始和結(jié)束標(biāo)記發(fā)起請(qǐng)求的報(bào)文頭信息如下：字段代碼字段名稱(chēng)是否必填備注REQUEST_TYPE交易類(lèi)型Y每個(gè)接口有固定值TRANSACTION

6、_NUM交易idY由平臺(tái)提供響應(yīng)報(bào)文頭信息如下：字段代碼字段名稱(chēng)是否必填備注RESPONSE_CODE結(jié)果編碼Y00-成功；01-失敗ERROR_MESSAGE結(jié)果信息Y具體原因描述RESPONSE_TYPE交易類(lèi)型Y同請(qǐng)求部分TRANSACTION_NUM交易idY由平臺(tái)提供3.4 接口列表接口名稱(chēng)SystemIDBusinessType發(fā)起方長(zhǎng)期險(xiǎn)鎖單接口WXXQ006互聯(lián)網(wǎng)長(zhǎng)期險(xiǎn)扣費(fèi)同步接口WXXQ007互聯(lián)網(wǎng)4. 長(zhǎng)期險(xiǎn)鎖單接口4.1 處理邏輯核心根據(jù)保單號(hào)及本次期數(shù)查詢?cè)摫蜗碌氖欠翊嬖谙鄳?yīng)的續(xù)期交費(fèi)信息，若存在可線上續(xù)期交費(fèi)的數(shù)據(jù)，則核心返回該期交費(fèi)信息，并將保單掛起，該期續(xù)期交費(fèi)

7、置為銀行在途狀態(tài)。 4.2 業(yè)務(wù)規(guī)則(1) 需為個(gè)險(xiǎn)處于生效狀態(tài)的保單(2) 該保單已續(xù)期抽檔生成應(yīng)收數(shù)據(jù)，并非銀行在途狀態(tài)、非收費(fèi)成功狀態(tài)；(3) 該保單未被保全、理賠等其他業(yè)務(wù)掛起；(4) 該保單的當(dāng)期續(xù)期應(yīng)交日期大于等于當(dāng)前日期；(5) 該保單處于續(xù)期交費(fèi)寬限期之內(nèi)；l 短期險(xiǎn)寬限期為38天l 長(zhǎng)期險(xiǎn)（除醫(yī)保加）寬限期為68天l 醫(yī)保加月交寬限期為38天，年交寬限期為68天4.3 請(qǐng)求信息主體參數(shù)字段代碼字段名稱(chēng)是否必填備注orderNo水滴訂單號(hào)YpolicyNo保單號(hào)YperiodNum本次期數(shù)Y首期為1，續(xù)期從2開(kāi)始periodOrderNo續(xù)期訂單號(hào)YprePayDay預(yù)計(jì)扣費(fèi)日

8、期Y4.4 請(qǐng)求報(bào)文示例<?xml version="1.0" encoding="UTF-8"?><SINO_API_CALL_REQUEST> <REQUEST_HEAD> <REQUEST_TYPE>XQ006</REQUEST_TYPE> <TRANSACTION_NUM>XQ</TRANSACTION_NUM> </REQUEST_HEAD><REQUEST_BODY> <orderNo></orderNo> &l

9、t;policyNo></policyNo> <periodNum>2</periodNum> <periodOrderNo></periodOrderNo> <prePayDay>2021-03-31</prePayDay> </REQUEST_BODY></SINO_API_CALL_REQUEST>4.1 響應(yīng)信息主體參數(shù)字段代碼字段名稱(chēng)是否必填備注orderNo水滴訂單號(hào)Y<同請(qǐng)求>policyNo保單號(hào)YperiodNum本次期數(shù)Y首期為1，續(xù)期從2開(kāi)始per

10、iodOrderNo續(xù)期訂單號(hào)Y<同請(qǐng)求>payPeriodType交費(fèi)期限類(lèi)型Y1-躉交；2-按年限交；3-交至某確定年齡payPeriodValue交費(fèi)年限YpayFrequency交費(fèi)間隔(頻率)Y0-躉交；1-月繳；2-季度繳；3-半年繳；4-年繳；payFrequencyValue交費(fèi)頻率數(shù)值Y默認(rèn)1discountType折扣類(lèi)型Y1-無(wú)；2-折扣活動(dòng)（默認(rèn)為1）renewalDuePayPremium續(xù)期應(yīng)繳保費(fèi)YrenewalActualPayPremium續(xù)期實(shí)繳保費(fèi)Y同續(xù)期應(yīng)繳保費(fèi)discountPremium折扣金額Y無(wú)折扣時(shí)為0renewalTime應(yīng)交時(shí)間

11、Yyyyy-MM-dd 00:00:00(核心無(wú)具體時(shí)間)endOfGraceTime寬限期截止日期Yyyyy-MM-dd 23:59:59status續(xù)期狀態(tài)Y具體詳見(jiàn)第7章statusDesc續(xù)期狀態(tài)描述Y具體可續(xù)期或不可續(xù)期原因描述4.2 響應(yīng)報(bào)文示例<?xml version="1.0" encoding="UTF-8"?><SINO_API_CALL_RESPONSE> <RESPONSE_HEAD> <RESPONSE_CODE>00</RESPONSE_CODE> <RESP

12、ONSE_TYPE>XQ006</RESPONSE_TYPE> <TRANSACTION_NUM>XQ</TRANSACTION_NUM> <ERROR_CODE>異常編碼詳見(jiàn)第八章節(jié)</ERROR_CODE> <ERROR_MESSAGE>異常描述</ERROR_MESSAGE> </RESPONSE_HEAD> <RESPONSE_BODY> <orderNo></orderNo> <policyNo></policyNo> &l

13、t;periodOrderNo></periodOrderNo> <periodNum>2</periodNum> <payPeriodType>2</payPeriodType> <payPeriodValue>30</payPeriodValue>: <payFrequency>4</payFrequency> <payFrequencyValue>1</payFrequencyValue> <discountType>1</disco

14、untType> <renewalDuePayPremium>2334.56</renewalDuePayPremium>: <renewalActualPayPremium>2334.56</renewalActualPayPremium> <discountPremium>0</discountPremium> <renewalTime>2021-04-01 00:00:00</renewalTime> <endOfGraceTime>2021-05-08 23:59:59&l

15、t;/endOfGraceTime> <status>1</status> <statusDesc>可續(xù)期</statusDesc> </RESPONSE_BODY></SINO_API_CALL_RESPONSE>5. 長(zhǎng)期險(xiǎn)扣費(fèi)同步接口5.1 處理邏輯核心根據(jù)水滴側(cè)請(qǐng)求信息中的保單號(hào)及本次期數(shù)字段查詢是否存在處于<長(zhǎng)期險(xiǎn)鎖單>狀態(tài)的保單，若存在則根據(jù)扣費(fèi)狀態(tài)進(jìn)行以下處理：(1) 若扣費(fèi)成功，則核心解掛該保單，將其續(xù)期交費(fèi)狀態(tài)置為已收費(fèi)成功，并進(jìn)行續(xù)期核銷(xiāo)。(2) 將扣費(fèi)失敗，則核心解掛該保單，此時(shí)該期

16、續(xù)期仍處于待收費(fèi)狀態(tài)。5.2 請(qǐng)求信息主體參數(shù)字段代碼字段名稱(chēng)是否必填備注orderNo水滴訂單號(hào)YpolicyNo保單號(hào)YperiodNum本次期數(shù)Y首期為1，續(xù)期從2開(kāi)始periodOrderNo續(xù)期訂單號(hào)YrenewalDuePayPremium續(xù)期應(yīng)繳保費(fèi)YrenewalActualPayPremium續(xù)期實(shí)繳保費(fèi)YpayMentTime扣費(fèi)日期YpayMentStatus扣費(fèi)狀態(tài)Y0-成功；1-失敗prePayDay預(yù)計(jì)扣費(fèi)日期Yyyyy-MM-dd5.3 請(qǐng)求報(bào)文示例<?xml version="1.0" encoding="UTF-8"

17、;?><SINO_API_CALL_REQUEST> <REQUEST_HEAD> <REQUEST_TYPE>XQ007</REQUEST_TYPE> <TRANSACTION_NUM>XQ</TRANSACTION_NUM> </REQUEST_HEAD> <REQUEST_BODY> <orderNo></orderNo> <policyNo></policyNo> <periodNum>2</periodNum>

18、<periodOrderNo></periodOrderNo> <renewalDuePayPremium>300000</renewalDuePayPremium> <renewalActualPayPremium>300000</renewalActualPayPremium> <payMentTime>2019-09-23 09:13:19</payMentTime> <payMentStatus>0</payMentStatus> <prePayDay>2

19、019-09-09</prePayDay> </REQUEST_BODY></SINO_API_CALL_REQUEST>5.4 響應(yīng)信息主體參數(shù)字段代碼字段名稱(chēng)是否必填備注orderNo水滴訂單號(hào)Y<同請(qǐng)求>policyNo保單號(hào)YperiodNum本次期數(shù)Y首期為1，續(xù)期從2開(kāi)始periodOrderNo續(xù)期訂單號(hào)Y<同請(qǐng)求>status處理結(jié)果Y0-成功；1-失敗supplierVerificationTime核銷(xiāo)時(shí)間Yyyyy-MM-dd HH:mm:ss5.5 響應(yīng)報(bào)文示例<?xml version="1.0

20、" encoding="UTF-8"?><SINO_API_CALL_RESPONSE> <RESPONSE_HEAD> <RESPONSE_CODE>00</RESPONSE_CODE> <ERROR_MESSAGE>交易成功</ERROR_MESSAGE> <RESPONSE_TYPE>XQ007</RESPONSE_TYPE> <TRANSACTION_NUM>XQ</TRANSACTION_NUM> </RESPONSE_HE

21、AD> <RESPONSE_BODY> <orderNo></orderNo> <policyNo></policyNo> <periodNum>2</periodNum> <periodOrderNo></periodOrderNo> <status>0</status> <supplierVerificationTime>2019-09-23 09:13:19</supplierVerificationTime> </RES

22、PONSE_BODY></SINO_API_CALL_RESPONSE>6. 核心收費(fèi)生成中間表批處理調(diào)整針對(duì)水滴側(cè)產(chǎn)品，核心將不再生成推資金平臺(tái)的收費(fèi)中間數(shù)據(jù)，即不再推資金平臺(tái)。7. 長(zhǎng)期險(xiǎn)續(xù)期狀態(tài)(1) 可續(xù)期：水滴調(diào)用鎖單接口，請(qǐng)求保司時(shí)；該保單在保司狀態(tài)正常，可以正?？劾m(xù)期保費(fèi)，則保司返回狀態(tài)值1。同時(shí)需返回應(yīng)繳日、應(yīng)繳金額、寬限期等具體信息。水滴會(huì)以保司返回?cái)?shù)據(jù)為準(zhǔn)進(jìn)行扣款。(2) 續(xù)期掛起中，暫時(shí)無(wú)法扣費(fèi)：水滴調(diào)用鎖單接口，請(qǐng)求保司時(shí)；保司發(fā)現(xiàn)該保單正在進(jìn)行保全/理賠/退保等保全操作，保司內(nèi)部掛起時(shí)，則返回該狀態(tài)值為2。且此時(shí)水滴不會(huì)進(jìn)行再次扣費(fèi)，但水滴會(huì)不斷嘗試對(duì)該保單進(jìn)行加鎖。(3) 本期已繳費(fèi)，無(wú)需再次繳費(fèi)：水滴調(diào)用鎖單接口，請(qǐng)求保司時(shí)；保司發(fā)現(xiàn)該保單已繳費(fèi)（例如：已在保司繳費(fèi)成功），無(wú)需再次繳費(fèi)，則返回該狀態(tài)值為3。且此時(shí)水滴