《企业与单一窗口货物申报系统接口说明》由会员分享，可在线阅读，更多相关《企业与单一窗口货物申报系统接口说明（49页珍藏版）》请在金锄头文库上搜索。
1、企业与单一窗口货物申报系统接口说明2016 年 04 月修订历史日期版本描述作者2015-11-021.1初稿谢安2016-04-051.2依据报关单调整内容修订徐飞跃1. 文档说明 -5 -1.1. 文档描述 -5-1.2. 阅读对象 -5-1.3. 报文传输说明 -5 -1.4. 交换说明 -5-2. 数据接口定义- 7 -2.1. 访问地址及参数- 7 -2.2. 报文编码 -7-2.3. 报文节点说明 - 8 -2.3.1. 报文节点概要 -8-2.3.2. 消息头定义 -9-2.3.3. 消息体定义 -9-2.4. 返回报文定义- 46 -2.4.1. 上传结果示例 -46-2.5.
2、 例文 -47 -2.5.1. 进口报关例文 -47-2.5.2. 进口报检例文 -47-2.5.3. 进口关检联合例文- 47 -2.5.4. 出口报关例文 -47-2.5.5. 出口报检例文 -47-2.5.6. 出口关检联合例文- 48 -3. 附件 -48 -4. 调用实例 -48 -4.1. Java 语言调用 -48 -1. 文档说明1.1. 文档描述为减少各企业在多套系统中重复填写进出口货物数据， 实现企业应用系统将进出口货物数据直接上传到“广州国际贸易单一窗口货物申报系统” （以下简称货物申报系统） ，对应“货物申报系统”中“ 暂存 ”功能，制定相应的数据交换平台和数据格式。1
3、.2. 阅读对象数据交换平台接口开发人员、维护人员。1.3. 报文传输说明使用 HTTP 方式传输数据， 应用 RestFul 方式交换数据， 业务数据和处理结果采用 XML 格式进行封装，用户名、密码等信息单独传输。1.4. 交 换说明1 、 企业必须先在单一窗口中进行统一认证，然后通过接口方式上传相应的报关、报检或关检联合数据。2 、 对于同一记录， 每次视为新增， 即首次提交数据， 如需删除多余上传数据， 需在“货物申报系统”中执行“删除”操作。3 、 所有项目内备注为 “必填 ” 指的是要求必填该项， 但没有填入也可以上传 （注： 申报口岸、经营单位、 申报单位必须填写， 如为空则不接
4、收上传数据）， 当前主要是便于企业上载数据，企业实际尽可能按实际业务要求填写对应的数据，后续根据业务需要，对“必填”项执行相应的校验。4 、 “暂存 ”指企业系统数据按指定格式上传到货物申报系统， “申报 ”指在企业系统中实现上载到 QP 系统或 CIQ2000 系统并申报（暂未实现），本期主要是实现“暂存 。”5 、 数据上传到“货物申报系统”中，原有的“ 上载 ”、“ 报关申报 ”、“ 报检申报 ”等操作仍在“货物申报系统”中。2.数据接口定义2.1. 访问地址及参数地址：http:/ip:port/CargoDeclaration/restful/operatorCompany/impo
5、rt/指定参数：userName 单点登录账号；password 单点登录密码；ioFlag 进出口标示 0/进口 1/出口；report报文内容，即具体的上传数据。具体访问实例请参见“4调用实例”Report由消息头（Head）和消息体（Body）两部分组成，报文具体定义如下：2.2. 报文编码报文编码统一采用 UTF-8格式。2.3.报文节点说明2.3.1.报文节点概要NessaseTypeFuncti onCodeMessage -lSenderReceiver3,才针足 画工. 4 RZ禺 J、F1 J h-1- JISendTinc2D1510L6L4O310+0fiVersionr
6、-二 Customs +1CIQ 由a5y-EGo dsList +CntainrList图2-12.3.2. 消息头定义消息头Head只涉及基础信息说明，不涉及具体业务内容，消息头 （Head）定义如下表:节点节点名称描述Messageld报文唯一编号组成规则：MessageType _Sender_SendTime+4位流水号MessageType报文类型当前固定为“SWCARGO001 ”FunctionCode报文类型定义暂存或者申报，1:暂存2申报。（相关说明见1.4交换说明）Sender发送方代码企业在电子口岸开户的公司编码Receiver接收方代码电子口岸代码，固定为“ GZSW
7、”SendTime发送时间格式yyyyMMddhhmmss ,时区为北京 （东八区），如：201506101736301Version报文版本号报文格式版本号，默认是1.0”表格2-12.3.3. 消息体定义进出口业务信息Body均由以下主要节点组成，如下:节点节点名称描述校验规则Customs海关数据项详细的海关数据描述，不含商品信息出现0次，至多1次CIQ国检数据项详细的国检数据描述，不含出现0次，至多1次商品信息GoodsList商品货物信息详细的商品货物信息数据描 述。此节点卜面分为海关商 品货物信息Customs和国 检商品货物信息CIQ, Customs和CIQ既可以单 独出现，也
8、可以同时出现， 分别表示报关、报检或者联 合关检仅出现1次ContainerList集装箱信息详细的集装箱数据描述出现0次，至多N次表格2-2实际上传数据时，根据业务需要，对上述节点进行组合，实现单独的报关、报检或者联合关检。如单独报关则需Customs、GoodsList , ContainerList（可选择），单独报检则需CIQ GoodsList , ContainerList（可选择），联合关检则需Customs 、CIQ、GoodsList, ContainerList.2.3.3.1. 进口报文结构描述文档 XSDSi 曲已TjnrlnwGDnd 号 luWithoulSameF
9、iel2.3.3.2. 出口报文结构描述文档 XSD笆Si rleWinrlnwGoodsOu tVi Lhout5ameEi 七2.3.3.3. 进口海关数据项Customs父节点于书点节点名称填写说明字段类型必填其它约束Custom sDeclHe ad（海关基 本数据 信息）DeclPort申报口岸代码String(4)Y参见海关关区代码ContractNo合同协议号String(32)YBillNo提运单号String(32)YTrafName运输工具名称String(26)YVoyageNo航次号String(32)YIEPort进口口岸代码String(4)Y参见海关关区代码Man
10、ualNo备案号String(12)N父节点于书点节点名称填写说明字段类型必填其它约束IEDate进口日期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(70Y父节点于书点节点名称填写说明
11、字段类型必填其它约束)CutMode征免性质代码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包装种类代
12、码String。)Y参见包装种类代码表GrossWt毛重decimalYNetWt净重decimalYFeeMark运费标记String。)N（1:率 2:单价父节点于书点节点名称填写说明字段类型必填其它约束3:总价)FeeRate运费/率decimalNFeeCurr运费币制代码String(3)N参见币制代码表InsurMark保费标记String。)N(1:率3:总价)InsurRate保费/率decimalNInsurCurr保费币制代码String(3)N参见币制代码表OtherMark杂费标记String。)N(1:率3:总价)OtherRate杂费/率decimalNOtherCurr杂费币制代码String(3)N参见币制代码表EntryType报关单类型代码String。)Y(O)有纸报关；(W)无纸报关；(L)有纸带清单报关；(D)无纸带清单报关；(M)无纸化通关TransMode成交方式代码String。)Y(1) CIF(2) C&F(3) FOB(4) C&I父节点于书点节点名称填写说明字段类型必填其它约束(5)市场价(6)垫仓ApprNo批准文号String(30)NNoteS
