单一窗口海关数据对接规范总署版.docx
《单一窗口海关数据对接规范总署版.docx》由会员分享，可在线阅读，更多相关《单一窗口海关数据对接规范总署版.docx（81页珍藏版）》请在冰豆网上搜索。
单一窗口海关数据对接规范总署版
单一窗口海关数据对接规范-总署版
备注：
请即时查看最新版本
版本变动表
版本号
更新时间
更新内容
备注
V1.0
2016-12-26
1.新增
目前只有申报接口，与总署的接口还未联通，测试接口只测试数据申报到单一窗口，单一窗口的申报海关以及海关回执的返回待后续完善。
V1.1
2016-03-29
1.删除了清单以及入库单报文示例中多出的节点
2.新增回执报文说明
3.补充正式申报的接口地址
回执报文里，税单报文还未接收到总署的回执消息，是根据总署文档来生成的。
V1.2
2018-07-03
1.增加主动获取回执接口
可以批量获取，建议控制获取条件，最好是手动触发，防止接口并发异常。
V1.3
2018-09-21
1.订单表头增加订购人电话
2.订单表体增加规格型号
3.运单表头增加订单编号
4.清单表体增加贸易国
5.清单表体规格型号增加长度限制
根据海关总署公告2018年第113号（关于修订跨境电子商务统一版信息化系统企业接入报文规范的公告）
V1.4
2019-07-10
1.增加订单重推接口
2.增加清单重推接口
1报文传输方式
以互联网连接方式，通过https+post形式进行报文交换。
2参考资料
3报文规范约定
1.非必填字段可以不填值，但是节点必须出现。
2.字段长度：
所有字段中如出现中文，则中文字符长度占2位。
3.日期分为五种格式，请注意区分：
序号
样式
示例
备注
格式一
yyyyMMddhhmmss
200
格式二
yyyy-MM-ddhh:
mm:
ss
2015-01-0101:
01:
01
中间使用空格分隔
格式三
yyyy-MM-ddThh:
mm:
ss
2015-01-01T01:
01:
01
中间使用T分隔
格式四
yyyy-MM-dd
2015-01-01
格式五
yyyyMMddhhmmssfffff
20022222
fffff为毫秒级
4订单申报接口描述
4.1订单申报报文描述
订单报文头和报文体构成，如下所示。
4.1.1接口地址
新增申报正式地址：
:
7080/ZsOrderDec
新增申报测试地址：
:
7080/ZsOrderDec
重复申报正式地址：
:
7080/ZsOrderDecRpt
重复申报测试地址：
:
7080/ZsOrderDecRpt
4.1.2接口说明
●申报后会返回《订单申报即时返回报文》（具体报文结构详见4.1.6）。
若为S，表示申报成功，为空。
若失败，为F，中显示失败信息。
●订单申报返回接受成功，即表示单一窗口已经成功接受订单，并不表示订单已经发往海关。
●重复申报必须符合以下条件
1要重推的订单必须存在且唯一
2要重推的订单，它的关联清单必须存在且是退单状态
3要重推的订单，如果正在等待总署回执，不能重推以避免通道拥堵
●满足重复申报条件的重推订单，可以根据新的订单信息更新之前的订单信息
4.1.3订单报文根节点
CEB311Message为订单报文XML根节点名称
4.1.4订单表头报文节点描述
中文名称
英文名称
数据格式
必填
说明
系统唯一序号
guid
VARCHAR（36）
是
企业系统生成36位唯一序号（英文字母大写）。
报送类型
appType
VARCHAR
（1）
是
企业报送类型。
1-新增2-变更3-删除。
默认为1。
报送时间
appTime
VARCHAR（14）
是
企业报送时间。
格式:
YYYYMMDDhhmmss。
业务状态
appStatus
VARCHAR
（1）
是
2-申报
订单类型
orderType
VARCHAR
（1）
是
电子订单类型：
I进口
订单编号
orderNo
VARCHAR（60）
是
交易平台的订单编号，同一交易平台的订单编号应唯一。
订单编号长度不能超过60位。
电商平台代码
ebpCode
VARCHAR（18）
是
电商平台的海关注册登记编号；电商平台未在海关注册登记，由电商企业发送订单的，以中国电子口岸发布的电商平台标识编号为准。
电商平台名称
ebpName
VARCHAR（100）
是
电商平台的海关注册登记名称；电商平台未在海关注册登记，由电商企业发送订单的，以中国电子口岸发布的电商平台名称为准。
电商企业代码
ebcCode
VARCHAR（18）
是
电商企业的海关注册登记编号。
电商企业名称
ebcName
VARCHAR（100）
是
电商企业的海关注册登记名称。
商品价格
goodsValue
DECIMAL（19,5）
是
商品实际成交价，含非现金抵扣金额。
运杂费
freight
DECIMAL（19,5）
是
不包含在商品价格中的运杂费，无则填写"0"。
非现金抵扣金额
discount
DECIMAL（19,5）
是
使用积分、虚拟货币、代金券等非现金支付金额，无则填写"0"。
代扣税款
taxTotal
DECIMAL（19,5）
是
企业预先代扣的税款金额，无则填写“0”
实际支付金额
acturalPaid
DECIMAL（19,5）
是
商品价格+运杂费+代扣税款-非现金抵扣金额，与支付凭证的支付金额一致。
币制
currency
VARCHAR（3）
是
限定为人民币，填写“142”。
订购人注册号
buyerRegNo
VARCHAR（60）
是
订购人的交易平台注册号。
订购人姓名
buyerName
VARCHAR（60）
是
订购人的真实姓名。
订购人电话
buyerTelephone
VARCHAR（30）
是
海关监管对象的电话，要求实际联系电话
订购人证件类型
buyerIdType
VARCHAR
（1）
是
1-身份证
订购人证件号码
buyerIdNumber
VARCHAR（60）
是
订购人的身份证件号码。
支付企业代码
payCode
VARCHAR（18）
否
支付企业的海关注册登记编号。
支付企业名称
payName
VARCHAR（100）
否
支付企业在海关注册登记的企业名称。
支付交易编号
payTransactionId
VARCHAR（60）
否
支付企业唯一的支付流水号。
商品批次号
batchNumbers
VARCHAR（100）
否
商品批次号。
收货人姓名
consignee
VARCHAR（100）
是
收货人姓名，必须与电子运单的收货人姓名一致。
收货人电话
consigneeTelephone
VARCHAR（50）
是
收货人联系电话，必须与电子运单的收货人电话一致。
收货地址
consigneeAddress
VARCHAR（200）
是
收货地址，必须与电子运单的收货地址一致。
收货地址行政区划代码
consigneeDitrict
VARCHAR（6）
否
参照国家统计局公布的国家行政区划标准填制。
备注
note
VARCHAR（1000）
否
4.1.5订单表体报文节点描述
中文名称
英文名称
数据格式
必填
说明
商品序号
gnum
INT
是
从1开始的递增序号。
企业商品货号
itemNo
VARCHAR（30）
是
电商企业自定义的商品货号（SKU）。
国检已备案的SKU
企业商品名称
itemName
VARCHAR（250）
是
交易平台销售商品的中文名称。
商品规格型号
gmodel
VARCHAR（510）
是
满足海关归类、审价以及监管的要求为准。
包括：
品名、牌名、规格、型号、成份、含量、等级等
企业商品描述
itemDescribe
VARCHAR（1000）
否
交易平台销售商品的描述信息。
条形码
barCode
VARCHAR（50）
否
国际通用的商品条形码，一般由前缀部分、制造厂商代码、商品代码和校验码组成。
单位
unit
VARCHAR（3）
是
填写海关标准的参数代码，参照《JGS-20海关业务代码集》-计量单位代码。
数量
qty
DECIMAL（19,5）
是
商品实际数量。
单价
price
DECIMAL（19,5）
是
商品单价。
赠品单价填写为“0”。
总价
totalPrice
DECIMAL（19,5）
是
商品总价，等于单价乘以数量。
币制
currency
VARCHAR（3）
是
限定为人民币，填写“142”。
原产国
country
VARCHAR（3）
是
填写海关标准的参数代码，参照《JGS-20海关业务代码集》-国家（地区）代码表。
备注
note
VARCHAR（1000）
否
促销活动，商品单价偏离市场价格的，可以在此说明。
4.1.6订单申报即时返回报文结构
fe2a0210a1b3430592dfe682bddce90a
311
2016-06-2810:
20:
28
S
--S成功，F失败-->
--RSP_RESULTS:
返回为空RSP_RESULTF:
返回的错误信息-->
5支付单申报接口描述
5.1支付单申报报文描述
订单报文头和报文体构成，如下所示。
5.1.1接口地址
正式地址：
:
7080/ZsPayDec
测试地址：
:
7080/ZsPayDec
5.1.2接口说明
●申报后会返回《支付单申报即时返回报文》（具体报文结构详见5.1.5）。
若为S，表示申报成功，为空。
若失败，为F，中显示失败信息。
●支付单申报返回接受成功，即表示单一窗口已经成功接受支付单，并不表示支付单已经发往海关。
5.1.3支付单报文根节点
CEB411Message为支付单报文XML根节点名称
5.1.4支付单报文节点描述
中文名称
英文名称
数据格式
必填
说明
系统唯一序号
guid
VARCHAR（36）
是
企业系统生成36位唯一序号（英文字母大写）。
报送类型
appType
VARCHAR
（1）
是
企业报送类型。
1-新增2-变更3-删除。
默认为1。
报送时间
appTime
VARCHAR（14）
是
企业报送时间。
格式:
YYYYMMDDhhmmss。
业务状态
appStatus
VARCHAR（3）
是
2-申报
支付企业代码
payCode
VARCHAR（18）
是
支付企业的海关注册登记编号。
支付企业名称
payName
VARCHAR（100）
是
支付企业在海关注册登记的名称。
支付交易编号
payTransactionId
VARCHAR（60）
是
支付企业唯一的支付流水号。
订单编号
orderNo
VARCHAR（60）
是
交易平台的订单编号，同一交易平台的订单编号应唯一。
订单编号长度不能超过60位。
电商平台代码
ebpCode
VARCHAR（18）
是
电商平台的海关注册登记编号；电商平台未在海关注册登记，由电商企业发送订单的，以中国电子口岸发布的电商平台标识编号为准。
电商平台名称
ebpName
VARCHAR（100）
是
电商平台的海关注册登记名称；电商平台未在海关注册登记，由电商企业发送订单的，以中国电子口岸发布的电商平台名称为准。
支付人证件类型
payerIdType
VARCHAR
（1）
是
1-身份证,限定为身份证，
支付人证件号码
payerIdNumber
VARCHAR（60）
是
支付人的身份证件号码。
支付人姓名
payerName
VARCHAR（60）
是
支付人的真实姓名。
支付人电话
telephone
VARCHAR（60）
否
支付人的电话号码。
支付金额
amountPaid
DECIMAL（19,5）
是
支付金额。
支付币制
currency
VARCHAR（3）
是
限定为人民币，填写“142”。
支付时间
payTime
VARCHAR（14）
是
支付时间，格式:
YYYYMMDDhhmmss。
备注
note
VARCHAR（1000）
否
5.1.5支付单申报即时返回报文结构
fe2a0210a1b3430592dfe682bddce90a
411
2016-06-2810:
20:
28
S
--S成功，F失败-->
--RSP_RESULTS:
返回为空RSP_RESULTF:
返回的错误信息-->
6运单申报接口描述
6.1运单申报报文描述
运单报文头和报文体构成，如下所示。
6.1.1接口地址
正式地址：
:
7080/ZsLogisticsDec
测试地址：
:
7080/ZsLogisticsDec
6.1.2接口说明
●申报后会返回《运单申报即时返回报文》（具体报文结构详见6.1.5）。
若为S，表示申报成功，为空。
若失败，为F，中显示失败信息。
●运单申报返回接受成功，即表示单一窗口已经成功接受运单，并不表示运单已经发往海关。
6.1.3运单报文根节点
CEB511Message为运单报文XML根节点名称
6.1.4运单报文节点描述
中文名称
英文名称
数据格式
必填
说明
系统唯一序号
guid
VARCHAR（36）
是
企业系统生成36位唯一序号（英文字母大写）。
报送类型
appType
VARCHAR
（1）
是
企业报送类型。
1-新增2-变更3-删除。
默认为1。
报送时间
appTime
VARCHAR（14）
是
企业报送时间。
格式:
YYYYMMDDhhmmss。
业务状态
appStatus
VARCHAR
（1）
是
2-申报,默认为2。
物流企业代码
logisticsCode
VARCHAR（18）
是
物流企业的海关注册登记编号。
物流企业名称
logisticsName
VARCHAR（100）
是
物流企业在海关注册登记的名称。
物流运单编号
logisticsNo
VARCHAR（60）
是
物流企业的运单包裹面单号。
同一物流企业的运单编号在6个月内不重复。
运单编号长度不能超过60位。
提运单号
billNo
VARCHAR（37）
否
直购进口为海运提单、空运总单或汽车载货清单
订单编号
orderNo
VARCHAR（60）
是
交易平台的订单编号，同一交易平台应唯一
运费
freight
DECIMAL（19,5）
是
商品运输费用，无则填“0”。
保价费
insuredFee
DECIMAL（19,5）
是
商品保险费用，无则填“0”。
币制
currency
VARCHAR（3）
是
限定为人民币，填写“142”。
毛重
weight
DECIMAL（19,5）
是
单位为千克。
件数
packNo
INT
是
单个运单下包裹数，限定为“1”。
主要货物信息
goodsInfo
VARCHAR（200）
否
配送的商品信息，包括商品名称、数量等。
收货人姓名
consingee
VARCHAR（100）
是
收货人姓名。
收货地址
consigneeAddress
VARCHAR（200）
是
收货地址。
收货人电话
consigneeTelephone
VARCHAR（50）
是
收货人电话号码。
备注
note
VARCHAR（1000）
否
6.1.5运单申报即时返回报文结构
fe2a0210a1b3430592dfe682bddce90a
511
2016-06-2810:
20:
28
S
--S成功，F失败-->
--RSP_RESULTS:
返回为空RSP_RESULTF:
返回的错误信息-->
7运单状态申报接口描述
7.1运单状态申报报文描述
运单状态由报文头和报文体构成，如下所示。
7.1.1接口地址
正式地址：
:
7080/ZsLogisticsStatusDec
测试地址：
:
7080/ZsLogisticsStatusDec
7.1.2接口说明
●运单状态申报返回接受成功，即表示单一窗口已经成功接受运单状态，并不表示运单状态已经发往海关。
7.1.3运单状态报文根节点
CEB513Message为运单状态报文XML根节点名称
7.1.4运单状态报文节点描述
中文名称
英文名称
数据格式
必填
说明
报送类型
appType
VARCHAR
（1）
是
企业报送类型。
1-新增2-变更3-删除。
默认为1。
报送时间
appTime
VARCHAR（14）
是
企业报送时间。
格式:
YYYYMMDDhhmmss。
业务状态
appStatus
VARCHAR
（1）
是
2-申报。
物流企业代码
logisticsCode
VARCHAR（18）
是
物流企业的海关注册登记编号。
物流企业名称
logisticsName
VARCHAR（100）
是
物流企业在海关注册登记的名称。
物流运单编号
logisticsNo
VARCHAR（60）
是
物流企业的运单包裹面单号。
同一物流企业的运单编号在6个月内不重复。
运单编号长度不能超过60位。
物流运单状态
logisticsStatus
VARCHAR
（1）
是
物流签收状态，限定S
物流状态时间
logisticsTime
VARCHAR（14
是
物流状态发生的实际时间。
格式:
YYYYMMDDhhmmss。
备注
note
VARCHAR（1000）
否
7.1.5运单状态申报即时返回报文结构
fe2a0210a1b3430592dfe682bddce90a
513
2016-06-2810:
20:
28
S
--S成功，F失败-->
--RSP_RESULTS:
返回为空RSP_RESULTF:
返回的错误信息-->
8清单申报接口描述
8.1清单申报报文描述
清单报文头和报文体构成，如下所示。
8.1.1接口地址
新增申报正式地址：
:
7080/ZsInventoryDec
新增申报测试地址：
:
7080/ZsInventoryDec
重复申报正式地址：
:
7080/ZsInventoryDecRpt
重复申报测试地址：
:
7080/ZsInventoryDecRpt
8.1.2接口说明
●该接口用于向海关进行清单申报，申请成功后，会即时向企业发送《海关清单即时返回报文》（具体报文结构详见8.1.6）。
●清单申报返回接受成功，即表示单一窗口已经成功接受清单，并不表示清单已经发往海关。
●重复申报必须符合以下条件
1要重推的清单必须存在且唯一
2要重推的清单，状态必须是退单状态或者新增申报成功
3要重推的清单，如果正在等待总署回执，不能重推以避免通道拥堵
●满足重复申报条件的重推清单，如果是退单状态则可以根据新的清单信息更新之前的清单信息
8.1.3清单报文根节点
CEB621Message为清单报文XML根节点名称
8.1.4清单表头报文节点描述
中文名称
英文名称
数据格式
必填
说明
系统唯一序号
guid
VARCHAR（36）
是
企业系统生成36位唯一序号（英文字母大写）。
报送类型
appType
VARCHAR
（1）
是
企业报送类型。
1-新增2-变更3-删除。
默认为1。
报送时间
appTime
VARCHAR（14）
是
企业报送时间。
格式:
YYYYMMDDhhmmss。
业务状态
appStatus
VARCHAR
（1）
是
2-申报,
订单编号
orderNo
VARCHAR（60）
是
交易平台的订单编号，同一交易平台的订单编号应唯一。
订单编号长度不能超过60位。
电商平台代码
ebpCode
VARCHAR（18）
是
电商平台的海关注册登记编号；电商平台未在海关注册登记，由电商企业发送订单的，以中国电子口岸发布的电商平台标识编号为准。
升级会员 