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

1、企业与单一窗口货物申报系统接口说明企业与单一窗口货物申报系统接口说明2016年04月修订历史日期版本描述作者2015-11-021.1初稿谢安2016-04-051.2依据报关单调整内容修订徐飞跃1. 文档说明1.1. 文档描述为减少各企业在多套系统中重复填写进出口货物数据，实现企业应用系统将进出口货物数据直接上传到“广州国际贸易单一窗口货物申报系统”(以下简称货物申报系统)，对应“货物申报系统”中“暂存”功能，制定相应的数据交换平台和数据格式。1.2. 阅读对象数据交换平台接口开发人员、维护人员。1.3. 报文传输说明使用HTTP方式传输数据，应用RestFul方式交换数据，业务数据和处理结

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

3、报”指在企业系统中实现上载到QP系统或CIQ2000系统并申报(暂未实现)，本期主要是实现“暂存”。5、 数据上传到“货物申报系统”中，原有的“上载”、“报关申报”、“报检申报”等操作仍在“货物申报系统”中。2. 数据接口定义2.1. 访问地址及参数地址：http:/ip:port/CargoDeclaration/restful/operatorCompany/import/指定参数：userName 单点登录账号; passWord 单点登录密码;ioFlag 进出口标示 0/进口 1/出口;report 报文内容，即具体的上传数据。具体访问实例请参见“4调用实例”Report由消息头(H

4、ead)和消息体(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发送方代码企业在电子口岸开户

5、的公司编码Receiver接收方代码电子口岸代码，固定为“GZSW”SendTime发送时间格式yyyyMMddhhmmss，时区为北京(东八区)，如：201506101736301Version报文版本号报文格式版本号，默认是“1.0”表格 212.3.3. 消息体定义 进出口业务信息Body均由以下主要节点组成，如下：节点节点名称描述校验规则Customs海关数据项详细的海关数据描述，不含商品信息出现0次，至多1次CIQ国检数据项详细的国检数据描述，不含商品信息出现0次，至多1次GoodsList商品货物信息详细的商品货物信息数据描述。此节点下面分为海关商品货物信息Customs和国检商品

6、货物信息CIQ，Customs和CIQ既可以单独出现，也可以同时出现，分别表示报关、报检或者联合关检仅出现1次ContainerList集装箱信息详细的集装箱数据描述出现0次，至多N次表格 22 实际上传数据时，根据业务需要，对上述节点进行组合，实现单独的报关、报检或者联合关检。如单独报关则需Customs、GoodsList，ContainerList（可选择），单独报检则需CIQ 、GoodsList，ContainerList（可选择），联合关检则需Customs 、CIQ、GoodsList，ContainerList.2.3.3.1. 进口报文结构描述文档XSD2.3.3.2. 出口

7、报文结构描述文档XSD2.3.3.3. 进口海关数据项Customs父节点子节点节点名称填写说明字段类型必填其它约束CustomsDeclHead(海关基本数据信息)DeclPort申报口岸代码String(4)Y参见海关关区代码ContractNo合同协议号String(32)YBillNo提运单号String(32)YTrafName运输工具名称String(26)YVoyageNo航次号String(32)YIEPort进口口岸代码String(4)Y参见海关关区代码ManualNo备案号String(12)NIEDate进口日期DateNYYYY-MM-DDTradeCo经营单位代码S

8、tring(10)YTradeName经营单位名称String(70)YTrafMode运输工具代码String(2)Y20 船舶29 海运集装箱31 火车32 汽车39 陆运集装箱50 飞机59 空运集装箱99 其他OwnerCode收货单位编码String(10)YOwnerName收货单位名称String(70)YAgentCode申报单位编码String(10)YAgentName申报单位名称String(70)YCutMode征免性质代码String(3)Y参见海关征免性质代码表PaymentMark纳税单位String(3)N001:经营单位 002:收货单位 003:申报单位Tr

9、adeMode监管方式代码String(4)Y参见海关监管方式代码表License许可证号String(20)NTradeCountry启运国(地区)代码String(3)Y参见国家代码表DestinationPort装货港代码String(4)Y参见港口代码表DestinationCode境内目的地代码String(5)Y参见海关境内目的地代码表PackNo件数decimalYWrapType包装种类代码String(1)Y参见包装种类代码表GrossWt毛重decimalYNetWt净重decimalYFeeMark运费标记String(1)N(1: 率 2:单价 3:总价)FeeRate

10、运费/率decimalNFeeCurr运费币制代码String(3)N参见币制代码表InsurMark保费标记String(1)N(1: 率 3:总价)InsurRate保费/率decimalNInsurCurr保费币制代码String(3)N参见币制代码表OtherMark杂费标记String(1)N(1: 率 3:总价)OtherRate杂费/率decimalNOtherCurr杂费币制代码String(3)N参见币制代码表EntryType报关单类型代码String(1)Y(O)有纸报关；(W)无纸报关；(L)有纸带清单报关；(D)无纸带清单报关；(M)无纸化通关TransMode成交方

11、式代码String(1)Y(1) CIF(2) C&F(3) FOB(4) C&I(5) 市场价(6) 垫仓ApprNo批准文号String(30)NNoteS报关备注String(255)NRelativeId关联报关单号String(18)NRelativeManualNo关联备案号String(12)NBondedNo监管仓号String(32)NCustomsField货场代码String(8)N参见海关货场代码表EntryTransitType转关提前报关String(3)N003表示转关单;001表示普通报关单EntryPerson报关员名称String(8)NEntryPerso

12、nContact报关员联系方式String(32)NTradeCodeScc收发货人统一编码String(18)NAgentCodeScc申报单位统一编码String(18)NOwnerCodeScc消费使用单位统一编码String(18)NCopCodeScc录入单位统一编码String(18)NSpecialRelation特殊关系确认String(1Y1:是 0:否PriceEffect价格影响确认String(1)Y1:是 0:否PaySpecialEnvoy支付特使权使用费确认String(1)Y1:是 0:否TradeAreaCode贸易国(地区)String(3)N参见国家代码表

13、CustomsDeclCertificateList (海关随附单据信息列表)CustomsDeclCertificate,允许出现多次，每个节点内包括DocuCode和CertCodeDocuCode随附单证代码String(1)Y参见报关随附单据类型表CertCode随附单证编号String(32)Y 表格 23 2.3.3.4. 进口国检数据项CIQ父节点子节点节点名称填写说明字段类型必填其它约束CIQDeclHead (国检基本数据信息)DeclPort申报口岸代码String(4)Y参见海关关区代码ContractNo合同协议号String(32)YBillNo提运单号String(

14、32)YTrafName运输工具名称String(26)YVoyageNo航次号String(32)YDeclTypeCode报检类别代码String(2)Y进口选择项：13 入境检验检疫14 入境流向15 入境验证出口选择项：21 出境预检24 出境检验检疫25 出境核查货证28 出境验证CheckOrgCode施检机构代码String(6)Y参见国检机构代码表DestOrgCode目的机构代码String(6)Y参见国检机构代码表CorpAttr企业性质代码String(1)Y1 国有企业2 中外合作企业3 中外合资企业4 外商独资企业5 集体企业6 私营企业9 其他AplPersonCo

15、de报检员编码String(10)NAplLinkman联系人String(20)YAplTel联系电话String(20)YDeclarationNumber报关单号String(50)YConsigneeCode收货人代码String(10)YConsigneeCn收货人中文名称String(50)YConsigneeEn收货人英文名称String(150)NTradeCode贸易方式代码String(2)Y参见贸易方式主表代码表ConsignorCode发货人代码String(10)NConsignorCn发货人中文名称String(50)NConsignorEn发货人英文名称Strin

16、g(150)NPartiTradeModeCode详细方式代码String(4)NConveyCode运输工具代码String(2)Y20 船舶29 海运集装箱31 火车32 汽车39 陆运集装箱50 飞机59 空运集装箱99 其他Tonnage运输工具吨位decimalNDeclareType报检单类别代码String(2)Y(01)一般进口(03)出区进境(05)境外进区(07)进口集装箱重箱(09)进口集装箱空箱TradeAreaCode贸易国代码String(3)Y参见国家代码表CompenValidDays索赔有效期(天)decimalNDepartAreaCode启运国(地区)代码

17、String(3)Y参见国家代码表DepartPort启运口岸代码String(6)Y参见国检国外口岸代码表MidPort经停口岸代码String(6)Y参见国检国外口岸代码表ArrivePort入境口岸代码String(8)Y参见国检国内口岸代码表Destination目的地代码String(6)Y参见国检行政区划表ArriveDate到货日期DateYYyyy-mm-ddUnloadDate卸毕日期DateYYyyy-mm-ddGoodsPlaceCode存货地点代码String(8)Y参见海关货场代码表ForeignAsset是否外商投资企业String(1)N(0：否 1:是)Back

18、TransportFlag是否退运String(1)N(0：否 1:是)Customdecl是否报关地String(1)N(0：否 1:是)Checkup财产鉴定String(1)N(0：否 1:是)AttachDocCodes随附单据代码串String(200)N多个用”,”分割MarksNum标记及号码String(200)NTreatmentFlag卫生处理状况String(1)N(0：未处理 1:已处理)多选时拼接一起,不需要分隔符TreatmentWay卫生处理方式String(3)N1:喷洒除虫2:喷洒消毒3:熏蒸SpecClause特殊要求String(100)NCertType

19、CodesList (国检需要证单数据信息)CertTypeCodes,允许出现多次，每个节点内包括CertType和CertOriginals、CertCopiesCertType单据类型代码String(1)Y参见国检证书类型表CertOriginals正本数IntYCertCopies副本数intY 表格 242.3.3.5. 进口商品货物信息GoodsList父节点子节点节点名称填写说明字段类型必填其它约束Good Customs 允许出现零次或1次，此节点为海关商品信息Customs下CustomsDeclHead子节点如下HsCode商品HS编码String(10)Y参见商品HS编

20、码表GoodsCn商品中文名称String(255)Y参见商品CIQ编码表GoodsModel规格型号String(255)YAmount总价decimalYPrice单价decimalYTradeCurr币制String(3)Y参见币制表OriginCountry原产国代码String(3)Y参见国家代码表Qty1第一计量数量decimalYUnit1第一计量单位代码String(3)Y参见计量单位代码表GQty申报数量decimalYGUnit申报计量单位代码String(3)Y参见计量单位代码表Qty2第二计量数量decimalYUnit2第二计量单位代码String(3)Y参见计量单位

21、代码表UseTo用途String(2)N参见海关用途代码表DutyMode征免代码String(1)Y参见海关征免方式代码表PrdtNo版本号String(8)NGoodsId货号String(30)NDestinationCountry最终目的国（地区）String(3)Y参见国家代码表子节点CIQ 允许出现零次或1次，此节点为国检商品信息CIQ下CIQDeclHead只允许1次，说明国检基本数据信息HsCode商品HS编码String(10)Y参见商品HS编码表CiqCodeCIQ代码String(8)N参见商品CIQ编码表GoodsCn商品中文名称String(255)Y参见商品HS编码

22、表，可修改GoodsModel规格型号String(255)YAmount总价decimalYPrice单价decimalYTradeCurr币制String(3)Y参见币种代码表OriAreaCode原产国代码String(6)Y参见国家代码表StdQuantity标准量decimalNStdUnit标准量单位代码String(3)Y参见计量单位代码表Quantity报检数量decimalNQuantityUnitCode数量单位代码String(3)N参见计量单位代码表Weight报检重量decimalNWeightUnitCode重量单位代码String(3)N参见计量单位代码表Pack

23、Quan包装数量decimalNPackKind包装种类代码String(3)N参见国检包装种类代码表UseTo国检用途String(1)Y参见国检用途代码表WasteFlag废旧标识代码String(1)N1:正常 2:废品 5:旧品9:其他Goodsort货物类型代码String(1)Y1:集装箱3:食品包装容5:一般货物HasAttachmentFlag带有动植物及其产品应检物String(1)N0:否 1:是IsCiqFlag强制CIQString(1)N0:否 1:是IsCompleteSetFlag是否成套设备String(1)N0:否 1:是VerificationConditi

24、on验证条件String(1)N01:目录内/预包装 02:目录外/非预包装MattingCode辅助包装种类代码String(4)N参见国检包装种类代码表PackNumber包装件数decimalNPackLong包装长decimalNPackWide包装宽decimalNPackHigh包装高decimalNMaterialType材料种类String(14)NProcessingFactory加工厂家String(30)NLimit 国检商品许可证Limit下LimitRecord允许出现零次或多次，子节点如下LimitCode许可证代码String(2)Y参见国检商品许可证类型代码表RegCode证书编号String(20)Y 表格 252.3.3.6. 进口集装箱信息ContainerList父节点子节点节点名称填写说明字段类型必填其它约束ContainerContainerId集装箱号String(11)YCIQContainerMd国检集装箱规格String(3)Y参见集装箱代码表CustomsContainerMd海关集装箱规格String(3)Y参见集装箱代码表ContainerWt集装箱自重decimalN表格 262.3.3.7. 出口海关数据项C