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

hao网银互联接口阐明书
Version 1.0

修订记录
日期
修订版本
修订人
修订内容
-9-3
1.0
吴桐
新建

目录
修订记录 1
1 公共查询 2
1.1 查询业务经办业务控制信息 2
1.2 交易查询 6
1.3 业务交易明细查询 11
1.4 业务总揽查询 17
2 网银贷记 23
3 签约管理 27
3.1 网银贷记协议签订经办 27
3.2 协议查询 31
附录A 46
A.1 银行号（2位） 46
A.2 返回代码 50
A.3 货币代码表 50
A.4 业务代码 51
A.5 业务请求状态 52
A.6 业务处理结果 52
A.48交易状态表 53
A.49业务类型 54
附录B 56
B.1 数据类型约定 56

1 公共查询
1.1 查询业务经办业务控制信息
祈求报文阐明
交易名称
查询业务经办业务控制信息
报文方向
祈求报文
接口
字段ID
字段名称
类型
取值
可空
备注
INFO
FUNNAM
函数名
C(1，20)
NTQEBCTL
否

DATTYP
数据格式
N(1)
2：xml格式三
否

LGNNAM
登陆顾客名
Z(1,20)

可
前置机模式必填
NTBUSMODY
BUSCOD

业务类型
C(6)
N31010=网银贷记
N31011=网银借记
N31012=第三方贷记
N31013=跨行账户信息查询
否

BUSMOD
业务模式
C(5)

可

应答报文阐明
交易名称
查询业务经办业务控制信息
报文类型
响应报文
接口
字段ID
字段名称
类型
取值
可空
备注
INFO
FUNNAM
函数名
C(1，20)
NTQEBCTL
否

DATTYP
数据格式
N(1)
2：xml格式三
否

RETCOD
返回代码
N
附录A.2
否

ERRMSG
错误信息
Z(1256)

可

NTQBSCTLZ
CCYNBR
币种
C(2)

LOWAMT
金额下限
M

HGHAMT
金额上限
M

RCVLMT
与否有收方限制
C(1)

CHKSUM
校验和
C(10)

RSV50Z
保存字段 50
C(50)

NTQEBACCZ
BBKNBR
银行号
C(2)
附录A.1

ACCNBR
帐号
C(35)

INNFLG
我行帐号标志
C(1)

Y:我行行内帐号 N:她行帐号
ACCNAM
帐户名称
Z(200)

CCYNBR
币种
C(2)
附录A.3

RELNBR
客户关系编号
C(10)

BNKBRD
行号
C(12)

ACCFLG
状态
C(1)

RSV30Z
保存字 30
C(30)

接口阐明
接口ID
接口名称
重复次数
备注
NTBUSMODY
输入接口
1

NTQBSCTLZ
输出接口(单记录)
0..1
输入接口字段BUSMOD不为空时才返回数据。
NTQEBACCZ
输出接口(多记录)
n
n为查询实际成果数

祈求报文范例

NTQEBCTL
2
OL03

N31010

应答报文范例

P>2

NTQEBCTL
OL03
0

A
欧弟专属测试户05
404
CB

10
>Y

A
欧弟专属测试户01
711
CB

10
Y

G>A
欧弟专属测试户02
722
CB

10
Y

A
欧弟专属测试户03
733
BKNBR>CB

10
Y

1.2 交易查询
祈求报文阐明
交易名称
交易查询
报文方向
祈求报文
接口
字段ID
字段名称
类型
取值
可空
备注
INFO
FUNNAM
函数名
C(1，20)
NTQRYEBP
否

DATTYP
数据格式
N(1)
2：xml格式三
否

LGNNAM
登陆顾客名
Z(1,20)

可
前置机模式必填
NTWAUEBPY
BUSCOD
业务类型
C(6)
N31010 网银贷记
N31011 网银借记
N31012 第三方贷记
N31013 跨行账户信息查询
可

BGNDAT
起始日期
D

否
日期间隔不能超过100天
ENDDAT
结束日期
D

否
MINAMT
最小金额
M

MAXAMT
最大金额
M

YURREF
业务参照号
C(30)

OPRLGN
经办顾客
Z(30)

AUTSTR
祈求状态
C(30)
附录A.5

可以组合取值，例如AUTSTR = 'AUTNTEWCF'
RTNSTR
返回成果
C(30)
附录 A.6

可以组合取值，例如RTNSTR = 'SFBR'
CNVNBR
内部合同号
C(10)

应答报文阐明
交易名称
交易查询
报文类型
响应报文
接口
字段ID
字段名称
类型
取值
可空
备注
INFO
FUNNAM
函数名
C(1，20)
NTQRYEBP
否

DATTYP
数据格式
N(1)
2：xml格式三
否

RETCOD
返回代码
N
附录A.2
否

ERRMSG
错误信息
Z(1,256)

可

NTWAUEBPZ
REQNBR
流程实例号
C(10)

BUSCOD
业务类型
C(6)
附录A.4

BUSMOD
业务模式
C(5)

BBKNBR
银行号
C(2)
附录A.1

ACCNBR
帐号
C(35)

CCYNBR
币种
C(2)
附录A.3

TRSAMT
金额
M

OPRDAT
经办日
D

YURREF
参照号
C(30)

REQSTS
祈求状态
C(3)
附录A.5

RTNFLG
业务解决成果
C(1)
附录 A.6

ATHFLG
附件标志
C(1)

RSV30Z
保存字 30
C(30)

接口阐明
接口ID
接口名称
重复次数
备注
NTWAUEBPY
输入接口
1

NTWAUEBPZ
输出接口(多记录)
n
n为查询实际成果数

祈求报文范例

NTQRYEBP
TTYP>2
OL03

******
0701
0724

BR>

应答报文范例

2

NTQRYEBP
OL03
0

404
N
CBBR>
N31010
00001
10
0718

FIN
F
10.00

404
N
CB
N31010
00001
10
0721

AUT
50.00

1.3 业务交易明细查询
祈求报文阐明
交易名称
业务交易明细查询
报文方向
祈求报文
接口
字段ID
字段名称
类型
取值
可空
备注
INFO
FUNNAM
函数名
C1，20)
NTEBPINF
否

DATTYP
数据格式
N(1)
2：xml格式三
否

LGNNAM
登陆顾客名
Z(1,20)

可
前置机模式必填
NTEBPINFX
REQNBR
流程实例号
C(10)

是
非必输，但两个字段必输一种
TRXNBR
NP交易流水号
C(11)

是

应答报文阐明
交易名称
业务交易明细查询
报文类型
响应报文
接口
字段ID
字段名称
类型
取值
可空
备注
INFO
FUNNAM
函数名
C(1，20)
NTEBPINF
否

DATTYP
数据格式
N(1)
2：xml格式三
否

RETCOD
返回代码
N
附录A.2
否

ERRMSG
错误信息
Z(1,256)

可

NTEBPINFZ
REQNBR
流程实例号
C(10)

TRXNBR
NP交易流水号
C(11)

TRXDIR
交易方向
C(1)
I：提回
O：提出

MSGNBR
报文类型
C(3)
101：网银贷记
103：网银借记
105：第三方贷记

TRXDAT
交易日期
D

TRXSTS
交易状态
C(2)
附录 A.48

IBPKEY
报文键值
C(50)

TRSDAT
委托日期
D

TRSTIM
委托时间
T

CNVNBR
内部合同号
C(10)

CCYNBR
交易货币
C(2)
附录 A.3

TRXAMT
交易金额
M

CLTEAC
我行客户户口
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

第三方贷记手续费金额，其她业务为0
FEEBRD
手续费收款行行号
C(12)

FEEACC
手续费收款人账号
C(35)

FEENAM
手续费收款人名称
Z(100)

NETDAT
网上交易日期
D

NETSEQ
网上交易单号
C(35)

NETTXT
网上交易阐明
Z(200)

AUTTYP
认证方式
C(4)

AUTFLG
认证信息附加标记
C(1)
1= 自动
2= 手工
3= 内部转账

AUTFMT
认证信息
C(140)

客户单放在明细最末尾
REMARK
交易附言
Z(235)

BUSCOD
业务类型编码
C(4)
附录A.49

BUSTYP
业务种类编码
C(5)

ISUCNL
发起渠道
C(3)

CLTSEQ
发起方键值
C(10)

YURREF
业务参照号
C(30)

TRXSET
交易套号
C(15)

ACTSET
记账套号
C(15)

ACTDAT
记账日期
D

RJCCOD
回绝码
C(4)

RJCRSN
回绝因素
Z(175)

RTNNAR
成果摘要
Z(120)

RSV50Z
保存字 50

接口阐明
接口ID
接口名称
重复次数
备注
NTEBPINFX
输入接口
1

NTEBPINFZ
输出接口(单记录)
1

祈求报文范例

NTEBPINF
2ATTYP>
OL03

应答报文范例

2

NTEBPINF
OL03
0

中华人民共和国工商银行

招商银行股份有限公司
C204
01100
10
404
>

0.00
ICO
101
8888
欧弟测试户口02
404
欧弟专属测试户05
擦擦擦

NNAR>CMZ0010 -信息文本提取错误，错误码M3CQ111 - CPF2499。
0530
104847
10.00
0530
O

01

1.4 业务总揽查询
祈求报文阐明
交易名称
业务总揽查询
报文方向
祈求报文
接口
字段ID
字段名称
类型
取值
可空
备注
INFO
FUNNAM
函数名
C(1,20)
NTQNPEBP
否

DATTYP
数据格式
N(1)
2：xml格式三
否

LGNNAM
登陆顾客名
Z(1,20)

可
前置机模式必填
NTQNPEBPY
QRYACC
账号
C(35)

否

TRXDIR
交易方向
C(1)
I：提回
O：提出
否

MSGNBR
业务种类
C(3)
101：网银贷记
103：网银借记
105：第三方贷记
否

BGNDAT
交易起始日期
D

否
日期间隔不能超过100天
ENDDAT
交易结束日期
D

否
MINAMT
最小金额
M

MAXAMT
最大金额
M

YURREF
业务参照号
C(30)

TRXSTS
交易状态
C(2)
附录 A.48

PYREAC
付款人账号
C(35)

PYEEAC
收款人账号
C(35)

CNVNBR
内部合同号
C(10)

应答报文阐明
交易名称
业务总揽查询
报文类型
响应报文
接口
字段ID
字段名称
类型
取值
可空
备注
INFO
FUNNAM
函数名
C(1，20)
NTQNPEBP
否

DATTYP
数据格式
N(1)
2：xml格式三
否

RETCOD
返回代码
N
附录A.2
否

ERRMSG
错误信息
Z(1,256)

可

NTQNPEBPZ
TRXNBR
NP交易流水号
C(11)

TRXDIR
交易方向
C(1)
I：提回
O：提出

MSGNBR
业务种类
C(3)
101：网银贷记
103：网银借记
105：第三方贷记
否

TRXDAT
交易日期
D

TRXSTS
交易状态
C(2)
附录 A.48

CCYNBR
交易货币
C(2)
附录 A.3

TRXAMT
交易金额
M

PYREAC
付款人账号
C(35)

PYRNAM
付款人名称
Z(100)

PYEEAC
收款人账号
C(3)

PYENAM
收款人名称
Z(100)

YURREF
业务参照号
C(30)

CNVNBR
内部合同号
C(10)

RSV30Z
保存字 30
C(30)

接口阐明
接口ID
接口名称
重复次数
备注
NTQNPEBPY
输入接口
1

NTQNPEBPZ
输出接口(多记录)
n
n为查询实际成果数

祈求报文范例

NTQNPEBP
2
OL03

404</QRYACC>
O
101
0330
0630

GK>
应答报文范例

2

NTQNPEBP
OL03
0

10

101>
7398
欧弟工行账号
404
欧弟专属测试户05
11.00
0530
O

01

10

101
8888
欧弟测试户口02
404
欧弟专属测试户05
10.00
0530
O

S>01

2 网银贷记
祈求报文阐明
交易名称
网银贷记
报文方向
祈求报文
接口
字段ID
字段名称
类型
取值
可空
备注
INFO
FUNNAM
函数名
C(1，20)
NTIBCOPR
否

DATTYP
数据格式
N(1)
2：xml格式三
否

LGNNAM
登陆顾客名
Z(1,20)

可
前置机模式必填
NTOPRMODX
BUSMOD
业务模式
C(5)

否

NTIBCOPRX
SQRNBR
流水号
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
字段名称
类型
取值
可空
备注
INFO
FUNNAM
函数名
C(1，20)
NTIBCOPR
否

DATTYP
数据格式
N(1)
2：xml格式三
否

RETCOD
返回代码
N
附录A.2
否

ERRMSG
错误信息
Z(1,256)

可

NTOPRRTNZ
SQRNBR
流水号
C(10)

REQNBR
流程实例号
C(10)

REQSTS
祈求状态
C(3)
附录A.5

OPRSQN
待解决操作序列
C(3)

OPRALS
操作别名
Z(32)

RTNFLG
业务解决成果
C(1)
附录 A.6

ERRCOD
错误代码
C(7)

系统返回错误代码
ERRTXT
错误文本
Z(92)

NTOPRDRTZ
RTNTIM
等待时间
N(3)

单位：秒
RSV50Z
保存字段 50
C(50)

接口阐明
接口ID
接口名称
重复次数
备注
NTOPRMODX
输入接口
1

NTIBCOPRX
输入接口(单记录)
1..30

NTOPRDRTZ
输出接口(单记录)
0..1

NTOPRRTNZ
输出接口(单记录)
1..30

祈求报文范例

NTIBCOPR
2
OL03

00001

CB
404
BR>

10
10
RCV0000002

林志玲
8888123

C208
0CAT>

应答报文范例

2

NTIBCOPR
OL03
0

TNZ>
SUC0000

BNK

3 签约管理
3.1 网银贷记合同订立经办
祈求报文阐明
交易名称
网银贷记合同订立经办
报文方向
祈求报文
接口
字段ID
字段名称
类型
取值
可空
备注
INFO
FUNNAM
函数名
C(1，20)
NTSGNCBC
否

DATTYP
数据格式
N(1)
2：xml格式三
否

LGNNAM
登陆顾客名
Z(1,20)

可
前置机模式必填
NTOPRMODX
BUSMOD
业务模式
C(5)

否

NTSGNCBCX
BBKNBR
银行号
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
字段名称
类型
取值
可空
备注
INFO
FUNNAM
函数名
C(1，20)
NTSGNCBC
否

DATTYP
数据格式
N(1)
2：xml格式三
否

RETCOD
返回代码
N
附录A.2
否

ERRMSG
错误信息
Z(1,256)

可

NTOPRRTNZ
REQNBR
流程号
C(10)

REQSTS
祈求状态
C(3)
附录A.5

OPRSQN
待解决操作序列
C(3)

OPRALS
操作别名
Z(32)

RTNFLG
业务解决成果
C(1)
附录 A.6

ERRCOD
错误