首期實時收費需求

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