企业联机接口技术方案v10.doc

国家外汇管理局 企业联机接口技术方案 版本号：V1.0 国家外汇管理局 2015年2月 目录 1. 前言 2 1.1. 目标 2 1.2. 企业联机接口概述 2 2. 接口分析 3 2.1. 总体业务处理流程 3 2.2. 接口业务处理范围 3 2.3. 接口开放时间 4 3. 物理连接说明 5 4. 应用连接说明 6 4.1. 应用连接结构图 6 4.2. 应用连接接口处理模式 6 4.3. 接口应用系统配置约定 7 4.4. 接口应用系统开发约定 7 5. 接口报文说明 8 6. 接口安全管理 9 6.1. 企业内部权限管理 9 6.2. 用户身份认证和权限控制 9 6.3. 报文权限控制 9 6.4. 报文加密 10 6.5. 审计追踪 10 6.6. 网络安全 10 7. 企业端接口程序样例 11 7.1. 基于Java平台样例： 11 7.2. 基于.net平台样例： 11 前言 目标 本方案的目标是描述国家外汇管理局货物贸易外汇监测系统、国际收支网上申报系统与企业自身业务系统之间的联机接口实现方法。企业可以依据本技术方案和《货物贸易外汇监测系统企业联机接口报文规范》、《国际收支网上申报系统企业联机接口报文规范》进行接口设计开发。 企业联机接口概述 国家外汇管理局企业联机接口提供一组基于XML格式的接口报文，实现企业自身业务系统与国家外汇管理局货物贸易外汇监测系统、国际收支网上申报系统（以下简称“外汇局业务系统”）的对接。 企业可以自主选择通过国家外汇管理局应用服务平台（ASOne）和企业联机接口两种方式访问使用外汇局业务系统，两种方式接入办理的业务功能和流程逻辑完全一致。 国家外汇管理局企业联机接口采用SOAP/HTTPS通讯接入方式。企业前置系统按照报文规范，发送和接收相应的报文，与外汇局业务系统进行信息交换。 接口分析 总体业务处理流程 目前，本接口方案中和企业有关的业务主要是实时类的查询和交易业务。 处理流程 图1：业务处理流程 如图1中，存在以下处理流程： 企业自身业务系统发起某类业务的总流程为： (A1) 企业自身业务系统向外汇局业务系统发起请求； (A2)外汇局业务系统对请求进行处理后将请求响应结果发送给企业自身业务系统； 接口业务处理范围 货物贸易外汇监测系统与企业自身业务系统的接口业务处理范围主要包括贸易核查基础数据查询、贸易信贷报告等。具体报文格式及填写要求参见《货物贸易外汇监测系统企业联机接口报文规范》。 国际收支网上申报系统与企业自身业务系统的接口业务处理范围主要包括涉外收入申报、境内收入申报等。具体报文格式及填写要求参见《国际收支网上申报系统企业联机接口报文规范》。 接口开放时间 货物贸易外汇监测系统、国际收支网上申报系统通过应用服务平台（ASOne）和企业联机接口两种方式提供的对外开放时间保持一致。目前，货物贸易外汇监测系统对外开放时间为工作日的8:00-20:00，企业自身业务系统在接口开放时间之外不能发起对外汇局业务系统的访问请求。 物理连接说明 如图2所示 图2 物理连接结构图 说明： 企业自身业务系统和外汇局企业接口接入平台进行连接 外汇局企业接口接入平台和外汇局业务系统连接。 企业自身业务系统和外汇局业务系统的信息通讯通过外汇局企业接口接入平台中转。 应用连接说明 应用连接结构图 图3 应用连接结构图 外汇局业务系统与企业自身业务系统之间的应用连接结构如图3所示，外汇局业务系统提供给企业自身业务系统的前置系统一组XML报文，以实现企业自身业务系统与外汇局业务系统的对接。企业自身业务系统的前置系统由企业自行开发。 企业自身业务系统使用HTTPS协议发送SOAP报文至外汇局业务系统，然后得到该请求报文对应的回执报文。 应用连接接口处理模式 企业自身业务系统与外汇局业务系统之间的联机交易模式为企业发送同步处理模式，具体如下： 图5 企业发送同步处理模式 说明： 1.企业自身业务系统通过HTTPS协议将SOAP报文给外汇局业务系统； 2.外汇局业务系统接收后，及时处理，在处理结束后立即将处理结果发送给企业自身业务系统。 接口应用系统配置约定 超时时间:超时时间大于报文传递路径上所耗总时间、根据测试结果确定。 报文重发次数:由于HTTP传输时不可靠传输，报文发送失败时，应该有自动重发机制。 HTTPS建立连接时需要握手交换Key，此操作消耗资源，对于批量操作要使用长连接，提高性能。 接口应用系统开发约定 无论各联网单位采用何种语言开发应用系统，在发送报文时使用GBK编码。 接口报文说明 参见文档《货物贸易外汇监测系统企业联机接口报文规范》和《国际收支网上申报系统企业联机接口报文规范》。 接口安全管理 为了保障联网单位之间信息处理和信息传递的安全、准确和及时，各企业自身业务系