企业与单一窗口货物申报系统接口说明.doc

企业与单一窗口货物申报系统 接口说明 2016年04月 修订历史 日期 版本 描述 作者 2015-11-02 1.1 初稿 谢安 2016-04-05 1.2 依据报关单调整内容修订 徐飞跃 1. 文档说明 - 3 - 1.1. 文档描述 - 3 - 1.2. 阅读对象 - 3 - 1.3. 报文传输说明 - 3 - 1.4. 交换说明 - 3 - 2. 数据接口定义 - 4 - 2.1. 访问地址及参数 - 4 - 2.2. 报文编码 - 4 - 2.3. 报文节点说明 - 5 - 2.3.1. 报文节点概要 - 5 - 2.3.2. 消息头定义 - 5 - 2.3.3. 消息体定义 - 6 - 2.4. 返回报文定义 - 22 - 2.4.1. 上传结果示例 - 22 - 2.5. 例文 - 22 - 2.5.1. 进口报关例文 - 22 - 2.5.2. 进口报检例文 - 22 - 2.5.3. 进口关检联合例文 - 22 - 2.5.4. 出口报关例文 - 22 - 2.5.5. 出口报检例文 - 23 - 2.5.6. 出口关检联合例文 - 23 - 3. 附件 - 23 - 4. 调用实例 - 23 - 4.1. Java语言调用 - 23 - 文档说明 文档描述 为减少各企业在多套系统中重复填写进出口货物数据，实现企业应用系统将进出口货物数据直接上传到“广州国际贸易单一窗口货物申报系统”(以下简称货物申报系统)，对应“货物申报系统”中“暂存”功能，制定相应的数据交换平台和数据格式。 阅读对象 数据交换平台接口开发人员、维护人员。 报文传输说明 使用HTTP方式传输数据，应用RestFul方式交换数据，业务数据和处理结果采用XML格式进行封装，用户名、密码等信息单独传输。 交换说明 企业必须先在单一窗口中进行统一认证，然后通过接口方式上传相应的报关、报检或关检联合数据。 对于同一记录，新增即首次提交数据，。 所有项目内备注为“必填” 指的是要求必填该项，但没有填入也可以，。  数据接口定义 访问地址及参数 地址：http://ip:port/CargoDeclaration/restful/operatorCompany/import/ 指定参数：userName 单点登录账号; passWord 单点登录密码; ioFlag 进出口标示 0/进口 1/出口; report 报文内容，即具体的上传数据。 具体访问实例请参见“4调用实例” Report由消息头(Head)和消息体(Body)两部分组成，报文具体定义如下： 报文编码 报文编码统一采用UTF-8格式。 报文节点说明 报文节点概要 图 21 消息头定义 消息头[Head]只涉及基础信息说明，不涉及具体业务内容，消息头(Head)定义如下表： 节点 点名称 [MessageId] 报文唯一编号 规则[MessageType] _[Sender]_[SendTime]+[4位流水号] [MessageType] 报文类型 当前固定为“SWCARGO001” [FunctionCode] 报文类型 定义暂存或者申报，1:暂存;2:申报。 [Sender] 发送方代码 [Receiver] 接收方代码 GZSW” [SendTime] 发送时间 yyyyMMddhhmmss，时区为北京(东八区)，如：20150610173630 [Version] 报文版本号 版本号，“1.0” 表格 21 消息体定义 进出口业务信息[Body]均由以下主要节点组成，如下： 节点 点名称 校验规则 [Customs] 海关数据项 详细的海关数据描述，不含商品信息 出现0次，至多1次 [CIQ] 国检数据项 详细的国检数据描述，不含商品信息 出现0次，至多1次 [GoodsList] 商品货物信息 详细的商品货物信息数据描述。Customs]和国检商品货物信息[CIQ]，[Customs]和[CIQ]既可以单独出现，也可以同时出现，分别表示报关、报检或者联合关检 仅出现1次 [ContainerList] 集装箱信息 详细的集装箱数据描述 出现0次，至多N次 表格 22 实际上传数据时，根据业务需要，对上述节点进行组合，实现单独的报关、报检或者联合关检。如单独报关则需[Customs]、[GoodsList]，[ContainerList]（可选择），单独报检则需[CIQ] 、[GoodsList]，[ContainerList]（可选择），联合关检则需[Customs] 、[CIQ]、[GoodsList]，[Conta