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

企业与单一窗口货物申报系统接口说明2016年04月修订历史日期版本描述作者2015-11-021.1初稿谢安2016-04-051.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，时区为北京(东八区)，如：201506101736301Version报文版本号报文格式版本号，默认是“1.0”表格 212.3.3. 消息体定义 进出口业务信息Body均由以下主要节点组成，如下：节点节点名称描述校验规则Customs海关数据项详细的海关数据描述，不含商品信息出现0次，至多1次CIQ国检数据项详细的国检数据描述，不含商品信息出现0次，至多1次GoodsList商品货物信息详细的商品货物信息数据描述。此节点下面分为海关商品货物信息Customs和国检商品货物信息CIQ，Customs和CIQ既可以单独出现，也可以同时出现，分别表示报关、报检或者联合关检仅出现1次ContainerList集装箱信息详细的集装箱数据描述出现0次，至多N次表格 22 实际上传数据时，根据业务需要，对上述节点进行组合，实现单独的报关、报检或者联合关检。如单独报关则需Customs、GoodsList，ContainerList（可选择），单独报检则需CIQ 、GoodsList，ContainerList（可选择），联合关检则需Customs 、CIQ、GoodsList，ContainerList.. 进口报文结构描述文档XSD. 出口报文结构描述文档XSD. 进口海关数据项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经营单位代码String(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:申报单位TradeMode监管方式代码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运费/率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成交方式代码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)NEntryPersonContact报关员联系方式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参见国家代码表CustomsDeclCertificateList (海关随附单据信息列表)CustomsDeclCertificate,允许出现多次，每个节点内包括DocuCode和CertCodeDocuCode随附单证代码String(1)Y参见报关随附单据类型表CertCode随附单证编号String(32)Y 表格 23 . 进口国检数据项CIQ父节点子节点节点名称填写说明字段类型必填其它约束CIQDeclHead (国检基本数据信息)DeclPort申报口岸代码String(4)Y参见海关关区代码ContractNo合同协议号String(32)YBillNo提运单号String(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 其他AplPersonCode报检员编码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发货人英文名称String(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启运国(地区)代码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:是)BackTransportFlag是否退运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)NCertTypeCodesList (国检需要证单数据信息)CertTypeCodes,允许出现多次，每个节点内包括CertType和CertOriginals、CertCopiesCertType单据类型代码String(1)Y参见国检证书类型表CertOriginals正本数IntYCertCopies副本数intY 表格 . 进口商品货物信息GoodsList父节点子节点节点名称填写说明字段类型必填其它约束Good Customs 允许出现零次或1次，此节点为海关商品信息Customs下CustomsDeclHead子节点如下HsCode商品HS编码String(10)Y参见商品HS编码表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参见计量单位代码表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编码表，可修改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参见计量单位代码表PackQuan包装数量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:是VerificationCondition验证条件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 表格 . 进口集装箱信息ContainerList父节点子节点节点名称填写说明字段类型必填其它约束ContainerContainerId集装箱号String(11)YCIQContainerMd国检集装箱规格String(3)Y参见集装箱代码表CustomsContainerMd海关集装箱规格String(3)Y参见集装箱代码表ContainerWt集装箱自重decimalN表格 2. 出口海关数据项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经营单位代码String(10)YTradeName经营单位名称String(70)YTrafMode运输方式代码String(1)Y参见运输工具表OwnerCode收货单位编码String(10)YOwnerName收货单位名称String(70)YAgentCode申报单位编码String(10)YAgentName申报单位名称String(70)YCutMode征免性质代码String(3)Y参见海关征免性质代码表PayMode结汇方式代码String(1)N海关结汇方式代码表PaymentMark纳税单位String(3)N001:经营单位 002:收货单位 003:申报单位TradeMode监管方式代码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运费/率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成交方式代码String(1)Y(7) CIF(8) C&F(9) FOB(10) C&I(11) 市场价(12) 垫仓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)NEntryPersonContact报关员联系方式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参见国家代码表CustomsDeclCertificateList (海关随附单据信息列表)CustomsDeclCertificate,允许出现多次，每个节点内包括DocuCode和CertCodeDocuCode随附单证代码String(1)Y参见报关随附单据类型代码表CertCode随附单证编号String(32)Y表格 2. 出口国检数据项CIQ父节点子节点节点名称填写说明字段类型必填其它约束CIQDeclHead (国检基本数据信息)DeclPort申报口岸代码String(4)Y参见海关关区代码ContractNo合同协议号String(32)YBillNo提运单号String(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 其他AplPersonCode报检员编码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发货人英文名称String(150)NPartiTradeModeCode详细方式代码String(4)NConveyCode运输工具代码String(2)Y20 船舶29 海运集装箱31 火车32 汽车39 陆运集装箱50 飞机59 空运集装箱99 其他Tonnage运输工具吨位decimalNDespDate发货日期dateYYYYY-mm-ddDeclareType报检单类别代码String(2)Y(01)一般进口(03)出区进境(05)境外进区(07)进口集装箱重箱(09)进口集装箱空箱DepartPort启运口岸代码String(6)Y参见国检国内口岸代码表DestPort到达口岸代码String(6)Y参见国检国外口岸代码表DestAreaCode输往国家(地区)代码String(3)YLcNo信用证号String(40)NGoodsPlaceCode存货地点代码String(8)Y参见海关货场代码表BackTransportFlag是否退运String(1)N(0：否 1:是)Customdecl是否报关地String(1)N(0：否 1:是)Checkup财产鉴定String(1)N(0：否 1:是)ProdNo出口批号String(20)NTreatmentFlag卫生处理状况String(1)N(0：未处理 1:已处理)多选时拼接一起,不需要分隔符TreatmentWay卫生处理方式String(3)N1:喷洒除虫 2:喷洒消毒 3:熏蒸AttachDocCodes随附单据代码串String(200)N国检入境随附单据类型表，多个用”,”分割ExchangeNoteCodes换证凭单编号串String(20)NExchangeNoteNum换证凭单份数串String(20)NPackCapResuCodes包装性能结果单编号串String(4)NPackUseResuCodes包装使用结果单编号串String(4)NResultContent厂检信息String(400)NMarksNum标记及号码String(200)NSpecClause特殊要求String(100)NCertTypeCodesList (国检需要证单数据信息)CertTypeCodes,允许出现多次，每个节点内包括CertType和CertOriginals、CertCopiesCertType单据类型代码String(1)Y参见国检证书类型表CertOriginals正本数IntYCertCopies副本数intY表格 2. 出口商品货物信息GoodsList父节点子节点节点名称填写说明字段类型必填其它约束Good Customs 允许出现零次或1次，此节点为海关商品信息Customs下CustomsDeclHead子节点如下HsCode商品HS编码String(10)Y参见商品HS编码表GoodsCn商品中文名称String(255)Y参见商品HS编码表,可修改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参见计量单位代码表DutyMode征免代码String(1)Y参见海关征免方式代码表PrdtNo版本号String(8)NGoodsId货号String(30)NProcessingFees工缴费decimalYManufactureFactory生产厂家String(100)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编码表，可修改GoodsModel规格型号String(255)YAmount总价decimalYPrice单价decimalYTradeCurr币制String(3)Y参见币制表StdQuantity标准量decimalNStdUnit标准量单位代码String(3)Y参见计量单位代码表Quantity报检数量decimalNQuantityUnitCode数量单位代码String(3)N参见计量单位代码表Weight报检重量decimalNWeightUnitCode重量单位代码String(3)N参见计量单位代码表PackQuan包装数量decimalNPackKind包装种类代码String(3)