1、 Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明中国工商银行银企互联系统接口说明Version 4.2中国工商银行电子银行部中国工商银行北京软件研发部2005 年 07 月Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明目 录1 帐户查询 11.1 单帐户余额查询 1提交包 1返回包 11.2 多帐户余额查询 2提交包 2返回包 31.3 当日明细查询 4提交包 4返回包 51.4 历史明细查询 6提交包 6返回包 71.5 现金管理户当日明细查询 9提交包 9返回
2、包 91.6 现金管理户历史明细查询 11提交包 11返回包 122 转帐支付（逐笔） 13支付提交包 13支付返回包 15逐笔支付查询提交包 16逐笔支付查询返回包 163 企业财务室 173.1 财务室批量指令 17提交包 17返回包 193.2 财务室批量指令查询 20提交包 20返回包 204 收费站 224.1 批量扣个人指令 22提交包 22返回包 234.2 批量扣个人指令查询 24提交包 24返回包 244.3 缴费个人信息查询 26提交包 26返回包 27Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明4.4 批
3、量扣企业指令 28提交包 28返回包 294.5 批量扣企业指令查询 29提交包 30返回包 304.6 缴费企业信息查询（只查已签订协议的） 31提交包 32返回包 325 批量代理汇兑 335.1 代理汇兑指令提交 33提交包 33返回包 355.2 代理汇兑指令查询 36提交包 36返回包 365.3 网点信息下载 38提交包 38返回包 386 批量外汇汇款 396.1 集团内外汇资金调拨指令提交 39提交包 40返回包 416.2 集团内外汇资金调拨指令查询 41提交包 41返回包 426.3 B 股资金清算指令提交 43提交包 43返回包 456.4 B 股资金清算指令查询 45提
4、交包 45返回包 466.5 国内外汇汇款指令提交 47提交包 47返回包 496.6 国内外汇汇款指令查询 49提交包 49返回包 507 电子商务 517.1 B2C 订购指令查询 .51提交包 51返回包 527.2 B2C 退货、返还、转付指令查询 .54提交包 54Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明返回包 557.3 B2B 订购指令查询 .57提交包 57返回包 587.4 B2B 退货、返还指令查询 .59提交包 59返回包 607.5 C2C 订购指令查询 .62提交包 62返回包 637.6 B2B
5、/B2C 退货、返还、转付指令提交 .64提交包 64返回包 657.7 个人联名卡签权指令 67提交包 67返回包 678 工资单 688.1 工资单文件上传 68提交包 68返回包 708.2 工资单文件查询 70提交包 71返回包 718.3 工资单文件删除 72提交包 72返回包 739 附录 错误代码 749.1 明文返回的错误代码 749.2 xml 中 retCode 的错误代码 74Copyright 中国工商银行北京软件研发部 2004 1Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明1 帐户查询1.1 单帐户
6、余额查询提交包NCQueryBalanceOp地区代码帐号 -必输项币种企业代码（和证书里的一致） -必输项包序列 ID -必输项请求包备用字段 1请求包备用字段 2返回包Copyright 中国工商银行北京软件研发部 2004 2Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明NCQueryBalanceOp帐号币种 例：RMB错误返回码 错误描述在 errMsg 中错误描述昨日余额余额可用余额帐户属性 中文包序列 ID企业代码返回包备用字段 1返回包备用字段 21.2 多帐户余额查询提交包NCQueryBalanceListO
7、p企业代码（和证书里的一致） -必输项Copyright 中国工商银行北京软件研发部 2004 3Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明包序列 ID -必输项请求包备用字段 1请求包备用字段 2地区代码帐号 -必输项币种请求包备用字段 3请求包备用字段 4返回包NCQueryBalanceListOp错误返回码 错误描述在 errMsg 中错误描述包序列 ID企业代码返回包备用字段 1返回包备用字段 2Copyright 中国工商银行北京软件研发部 2004 4Industrial and Commercial Bank
8、 of China 中国工商银行银企互联系统接口说明帐号币种昨日余额余额可用余额帐户属性 中文返回包备用字段 3返回包备用字段 4账号出错信息1.3 当日明细查询提交包Copyright 中国工商银行北京软件研发部 2004 5Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明NCCurDetailOp地区代码帐号 -必输项币种企业代码（和证书里的一致） -必输项包序列 ID -必输项请求包备用字段 1请求包备用字段 2返回包NCCurDetailOp错误返回码 错误描述在 errMsg 中错误描述本方帐号包序列 ID企业代码返回包
9、备用字段 1返回包备用字段 2Copyright 中国工商银行北京软件研发部 2004 6Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明交易日期 （例：yyyy-MM-dd-HH:mm:ss:6 位毫秒）共 26 位凭证号对方行行号对方账号发生额用途业务种类 中文附言对方户名借贷标志 中文摘要返回包备用字段 3返回包备用字段 41.4 历史明细查询提交包Copyright 中国工商银行北京软件研发部 2004 7Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明NCH
10、isDetailOp地区代码帐号起始日期 -必输项（例：yyyyMMdd）终止日期 -必输项最大金额 -必输项（以分为单位，不带小数点）最小金额 -必输项企业代码（和证书里的一致） -必输项包序列 ID -必输项请求包备用字段 1请求包备用字段 2返回包NCHisDetailOp错误返回码 错误描述在 errMsg 中错误描述包序列 ID企业代码返回包备用字段 1Copyright 中国工商银行北京软件研发部 2004 8Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明返回包备用字段 2地区代码帐号交易日期 （例：yyyyMMdd
11、）凭证号摘要借方发生额贷方发生额余额对方账号开户行名称对方行行名对方单位名称业务种类 中文用途交易时间（例：yyyy-MM-dd-HH:mm:ss:6 位毫秒）共 26 位其值与当日明细中“交易日期”字段值一致借贷标志 中文返回包备用字段 3返回包备用字段 4Copyright 中国工商银行北京软件研发部 2004 9Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明1.5 现金管理户当日明细查询提交包NCCashManageAccCurDetailOp地区代码帐号 -必输项币种企业代码（和证书里的一致） -必输项包序列 ID -必
12、输项请求包备用字段 1请求包备用字段 2返回包NCCashManageAccCurDetailOp错误返回码 错误描述在 errMsg 中错误描述Copyright 中国工商银行北京软件研发部 2004 10Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明本方帐号包序列 ID企业代码返回包备用字段 1返回包备用字段 2交易时间 HH:mm:ss对方行行号对方账号发生额用途业务种类 中文附言对方户名借贷标志 中文摘要业务编号相关业务编号业务代码英文备注凭证种类凭证号附加信息返回包备用字段 3返回包备用字段 4Copyright 中国
13、工商银行北京软件研发部 2004 11Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明1.6 现金管理户历史明细查询提交包NCCashManageAccHisDetailOp地区代码帐号起始日期 -必输项（例：yyyyMMdd）终止日期 -必输项最大金额 -必输项（以分为单位，不带小数点）最小金额 -必输项企业代码（和证书里的一致） -必输项包序列 ID -必输项请求包备用字段 1请求包备用字段 2Copyright 中国工商银行北京软件研发部 2004 12Industrial and Commercial Bank of Ch
14、ina 中国工商银行银企互联系统接口说明返回包NCCashManageAccHisDetailOp错误返回码 错误描述在 errMsg 中错误描述包序列 ID企业代码返回包备用字段 1返回包备用字段 2交易类型 中文交易日期 yyyyMMdd交易时间 HH:mm:ss交易帐号本方行名业务种类 中文借贷标志 中文借方发生额贷方发生额余额用途凭证种类凭证号Copyright 中国工商银行北京软件研发部 2004 13Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明对方帐号对方户名对方行名业务编号相关业务编号业务代码英文备注附加信息返回
15、包备用字段 3返回包备用字段 42 转帐支付（逐笔）支付提交包NCpaySubmitOp汇款单位汇款帐号 （35 位）-必输项地区代码汇款单位开户行收款单位 （60 位） -必输项Copyright 中国工商银行北京软件研发部 2004 14Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明收款帐号 （35 位） -必输项收款人地区代码 0：它行 1：工行收款单位开户行（60 位）-必输项交易时间指令序号金额 （18 位） -必输项 以分为单位币种用途 （20 位）汇款速度 0：普通 1：加急授权人 ID二次授权人 ID提交人 ID
16、 -必输项付款人账户地区名(付款人所在地) 收款人账户地区名(收款人所在地) -必输项 收方如果是工行，以信息对照表中的地区代码对照表为准账户分理处号支付密码备注栏(用户备注) 付款行网点号付款行行号付款行行标识付款行分签号对方行号对方行标识对方分签号附言附言标志Copyright 中国工商银行北京软件研发部 2004 15Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明转帐类型企业代码（和证书里的一致） -必输项包序列 ID（15 位） -必输项签名时间（yyyyMMddhhmmssSSS） -必输项请求包备用字段 1请求包备用
17、字段 2支付返回包NCpaySubmitOp返回码0-成功 1-可疑 其他为失败，错误描述在 errMsg 中错误描述成功描述包序列 ID企业代码返回包备用字段 1返回包备用字段 2Copyright 中国工商银行北京软件研发部 2004 16Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明逐笔支付查询提交包NCQueryPayOrderDetailOp企业代码（和证书里的一致） -必输项包序列 ID -必输项（提交指令中的包 ID）请求包备用字段 1请求包备用字段 2逐笔支付查询返回包NCQueryPayOrderDetailO
18、p错误返回码 错误描述在 errMsg 中此值只表示该交易是否执行成功，并不代表此笔支付是否成功或失败（非空表示交易执行失败，失败原因见 errMsg） 。判断支付交易成功、失败应以该交易包中“指令状态”一值为准。错误描述包序列 ID企业代码Copyright 中国工商银行北京软件研发部 2004 17Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明汇款单位汇款帐号收款单位收款帐号交易时间金额银行反馈指令状态 返回代码其含义见下表返回包备用字段 1返回包备用字段 2查询支付指令返回的 XML 包中 Result（指令状态）代码含义
19、：0： 提交成功,等待银行处理。1： 授权成功，等待银行处理2： 等待授权3： 等待二次授权4： 等待银行答复。该笔转帐交易落地。应联系付款方开户行。6： 被银行拒绝。拒绝原因见Bank_Rem字段。7： 处理成功。8： 指令被拒绝授权9： 银行正在处理。该笔转帐交易可疑。应联系付款方开户行以下交易提交包中所有元素均为必输项3 企业财务室3.1 财务室批量指令Copyright 中国工商银行北京软件研发部 2004 18Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明提交包NCReimburseBatchSubmitOp企业代码（
20、和证书里的一致）包序列 ID （15 位）付款帐号付款方式 0：普通 1：加急记帐方式 1：汇总记帐 2：逐笔记帐总笔数总金额 不带小数点，以分为单位提交人 ID （24 位）签名时间（yyyyMMddhhmmssSSS）请求包备用字段 1请求包备用字段 2顺序号（顺序号字段要求对客户透明，由企业端服务器自动生成，从“1“开始按照笔数累加，此字段不能重复。 ）报销号 （40 字符） （企业内部报销号，此项可为空）单据张数 (10 字符)（企业内部此报销号的单据数，此项可为空）收款帐号开户行 (60 字符)收款帐号地区码 （以地区Copyright 中国工商银行北京软件研发部 2004 19In
21、dustrial and Commercial Bank of China 中国工商银行银企互联系统接口说明代码对照表为准（4 位代码） ） 如果为它行此字段为“0”收款帐号地市名 （以地区代码对照表为准收款帐号收款帐号名称 (60 字符)币种 （目前暂定为“RMB” ）金额 不带小数点，以分为单位用途必须是信息对照表中用途对照表的内容备注 （100 字符）请求包备用字段 3请求包备用字段 4返回包NCReimburseBatchSubmitOp返回码“0-文件提交成功” （不表示所有指令处理成功）其他为失败，错误描述在 errMsg 中内容描述包序列 ID企业代码Copyright 中国工商
22、银行北京软件研发部 2004 20Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明返回包备用字段 1返回包备用字段 23.2 财务室批量指令查询提交包NCQueryReimburseBatchOrderDetailOp企业代码（和证书里的一致）包序列 ID查询状态类型Result_type 输入项的范围：100 查询状态为“正在处理“的指令010 查询状态为“处理成功“的指令001 查询状态为“处理失败“的指令111 查询以上所有指令状态以上状态可自由组合例：110 查询状态为“正在处理和处理成功“的指令请求包备用字段 1请求包备
23、用字段 2Copyright 中国工商银行北京软件研发部 2004 21Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明返回包NCQueryReimburseBatchOrderDetailOp错误返回码 错误描述在 errMsg 中如果 retCode 返回是“40416”说明本批次被全部拒绝，拒绝原因见errMsg错误描述包序列 ID企业代码付款方式 返回中文记帐方式 返回中文查询状态类型 返回代码返回包备用字段 1返回包备用字段 2顺序号报销号单据张数付款帐号付款帐号名称收款帐号收款帐号名称币种Copyright 中国工商银
24、行北京软件研发部 2004 22Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明付款金额 不带小数点，以分为单位用途用户备注处理结果 返回中文银行备注返回包备用字段 3返回包备用字段 44 收费站4.1 批量扣个人指令提交包NCEntIndivilBatchSubmitOp企业代码（和证书里的一致）包序列 ID （15 位）收款帐号总笔数总金额 不带小数点，以分为单位Copyright 中国工商银行北京软件研发部 2004 23Industrial and Commercial Bank of China 中国工商银行银企互联系统
25、接口说明提交人 ID （24 位）签名时间（yyyyMMddhhmmssSSS）请求包备用字段 1请求包备用字段 2顺序号 （从“1“开始按照笔数累加）协议编号 （15 字符）缴费编号 （30 字符）付款帐号开户行 (60 字符)付款帐号付方户名 (60 字符)币种 （目前暂定为“RMB” ）金额 不带小数点，以分为单位用途 （100 字符）备注 （70 字符）请求包备用字段 3请求包备用字段 4返回包NCEntIndivilBatchSubmitOpCopyright 中国工商银行北京软件研发部 2004 24Industrial and Commercial Bank of China 中
26、国工商银行银企互联系统接口说明返回码“0-文件提交成功” （不表示所有指令处理成功）其他为失败，错误描述在 errMsg 中内容描述包序列 ID企业代码返回包备用字段 1返回包备用字段 24.2 批量扣个人指令查询提交包NCQueryEntIndivBatchOrderDetailOp企业代码（和证书里的一致）包序列 ID查询状态类型Result_type 输入项的范围同上请求包备用字段 1请求包备用字段 2Copyright 中国工商银行北京软件研发部 2004 25Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明返回包NCQu
27、eryEntIndivBatchOrderDetailOp错误返回码 错误描述在 errMsg 中如果 retCode 返回是“40416”说明本批次被全部拒绝，拒绝原因见errMsg错误描述包序列 ID企业代码查询状态类型 返回代码返回包备用字段 1返回包备用字段 2顺序号缴费编号缴费类型协议编号收款帐号收款帐号名称付款帐号付款帐号名称币种Copyright 中国工商银行北京软件研发部 2004 26Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明金额用途用户备注处理结果 返回中文银行备注返回包备用字段 3返回包备用字段 44.3 缴费个人信息查询提交包NCQueryCustomerListOp企业代码（和证书里的一致）包序列 ID起始日期 （例：yyyyMMdd）终止日期收费企业账号付款帐号 （此项可为空）缴费编号 （此项可为空）查询协议类型 0 签订协议，1 撤销协议
