1、 第 1 页货 物 贸 易 外 汇 监 测 系 统企 业 联 机 接 口 报 文 规 范版 本 号 ： V1.0国 家 外 汇 管 理 局2015 年 2 月变更履历第 2 页修改编号 版本 修改内容 修改人 修改日期目 录1 范围 .4第 3 页2 术语和接口说明 .43 要求 .43.1 数据类型定义 43.2 数据处理规则 53.3 报文格式校验 54 接口格式概述 .64.1 报文接口格式结构 65 报文格式说明 .75.1 实时业务类 76 集团企业数据权限说明 .127 报文定义 .127.1 基础业务数据查询 147.2 预收 /预付报告 .217.3 延收 /延付报告 .277
2、.4 转口贸易收支时间差报告 347.5 多收汇 /多付汇差额报告 .397.6 多进口 /多出口差额报告 .437.7 其他特殊交易报告 467.8 出口收入存放境外报告 517.9 企业信息查询 657.10 业务指标情况查询服务 667.11 业务汇总数据查询 717.12 现场核查 727.13 信息交互 747.14 登记表业务 778 报文样例 .839 SCHEMA 校验文件 .8310 数据字典 .8310.1 收汇性质 8310.2 付汇性质 8410.3 结算方式 8410.4 涉外收支交易代码 8410.5 贸易方式 8410.6 登记表类别 8710.7 登记表状态 8
3、710.8 差额原因代码 8711 错误编码与错误名称对应表 .881 范围第 4 页货物贸易外汇监测系统企业联机接口报文规范，规定了国家外汇管理局（以下简称“外汇局”）货物贸易外汇监测系统与企业自身业务系统进行联机实时业务交互时，应采用的报文格式和规范。2 术语和接口说明 标识符：唯一标识报文中一个数据项或者节点项的代码。 报文：用于外汇局与联网机构间交换信息的载体。 报文头：报文通讯使用的基本信息。 XML节点TAG：某一段数据域的标识，比如报文头、用户信息等，用于组织报文中节点项的代码。 节点代码：为了方便管理，对于接入的机构，由外汇局进行编码并分配给接入单位使用。对于企业，节点代码采用
4、“组织机构代码证”的代码，共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 zA B C D E F G H I J K L M N O P Q R S T U V W X Y Z0 1 2 3 4 5 6 7 8 9 . , - ( ) / = + ? ! “ ” % #(cr) (lf) (space)对于使用TCP/IP协议的系统， x-字符集的编码（字符的二进制编码）适用于 ISO-2022（ASCII）3.1.2 符号约定符号 说明String 表示
5、由 x-字符集组成的字符串，如： PbcGkjCfccNString 表示由数字0-9组成的字符串，如： 000045GBString 表示由 GBK 字符集组成的字符串，报文规范中的长度定义以字节为单位，如：商业第 5 页Currency 表示金额，符号位可选，整数部分最长 15 位，小数部分固定两位，不能包含逗号等分隔符，如：8979.05Integer 表示整数，符号位可选，数值部分最长 8 位，如：88888Decimal 表示实数，如：655785.5676Long 表示日期。日期是毫秒数，毫秒数是根据 1970-1-1 为参照值，由参数日期减去参照值将结果转换为毫秒数得来的如：13
6、33248494648Date 表示日期，格式为 yyyy-mm-dd（年月日） 。如：2005-06-11Time 表示时间，格式为 HH:MM:SS（时分秒） 。如：11:28:21DateTime 表示日期时间，格式为 yyyy-mm-dd HH:MM:SS（年月日时分秒） 。如：2005-06-11 11:27:39 HexBinary 表示按十六进制编码,的二进制数据，如：4F59B25ABoolean 表示布尔值(true 或 false)，如：true3.2 数据处理规则(1)对于每个字段所填内容，在后面的章节中针对不同报文将具体说明。(2)当“长度”是n时表示此域出现时，长度固
7、定为n个字符；当“长度”是1,n时表示此域出现时，其最小长度为1个字符，其最大长度为n个字符。(3)当“强制/可选”是M时，表示此要素为强制项，必须出现；当“强制/可选”是O时，表示此要素为可选项，根据业务要求填制，不必须出现，但一旦出现，则其中内容必须出现，不可为空。3.3 报文格式校验本规范对XML格式的请求报文提供了 Schema校验文件，请求方系统在发起请求前需要根据Schema文件对请求报文进行格式校验。4 接口格式概述第 6 页国家外汇管理局业务信息系统与企业接入机构通过报文进行联机交互。4.1 报文接口格式结构4.1.1 报文结构4.1.1.1 参考原则4.1.1.1.1 规范原
8、则所有数据报文使用 XML 进行描述（有特殊说明的部分以说明为准） 。4.1.1.1.2 高效性原则由于国家外汇管理局业务信息系统对报文进行实时处理，因此将追求效率作为首要目标。4.1.1.1.3 易读性原则在保证报文交换和处理高效的前提下，尽可能提高报文的易读性，以利于系统测试和联调。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
9、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域域块域块域域块域域块组块： 表示重复组中每块重复部分 ， 也是由域块组成域： 表示某个域域块： 表示多个域集合重复组： 表示重复组 ， 可由多个重复组块组成组件： 表示多个域的集合 ， 这些域所代表的含义之间具有关联性说明：总体上，报文全部内容封装在一个 XML 报文中，报文分为三大部分：报文头、报文体及报文尾。 报文头部分报文头部分用于标识 XML 报文的基本属性，包括报文版本号、机构类型、发起节点代码、接收节点代码、发送方系统标识、接收方系统标识、用户信息、发送时间等等信息。
10、 报文体部分第 7 页报文体部分是业务信息，包括业务参数、数据集合两部分。 报文尾部分数字签名部分用于存放报文的数字签名信息，用于交易参与方的身份认证。算法对报文开始（即从 行开始）至之间的全部内容（不包括报文尾信息）进行签名，并以 XML 注释的形式存储于原 XML 报文的尾部。校验和通常在通信过程中保证内容的完整性和准确性。发送端通过对报文内容运用特定算法计算得出校验和，接收端接收到报文后也对报文进行同样的计算，如果结果一致则代表内容没被改变。注：标准 XML 报文首位字符不允许出现空格等字符，应以 报文头内容 报文体内容 报文尾 组件组件是一个逻辑概念，它用来表示一组彼此之间有一定关系的
11、消息域的组合。这些组件在协议中都赋以相应的名称，用来更好的理解消息结构以及所应用的场景。在实际消息传送过程中，这些组件名称并不会作为信息消息中出现，可以这么说，组件的出现是起到更好让人能够理解消息结构的作用。 重复组域可以在重复组里多次重复，用以传输数组同类的数据。在协议中，重复组也同样是一个逻辑概念，它用来表示一组彼此之间有一定关系的消息域的组合能够连续反复地在消息中出现。5 报文格式说明5.1 实时业务类此类报文主要包含请求报文和回执报文。第 8 页5.1.1 请求报文格式5.1.1.1 报文格式通讯基本信息公共参数信息业务数据集合报文尾报文体业务参数信息 业务数据信息 （ 0 , N ）
12、分页信息报文头控制信息说明：请求报文由报文头、报文体、报文尾组成。报文头包括报文通讯使用的基本信息和控制信息；报文体包括公共参数和业务数据集合，而业务数据信息又包括分页信息、业务参数信息和业务数据信息；报文尾是数字签名和校验和信息。5.1.1.2 数据项5.1.1.2.1 报文头XML 节点 TAG：MSG-HEAD标识符 字段名称 类型 长度 备注 强制/可选VER 报文版本号 NString 1,4 当前为 2014 MCOMMON_ORG_TYPE机构类型 NString 1,4 1：外汇局、2：银行、3：企业。MSRC 发起节点代码NString 4 或 9 企业：组织机构代码 MDE
13、S 接收节点代码NString 6 外汇局：默认 100000 MSRCAPP 发送端应用代码String 1,100 发送端应用名称，由报文的发起方自行控制ODESAPP 接收端应用代码String 1,100 接收端应用名称，例如货物贸易外汇监测系统为 TMISMSENDTIME 发送时间 DateTime报文发送时间 M第 9 页COMMON_ORG_CODE机构代码 String 1,40 企业：组织机构代码 MCOMMON_USER_CODE用户代码 String 1,40 用户代码 MPASSWORD 密码 String 1,50 密码（明文密码需经MD5（32 位，小写）加密）M
14、SERVICEPATH 访问服务信息String 5,100 服务名称+“.”+ 方法名称MMSGNO 报文参考号 String 1,33 企业：组织机构代码+年月日+8 位唯一代码M5.1.1.2.2 报文体公共参数信息XML 节点 TAG：MSG-BODY-PARAMETERS 说明：此节点是业务公共参数位置,主要用于非分页查询和写操作时传参，参数的详细定义见本文档报文的定义部分。数据集信息XML 节点 TAG ：MSG-BODY-DATASTORES-DS1标识符 数据项名称 类型 长度 数据项描述强制/可选PAGESIZE 每页条数 NString 1,10 最大不能超过 1000 条
15、 MPAGENUMBER 页码 NString 1,10 当前是多少页 M说明：对于分页查询，以上内容是必输，如果不输入 PAGESIZE 值默认是 1000；对于非分页查询和写操作，以上内容无需存在。XML 节点 TAG ：MSG-BODY-DATASTORES-DS-PARAMETERS 说明：PARAMETERS 下是业务参数，此节点下的参数为非必输参数，此节点下的参数为非必输参数，此节点为分页查询和写操作入参位置。第 10 页XML 节点 TAG ：MSG-BODY-DATASTORES-DS-ROWSET标识符 数据项名称 类型 长度 数据项描述强制/可选ROW 数据集 GBStri
16、ng 数据集，可循环出现 O说明：ROW可以重复出现，详细定义见本文档对报文的定义部分。5.1.1.2.3 报文尾XML 节点 TAG ：MSG- TAIL标识符 数据项名称 类型 长度 数据项描述强制/可选SIGNATURE 数字签名 String 0,300 暂不使用 OCHECKSUM 预留字段 String 0,300 暂不使用 O5.1.2 回执报文格式 5.1.2.1 报文格式通讯基本信息公共参数信息业务数据集合报文尾报文体业务参数信息 业务数据信息 （ 0 , N ）分页信息报文头请求状态信息说明：由一个报文头、一个回执信息、报文尾构成。5.1.2.2 数据项5.1.2.2.1
17、报文头XML 节点 TAG：MSG-HEAD标识符 字段名称 类型 长度 备注 强制/可选VER 报文版本号 NString 1,4 当前为 2014 MSRC 发起节点代码NString 6 外汇局：默认 100000 M第 11 页DES 接收节点代码NString 4 或 9 企业：组织机构代码 MSRCAPP 发送端应用代码String 1,100 外汇局端应用名称，例如货物贸易外汇监测系统为 TMISMDESAPP 接收端应用代码String 1,100 接收端应用名称，对应请求报文中的发送端应用代码OSENDTIME 发送时间 DateTime报文发送时间 MMSGNO 报文参考号
18、 String 1,33 对应请求报文中的报文参考号MCODE 状态码 NString 1,6 处理成功是 00000，如果错误返回错误码MDETAIL 错误详细信息GBString1,200 错误详细信息 O5.1.2.2.2 报文体XML 节点 TAG ：MSG-BODY-DATASTORES-DS1标识符 数据项名称 类型 长度 数据项描述强制/可选PAGESIZE 每页条数 NString 1,10 最大值为 1000 MPAGENUMBER 页码 NString 1,10 当前是多少页 MRECORDCOUNT 记录总条数 NString 1,10 记录总条数 M说明：DS 为重复组
19、，可以重复出现，但有多个时要有编号，即 DS+i,i 从 1 开始，如,。对于分页查询以上三项为必输项，对于非分页查询以上三项无需存在。XML 节点 TAG ：MSG-BODY-DATASTORES-DS-PARAMETERS 说明：PARAMETERS 下是业务参数，此节点下的参数为非必输参数 ，用于分页查询和写操作时第 12 页存放入参，详细定义见本文档对报文的定义部分。XML 节点 TAG ：MSG-BODY-DATASTORES-DS-ROWSET标识符 数据项名称 类型 长度 数据项描述强制/可选ROW 数据集 String 数据集，可循环出现 O说明：ROW可以重复出现，详细定义见
20、本文档对报文的定义部分。5.1.2.2.3 报文尾XML 节点 TAG ：MSG- TAIL标识符 数据项名称 类型 长度 数据项描述强制/可选SIGNATURE 数字签名 String 0,300 暂不使用 OCHECKSUM 预留字段 String 0,300 暂不使用 O6 集团企业数据权限说明对于集团型企业，主办企业可以查询成员企业的业务数据，但是企业报告等交易业务仍需要以成员企业的身份进行报告。当主办企业调用查询类服务查询成员企业的业务数据时，需要在报文体中填写对应企业的企业代码。集团企业的关联关系需要由主办企业所在外汇局报总局通过“集团企业管理”模块进行登记。7 货物贸易外汇监测系
21、统报文定义货物贸易外汇监测系统通过联机接口向企业提供了 14 个业务领域、共计 53 个 webservice 服务，具体列表如下：业务领域 服务 服务名称doQueryBaseDataRcv 报告对应收汇数据查询doQueryBaseDataPay 报告对应付汇数据查询doQueryBaseDataExp 报告对应出口数据查询基础业务数据查询SafeBaseDataServicedoQueryBaseDataImp 报告对应进口数据查询doAddGoodsAdvancePrepaidReport 预收/预付报告新增doExecuteFirstGoodsAdvancePrepaid 预收/预付
22、报告查询预收/预付报告SafeGoodsServicedoExecuteFirstGoodsAdvancePrepaidReport 预收/预付报告明细查询第 13 页doRemoveGoodsAdvancePrepaidReportByID 预收/预付报告删除doModifyCreditReport 预收/预付报告修改和调整doAddGoodsDelayPayingReport 延收/延付报告新增doExecuteGoodsDelayPaying延收/延付报告查询doExecuteGoodsDelayPayingReport 延收/延付报告明细查询doRemoveGoodsDelayPayi
23、ngByID 延收/延付报告删除延收/延付报告SafeFEServicedoModifyCreditReport 延收/延付报告修改和调整doReExportTradeReportAdd 转口贸易收支时间差报告新增doReExportTradeReportQuery 转口贸易收支时间差报告查询doReExportTradeReportDetailQuery 转口贸易收支时间差报告明细查询doReExportTradeReportDel 转口贸易收支时间差报告删除转口贸易收支时间差报告SafeReExportTradeServicedoReExportTradeReportModify 转口贸易
24、收支时间差报告修改和调整doAdPayRecieveReport 多收汇/多付汇差额报告新增doExcMoreMorePaymentCollectionReport 多收汇/多付汇差额报告查询doModPayRecieveReport 多收汇/多付汇差额报告修改多收汇/多付汇差额报告SafeFEDiffServicedoRemPayRecieveReport 多收汇/多付汇差额报告删除doAdImportExportReport 多进口/多出口差额报告新增doExcPayRecieveReport 多进口/多出口差额报告查询doModImportExportReport 多进口/多出口差额报告
25、修改多进口/多出口差额报告SafeGoodsDiffServicedoRemImportExportReport 多进口/多出口差额报告删除doAdSpecialReport 其他特殊交易报告新增doExcSpeciaExporFEDifftReport 其他特殊性交易收付汇报告查询服务doExcSpeciaExporDifftReport 其他特殊性交易进出口报告查询服务doModSpeciaExportReport 其他特殊交易报告修改其他特殊交易报告SafeSpecTranServicedoRemSpecialExportReport 其他特殊交易报告删除企业信息查询SafeEnterp
26、riseInfoServicedoQueryCorpInfo 企业信息查询业务指标情况查询服务SafeBussTargetServicedoQueryIndexInfo 业务指标情况查询业务汇总业务查询SafeDataServicedoQueryBasicDataInfo 基础业务数据查询doModNoticeMsg 现场核查信息反馈现场核查SafeSiteCheckService doQueryNoticeMsg 现场核查信息查询doAddBankSysbbsmsg 新建留言doQueryBankSysbbsmsg 留言查询信息交互BaseInfoServicedoQuerySafeSysb
27、oardmsg 公告信息查询doQueryRegTradeMark 登记表查询登记表业务SafeRegistTableService doGetRegistTableMark 登记表签注信息查询第 14 页doQueryOutSideAccountReport 境外收支报告查询doQueryOutSideAccountRegistQuery 境外开户查询doAccountNumberQuery 境外开户账号查询doAdAccount 境外开户新增doModAccount 境外开户修改doRemAccount 境外开户删除doAdOutSideReport 境外收支报告新增doModOutSid
28、eReport 境外收支报告修改出口收入存放境外报告SafeForiegnAccountServicedoRemOutSideReport 境外收支报告删除7.1 基础业务数据查询7.1.1 报告对应收汇数据查询名称 报告对应收汇数据查询描述 该服务为接入客户端提供可做报告对应收汇数据查询服务功能，领域层接口为：SafeBaseDataService，方法名称为：doQueryBaseDataRcv7.1.1.1 请求报文XML 节点 TAG ：MSG-BODY-DATASTORES-DS1-PARAMETERS 标识符 字段名称 类型 长度 强制/可选 备注CORPID 企业代码 Strin
29、g 9 MRPTNO 申报单号 String 22 OPAYTYPE 收汇性质是否为预收货款String 1 O 空代表全部，“1”代表是，“0”代表否TXSTARTDATE 收汇起始日期 Date OTXENDDATE 收汇截止日期 Date OUDSTARTDATE 更新起始日期 Date OUDENDDATE 更新截止日期 Date OCONTRACTNO 合同号 String 30 O 模糊查询第 15 页业务规则：1、 收汇起始日期和收汇截止日期必须同时输入或同时为空。2、 更新起始日期和更新截止日期必须同时输入或同时为空。3、 申报单号、收汇起始日期和收汇截止日期、更新起始日期和更
30、新截止日期三者不可同时为空。4、 输入申报单号，其他查询条件失效。7.1.1.2 回执报文XML 节点 TAG ：MSG-BODY-DATASTORES-DS1-ROWSET-ROW 标识符 字段名称 类型 长度 强制/可选 备注RPTNO 申报单号 String 22TXCCY 收汇币种 String 3TXAMT 收汇金额 DecimalBIZDATE 收汇日期 DateTXREM 合同号（交易附言 1）String 22CORPID 企业代码 String 9CORPNAME 企业名称 GBString 256CUSTNAME 付汇人姓名 GBString 256COUNTRYCODE
31、付汇人国别 StringPAYTYPE 收汇性质 String 1 A-预收货款R-退款O-其它PAYMETHOD 结算方式 String 22 L信用证G保函C托收T电汇D票汇M信汇O其他第 16 页TXCODE1 交易编码 1 String 6TXAMT1 相应金额 1 DecimalTXCODE2 交易编码 2 String 6TXAMT1 相应金额 2 DecimalCONTRACTNO 合同号 String 22UPDATEDATE 更新日期 DateTime7.1.2 报告对应付汇数据查询名称 报告对应付汇数据查询描述 该服务为接入客户端提供可做报告对应付汇数据查询服务功能，领域层
32、接口为：SafeBaseDataService，方法名称为：doQueryBaseDataPay7.1.2.1 请求报文XML 节点 TAG ：MSG-BODY-DATASTORES-DS1-PARAMETERS 标识符 字段名称 类型 长度 强制/可选 备注CORPID 企业代码 String 9 MRPTNO 申报单号 String 22 OPAYTYPE 付汇性质是否为预付货款String 1 O 空代表全部，“1”代表是，“0”代表否TXSTARTDATE 付汇起始日期 Date OTXENDDATE 付汇截止日期 Date OUDSTARTDATE 更新起始日期 Date OUDEN
33、DDATE 更新截止日期 Date OCONTRACTNO 合同号 String 30 O 模糊查询业务规则：第 17 页1、 付汇起始日期和付汇截止日期必须同时输入或同时为空。2、 更新起始日期和更新截止日期必须同时输入或同时为空。3、 申报单号、付汇起始日期和付汇截止日期、更新起始日期和更新截止日期三者不可同时为空。4、 输入申报单号，其他查询条件失效。7.1.2.2 回执报文XML 节点 TAG ：MSG-BODY-DATASTORES-DS1-ROWSET-ROW 标识符 字段名称 类型 长度 强制/可选 备注RPTNO 申报单号 String 22TXCCY 付汇币种 String
34、3TXAMT 付汇金额 DecimalBIZDATE 付汇日期 DateCONTRACTNO 合同号 String 22CORPID 企业代码 String 9CORPNAME 企业名称 GBString 256CUSTNAME 收汇人名称 GBString 256COUNTRYCODE 收汇人国别 String 3PAYTYPE 付汇性质 String A-预付货款P-货到付款R-退款O-其他PAYMETHOD 结算方式 String 22 L信用证G保函C托收T电汇D票汇M信汇O其他TXCODE1 交易编码 1 String 6第 18 页TXAMT1 相应金额 1 DecimalTXCO
35、DE2 交易编码 2 String 6TXAMT2 相应金额 2 DecimalUSDAMT 付汇金额折美元DecimalUPDATEDATE 更新日期 DateTime7.1.3 报告对应出口数据查询名称 报告对应出口数据查询描述 该服务为接入客户端提供可做报告对应出口数据查询服务功能，领域层接口为：SafeBaseDataService，方法名称为：doQueryBaseDataExp7.1.3.1 请求报文XML 节点 TAG ：MSG-BODY-DATASTORES-DS1-PARAMETERS 标识符 字段名称 类型 长度 强制/可选 备注CORPID 企业代码 String 9 M
36、ENTRYID 报关单号 String 18 O 空代表全部，“1”代表是，“0”代表否CONTRACTNO 合同号 String 30 O 模糊查询EDSTARTDATE 出口起始日期 Date OEDENDDATE 出口截止日期 Date OUDSTARTDATE 更新起始日期 Date OUDENDDATE 更新截止日期 Date O业务规则：1、 出口起始日期和出口截止日期必须同时输入或同时为空。第 19 页2、 更新起始日期和更新截止日期必须同时输入或同时为空。3、 报关单号、出口起始日期和出口截止日期、更新起始日期和更新截止日期三者不可同时为空。4、 输入报关单号，其他查询条件失效
37、。7.1.3.2 回执报文XML 节点 TAG ：MSG-BODY-DATASTORES-DS1-ROWSET-ROW 标识符 字段名称 类型 长度 强制/可选 备注ENTRYID 报关单号 String 18TXCCY 报关币种 String 3TXAMT 出口金额 DecimalEXPDATE 出口日期 DateCONTRACTNO 合同号 String 32PREENTRYID 预录入号码 String 18CORPID 企业代码 String 9CORPNAME 企业名称 GBString 256PORTCODE 出口口岸 String 4TRADEMODE 贸易方式 String 4
38、TRADECOUNTRY 抵运国 String 3USDAMT 成交总价折美元 DecimalUPDATEDATE 更新日期 DateTime7.1.4 报告对应进口数据查询名称 报告对应进口数据查询描述 该服务为接入客户端提供可做报告对应进口数据查询服务功能，领域层接口为：SafeBaseDataService，方法名称为：doQueryBaseDataImp第 20 页7.1.4.1 请求报文XML 节点 TAG ：MSG-BODY-DATASTORES-DS1-PARAMETERS 标识符 字段名称 类型 长度 强制/可选 备注CORPID 企业代码 String 9 MENTRYID
39、报关单号 String 18 O 空代表全部，“1”代表是，“0”代表否CONTRACTNO 合同号 String 30 O 模糊查询IDSTARTDATE 进口起始日期 Date OIDENDDATE 进口截止日期 Date OUDSTARTDATE 更新起始日期 Date OUDENDDATE 更新截止日期 Date O业务规则：1、 进口起始日期和进口截止日期必须同时输入或同时为空。2、 更新起始日期和更新截止日期必须同时输入或同时为空。3、 报关单号、进口起始日期和进口截止日期、更新起始日期和更新截止日期三者不可同时为空。4、 输入报关单号，其他查询条件失效。7.1.4.2 回执报文X
40、ML 节点 TAG ：MSG-BODY-DATASTORES-DS1-ROWSET-ROW 标识符 字段名称 类型 长度 强制/可选 备注ENTRYID 报关单号 String 18TXCCY 报关币种 String 3TXAMT 进口金额 Decimal第 21 页IMPDATE 进口日期 DateCONTRACTNO 合同号 String 32PREENTRYID 预录入号码 String 18CORPID 企业代码 String 9CORPNAME 企业名称 GBString 256PORTCODE 进口口岸 String 4TRADEMODE 贸易方式 String 4TRADECOU
41、NTRY 起运国 String 3USDAMT 成交总价折美元 DecimalOWNERNAME 收货单位名称 GBString 256UPDATEDATE 更新日期 DateTime7.2 预收/预付报告7.2.1 预收/预付报告查询名称 预收/预付报告查询描述 该服务为接入客户端提供可做预收/预付报告查询服务功能，领域层接口为：SafeGoodsService，方法名称为：doExecuteFirstGoodsAdvancePrepaid 7.2.1.1 请求报文XML 节点 TAG ：MSG-BODY-DATASTORES-DS1-PARAMETERS 标识符 字段名称 类型 长度 强制
42、/可选 备注TYPE 业务参数 String 1 M “1”为预收“2”为预付CORPID 企业代码 String 9 MRPTNO 申报单号 String 22 OCONTRACTNO 合同号 String 30 O 模糊查询STARTDATE 报告起始日期 Date O第 22 页ENDDATE 报告截止日期 Date O业务规则：1、 报告起始日期和报告截止日期必须同时输入或同时为空。2、 申报单号、报告起始日期和报告截止日期、合同号三者不可同时为空。3、 输入申报单号，其他查询条件失效。4、 报告起始日期和报告截止日期跨度不可超过 30 天，起始日期不能大于截止日期。7.2.1.2 回
43、执报文XML 节点 TAG ：MSG-BODY-DATASTORES-DS1-ROWSET-ROW 标识符 字段名称 类型 长度 强制/可选 备注RPTNO 申报单号 String 22 MTXCCY 收付汇币种 String 9 MTXAMT 收付汇金额 Decimal MRPTDATE 报告日期 Date MCREDITAMT 已报告金额合计 Decimal MCONTRACTNO 合同号（交易附言） String 22 OVERCODE 更新日期 DateTime M7.2.2 预收/预付报告明细查询名称 预收/预付报告明细查询描述 该服务提供预收/预付报告明细查询功能，领域层接口为：S
44、afeGoodsService，方法名称为：doExecuteFirstGoodsAdvancePrepaidReport7.2.2.1 请求报文XML 节点 TAG ：MSG-BODY-PARAMETERS 标识符 字段名称 类型 长度 强制/可选 备注TYPE 业务参数 String 1 M “1”为预收“2”为预付第 23 页CORPID 企业代码 String 9 MRPTNO 申报单号 String 22 M业务规则：无登录用户通过预收付申报单号查询服务来具体的查询某一个已做过预收货款/预付货款报告申报单报告的详细信息，用户可以通过业务参数（TYPE）来区分具体查询的是预收还是预付。
45、7.2.2.2 回执报文XML节点TAG ：MSG-BODY-DATASTORES-DS1-ROWSET-ROW标识符 字段名称 类型 长度 强制/可选 备注CREDITID 贸易信贷报告序号Integer MFUTUREDATE 预计出口日期/预计进口日期Date MTXCCY 币种 String 3 MCREDITAMT 报告金额 Decimal MTXTYPE 关联关系类型 String M 0 无关联关系1 母子公司关系2 直接或间接同为第三方所控制或同时控制第三方3 一方对另一方财务或经营决策过程具有参与权利并可施加一定影响第 24 页UPDATEDATE更新日期 DateTime7
46、.2.3 预收/预付报告新增名称 预收/预付报告新增描述 该服务提供预收/预付报告新增服务功能，领域层接口为：SafeGoodsService，方法名称为：doAddGoodsAdvancePrepaidReport7.2.3.1 请求报文XML节点TAG ：MSG-BODY- PARAMETERS标识符 字段名称 类型 长度 强制 /可选 备注TYPE 业务参数 String 1 M “1”为预收“2”为预付CORPID 企业代码 String 9 MRPTNO 申报单号 String 22 MXML节点TAG ：MSG-BODY-DATASTORES-DS1-ROWSET-ROW标识符 字
47、段名称 类型 长度 强制/可选 备注CREDITAMT 报告金额 Decimal MFUTUREDATE 预计进口日期/预计出口日期Date MTXTYPE 关联关系类型 String M 0 无关联关系1 母子公司关系2 直接或间接同为第三方所控制或同时控制第三方3 一方对另一方财务或经营决策过程具有参与权利并可施加一定影响第 25 页业务规则：1、实现对收汇日期在当前日期前 30 天（含）内的收汇数据做预收货款报告新增、对付汇日期在当前日期前 30 天（含）内的付汇数据做预付货款报告新增。2、预计进口日期/预计出口日期必须在付汇日期/收汇日期之后。3、已报告金额合计不能超过付汇金额/收汇金
48、额。7.2.3.2 回执报文预收付报告新增服务返回 xml,code 作为判断修改成功或者失败的标志，当返回 code 为 00000 的时候表示修改成功，返回 code 为其它值的时候表示修改操作失败,detail 标识失败原因。7.2.4 预收/预付报告修改和调整名称 预收付报告修改和调整描述 该服务提供预收/预付报告修改和调整服务功能，领域层接口为：SafeGoodsService，方法名称为：doModifyCreditReport7.2.4.1 请求报文XML节点TAG ：MSG-BODY- PARAMETERS标识符 字段名称 类型 长度 强制 /可选 备注TYPE 业务参数 St
49、ring 1 M “1”为预收“2”为预付CORPID 企业代码 String 9 MRPTNO 申报单号 String 22 M本次修改和调整后新增明细信息XML节点TAG ：MSG-BODY-DATASTORES-DS1-ROWSET-ROW标识符 字段名称 类型 长度 强制/可选 备注CREDITAMT 报告金额 Decimal MFUTUREDATE 预计进/出口日期 Long M第 26 页TXTYPE 关联关系类型 Integer M 0 无关联关系1 母子公司关系2 直接或间接同为第三方所控制或同时控制第三方3 一方对另一方财务或经营决策过程具有参与权利并可施加一定影响本次修改和调整被删除明细信息的主键XML节点TAG ：MSG-BODY-DATASTORES-DS2-ROWSET-ROW标识符 字段名称 类型 长度 强制/可选 备注CREDITID 贸易信贷报告序号 Integer M 可多条报告修改的业务规则：1. 收汇日期/付汇日期在当前日期 30 天（含）内的可以做报告的修改。2. 修改后的“预计进/出口日期 ”不得
