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

1、企业与单一窗口货物申报系统接口说明2016年04月精品文档修订历史日期版本描述作者2015-11-021.1初槁谢女2016-04-051.2依据报关单调整内容修订徐飞跃-2 - -欢迎下载精品文档目录 TOC o 1-5 h z .文档说明-4 -文档描述-4 - HYPERLINK l bookmark7 o Current Document 阅读对象-4 - HYPERLINK l bookmark9 o Current Document 报文传输说明-4 - HYPERLINK l bookmark11 o Current Document 交换说明 -4 -.数据接口定义-5 -访问

2、地址及参数-5 - HYPERLINK l bookmark16 o Current Document 报文编码-5 - HYPERLINK l bookmark18 o Current Document 报文节点说明 -6 -报文节点概要 -6-消息头定义 -6-消息体定义 -7-返回报文定义 -26-上传结果示例-26 -例文-27 -进口报关例文 -27 -进口报检例文 -27 -进口关检联合例文 -27 -出口报关例文 -27 -出口报检例文 -27 -出口关检联合例文 -27 -.附件-27 -. 调用实例-28 -Java 语言调用 -28 -欢迎下载精品文档.文档说明文档描述为减

3、少各企业在多套系统中重复填写进出口货物数据，实现企业应用系统将进出口货物 数据直 接上传到“广州国际贸易单一窗口货物申报系统”（以下简称货物申报系统），对应“货物申报 系统”中“暂存”功能，制定相应的数据交换平台和数据格式。阅读对象数据交换平台接口开发人员、维护人员。报文传输说明使用HTTP方式传输数据，应用 RestFul方式交换数据，业务数据和处理结果采用XML格式进行封装，用户名、密码等信息单独传输。交换说明1、企业必须先在单一窗口中进行统一认证，然后通过接口方式上传相应的报关、报检或关检联合数 据。2、对于同一记录，每次视为新增，即首次提交数据，如需删除多余上传数据，需在“货物申报系

4、统”中执行“删除”操作。3、所有项目内备注为“必填”指的是要求必填该项，但没有填入也可以上传（注：申报口岸、 经营单位、申报单位必须填写，如为空则不接收上传数据），当前主要是便于企业上载数据，企业实际尽可能按实际业务要求填写对应的数据，后续根据业务需要，对“必填”项执 行相应的校验。4、 “暂存”指企业系统数据按指定格式上传到货物申报系统，“申报”指在企业系统中实现上载到QP系统或CIQ2000系统并申报（暂未实现），本期主要是实现“暂存”5、数据上传到“货物申报系统”中，原有的“上载”、“报关申报”、“报检申报”等操作仍在“货物申报系统”中。欢迎下载精品文档2.数据接口定义访问地址及参数地址

5、：http:ip:port/CargoDeclaration/restful/operatorCompany/import/指定参数：userName单点登录账号；passWord单点登录密码；ioFlag进出口标示0/进口 1/出口 ；report报文内容，即具体的上传数据。具体访问实例请参见“ 4调用实例”Report由消息头(Head)和消息体(Body)两部分组成，报文具体定义如下：报文编码报文编码统一采用UTF-8格式。精品文档23报文节点说明231.报文节点概要NesAaceTypeFujicti onCodeReceiverSeujTiniiegessageM(精品文档23报文节

6、点说明231.报文节点概要NesAaceTypeFujicti onCodeReceiverSeujTiniiegessageM(.VersionBody一Castonscig由GotfdsList ffl一:Cont ai nerLis t pH图2-12.3.2.消息头定义消息头Head只涉及基础信息说明，不涉及具体业务内容，消息头（Head）定义如下表:节点节点名称描述Messageld报文唯编号组成规则：MessageTypeSenderSendTime+4位流水号-6 - 一 -欢迎下载精品文档MessageType报文类型当前固定为“ SWCARGO001Function Code

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

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

9、toms、CIQ、GoodsList ，ContainerList.进口报文结构描述文档XSDSi riglcWinrlrwGnods luWi thoulSameFi e 1欢迎下载精品文档2.3.32出口报文结构描述文档XSD.进口海关数据项Customs父节点子节点节点名称填写说明字段类型必填其它约束CustomsDecIHea d（海关基 本数据信 息）DecIPort申报口岸代码Strin g(4 )Y参见海关关区代 码Co ntractNo合同协议号Strin g(32)YBillNo提运单号Strin g(32)YTrafName运输工具名称Strin g(26)YVoyageN

10、o航次号Strin g(32)YIEPort进口口岸代码Strin g(4 )Y参见海关关区代 码Ma nualNo备案号Strin g(12)NIEDate进口日期DateNYYYY-MM-DDTradeCo经营单位代码Strin g(10)YTradeName经营单位名称Strin g(7 0)YTrafMode运输工具代码Strin g(2 )Y20船舶29海运集装箱31火车32汽车39陆运集装箱50飞机59空运集装箱99其他Ow nerCode收货单位编码Strin g(10)YOw nerName收货单位名称Strin g(7 0)YAge ntCode申报单位编码Strin g(1

11、Y-8 - 一 -欢迎下载子节点节点名称填写说明字段类型必填其它约束0)Age ntName申报单位名称Strin g(7 0)YCutMode征免性质代码Strin g(3 )Y参见海关征免性质 代码表Payme ntMark纳税单位Strin g(3 )N001:经营单位002:收货单位003:申报单位TradeMode监管方式代码Strin g(4 )Y参见海关监管方式 代码表Lice nse许可证号Strin g(20)NTradeCou ntry启运国（地区）代 码Strin g(3 )Y参见国家代码表Desti natio nPort 装货港代码Strin g(4 )Y参见港口代码

12、表Desti nati on Code 境内目的地代码Strin g(5 )Y参见海关境内目的 地代码表PackNo件数decimalYWrapType包装种类代码Strin g(1 )Y参见包装种类代码 表GrossWt毛重decimalYNetWt净重decimalYFeeMark运费标记Strin g(1 )N（1:率2:单价3:总价）FeeRate运费/率decimalNFeeCurr运费币制代码Strin g(3 )N参见币制代码表In surMark保费标记Strin g(1 )N（1:率3:总价）In surRate保费/率：decimalNIn surCurr保费币制代码Str

13、in g(3 )N参见币制代码表OtherMark杂费标记Strin g(1 )N（1:率3:总价）OtherRate杂费/率decimalNOtherCurr杂费币制代码Strin g(3 )N参见币制代码表报关单类型代码Strin g(1 )（0）有纸报关；（W）无纸报关；（L）有纸带清单精品文档父节点子节点节点名称填写说明字段类型必填其它约束En tryTypeY报关；(D)无纸带清单报关；(M)无纸化通关Tra nsMode成交方式代码Strin g(1 )YCIFC&FFOBC&I(5)市场价(6)垫仓ApprNo批准文号Strin g(3 0)N网oteS报关备注Stri ng (255)NRelativeld关联报关单号Strin g(18)NRelativeMa nualN o关联备案号Strin g(12)NBo ndedNo监管仓号Strin g(32)NCustomsField货场代码Strin g(8 )N参见海关货场代码 表En tryTra nsitTyp e转关提前报关Strin g(3 )N003表示转关单；001表示普通报关单En tryPers on报关员名称Strin g(8 )N单En tryPers onCont act报关员联系方式Strin g(32)NTradeCodeScc收发货