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

《企业与单一窗口货物申报系统接口说明》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、企业与单一窗口货物申报系统接口说明2016年04月-25-修订历史日期版本描述作者2015-11-021.1初稿谢安2016-04-051.2依据报关单调整内容修订徐飞跃-25-目录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.进口报关例文-

2、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--25-文档说明1.1.文档描述为减少各企业在多套系统中重复填写进出口货物数据，实现企业应用系统将进出口货物数据直接上传到“广州国际贸易单一窗口货物申报系统”(以下简称货物申报系统)，对应“货物申报系统”中“暂存”功能，制定相应的数据交换平台和数据格式。1.2.阅读对象数据交换平台接口开发人员、维护人员。1.3.报文传输说明使用HTTP方

3、式传输数据，应用RestFul方式交换数据，业务数据和处理结果采用XML格式进行封装，用户名、密码等信息单独传输。1.4.交换说明1、企业必须先在单一窗口中进行统一认证，然后通过接口方式上传相应的报关、报检或关检联合数据。2、对于同一记录，每次视为新增，即首次提交数据，如需删除多余上传数据，需在“货物申报系统”中执行“删除”操作。3、所有项目内备注为“必填”指的是要求必填该项，但没有填入也可以上传(注：申报口岸、经营单位、申报单位必须填写，如为空则不接收上传数据)，当前主要是便于企业上载数据，企业实际尽可能按实际业务要求填写对应的数据，后续根据业务需要，对“必填”项执行相应的

4、校验。4、“暂存”指企业系统数据按指定格式上传到货物申报系统，“申报”指在企业系统中实现上载到QP系统或CIQ2000系统并申报(暂未实现)，本期主要是实现“暂存”。5、数据上传到“货物申报系统”中，原有的“上载”、“报关申报”、“报检申报”等操作仍在“货物申报系统”中。-25-1.数据接口定义1.1.访问地址及参数地址：http://ip:port/CargoDeclaration/restful/operatorCompany/import/指定参数：userName单点登录账号;passWord单点登录密码;ioFlag进出口标示0/进口1/出口;report报文内容，

5、即具体的上传数据。具体访问实例请参见“4调用实例”Report由消息头(Head)和消息体(Body)两部分组成，报文具体定义如下：1.2.报文编码报文编码统一采用UTF-8格式。-25-1.1.报文节点说明1.1.1.报文节点概要图211.1.2.消息头定义消息头[Head]只涉及基础信息说明，不涉及具体业务内容，消息头(Head)定义如下表：节点节点名称描述[MessageId]报文唯一编号组成规则：[MessageType]_[Sender]_[SendTime]+[4位流水号]-25-[MessageType]报文类型当前固定为“SWCARGO001”[Functi

6、onCode]报文类型定义暂存或者申报，1:暂存;2:申报。(相关说明见1.4交换说明)[Sender]发送方代码企业在电子口岸开户的公司编码[Receiver]接收方代码电子口岸代码，固定为“GZSW”[SendTime]发送时间格式yyyyMMddhhmmss，时区为北京(东八区)，如：201506101736301[Version]报文版本号报文格式版本号，默认是“1.0”表格211.1.1.消息体定义进出口业务信息[Body]均由以下主要节点组成，如下：节点节点名称描述校验规则[Customs]海关数据项详细的海关数据描述，不含商品信息出现0次，至多1次[CIQ]国

7、检数据项详细的国检数据描述，不含商品信息出现0次，至多1次[GoodsList]商品货物信息详细的商品货物信息数据描述。此节点下面分为海关商品货物信息[Customs]和国检商品货物信息[CIQ]，[Customs]和[CIQ]既可以单独出现，也可以同时出现，分别表示报关、报检或者联合关检仅出现1次[ContainerList]集装箱信息详细的集装箱数据描述出现0次，至多N次表格22实际上传数据时，根据业务需要，对上述节点进行组合，实现单独的报关、报检或者联合关检。如单独报关则需[Customs]、[