货物贸易外汇监测系统.DOC

1、 第 1 页 货物贸易外汇监测系统 企业联机接口报文规范 版本号： V1.0 国家外汇管理局 2015 年 2 月 第 2 页 变更履历 修改编号 版本 修改内容 修改人 修改日期 第 3 页 目 录 1 范围 . 4 2 术语和接口说明 . 4 3 要求 . 4 3.1 数据 类型定义 .4 3.2 数据处理规则 .5 3.3 报文格式校验 .5 4 接口格式概述 . 6 4.1 报文接口格式结构 .6 5 报文格式说明 . 7 5.1 实时业务类 .7 6 集团企业数据权限说明 . 12 7 报文定义 . 12 7.1 基础业务数据查询 . 14 7.2 预收 /预付报告 . 21 7.3

2、 延收 /延付报告 . 27 7.4 转口贸易收支时间差报告 . 34 7.5 多收汇 /多付汇差额报告 . 39 7.6 多进口 /多出口差额报告 . 43 7.7 其他特殊交易报告 . 46 7.8 出口收入存放境外报告 . 51 7.9 企业信息查询 . 65 7.10 业务指标情况查询服务 . 66 7.11 业务汇总数据查询 . 71 7.12 现场核查 . 72 7.13 信息交互 . 74 7.14 登记表业务 . 77 8 报文样例 . 83 9 SCHEMA 校验文件 . 83 10 数据字典 . 83 10.1 收汇性质 . 83 10.2 付汇性质 . 84 10.3 结

3、算方式 . 84 10.4 涉外收支交易代码 . 84 10.5 贸易方式 . 84 10.6 登记表类别 . 87 10.7 登记表状态 . 87 10.8 差额原因代码 . 87 11 错误编码与错误名称对应表 . 88 第 4 页 1 范围 货物贸易外汇监测系统企业联机接口报文规范 ，规定了 国家外汇管理局 （以下简称“外汇局”）货物贸易外汇监测系统 与 企业自身业务 系统进行 联机实时 业务交互 时，应采用的报文格式 和规范 。 2 术语和 接口说明 标识符 ：唯 一标识报文中一个数据项或者节点项的代码。 报文： 用于 外汇局 与联网机构间交换信息的载体。 报文头 ：报文通讯使用的基本

4、信息。 XML节点 TAG：某一段数据域的标识，比如报文头、 用户信息 等，用于组织报文中节点项的代码。 节点代码 ：为了方便管理，对于接入的 机构 ， 由外汇局进行编码 并分配给接入 单位 使用。 对于企业，节点代码采用“组织机构代码证”的代码，共 9位 。 3 要求 3.1 数据类型定义 3.1.1 字符集 x-字符集由以下 87个字符组成： a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 .

5、 , - ( ) / = + ? ! “ ” % # (cr) (lf) (space) 对于使用 TCP/IP协议的系统， x-字符集的编码（字符的二进制编码）适用于 ISO-2022（ ASCII） 3.1.2 符号约定 符号 说明 String 表示由 x-字符集组成的字符串，如： PbcGkjCfcc 第 5 页 NString 表示由数字 0-9组成的字符串，如： 000045 GBString 表示由 GBK 字符集组成的字符串，报文规范中的长度定义以字节为单位，如： 商业 Currency 表示金额，符号位可选，整数部分最长 15 位，小数部分固定两位，不能包含逗号等分隔符，如：

6、 8979.05 Integer 表示整数，符号位可选，数值部分最长 8 位，如： 88888 Decimal 表示实数，如 ： 655785.5676 Long 表示日期 。 日期是毫秒数， 毫秒数是根据 1970-1-1 为参照值，由参数日期减去参照值将结果转换为毫秒数得来的 如： 1333248494648 Date 表示日期，格式为 yyyy-mm-dd（年月日）。如： 2005-06-11 Time 表示时间，格式为 HH:MM:SS（时分秒）。如： 11 :28:21 DateTime 表示日期时间，格式为 yyyy-mm-dd HH:MM:SS（年月日时分秒）。 如： 2005-

7、06-11 11:27:39 HexBinary 表示按十六进制编码 ,的二进制数据，如： 4F59B25A Boolean 表示布尔值 (true 或 false)，如： true 3.2 数据处理规则 (1) 对于每个字段所填内容，在后面的章节中针对不同报文将具体说明。 (2) 当“长度”是 n时表示此域出现时，长度固定为 n个字符；当“长度”是 1,n时表示此域出现时，其最小长度为 1个字符，其最大长度为 n个字符。 (3) 当“强制 /可选”是 M时，表示此要素为强制项，必须出现；当“强制 /可选”是 O时，表示此要素为可选项，根据业务要求填制，不必须出现，但一旦出现，则其中内容必须出

8、现，不可为空。 3.3 报文格式校验 本规范 对 XML格式的请求报文提供了 Schema校验文件，请求方 系统 在发起请求前需要根据Schema文件对请求报文进行格式校验。 第 6 页 4 接口格式概述 国家外汇管理局业务信息系统 与 企业 接入机构通过报文进行联机交互 。 4.1 报文接口格式结构 4.1.1 报文结构 4.1.1.1 参考原则 4.1.1.1.1 规范原则 所有数据报文使用 XML 进行描述（有特殊说明的部分以说明为准）。 4.1.1.1.2 高效性原则 由于 国家外汇管理局业务信息系统 对 报文进行 实时 处理，因此将追求效率作为首要目标。 4.1.1.1.3 易读性原

9、则 在保证报文交换和处理高效的前提下，尽可能提高报文的易读性，以利于系统测 试和联调。 4.1.1.2 结构说明 报文结构如下图所示： 域 1C o m p o e n t组 件M e s s a g e报 文H e a d e r报 文 头B o d y报 文 体T a i l报 文 尾域 2域 3域 块域 块域 1 0域 块R e p e a t i n g G r o u p重 复 组G r o u p B l o c k 1组 块 1G r o u p B l o c k 2组 块 2G r o u p B l o c k n组 块 n域域 块域 块域域 块域域 块组 块： 表 示 重

10、 复 组 中 每 块重 复 部 分 ， 也 是 由 域块 组 成域： 表 示 某 个 域域 块： 表 示 多 个 域 集 合重 复 组： 表 示 重 复 组 ， 可 由多 个 重 复 组 块 组 成组 件： 表 示 多 个 域 的 集合 ， 这 些 域 所 代 表的 含 义 之 间 具 有 关联 性说明 ：总体上，报文全部内容封装在一个 XML 报文中，报文分为三大部分：报文头、报文体 及 报文尾 。 报文头部分 报文头部分用于标识 XML 报文的基本属性，包括 报文版本号 、 机构类型 、 发起节点代码、接收节点代码、 发送方系统标识 、 接收方系统标识、 用户信息、 发送时间 等 等信息

11、。 第 7 页 报文体部分 报文体部分 是 业务信息 ， 包括 业务参数 、 数据集合两 部分 。 报文尾 部分 数字签名部分用于存放报文的数字签名信息，用于交易参与方的身份认证。算法 对报文开始（即从 行开始）至 之间的全部内容（不包括 报文尾信息 ）进行签名，并以 XML 注释的形式存储于原 XML 报文的尾部。 校验和 通常在通信过程中保证内容的完整性和准确性。发送端通过对报文内容运用特定算法计算得出校验和，接收端接收到报文后也对报文进行同样的计算，如果结果一致则代表内容没被改变。 注：标准 XML 报文首位字符不允许出现空格等字符，应以 报文头内容 报文体内容 报文尾 组件 组件是一个

12、逻辑概念，它用来表示一组彼此之间有一定关系的消息域的组合。这些组件在协议中都赋以相应的名称，用来更好的理解消息结构以及所应用的场景。在实际消息传送过程中，这些组件名称并不会作为信息消息中出现，可以这么说，组件的出现是起到更好让人能够理解消息结构的作用。 重复组 域可以在重复组里多次重复，用以传输数组同类的数据。 在协议中，重复组也同样是一个逻辑概念，它用来表示一组彼此之间有一定关系的消息域的组合能够连续反复地在消息中出现。 5 报文 格式 说明 5.1 实时业务类 此类报文主要包含 请求 报文 和 回执报文 。 第 8 页 5.1.1 请求 报文格式 5.1.1.1 报文格式 通 讯 基 本

13、信 息公 共 参 数 信 息业 务 数 据 集 合报 文 尾报 文 体业 务 参 数 信 息 业 务 数 据 信 息 （ 0 , N ）分 页 信 息报 文 头控 制 信 息说明 ： 请求报文由 报文头、 报文体、报文尾组成。报文头包括 报文通讯使用的基本信息 和控制信息 ；报文体包括 公共参数 和 业务数据集合 ， 而业务数据信息又 包括 分页信息、 业务参数 信息 和 业务数据 信息 ； 报文尾是数字签名和校验和信息 。 5.1.1.2 数据项 5.1.1.2.1 报文头 XML 节点 TAG： MSG-HEAD 标识符 字段名称 类型 长度 备注 强制 /可选 VER 报文版本号 NSt

14、ring 1,4 当前为 2014 M COMMON_ORG_TYPE 机构类型 NString 1,4 1：外汇局、 2：银行、 3：企业。 M SRC 发起节点代码 NString 4 或 9 企业：组织机构代码 M DES 接收节点代码 NString 6 外汇局：默认 100000 M SRCAPP 发送端应用代码 String 1,100 发送端应用名称 ，由报文的发起方自行控制 O DESAPP 接收端应用代码 String 1,100 接收端应用名称， 例如货物贸易外汇监测系统为 TMIS M SENDTIME 发送时间 DateTime 报文发送时间 M 第 9 页 COMMO

15、N_ORG_CODE 机构代码 String 1,40 企业：组织机构代码 M COMMON_USER_CODE 用户代码 String 1,40 用户代码 M PASSWORD 密码 String 1,50 密码（ 明文密码需经MD5（ 32 位，小写） 加密） M SERVICEPATH 访问服务信息 String 5,100 服务名称 +“ .” +方法名称 M MSGNO 报文 参考号 String 1,33 企业： 组织机构代码 +年月日 +8 位唯一代码 M 5.1.1.2.2 报文体 公共参数信息 XML 节点 TAG： MSG-BODY-PARAMETERS 说明： 此节点是业

16、务公共参数位置 ,主要用于非分页查询和写操作时传参，参数的详细定义见本文档报文的定义部分 。 数据集 信息 XML 节点 TAG ： MSG-BODY-DATASTORES-DS1 标识符 数据项名称 类型 长度 数据项描述 强制 /可选 PAGESIZE 每页条数 NString 1,10 最大不能超过 1000 条 M PAGENUMBER 页码 NString 1,10 当前是多少页 M 说明： 对于分页查询，以上内容是必输，如果不输入 PAGESIZE 值默认是 1000；对于非分页查询和写操作，以上内容无需存在 。 XML 节点 TAG ： MSG-BODY-DATASTORES-D

17、S-PARAMETERS 说明： PARAMETERS 下是业务参数，此节点下的参数为非必输参数 ，此节点下的参数为非必输参数 ，此节点为分页查询和写操作 入参位置 。 第 10 页 XML 节点 TAG ： MSG-BODY-DATASTORES-DS-ROWSET 标识符 数据项名称 类型 长度 数据项描述 强制 /可选 ROW 数据集 GBString 数据集，可循环出现 O 说明： ROW可以重复出现 ，详细定义见本文档对报文的定义部分 。 5.1.1.2.3 报文尾 XML 节点 TAG ： MSG- TAIL 标识符 数据项名称 类型 长度 数据项描述 强制 /可选 SIGNATU

18、RE 数字签名 String 0,300 暂不使用 O CHECKSUM 预留字段 String 0,300 暂不使用 O 5.1.2 回执报文格式 5.1.2.1 报文格式 通 讯 基 本 信 息公 共 参 数 信 息业 务 数 据 集 合报 文 尾报 文 体业 务 参 数 信 息 业 务 数 据 信 息 （ 0 , N ）分 页 信 息报 文 头请 求 状 态 信 息说明 ： 由一个报文头、一个 回执 信息 、 报文尾 构成。 5.1.2.2 数据项 5.1.2.2.1 报文头 XML 节点 TAG： MSG-HEAD 标识符 字段名称 类型 长度 备注 强制 /可选 VER 报文版本号 NString 1,4 当前为 2014 M SRC 发起节点代码 NString 6 外汇局：默认 100000 M