银行接口表结构说明文档

1、银行接口表结构说明书公司名称深圳市金证科技股份有限公司文档编号文档名称银行接口表结构说明书文档版本1.0起 草伍叶飞起草日期2015-04-21审 批李建永审批日期版本号日期状态修订人摘要1.02015-7-03C冷洪亮(大三实习生)修改文档修订历史状态标识：C Created A - Added M - Modified D - Deleted1. 协议类表1.1 表名BANK_*_AGREEMENT（*代表不同的银行渠道）1.2 用途记录投资者和各银行渠道的签约信息，便于托收支付等操作检查。1.3 字段例如BANK_ABC_AGREEMENT表即为农行签约协议表字段名类型为空默认值备注sa

2、veplannovarchar2(30)y协议号certificatetypevarchar2(4)y证件类型certificatenovarchar2(30)y证件号码investornamevarchar2(60)y投资人名depositacctvarchar2(30)y农行账号flagchar(1)y0未签订 1已签订 2已取消createdatedateysysdate创建时间1.4 说明各家银行渠道的协议表结构大体相同，一般都会记录（证件类型、证件号码、投资者姓名、银行卡号、签约标识）关键字段，其他差异字段因银行渠道的个体化差异而不同。2. 转换关系类表2.1 证件类型关系表2.1.

3、 1 表名BANK_CERTTYPE2.1.2 用途关联本地证件类型和银行证件类型的对应关系，便于生成报文参数时转换。2.1.3 字段字段名类型为空默认值备注bankvarchar2(20)ycmb 招行 icbc 工行 ccb建行 easypay好易联 chinapay银联 abc农行等 usertypechar(1)y'1'0机构 1个人sale_certtypevarchar2(2)y直销证件类型bank_certtypevarchar2(4)y银行证件类型descriptionvarchar2(40)y说明2.1.4 说明由于各家银行渠道的证件类型都有差异，所以发送报文

4、给银行时必须发送银行接受的证件类型，这时候就需要我们做一个证件类型的转换动作。这种转换是双向的。2.2 业务类型关系表2.2.1 表名BANK_BUSI_FUNCTION2.2.2 用途关联本地业务类型和银行业务类型的对应关系，便于生成报文参数时转换。2.2.3 字段字段名类型为空默认值备注businesscodevarchar2(20)y业务代码businesscodenamevarchar2(20)y业务代码名称funcitonvarchar2(10)y银行功能代码funcitonnamevarchar2(50)y银行功能代码名称bankvarchar2(10)ycmb 招行 icbc 工

5、行 ccb建行 easypay好易联 chinapay银联 industrial银联兴业银行 abc农行等iscancelvarchar2(1)y'n'是否走撤单接口 y 是 n否 农行 好易联根据该标志决定是否执行撤单动作 银联该标志无效2.2.4 说明由于各家银行渠道的业务类型都有差异，所以发送报文给银行时必须发送银行接受的业务类型，这时候就需要我们做一个业务类型的转换动作。这种转换是双向的。2.3 基金类型关系表2.3.1 表名BANK_FUNDTYPE2.3.2 用途关联本地基金类型和银行基金类型的对应关系，便于生成报文参数时转换。2.3.3 字段字段名类型为空默认值备

6、注bankvarchar2(20)ycmb 招行 icbc 工行 ccb建行 easypay好易联 chinapay银联 abc农行. sale_fundtypevarchar2(2)y直销基金类型sale_fundtypenamevarchar2(20)y直销基金类型名称bank_fundtypevarchar2(2)y银行基金类型bank_fundtypenamevarchar2(20)y银行基金类型名称2.3.4 说明由于各家银行渠道的基金类型都有差异，所以发送报文给银行时必须发送银行接受的基金类型，这时候就需要我们做一个基金类型的转换动作。这种转换是双向的。3. 参数配置表5.1 表名

7、BANK_COMMON_CONFIG5.2 用途基本参数配置表，存放各银行基本的参数配置，与perties灵活搭配。5.3 字段字段名类型为空默认值备注bankvarchar2(20)y银行简称-例cmb 招行 icbc 工行 ccb建行 easypay好易联 chinapay银联 industrial银联兴业银行 abc农行。 key_namevarchar2(50)y配置名称key_valuevarchar2(500)y配置值explanationvarchar2(200)y配置说明5.4 说明暂无4. 证书信息表6.1 表名CERT_INFO6.2 用途

8、存放部分证书的相关信息，证书检查时用到。6.3 字段字段名类型为空默认值备注bank_namevarchar2(300)银行名称cert_typevarchar2(300)证书类型(公钥-der,私钥-pkcs12)cert_pathvarchar2(2000)证书路径cert_explainvarchar2(2000)证书说明cert_not_aftervarchar2(2000)y证书过期时间 yyyy-mm-ddcert_not_beforevarchar2(2000)y证书开始时间 yyyy-mm-ddbak_colvarchar2(2000)y备用字段bak_col2varchar2

9、(2000)y备用字段2cert_info_idinteger主键cert_passwordvarchar2(200)y证书密码cert_dayvarchar2(50)y证书有效时间（天数）6.4 说明暂无5. 文件参数类表5.1 批量申购/赎回数据表5.1.1 表名SALE_BUY_DATA5.1.2 用途批量退款（还款），批量扣款（划款） （实时）会查询该表数据。5.1.3 字段字段名类型为空默认值备注paycenteridvarchar2(9)支付所属中心datatypeinteger0数据类型snointeger0buydatacloby购买数据5.1.4 说明批量退款，

10、批量扣款 （实时），business：BatchBusiness，method：batchPayBack,batchDraw注释：BatchBusiness会根据接收的参数(datatype和paycenterid)从表SALE_BUY_DATA的buydata中拿数据(只取一条结果)解析成list<map*>。buydata数据类型是CLOB，内容是多条数据，每条数据之间用&分隔，每条数据包含多个键值对，键值对之间用；分隔,例如：buydata内容格式：key1=value1;key12=value12&key21=value21;key22=value225.2

11、 对账单数据表5.2.1 表名SALE_FILE_DATA5.2.2 用途保存下载的对账数据。5.2.3 字段字段名类型为空默认值备注paycenteridvarchar2(9)支付所属中心datatypeinteger0数据类型snointeger0filedatabloby文件数据filenamevarchar2(128)y' '文件名descfiledatalenvarchar2(16)'0'5.2.4 说明下载对账文件（将文件内容插入到相关表里）business：DownloadBusiness，method：downLoadSettleF

12、ile,getFileResult注释：DownloadBusiness是从某一处(银行接口之外)下载对账文件(类型一般为.txt)，并将对账文件的内容写入表sale_file_data中的filedata中。Filedata数据类型是blob,数据内容是对账单，而对账单的格式都是各自的标准，也就是说：表sale_file_data中的每条数据中的filedata的内容格式不一定相同。生成落地文件（商户平台上传）（将文件内容插到相关表里）business：MakeFileBusiness，method：makeBindFile,makeTransConfirmFile,makeD

13、ividendFile,makePayBackFile,makeSavePlanFile,makePayMonitorFile注释：MakeFileBusiness生成文件之后，会根据要求和文件类型选择落地方式，有的方式会插入返回给kcbp的数据 文件内容到表sale_file_data里。5.3 对账单转换数据表5.3.1 表名SALE_CONVERT_FILE_DATA5.3.2 用途对账单转换用到。保存对账转换前后数据。5.3.3 字段字段名类型为空默认值备注paycenteridvarchar2(9)支付所属中心datatypeinteger0数据类型snointeger0fileda

14、tacloby文件数据descfiledatabloby文件数据(转换后)descfiledatalenvarchar2(16)'0'转换后数据长度5.3.4 说明对账单转换（转换成bp所需的内容）（有的文件需要解密）business：ConverSettleFileBusiness，method：getSettleContent注释：ConverSettleFileBusiness从表SALE_CONVERT_FILE_DATA的filedata中拿数据，并对数据进行转换(细节见注释1)，将转换之后的数据写入SALE_CONVERT_FILE_DATA的desc

15、filedata中。Filedata数据类型是clob,数据内容是对账单，而对账单的格式都是各自的标准，也就是说：表SALE_CONVERT_FILE_DATA中的每条数据中的filedata的内容格式不一定相同。Descfiledata的数据类型是blob，数据内容是转换后的对账单。注释1：对账单转换（转换成bp所需的内容）（有的文件需要解密）1.根据payceterid datatype sno查询SALE_CONVERT_FILE_DATA表获取FILEDATA值并转成inputstream2.再根据对应subbankno的settler执行导入（区分settleMode对账单模式(im

16、pPay, impPayBack)）读取每行解析成map，最后整个inputstream解析成list<map*>，再匹配成bp接受的参数list<map*>再将list<map*>转成key=value1|key2=value2&(多行)3.更新SALE_CONVERT_FILE_DATA的descFileData字段5.4 文件发送数据表5.4.1 表名SALE_RESERVE_DATA5.4.2 用途生成文件发送（上传）和生成落地文件（商户平台上传）时用到。5.4.3 字段字段名类型为空默认值备注paycenteridvarchar2(9)支付

17、渠道网点代码datatypeinteger0数据类型snointeger0序号senddatavarchar2(1024)y发送数据modidatechar(8)to_char(sysdate,'yyyymmdd')写入日期5.4.4 说明生成文件发送（上传）：business：IntendanceBusiness，method：makeUpdateFile,makeStopFile,makeImageUpdateFile,makeWasteFile,makeBuyFundFile,makeTransactConfirmFile,makeSharesFile,ma

18、keOpenAccountFile,sendBankData,makeBankDataFile,makeBuycompFile,makeShareFile,makeTradeFile,makeAccountFile,makeFasttransFile,makePurchaseFile,makeSellcompFile,makeFundProductFile,combineBankDataFile,makeCancelApplyFile,makeEleContractSignFile,makeFollowEleContractSignFile,makeFundDetailFile,makeFun

19、dBuyRatesFile,makeFundPresetFile注释：IntendanceBusiness根据接收的参数(datatype或paycenterid)从表sale_reserve_data的senddata中拿数据解析成list<map*>。Senddata的数据类型是VARCHAR2(1024 BYTE)，是有大小限制的，这里面存储的数据不能无限大，表sale_reserve_data的每一条数据中的senddata只存储一条记录，没条记录包含多个键值对，每个键值对之间用；隔开，例如：senddata内容格式：key1=value1;key2=value2;key3

20、=value生成落地文件（商户平台上传）（将文件内容插到相关表里）business：MakeFileBusiness，method：makeBindFile,makeTransConfirmFile,makeDividendFile,makePayBackFile,makeSavePlanFile,makePayMonitorFile注释， IntendanceBusiness根据接收的参数(datatype或paycenterid)从表sale_reserve_data的sendData中拿数据解析成list<map*>。sendData的数据类型是VARCHAR

21、2(1024 BYTE)，是有大小限制的，这里面存储的数据不能无限大，表sale_reserve_data的每一条数据中的senddata只存储一条记录，没条记录包含多个键值对，每个键值对之间用；隔开。6. 流水数据表11.1 表名SALE_SERIALNO_DATA6.2 用途11.3 字段字段名类型为空默认值备注paycenteridvarchar2(9)支付所属中心datatypeinteger0数据类型serialnovarchar2(32)系统流水号serialno2bankvarchar2(32)y送银行的流水号11.4 说明11.4.1 生成落地文件（商户平台上传）（将文件内容插

22、到相关表里）business：MakeFileBusiness，method：makeBindFile,makeTransConfirmFile,makeDividendFile,makePayBackFile,makeSavePlanFile,makePayMonitorFile注释：MakeFileBusiness生成文件之后，会根据要求和文件类型选择落地方式，有的方式会插入返回给kcbp的数据 流水号到表sale_serialno_data里。7. 数据记录表11.1 表名BANK_*_DATA_RECORDS(*为各银行渠道)7.2 用途记录各渠道调用的入参出参信息11.3 字段字段名

23、类型为空默认值备注app_idvarchar2(20)系统来源branch_codevarchar2(20)银行代码function_namevarchar2(20)调用的方法名versionvarchar2(20)调用的方法版本号execute_timedate调用时间msgvarchar2(40)y信息in_certificatetypevarchar2(2)y证件类型in_certificatenovarchar2(25)y证件号码in_depositacctnamevarchar2(30)y投资人姓名in_depositacctvarchar2(32)y投资者账号in_bankseri

24、alnovarchar2(40)y银行流水号in_appsheetserialnovarchar2(40)y系统流水号detail_databloby详细数据data_descvarchar2(1024)y数据字段描述11.4 说明暂无8. 接口参数类表8.1接口版本表8.1.1 表名CFG_CLASS8.1.2 用途接口版本表，记录各渠道银行的Java执行类和版本信息8.1.3 字段字段名类型为空默认值备注idnumber(14)标识versionvarchar2(20)1.0版本号bank_codevarchar2(64)银行代码bank_namevarchar2(16)银行简称（如abc

25、,alipay,allinpay,boc等）class_namevarchar2(256)接口类名reserve_fieldvarchar2(1024)y预留字段descriptionvarchar2(256)y描述8.1.4 说明暂无8.2接口方法表8.2.1 表名CFG_FUNCTION8.2.2 用途接口方法表，记录调用方法的相关信息8.2.3 字段字段名类型为空默认值备注idnumber(14)接口idversion_class_idnumber(14)版本接口类idfunction_namevarchar2(256)接口名称statuschar(1)y0接口状态（0：正常，1：暂停服

26、务，2：停止服务）validate_flagchar(1)y1是否校验所有参数（0：不校验，1：校验）reserve_fieldvarchar2(1024)y预留字段descriptionvarchar2(256)y描述comtypevarchar2(16)y通讯类型（post，socket）8.2.4 说明version_class_id字段可以关联CFG_CLASS的id查询8.3接口参数表8.3.1 表名CFG_PARAMETER8.3.2 用途接口参数表，记录调用参数的相关信息8.3.3 字段字段名类型为空默认值备注idnumber(14)参数idfunction_idnumber(1

27、4)所属接口idnamevarchar2(256)参数名称param_modechar(1)0参数类型（0：入参，1：出参）idxnumber(3)入参（出参）参数顺序typevarchar2(256)'string'"数据类型（默认为java.lang.stablevalidate_flagchar(1)1是否校验（0不校验，1：校验）requiredchar(1)1是否必须（0：可选，1：必须）default_valuevarchar2(1024)y默认值（只有当required为假并该参数值为空的时候才有效）lengthvarchar2(50)y'1,1024'长度（支持区间 默认1,1024）value_listvarchar2(1024)y参数值集合(半角逗号分隔，请求的参数值必须在此集合里)regexvarchar2(1024)y"正则表达式（java中的正则表达式trigger_conditionvarchar2(1024)y"触发条件（如果为空则始终执行该校验rule_classvarchar2(256)y自定义规则校验类名reserve_fieldvarchar2(1024)y预留字段descriptionvarchar2(256)y描述8.3.4 说明