首期實(shí)時(shí)收費(fèi)需求

陽光人壽關(guān)于首期實(shí)時(shí)收費(fèi)需求--SLFS系統(tǒng)功能需求分析規(guī)格說明書批準(zhǔn)/日期：審核/日期：編制/日期：修改序號(hào)修改理由/內(nèi)容修改/日期批準(zhǔn)日期文檔編號(hào)密級(jí)秘密修訂歷史需求號(hào)需求變更背景變更章節(jié)版本號(hào)類型作者修改日期R201406059AC林仲俠2014.7.21說明：類型－創(chuàng)建（C）、修改（U）、刪除（D）、增加（A）；1.概述略1.1目標(biāo)略系統(tǒng)功能描述核心系統(tǒng)調(diào)SLFS系統(tǒng)接口，SLFS系統(tǒng)根據(jù)報(bào)文判斷是否實(shí)時(shí)收付費(fèi)，SLFS調(diào)廣州銀聯(lián)接口進(jìn)行實(shí)時(shí)收付費(fèi)。2.1保證金主流程及實(shí)時(shí)收費(fèi)及記賬功能2.1.1流程圖2.2核心系統(tǒng)與SLFS系統(tǒng)2.2.1實(shí)時(shí)請(qǐng)求報(bào)文說明接口字段ID字段名稱類型取值可空TRANS_DETAILBATCH_NO批次號(hào)NUMBER(20)非空OTHER_NO業(yè)務(wù)號(hào)VARCHAR2(20)非空OTHER_TYPE業(yè)務(wù)類型號(hào)碼VARCHAR2(10)非空SOURCE_CODE業(yè)務(wù)來源VARCHAR2(30)非空PAY_MODE收付方式VARCHAR2(30)非空MANAGER_COM管理機(jī)構(gòu)VARCHAR2(20)非空CUSTOMER_TYPE客戶類型VARCHAR2(20)PRIVATE私人，PUBLIC公司。不填時(shí)，默認(rèn)為私人PRIVATE?？煽誄USTOMER_NAME客戶名稱VARCHAR2(480)銀行卡或存折上的所有人姓名。非空CUSTOMER_ID_TYPE客戶證件類型VARCHAR2(10)見附錄4.3非空CUSTOMER_ID客戶證件號(hào)VARCHAR2(150)非空CUSTOMER_ACCOUNT_TYPE客戶銀行賬號(hào)類型VARCHAR2(10)00銀行卡，01存折，默認(rèn)為銀行卡00可空CUSTOMER_ACCT_NO客戶銀行賬號(hào)VARCHAR2(50)非空CUSTOMER_BANK_CODE客戶銀行代碼VARCHAR2(50)3位的銀行代碼，見附錄4.1非空CUSTOMER_BANK_NAME客戶銀行賬戶的開戶行名稱VARCHAR2(250)開戶行詳細(xì)名稱，也叫網(wǎng)點(diǎn)，如中國建設(shè)銀行廣州東山廣場(chǎng)分理處?？煽誄USTOMER_BANK_AREA客戶銀行賬戶的地區(qū)碼VARCHAR2(50)可空RORP收付標(biāo)識(shí)VARCHAR2(20)是收還是支R標(biāo)識(shí)收，P表示支。非空AMOUNT金額NUMBER(16,2)非空CURRENCY幣種VARCHAR2(10)默認(rèn)CNY可空2.2.2實(shí)時(shí)響應(yīng)報(bào)文說明接口字段ID字段名稱類型取值可空RET_DETAILSBATCH_NO批次號(hào)NUMBER(20)非空OTHER_NO業(yè)務(wù)號(hào)VARCHAR2(20)非空CONTRACT_ID主鍵VARCHAR2(20)非空RET_CODE返回碼NUMBER(4)非空ERR_MSG錯(cuò)誤文本VARCHAR2(256)可空2.2.3例子（1）核心請(qǐng)求SLFS系統(tǒng)報(bào)文<?xmlversion="1.0"encoding="UTF-8"?><!--核心請(qǐng)求SLFS系統(tǒng)報(bào)文--><SLFSLINK><BATCH_NO>批次號(hào)</BATCH_NO><OTHER_NO>業(yè)務(wù)號(hào)碼</OTHER_NO><OTHER_TYPE>業(yè)務(wù)類型號(hào)碼</OTHER_TYPE><SOURCE_CODE>來源代碼</SOURCE_CODE><PAY_MODE>收付方式</PAY_MODE><MANAGER_COM>管理機(jī)構(gòu)</MANAGER_COM><CUSTOMER_TYPE>客戶類型(可空)</CUSTOMER_TYPE><CUSTOMER_NAME>客戶名稱</CUSTOMER_NAME><CUSTOMER_ID_TYPE>客戶證件類型</CUSTOMER_ID_TYPE><CUSTOMER_ID>客戶證件號(hào)</CUSTOMER_ID><CUSTOMER_ACCOUNT_TYPE>客戶銀行賬號(hào)類型(可空)</CUSTOMER_ACCOUNT_TYPE><CUSTOMER_ACCT_NO>客戶銀行賬號(hào)</CUSTOMER_ACCT_NO><CUSTOMER_BANK_CODE>客戶銀行代碼</CUSTOMER_BANK_CODE><CUSTOMER_BANK_NAME>客戶銀行賬戶的開戶行名稱(可空)</CUSTOMER_BANK_NAME><CUSTOMER_BANK_AREA>客戶銀行賬戶的地區(qū)碼(可空)</CUSTOMER_BANK_AREA><AMOUNT>金額</AMOUNT><RORP>收付標(biāo)識(shí)</RORP><CURRENCY>幣種(可空)</CURRENCY></SLFSLINK>（2）SLFS響應(yīng)核心系統(tǒng)報(bào)文<?xmlversion="1.0"encoding="UTF-8"?><!--SLFS系統(tǒng)響應(yīng)核心系統(tǒng)報(bào)文--><SLFSLINK><BATCH_NO>批次號(hào)</BATCH_NO><OTHER_NO>業(yè)務(wù)號(hào)</OTHER_NO><CONTRACT_ID>主鍵ID</CONTRACT_ID><RET_CODE>0000</RET_CODE><ERR_MSG></ERR_MSG></SLFSLINK>2.3SLFS系統(tǒng)與廣州銀聯(lián)2.3.1請(qǐng)求報(bào)文說明接口字段ID字段名稱類型取值可空備注INFOTRX_CODE交易代碼C(1,20)100004否VERSION版本C(2)04可DATA_TYPE數(shù)據(jù)格式N(1)2：xml格式可LEVEL名處理級(jí)別N(1)0實(shí)時(shí)處理默認(rèn)0可USER_NAME用戶C(1,20)否USER_PASS用戶密碼否REQ_SN交易流水號(hào)C(30)否不重復(fù)流水(對(duì)代收付系統(tǒng)需要唯一)SIGNED_MSG簽名信息C否對(duì)本報(bào)文的所有信息進(jìn)行簽名（除本域外——也不含<SIGNED_MSG></SIGNED_MSG>）BODY/TRANS_SUMBUSINESS_CODE業(yè)務(wù)代碼C(6)見附錄4.2非空MERCHANT_ID商戶代碼C(15)銀聯(lián)網(wǎng)絡(luò)商戶ID非空SUBMIT_TIME提交時(shí)間C(14)YYYYMMDDHHMMSS可空TOTAL_ITEM總記錄數(shù)N(1,4)固定為1非空TOTAL_SUM總金額N(1,12)整數(shù)，單位分非空BODY/TRANS_DETAILS/TRANS_DETAILSN記錄序號(hào)C(1,25)同一個(gè)請(qǐng)求內(nèi)必須唯一。建議從0001開始遞增非空E_USER_CODE銀聯(lián)網(wǎng)絡(luò)用戶編號(hào)C(1,20)銀聯(lián)網(wǎng)絡(luò)客戶編號(hào)可空BANK_CODE銀行代碼C(3)3位的銀行代碼，見附錄4.3非空目前僅支持建行、工行、農(nóng)行ACCOUNT_TYPE賬號(hào)類型C(2)00銀行卡，01存折。不填默認(rèn)為銀行卡00?？煽誂CCOUNT_NO賬號(hào)N(1,32)銀行卡或存折號(hào)碼非空ACCOUNT_NAME賬號(hào)名C(1,60)銀行卡或存折上的所有人姓名。非空PROVINCE開戶行所在省C(1,20)不帶“省”或“自治區(qū)”，如廣東，廣西，內(nèi)蒙古等。建議根據(jù)后附的中國郵政區(qū)號(hào)表內(nèi)的“省洲名稱”列的內(nèi)容填寫?？煽誄ITY開戶行所在市C(1,20)不帶“市”，如廣州，南寧等。如果是直轄市，則填區(qū)，如北京（市）朝陽（區(qū)）。建議根據(jù)后附的中國郵政區(qū)號(hào)表內(nèi)的“地區(qū)名稱”列的內(nèi)容填寫?？煽誃ANK_NAME開戶行名稱C(1,60)開戶行詳細(xì)名稱，也叫網(wǎng)點(diǎn)，如中國建設(shè)銀行廣州東山廣場(chǎng)分理處?？煽誂CCOUNT_PROP賬號(hào)屬性C(1)0私人，1公司。不填時(shí)，默認(rèn)為私人0?？煽誂MOUNT金額N(1,12)整數(shù)，單位分非空CURRENCY貨幣類型C(3)人民幣：CNY,港元：HKD，美元：USD。不填時(shí)，默認(rèn)為人民幣。可空PROTOCOL協(xié)議號(hào)C(1,60)可空PROTOCOL_USERID協(xié)議用戶編號(hào)C(1,30)可空ID_TYPE開戶證件類型C(1)0：身份證,1:戶口簿，2：護(hù)照,3.軍官證,4.士兵證，5.港澳居民來往內(nèi)地通行證,6.臺(tái)灣同胞來往內(nèi)地通行證,7.臨時(shí)身份證,8.外國人居留證,9.警官證,X.其他證件可空ID證件號(hào)C(1,22)可空TEL手機(jī)號(hào)/小靈通C(1,13)小靈通帶區(qū)號(hào)，不帶括號(hào)，減號(hào)可空RECKON_ACCOUNT清算賬號(hào)C(1,30)資金清算賬號(hào)可空商戶有需要把一天的交易清算到不同賬戶時(shí)填寫CUST_USERID自定義用戶號(hào)C(1,20)商戶自定義的用戶號(hào)，用戶號(hào)要唯一可空REMARK備注C(1,50)供商戶填入?yún)⒖夹畔⒖煽誖ESERVE1保留域1C(1,200)備用字段1可空RESERVE2保留域2C(1,200)備用字段2可空數(shù)字簽名原文為沒有SIGNED_MSG 簽名信息項(xiàng)的xml全文。2.3.2響應(yīng)報(bào)文說明接口字段ID字段名稱類型取值可空備注INFOTRX_CODE交易代碼C(1,20)100004否VERSION版本C(2)04可DATA_TYPE數(shù)據(jù)格式N(1)2：xml格式可REQ_SN交易流水號(hào)C(16)否同請(qǐng)求流水RET_CODEHYPERLINK返回代碼C(4)否附錄4反饋代碼表ERR_MSG錯(cuò)誤信息C(1,256)可SIGNED_MSG簽名信息C否對(duì)本報(bào)文的所有信息進(jìn)行簽名（除本域外——也不含<SIGNED_MSG></SIGNED_MSG>）BODY/RET_DETAILS/RET_DETAILSN記錄序號(hào)C(1,25)可ACCOUNT_NO賬號(hào)C(1,32)否ACCOUNT_NAME賬號(hào)名C(1,60)否AMOUNT金額N(1,12)否CUST_USERID自定義用戶號(hào)C(1,20)可REMARK備注C(1,50)可RET_CODE返回碼C(4)否ERR_MSG錯(cuò)誤文本C(1,256)可RESERVE1備注域1C(1,200)備用字段1可空數(shù)字簽名原文為沒有SIGNED_MSG 簽名信息項(xiàng)的xml全文。2.3.3例子請(qǐng)求<?xmlversion="1.0"encoding="GBK"?><GZELINK> <INFO> <TRX_CODE>100001</TRX_CODE> <VERSION>04</VERSION> <DATA_TYPE>2</DATA_TYPE> <LEVEL>0</LEVEL> <USER_NAME>test</USER_NAME> <USER_PASS>test</USER_PASS> <REQ_SN>2009041611084101</REQ_SN> <SIGNED_MSG>簽名信息</SIGNED_MSG> </INFO> <BODY> <TRANS_SUM> <BUSINESS_CODE>10600</BUSINESS_CODE> <MERCHANT_ID>001053110000001</MERCHANT_ID> <SUBMIT_TIME>20090416120000</SUBMIT_TIME> <TOTAL_ITEM>1</TOTAL_ITEM> <TOTAL_SUM>1</TOTAL_SUM> </TRANS_SUM> <TRANS_DETAILS> <TRANS_DETAIL> <SN>0001</SN> <E_USER_CODE/> <BANK_CODE>105</BANK_CODE> <ACCOUNT_TYPE>00</ACCOUNT_TYPE> <ACCOUNT_NO>60138270140042110021</ACCOUNT_NO> <ACCOUNT_NAME>張三</ACCOUNT_NAME> <PROVINCE>廣東</PROVINCE> <CITY>廣州</CITY> <BANK_NAME>建行</BANK_NAME> <ACCOUNT_PROP>0</ACCOUNT_PROP> <AMOUNT>1</AMOUNT> <CURRENCY>CNY</CURRENCY> <PROTOCOL/> <PROTOCOL_USERID/> <ID_TYPE/> <ID/> <TEL/><RECKON_ACCOUNT/> <CUST_USERID/> <REMARK>保險(xiǎn)理賠</REMARK><RESERVE1/><RESERVE2/> </TRANS_DETAIL> </TRANS_DETAILS> </BODY></GZELINK>響應(yīng)<GZELINK> <INFO> <TRX_CODE>100001</TRX_CODE> <VERSION>04</VERSION> <DATA_TYPE>2</DATA_TYPE> <REQ_SN>2009041611084101</REQ_SN> <RET_CODE>0000</RET_CODE> <ERR_MSG/> <SIGNED_MSG>簽名信息</SIGNED_MSG> </INFO> <BODY> <RET_DETAILS> <RET_DETAIL> <SN>0001</SN> <ACCOUNT>60138270140042110021</ACCOUNT> <ACCOUNT_NAME>張三</ACCOUNT_NAME> <AMOUNT>1</AMOUNT><CUST_USERID></CUST_USERID> <REMARK></REMARK> <RET_CODE>0000</RET_CODE> <ERR_MSG/><RESERVE1/> </RET_DETAIL> </RET_DETAILS> </BODY></GZELINK>相關(guān)表結(jié)3.1契約信息表(T_SLFS_CHARGE_REALTIME)CONTRACT_IDNUMBER(20)N主鍵BATCH_NONUMBER(20)N批次號(hào)OTHER_NOVARCHAR2(20)N收付業(yè)務(wù)號(hào)OTHER_TYPEVARCHAR2(10)Y其他號(hào)碼類型FEE_TYPEVARCHAR2(20)Y費(fèi)用類型（保證金收費(fèi)，付費(fèi)）PAY_MODEVARCHAR2(10)Y收付方式SOURCE_CODEVARCHAR2(30)N來源代碼KIND_TYPEVARCHAR2(20)N業(yè)務(wù)系列，產(chǎn)，P，壽，L，集團(tuán)GMANAGER_COMVARCHAR2(20)N管理機(jī)構(gòu)CUSTOMER_TYPEVARCHAR2(20)YPRIVATEPRIVATE私人，PUBLIC公司。不填時(shí)，默認(rèn)為私人PRIVATE。CUSTOMER_ID_TYPEVARCHAR2(10)Y客戶證件類型，證件類型0：身份證,1:戶口簿，2：護(hù)照,3.軍官證,4.士兵證，5.港澳居民來往內(nèi)地通行證,6.臺(tái)灣同胞來往內(nèi)地通行證,7.臨時(shí)身份證,8.外國人居留證,9.警官證,X.其他證件CUSTOMER_IDVARCHAR2(150)Y客戶證件號(hào)CUSTOMER_ACCOUNT_TYPEVARCHAR2(10)Y客戶銀行賬號(hào)類型，00銀行卡01存折02信用卡CUSTOMER_ACCT_NOVARCHAR2(50)Y客戶銀行賬號(hào)CUSTOMER_NAMEVARCHAR2(480)Y客戶名稱CUSTOMER_BANK_CODEVARCHAR2(50)Y客戶銀行代碼CUSTOMER_BANK_NAMEVARCHAR2(250)Y客戶銀行賬戶的開戶行名稱CUSTOMER_BANK_AREAVARCHAR2(50)Y客戶銀行賬戶的地區(qū)碼AMOUNTNUMBER(16,2)N金額RORPVARCHAR2(20)N是收還是支R標(biāo)識(shí)收，P表示支。CURRENCYVARCHAR2(10)N幣種ACCRUAL_NONUMBER(20)Y財(cái)務(wù)實(shí)際收付號(hào)，收付完畢，由財(cái)務(wù)回寫，如果是批次送回盤，這里是批次號(hào)。ACCRUAL_DATEDATEY實(shí)收實(shí)付日期ACCRUAL_FLAGCHAR(1)Y收付成功標(biāo)識(shí)，S標(biāo)識(shí)成功，F(xiàn)標(biāo)識(shí)失敗，N收費(fèi)結(jié)果未知,銀行轉(zhuǎn)帳，支票等支付方式ERROR_DESCVARCHAR2(250)Y收付如果失敗，失敗的原因是什么。LAST_UPDATE_DATEDATEYLAST_UPDATED_BYVARCHAR2(80)YCREATION_DATEDATEYCREATED_BYVARCHAR2(80)Y3.2廣州銀聯(lián)交互表（T_SLFS_GZELINK_INFO）GZELINK_IDNUMBER(20)N主鍵BUSINESS_IDNUMBER(20)N保證金/契約表主鍵IDOTHER_NOVARCHAR2(20)N收付業(yè)務(wù)號(hào)OTHER_TYPEVARCHAR2(10)Y其他號(hào)碼類型FEE_TYPEVARCHAR2(20)Y費(fèi)用類型（保證金收費(fèi)，付費(fèi)）PAY_MODEVARCHAR2(10)Y收付方式SOURCE_CODEVARCHAR2(30)N來源代碼KIND_TYPEVARCHAR2(20)N業(yè)務(wù)系列，產(chǎn)，P，壽，L，集團(tuán)GMANAGER_COMVARCHAR2(20)N管理機(jī)構(gòu)CUSTOMER_TYPEVARCHAR2(20)YPRIVATEPRIVATE私人，PUBLIC公司。不填時(shí)，默認(rèn)為私人PRIVATE。CUSTOMER_ID_TYPEVARCHAR2(10)Y客戶證件類型，證件類型0：身份證,1:戶口簿，2：護(hù)照,3.軍官證,4.士兵證，5.港澳居民來往內(nèi)地通行證,6.臺(tái)灣同胞來往內(nèi)地通行證,7.臨時(shí)身份證,8.外國人居留證,9.警官證,X.其他證件CUSTOMER_IDVARCHAR2(150)Y客戶證件號(hào)CUSTOMER_ACCOUNT_TYPEVARCHAR2(10)Y客戶銀行賬號(hào)類型，00銀行卡01存折02信用卡CUSTOMER_ACCT_NOVARCHAR2(50)Y客戶銀行賬號(hào)CUSTOMER_NAMEVARCHAR2(480)Y客戶名稱CUSTOMER_BANK_CODEVARCHAR2(50)Y客戶銀行代碼CUSTOMER_BANK_NAMEVARCHAR2(250)Y客戶銀行賬戶的開戶行名稱CUSTOMER_BANK_AREAVARCHAR2(50)Y客戶銀行賬戶的地區(qū)碼AMOUNTNUMBER(16,2)N金額RORPVARCHAR2(20)N是收還是支R標(biāo)識(shí)收，P表示支。CURRENCYVARCHAR2(10)N幣種ACCRUAL_NONUMBER(20)Y財(cái)務(wù)實(shí)際收付號(hào)，收付完畢，由財(cái)務(wù)回寫，如果是批次送回盤，這里是批次號(hào)。ACCRUAL_DATEDATEY實(shí)收實(shí)付日期ACCRUAL_FLAGCHAR(1)Y收付成功標(biāo)識(shí)，S標(biāo)識(shí)成功，F(xiàn)標(biāo)識(shí)失敗，N收費(fèi)結(jié)果未知,銀行轉(zhuǎn)帳，支票等支付方式ERROR_DESCVARCHAR2(250)Y收付如果失敗，失敗的原因是什么。LAST_UPDATE_DATEDATEYLAST_UPDATED_BYVARCHAR2(80)YCREATION_DATEDATEYCREATED_BYVARCHAR2(80)Y附錄4.1銀行代號(hào)代碼名稱支持交易備注102中國工商銀行代收、代付103中國農(nóng)業(yè)銀行代收、代付存折只支持廣東省除深圳外104中國銀行代收、代付105中國建設(shè)銀行代收、代付303中國光大銀行代收、代付306廣東發(fā)展銀行代收、代付308招商銀行代收、代付403中國郵政儲(chǔ)蓄銀行代收、代付支持廣東、河南省代收，在省的域分別填對(duì)應(yīng)的卡開戶所在省4.2反饋代碼表交易類型反饋碼含義對(duì)應(yīng)<INFO>響應(yīng)碼與響應(yīng)信息（報(bào)文頭）批量代收代付交易0000系統(tǒng)接收成功1000報(bào)文域內(nèi)容檢查錯(cuò)（具體錯(cuò)誤見響應(yīng)報(bào)文中的ERR_MSG域）1001報(bào)文解析錯(cuò)（一般為報(bào)文格式有誤）實(shí)時(shí)交易0000處理完成0001系統(tǒng)處理失敗0002已撤銷1000報(bào)文內(nèi)容檢查錯(cuò)或者處理錯(cuò)（具體內(nèi)容見返回錯(cuò)誤信息）1001報(bào)文解釋錯(cuò)1002無法查詢到該交易，可以重發(fā)2000系統(tǒng)正在對(duì)數(shù)據(jù)處理2007提交銀行處理3028系統(tǒng)繁忙3045協(xié)議未生效(例工行協(xié)議同步)3097渠道不支持或者商戶不支持此渠道xxxx新增的響應(yīng)碼默認(rèn)我司接收成功，但最終結(jié)果均需通過查詢交易接口獲取查詢交易0000處理完成0001系統(tǒng)處理失敗0002已撤銷1000報(bào)文內(nèi)容檢查錯(cuò)或者處理錯(cuò)（具體內(nèi)容見返回錯(cuò)誤信息）1001報(bào)文解釋錯(cuò)1002無法查詢到該交易，可以重發(fā)2000系統(tǒng)正在對(duì)數(shù)據(jù)處理2001等待商戶審核2002商戶審核不通過2003等待銀聯(lián)網(wǎng)絡(luò)受理2004銀聯(lián)網(wǎng)絡(luò)不通過受理2005等待銀聯(lián)網(wǎng)絡(luò)復(fù)核2006銀聯(lián)網(wǎng)絡(luò)不通過復(fù)核2007提交銀行處理對(duì)應(yīng)<RET_DETAIL>響應(yīng)碼與響應(yīng)信息（報(bào)文體）查詢交易明細(xì)0000交易成功3001查開戶方原因3002沒收卡3003不予承兌3004無效卡號(hào)3005受卡方與安全保密部門聯(lián)系3006已掛失卡3007被竊卡3008余額不足3009無此賬戶3010過期卡3011密碼錯(cuò)30