《企业与单一窗口货物申报系统接口说明.docx》由会员分享，可在线阅读，更多相关《企业与单一窗口货物申报系统接口说明.docx（81页珍藏版）》请在三一文库上搜索。
1、v1.0 可编辑可修改企业与单一窗口货物申报系统接口说明2016 年 04 月- 1 - 1 -v1.0 可编辑可修改修订历史日期2015 -11-022016 -04-05版本描述初稿依据报关单调整内容修订作者谢安徐飞跃- 2 - 2 -1.2.3.4.v1.0 可编辑可修改目 录文档说明.- 4 -1.1. 文档描述.- 4 -1.2. 阅读对象.- 4 -1.3. 报文传输说明 .- 4 -1.4. 交换说明.- 4 -数据接口定义.- 6 -2.1. 访问地址及参数.- 6 -2.2. 报文编码.- 6 -2.3. 报文节点说明 .- 7 -2.3.1. 报文节点概要 .- 7 -2.
2、3.2. 消息头定义 .- 7 -2.3.3. 消息体定义 .- 8 -2.4. 返回报文定义 . - 40 -2.4.1. 上传结果示例 . - 40 -2.5. 例文. - 41 -2.5.1. 进口报关例文 . - 41 -2.5.2. 进口报检例文 . - 41 -2.5.3. 进口关检联合例文 . - 41 -2.5.4. 出口报关例文 . - 41 -2.5.5. 出口报检例文 . - 41 -2.5.6. 出口关检联合例文 . - 41 -附件. - 42 -调用实例. - 42 -4.1. Java 语言调用. - 42 - 3 - 3 -v1.0 可编辑可修改1. 文档说明1
3、.1. 文档描述为减少各企业在多套系统中重复填写进出口货物数据，实现企业应用系统将进出口货物数据直接上传到“广州国际贸易单一窗口货物申报系统”(以下简称货物申报系统)，对应“货 物申报系统”中“暂存”功能，制定相应的数据交换平台和数据格式。1.2. 阅读对象数据交换平台接口开发人员、维护人员。1.3. 报文传输说明使用 HTTP 方式传输数据，应用 RestFul 方式交换数据，业务数据和处理结果采用 XML 格式进行封装，用户名、密码等信息单独传输。1.4. 交换说明1、 企业必须先在单一窗口中进行统一认证，然后通过接口方式上传相应的报关、报检或关 检联合数据。2、 对于同一记录，每次视为新
4、增，即首次提交数据，如需删除多余上传数据，需在“货物 申报系统”中执行“删除”操作。3、 所有项目内备注为“必填” 指的是要求必填该项，但没有填入也可以上传(注：申报口岸、经营单位、申报单位必须填写，如为空则不接收上传数据 )，当前主要是便于企业上载数据，企业实际尽可能按实际业务要求填写对应的数据，后续根据业务需要，对“必 填”项执行相应的校验。4、 “暂存 ”指企业系统数据按指定格式上传到货物申报系统，“申报 ”指在企业系统中实现上载到 QP 系统或 CIQ2000 系统并申报(暂未实现)，本期主要是实现“暂存”。5、 数据上传到“货物申报系统”中，原有的“上载”、“报关申报”、“报检申报”
5、等操 作仍在“货物申报系统”中。- 4 - 4 -v1.0 可编辑可修改- 5 - 5 -v1.0 可编辑可修改2. 数据接口定义2.1. 访问地址及参数地址： 单点登录账号;passWord 单点登录密码;ioFlag 进出口标示 0/进口 1/出口;report 报文内容，即具体的上传数据。具体访问实例请参见“错误!未找到引用源。错误!未找到引用源。”Report 由消息头(Head)和消息体(Body)两部分组成，报文具体定义如下：2.2. 报文编码报文编码统一采用 UTF-8 格式。2.3. 报文节点说明2.3.1. 报文节点概要图 2-1- 6 - 6 -v1.0 可编辑可修改2.3
6、.2. 消息头定义消息头Head只涉及基础信息说明，不涉及具体业务内容，消息头(Head)定义如下表：节点MessageIdMessageType节点名称报文唯一编号报文类型描述组成规则：MessageType _Sender_SendTime+4 位流水号 当前固定为“SWCARGO001”定义暂存或者申报，1:暂存;2:申报。(相关说明见交换FunctionCode 报文类型SenderReceiverSendTimeVersion发送方代码接收方代码发送时间报文版本号说明)企业在电子口岸开户的公司编码电子口岸代码，固定为“GZSW”格式yyyyMMddhhmmss，时区为北京(东八区)，
7、如：20 报文格式版本号，默认是“”表格 2-12.3.3. 消息体定义进出口业务信息Body均由以下主要节点组成，如下：节点CustomsCIQ节点名称海关数据项国检数据项商品货物信描述详细的海关数据描述，不含 商品信息详细的国检数据描述，不含 商品信息详细的商品货物信息数据描述。此节点下面分为海关校验规则出现 0 次，至多 1 次出现 0 次，至多 1 次仅出现1次GoodsList息商品货物信息 Customs和国检商品货物信息 CIQ，- 7 - 7 -ContainerList 集装箱信息Customs 和 CIQ 既 可 以单独出现，也可以同时出现，分别表示报关、报检或 者联合关检
8、详细的集装箱数据描述 表格 2-2v1.0 可编辑可修改出现 0 次，至多 N 次实际上传数据时，根据业务需要，对上述节点进行组合，实现单独的报关、报检或者联合关检。如单独报关则需Customs、GoodsList，ContainerList（可选择），单独报检则需CIQ 、GoodsList，ContainerList（可选择），联合关检则需 Customs 、CIQ、 GoodsList，ContainerList.2.3.3.1.进口报文结构描述文档 XSD2.3.3.2.出口报文结构描述文档 XSD2.3.3.3.进口海关数据项 Customs父节点填写说明子节点节点名称字段类型Str
9、ing(4必填Y其它约束参见海关关区代DeclPort申报口岸代码)码- 8 - 8 -v1.0 可编辑可修改父节点填写说明子节点节点名称字段类型String(3必填Y其它约束CustomsContractNo合同协议号2)DeclHeaString(3YdBillNo提运单号2)( 海关基String(2Y本 数 据TrafName运输工具名称6)信息)VoyageNoString(3Y航次号2)IEPortString(4Y参见海关关区代进口口岸代码)码ManualNoString(1N备案号2)IEDateTradeCo进口日期 DateString(1NYYYYY-MM-DD经营单位代
10、码TradeName0)String(7Y经营单位名称0)TrafModeY 20 船舶29 海运集装箱 31 火车String(2运输工具代码32 汽车)39 陆运集装箱 50 飞机59 空运集装箱- 9 - 9 -v1.0 可编辑可修改父节点填写说明子节点节点名称OwnerCode字段类型必填String(1 Y其它约束99 其他收货单位编码OwnerName0)String(7 Y收货单位名称AgentCode0)String(1 Y申报单位编码AgentName0)String(7 Y申报单位名称CutMode0)String(3 Y参见海关征免性征免性质代码)质代码表PaymentM
11、arkN001: 经 营 单 位String(3纳税单位002: 收 货 单 位TradeMode)String(4 Y003:申报单位参见海关监管方监管方式代码)式代码表LicenseString(2 N许可证号0)TradeCountry启运国 ( 地区 ) 代String(3Y参见国家代码表码)DestinationPortString(4 Y参见港口代码表装货港代码DestinationCode)String(5 Y参见海关境内目境内目的地代码 )- 10 - 10 -的地代码表v1.0 可编辑可修改父节点子节点PackNoWrapType填写说明节点名称字段类型必填件数 decima
12、lYString(1Y其它约束参见包装种类代包装种类代码)码表GrossWtNetWt毛重净重decimaldecimalYYFeeMarkString(1N(1: 率 2: 单价运费标记FeeRateFeeCurr)运费/率 decimalString(3NN3:总价)参见币制代码表运费币制代码InsurMark)String(1 N (1: 率 3:总价)保费标记InsurRateInsurCurr)保费/率 decimalString(3NN参见币制代码表保费币制代码OtherMark)String(1 N (1: 率 3:总价)杂费标记OtherRateOtherCurr)杂费/率 d
13、ecimalString(3NN参见币制代码表杂费币制代码)String(1(O)有纸报关；(W)无纸报关；EntryType报关单类型代码)Y(L) 有纸带清单报关；- 11 - 11 -v1.0 可编辑可修改父节点填写说明子节点节点名称字段类型必填其它约束(D) 无纸带清单报关；(M)无纸化通关 (1) CIFTransModeY(2) C&FString(1(3) FOB成交方式代码ApprNo) (4) C&I(5) 市场价(6) 垫仓String(3 N批准文号NoteS0)String N报关备注RelativeId(255)String(1 N关联报关单号RelativeManu
14、alN8)String(1 N关联备案号oBondedNo2)String(3 N监管仓号CustomsField2)String(8 N参见海关货场代货场代码)码表EntryTransitTyp003 表 示 转 关e转关提前报关String(3N单;)001 表示普通报- 12 - 12 -v1.0 可编辑可修改父节点填写说明子节点节点名称EntryPerson字段类型必填String(8 N其它约束关单报关员名称EntryPersonCont)String(3 N报关员联系方式actTradeCodeSccAgentCodeSccOwnerCodeSccCopCodeSccSpecial
15、Relation收 发货 人统一 编 码申 报单 位统一 编 码消 费使 用单位 统 一编码录 入单 位统一 编 码特殊关系确认2)String(18)String(18)String(18)String(18)String(1NNNNY 1:是 0:否PriceEffectString(1 Y 1:是 0:否价格影响确认)PaySpecialEnvoy支 付特 使权使 用 费确认String(1)Y 1:是 0:否TradeAreaCodeString(3 N参见国家代码表C ustomsD eclCer贸易国(地区)CustomsDeclCertificate,允许出现多次，每个节点内包括
16、 DocuCode 和 CertCodetificat随附单证代码 String(1 Y- 13 - 13 -参见报关随附单v1.0 可编辑可修改父节点填写说明子节点节点名称字段类型必填其它约束eListDocuCode)据类型表( 海关随CertCodeY附 单 据String(3随附单证编号信 息 列表)2)表格 2-32.3.3.4.进口国检数据项 CIQ父节点填写说明子节点节点名称字段类型String(4必填Y其它约束参见海关关区代DeclPort申报口岸代码)码CIQDeclContractNo合同协议号String(3YHead( 国检基本 数 据信息)BillNoTrafName
17、VoyageNo提运单号运输工具名称2)String(3 Y2)String(2 Y6)String(3 Y航次号2)DeclTypeCodeY进口选择项：String(2报检类别代码13 入境检验检)疫- 14 - 14 -v1.0 可编辑可修改父节点填写说明子节点节点名称字段类型必填其它约束14 入境流向15 入境验证出口选择项：21 出境预检24 出境检验检 疫25 出境核查货 证28 出境验证CheckOrgCodeString(6 Y参见国检机构代施检机构代码DestOrgCode)String(6 Y码表参见国检机构代目的机构代码)CorpAttr YString(1企业性质代码)
18、码表1 国有企业2 中外合作企业3 中外合资企业4 外商独资企业 5 集体企业6 私营企业9 其他AplPersonCodeString(1 N报检员编码AplLinkman0)String(2 Y联系人0)- 15 - 15 -v1.0 可编辑可修改父节点填写说明子节点节点名称字段类型必填其它约束AplTelString(2Y联系电话DeclarationNumb0)String(5 Y报关单号erConsigneeCode0)String(1 Y收货人代码ConsigneeCn0)String(5 Y收货人中文名称ConsigneeEn0)String(1 N收货人英文名称TradeCod
19、e50)String(2 Y参见贸易方式主贸易方式代码)表代码表ConsignorCodeString(1 N发货人代码ConsignorCn0)String(5 N发货人中文名称ConsignorEn0)String(1 N发货人英文名称PartiTradeModeC50)String(4 N详细方式代码ode)ConveyCodeY 20 船舶String(229 海运集装箱运输工具代码) 31 火车32 汽车- 16 - 16 -v1.0 可编辑可修改父节点填写说明子节点节点名称字段类型必填其它约束39 陆运集装箱 50 飞机59 空运集装箱 99 其他TonnageDeclareTyp
20、e运输工具吨位 decimal NY (01)一般进口(03)出区进境(05)境外进区String(2报检单类别代码(07)进口集装箱TradeAreaCode)String(3 Y重箱(09)进口集装箱 空箱参见国家代码表贸易国代码)CompenValidDaysN索赔有效期(天)decimalDepartAreaCode启运国 ( 地区 ) 代String(3Y参见国家代码表码)DepartPortString(6 Y参见国检国外口启运口岸代码MidPort)String(6 Y岸代码表参见国检国外口经停口岸代码ArrivePort)String(8 Y岸代码表参见国检国内口入境口岸代码)
21、岸代码表- 17 - 17 -v1.0 可编辑可修改父节点填写说明子节点节点名称Destination字段类型String(6必填Y其它约束参见国检行政区目的地代码)划表ArriveDateUnloadDateGoodsPlaceCode到货日期卸毕日期DateDateString(8YYYYyyy-mm-ddYyyy-mm-dd参见海关货场代存货地点代码)码表ForeignAsset是 否外 商投资 企String(1N(0：否 1:是)业)BackTransportFlString(1 N (0：否 1:是)是否退运agCustomdecl)String(1 N (0：否 1:是)是否报关
22、地Checkup)String(1 N (0：否 1:是)财产鉴定AttachDocCodes)String N多 个 用 ”,” 分随附单据代码串(200)割MarksNumString N标记及号码(200)TreatmentFlagN (0 ：未处理 1:String(1已处理 ) 多选时卫生处理状况)拼接一起 , 不需要分隔符TreatmentWayString(3 N 1:喷洒除虫卫生处理方式) 2:喷洒消毒- 18 - 18 -v1.0 可编辑可修改父节点填写说明子节点节点名称SpecClause字段类型必填String N其它约束3:熏蒸CertTypeCodesL特殊要求(10
23、0)CertTypeCodes, 允 许 出 现 多 次 ， 每 个 节 点 内 包 括 CertType 和 CertOriginals、CertCopiesist ( 国检 需 要CertType单据类型代码String(1 Y)参见国检证书类 型表证 单 数据信息)CertOriginalsCertCopies正本数副本数IntintYY表格 2-42.3.3.5.进口商品货物信息GoodsList父节点填写说明子节点节点名称字段类型必填其它约束Customs 允许出现零次或1次，此节点为海关商品信息 Customs下CustomsDeclHead子节点如下GoodHsCode商品HS编
24、码String(1Y参见商品HS编码0)StringY表参见商品 CIQ 编GoodsCn商品中文名称(255)码表GoodsModelString Y规格型号(255)- 19 - 19 -v1.0 可编辑可修改父节点填写说明子节点节点名称字段类型必填其它约束AmountPrice总价单价decimaldecimalYYTradeCurrString(3Y参见币制表币制OriginCountry)String(3 Y参见国家代码表原产国代码)Qty1Unit1GQtyGUnitQty2Unit2第一计量数量第 一计 量单位 代 码申报数量申 报计 量单位 代 码第二计量数量第 二计 量单位
25、代 码decimalString(3)decimalString(3)decimalString(3)YYYYYY参见计量单位代 码表参见计量单位代 码表参见计量单位代 码表UseToDutyModePrdtNoGoodsIdDestinationCounString(2 N用途)String(1 Y征免代码)String(8 N版本号)String(3 N货号0)最 终目 的国（ 地 String(3 Y- 20 - 20 -参见海关用途代 码表参见海关征免方式代码表参见国家代码表v1.0 可编辑可修改父节点填写说明子节点节点名称字段类型必填其它约束try区） )子节点CIQ 允许出现零次或 1 次，此节点为国检商品信息CIQ下CIQDeclHead只允许 1 次，说明国检基本数据信息String(1Y参见商品HS编码HsCode商品HS编码0)StringN表参见商品 CIQ 编CiqCode CIQ代码(8)StringY码表参见商品 HS 编GoodsCn商品中文名称(255)码表，可修改GoodsModelString Y规格型号(255)AmountPrice总价单价decimaldecimalYYTradeCurrString(3Y参见币种代码表币制OriAreaCode)String(6 Y参见国家代码表原产国代码StdQuantityStdUnit)标