企业与单一窗口货物申报系统接口说明.docx
《企业与单一窗口货物申报系统接口说明.docx》由会员分享,可在线阅读,更多相关《企业与单一窗口货物申报系统接口说明.docx(45页珍藏版)》请在冰点文库上搜索。
企业与单一窗口货物申报系统接口说明
企业与单一窗口货物申报系统
接口说明
2016年04月
-1-
.
修订历史
日版描作
谢安2015-11-021.1初稿徐飞跃依据报关单调整内容修订1.22016-04-05
-2-
.
.
1.
文档说明...............................................................................................................................-4-
1.1.文档描述...................................................................................................................-4-
1.2.阅读对象...................................................................................................................-4-
1.3.报文传输说明...........................................................................................................-4-
1.4.交换说明...................................................................................................................-4-
数据接口定义.......................................................................................................................-5-2.
......................................................................................................-5-.2.1.访问地址及参数
..................................................................................................................-5-.2.2.报文编码
..........................................................................................................-5-
.2.3.报文节点说明
..............................................................................................-5-.报文节点概要2.3.1.
..................................................................................................-5-.消息头定义2.3.2.
..................................................................................................-6-.消息体定义2.3.3.
.......................................................................................................-22-
.2.4.返回报文定义...........................................................................................-23-.2.4.1.上传结果示例.......................................................................................................................-23-
.2.5.例文...........................................................................................-23-.2.5.1.进口报关例文
...........................................................................................-23-.2.5.2.进口报检例文
...................................................................................-23-.进口关检联合例文2.5.3.
...........................................................................................-23-.2.5.4.出口报关例文...........................................................................................-23-.2.5.5.出口报检例文...................................................................................-24-.2.5.6.出口关检联合例文
3.....................................................................................................................................-24-附件4.
...........................................................................................................................-24-调用实例........................................................................................................-24-
Java4.1.语言调用.
-3-
.
.
1.文档说明
1.1.文档描述
为减少各企业在多套系统中重复填写进出口货物数据,实现企业应用系统将进出口货物数据直接上传到“广州国际贸易单一窗口货物申报系统”(以下简称货物申报系统),对应“货物申报系统”中“暂存”功能,制定相应的数据交换平台和数据格式。
1.2.阅读对象
数据交换平台接口开发人员、维护人员。
1.3.报文传输说明
使用HTTP方式传输数据,应用RestFul方式交换数据,业务数据和处理结果采用XML格式进行封装,用户名、密码等信息单独传输。
1.4.交换说明
1、企业必须先在单一窗口中进行统一认证,然后通过接口方式上传相应的报关、报检或关检联合数据。
2、对于同一记录,每次视为新增,即首次提交数据,如需删除多余上传数据,需在“货物申报系统”中执行“删除”操作。
3、所有项目内备注为“必填”指的是要求必填该项,但没有填入也可以上传(注:
申报口岸、经营单位、申报单位必须填写,如为空则不接收上传数据),当前主要是便于企业上载数据,企业实际尽可能按实际业务要求填写对应的数据,后续根据业务需要,对“必填”项执行相应的校验。
4、“暂存”指企业系统数据按指定格式上传到货物申报系统,“申报”指在企业系统中实现上载到QP系统或CIQ2000系统并申报(暂未实现),本期主要是实现“暂存”。
5、数据上传到“货物申报系统”中,原有的“上载”、“报关申报”、“报检申报”等操作仍在“货物申报系统”中。
-4-
.
.
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.报文节点概要
2-1图
2.3.2.消息头定义
消息头[Head]只涉及基础信息说明,不涉及具体业务内容,消息头(Head)定义如下表:
节点节点名称描述
-5-
.
.
组成规则:
[MessageId]报文唯一编号]位流水号[MessageType]_[Sender]_[SendTime]+[4[MessageType]
”当前固定为“报文类型SWCARGO001交换1.4申报。
(相关说明见定义暂存或者申报,1:
暂存;2:
[FunctionCode]报文类型)
说明[Sender]企业在电子口岸开户的公司编码发送方代码[Receiver]接收方代码电子口岸代码,固定为“GZSW”,如:
格式),时区为北京(东八区yyyyMMddhhmmss[SendTime]发送时间201506101736301
[Version]
报文格式版本号,默认是报文版本号“1.0”
2-1
表格
消息体定义2.3.3.
[Body]均由以下主要节点组成,如下:
进出口业务信息校验规则节点名称描述节点次次,至多1详细的海关数据描述,不含出现0[Customs]海关数据项商品信息1次次,至多出现详细的国检数据描述,不含0[CIQ]
国检数据项商品信息1次仅出现详细的商品货物信息数据描述。
此节点下面分为海关商和国检品货物信息[Customs]信货物商[CIQ]货商品物信息,品[GoodsList]
单[CIQ][Customs]和既可以息独出现,也可以同时出现,分别表示报关、报检或者联合关检[ContainerList]详细的集装箱数据描述次0次,至多N集装箱信息出现2-2
表格
报检或者联合关实现单独的报关、实际上传数据时,根据业务需要,对上述节点进行组合,、[CIQ]单独报检则需[ContainerList](可选择),,如单独报关则需检。
[Customs]、[GoodsList],、[GoodsList][Customs][ContainerList](可选择),联合关检则需、[CIQ],[GoodsList][ContainerList].
XSD
进口报文结构描述文档2.3.3.1.
-6-
.
.
XSD
出口报文结构描述文档2.3.3.2.
[Customs]
进口海关数据项2.3.3.3.
父节点填写说明子节点节点名称必填字段类型其它约束Y参见海关关区代[DeclPort]String(4)申报口岸代码码Y[ContractNo]String(32)合同协议号
Y[BillNo]String(32)提运单号Customs[TrafName]YString(26)运输工具名称DeclHea[VoyageNo]YString(32)航次号d
[IEPort]Y参见海关关区代基关(海String(4)进口口岸代码码据本数[ManualNo]String(12)N备案号)
信息[IEDate]DateYYYY-MM-DDN进口日期
[TradeCo]String(10)Y经营单位代码
[TradeName]String(70)
Y经营单位名称
[TrafMode]
Y
20船舶海运集装箱29
火车31
32汽车String
(2)
运输工具代码陆运集装箱39
飞机50
空运集装箱59
99其他[OwnerCode]String(10)Y收货单位编码Y[OwnerName]String(70)收货单位名称Y[AgentCode]String(10)申报单位编码YString(70)[AgentName]申报单位名称Y[CutMode]参见海关征免性String(3)
征免性质代码质代码表N
[PaymentMark]
位营经001:
单String(3)
单货002:
收纳税单位位
申报单位003:
Y
[TradeMode]
参见海关监管方String(4)
监管方式代码式代码表.
-7-
.
父节点填写说明子节点节点名称其它约束字段类型必填[License]NString(20)
许可证号String(3)
Y[TradeCountry]代码(地区)参见国家代码表启运国
[DestinationPort][DestinationCode]
装货港代码
String(4)Y参见港口代码表
Y
参见海关境内目
[PackNo]
境内目的地代码件数
String(5)decimal
Y
的地代码表
[WrapType]
Y
参见包装种类代
包装种类代码
String
(1)
码表
[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][OtherMark][OtherRate][OtherCurr][EntryType]
保费币制代码杂费标记/杂费率杂费币制代码报关单类型代码
String(3)String
(1)decimalString(3)String
(1)
NNNN
参见币制代码表率(1:
)3:
总价参见币制代码表有纸报关;(O)(W)无纸报关;有纸带清单报(L)关;
Y
单带清纸(D)无
报关;
无纸化通关(M)
CIF
(1)
[TransMode]
成交方式代码
String
(1)
Y
C&F
(2)FOB(3)
C&I(4)
市场价(5)(6)垫仓
[ApprNo][NoteS]
批准文号报关备注
String(30)String
NN
(255)
NString(18)[RelativeId]关联报关单号String(12)[RelativeManualNo]N关联备案号[BondedNo]NString(32)监管仓号N
[CustomsField]
参见海关货场代String(8)
货场代码码表
-8-
.
.
父节点CustomsDeclCertificateLis关(海t单附随息据信)
列表
子节点
节点名称
填写说明
字段类型
必填
其它约束
[EntryTransitType]
转关提前报关
String(3)
N
;003表示转关单表示普通报001
关单
[EntryPerson]
报关员名称
String(8)
N
[EntryPersonContact
报关员联系方式
String(32)
N
]
[TradeCodeScc]
编人统一收发货
String(18)
N
码
[AgentCodeScc]
编位统一申报单
String(18)
N
码
[OwnerCodeScc][CopCodeScc][SpecialRelation][PriceEffect][PaySpecialEnvoy]
统用单位消费使一编码编位统一录入单码特殊关系确认价格影响确认用付特使权使支
String(18)String(18)String(1String
(1)String
(1)
NNYYY
1:
0:
否是1:
是0:
否否1:
是0:
[TradeAreaCode][CustomsDeclCertificate],[DocuCode]
费确认)(地区贸易国允许出现多次,每个节点内包括随附单证代码
String(3)String
(1)
N[DocuCode]Y
参见国家代码表[CertCode]和参见报关随附单据类型表
[CertCode]
Y
随附单证编号
String(32)
2-3
表格
[CIQ]
进口国检数据项2.3.3.4.
父节点CIQDecl国Head(本基检
子节点
节点名称
填写说明
字段类型
必填
其它约束
[DeclPort]
申报口岸代码
String(4)
Y
参见海关关区代
码
[ContractNo]
合同协议号
String(32)
Y
[BillNo][TrafName]
提运单号运输工具名称
String(32)String(26)
YY
[VoyageNo]
航次号
String(32)
Y
[DeclTypeCode]
报检类别代码
String
(2)
Y
进口选择项:
.
-9-
.
父节点
子节点
节点名称
填写说明
字段类型
必填
其它约束
据信数)
息
入境检验检13疫
入境流向14
15入境验证出口选择项:
出境预检21
出境检验检24
疫
出境核查货25
证
[CheckOrgCode]
施检机构代码
String(6)
Y
出境验证28参见国检机构代码表
[DestOrgCode]
目的机构代码
String(6)
Y
参见国检机构代
[CorpAttr]
Y
码表1国有企业
2中外合作企业3中外合资企业
企业性质代码
String
(1)
4外商独资企业
5集体企业
6私营企业9其他
[AplPersonCode][AplLinkman]
报检员编码联系人
String(10)String(20)
NY
[AplTel]
联系电话
String(20)
Y
[DeclarationNumber
报关单号
String(50)
Y
][ConsigneeCode]
收货人代码
String(10)
Y
[ConsigneeCn]
收货人中文名称
String(50)
Y
N[ConsigneeEn]String(150收货人英文名称)
[TradeCode]
贸易方式代码
String
(2)
Y
参见贸易方式主表代码表
[ConsignorCode][ConsignorCn][ConsignorEn]
发货人代码发货人中文名称发货人英文名称
String(10)String(50)String(150
NNN
)
N[PartiTradeModeCoString(4)
详细方式代码de]
Y
[ConveyCode]
船舶20
String
(2)
运输工具代码海运集装箱29
31火车
.
-10-
.
父节点
子节点
节点名称
填写说明
字段类型
必填
其它约束
[Tonnage][DeclareType]
运输工具吨位报检单类别代码
decimalString
(2)
NY
32汽车39陆运集装箱50飞机59空运集装箱99其他一般进口(01)出区进境(03)境外进区(05)(07)进口集装箱重箱
进口集装箱(09)空箱
[TradeAreaCode][Com