企业与单一窗口货物申报系统接口说明.docx
《企业与单一窗口货物申报系统接口说明.docx》由会员分享，可在线阅读，更多相关《企业与单一窗口货物申报系统接口说明.docx（12页珍藏版）》请在冰豆网上搜索。
企业与单一窗口货物申报系统接口说明
企业与单一窗口货物申报系统
接口说明
2016年04月
修订历史
日期
版本
描述
作者
2015-11-02
1.1
初稿
谢安
2016-04-05
1.2
依据报关单调整内容修订
徐飞跃
1.文档说明.-4-
1.1.文档描述.-4-
1.2.阅读对象.-4-
1.3.报文传输说明.-4-
1.4.交换说明.-4-
2.数据接口定义.-5-
2.1.访问地址及参数.-5-
2.2.报文编码.-5-
2.3.报文节点说明.-6-
2.3.1.报文节点概要.-6-
2.3.2.消息头定义.-6-
2.3.3.消息体定义.-7-
2.4.返回报文定义.-26-
2.4.1.上传结果示例.-26-
2.5.例文.-27-
2.5.1.进口报关例文.-27-
2.5.2.进口报检例文.-27-
2.5.3.进口关检联合例文.-27-
2.5.4.出口报关例文.-27-
2.5.5.出口报检例文.-27-
2.5.6.出口关检联合例文.-27-
3.附件-27-
4.调用实例.-28-
4.1.Java语言调用-28-
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格式。
23报文节点说明
231.报文节点概要
抢文【D-妾求玉一.澄咸
忖sssceT\o=^S&rc=rID_5=rvlTim*二1&尹水号・5r
CSMiofM跖瀛515
10161403105IS
Nes^aceType
FujictionCode
Receiver
Version
*--J1ft
*■.w*■»
「-・Castons由
图2-1
2.3.2.消息头定义
消息头［Head］只涉及基础信息说明，不涉及具体业务内容，消息头（Head）定义如下表:
节点
节点名称
描述
[Messageld]
报文唯编号
组成规则：
[MessageType]」Sender][SendTime]+[4位流水号]
[MessageType]
报文类型
当前固定为“SWCARGO001
[FunctionCode]
报文类型
定义暂存或者申报，1：
暂存；2:
申报。
（相关说明见1.4交换说明）
[Sender]
发送方代码彳
企业在电子口岸开户的公司编码
[Receiver]
接收方代码
电子口岸代码，固定为“GZS”
[SendTime]
发送时间
格式yyyyMMddhhmmss时区为北京（东八区），如：
201506101736301
[Version]
报文版本号
报文格式版本号，默认是1.0”
表格2-1
233.消息体定义
进出口业务信息［Body］均由以下主要节点组成，如下:
节点
节点名称
描述
校验规则
[Customs]
海关数据项
详细的海关数据描述，不含商品信息
出现0次，至多1次
[CIQ]
国检数据项
详细的国检数据描述，不含商品信息
出现0次，至多1次
[GoodsList]
商品货物信息
详细的商品货物信息数据描述。
此节点下面分为海关商品货物信息［Customs］和国检商品货物信息［CIQ］，
［Customs］和［CIQ］既可以单独出现，也可以同时出现，分别表示报关、报检或者联合关检
仅出现1次
[ContainerList]
集装箱信息
详细的集装箱数据描述
出现0次，至多N次
表格2-2
实际上传数据时，根据业务需要，对上述节点进行组合，实现单独的报关、报检或者联合关
检。
如单独报关则需［Customs］、［GoodsList］，［ContainerList］（可选择），单独报检则需
［CIQ］、［GoodsList］，［ContainerList］（可选择），联合关检则需［Customs］、［CIQ］、
［GoodsList］，［ContainerList］.
2.3.3.1.进口报文结构描述文档XSD
SiriglcWinrlrwGnodsluWithoulSameFie1
2.3.32出口报文结构描述文档XSD
SirfllrWindowGoodsOjlWilliouLSaintiEie
2.3.3.3.进口海关数据项[Customs]
父节点
子节点
节点名称
填写说明
字段类型
必填
其它约束
CustomsDecIHead
（海关基本数据信息）
[DecIPort]
申报口岸代码
String（4）
Y
参见海关关区代
码
[ContractNo]
合同协议号
String（3
2）
Y
[BillNo]
提运单号
String（3
2）
Y
[TrafName]
运输工具名称
String（2
6）
Y
[VoyageNo]
航次号
String（3
2）
Y
[IEPort]
进口口岸代码
String（4）
Y
参见海关关区代
码
[ManualNo]
备案号
String（1
2）
N
[IEDate]
进口日期
Date
N
YYYY-MM-DD
[TradeCo]
经营单位代码
String（1
0）
Y
[TradeName]
经营单位名称
String（7
0）
Y
[TrafMode]
运输工具代码
String
（2）
Y
20船舶
29海运集装箱
31火车
32汽车
39陆运集装箱
50飞机
59空运集装箱
99其他
[OwnerCode]
收货单位编码
String（1
0）
Y
[OwnerName]
收货单位名称
String（7
0）
Y
[AgentCode]
申报单位编码
String（1
Y
父节点
子节点
节点名称
填写说明
字段类型
必填
其它约束
0）
[AgentName]
申报单位名称
String（7
0）
Y
[CutMode]
征免性质代码
String（3）
Y
参见海关征免性质代码表
[PaymentMark]
纳税单位
String（3）
N
001:
经营单位
002:
收货单位
003:
申报单位
[TradeMode]
监管方式代码
String（4）
Y
参见海关监管方式代码表
[License]
许可证号
String（2
0）
N
[TradeCountry]
启运国（地区）代码
String（3）
Y
参见国家代码表
[DestinationPort]
装货港代码
String（4）
Y
参见港口代码表
[DestinationCode
]
境内目的地代码
String（5）
Y
参见海关境内目的地代码表
[PackNo]
件数
decimal
Y
[WrapType]
包装种类代码
String
（1）
Y
参见包装种类代码表
[GrossWt]
毛重
decimal
Y
[NetWt]
净重
decimal
Y
[FeeMark]
运费标记
String
（1）
N
（1:
率2:
单价
3:
总价）
[FeeRate]
运费/率
decimal
N
[FeeCurr]
运费币制代码
String（3）
N
参见币制代码表
[InsurMark]
保费标记
String
（1）
N
（1:
率3:
总价）
[InsurRate]
保费/率:
decimal
N
[InsurCurr]
保费币制代码
String（3）
N
参见币制代码表
[OtherMark]
杂费标记
String
（1）
N
（1:
率3:
总价）
[OtherRate]
杂费/率
decimal
N
[OtherCurr]
杂费币制代码
String（3）
N
参见币制代码表
报关单类型代码
String
（1）
（0）有纸报关；
（W）无纸报关；
（L）有纸带清单
父节点
子节点
节点名称
填写说明
字段类型
必填
其它约束
[EntryType]
Y
报关；
（D）无纸带清单
报关；
（M）无纸化通关
[TransMode]
成交方式代码
String
（1）
Y
（1）CIF
（2）C&F
（3）FOB
（4）C&I
（5）市场价
（6）垫仓
[ApprNo]
批准文号
String（3
0）
N
[NoteS]
报关备注
String
（255）
N
[Relativeld]
关联报关单号
String（1
8）
N
[RelativeManualNo]
关联备案号
String（1
2）
N
[BondedNo]
监管仓号
String（3
2）
N
[CustomsField]
货场代码
String（8）
N
参见海关货场代码表
[EntryTransitType]
转关提前报关
String（3）
N
003表示转关
单；
001表示普通报关单
[EntryPerson]
报关员名称
String（8）
N
[EntryPersonContact]
报关员联系方式
String（3
2）
N
[TradeCodeScc]
收发货人统编
码
String（1
8）
N
[AgentCodeScc]
申报单位统一编
码
String（1
8）
N
[OwnerCodeScc]
消费使用单位统一编码
String（1
8）
N
[CopCodeScc]
录入单位统一编
码
String（1
8）
N
[SpecialRelation]
特殊关系确认
String（1
Y
1:
是0:
否
[PriceEffect]
价格影响确认
String
（1）
Y
1:
是0:
否
升级会员 