下载文档原格式
中信银行银企直联接口使用规范（必读）版本V1.0.0.0目录一、概述 (1)1.1文档用途 (1)1.2适用对象 (1)二、报文结构 (1)2.1 HTTP请求报文 (1)2.2 HTTP响应报文 (1)三、报文定义规则 (1)3.1 XML报文格式 (1)3.2响应报文说明 (2)3.3响应码 (2)3.3.1客户端响应码 (3)3.3.2服务器端响应码 (3)四、典型交易说明 (4)4.1动账类 (4)4.2查询类 (4)一、概述1.1文档用途此文档作为银企直联客户的必读手册，用于说明中信银行银企直联系统的接口规范。
银企直联客户须严格按照该规范使用银企直联接口，避免因接口使用不当导致重复动账、资金损失。
1.2适用对象中信银行银企直联客户。
二、报文结构在企业内部局域网环境内，报文的传输方式采用HTTP协议。
HTTP报文包括企业内部系统向前置服务器（客户端软件）的请求报文以及前置服务器（客户端软件）向企业内部系统的响应报文，均由HTTP报文头与HTTP报文体两部分构成。
2.1 HTTP请求报文HTTP请求报文由HTTP报文头（请求行、通用信息、请求头、实体头)、回车换行（CRLF）、HTTP报文体构成。
HTTP请求报文采用POST方式提交。
HTTP报文体为报文接口定义的请求报文数据（XML报文数据）。
2.2 HTTP响应报文前置服务器处理HTTP请求报文后，返回HTTP响应报文至企业内部系统。
HTTP响应报文由HTTP报文头（状态行、通用信息、响应头、实体头）、回车换行（CRLF）、HTTP报文体构成。
HTTP报文体为报文接口定义的响应报文数据（XML报文数据）。
三、报文定义规则3.1 XML报文格式所有XML报文均遵循以下数据格式：<?xml version="1.0" encoding="GBK"?><stream><key1>value1</key1><key2>value2</key2><list name="userDataList"><row><key3>value3</key3>…</row></list></stream>。
招商银行直联系统开发指南version 2.1修订记录日期修订版本修订人修订内容2010-10-18 1.0.0 杨成海新建2011-9-27 1.0.1 徐蓓FBSDK3.3发布，修改版本信息，更新5.1版本信息和6.1接口文档2011-11-21 1.0.2 徐蓓FBSDK3.4发布，修改版本信息，更新5.1版本信息和6.1接口文档2012-02-23 1.0.3 徐蓓FBSDK3.5发布，修改版本信息，更新5.1版本信息和6.1接口文档2012-04-13 1.0.4 徐蓓FBSDK3.6发布，修改版本信息，更新5.1版本信息和6.1接口文档2013-4-2 1.0.6 杨成海FBSDK3.8发布，更新5.1版本信息和6.1接口文档2013-4-18 2.0.0 杨成海FBSDK5.0发布，更新3.1.3菜单功能说明、5.1版本信息和6.1接口文档.删除原4.3.6国内信用证接口2013-4-19 2.0.1 杨成海FBSDK5.1发布，增加二代KEY支持。
2013-7-9 2.0.2 徐蓓增加供应链金融功能（增加附录6.6）。
修改了票据通的业务接口（附录6.3的接口文档）；修改5.1版本信息；2013-8-15 2.0.3 杨成海增加公司理财业务接口（附录6.1）；更新供应链接口文档V1.1（附录6.6）；修改5.1版本信息;2013-9-3 2.0.4 徐蓓修改人民币现金池业务接口（附录6.1）；更新供应链接口文档V1.2（附录6.6）；修改5.1版本信息;2013-9-12 2.0.5 杨成海增加记账宝接口（附录6.1）；修改5.1版本信息;2013-10-10 2.0.6 徐蓓FBSDK5.2发布；增加对跨境账户视图功能的支持（附录6.1）；修改5.1版本信息; 修改5.3的版本查看方式。
2013-10-29 2.0.7 杨成海更新6.1接口文档2013-10-30 2.0.8 徐蓓更新供应链接口文档V1.3（附录6.6）；修改5.1版本信息2013-11-20 2.0.9 杨成海(1)代发代扣业务增加“代发工资额度查询接口”(2)修改公司理财业务接口详情见附录6.1。
531银企直联通讯机安装配置手册概述531新网银上线后，提供的直联服务与老的直联有区别，因此必须使用新的直联通讯机。
为了新老版本切换方便，直联升级版531银企直联通讯机，即支持老的银企直联,也支持531银企直联.通讯机安装1．在安装包中找到Setup。
exe 双击，开始安装NetCS,如下图所示：如果已经安装过网银企业端通讯机，先选择‘卸载’。
卸载完成后再运行Setup。
exe安装NetCS。
2．选择“安装"按钮，单击“下一步"，进入如下界面：3．选择安装目录后，单击“安装”，进入如下界面：4．单击安装按钮，系统开始安装,出来如下对话框选择Yes，立即启动NetCS选择No,安装完成,可通过桌面快捷方式或开始菜单程序启动NetCS。
通讯机配置主要文件说明NetCS.exe：该文件位于bin目录下，是531直联通讯机主程序。
txpz。
ini：该文件位于etc目录下,是老的直联通讯机系统参数配置文件。
txpz_531。
ini：该文件位于etc目录下,是531直联通讯机系统参数配置文件.log［yyyyMMdd]。
txt：该文件位于log目录下，是通讯机交易日志文件，每天产生一个文件.ErrLog[yyyyMMdd］。
txt：该文件位于log目录下，是通讯机交易错误日志文件，每天产生一个文件。
配置说明1.运行“网银企业端通讯机”，如下图所示：2．先不要启动服务，单击“配置"按钮，系统弹出系统安全密码验证窗口，如下图所示: 3．输入安全密码（默认为1)，确定，验证通过后弹出系统参数配置界面，如下图所示：(图中配置非生产环境配置参数，具体参见参数部分）通讯配置主要提供通讯机与银行通信的IP地址、端口及本机通讯参数的设置功能以下为各配置项目说明:银行参数银行IP:不可任意设定，此处填入银行端签名服务器的IP地.如有问题，可以向银行咨询。
银行交易端口：不可任意设定，此处填入银行端签名服务器的交易端口。
第二十章支付系统业务第七节银企直联系统业务一、基本规定1、银企直联银行端操作员角色类型分为总行级操作员和网点级操作员，总行级操作员分为特权录入员和特权复核员，特权录入员对应柜面系统的总行管理员，特权复核员对应柜面系统的总行管理主管。
网点级操作员分为普通录入员和普通复核员，普通录入员对应柜面系统的综合柜员，普通复核员对应柜面系统的网点业务主管。
2、总行管理员设置网点级操作员。
总行管理员和总行管理主管有权操作机构管理、机构权限管理、柜员权限管理、复核审批设置和综合查询等。
综合柜员和网点业务主管有权操作客户管理、客户权限管理、账户管理、账户权限管理、用户管理、企业收费管理等。
3、银行端操作员使用柜面系统的柜员号、密码和指纹登录系统。
登录界面如图：二、银行机构增加（一）业务审核无（二）业务操作1、该交易主要提供总行管理员增加银行机构相关信息功能。
上级机构可选，输入机构代码和名称，机构级别系统默认。
如图：（三）会计分录无（四）回单处理无（五）注意事项无三、银行机构修改（一）业务审核无（二）业务操作1、该交易主要提供总行管理员修改银行机构相关信息功能。
选择需修改机构，点击“修改”，只允许修改机构名称。
如图：（三）会计分录无（四）回单处理无（五）注意事项无四、银行机构注销（一）业务审核无（二）业务操作1、该交易主要提供总行管理员注销银行机构相关信息功能。
选择需注销机构，点击“注销”。
如图：（三）会计分录无（四）回单处理无（五）注意事项无五、支付行设置（一）业务审核无（二）业务操作1、该交易主要提供总行管理员维护支付行信息功能。
如图：（三）会计分录无（四）回单处理无（五）注意事项无六、银行机构权限模版设置（一）业务审核无（二）业务操作1、该交易主要提供总行管理员维护银行机构模版权限功能，供快速设置权限时，基于模版功能之用。
如图：（三）会计分录无（四）回单处理无（五）注意事项无七、银行机构权限设置（一）业务审核无（二）业务操作1、该交易主要提供总行管理员设置银行机构权限功能。
第 1 章概述银企互联面向大的集团客户，提供与企业ERP系统直连的平台，银企互联面向大的集团客户，提供与企业ERP系统直连的平台，为工行的现金管理服务提供多渠道和客户化支持。
企业ERP系统通过HTTPS协议与工行系统进行连接并向银企互联前置发送数据，数据的接口格式使用标准的xml数据格式，但双方通讯的过程中则需要遵守下文描述的规定。
银企互联前置接到企业数据后进行一系列的检查后完成交易，并将处理结果以企业便于处理的形式返回给企业。
在安全保证方面，通讯层的安全保证是HTTPS协议。
企业如需使用银企互联系统，要办理有关注册手续，并审领证书。
企业进行结算类交易时，如果涉及到授权过程，企业需要在企业网银系统中完成相关授权动作。
银企互连系统将企业提交的支付指令或者授权成功后的指令当作最终转账指令，根据提交指令的证书ID检查收付方帐号等合法性，以保证所提交指令在权限允许范围内进行操作。
第 2 章总体方案介绍2.1总体网络结构图银企互联系统上图企业ERP系统1采用的是非NC方式接入的客户；企业ERP系统2采用的是NC方式接入的客户；2.2企业端安全服务器简介此服务器只对使用NC方式接入的客户有效。
企业端安全服务器被称为NetSafe Client。
它有两个可以配置的端口分别用于加密和签名／验签服务，如下图所示（假设１为加密端口，２为签名／验签端口）。
具体使用时，企业应用向工行提交交易请求时，可以依照http协议向NetSafe Client 的端口１发送请求。
接到请求后，NetSafe Client使用企业证书将http请求包转换成https请求包发往工行端服务器；如果需要对某些交易数据进行签名，则企业应用需要与签名端口建立Socket 连接并将待签名数据发往端口２，然后接收端口２的签名结果，之后再将包含签名信息的交易请求发往端口１而完成整个交易请求过程。
对签名还是验签名请求的区分则是通过http包头来进行。
Content-Type: INFOSEC_SIGN/1.0和Content-Type: INFOSEC_VERIFY_SIGN/1.0分别用于标识签名请求和验签名请求，而Content-Type: INFOSEC_SIGN_RESULT/1.0和Content-Type: INFOSEC_VERIFY_SIGN_RESULT/1.0分别用于标识签名和验签名的返回结果。
