企业与单一窗口货物申报系统接口说明分解.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 - 1. 文档说明 1.1. 文档描述 为减少各企业在多套系统中重复填写进出口货物数据，实现企业应用系统将进出口货物数据直接上传到“广州国际贸易单一窗口货物申报系统”(以下简称货物申报系统)，对应“货物申报系统”中“暂存”功能，制定相应的数据交换平台和数据格式。 1.2. 阅读对象 数据交换平台接口开发人员、维护人员。 1.3. 报文传输说明 使用HTTP方式传输数据，应用RestFul方式交换数据，业务数据和处理结果采用XML格式进行封装，用户名、密码等信息单独传输。 1.4. 交换说明 1、 企业必须先在单一窗口中进行统一认证，然后通过接口方式上传相应的报关、报检或关检联合数据。 2、 对于同一记录，每次视为新增，即首次提交数据，如需删除多余上传数据，需在“货物申报系统”中执行“删除”操作。 3、 所有项目内备注为“必填” 指的是要求必填该项，但没有填入也可以上传(注：申报口岸、经营单位、申报单位必须填写，如为空则不接收上传数据)，当前主要是便于企业上载数据，企业实际尽可能按实际业务要求填写对应的数据，后续根据业务需要，对“必填”项执行相应的校验。 4、 “暂存”指企业系统数据按指定格式上传到货物申报系统，“申报”指在企业系统中实现上载到QP系统或CIQ2000系统并申报(暂未实现)，本期主要是实现“暂存”。 5、 数据上传到“货物申报系统”中，原有的“上载”、“报关申报”、“报检申报”等操作仍在“货物申报系统”中。  2. 数据接口定义 2.1. 访问地址及参数 地址：http://ip:port/CargoDeclaration/restful/operatorCompany/import/ 指定参数：userName 单点登录账号; passWord 单点登录密码; ioFlag 进出口标示 0/进口 1/出口; report 报文内容，即具体的上传数据。 具体访问实例请参见“4调用实例” Report由消息头(Head)和消息体(Body)两部分组成，报文具体定义如下： 2.2. 报文编码 报文编码统一采用UTF-8格式。 2.3. 报文节点说明 2.3.1. 报文节点概要 图 21 2.3.2. 消息头定义 消息头[Head]只涉及基础信息说明，不涉及具体业务内容，消息头(Head)定义如下表： 节点 节点名称 描述 [MessageId] 报文唯一编号 组成规则： [MessageType] _[Sender]_[SendTime]+[4位流水号] [MessageType] 报文类型 当前固定为“SWCARGO001” [FunctionCode] 报文类型 定义暂存或者申报，1:暂存;2:申报。(相关说明见1.4交换说明) [Sender] 发送方代码 企业在电子口岸开户的公司编码 [Receiver] 接收方代码 电子口岸代码，固定为“GZSW” [SendTime] 发送时间 格式yyyyMMddhhmmss，时区为北京(东八区)，如：201506101736301 [Version] 报文版本号 报文格式版本号，默认是“1.0” 表格 21 2.3.3. 消息体定义 进出口业务信息[Body]均由以下主要节点组成，如下： 节点 节点名称 描述 校验规则 [Customs] 海关数据项 详细的海关数据描述，不含商品信息 出现0次，至多1次 [CIQ] 国检数据项 详细的国检数据描述，不含商品信息 出现0次，至多1次