网银互联直联接口说明指导书.doc

hao网银互联接口阐明书Version 1.0修订记录日期修订版本修订人修订内容-9-31.0吴桐新建目录修订记录11公共查询21.1查询业务经办业务控制信息21.2交易查询61.3业务交易明细查询111.4业务总揽查询172网银贷记233签约管理273.1网银贷记协议签订经办273.2协议查询31附录A46A.1 银行号（2位）46A.2 返回代码50A.3 货币代码表50A.4 业务代码51A.5 业务请求状态52A.6 业务处理结果52A.48交易状态表53A.49业务类型54附录B56B.1 数据类型约定561 公共查询1.1 查询业务经办业务控制信息 祈求报文阐明交易名称查询业务经办业务控制信息报文方向祈求报文接口字段ID字段名称类型取值可空备注INFOFUNNAM函数名C(1，20)NTQEBCTL否DATTYP数据格式N(1)2：xml格式三否LGNNAM登陆顾客名Z(1,20)可前置机模式必填NTBUSMODYBUSCOD业务类型C(6)N31010=网银贷记N31011=网银借记N31012=第三方贷记N31013=跨行账户信息查询否BUSMOD业务模式C(5)可应答报文阐明交易名称查询业务经办业务控制信息报文类型响应报文接口字段ID字段名称类型取值可空备注INFOFUNNAM函数名C(1，20)NTQEBCTL否DATTYP数据格式N(1)2：xml格式三否RETCOD返回代码N附录A.2否ERRMSG错误信息Z(1,256)可NTQBSCTLZCCYNBR币种C(2)LOWAMT金额下限MHGHAMT金额上限MRCVLMT与否有收方限制C(1)CHKSUM校验和C(10)RSV50Z保存字段 50C(50)NTQEBACCZBBKNBR银行号C(2)附录A.1ACCNBR帐号C(35)INNFLG我行帐号标志C(1)Y:我行行内帐号 N:她行帐号ACCNAM帐户名称Z(200)CCYNBR币种C(2)附录A.3RELNBR客户关系编号C(10)BNKBRD行号C(12)ACCFLG状态C(1)RSV30Z保存字 30C(30)接口阐明接口ID接口名称重复次数备注NTBUSMODY输入接口1NTQBSCTLZ输出接口(单记录)0.1输入接口字段BUSMOD不为空时才返回数据。NTQEBACCZ输出接口(多记录)nn为查询实际成果数祈求报文范例NTQEBCTL2OL03N31010应答报文范例2NTQEBCTLOL030A欧弟专属测试户05404CB10YA欧弟专属测试户01711CB10YA欧弟专属测试户02722CB10YA欧弟专属测试户03733CB10Y1.2 交易查询 祈求报文阐明交易名称交易查询报文方向祈求报文接口字段ID字段名称类型取值可空备注INFOFUNNAM函数名C(1，20)NTQRYEBP否DATTYP数据格式N(1)2：xml格式三否LGNNAM登陆顾客名Z(1,20)可前置机模式必填NTWAUEBPYBUSCOD业务类型C(6)N31010网银贷记N31011网银借记N31012第三方贷记N31013跨行账户信息查询可BGNDAT起始日期D否日期间隔不能超过100天ENDDAT结束日期D否MINAMT最小金额MMAXAMT最大金额MYURREF业务参照号C(30)OPRLGN经办顾客Z(30)AUTSTR祈求状态C(30)附录A.5可以组合取值，例如AUTSTR = AUTNTEWCFRTNSTR返回成果C(30)附录 A.6可以组合取值，例如RTNSTR = SFBRCNVNBR内部合同号C(10)应答报文阐明交易名称交易查询报文类型响应报文接口字段ID字段名称类型取值可空备注INFOFUNNAM函数名C(1，20)NTQRYEBP否DATTYP数据格式N(1)2：xml格式三否RETCOD返回代码N附录A.2否ERRMSG错误信息Z(1,256)可NTWAUEBPZREQNBR流程实例号C(10)BUSCOD业务类型C(6)附录A.4BUSMOD业务模式C(5)BBKNBR银行号C(2)附录A.1ACCNBR帐号C(35)CCYNBR币种C(2)附录A.3TRSAMT金额MOPRDAT经办日DYURREF参照号C(30)REQSTS祈求状态C(3)附录A.5RTNFLG业务解决成果C(1)附录 A.6ATHFLG附件标志C(1)RSV30Z保存字 30C(30)接口阐明接口ID接口名称重复次数备注NTWAUEBPY输入接口1NTWAUEBPZ输出接口(多记录)nn为查询实际成果数祈求报文范例 NTQRYEBP 2 OL03 * 0701 0724 应答报文范例2NTQRYEBPOL030404NCBN3101000001100718FINF10.00404NCBN3101000001100721AUT50.001.3 业务交易明细查询 祈求报文阐明交易名称业务交易明细查询报文方向祈求报文接口字段ID字段名称类型取值可空备注INFOFUNNAM函数名C(1，20)NTEBPINF否DATTYP数据格式N(1)2：xml格式三否LGNNAM登陆顾客名Z(1,20)可前置机模式必填NTEBPINFXREQNBR流程实例号C(10)是非必输，但两个字段必输一种TRXNBRNP交易流水号C(11)是应答报文阐明交易名称业务交易明细查询报文类型响应报文接口字段ID字段名称类型取值可空备注INFOFUNNAM函数名C(1，20)NTEBPINF否DATTYP数据格式N(1)2：xml格式三否RETCOD返回代码N附录A.2否ERRMSG错误信息Z(1,256)可NTEBPINFZREQNBR流程实例号C(10)TRXNBRNP交易流水号C(11)TRXDIR交易方向C(1)I：提回O：提出MSGNBR报文类型C(3)101：网银贷记103：网银借记105：第三方贷记TRXDAT交易日期DTRXSTS交易状态C(2)附录 A.48IBPKEY报文键值C(50)TRSDAT委托日期DTRSTIM委托时间TCNVNBR内部合同号C(10)CCYNBR交易货币C(2)附录 A.3TRXAMT交易金额MCLTEAC我行客户户口C(35)CLTNBR我行客户号C(10)ACRBRD付款人开户行行号C(12)ACRNAM付款人开户行名称Z(100)PYREAC付款人账号C(35)PYRNAM付款人名称Z(100)DBTCLR付款清算行行号C(12)DBTPAR付款人开户行所属网银系统行号C(12)OTHBRD发起参加者C(12)ACEBRD收款人开户行行号C(12)ACENAM收款人开户行名称Z(100)PYEEAC收款人账号C(35)PYENAM收款人名称Z(100)CDTCLR收款清算行行号C(12)CDTPAR收款人开户行所属网银系统行号C(12)FEEAMT手续费金额M第三方贷记手续费金额，其她业务为0FEEBRD手续费收款行行号C(12)FEEACC手续费收款人账号C(35)FEENAM手续费收款人名称Z(100)NETDAT网上交易日期DNETSEQ网上交易单号C(35)NETTXT网上交易阐明Z(200)AUTTYP认证方式C(4)AUTFLG认证信息附加标记C(1)1= 自动2= 手工3= 内部转账AUTFMT认证信息C(140)客户单放在明细最末尾REMARK交易附言Z(235)BUSCOD业务类型编码C(4)附录A.49BUSTYP业务种类编码C(5)ISUCNL发起渠道C(3)CLTSEQ发起方键值C(10)YURREF业务参照号C(30)TRXSET交易套号C(15)ACTSET记账套号C(15)ACTDAT记账日期DRJCCOD回绝码C(4)RJCRSN回绝因素Z(175)RTNNAR成果摘要Z(120)RSV50Z保存字 50接口阐明接口ID接口名称重复次数备注NTEBPINFX输入接口1NTEBPINFZ输出接口(单记录)1祈求报文范例 NTEBPINF 2 OL03 应答报文范例 2 NTEBPINF OL03 0 中华人民共和国工商银行 招商银行股份有限公司 C204 01100 10 404 0.00 ICO 101 8888 欧弟测试户口02 404 欧弟专属测试户05 擦擦擦 CMZ0010 -信息文本提取错误，错误码M3CQ111 - CPF2499。 0530 104847 10.00 0530 O 01 1.4 业务总揽查询 祈求报文阐明交易名称业务总揽查询报文方向祈求报文接口字段ID字段名称类型取值可空备注INFOFUNNAM函数名C(1,20)NTQNPEBP否DATTYP数据格式N(1)2：xml格式三否LGNNAM登陆顾客名Z(1,20)可前置机模式必填NTQNPEBPYQRYACC账号C(35)否TRXDIR交易方向C(1)I：提回O：提出否MSGNBR业务种类C(3)101：网银贷记103：网银借记105：第三方贷记否BGNDAT交易起始日期D否日期间隔不能超过100天ENDDAT交易结束日期D否MINAMT最小金额MMAXAMT最大金额MYURREF业务参照号C(30)TRXSTS交易状态C(2)附录 A.48PYREAC付款人账号C(35)PYEEAC收款人账号C(35)CNVNBR内部合同号C(10)应答报文阐明交易名称业务总揽查询报文类型响应报文接口字段ID字段名称类型取值可空备注INFOFUNNAM函数名C(1，20)NTQNPEBP否DATTYP数据格式N(1)2：xml格式三否RETCOD返回代码N附录A.2否ERRMSG错误信息Z(1,256)可NTQNPEBPZTRXNBRNP交易流水号C(11)TRXDIR交易方向C(1)I：提回O：提出MSGNBR业务种类C(3)101：网银贷记103：网银借记105：第三方贷记否TRXDAT交易日期DTRXSTS交易状态C(2)附录 A.48CCYNBR交易货币C(2)附录 A.3TRXAMT交易金额MPYREAC付款人账号C(35)PYRNAM付款人名称Z(100)PYEEAC收款人账号C(3)PYENAM收款人名称Z(100)YURREF业务参照号C(30)CNVNBR内部合同号C(10)RSV30Z保存字 30C(30)接口阐明接口ID接口名称重复次数备注NTQNPEBPY输入接口1NTQNPEBPZ输出接口(多记录)nn为查询实际成果数祈求报文范例 NTQNPEBP 2 OL03 404 O 101 0330 0630 应答报文范例 2 NTQNPEBP OL03 0 10 101 7398 欧弟工行账号 404 欧弟专属测试户05 11.00 0530 O 01 10 101 8888 欧弟测试户口02 404 欧弟专属测试户05 10.00 0530 O 01 2 网银贷记祈求报文阐明交易名称网银贷记报文方向祈求报文接口字段ID字段名称类型取值可空备注INFOFUNNAM函数名C(1，20)NTIBCOPR否DATTYP数据格式N(1)2：xml格式三否LGNNAM登陆顾客名Z(1,20)可前置机模式必填NTOPRMODXBUSMOD业务模式C(5)否NTIBCOPRXSQRNBR流水号C(10)否批次内唯一，批量经办时用作响应成果与祈求相应字段。BBKNBR付款账号银行号C(2)否ACCNBR付款账号C(35)否我行账号CNVNBR合同号C(10)否贷记内部合同号YURREF业务参照号C(30)否成功和在途业务唯一CCYNBR币种C(2)附录 A.3否TRSAMT金额M否CRTSQN收方编号C(20)可NTFCH1告知方式一C(40)是NTFCH2告知方式二C(40)是CDTNAM收款人户名Z(100)否CDTEAC收款人账号C(35)否CDTBRD收款行行号C(12)否TRSTYP业务类型编码C(4)附录A.49否TRSCAT业务种类编码C(5)否RMKTXT附言Z(235)是RSV30Z保存字 30应答报文阐明交易名称网银贷记报文类型响应报文接口字段ID字段名称类型取值可空备注INFOFUNNAM函数名C(1，20)NTIBCOPR否DATTYP数据格式N(1)2：xml格式三否RETCOD返回代码N附录A.2否ERRMSG错误信息Z(1,256)可NTOPRRTNZSQRNBR流水号C(10)REQNBR流程实例号C(10)REQSTS祈求状态C(3)附录A.5OPRSQN待解决操作序列C(3)OPRALS操作别名Z(32)RTNFLG业务解决成果C(1)附录 A.6ERRCOD错误代码C(7)系统返回错误代码ERRTXT错误文本Z(92)NTOPRDRTZRTNTIM等待时间N(3)单位：秒RSV50Z保存字段 50C(50)接口阐明接口ID接口名称重复次数备注NTOPRMODX输入接口1NTIBCOPRX输入接口(单记录)1.30NTOPRDRTZ输出接口(单记录)0.1NTOPRRTNZ输出接口(单记录)1.30祈求报文范例 NTIBCOPR 2 OL03 00001 CB 404 10 10 RCV0000002 林志玲 8888123 C208 0 应答报文范例 2 NTIBCOPR OL03 0 SUC0000 BNK 3 签约管理3.1 网银贷记合同订立经办祈求报文阐明交易名称网银贷记合同订立经办报文方向祈求报文接口字段ID字段名称类型取值可空备注INFOFUNNAM函数名C(1，20)NTSGNCBC否DATTYP数据格式N(1)2：xml格式三否LGNNAM登陆顾客名Z(1,20)可前置机模式必填NTOPRMODXBUSMOD业务模式C(5)否NTSGNCBCXBBKNBR银行号C(2)否ACCNBR我行账号C(35)否PYETEL联系电话C(35)是YURREF业务参照号C(30)否SGNLMT单笔业务金额上限M是不输表达无单笔金额限制DAYCNT日合计业务笔数上限N(8)是不输表达无日合计业务笔数限制DAYLMT日合计金额上限N(15)是不输表达无日合计金额上限限制MTHCNT月合计业务笔数上限N(8)是不输无月合计业务笔数上限限制MTHLMT月合计金额上限N(15)是不输表达无月合计金额上限EFTDAT合同生效日期D否IFTDAT合同失效日期D是如果不填写则表达合同永久有效RMKINF签约阐明Z(256)是应答报文阐明交易名称网银贷记合同订立经办报文类型响应报文接口字段ID字段名称类型取值可空备注INFOFUNNAM函数名C(1，20)NTSGNCBC否DATTYP数据格式N(1)2：xml格式三否RETCOD返回代码N附录A.2否ERRMSG错误信息Z(1,256)可NTOPRRTNZREQNBR流程号C(10)REQSTS祈求状态C(3)附录A.5OPRSQN待解决操作序列C(3)OPRALS操作别名Z(32)RTNFLG业务解决成果C(1)附录 A.6ERRCOD错误