《上海银行影像工作流系统AppServer交易接口文档v1.0..docx》由会员分享，可在线阅读，更多相关《上海银行影像工作流系统AppServer交易接口文档v1.0..docx（34页珍藏版）》请在三一文库上搜索。
1、.AppServer交易接口文档;第 34 页 共 34 页AppServer交易接口文档上海银行申请影像工作流系统详细设计说明书交易接口设计V1.0.12004年8月5日上海华腾软件系统有限公司修订控制页章节编号章节名称修订内容简述修订日期修订前版本号拟稿人已评审初稿2004-8-5佟佰钢修改SV，增加AU、ST2004-8-11佟佰钢增加 查看权限、修改权限、删除权限、查看缺省权限、修改缺省权限、删除缺省权限的交易接口2004-8-12佟佰钢增加操作员签到下传报文中的相关字段2004-8-13佟佰钢增加报文头2004-8-16佟佰钢增加查看操作员接口增加修改操作员接口增加删除操作员接口20
2、04-8-18佟佰钢增加动态执行SQL接口2004-8-20佟佰钢增加操作员签退交易、代签退交易接口2004-8-30佟佰钢修改动态执行SQL接口2004-8-30佟佰钢增加错误码定义2004-9-3佟佰钢增加错误码60092004-9-7佟佰钢修改签到交易下传报文2004-9-7佟佰钢修改9997交易，根据字段标志决定是否取字段名2004-9-15佟佰钢目 录1.公共报文头61.1.上传报文头61.2.下传报文头61.3.错误码定义71.3.1.数据库操作错误信息71.3.2.操作员错误信息71.3.3.机构错误信息71.3.4.客户端升级错误信息71.3.5.操作权限错误信息81.3.6.
3、动态SQL错误信息81.3.7.文件和日志错误信息82.系统访问控制(SV_U)92.1.操作员签到92.1.1.交易码92.1.2.上传报文92.1.3.下传报文92.1.4.返回结果102.2.操作员签退112.2.1.交易码112.2.2.上传报文112.2.3.下传报文112.2.4.返回结果112.3.获取客户端升级包122.3.1.交易码122.3.2.上传报文122.3.3.下传报文122.3.4.返回结果122.4.修改密码132.4.1.交易码132.4.2.上传报文132.4.3.下传报文132.4.4.返回结果132.5.操作员代签退142.5.1.交易码142.5.2.
4、上传报文142.5.3.下传报文142.5.4.返回结果142.6.主管置操作员签到状态152.6.1.交易码152.6.2.上传报文152.6.3.下传报文152.6.4.返回结果153.操作员管理(ST_U)163.1.增加操作员163.1.1.交易码163.1.2.上传报文163.1.3.下传报文173.1.4.返回结果173.2.查看操作员183.2.1.交易码183.2.2.上传报文183.2.3.下传报文183.2.4.返回结果193.3.修改操作员203.3.1.交易码203.3.2.上传报文203.3.3.下传报文213.3.4.返回结果213.4.删除操作员223.4.1.交
5、易码223.4.2.上传报文223.4.3.下传报文223.4.4.返回结果224.权限管理(AU_U)234.1.增加权限234.1.1.交易码234.1.2.上传报文234.1.3.下传报文234.1.4.返回结果234.2.增加缺省权限244.2.1.交易码244.2.2.上传报文244.2.3.下传报文244.2.4.返回结果244.3.查看权限254.3.1.交易码254.3.2.上传报文254.3.3.下传报文254.3.4.返回结果254.4.修改权限264.4.1.交易码264.4.2.上传报文264.4.3.下传报文264.4.4.返回结果264.5.删除权限274.5.1.
6、交易码274.5.2.上传报文274.5.3.下传报文274.5.4.返回结果274.6.查看缺省权限284.6.1.交易码284.6.2.上传报文284.6.3.下传报文284.6.4.返回结果284.7.修改缺省权限294.7.1.交易码294.7.2.上传报文294.7.3.下传报文294.7.4.返回结果294.8.删除缺省权限304.8.1.交易码304.8.2.上传报文304.8.3.下传报文304.8.4.返回结果305.执行动态SQL（SQL_U）315.1.直接执行（update/insert/delete语句）315.1.1.交易码315.1.2.上传报文315.1.3.下
7、传报文315.1.4.返回结果315.2.查询语句(SELECT语句返回多条记录)325.2.1.交易码325.2.2.上传报文325.2.3.下传报文325.2.4.返回结果325.3.查询语句(SELECT语句返回单条记录)345.3.1.交易码345.3.2.上传报文345.3.3.下传报文345.3.4.返回结果341. 公共报文头1.1. 上传报文头字段名称长度取值 HTRMSEQ 取消终端号200 HEJFNO 取消日志序号7取消时原始交易流水号 OPNBR 开户行3本行行号 KINBR 交易行3本行行号 TRMSEQ 终端号2 EJFNO 日志序号7 TASKID 程序类别2UY
8、 TMTYPE 终端类型10 TXNO 交易代码4 HCODE 取消标志1正常时为0，取消时为1 SUPINIT 主管标志200 TLRNO 操作员号6 SPTLRNO 授权主管号6 OTXTLRNO 验证交易柜员号6 OTXTLSRNO 验证交易流水号7 PASSWD 操作员密码8 NBCD 无折交易标志10 MULTTX 连续组合交易标志10 MULTNO 连续组合交易代码60000001.2. 下传报文头字段中文名称长度说明 KINBR 交易行3本行行号 TRMSEQ 终端号2 EJFNO 日志序号7 TASKID 程序类别2UY TMTYPE 终端类型10 TXDATE 交易日期8 T
9、XTIME 交易时间9 MSGEND 报文结束标志11无后续报文 MSGTYPE 报文类型1Y成功返回其他交易失败 MSGNO 报文编号4成功交易编号失败错误代码 MSGLNG 报文长度4不足前补0 包括报文头42个字节1.3. 错误码定义1.3.1. 数据库操作错误信息错误码错误说明宏定义备注5999无记录E_DB_OPERATOR_NOT_FOUND6000数据库操作错误E_DB_OPERATOR_ERR1.3.2. 操作员错误信息错误码错误说明宏定义备注6001操作员不存在E_COM_OPER_NOT_EXIST6002操作员被冻结E_COM_OPER_IS_FROZEN6003操作员没
10、有被激活E_COM_OPER_IS_NOT_ACTIVE6004操作员已过有效期E_COM_OPER_IS_EXPIRED6005操作员密码错误E_COM_OPER_PASSWD_ERR6006操作员已存在E_COM_OPER_EXIST6007操作员已登陆E_COM_OPER_HAS_LOGIN6008不能处理非机构构操作员E_COM_OPER_BRANCH_ERR6009操作员被锁定E_COM_OPER_IS_LOCKED1.3.3. 机构错误信息错误码错误说明宏定义备注6020机构信息不存在E_COM_ORG_NOT_EXIST1.3.4. 客户端升级错误信息错误码错误说明宏定义备注60
11、30产生升级文件错误E_COM_GEN_FILE_ERR6031需要升级客户端E_COM_CLIENT_UPDDEL6032需要升级参数表E_COM_PARAM_UPDDEL1.3.5. 操作权限错误信息错误码错误说明宏定义备注6040权限冲突E_COM_AUTH_CONFLICT6041没有操作权限E_COM_AUTH_NO_OPER_AUTH6042权限编号不存在E_COM_AUTHID_NOT_EXIST6043岗位编号不存在E_COM_DFL_AUTHID_NOT_EXIST6044无跨分行处理权限E_COM_AUTH_BRANCH6045获取权限编号错误E_COM_GET_AUTHI
12、D_ERR1.3.6. 动态SQL错误信息错误码错误说明宏定义备注6070数据超长E_COM_DATA_TOO_LONG6071字段超长E_COM_COL_TOO_LONG6072参数个数错误E_COM_PARAMNUM_ERR6073参数配置错误E_COM_PARAM_CFG_ERR1.3.7. 文件和日志错误信息错误码错误说明宏定义备注7000写日志错误E_COM_WRITE_LOG_ERR7010文件不存在E_COM_FILE_NOT_EXIST7011打开文件错误E_COM_OPEN_FILE_ERR2. 系统访问控制(SV_U)2.1. 操作员签到2.1.1. 交易码00112.1.
13、2. 上传报文项目数据类型空值备注Client程序版本号char(10)N参数表名称Char(900)N每个参数表30字节参数表版本号char(300)N目前支持30个参数表2.1.3. 下传报文项目数据类型空值备注程序升级标志charN1需要升级 0不需升级参数升级标志charN1需要升级 0不需升级Client程序版本号char(10)NServer的最新版本号程序升级文件名char(23)Y当程序需要升级时可用操作员权限char(80)N操作员权限的序列操作员可分配的权限char(200)N操作员可分配权限的序列操作员的机构号char(3)N操作员所属分行号char(6)N连续失败次数c
14、har(2)当天失败次数char(2)最后一次访问时间char(14)最后一次成功登陆时间char(14)最后一次失败登陆时间char(14)可以处理申请的信用额度的起始金额char(15)可以处理申请的信用额度的终止金额char(15)每天能处理的申请的最小笔数char(5)每天能处理的申请的最大笔数char(5)卡种的编号列表char(200)2.1.4. 返回结果交易成功操作员不存在操作员被冻结操作员没有激活操作员密码错误操作员已过期操作员被锁定数据库操作错机构信息不存在产生升级文件错误2.2. 操作员签退2.2.1. 交易码 00122.2.2. 上传报文 项目数据类型空值备注2.2.
15、3. 下传报文项目数据类型空值备注2.2.4. 返回结果交易成功2.3. 获取客户端升级包2.3.1. 交易码 00132.3.2. 上传报文 项目数据类型空值备注2.3.3. 下传报文项目数据类型空值备注2.3.4. 返回结果 交易成功2.4. 修改密码2.4.1. 交易码 00142.4.2. 上传报文项目数据类型空值备注新密码char(8)N2.4.3. 下传报文项目数据类型空值备注2.4.4. 返回结果交易成功数据库操作错误2.5. 操作员代签退2.5.1. 交易码00152.5.2. 上传报文项目数据类型空值备注操作员编号char(6)N代签退的操作员密码char(8)N2.5.3.
16、 下传报文项目数据类型空值备注2.5.4. 返回结果交易成功操作员不存在数据库操作错误操作员密码错误不能代签退非本分行的操作员2.6. 主管置操作员签到状态2.6.1. 交易码 00162.6.2. 上传报文 项目数据类型空值备注操作员编号char(6)N代签退的操作员必须同一分行2.6.3. 下传报文项目数据类型空值备注2.6.4. 返回结果交易成功操作员不存在数据库操作错误不能代签退非本分行的操作员没有操作权限3. 操作员管理(ST_U)3.1. 增加操作员3.1.1. 交易码 00213.1.2. 上传报文项目数据类型空值备注操作员编号char(6)N要增加的操作员编号分行号char(6
17、)N操作员所属分行操作员姓名char(20)操作员职位char(40)操作员的级别char操作员的联系电话char(20)操作员有效期起始日期char(8)操作员有效期结束日期char(8)操作员密码char(8)操作员权限char(80)N操作员权限的序列操作员可分配的权限char(200)N操作员可分配权限的序列可以处理申请的信用额度的起始金额char(15)可以处理申请的信用额度的终止金额char(15)每天能处理的申请的最小笔数char(5)每天能处理的申请的最大笔数char(5)能否处理所有的卡种charY-可以 N-不可以处理卡种标志charI： 只能处理以下这些卡种E： 除了以下
18、的卡种都能处理卡种的编号列表char(200)3.1.3. 下传报文项目数据类型空值备注3.1.4. 返回结果交易成功该操作员已经存在无操作权限数据库操作错误3.2. 查看操作员3.2.1. 交易码00223.2.2. 上传报文项目数据类型空值备注操作员编号char(6)N要查看的操作员编号3.2.3. 下传报文项目数据类型空值备注操作员编号char(6)N要查看的操作员编号机构号char(3)N分行号char(6)N操作员所属分行上次维护操作员char(6)N上次维护日期char(14)N操作员的状态charN操作员姓名char(20)N操作员职位char(40)N添加该用户的主管IDcha
19、r(6)N操作员的级别charN操作员的联系电话char(20)操作员有效期起始日期char(8)操作员有效期结束日期char(8)连续失败次数char(2)当天累计失败次数char(2)最后一次访问时间char(14)最后一次成功登录时间char(14)最后一次修改密码时间char(14)最后一次失败登录时间char(14)操作员权限char(80)N操作员权限的序列操作员可分配的权限char(200)N操作员可分配权限的序列可以处理申请的信用额度的起始金额char(15)可以处理申请的信用额度的终止金额char(15)每天能处理的申请的最小笔数char(5)每天能处理的申请的最大笔数cha
20、r(5)能否处理所有的卡种charY-可以 N-不可以处理卡种标志charI： 只能处理以下这些卡种E： 除了以下的卡种都能处理卡种的编号列表char(200)3.2.4. 返回结果交易成功无此柜员数据库操作错误3.3. 修改操作员3.3.1. 交易码 00233.3.2. 上传报文项目数据类型空值备注操作员编号char(6)N要修改的操作员编号分行号char(6)N操作员所属分行上次维护操作员char(6)N上次维护日期char(14)N操作员的状态charN操作员姓名char(20)N操作员职位char(40)N操作员的级别charN操作员的联系电话char(20)操作员有效期起始日期ch
21、ar(8)操作员有效期结束日期char(8)操作员权限char(80)N操作员权限的序列操作员可分配的权限char(200)N操作员可分配权限的序列可以处理申请的信用额度的起始金额char(15)可以处理申请的信用额度的终止金额char(15)每天能处理的申请的最小笔数char(5)每天能处理的申请的最大笔数char(5)能否处理所有的卡种charY-可以 N-不可以处理卡种标志charI： 只能处理以下这些卡种E： 除了以下的卡种都能处理卡种的编号列表char(200)3.3.3. 下传报文项目数据类型空值备注3.3.4. 返回结果交易成功无此柜员数据库操作失败无操作权限3.4. 删除操作员
22、3.4.1. 交易码 00243.4.2. 上传报文项目数据类型空值备注操作员编号char(6)N要删除的操作员编号3.4.3. 下传报文项目数据类型空值备注3.4.4. 返回结果交易成功无此柜员数据库操作失败无操作权限4. 权限管理(AU_U)4.1. 增加权限4.1.1. 交易码00314.1.2. 上传报文项目数据类型空值备注权限编号char(2)N权限描述char(40)N不足右补空格权限冲突标志char(2)N不足左补“0”4.1.3. 下传报文项目数据类型空值备注4.1.4. 返回结果交易成功无操作权限数据操作失败权限冲突4.2. 增加缺省权限4.2.1. 交易码00324.2.2
23、. 上传报文项目数据类型空值备注岗位编号char(3)N缺省权限描述char(40)N不足右补空格缺省权限的序列char(80)N不足右补空格4.2.3. 下传报文项目数据类型空值备注4.2.4. 返回结果交易成功无操作权限数据操作失败权限冲突4.3. 查看权限4.3.1. 交易码 00334.3.2. 上传报文 项目数据类型空值备注权限编号char(2)N4.3.3. 下传报文项目数据类型空值备注权限编号char(2)N权限描述char(40)N不足右补空格权限冲突标志char(2)N不足左补“0”最后操作柜员char(6)N不足右补空格最后操作时间char(14)NYYYYMMDDHHMM
24、SS权限状态char(1)N4.3.4. 返回结果交易成功无操作权限数据操作失败权限不存在4.4. 修改权限4.4.1. 交易码 00344.4.2. 上传报文项目数据类型空值备注权限编号char(2)N权限描述char(40)N不足右补空格权限冲突标志char(2)N不足左补“0”4.4.3. 下传报文项目数据类型空值备注4.4.4. 返回结果交易成功无操作权限权限不存在数据操作失败权限冲突4.5. 删除权限4.5.1. 交易码00354.5.2. 上传报文 项目数据类型空值备注权限编号char(2)N4.5.3. 下传报文 项目数据类型空值备注4.5.4. 返回结果交易成功无操作权限权限不
25、存在数据操作失败4.6. 查看缺省权限4.6.1. 交易码 00364.6.2. 上传报文项目数据类型空值备注岗位编号char(3)N4.6.3. 下传报文项目数据类型空值备注岗位编号char(3)N缺省权限描述char(40)N不足右补空格缺省权限的序列char(80)N不足右补空格最后操作柜员char(6)N不足右补空格最后操作时间char(14)NYYYYMMDDHHMMSS权限状态char(1)N4.6.4. 返回结果交易成功无操作权限数据操作失败岗位编号不存在4.7. 修改缺省权限4.7.1. 交易码 00374.7.2. 上传报文项目数据类型空值备注岗位编号char(3)N缺省权限
26、描述char(40)N不足右补空格缺省权限的序列char(80)N不足右补空格4.7.3. 下传报文项目数据类型空值备注4.7.4. 返回结果交易成功无操作权限岗位不存在数据操作失败权限冲突4.8. 删除缺省权限4.8.1. 交易码 00384.8.2. 上传报文项目数据类型空值备注岗位编号char(3)N4.8.3. 下传报文项目数据类型空值备注4.8.4. 返回结果交易成功无操作权限岗位不存在数据操作失败5. 执行动态SQL（SQL_U）5.1. 直接执行（update/insert/delete语句）5.1.1. 交易码99995.1.2. 上传报文项目数据类型空值备注文件编号char(
27、4)N配置文件的编号参数个数char(2)N不足前补0参数列表char(4096)N用分隔符分隔每个参数最长不超过400字节，不能超过99个参数5.1.3. 下传报文项目数据类型空值备注执行记录条数char(4)N5.1.4. 返回结果交易成功参数非法配置文件不存在，不能执行5.2. 查询语句(SELECT语句返回多条记录)5.2.1. 交易码99985.2.2. 上传报文项目数据类型空值备注文件编号char(4)N配置文件的编号执行次序charN第一次交易传送上来为0，以后为1参数个数char(2)N不足前补0参数列表char(4096)N用分隔符分隔每个参数最长不超过400字节，不能超过9
28、9个参数5.2.3. 下传报文项目数据类型空值备注记录数char(4)N最大不超过记录列char(4096)N第一次交易：4个字节字段长度+字段列表（分隔符分隔）4个字节数据长度数据列表（分隔符分隔）以后交易：4个字节数据长度数据列表（分隔符分隔）5.2.4. 返回结果交易成功打开文件失败读取文件失败数据库操作失败文件配置错误数据太长数据列太长5.3. 查询语句(SELECT语句返回单条记录)5.3.1. 交易码99975.3.2. 上传报文项目数据类型空值备注文件编号char(4)N配置文件的编号字段标志charN1-取字段名称0-不取字段名称参数个数char(2)N不足前补0参数列表char(4096)N用分隔符分隔每个参数最长不超过400字节，不能超过99个参数5.3.3. 下传报文项目数据类型空值备注受影响记录数char(4)N返回结果char(2000)N4个字节字段长度+字段列表（分隔符分隔）4个字节数据长度数据列表（分隔符分隔）5.3.4. 返回结果交易成功返回数据超长读取文件失败数据库操作失败文件配置错误数据太长数据列太长