企业与单一窗口货物申报系统接口说明.docx
《企业与单一窗口货物申报系统接口说明.docx》由会员分享,可在线阅读,更多相关《企业与单一窗口货物申报系统接口说明.docx(39页珍藏版)》请在冰豆网上搜索。
企业与单一窗口货物申报系统接口说明
企业与单一窗口货物申报系统
接口说明
2016年04月
修订历史
日期
版本
描述
作者
2015-11-02
1.1
初稿
谢安
2016-04-05
1.2
依据报关单调整内容修订
徐飞跃
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,时区为北京(东八区),如:
201506101736301
[Version]
报文版本号
报文格式版本号,默认是“1.0”
表格21
2.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].
2.3.3.1.进口报文结构描述文档XSD
2.3.3.2.出口报文结构描述文档XSD
2.3.3.3.进口海关数据项[Customs]
父节点
子节点
节点名称
填写说明
字段类型
必填
其它约束
Customs
DeclHead
(海关基本数据信息)
[DeclPort]
申报口岸代码
String(4)
Y
参见海关关区代码
[ContractNo]
合同协议号
String(32)
Y
[BillNo]
提运单号
String(32)
Y
[TrafName]
运输工具名称
String(26)
Y
[VoyageNo]
航次号
String(32)
Y
[IEPort]
进口口岸代码
String(4)
Y
参见海关关区代码
[ManualNo]
备案号
String(12)
N
[IEDate]
进口日期
Date
N
YYYY-MM-DD
[TradeCo]
经营单位代码
String(10)
Y
[TradeName]
经营单位名称
String(70)
Y
[TrafMode]
运输工具代码
String
(2)
Y
20船舶
29海运集装箱
31火车
32汽车
39陆运集装箱
50飞机
59空运集装箱
99其他
[OwnerCode]
收货单位编码
String(10)
Y
[OwnerName]
收货单位名称
String(70)
Y
[AgentCode]
申报单位编码
String(10)
Y
[AgentName]
申报单位名称
String(70)
Y
[CutMode]
征免性质代码
String(3)
Y
参见海关征免性质代码表
[PaymentMark]
纳税单位
String(3)
N
001:
经营单位002:
收货单位003:
申报单位
[TradeMode]
监管方式代码
String(4)
Y
参见海关监管方式代码表
[License]
许可证号
String(20)
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
参见币制代码表
[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)
N
[NoteS]
报关备注
String
(255)
N
[RelativeId]
关联报关单号
String(18)
N
[RelativeManualNo]
关联备案号
String(12)
N
[BondedNo]
监管仓号
String(32)
N
[CustomsField]
货场代码
String(8)
N
参见海关货场代码表
[EntryTransitType]
转关提前报关
String(3)
N
003表示转关单;
001表示普通报关单
[EntryPerson]
报关员名称
String(8)
N
[EntryPersonContact]
报关员联系方式
String(32)
N
[TradeCodeScc]
收发货人统一编码
String(18)
N
[AgentCodeScc]
申报单位统一编码
String(18)
N
[OwnerCodeScc]
消费使用单位统一编码
String(18)
N
[CopCodeScc]
录入单位统一编码
String(18)
N
[SpecialRelation]
特殊关系确认
String(1
Y
1:
是0:
否
[PriceEffect]
价格影响确认
String
(1)
Y
1:
是0:
否
[PaySpecialEnvoy]
支付特使权使用费确认
String
(1)
Y
1:
是0:
否
[TradeAreaCode]
贸易国(地区)
String(3)
N
参见国家代码表
CustomsDeclCertificateList(海关随附单据信息列表)
[CustomsDeclCertificate],允许出现多次,每个节点内包括[DocuCode]和[CertCode]
[DocuCode]
随附单证代码
String
(1)
Y
参见报关随附单据类型表
[CertCode]
随附单证编号
String(32)
Y
表格23
2.3.3.4.进口国检数据项[CIQ]
父节点
子节点
节点名称
填写说明
字段类型
必填
其它约束
CIQDeclHead(国检基本数据信息)
[DeclPort]
申报口岸代码
String(4)
Y
参见海关关区代码
[ContractNo]
合同协议号
String(32)
Y
[BillNo]
提运单号
String(32)
Y
[TrafName]
运输工具名称
String(26)
Y
[VoyageNo]
航次号
String(32)
Y
[DeclTypeCode]
报检类别代码
String
(2)
Y
进口选择项:
13入境检验检疫
14入境流向
15入境验证
出口选择项:
21出境预检
24出境检验检疫
25出境核查货证
28出境验证
[CheckOrgCode]
施检机构代码
String(6)
Y
参见国检机构代码表
[DestOrgCode]
目的机构代码
String(6)
Y
参见国检机构代码表
[CorpAttr]
企业性质代码
String
(1)
Y
1国有企业
2中外合作企业
3中外合资企业
4外商独资企业
5集体企业
6私营企业
9其他
[AplPersonCode]
报检员编码
String(10)
N
[AplLinkman]
联系人
String(20)
Y
[AplTel]
联系电话
String(20)
Y
[DeclarationNumber]
报关单号
String(50)
Y
[ConsigneeCode]
收货人代码
String(10)
Y
[ConsigneeCn]
收货人中文名称
String(50)
Y
[ConsigneeEn]
收货人英文名称
String(150)
N
[TradeCode]
贸易方式代码
String
(2)
Y
参见贸易方式主表代码表
[ConsignorCode]
发货人代码
String(10)
N
[ConsignorCn]
发货人中文名称
String(50)
N
[ConsignorEn]
发货人英文名称
String(150)
N
[PartiTradeModeCode]
详细方式代码
String(4)
N
[ConveyCode]
运输工具代码
String
(2)
Y
20船舶
29海运集装箱
31火车
32汽车
39陆运集装箱
50飞机
59空运集装箱
99其他
[Tonnage]
运输工具吨位
decimal
N
[DeclareType]
报检单类别代码
String
(2)
Y
(01)一般进口
(03)出区进境
(05)境外进区
(07)进口集装箱重箱
(09)进口集装箱空箱
[TradeAreaCode]
贸易国代码
String(3)
Y
参见国家代码表
[CompenValidDays]
索赔有效期(天)
decimal
N
[DepartAreaCode]
启运国(地区)代码
String(3)
Y
参见国家代码表
[DepartPort]
启运口岸代码
String(6)
Y
参见国检国外口岸代码表
[MidPort]
经停口岸代码
String(6)
Y
参见国检国外口岸代码表
[ArrivePort]
入境口岸代码
String(8)
Y
参见国检国内口岸代码表
[Destination]
目的地代码
String(6)
Y
参见国检行政区划表
[ArriveDate]
到货日期
Date
Y
Yyyy-mm-dd
[UnloadDate]
卸毕日期
Date
Y
Yyyy-mm-dd
[GoodsPlaceCode]
存货地点代码
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)
N
[TreatmentFlag]
卫生处理状况
String
(1)
N
(0:
未处理1:
已处理)多选时拼接一起,不需要分隔符
[TreatmentWay]
卫生处理方式
String(3)
N
1:
喷洒除虫
2:
喷洒消毒
3:
熏蒸
[SpecClause]
特殊要求
String
(100)
N
CertTypeCodesList(国检需要证单数据信息)
[CertTypeCodes],允许出现多次,每个节点内包括[CertType]和[CertOriginals]、[CertCopies]
[CertType]
单据类型代码
String
(1)
Y
参见国检证书类型表
[CertOriginals]
正本数
Int
Y
[CertCopies]
副本数
int
Y
表格24
2.3.3.5.进口商品货物信息[GoodsList]
父节点
子节点
节点名称
填写说明
字段类型
必填
其它约束
Good
[Customs]允许出现零次或1次,此节点为海关商品信息
[Customs]下[CustomsDeclHead]子节点如下
[HsCode]
商品HS编码
String(10)
Y
参见商品HS编码表
[GoodsCn]
商品中文名称
String
(255)
Y
参见商品CIQ编码表
[GoodsModel]
规格型号
String
(255)
Y
[Amount]
总价
decimal
Y
[Price]
单价
decimal
Y
[TradeCurr]
币制
String(3)
Y
参见币制表
[OriginCountry]
原产国代码
String(3)
Y
参见国家代码表
[Qty1]
第一计量数量
decimal
Y
[Unit1]
第一计量单位代码
String(3)
Y
参见计量单位代码表
[GQty]
申报数量
decimal
Y
[GUnit]
申报计量单位代码
String(3)
Y
参见计量单位代码表
[Qty2]
第二计量数量
decimal
Y
[Unit2]
第二计量单位代码
String(3)
Y
参见计量单位代码表
[UseTo]
用途
String
(2)
N
参见海关用途代码表
[DutyMode]
征免代码
String
(1)
Y
参见海关征免方式代码表
[PrdtNo]
版本号
String(8)
N
[GoodsId]
货号
String(30)
N
[DestinationCountry]
最终目的国(地区)
String(3)
Y
参见国家代码表
子节点[CIQ]允许出现零次或1次,此节点为国检商品信息
[CIQ]下[CIQDeclHead]只允许1次,说明国检基本数据信息
[HsCode]
商品HS编码
String(10)
Y
参见商品HS编码表
[CiqCode]
CIQ代码
String
(8)
N
参见商品CIQ编码表
[GoodsCn]
商品中文名称
String
(255)
Y
参见商品HS编码表,可修改
[GoodsModel]
规格型号
String
(255)
Y
[Amount]
总价
decimal
Y
[Price]
单价
decimal
Y
[TradeCurr]
币制
String(3)
Y
参见币种代码表
[OriAreaCode]
原产国代码
String(6)
Y
参见国家代码表
[StdQuantity]
标准量
decimal
N
[StdUnit]
标准量单位代码
String(3)
Y
参见计量单位代码表
[Quantity]
报检数量
decimal
N
[QuantityUnitCode]
数量单位代码
String(3)
N
参见计量单位代码表
[Weight]
报检重量
decimal
N
[WeightUnitCode]
重量单位代码
String(3)
N
参见计量单位代码表
[PackQuan]
包装数量
decimal
N
[PackKind]
包装种类代码
String(3)
N
参见国检包装种类代码表
[UseTo]
国检用途
String
(1)
Y
参见国检用途代码表
[WasteFlag]
废旧标识代码
String
(1)
N
1:
正常
2:
废品
5:
旧品
9:
其他
[Goodsort]
货物类型代码
String
(1)
Y
1:
集装箱
3:
食品包装容
5:
一般货物
[HasAttachmentFlag]
带有动植物及其产品应检物
String
(1)
N
0:
否1:
是
[IsCiqFlag]
强制CIQ
String
(1)
N
0:
否1:
是
[IsCompleteSetFlag]
是否成套设备
String
(1)
N
0:
否1:
是
[VerificationCondition]
验证条件
String
(1)
N
01:
目录内/预包装
02:
目录外/非预包装
[MattingCode]
辅助包装种类代码
String(4)
N
参见国检包装种类代码表
[PackNumber]
包装件数
decimal
N
[PackLong]
包装长
decimal
N
[PackWide]
包装宽
decimal
N
[PackHigh]
包装高
decimal
N
[MaterialType]
材料种类
String(14)
N
[ProcessingFactory]
加工厂家
String(30)
N
[Limit]国检商品许可证
[Limit]下[LimitRecord]允许出现零次或多次,子节点如下
[LimitCode]
许可证代码
String
(2)
Y
参见国检商品许可证类型代码表
[RegCode]
证书编号
String(20)
Y
表格25
2.3.3.6.进口集装箱信息[ContainerList]
父节点
子节点
节点名称
填写说明
字段类型
必填
其它约束
Container
[ContainerId]
集装箱号
String(11)
Y
[CIQContainerMd]
国检集装箱规格
String(3)
Y
参见集装箱代码表
[CustomsContainerMd]
海关集装箱规格
String(3)
Y
参见集装箱代码表
[ContainerWt]
集装箱自重
decimal
N
表格26
2.3.3.7.出口海关数据项[C