农行专线ERP接口三期开发手册0730.docx

1、农行专线ERP接口三期开发手册0730企业银行平台ERP接口（三期）开发手册中国农业银行 软件开发中心文档管理信息编号 PP/CME/项目 企业银行平台类别 企业银行/项目文档密级 内部路径 企业银行/ERP文档修订记录日 期版本描 述 信 息作 者2009-5-8初稿。整理一、二期仍继续沿用的交易接口张峰2009-5-26增加2281，删除1908中代理支付相关节点张峰2009-6-4增加C400交易，详细通知（010）张峰2009-6-26增加C317、2210、2212、2221、C320、C321、2225、2234张峰2009-7-16增加25J7、25M9、25J9、25JA、25

2、JB、25JC、25JX、2265张峰2009-7-30增加25MD张峰1前言1.1编写目的本文档描述了农行企业银行的处理机制，定义了面向外部系统的接口，供企业财务系统ERP开发接口程序参考。1.2关于现金管理三期和二期的说明【1】接口向下兼容。三期系统对于部分常用的二期交易仍继续支持。但要注意部分功能在三期中以新的接口（或交易码）进行封装，建议ERP软件商逐步淘汰掉相同功能的老的交易接口。1.3关于银行系统和ERP互连的简要备注（比较重要）1.4约定1.4.1关于通讯方式：ERP与CS之间：Socket方式中报文结构为“包头+数据包”。包头固定为7个字节长，第1字节为是否加密标志（0-不加密

3、，1-加密）。后6个字节是数据包的长度，即将报文长度直接转为字符串存储，长度不足6位则右边用空格补足，比如：“1234 ”。比如汇兑的长度为1234字节的数据包，其包头为“11234 ”共7位；查询单账户余额的长度为1000字节的数据包，其包头为“01000 ”共7位。其中数据包长度包含加密包标志位。1.4.2关于XML约定：XML（包括XML数据包和XML文件）都不包含头部的XML声明（即）；除非有特别的说明，否则所有XML的根元素的标记名都为；接口中字段名即对应元素的标记名(包含了相对于根的路径名)；在XML数据包中所有元素的数据都不采用属性，而一律用字符数据的文本块来表示。1.4.3关于

4、字段次序:对于XML，同一层的字段次序可以不参照本文档中的字段次序描述；对于多域串（即以|作为每个字段结束符的字符串，以下简称MFS）或格式化字符串，字段次序必须严格与本文档中的字段次序描述保持一致。1.4.4关于字段类型：字段类型分为以下三类：Cn：字段允许为任何可见字符（包括数字和中文），n在XML中表示有效数据的最大总长度，如果有效数据长度不足n位按实际位数；在格式化字符串（定长字符串）中表示固定的长度，如果有效数据长度不足n位，则有效数据左对齐，右边用空格补足至n位；Nn：字段内容只允许为0-9数字，n在XML中表示有效数据的最大总长度，如果有效数据长度不足n位按实际位数；在格式化字符

5、串中表示固定的长度，如果有效数据长度不足n位，则有效数据右对齐，左边用空格补足至n位；：基本上与Nm类型类似，但字段内容可以允许为负号、0-9数字和小数点，其中m表示有效数据的最大总长度（对于格式化字符串中表示固定长度），n表示小数位数，通常用来表示发生额、余额等金额类字段，如表示15位，其中带两位小数位的字段。1.4.5关于空字段：表示字段在某些条件下允许为空字段，空字段在XML中对应的字段值为空，在格式化字符串中则用全空格填充至规定的长度。1.4.6关于多域串：多域串用于企业银行内部各子系统之间返回多条记录，简写为MFS，多域串采用固定分隔符，对于本系统而言，分隔符一般采用“|”，如果多域

6、串内的字段值还是多域串（如通知查询交易），则字段值的多域串分隔符一般采用“/”，除非特殊说明。本文档中对于多域串的情况给出了当前情况下字段排列顺序，实际上本接口文档中设计上相对灵活，由于第一条记录是字段名记录，如果采用灵活实现方式，则根据该字段名记录可以确定排列顺序，因而不必事先约定顺序。1.4.7关于定位串：定位串用于返回多条记录的交易中，定位串的组成格式由服务方决定，定位串缩写为FFS。客户端在第一次请求时将定位串置成空，服务端在应答时对每条返回的记录填写定位串。定位串必须给定字段排列顺序，本文档中设计定位串的地方主要都是与CMF通讯的接口里面，下面每个交易都是通过交易表中起始字段和终止字

7、段来表述的，在这两个字段之间顺序排列即可。1.4.8关于文件：由于部分交易中涉及的交易包过大，如果采用交易包返回，将造成较多的冗余，所以采用文件方式返回。文件的格式和交易包中的格式定义基本相同，唯一的区别可能就是将一条条记录拆成了文件的一条记录而已。文件的上传、下载可以通过调用我们提供的通讯底层来获取。1.4.9关于操作员密码：企业操作员的密码都为最长8位的字母或数字。在传输过程中单独加密，加密后为16字节的可见字符串。1.4.10关于认证码、数字签名和加密：企业操作员在签到时，ES会根据某种算法得出一个认证码，以后每次该操作员作交易时都要求送认证码供ES校验。认证码为32字节的可见字符串。数

8、字签名是为了防抵赖和防篡改的要求，具体哪些交易需要签名、哪些签名字段和签名顺序如何是通过ES的交易控制配置文件来确定。CC-CS需要通讯加密。哪些交易需要加密也是通过ES的交易控制配置文件来确定。1.4.11关于返回结果：一笔交易的结果的返回用返回来源+返回码来标示，返回信息为返回码的具体中文含义，扩展信息中包含了详细的信息。由于成功的返回结果有多种可能（如交易成功0000，交易落地0001，预约受理0002，等），约定这种情况下返回来源都为0。1.4.12关于查询类的返回接口：查询类交易分多笔查询和单笔查询，其中单笔查询包括：查询单帐户余额、下级查询上存支取余额等交易；多笔查询包括：查询帐户

9、明细等。单笔查询交易：应答报文不通过RespPrvData来返回，而是直接填写XML域。多笔查询交易：多笔查询交易无论笔数是1还是多条，都需要首先判断是否通过文件返回，如果不是通过文件，则肯定是通过RespPrvData来返回的多笔记录。判断是文件返回还是记录返回请检查XML节点和记录数（行数）通过Cme/RecordNum得到(值为N)，字段数（列数）通过Cme/FieldNum得到(值为M)。其中RespPrvData的构成方式如下：字段1名|字段2名|字段M名|第一条记录字段1值|第一条记录字段2值|第一条记录字段M值|第N条记录字段1值|第N条记录字段2值|第N条记录字段n值|如果是通

10、过文件方式，则文件的记录格式也是采用多域串，但是有所差异，就是将每条记录分开成文件的每条记录，格式如下：字段1名|字段2名|字段M名|第一条记录字段1值|第一条记录字段2值|第一条记录字段M值|第N条记录字段1值|第N条记录字段2值|第N条记录字段n值|1.4.13通讯区大小约定由于企业银行CS与ERP肯定在局域网内部，因此约定ERP与企业银行系统之间的通讯区大小为100K，请求数据包不可能大于100K，而应答数据包如果超过100K，则通过文件返回。是否通过文件返回，在公共包头中有“是否文件返回的标识”，如果采用文件返回，则公共包头中可以通过“批量文件名”字段获得返回的文件名；如果采用非文件方

11、式返回，则按照1.4.12的约定获取RespPrvData字段。2数据字典定义数据字典是本系统的业务基础，基本涵盖了所有的字段及其属性信息。数据字典的用途可以非常广泛，目前数据字典的功用还有待开发。2.1字典键值索引（0）1 返回来源2 农行他行标志3 同城异地标志4 汇兑类型5 反向归集标志6 利息再分配周期7 利息再可配标志8 法人间资金归集标志9 资金归集方向10 资金归集周期11 资金归集类型12 业务类型13 申请/恢复额度标志14 生效标志15 额度转移标志16 可使用上级额度标志17 票据状态18 电子对账单输出标志19 账页输出标志20 现转标志21 发生额标志22 交易类别2

12、3 授信种类24 票据种类25 凭证种类26 摘要27 帐户操作权限28 帐户类型29 加急标志30 到账通知标志31 联系方式32 消息（通知）类型33 消息发送标志34 归集帐户35 流水状态36 企业状态37 证件类型38 利率标志39 使用状态40 省市代码41 货币码42 交易代码43 企业操作员类别44 企业操作员状态45 收妥标志46 汇票种类47 本票种类48 查询类型49 预约标志50 落地处理标志51 修改内容53 对账标志54 可否转汇标志55 挂失方式56 领取方式59 操作员联机状态60 授权帐户状态61 自身归集状态62 上级归集状态63 收费基数类型64 支票种类

13、65 通知处理状态66 资金归集关系修改类型2.2返回来源（1）0 成功返回1 CMECC返回2 CMECS返回3 CMES返回4 CMF返回5 ABIS返回6 CM返回7 CMC返回2.3农行他行标志（2）0 农行1 他行2.4同城异地标志（3）0 异地1 同城2.5汇兑类型（4）0 普通汇兑1 上级发起的下级账户之间的划款2 上级发起的下级账户的对外支付2.6反向归集标志（5）0 不做1 做2.7利息再分配周期（6）1 每月月底2 每月20日3 每季季底4 每季20日2.8利息再分配标志（7）0 不自动分配1 自动分配2.9法人间资金归集标志（8）0 非法人间资金归集1 法人间资金归集2.

14、10资金归集方向（9）1 只能向上归集2 可从上级账户划拨资金给下级账户2.11资金归集周期（10）1 每天2 每月2.12资金归集类型（11）1 实时归集2 批量归集3 资金池管理4 巴斯夫归集方式处理2.13业务类型（12）1 资金上存2 资金支取3 资金下拨4 资金上划2.14申请/恢复额度标志（13）0 申请1 恢复2 转入3 转出2.15生效标志（14）0 未生效1 已生效2.16额度转移标志（15）0 不可转移1 可转移；2.17可使用上级额度标志（16）0 只能使用自身额度1 可使用上级额度；2.18票据状态（17）0 全部1 从付款人收回2 退票后从受让企业收回3 退票后转逾期

15、贷款收回、4 部分收回5 退票2.19电子对账单输出标志（18）0 未输出1 已输出2.20账页输出标志（19）0 未输出1 已输出2.21现转标志（20）0 现金1 转账2.22发生额标志（21）0 正常1 红字2 蓝字3 已抹4 抹帐2.23交易类别（22）0 自身1 资金归集2 结息3 收费4 资金池划拨户结息或清息5 平等资金池委托贷款6 如果是隔夜透支不用申请额度7 资金归集（不记账簿自身）8 有权机关强制扣划 2.24授信种类（23）2502-透支额度2.25票据种类（24）00 全部01 银行汇票02 银行承兑汇票03 转账支票2.26凭证种类（25）00 非重要空白凭证01 储

16、蓄存单02 一般储蓄存单03 存本取息存需存单04 定期存款一本通折05 单位定期存款证实书06 现金支票07 转账支票08 普通支票09 全国银行汇票10 省辖或县辖银行汇票11 银行承兑汇票12 商业承兑汇票13 不定额银行本票14 金穗卡卡片15 智能卡16 借记卡17 贷款还款证实书18 县辖邮划借方报单19 县辖邮划贷方报单20 国库券收款凭证22 汇票委托书23 外币普通支票24 单位定期存单31 金卡32 银卡33 收贷凭证34 电子同城补充报单36 清分机支票37 金融服务收入凭证38 特种大额定期存单50 外汇出境许可证60 一卡通开销户登记簿61 一卡通对账登记簿63 定期

17、一本通存折64 活期一本通存折78 清分机转账支票80 人行现金支票81 人行转账支票84 人行假币没收收据98 电子支付凭证99 所有重要空白凭证2.27摘要（包括原ABIS和新ABIS）（26）1 01-现收2 02-现支3 03-转收4 04-转支5 05-汇入6 06-汇出7 07-托收8 08-承付9 09-委收10 10-委付11 11-补账12 12-冲账13 13-收息14 14-付息15 15-汇票16 16-转账17 17-提入18 18-提出19 19-退款20 20-电汇21 99-其他22 0101-商品销售收入23 0102-服务业收入24 0103-税款收入25

18、0108-城乡个体经营收入26 0109-储蓄存款收入27 0110-其他金融机构收入28 0111-居民归还贷款收入29 0112-汇兑收入30 0113-有价证券收入31 0199-其他收入32 0115-兑换外币收入33 0190-收入合计34 0116-内部现金收入35 0117-同业往来收入36 0118-由人行发行库领取现金37 0119-由银行（人行）业务库领取现金38 0120-信用社（其他银行）交存现金39 0130-前期业务库存40 0191-收入总计41 0260-工资性支出42 0201-国家工资及奖金43 0202-国家对个人其他支出44 0203-部队存款支出45

19、0204-其他单位工资性支出46 0205-农副产品采购支出47 0206-工矿及其他产品采购支出48 0207-行政企事业管理费支出49 0208-城乡个体经营支出50 0209-储蓄存款支出51 0210-其他金融机构支出52 0211-居民提取贷款支出53 0212-汇兑支出54 0213-有价证券支出55 0299-其他支出56 0215-兑换外币支出57 0290-支出合计58 0216-内部现金支出59 0217-同业往来支出60 0218-交回人行发行库现金61 0219-交回银行（人行）业务库现金62 0220-信用社（其他银行）支出现金63 0230-本期业务库存64 029

20、1-支出总计65 0240-投放（+）、回笼（-）66 0250-附报项目：代发工资67 1003-转收68 1004-转支69 1005-汇入70 1006-汇出71 1007-托收72 1008-承付73 1009-委收74 1010-委付75 1011-补账76 1012-冲账77 1013-收息78 1014-付息79 1015-汇票80 1016-转账81 1017-提入82 1018-提出83 1019-退款84 1020-电汇85 1021-票据买入86 1022-收回买入票据垫款87 1023-资金上存88 1024-资金支取89 1025-资金上划90 1026-资金下拨91

21、 1027-签发银行汇票92 1028-签发银行本票93 1029-签发大额支付报单94 1099-其他2.28账户操作权限（27）0 不能操作1 查询2 集团内划款3 对外支付8 全权操作9 自身账户2.29账户类型（28）0 基本存款账户1 单位辅助2 专用存款账户3 一般存款账户4 个人支票户5 可透支户6 临时存款账户7 注册验资临时存款户8 保证金户2.30加急标志（29）0 不加急 1 加急2.31到账通知标志（30）0 不通知1 通知付款人2 通知收款人3 全部通知2.32联系方式（31）1-电子邮件2-传真3-电话4-短信5-联网6-其他2.33通知类型（32）000 所有通知

22、001 到账通知002 批量交易完成003 抹帐通知004 更新通知00A 信使服务2.34消息发送标志（33）1-未发送2-已发送2.35是否归集帐户（34）0非归集户1归集户2.36流水状态(35)1 待复核2 待发送3 正在发送4 成功5 失败6 落地7 预约9 未知2.37证件类型(37)I 个人身份证P 执照L 营业执照T 临时证件O 无证件开户J 联名开户S 军官证1 驾驶证2 警官证3 文职干部证4 户口簿2.38利率标志(38)0 日利率1 月利率2 年利率2.39使用状态(39)0 使用1 不使用2.40省市代码（40）01 总行11 北京市02 天津市03 上海市04 山西

23、省05 内蒙古06 辽宁省07 吉林省08 黑龙江09 上海市10 江苏省12 安徽省13 福建省14 江西省15 山东省16 河南省17 湖北省18 湖南省19 浙江省20 广西区21 海南省22 四川省23 贵州省24 云南省25 西藏区26 陕西省27 甘肃省28 青海省29 宁夏区30 新疆区31 重庆市34 大连市38 青岛市39 宁波市40 厦门市41 深圳市44 广东省45 新兵团50 河北省71 台湾省97 香港99 总行清算中心80 会计部81 营业部82 计划部83 国际部2.41货币码（包括农行和国标）（41）01 RMB 人民币12 GBP 英镑13 HKD 港币14

24、USD 美元15 CHF 瑞士法郎16 DEM 德国马克17 FRF 法国法郎18 SGD 新加坡元19 BEF 比利时法郎20 NLG 荷兰盾21 SEK 瑞典克郎22 DKK 丹麦克郎23 NOK 挪威克郎24 ATS 奥地利先令26 ITL 意大利里拉27 JPY 日元28 CAD 加元29 AUD 澳元30 TZS 坦桑尼亚先令31 ESP 西班牙比塞塔32 MYR 马来西亚林吉特33 XEL 欧洲货币单位40 LKR 斯里兰卡卢比41 DZD 阿尔及利亚第纳尔42 FIM 芬兰马克43 GHC 加纳塞地44 IQD 伊拉克地那尔45 MLF 马里法郎46 MAD 摩洛哥地拉姆47 S

25、LL 塞拉利昂48 IRR 伊朗里亚尔49 NPR 尼泊尔卢比61 ALL 阿尔巴尼亚列克62 ROL 罗马尼亚列依63 KPW 朝鲜币64 VND 越南盾65 UUP 匈牙利福林66 BGL 保加利亚列瓦67 CSK 捷克克郎69 PLZ 波兰兹罗提70 BUR 苏联卢布73 FUG 蒙古图格里克80 ZMR 赞比亚克瓦查81 MOP 澳门币82 PHP 菲律宾比索83 BUK 缅甸币84 THB 泰币85 INR印度罗比86 MTP马尔他镑87 NZD新西兰元2.42交易代码（42）C000开通企业银行功能C003查询数据字典C004增加数据字典C005删除数据字典C006修改数据字典C1

26、00企业操作员签到C101企业操作员签退C102查询企业操作员C103增加企业操作员C104修改企业操作员C108修改企业操作员密码C109查询操作员可操作账户C110设置操作员可操作账户C111查询企业操作员权限C112设置企业操作员权限C113 查询企业被授权账户C114 企业操作员设置自身菜单C200查询集团关系C201查询企业信息C202查询账户信息C203查询贸易伙伴C204增加贸易伙伴C205修改贸易伙伴C206删除贸易伙伴C207查询所有账户组C208查询账户组中的账户C209设置账户组中的账户C211删除账户组C212查询员工信息C213增加员工信息C214修改员工信息C215

27、删除员工信息C300查询交易日志流水C301查询金融交易流水C302复核金融交易C303查询收费明细C304查询企业通知(CC发起)C305查询复核流水操作员C306增加复核功能级别C307查询复核功能级别C308查询需要复核的交易流水C309修改复核功能级别C310删除复核功能级别C400发送企业通知(ES或CS发起)C402下载对账单C403打印对账结果C404 更新工资信息C500 查询提交C501 多账户明细查询C502 查询汇总帐户余额M000银行操作员登陆校验M001查询银行操作员M002 银行操作员维护M003查询数据字典M004数据字典维护M005系统日终M006错误代码维护M

28、006解冻银行操作员M007修改银行操作员密码M008查询银行操作员权限M009修改银行操作员权限0324购买电子支付凭证0325支票挂失0394利率查询0395外汇汇率查询1908汇兑1909代发工资1913申购支票1944 查询金融交易流水状态1943 取消金融交易2531查询客户使用授信情况2532查询客户授信额度使用明细2533查询客户转移/恢复额度明细2551修改上存利率、下拨利率、留存最低限额、划拨最高限额2553查询资金归集关系2556资金上存2557资金支取2558资金下拨2559资金上划2560下级查询上存资金余额2561上级查询汇总上存余额2562查询上存支取明细2563下级查询下拨资金余额2564上级查询汇总下拨余额2565查询下拨上划明细2575查询票据买入余