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

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

修订历史日期版本描述作者2015-11-021.1初稿谢安2016-04-051.2依据报关单调整内容修订徐飞跃目录TOC\o"1-5"\h\z文档说明 -4-文档描述 -4-\o"CurrentDocument"阅读对象 -4-\o"CurrentDocument"报文传输说明 -4-\o"CurrentDocument"交换说明 -4-数据接口定义 -5-访问地址及参数 -5-\o"CurrentDocument"报文编码 -5-\o"CurrentDocument"报文节点说明 -6-\o"CurrentDocument"报文节点概要 -6-\o"CurrentDocument"消息头定义 -6-\o"CurrentDocument"消息体定义 -7-返回报文定义 -26 -上传结果示例 -26-例文 -27-进口报关例文 -27-进口报检例文 -27-进口关检联合例文 -27-出口报关例文 -27-出口报检例文 -27-出口关检联合例文 -27-附件 -27-调用实例 -28-Java语言调用 -28-文档说明文档描述为减少各企业在多套系统中重复填写进出口货物数据，实现企业应用系统将进出口货物数据直接上传到“广州国际贸易单一窗口货物申报系统”（以下简称货物申报系统），对应“货物申报系统”中“暂存”功能，制定相应的数据交换平台和数据格式。阅读对象数据交换平台接口开发人员、维护人员。报文传输说明使用HTTP方式传输数据，应用RestFul方式交换数据，业务数据和处理结果采用 XML格式进行封装，用户名、密码等信息单独传输。交换说明1、 企业必须先在单一窗口中进行统一认证，然后通过接口方式上传相应的报关、报检或关检联合数据。2、 对于同一记录，每次视为新增，即首次提交数据，如需删除多余上传数据，需在“货物申报系统”中执行“删除”操作。3、所有项目内备注为“必填”指的是要求必填该项，但没有填入也可以上传（注：申报口岸、经营单位、申报单位必须填写，如为空则不接收上传数据 ），当前主要是便于企业上载数据，企业实际尽可能按实际业务要求填写对应的数据，后续根据业务需要，对“必填”项执行相应的校验。4、“暂存”指企业系统数据按指定格式上传到货物申报系统， “申报”指在企业系统中实现上载到QP系统或CIQ2000系统并申报（暂未实现），本期主要是实现“暂存”5、数据上传到“货物申报系统”中，原有的“ 上载”、“报关申报”、“报检申报”等操作仍在“货物申报系统”中。数据接口定义访问地址及参数地址：http://ip:port/CargoDeclaration/restful/operatorCompany/import/指定参数：userName单点登录账号；passWord单点登录密码；ioFlag进出口标示0/进口1/出口；report报文内容，即具体的上传数据。具体访问实例请参见“4调用实例”Report由消息头(Head)和消息体(Body)两部分组成，报文具体定义如下：报文编码报文编码统一采用UTF-8格式。23报文节点说明231.报文节点概要NesAaceTypeFujictionCodeReceiverSeujTiniiegessagef] (23报文节点说明231.报文节点概要NesAaceTypeFujictionCodeReceiverSeujTiniiegessagef] (...VersionBodyr-Castonscig由GotfdsListffl一:ContainerListpH图2-1消息头定义消息头［Head］只涉及基础信息说明，不涉及具体业务内容，消息头 （Head）定义如下表:节点节点名称描述[Messageld]报文唯编号组成规则：[MessageType]」Sender][SendTime]+[4位流水号］

[MessageType]报文类型当前固定为“SWCARGO001[FunctionCode]报文类型定义暂存或者申报，1：暂存；2:申报。（相关说明见1.4父换说明）[Sender]发送万代码彳企业在电子口岸开户的公司编码[Receiver]接收方代码电子口岸代码，固定为“GZS”[SendTime]发送时间格式yyyyMMddhhmmss时区为北京（东八区），如:201506101736301[Version]报文版本号报文格式版本号，默认是1.0”表格2-1233.消息体定义进出口业务信息［Body］均由以下主要节点组成，如下:节点节点名称描述校验规则[Customs]海关数据项详细的海关数据描述，不含商品信息出现0次，至多1次[CIQ]国检数据项详细的国检数据描述，不含商品信息出现0次，至多1次[GoodsList]商品货物信息详细的商品货物信息数据描述。此节点下面分为海关商品货物信息［Customs］和国检商品货物信息［CIQ］，［Customs］和［CIQ］既可以单独出现，也可以同时出现，分别表示报关、报检或者联合关检仅出现1次[ContainerList]集装箱信息详细的集装箱数据描述出现0次，至多N次表格2-2实际上传数据时，根据业务需要，对上述节点进行组合， 实现单独的报关、报检或者联合关检。如I单独报关则需［Customs］、［GoodsList］，［ContainerList］（可选择），单独报检则需［CIQ］、［GoodsList］， ［ContainerList］ （可选择），联合关检则需［Customs］、［CIQ］、[GoodsList[GoodsList]，[ContainerList].进口报文结构描述文档XSDSiriglcWinrlrwGnodsluWithoulSameFie1

2.3.32出口报文结构描述文档XSD.进口海关数据项[Customs]父节点子节点节点名称填写说明字段类型必填其它约束CustomsDecIHead（海关基本数据信息）[DecIPort]申报口岸代码String(4)Y参见海关关区代码[ContractNo]合同协议号String(32)Y[BillNo]提运单号String(32)Y[TrafName]运输工具名称String(26)Y[VoyageNo]航次号String(32)Y[IEPort]进口口岸代码String(4)Y参见海关关区代码[ManualNo]备案号String(12)N[IEDate]进口日期DateNYYYY-MM-DD[TradeCo]经营单位代码String(10)Y[TradeName]经营单位名称String(70)Y[TrafMode]运输工具代码String(2)Y20船舶29海运集装箱31火车32汽车39陆运集装箱50飞机59空运集装箱99其他[OwnerCode]收货单位编码String(10)Y[OwnerName]收货单位名称String(70)Y[AgentCode]申报单位编码String(1Y

子节点节点名称填写说明字段类型必填其它约束0)[AgentName]申报单位名称String(70)Y[CutMode]征免性质代码String(3)Y参见海关征免性质代码表[PaymentMark]纳税单位String(3)N001:经营单位002:收货单位003:申报单位[TradeMode]监管方式代码String(4)Y参见海关监管方式代码表[License]许可证号String(20)N[TradeCountry]启运国（地区）代码String(3)Y参见国家代码表[DestinationPort]装货港代码String(4)Y参见港口代码表[DestinationCode]境内目的地代码String(5)Y参见海关境内目的地代码表[PackNo]件数decimalY[WrapType]包装种类代码String(1)Y参见包装种类代码表[GrossWt]毛重decimalY[NetWt]净重decimalY[FeeMark]运费标记String(1)N（1:率2:单价3总价）[FeeRate]运费/率decimalN[FeeCurr]运费币制代码String(3)N参见币制代码表[InsurMark]保费标记String(1)N（1:率3:总价）[InsurRate]保费/率 ：decimalN[InsurCurr]保费币制代码String(3)N参见币制代码表[OtherMark]杂费标记String(1)N（1:率3:总价）[OtherRate]杂费/率decimalN[OtherCurr]杂费币制代码String(3)N参见币制代码表报关单类型代码String(1)（0）有纸报关；（W）无纸报关；（L）有纸带清单父节点

子节点节点名称填写说明字段类型必填其它约束[EntryType]Y报关；(D)无纸带清单报关；(M)无纸化通关[TransMode]成交方式代码String(1)YCIFC&FFOBC&I市场价垫仓[ApprNo]批准文号String(30)N[NoteS]报关备注String(255)N[Relativeld]关联报关单号