企业与单一窗口货物申报系统接口说明.docx
《企业与单一窗口货物申报系统接口说明.docx》由会员分享，可在线阅读，更多相关《企业与单一窗口货物申报系统接口说明.docx（43页珍藏版）》请在冰点文库上搜索。
企业与单一窗口货物申报系统接口说明
企业与单一窗口货物申报系统
接口说明
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.报文节点说明-5-
2.3.1.报文节点概要-5-
2.3.2.消息头定义-5-
2.3.3.消息体定义-6-
2.4.返回报文定义-22-
2.4.1.上传结果示例-22-
2.5.例文-23-
2.5.1.进口报关例文-23-
2.5.2.进口报检例文-23-
2.5.3.进口关检联合例文-23-
2.5.4.出口报关例文-23-
2.5.5.出口报检例文-23-
2.5.6.出口关检联合例文-23-
3.附件-23-
4.调用实例-23-
4.1.Java语言调用-23-
1.文档说明
1.1.文档描述
为减少各企业在多套系统中重复填写进出口货物数据，实现企业应用系统将进出口货物数据直接上传到“国际贸易单一窗口货物申报系统”（以下简称货物申报系统），对应“货物
申报系统”中“暂存”功能，制定相应的数据交换平台和数据格式。
1.2.阅读对象
数据交换平台接口开发人员、维护人员。
1.3.报文传输说明
使用HTTP方式传输数据，应用RestFul方式交换数据，业务数据和处理结果采用XML
格式进行封装，用户名、密码等信息单独传输。
1.4.交换说明
1、
企业必须先在单一窗口中进行统一认证，然后通过接口方式上传相应的报关、报检或关检联合数据。
2、
对于同一记录，每次视为新增，即首次提交数据，如需删除多余上传数据，需在“货物申报系统”中执行“删除”操作。
3、
所有项目备注为“必填”指的是要求必填该项，但没有填入也可以上传
经营单位、申报单位必须填写，如为空则不接收上传数据
（注：
申报口岸、
），当前主要是便于企业上载
4、
数据，企业实际尽可能按实际业务要求填写对应的数据，
项执行相应的校验。
后续根据业务需要，对“必填”
“暂存”指企业系统数据按指定格式上传到货物申报系统，
现上载到QP系统或CIQ2000系统并申报（暂未实现），本期主要是实现“
申报”指在企业系统中实
暂存”。
5、数据上传到“货物申报系统”中，原有的作仍在“货物申报系统”中。
上载”、“报关申报”、“报检申报”等操
2.数据接口定义
2.1.访问地址及参数
地址：
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）定义如下表:
[MessageId]
报文唯编号
组成规则：
[MessageType]」Sender][SendTime]+[4位流水号]
[MessageType]
报文类型
当前固定为“SWCARG0001
[FunctionCode]
报文类型
定义暂存或者申报，1:
暂存;2:
申报。
（相关说明见1.4交换说明）
[Sender]
发送方代码
企业在电子口岸开户的公司编码
[Receiver]
接收方代码
电子口岸代码，固定为“GZSW
[SendTime]
:
发送时间
格式yyyyMMddhhmmss，时区为（东八区），如：
6301
[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
2332出口报文结构描述文档XSD
2333进口海关数据项[Customs]
父节点
子节点
节点名称
填写说明
字段类型
必填
其它约束
CustomsDecIHead
（海关基本数据信息）
[DecIPort]
申报口岸代码
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
参见国家代码表
CustomsDeciCertificateList（海关随附单据信息列表）
[CustomsDeclCertificate],允许出现多次，每个节点包括[DocuCode]和[CertCode]
[DocuCode]
随附单证代码
String
（1）
Y
参见报关随附单据类型表
[CertCode]
随附单证编号
String（32）
Y
表格2-3
2334进口国检数据项[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]
发货人中文名称1
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
表格2-4
233.5.进口商品货物信息[GoodsList]
父节点
子节点
节点名称
填写说明
字段类型
必填
其它约束
Good
[Customs]允许出现零次或1次，此节点为海关商品信息
[Customs]下[CustomsDecIHead]子节点如下
[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]
原产国代码1
String（3）
Y
参见国家代码表
[Qty1]
第一计量数量1
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
[Goodsld]
货号:
String（30）
N
[DestinationCountry]
最终目的国（地区）
String（3）
Y
参见国家代码表
子节点［CIQ］允许出现零次或1次，此节点为国检商品信息
［CIQ］下［CIQDecIHead］只允许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]
货物类型代码
升级会员 