您好,欢迎来到九壹网。
搜索
您的当前位置:首页中国工商银行银企互联系统接口说明Version 4.3

中国工商银行银企互联系统接口说明Version 4.3

来源:九壹网


Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

中国工商银行银企 互联系统接口说明

Version 4.2

中国工商银行电子银行部 中国工商银行北京软件研发部

2005年07月

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 目 录

1

帐户查询 ................................................................................................................................... 1 1.1 单帐户余额查询 ....................................................................................................... 1

提交包 ............................................................................................................................... 1 返回包 ............................................................................................................................... 1 1.2 多帐户余额查询 ....................................................................................................... 2

提交包 ............................................................................................................................... 2 返回包 ............................................................................................................................... 3 1.3 当日明细查询 ........................................................................................................... 4

提交包 ............................................................................................................................... 4 返回包 ............................................................................................................................... 5 1.4 历史明细查询 ........................................................................................................... 6

提交包 ............................................................................................................................... 6 返回包 ............................................................................................................................... 7 1.5 现金管理户当日明细查询 ....................................................................................... 9

提交包 ............................................................................................................................... 9 返回包 ............................................................................................................................... 9 1.6 现金管理户历史明细查询 ..................................................................................... 11

提交包 ............................................................................................................................. 11 返回包 ............................................................................................................................. 12 转帐支付(逐笔) ................................................................................................................. 13

支付提交包 ..................................................................................................................... 13 支付返回包 ..................................................................................................................... 15 逐笔支付查询提交包 ..................................................................................................... 16 逐笔支付查询返回包 ..................................................................................................... 16 企业财务室 ............................................................................................................................. 17 3.1 财务室批量指令 ..................................................................................................... 17

提交包 ............................................................................................................................. 18 返回包 ............................................................................................................................. 19 3.2 财务室批量指令查询 ............................................................................................. 20

提交包 ............................................................................................................................. 20 返回包 ............................................................................................................................. 21 收费站..................................................................................................................................... 22 4.1 批量扣个人指令 ..................................................................................................... 22

提交包 ............................................................................................................................. 22 返回包 ............................................................................................................................. 23 4.2 批量扣个人指令查询 ............................................................................................. 24

提交包 ............................................................................................................................. 24 返回包 ............................................................................................................................. 25 4.3 缴费个人信息查询 ................................................................................................. 26

提交包 ............................................................................................................................. 26

2

3

4

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 5

6

7

返回包 ............................................................................................................................. 27 4.4 批量扣企业指令 ..................................................................................................... 28

提交包 ............................................................................................................................. 28 返回包 ............................................................................................................................. 29 4.5 批量扣企业指令查询 ............................................................................................. 30

提交包 ............................................................................................................................. 30 返回包 ............................................................................................................................. 30 4.6 缴费企业信息查询(只查已签订协议的) ......................................................... 32

提交包 ............................................................................................................................. 32 返回包 ............................................................................................................................. 32 批量代理汇兑 ......................................................................................................................... 33 5.1 代理汇兑指令提交 ................................................................................................. 33

提交包 ............................................................................................................................. 33 返回包 ............................................................................................................................. 35 5.2 代理汇兑指令查询 ................................................................................................. 36

提交包 ............................................................................................................................. 36 返回包 ............................................................................................................................. 36 5.3 网点信息下载 ......................................................................................................... 38

提交包 ............................................................................................................................. 38 返回包 ............................................................................................................................. 39 批量外汇汇款 ......................................................................................................................... 39 6.1 集团内外汇资金调拨指令提交 ............................................................................. 39

提交包 ............................................................................................................................. 40 返回包 ............................................................................................................................. 41 6.2 集团内外汇资金调拨指令查询 ............................................................................. 41

提交包 ............................................................................................................................. 41 返回包 ............................................................................................................................. 42 6.3 B股资金清算指令提交 .......................................................................................... 43

提交包 ............................................................................................................................. 43 返回包 ............................................................................................................................. 45 6.4 B股资金清算指令查询 .......................................................................................... 45

提交包 ............................................................................................................................. 45 返回包 ............................................................................................................................. 46 6.5 国内外汇汇款指令提交 ......................................................................................... 47

提交包 ............................................................................................................................. 47 返回包 ............................................................................................................................. 49 6.6 国内外汇汇款指令查询 ......................................................................................... 49

提交包 ............................................................................................................................. 49 返回包 ............................................................................................................................. 50 电子商务 ................................................................................................................................. 51 7.1 B2C订购指令查询 ................................................................................................. 51

提交包 ............................................................................................................................. 51 返回包 ............................................................................................................................. 52 7.2 B2C退货、返还、转付指令查询.......................................................................... 54

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 8

9

提交包 ............................................................................................................................. 54 返回包 ............................................................................................................................. 55 7.3 B2B订购指令查询 ................................................................................................. 57

提交包 ............................................................................................................................. 57 返回包 ............................................................................................................................. 58 7.4 B2B退货、返还指令查询 ..................................................................................... 59

提交包 ............................................................................................................................. 59 返回包 ............................................................................................................................. 60 7.5 C2C订购指令查询 ................................................................................................. 62

提交包 ............................................................................................................................. 62 返回包 ............................................................................................................................. 63 7.6 B2B/B2C退货、返还、转付指令提交 .................................................................

提交包 ............................................................................................................................. 返回包 ............................................................................................................................. 65 7.7 个人联名卡签权指令 ............................................................................................. 67

提交包 ............................................................................................................................. 67 返回包 ............................................................................................................................. 67 工资单..................................................................................................................................... 68 8.1 工资单文件上传 ..................................................................................................... 68

提交包 ............................................................................................................................. 68 返回包 ............................................................................................................................. 70 8.2 工资单文件查询 ..................................................................................................... 70

提交包 ............................................................................................................................. 71 返回包 ............................................................................................................................. 71 8.3 工资单文件删除 ..................................................................................................... 72

提交包 ............................................................................................................................. 72 返回包 ............................................................................................................................. 73 附录 错误代码 ....................................................................................................................... 74 9.1 明文返回的错误代码 ............................................................................................. 74 9.2 xml中retCode的错误代码 ..................................................................................... 74

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 1 帐户查询

1.1 单帐户余额查询

提交包

NCQueryBalanceOp 地区代码

帐号 ---必输项 币种

企业代码(和证书里的一致) ---必输项 包序列ID ---必输项 请求包备用字段1

请求包备用字段2

返回包

Copyright 中国工商银行北京软件研发部 2004 1

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 NCQueryBalanceOp 帐号 币种

例:RMB

错误返回码 错误描述在errMsg 中 错误描述

昨日余额 余额

可用余额 帐户属性 中文

包序列ID 企业代码

返回包备用字段1

返回包备用字段2

1.2 多帐户余额查询

提交包

NCQueryBalanceListOp

企业代码(和证书里的一致) ---必输项Copyright 中国工商银行北京软件研发部 2004 2

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 包序列ID ---必输项 请求包备用字段1

请求包备用字段2

地区代码

帐号 ---必输项 币种

请求包备用字段3

请求包备用字段4

返回包

NCQueryBalanceListOp 错误返回码 错误描述在errMsg 中 错误描述 包序列ID 企业代码

返回包备用字段1

返回包备用字段2

Copyright 中国工商银行北京软件研发部 2004 3

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 帐号 币种 昨日余额 余额

可用余额 帐户属性 中文 返回包备用字段3

返回包备用字段4

账号

出错信息

1.3 当日明细查询

提交包

Copyright 中国工商银行北京软件研发部 2004 4

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 NCCurDetailOp 地区代码

帐号 ---必输项 币种

企业代码(和证书里的一致) ---必输项 包序列ID ---必输项 请求包备用字段1

请求包备用字段2

返回包

NCCurDetailOp 错误返回码 错误描述在errMsg 中 错误描述

本方帐号 包序列ID 企业代码

返回包备用字段1

返回包备用字段2

Copyright 中国工商银行北京软件研发部 2004 5

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

交易日期

(例:yyyy-MM-dd-HH:mm:ss:6位毫秒)共26位

凭证号 对方行行号 对方账号 发生额 用途

业务种类 中文

附言

对方户名 借贷标志

中文

摘要

返回包备用字段3

返回包备用字段4

1.4 历史明细查询

提交包

Copyright 中国工商银行北京软件研发部 2004 6

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

NCHisDetailOp

地区代码 帐号 起始日期 终止日期

---必输项(例:yyyyMMdd)

---必输项

---必输项(以分为单位,不带

最大金额

小数点)

最小金额

---必输项

企业代码(和证书里的一致) ---必输项 包序列ID ---必输项 请求包备用字段1 请求包备用字段2

返回包

NCHisDetailOp

错误返回码 错误描述在errMsg 中 错误描述 包序列ID 企业代码

返回包备用字段1

Copyright 中国工商银行北京软件研发部 2004 7

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 返回包备用字段2

地区代码 帐号

交易日期 (例:yyyyMMdd) 凭证号 摘要 借方发生额 贷方发生额 余额

对方账号 开户行名称 对方行行名 对方单位名称 业务种类 中文

用途

交易时间

(例:yyyy-MM-dd-HH:mm:ss:6位毫秒)共26位

其值与当日明细中“交易日期”字段值一致

借贷标志

中文

返回包备用字段3

返回包备用字段4

Copyright 中国工商银行北京软件研发部 2004 8

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 1.5 现金管理户当日明细查询

提交包

NCCashManageAccCurDetailOp 地区代码

帐号 ---必输项 币种

企业代码(和证书里的一致) ---必输项 包序列ID ---必输项 请求包备用字段1

请求包备用字段2

返回包

NCCashManageAccCurDetailOp 错误返回码 错误描述在errMsg 中

错误描述

Copyright 中国工商银行北京软件研发部 2004 9

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 本方帐号 包序列ID 企业代码

返回包备用字段1

返回包备用字段2

交易时间 HH:mm:ss 对方行行号 对方账号 发生额 用途

业务种类 中文

附言

对方户名 借贷标志

中文

摘要 业务编号 相关业务编号 业务代码 英文备注 凭证种类 凭证号 附加信息

返回包备用字段3

返回包备用字段4

Copyright 中国工商银行北京软件研发部 2004 10

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

1.6 现金管理户历史明细查询

提交包

NCCashManageAccHisDetailOp

地区代码 帐号 起始日期 终止日期

---必输项(例:yyyyMMdd)

---必输项

---必输项(以分为单位,不带

最大金额

小数点)

最小金额

---必输项

企业代码(和证书里的一致) ---必输项 包序列ID ---必输项 请求包备用字段1 请求包备用字段2

Copyright 中国工商银行北京软件研发部 2004 11

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 返回包

NCCashManageAccHisDetailOp 错误返回码 错误描述在errMsg 中 错误描述 包序列ID 企业代码

返回包备用字段1

返回包备用字段2

交易类型 中文 交易日期 yyyyMMdd 交易时间

HH:mm:ss

交易帐号 本方行名 业务种类 中文

借贷标志

中文

借方发生额 贷方发生额 余额 用途

凭证种类

凭证号

Copyright 中国工商银行北京软件研发部 2004 12

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 对方帐号 对方户名 对方行名 业务编号 相关业务编号 业务代码 英文备注

附加信息

返回包备用字段3

返回包备用字段4

2 转帐支付(逐笔)

支付提交包

NCpaySubmitOp 汇款单位

汇款帐号 (35位)---必输项 地区代码

汇款单位开户行

收款单位 (60位) ---必输项Copyright 中国工商银行北京软件研发部 2004 13

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

---对照表为准

收款帐号 (35位) ---必输项 收款人地区代码 0:它行 1:工行 收款单位开户行(60位)--必输项 交易时间 指令序号

金额 (18位) ---必输项 以分为单位 币种 用途

(20位)

汇款速度 0:普通 1:加急 授权人ID 二次授权人ID

提交人ID ---必输项

付款人账户地区名(付款人所在地) 收款人账户地区名(收款人所在地)

必输项 收方如果是工行,以《信息对照表》中的地区代码账户分理处号 支付密码 备注栏(用户备注) 付款行网点号 付款行行号 付款行行标识 付款行分签号 对方行号 对方行标识 对方分签号 附言

附言标志 转帐类型

Copyright 中国工商银行北京软件研发部 2004 14

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 企业代码(和证书里的一致) ---必输项 包序列ID(15位)

---必输项

签名时间(yyyyMMddhhmmssSSS) ---必输项 请求包备用字段1

请求包备用字段2

支付返回包

NCpaySubmitOp 返回码

0-成功1-可疑 其他为失败,错误描述在errMsg 中 错误描述 成功描述 包序列ID 企业代码

返回包备用字段1

返回包备用字段2

Copyright 中国工商银行北京软件研发部 2004 15

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 逐笔支付查询提交包

NCQueryPayOrderDetailOp

企业代码(和证书里的一致) ---必输项

包序列ID ---必输项(提交指令中的包ID) 请求包备用字段1 请求包备用字段2

逐笔支付查询返回包

NCQueryPayOrderDetailOp

错误返回码 错误描述在errMsg 中此值只表示该

交易是否执行成功,并不代表此笔支付是否成功或失败(非空表示交易执行失败,失败原因见errMsg)。判断支付交易成功、失败应以该交易包中“指令状态”一值为准。

错误描述 包序列ID 企业代码

Copyright 中国工商银行北京软件研发部 2004 16

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 汇款单位 汇款帐号 收款单位 收款帐号 交易时间 金额 银行反馈 指令状态

返回代码其含义见下表 返回包备用字段1

返回包备用字段2

查询支付指令返回的XML包中Result(指令状态)代码含义: 0: 提交成功,等待银行处理。 1: 授权成功,等待银行处理 2: 等待授权 3: 等待二次授权 4: 等待银行答复。该笔转帐交易落地。应联系付款方开户行。 6: 被银行拒绝。拒绝原因见Bank_Rem字段。 7: 处理成功。 8: 指令被拒绝授权 9: 银行正在处理。该笔转帐交易可疑。应联系付款方开户行

以下交易提交包中所有元素均为必输项

3 企业财务室

3.1 财务室批量指令

Copyright 中国工商银行北京软件研发部 2004 17

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 提交包

NCReimburseBatchSubmitOp

企业代码(和证书里的一致) 包序列ID 付款帐号

付款方式 0:普通 1:加急

记帐方式 1:汇总记帐 2:逐笔记帐 总笔数 总金额

不带小数点,以分为单位

(24位)

(15位)

提交人ID

签名时间(yyyyMMddhhmmssSSS)

请求包备用字段1 请求包备用字段2

顺序号

(顺序号字段要求对客户透明,由企业端服务器自动生成,从\"1\"开

始按照笔数累加,此字段不能重复。)

报销号 (40字符)(企业内部

报销号,此项可为空)

单据张数 (10字符)(企业内

部此报销号的单据数,此项可为空)

收款帐号开户行

(60字符)

收款帐号地区码 (以《地区

Copyright 中国工商银行北京软件研发部 2004 18

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 代码对照表》为准(4位代码)) 如果为它行此字段为“0”

收款帐号地市名 (以《地区

代码对照表》为准

收款帐号 收款帐号名称

(60字符)

币种 (目前暂定为“RMB”) 金额

不带小数点,以分为单位

用途必须是《信息对照表》中用途对照表的

内容

备注

(100字符)

请求包备用字段3 请求包备用字段4

返回包

NCReimburseBatchSubmitOp

返回码

“0-文件提交成功”(不表示所有指令处理成功)其他为失败,错误描述

在errMsg 中

内容描述 包序列ID 企业代码

Copyright 中国工商银行北京软件研发部 2004 19

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 返回包备用字段1

返回包备用字段2

3.2 财务室批量指令查询

提交包

NCQueryReimburseBatchOrderDetailOp 企业代码(和证书里的一致) 包序列ID

查询状态类型

Result_type输入项的范围:

100 查询状态为\"正在处理\"的指令

010 查询状态为\"处理成功\"的指令 001 查询状态为\"处理失败\"的指令 111 查询以上所有指令状态 以上状态可自由组合

例:110 查询状态为\"正在处理和处理成功\"的指令 请求包备用字段1

请求包备用字段2

Copyright 中国工商银行北京软件研发部 2004 20

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 返回包

NCQueryReimburseBatchOrderDetailOp

错误返回码 错误描述在errMsg 中

如果retCode返回是“40416”说明本批次被全部拒绝,拒绝原因见errMsg 错误描述 包序列ID 企业代码 付款方式

返回中文

返回中文

记帐方式

查询状态类型 返回代码

返回包备用字段1 返回包备用字段2

顺序号

报销号 单据张数 付款帐号 付款帐号名称 收款帐号

收款帐号名称 币种 付款金额

不带小数点,以分为单位

Copyright 中国工商银行北京软件研发部 2004 21

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 用途 用户备注 处理结果

返回中文

银行备注

返回包备用字段3

返回包备用字段4

4 收费站

4.1 批量扣个人指令

提交包

NCEntIndivilBatchSubmitOp

企业代码(和证书里的一致) 包序列ID (15位)

收款帐号 总笔数 总金额

不带小数点,以分为单位

提交人ID

(24位)

Copyright 中国工商银行北京软件研发部 2004 22

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 签名时间(yyyyMMddhhmmssSSS)

请求包备用字段1

请求包备用字段2

顺序号 (从\"1\"开始按照笔数累加) 协议编号 (15字符)

缴费编号

(30字符)

付款帐号开户行 (60字符)

付款帐号 付方户名

(60字符)

币种 (目前暂定为“RMB”) 金额 不带小数点,以分为单位 用途

(100字符) 备注

(70字符)

请求包备用字段3

请求包备用字段4

返回包

NCEntIndivilBatchSubmitOp

Copyright 中国工商银行北京软件研发部 2004 23

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

返回码

“0-文件提交成功”(不表示所有指令处理成功)其他为失败,错误描述

在errMsg 中 内容描述 包序列ID 企业代码

返回包备用字段1

返回包备用字段2

4.2 批量扣个人指令查询

提交包

NCQueryEntIndivBatchOrderDetailOp 企业代码(和证书里的一致) 包序列ID 查询状态类型

Result_type输入项的范围同上 请求包备用字段1

请求包备用字段2

Copyright 中国工商银行北京软件研发部 2004 24

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 返回包

NCQueryEntIndivBatchOrderDetailOp

错误返回码 错误描述在errMsg 中

如果retCode返回是“40416”说明本批次被全部拒绝,拒绝原因见errMsg 错误描述 包序列ID 企业代码

查询状态类型 返回代码 返回包备用字段1 返回包备用字段2

顺序号 缴费编号 缴费类型 协议编号 收款帐号

收款帐号名称 付款帐号 付款帐号名称 币种 金额

Copyright 中国工商银行北京软件研发部 2004 25

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 用途 用户备注 处理结果

返回中文

银行备注

返回包备用字段3

返回包备用字段4

4.3 缴费个人信息查询

提交包

NCQueryCustomerListOp 企业代码(和证书里的一致) 包序列ID 起始日期

(例:yyyyMMdd)

终止日期 收费企业账号 付款帐号 (此项可为空) 缴费编号

(此项可为空)

查询协议类型

0 签订协议,1 撤销协议

请求包备用字段1

Copyright 中国工商银行北京软件研发部 2004 26

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

请求包备用字段2

返回包

NCQueryCustomerListOp

错误返回码 错误描述在errMsg 中 错误描述 包序列ID 企业代码 收费企业账号 查询协议类型

返回代码

返回包备用字段1 返回包备用字段2

协议编号 缴费编号 缴费种类 付款帐号 付款帐号名称

签定/撤销协议日期 例:yyyyMMddHHmmss 返回包备用字段3

Copyright 中国工商银行北京软件研发部 2004 27

返回中文

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 返回包备用字段4

4.4 批量扣企业指令

提交包

NCEnterpriseBatchSubmitOp 企业代码(和证书里的一致) 包序列ID (15位)

收款帐号

付款方式 0:普通 1:加急 总笔数 总金额

不带小数点,以分为单位

提交人ID

(24位)

签名时间(yyyyMMddhhmmssSSS)

请求包备用字段1

请求包备用字段2

顺序号 (从\"1\"开始按照笔数累加)Copyright 中国工商银行北京软件研发部 2004 28

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 (60字符)

付款帐号开户行 付款帐号 付方户名

(60字符)

币种 (目前暂定为“RMB”) 金额 用途

不带小数点,以分为单位

(100字符) (70字符)

备注

请求包备用字段3 请求包备用字段4

返回包

NCEnterpriseBatchSubmitOp

返回码

“0-文件提交成功”(不表示所有指令处理成功)其他为失败,错误描述

在errMsg 中

内容描述 包序列ID 企业代码

返回包备用字段1 返回包备用字段2

Copyright 中国工商银行北京软件研发部 2004 29

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

4.5 批量扣企业指令查询

提交包

NCQueryEnterpriseBatchOrderDetailOp 企业代码(和证书里的一致) 包序列ID 查询状态类型

Result_type输入项的范围同上 请求包备用字段1

请求包备用字段2

返回包

NCQueryEnterpriseBatchOrderDetailOp

错误返回码 错误描述在errMsg 中

Copyright 中国工商银行北京软件研发部 2004 30

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 如果retCode返回是“40416”说明本批次被全部拒绝,拒绝原因见errMsg 错误描述 包序列ID 企业代码 付款方式

返回中文

查询状态类型 返回代码 返回包备用字段1

返回包备用字段2

顺序号 收款帐号

收款帐号名称 付款帐号 付款帐号名称 币种

金额 用途 用户备注 处理结果

返回中文

银行备注

返回包备用字段3

返回包备用字段4

Copyright 中国工商银行北京软件研发部 2004 31

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 4.6 缴费企业信息查询(只查已签订协议的)

提交包

NCQueryCorporationListOp 企业代码(和证书里的一致) 包序列ID 起始日期

(例:yyyyMMdd) 终止日期 收费企业账号 付款帐号

(此项可为空)

请求包备用字段1

请求包备用字段2

返回包

NCQueryCorporationListOp

错误返回码 错误描述在errMsg 中

Copyright 中国工商银行北京软件研发部 2004 32

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 错误描述 包序列ID 企业代码 收费企业账号

返回包备用字段1

返回包备用字段2

付款帐号 付款帐号名称

签定协议日期

例:yyyyMMddHHmmss

返回包备用字段3

返回包备用字段4

5 批量代理汇兑

5.1 代理汇兑指令提交

提交包

Copyright 中国工商银行北京软件研发部 2004 33

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

NCBatchExchangeSubmitOp

企业代码(和证书里的一致) 包序列ID

(15位)

付款方式 0:普通 1:加急 总笔数 总金额

不带小数点,以分为单位

(24位)

提交人ID

签名时间(yyyyMMddhhmmssSSS)

请求包备用字段1 请求包备用字段2

顺序号 (从\"1\"开始按照笔数累加) 代理付款人账号 被代理

行在工行的19位帐号

代理付款人行名 被代

理行在工行的户名(60字符)

付款人账号 被代理行实际帐号

(30字符)

付款人户名 被代理行实际户名

(60字符)

汇出行行名(40字

符)

收款行标识 0:它行 1:工行 收款方工行地区名称以《地区代码对照表》为准

收款方工行网点名称 如果收款方是工行,

Copyright 中国工商银行北京软件研发部 2004 34

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 则该项为空。否则如为它行,则此域值为收款方就近的工行网点名称,以网点信息下载功能中的网点名称(Net_Name)为准(注意不同地区代码下,有可能有相同的网点名称)

收款人户名(30字符)

符)

币种 (目前暂定为“RMB”) 金额 用途

不带小数点,以分为单位

(20字符)

收款人账号(30字符)

汇入行行名(40字

请求包备用字段3 请求包备用字段4

返回包

NCBatchExchangeSubmitOp

返回码

“0-文件提交成功”(不表示所有指令处理成功)其他为失败,错误描述

在errMsg 中

内容描述 包序列ID 企业代码

Copyright 中国工商银行北京软件研发部 2004 35

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 返回包备用字段1

返回包备用字段2

5.2 代理汇兑指令查询

提交包

NCQueryBatAgtExchDetailOp 企业代码(和证书里的一致) 包序列ID 查询状态类型 Result_type输入项的范围同上 请求包备用字段1

请求包备用字段2

返回包

Copyright 中国工商银行北京软件研发部 2004 36

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 NCQueryBatAgtExchDetailOp 错误返回码 错误描述在errMsg 中

如果retCode返回是“40416”说明本批次被全部拒绝,拒绝原因见errMsg 错误描述 包序列ID 企业代码

交易时间 yyyyMMddhhmmss

付款方式

返回中文

查询状态类型 返回代码 返回包备用字段1

返回包备用字段2

顺序号

代理付款人账号 代理付款人行名 付款人账号 付款人户名

汇出行行名

收款行标识

0:它行 1:工行

收款方工行地区名称

工行收款方网点名称 收款人帐号 收款人户名

汇入行行名

币种

Copyright 中国工商银行北京软件研发部 2004 37

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 不带小数点,以分为单位

付款金额 用途 处理结果

返回中文

银行备注

返回包备用字段3

返回包备用字段4

5.3 网点信息下载

提交包

NCQueryHostOfficeInfoOp 企业代码(和证书里的一致) 包序列ID

请求包备用字段1

请求包备用字段2

Copyright 中国工商银行北京软件研发部 2004 38

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 返回包

NCQueryHostOfficeInfoOp 错误返回码 错误描述在errMsg 中 错误描述 包序列ID 企业代码

返回包备用字段1

返回包备用字段2

地区代码 网点名称

返回包备用字段3

返回包备用字段4

6 批量外汇汇款

6.1 集团内外汇资金调拨指令提交

Copyright 中国工商银行北京软件研发部 2004 39

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 提交包

NCBatchExchGroupSubmitOp

企业代码(和证书里的一致) 包序列ID 总笔数 总金额

不带小数点,以分为单位

(15位)

币种 以《信息对照表》中币种对照表缩写为准

提交人ID

(24位)

签名时间(yyyyMMddhhmmssSSS)

请求包备用字段1 请求包备用字段2

顺序号 (从\"1\"开始按照笔数累加) 付款人账号 收款人账号 金额 用途

不带小数点,以分为单位

(200字符)

(70字符)

备注信息

请求包备用字段3 请求包备用字段4

Copyright 中国工商银行北京软件研发部 2004 40

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

返回包

NCBatchExchGroupSubmitOp

返回码

“0-文件提交成功”(不表示所有指令处理成功)其他为失败,错误描述

在errMsg 中

内容描述 包序列ID 企业代码

返回包备用字段1 返回包备用字段2

6.2 集团内外汇资金调拨指令查询

提交包

Copyright 中国工商银行北京软件研发部 2004 41

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

NCQueryExchGroupDetailOp

企业代码(和证书里的一致) 包序列ID 查询状态类型

Result_type输入项的范围同上 请求包备用字段1 请求包备用字段2

返回包

NCQueryExchGroupDetailOp

错误返回码 错误描述在errMsg 中

如果retCode返回是“40416”说明本批次被全部拒绝,拒绝原因见errMsg 错误描述 包序列ID 企业代码

交易时间

yyyyMMddhhmmss

币种 返回代码

查询状态类型 返回代码 返回包备用字段1 返回包备用字段2

Copyright 中国工商银行北京软件研发部 2004 42

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 顺序号

付款帐号名称 付款帐号 收款帐号名称 收款帐号

金额 用途 用户备注 处理结果

返回中文

银行备注

返回包备用字段3

返回包备用字段4

6.3 B股资金清算指令提交

提交包

NCBatchExchBSubmitOp

Copyright 中国工商银行北京软件研发部 2004 43

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

企业代码(和证书里的一致) 包序列ID 总笔数 总金额

不带小数点,以分为单位

(15位)

币种 以《信息对照表》中币种对照表缩写为准

提交人ID

(24位)

签名时间(yyyyMMddhhmmssSSS)

请求包备用字段1 请求包备用字段2

顺序号 (从\"1\"开始按照笔数累加) 付款人账号 收款人账号

席位号 (20字符 可为空) 股东代码 (20字符 可为空) 金额 用途

不带小数点,以分为单位

(目前只能输入“B股资金清算”)

(70字符)

备注信息

请求包备用字段3 请求包备用字段4

Copyright 中国工商银行北京软件研发部 2004 44

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 返回包

NCBatchExchBSubmitOp

返回码

“0-文件提交成功”(不表示所有指令处理成功)其他为失败,错误描述

在errMsg 中

内容描述 包序列ID 企业代码

返回包备用字段1 返回包备用字段2

6.4 B股资金清算指令查询

提交包

NCQueryExchBDetailOp

企业代码(和证书里的一致)

Copyright 中国工商银行北京软件研发部 2004 45

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

包序列ID 查询状态类型

Result_type输入项的范围同上 请求包备用字段1 请求包备用字段2

返回包

NCQueryExchBDetailOp

错误返回码 错误描述在errMsg 中

如果retCode返回是“40416”说明本批次被全部拒绝,拒绝原因见errMsg 错误描述 包序列ID 企业代码

交易时间

yyyyMMddhhmmss

币种 返回代码

查询状态类型 返回代码 返回包备用字段1 返回包备用字段2

顺序号

Copyright 中国工商银行北京软件研发部 2004 46

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 付款帐号名称 付款帐号 收款帐号名称 收款帐号 席位号 股东代码

金额 用途 用户备注 处理结果

返回中文

银行备注

返回包备用字段3

返回包备用字段4

6.5 国内外汇汇款指令提交

提交包

NCBatchExchLocalSubmitOp 企业代码(和证书里的一致) 包序列ID (15位)

总笔数

Copyright 中国工商银行北京软件研发部 2004 47

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 不带小数点,以分为单位

总金额

币种 以《信息对照表》中币种对照表缩写为准

提交人ID

(24位)

签名时间(yyyyMMddhhmmssSSS)

请求包备用字段1 请求包备用字段2

顺序号 (从\"1\"开始按照笔数累加) 收款行标识 0:它行 1:工行(目前只

支持工行范围内结算,此值暂定为“1”工行)

付款人账号 收款帐号开户行

(60字符)

收款帐号地区名称 《地区代码对照表》为准)

收款人账号 收款人户名 金额 用途

(30字符)

不带小数点,以分为单位

(200字符)

(70字符)

备注信息

请求包备用字段3 请求包备用字段4

Copyright 中国工商银行北京软件研发部 2004 48

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 返回包

NCBatchExchLocalSubmitOp

返回码

“0-文件提交成功”(不表示所有指令处理成功)其他为失败,错误描述

在errMsg 中

内容描述 包序列ID 企业代码

返回包备用字段1 返回包备用字段2

6.6 国内外汇汇款指令查询

提交包

NCQueryExchLocalDetailOp

企业代码(和证书里的一致)

Copyright 中国工商银行北京软件研发部 2004 49

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

包序列ID 查询状态类型

Result_type输入项的范围同上 请求包备用字段1 请求包备用字段2

返回包

NCQueryExchLocalDetailOp

错误返回码 错误描述在errMsg 中

如果retCode返回是“40416”说明本批次被全部拒绝,拒绝原因见errMsg 错误描述 包序列ID 企业代码

交易时间

yyyyMMddhhmmss

币种 返回代码

查询状态类型 返回代码 返回包备用字段1 返回包备用字段2

顺序号

Copyright 中国工商银行北京软件研发部 2004 50

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 0:它行 1:工行(因目前

收款行标识

只支持工行范围内结算,所以此域暂未返回具体数值,为空。) 付款帐号名称 付款帐号

收款地区名称 收款帐号开户行 收款帐号名称 收款帐号

金额 用途 用户备注 处理结果

返回中文

银行备注

返回包备用字段3

返回包备用字段4

7 电子商务

7.1 B2C订购指令查询

提交包

Copyright 中国工商银行北京软件研发部 2004 51

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

NCQueryB2CPayOrderOp

企业代码(和证书里的一致) ---必输项 包序列ID ---必输项

商城类型1:B2B商城 2:B2C商城 3:C2C商城 商城代码 商城账号

---必输项 ---必输项

银行生成的交易

交易序列号

序号 ---可为空

订单号 ---可为空 起始日期

当输入交易序列号或订单号时

此项可为空

终止日期

同上(例:yyyyMMdd)

输入交易序列号或订

查询状态类型

单号时此项可为空

Result_type输入项的范围: 100 查询状态为\"可疑\"的指令

010 查询状态为\"成功\"的指令 001 查询状态为\"失败\"的指令 111 查询以上所有指令状态 以上状态可自由组合

例:110 查询状态为\"可疑和成功\"的指令

请求包备用字段1 请求包备用字段2

返回包

Copyright 中国工商银行北京软件研发部 2004 52

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

NCQueryB2CPayOrderOp

错误返回码 错误描述在errMsg 中 错误描述 包序列ID 企业代码

商城类型1:B2B商城 2:B2C商城 3:C2C商城 商城代码 商城账号

交易序列号 订单号 起始日期 终止日期

查询状态类型 返回代码 返回包备用字段1 返回包备用字段2

(例:yyyyMMdd)

交易序列号 订单号 订单金额 交易证书ID 交易时间

yyyyMMddhhmmss

银行生成的交易序号

付款人名称 付款账号/卡号

隐藏部分信息

累计退货金额 累计返还金额

Copyright 中国工商银行北京软件研发部 2004 53

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

累计转付金额 商品编号 商品名称 订单数量 已含运费金额 处理结果

返回中文

银行备注

返回包备用字段3 返回包备用字段4

7.2 B2C退货、返还、转付指令查询

提交包

NCQueryB2CAllPayOrderOp

企业代码(和证书里的一致) ---必输项 包序列ID ---必输项

查询指令类型0:退货 1:返还 2:转付 商城类型1:B2B商城 2:B2C商城 3:C2C商城

Copyright 中国工商银行北京软件研发部 2004 54

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 ---必输项 ---必输项

银行生成的退

商城代码 商城账号

交易序列号

货、返还、转付交易序号 ---可为空

订单号 ---可为空 起始日期

输入交易序列号或订单号时此

项可为空

终止日期

同上(例:yyyyMMdd)

输入交易序列号或订单号

查询状态类型 Result_type输入项的范围同上

时此项可为空

请求包备用字段1 请求包备用字段2

返回包

NCQueryB2CAllPayOrderOp

错误返回码 错误描述在errMsg 中 错误描述 包序列ID 企业代码

查询指令类型0:退货 1:返还 2:转付 商城类型1:B2B商城 2:B2C商城 3:C2C商城 商城代码

Copyright 中国工商银行北京软件研发部 2004 55

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

商城账号

交易序列号 订单号 起始日期 终止日期

查询状态类型 返回代码 返回包备用字段1 返回包备用字段2

(例:yyyyMMdd)

交易序列号 订单号 订单金额 交易金额 交易时间

yyyyMMddhhmmss

银行生成的交易序号

收款人名称 收款账号/卡号

隐藏部分信息

累计退货金额 累计返还金额 累计转付金额 商品编号 商品名称 订单数量 已含运费金额 处理结果

返回中文

银行备注

返回包备用字段3 返回包备用字段4

Copyright 中国工商银行北京软件研发部 2004 56

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

7.3 B2B订购指令查询

提交包

NCQueryB2BPayOrderOp

企业代码(和证书里的一致) ---必输项 包序列ID ---必输项

商城类型1:B2B商城 2:B2C商城 3:C2C商城 商城代码 商城账号

---必输项 ---必输项

银行生成的交易

交易序列号

序号 ---可为空

订单号 ---可为空 起始日期

输入交易序列号或订单号时此

项可为空

终止日期

同上(例:yyyyMMdd)

查询状态类型 输入交易序列号或订单号时此

项可为空

Result_type输入项的范围同上

请求包备用字段1 请求包备用字段2

Copyright 中国工商银行北京软件研发部 2004 57

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

返回包

NCQueryB2BPayOrderOp

错误返回码 错误描述在errMsg 中 错误描述 包序列ID 企业代码

商城类型1:B2B商城 2:B2C商城 3:C2C商城 商城代码 商城账号

交易序列号 订单号 起始日期 终止日期

查询状态类型 返回代码 返回包备用字段1 返回包备用字段2

(例:yyyyMMdd)

交易序列号 订单号 订单金额

Copyright 中国工商银行北京软件研发部 2004 58

银行生成的交易序号

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 交易时间

yyyyMMddhhmmss

付款人名称

付款账号

隐藏部分信息

收款人名称 收款账号

累计退货金额 累计返还金额 商品编号 商品名称 订单数量

已含运费金额 处理结果

返回中文

银行备注

返回包备用字段3

返回包备用字段4

7.4 B2B退货、返还指令查询

提交包

Copyright 中国工商银行北京软件研发部 2004 59

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

NCQueryB2BAllPayOrderOp

企业代码(和证书里的一致) ---必输项 包序列ID ---必输项

查询指令类型0:退货 1:返还

商城类型1:B2B商城 2:B2C商城 3:C2C商城 商城代码 商城账号

---必输项 ---必输项

银行生成的退

交易序列号

货、返还交易序号 ---可为空

订单号 ---可为空 起始日期

输入交易序列号或订单号时此

项可为空

终止日期

同上(例:yyyyMMdd)

查询状态类型 输入交易序列号或订单号时此

项可为空

Result_type输入项的范围同上

请求包备用字段1 请求包备用字段2

返回包

NCQueryB2BAllPayOrderOp

错误返回码 错误描述在errMsg 中 错误描述

Copyright 中国工商银行北京软件研发部 2004 60

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

包序列ID 企业代码

查询指令类型0:退货 1:返还

商城类型1:B2B商城 2:B2C商城 3:C2C商城 商城代码 商城账号

交易序列号 订单号 起始日期 终止日期

查询状态类型 返回代码 返回包备用字段1 返回包备用字段2

(例:yyyyMMdd)

交易序列号 订单号 订单金额 交易金额 交易时间

yyyyMMddhhmmss

银行生成的交易序号

收款人名称 收款账号

隐藏部分信息

累计退货金额 累计返还金额 商品编号 商品名称 订单数量 已含运费金额 处理结果

返回中文

Copyright 中国工商银行北京软件研发部 2004 61

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 银行备注

返回包备用字段3 返回包备用字段4

7.5 C2C订购指令查询

提交包

NCQueryC2CPayOrderOp

企业代码(和证书里的一致) ---必输项 包序列ID ---必输项

商城类型1:B2B商城 2:B2C商城 3:C2C商城 商城代码 商城账号

---必输项 ---必输项

银行生成的交易

交易序列号

序号 ---可为空

订单号 ---可为空 起始日期

输入交易序列号或订单号时此

项可为空

终止日期

同上(例:yyyyMMdd)

查询状态类型 输入交易序列号或订单号时此

Copyright 中国工商银行北京软件研发部 2004 62

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 项可为空

Result_type输入项的范围同上

请求包备用字段1 请求包备用字段2

返回包

NCQueryC2CPayOrderOp

错误返回码 错误描述在errMsg 中 错误描述 包序列ID 企业代码

商城类型1:B2B商城 2:B2C商城 3:C2C商城 商城代码 商城账号

交易序列号 订单号 起始日期 终止日期

查询状态类型 返回代码 返回包备用字段1 返回包备用字段2

(例:yyyyMMdd)

Copyright 中国工商银行北京软件研发部 2004 63

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 交易序列号 银行生成的交易序号

订单号 订单金额 交易时间

yyyyMMddhhmmss

付款人名称

付款账号/卡号

隐藏部分信息收款人名称 收款账号/卡号 银行收费金额

商城收费金额 商品编号 商品名称 订单数量

已含运费金额 处理结果

返回中文

银行备注

返回包备用字段3

返回包备用字段4

7.6 B2B/B2C退货、返还、转付指令提交

提交包

Copyright 中国工商银行北京软件研发部 2004

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

NCEBusinessPaySubmitOp

企业代码(和证书里的一致) ---必输项 包序列ID ---必输项

签名时间(yyyyMMddhhmmssSSS) 指令交易类型

0:退货 1:返还 2:转付

商城类型1:B2B商城 2:B2C商城 商城代码 商城账号 订单号

---必输项 ---必输项 ---必输项

原订购指令支付时间 ---必输项 yyyyMMdd B2B支付速度0:普通 1:加急(B2C交易可为空) 转付人名称 ---B2C转付操作时必输,

其他情况为空

转付账号/卡号 ---B2C转付操作时必

输,其他情况为空

金额 (18位) ---必输项 以分为单位 提交人ID 请求包备用字段1

请求包备用字段2

返回包

Copyright 中国工商银行北京软件研发部 2004 65

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

NCEBusinessPaySubmitOp

返回码

0-成功1-可疑 其他为失败,错误描述在errMsg 中 错误描述 成功描述 包序列ID 企业代码 指令交易类型

0:退货 1:返还 2:转付

商城类型1:B2B商城 2:B2C商城 3:C2C商城 商城代码 商城账号 订单号

原订购指令支付时间

B2B支付速度0:普通 1:加急(B2C交易为空) 金额

交易序列号 银行生成的该笔序号 退货、返还、转付时原订单中付款人名称

退货、返还、转付时原订单中付款账号/卡号 隐藏部分信息

转付人名称 转付账号/卡号

返回包备用字段1 返回包备用字段2

Copyright 中国工商银行北京软件研发部 2004 66

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 7.7 个人联名卡签权指令

提交包

NCCheckUnionCardNameOp

企业代码(和证书里的一致) ---必输项 包序列ID

---必输项

个人账号/卡号 ---必输项 户名

(30字符 必输)---必输项

(50字符 可为空)---必输项

业务编码 备注

(100字符 可为空)

(24位 可为空)

提交人ID

签名时间(yyyyMMddhhmmssSSS) ---必输项 请求包备用字段1

请求包备用字段2

返回包

NCCheckUnionCardNameOp

Copyright 中国工商银行北京软件研发部 2004 67

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 返回码(0-鉴权成功,否则签权失败,失败原因见

errMsg)

内容描述 包序列ID 企业代码 个人账号/卡号 户名

返回包备用字段1

返回包备用字段2

8 工资单

8.1 工资单文件上传

提交包

NCBatchWageSubmitOp

企业代码(和证书里的一致) 包序列ID 总笔数

总金额 每个员工实际收入和,不带小数点以分为单位

Copyright 中国工商银行北京软件研发部 2004 68

(15位)

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 (24位 可为空)

提交人ID

签名时间(yyyyMMddhhmmssSSS) 企业名称 收入项目数

(80字符) (2字符 最大为18) (2字符 最大为18)

支出项目数 备注

(100字符 可为空)

收入项目名称 (1100字符 每个项目名称为60字符,不同收入项目名称之间以“|”分隔,例如:基本工资|岗位工资|奖励工资 中间不允许有空项,个数应与收入项目数一致)

支出项目名称(1100字符 格式同上)

请求包备用字段1 请求包备用字段2

顺序号 (从\"1\"开始按照笔数累加) 部门名称 (30字符) 人员编号

(20字符 可为空)

员工姓名 (40字符) 发放年月 (yyyyMM) 工资账户1 (20字符) 工资账户2

工资账户3 三个工资账户不能同时为空 收入合计

(20字符)

支出合计 (20字符)

实际收入 (20字符)

收入项目金额 (400字符 每项金额为20字符,金额不带小数点以分为单位) 例如:100|0|300 顺序要与“收入项目名称”顺序一致,如此人该项

Copyright 中国工商银行北京软件研发部 2004 69

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 无金额应填入“0”。

支出项目金额 同上

请求包备用字段3

请求包备用字段4

返回包

NCBatchWageSubmitOp 返回码

“0-工资单文件提交成功”(其他为失败,错误描述在errMsg 中) 内容描述 包序列ID 企业代码

银行产生的工资单文件流水号 返回包备用字段1

返回包备用字段2

8.2 工资单文件查询

Copyright 中国工商银行北京软件研发部 2004 70

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 提交包

NCQueryBatchWageOp

企业代码(和证书里的一致) ---必输项 包序列ID ---必输项 起始日期 终止日期

---必输项(例:yyyyMMdd)

---必输项

请求包备用字段1 请求包备用字段2

返回包

NCQueryBatchWageOp

错误返回码 错误描述在errMsg 中 错误描述 包序列ID 企业代码 起始日期

(例:yyyyMMdd)

Copyright 中国工商银行北京软件研发部 2004 71

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

终止日期

返回包备用字段1 返回包备用字段2

企业提交工资单文件日期 yyyyMMdd 企业提交工资单文件时的包

ID

银行产生的工资单文件流水号 总笔数 总金额 状态

中文(正常 删除)

返回包备用字段3 返回包备用字段4

8.3 工资单文件删除

提交包

NCDeleteBatchWageOp

Copyright 中国工商银行北京软件研发部 2004 72

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

企业代码(和证书里的一致) ---必输项 包序列ID ---必输项

企业提交工资单文件日期 yyyyMMdd ---

必输项

银行产生的工资单文件流水号 ---必

输项

提交人ID

(24位 可为空)签名时间(yyyyMMddhhmmssSSS)

请求包备用字段1

请求包备用字段2

返回包

NCDeleteBatchWageOp 返回码

“0-工资单文件删除成功!”(其他为失败,错误描述在errMsg 中) 内容描述 包序列ID 企业代码

企业提交工资单文件日期

银行产生的工资单文件流水号

Copyright 中国工商银行北京软件研发部 2004 73

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明

返回包备用字段1 返回包备用字段2

9 附录 错误代码

9.1 明文返回的错误代码

格式:errorCode=错误代码 错误代码 说明 40418 解析请求数据时出现错误 40422 40426 41062 读交易名称失败 银行已处理完毕,返回应答包时出错 签名数据有误或为空 建议处理方法 缺少必要参数,检查请求数据重新打包发送请求 检查请求数据中的交易名称,重新打包发送请求 查询明细,查看银行处理结果 请检查签名数据是否正确发送 9.2 xml中retCode的错误代码

错误代码(retCode) 40400 错误信息描述(errMsg) 验证签名失败 说明 验证签名失败 建议处理方法 检查NetSafe Client配置,重新打包签名发送请求 检查NetSafe Client配置,重新打包发送请求 检查请求xml包中的userID以及NetSafe Client配置的userID,重新打包发送请求 重新打包签名发送请求 40402 获得明文包失败 获得明文包失败 40403 企业ID不符 企业ID不符 40404 企业签名时间与工行服务器时间间隔过长 企业的签名时间与转帐请求到达工行应用服务器的时间相差超过15分钟,则工行认为此交易数据有可能在途中Copyright 中国工商银行北京软件研发部 2004 74

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 被篡改,不进行结算类处理。 签名数据文件重复 xml解包错误 40405 40406 签名数据包重复 xml解包错误 40407 存储签名文件失败 存储签名文件失败 40408 企业签名时间与工行时间不符 该批指令笔数大于??条的,请分批提交 提交的“总笔数”与实际笔数不符 提交的“总金额”与实际金额和不符 插入银企互联代收代付文件表失败 收款帐号不在定向汇款列表中 40409 40410 40411 40412 40413 40414 40415 收付款帐号不是人民币帐户 必输项输入有误 40416 40417 查询代收代付返回包中“errMsg”字段信息 查看“errMsg”字段中的相关信息 对不起,此交易当天只能做??次 企业签名时间与工行时间不符(快5分钟) 一批指令不能大于工行系统规定的笔数 Xml包中“总笔数”标签的数值与提交的笔数不符 Xml包中“总金额”标签的数值与提交的金额和不一致 工行数据库操作异常所致 此付款帐号在银行系统中设定了定向汇款功能,但收款帐号不在定向汇款列表中 系统暂不支持外币结算业务 结算类交易必输项输入为空或未按规定输入 本批次被全部拒绝处理 总笔数、总金额或某笔交易中金额项有非法字符 由于某些交易数据非常大且不会经常进行更新,所以需控制交易每天下载次数 工资单提交数据收入项目名称标签中“|”之间有空项 工资单提交数据中重新打包签名发送请求 检查发送xml包格式,重新打包发送请求 与工行联系,检查签名文件路径,重新打包签名发送请求 调整企业端服务器时间,重新打包签名发送请求 分批提交 核对笔数后重新提交 核对金额后重新提交 重新发送此批交易 与当地行联系在银行内部管理系统中,核对此企业ID的定向汇款列表中是否加入收款帐号 更换收付款帐号 检查转帐交易提交包中必输项是否正确输入 根据errMsg字段中的错误信息进行改正 检查相关项的输入数据,去掉非法字符 请隔日再进行下载 40419 40420 收入项目名称之间不能有空项! 去掉或填充该项“|”之间的内容 40421 收入项目数与收入项检查并重新填写上Copyright 中国工商银行北京软件研发部 2004 75

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 诉两标签的内容 目名称数目不一致! 40422 40423 40424 40425 40427 40428 40429 40430 40431 40432 40433 40434 40435 标签中项目个数与输入数字不符 支出项目名称之间不同40420错误,标签能有空项! 为 支出项目数与支出项同40421错误,标签目名称数目不一致! 为 收入项目金额之间不工资单提交数据收能有空项! 入项目金额标签中“|”之间有空项 收入项目数与收入项工资单提交数据中目金额数目不一致! 标签中金额个数与输入数字不符 支出项目金额之间不同40424错误,标签能有空项! 为 支出项目数与支出项同40425错误,标签目金额数目不一致! 为 收入或支出项目数个工资单提交数据中数有误! 标签的输入值范围为1--18 您的商城类型与该交商城提交的易不符 值与在网银注册的商城类别不符,如商城提交的该值是1(B2B商城),而在网银注册的是B2C商城 您的商城id无对应的商城注册的证书ID操作权限 没有所做交易的权限(查询、退货等) 商城代码、类型有误根据商城提交的代或商城状态非正常 码、类型在网银未找到状态正常的相关商城信息 商城代码、ID或商城根据商城代码、ID账号有误 和商城账号在网银中未找到商城ID的操作权限 该交易不支持此类卡 个人联名卡签权交易不支持所有卡种 转付交易请上送转付B2C转付交易需上人名称和转付账号数送转付人名称和账据 号/卡号 同40420错误 同40421错误 去掉或填充该项“|”之间的内容 检查并重新填写上诉两标签的内容 同40424错误 同40425错误 检查并修改相关标签中数值范围 请与当地工行进行确认或修改的数值 请与当地工行进行确认或修改相关交易 请确认上送的商城代码、类型是否正确 请确认上送的数据是否正确 请确认卡号是否输入正确或更换卡号 检查并补填相关数据 Copyright 中国工商银行北京软件研发部 2004 76

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 查看企业代码是否输入正确或与当地工行进行确认 请与当地工行进行确认 更换账号\\卡号或与当地工行进行确认 请确认交易类型或联系当地工行开通此交易权限 请检查订单号信息输入是否正确 请联系当地行解决此问题 请检查上送数据包中的相关数据是否正确 请确认转付金额的数值 请检查订单号信息是否正确 请检查订单号信息输入是否正确 40436 未开通鉴权功能或者未审核通过 40437 40438 40439 40440 41055 41056 41057 41058 41059 41060 41061 41063 该企业未在工行开通个人鉴权功能或企业状态非正常 超过企业日鉴权次数企业当日鉴权次数 (执行该交易)超过预先设定的额度 超过企业对个人日鉴企业当日签权某账权次数 号/卡号的次数超过预先设定的额度 您的商城id未开通返商城ID在做B2B、还权限 B2C返还交易时必须具有返还权限 B2B订单支付未成B2B原订单指令状功,不能退货或返还 态非正常不能进行退货、返还操作 总行参数有效天数设退货、返还、转付交置有误 易的有效时间参数包含非法字符 上送商城类型或者交B2B、B2C退货、返易类型错误 还、转付交易中的商城类型或交易类型数值未按规定上送 上送转付金额超过B2C转付的金额必B2C转付单笔限须控制在提示金额额??元 范围内 收付款行信息有误 根据订单号查询出的收付方信息有错误 订单支付未成功,不B2C原订单指令状能退货、返还和转付 态非正常不能进行退货、返还或转付操作 上送商城账号与支付B2B退货、返还交指令的收款账号不符 易中商城账号必须与原订单中的收款账号一致 B2C转付上送转付账B2C转付交易上送号有误 的转付账号/卡号有错误 订单超过有效操作期B2C退货、返还、限 转付交易必须在规定期限内进行 交易金额有误 累积退货、返还或者转付金额超过了订单总金额 B2B支付速度上送数据有误 B2C交易提交金额为空或有非法字符 该订单反交易的金额累计已超过原订单的金额 B2B退货、返还交易中支付速度一值请检查商城账号或订单号输入是否正确 请检查上送数据包中的转付账号是否正确 请咨询当地行所做交易的期限时间或检查交易数据是否正确 请检查交易金额数据是否正确 请检查交易数据是否正确 请检查该字段数值 410 40872 40873 Copyright 中国工商银行北京软件研发部 2004 77

Industrial and Commercial Bank of China 中国工商银行银企互联系统接口说明 非法 B2C转付交易收方账号不在支持的卡请检查转付账号或咨询当地行 40874 B2C转付交易不支持此卡种 其他

Copyright 类型范围内 与企业网上银行相 同 2004 78

中国工商银行北京软件研发部

因篇幅问题不能全部显示,请点此查看更多更全内容

Copyright © 2019- 91gzw.com 版权所有 湘ICP备2023023988号-2

违法及侵权请联系:TEL:199 18 7713 E-MAIL:2724546146@qq.com

本站由北京市万商天勤律师事务所王兴未律师提供法律服务