单一窗口海关数据对接规范总署版.docx

1、单一窗口海关数据对接规范总署版单一窗口海关数据对接规范-总署版备注：请即时查看最新版本版本变动表版本号更新时间更新内容备注V1.02016-12-261.新增目前只有申报接口，与总署的接口还未联通，测试接口只测试数据申报到单一窗口，单一窗口的申报海关以及海关回执的返回待后续完善。V1.12016-03-291.删除了清单以及入库单报文示例中多出的节点2.新增回执报文说明3.补充正式申报的接口地址回执报文里，税单报文还未接收到总署的回执消息，是根据总署文档来生成的。V1.22018-07-031.增加主动获取回执接口可以批量获取，建议控制获取条件，最好是手动触发，防止接口并发异常。V1.3201

2、8-09-211.订单表头增加订购人电话2.订单表体增加规格型号3.运单表头增加订单编号4.清单表体增加贸易国5.清单表体规格型号增加长度限制根据海关总署公告2018年第113号（关于修订跨境电子商务统一版信息化系统企业接入报文规范的公告）V1.42019-07-101.增加订单重推接口2.增加清单重推接口1报文传输方式以互联网连接方式，通过https+post形式进行报文交换。2参考资料3报文规范约定1.非必填字段可以不填值，但是节点必须出现。2.字段长度：所有字段中如出现中文，则中文字符长度占2位。3.日期分为五种格式，请注意区分：序号样式示例备注格式一yyyyMMddhhmmss200格

3、式二yyyy-MM-dd hh:mm:ss2015-01-01 01:01:01中间使用空格分隔格式三yyyy-MM-ddThh:mm:ss2015-01-01T01:01:01中间使用T分隔格式四yyyy-MM-dd2015-01-01格式五yyyyMMddhhmmssfffff20022222fffff为毫秒级4订单申报接口描述4.1订单申报报文描述订单报文头和报文体构成，如下所示。4.1.1接口地址新增申报正式地址：:7080/ZsOrderDec新增申报测试地址：:7080/ZsOrderDec重复申报正式地址：:7080/ZsOrderDecRpt重复申报测试地址：:7080/ZsO

4、rderDecRpt4.1.2接口说明申报后会返回订单申报即时返回报文（具体报文结构详见4.1.6）。若为S，表示申报成功，为空。若失败，为F，中显示失败信息。订单申报返回接受成功，即表示单一窗口已经成功接受订单，并不表示订单已经发往海关。重复申报必须符合以下条件1 要重推的订单必须存在且唯一2 要重推的订单，它的关联清单必须存在且是退单状态3 要重推的订单，如果正在等待总署回执，不能重推以避免通道拥堵满足重复申报条件的重推订单，可以根据新的订单信息更新之前的订单信息4.1.3订单报文根节点CEB311Message为订单报文XML根节点名称4.1.4订单表头报文节点描述中文名称英文名称数据格

5、式必填说明系统唯一序号guidVARCHAR(36)是企业系统生成36位唯一序号（英文字母大写）。报送类型appTypeVARCHAR(1)是企业报送类型。1-新增 2-变更 3-删除。默认为1。报送时间appTimeVARCHAR(14)是企业报送时间。格式:YYYYMMDDhhmmss。业务状态appStatusVARCHAR(1)是2-申报订单类型orderTypeVARCHAR(1)是电子订单类型：I进口订单编号orderNoVARCHAR(60)是交易平台的订单编号，同一交易平台的订单编号应唯一。订单编号长度不能超过60位。电商平台代码ebpCodeVARCHAR(18)是电商平台的

6、海关注册登记编号；电商平台未在海关注册登记，由电商企业发送订单的，以中国电子口岸发布的电商平台标识编号为准。电商平台名称ebpNameVARCHAR(100)是电商平台的海关注册登记名称；电商平台未在海关注册登记，由电商企业发送订单的，以中国电子口岸发布的电商平台名称为准。电商企业代码ebcCodeVARCHAR(18)是电商企业的海关注册登记编号。电商企业名称ebcNameVARCHAR(100)是电商企业的海关注册登记名称。商品价格goodsValueDECIMAL(19, 5)是商品实际成交价，含非现金抵扣金额。运杂费freightDECIMAL(19, 5)是不包含在商品价格中的运杂费

7、，无则填写0。非现金抵扣金额discountDECIMAL(19, 5)是使用积分、虚拟货币、代金券等非现金支付金额，无则填写0。代扣税款taxTotalDECIMAL(19, 5)是企业预先代扣的税款金额，无则填写“0”实际支付金额acturalPaidDECIMAL(19, 5)是商品价格+运杂费+代扣税款-非现金抵扣金额，与支付凭证的支付金额一致。币制currencyVARCHAR(3)是限定为人民币，填写“142”。订购人注册号buyerRegNoVARCHAR(60)是订购人的交易平台注册号。订购人姓名buyerNameVARCHAR(60)是订购人的真实姓名。订购人电话buyerT

8、elephoneVARCHAR(30)是海关监管对象的电话，要求实际联系电话订购人证件类型buyerIdTypeVARCHAR(1)是1-身份证订购人证件号码buyerIdNumberVARCHAR(60)是订购人的身份证件号码。支付企业代码payCodeVARCHAR(18)否支付企业的海关注册登记编号。支付企业名称payNameVARCHAR(100)否支付企业在海关注册登记的企业名称。支付交易编号payTransactionIdVARCHAR(60)否支付企业唯一的支付流水号。商品批次号batchNumbersVARCHAR(100)否商品批次号。收货人姓名consigneeVARCHA

9、R(100)是收货人姓名，必须与电子运单的收货人姓名一致。收货人电话consigneeTelephoneVARCHAR(50)是收货人联系电话，必须与电子运单的收货人电话一致。收货地址consigneeAddressVARCHAR(200)是收货地址，必须与电子运单的收货地址一致。收货地址行政区划代码consigneeDitrictVARCHAR(6)否参照国家统计局公布的国家行政区划标准填制。备注noteVARCHAR(1000)否4.1.5订单表体报文节点描述中文名称英文名称数据格式必填说明商品序号gnumINT是从1开始的递增序号。企业商品货号itemNoVARCHAR(30)是电商企业

10、自定义的商品货号（SKU）。国检已备案的SKU企业商品名称itemNameVARCHAR(250)是交易平台销售商品的中文名称。商品规格型号gmodelVARCHAR(510)是满足海关归类、审价以及监管的要求为准。包括：品名、牌名、规格、型号、成份、含量、等级等企业商品描述itemDescribeVARCHAR(1000)否交易平台销售商品的描述信息。条形码barCodeVARCHAR(50)否国际通用的商品条形码，一般由前缀部分、制造厂商代码、商品代码和校验码组成。单位unitVARCHAR(3)是填写海关标准的参数代码，参照JGS-20 海关业务代码集- 计量单位代码。数量qtyDECI

11、MAL(19, 5)是商品实际数量。单价priceDECIMAL(19, 5)是商品单价。赠品单价填写为“0”。总价totalPriceDECIMAL(19, 5)是商品总价，等于单价乘以数量。币制currencyVARCHAR(3)是限定为人民币，填写“142”。原产国countryVARCHAR(3)是填写海关标准的参数代码，参照JGS-20 海关业务代码集-国家（地区）代码表。备注noteVARCHAR(1000)否促销活动，商品单价偏离市场价格的，可以在此说明。4.1.6订单申报即时返回报文结构 fe2a0210a1b3430592dfe682bddce90a 311 2016-06-

12、28 10:20:28 S 5支付单申报接口描述5.1支付单申报报文描述订单报文头和报文体构成，如下所示。5.1.1接口地址正式地址：:7080/ZsPayDec测试地址：:7080/ZsPayDec5.1.2接口说明申报后会返回支付单申报即时返回报文（具体报文结构详见5.1.5）。若为S，表示申报成功，为空。若失败，为F，中显示失败信息。支付单申报返回接受成功，即表示单一窗口已经成功接受支付单，并不表示支付单已经发往海关。5.1.3支付单报文根节点CEB411Message为支付单报文XML根节点名称5.1.4支付单报文节点描述中文名称英文名称数据格式必填说明系统唯一序号guidVARCHA

13、R(36)是企业系统生成36位唯一序号（英文字母大写）。报送类型appTypeVARCHAR(1)是企业报送类型。1-新增 2-变更 3-删除。默认为1。报送时间appTimeVARCHAR(14)是企业报送时间。格式:YYYYMMDDhhmmss。业务状态appStatusVARCHAR(3)是2-申报 支付企业代码payCodeVARCHAR(18)是支付企业的海关注册登记编号。支付企业名称payNameVARCHAR(100)是支付企业在海关注册登记的名称。支付交易编号payTransactionIdVARCHAR(60)是支付企业唯一的支付流水号。订单编号orderNoVARCHAR(

14、60)是交易平台的订单编号，同一交易平台的订单编号应唯一。订单编号长度不能超过60位。电商平台代码ebpCodeVARCHAR(18)是电商平台的海关注册登记编号；电商平台未在海关注册登记，由电商企业发送订单的，以中国电子口岸发布的电商平台标识编号为准。电商平台名称ebpNameVARCHAR(100)是电商平台的海关注册登记名称；电商平台未在海关注册登记，由电商企业发送订单的，以中国电子口岸发布的电商平台名称为准。支付人证件类型payerIdTypeVARCHAR(1)是1-身份证,限定为身份证，支付人证件号码payerIdNumberVARCHAR(60)是支付人的身份证件号码。支付人姓名

15、payerNameVARCHAR(60)是支付人的真实姓名。支付人电话telephoneVARCHAR(60)否支付人的电话号码。支付金额amountPaidDECIMAL(19, 5)是支付金额。支付币制currencyVARCHAR(3)是限定为人民币，填写“142”。支付时间payTimeVARCHAR(14)是支付时间，格式:YYYYMMDDhhmmss。备注noteVARCHAR(1000)否5.1.5支付单申报即时返回报文结构 fe2a0210a1b3430592dfe682bddce90a 411 2016-06-28 10:20:28 S 6运单申报接口描述6.1运单申报报文描

16、述运单报文头和报文体构成，如下所示。6.1.1接口地址正式地址： :7080/ZsLogisticsDec测试地址： :7080/ZsLogisticsDec6.1.2接口说明申报后会返回运单申报即时返回报文（具体报文结构详见6.1.5）。若为S，表示申报成功，为空。若失败，为F，中显示失败信息。运单申报返回接受成功，即表示单一窗口已经成功接受运单，并不表示运单已经发往海关。6.1.3运单报文根节点CEB511Message为运单报文XML根节点名称6.1.4运单报文节点描述中文名称英文名称数据格式必填说明系统唯一序号guidVARCHAR(36)是企业系统生成36位唯一序号（英文字母大写）。

17、报送类型appTypeVARCHAR(1)是企业报送类型。1-新增 2-变更 3-删除。默认为1。报送时间appTimeVARCHAR(14)是企业报送时间。格式:YYYYMMDDhhmmss。业务状态appStatusVARCHAR(1)是2-申报,默认为2。物流企业代码logisticsCodeVARCHAR(18)是物流企业的海关注册登记编号。物流企业名称logisticsNameVARCHAR(100)是物流企业在海关注册登记的名称。物流运单编号logisticsNoVARCHAR(60)是物流企业的运单包裹面单号。同一物流企业的运单编号在6个月内不重复。运单编号长度不能超过60位。提

18、运单号billNoVARCHAR(37)否直购进口为海运提单、空运总单或汽车载货清单订单编号orderNoVARCHAR(60)是交易平台的订单编号，同一交易平台应唯一运费freightDECIMAL(19, 5)是商品运输费用，无则填“0”。保价费insuredFeeDECIMAL(19, 5)是商品保险费用，无则填“0”。币制currencyVARCHAR(3)是限定为人民币，填写“142”。毛重weightDECIMAL(19, 5)是单位为千克。件数packNoINT是单个运单下包裹数，限定为“1”。主要货物信息goodsInfoVARCHAR(200)否配送的商品信息，包括商品名称、

19、数量等。收货人姓名consingeeVARCHAR(100)是收货人姓名。收货地址consigneeAddressVARCHAR(200)是收货地址。收货人电话consigneeTelephoneVARCHAR(50)是收货人电话号码。备注noteVARCHAR(1000)否6.1.5运单申报即时返回报文结构 fe2a0210a1b3430592dfe682bddce90a 511 2016-06-28 10:20:28 S 7运单状态申报接口描述7.1运单状态申报报文描述运单状态由报文头和报文体构成，如下所示。7.1.1接口地址正式地址： :7080/ZsLogisticsStatusDec

20、测试地址： :7080/ZsLogisticsStatusDec7.1.2接口说明运单状态申报返回接受成功，即表示单一窗口已经成功接受运单状态，并不表示运单状态已经发往海关。7.1.3运单状态报文根节点CEB513Message为运单状态报文XML根节点名称7.1.4运单状态报文节点描述中文名称英文名称数据格式必填说明报送类型appTypeVARCHAR(1)是企业报送类型。1-新增 2-变更 3-删除。默认为1。报送时间appTimeVARCHAR(14)是企业报送时间。格式:YYYYMMDDhhmmss。业务状态appStatusVARCHAR(1)是2-申报。物流企业代码logistic

21、sCodeVARCHAR(18)是物流企业的海关注册登记编号。物流企业名称logisticsNameVARCHAR(100)是物流企业在海关注册登记的名称。物流运单编号logisticsNoVARCHAR(60)是物流企业的运单包裹面单号。同一物流企业的运单编号在6个月内不重复。运单编号长度不能超过60位。物流运单状态logisticsStatusVARCHAR(1)是物流签收状态，限定S物流状态时间logisticsTimeVARCHAR(14是物流状态发生的实际时间。格式:YYYYMMDDhhmmss。备注noteVARCHAR(1000)否7.1.5运单状态申报即时返回报文结构 fe2a

22、0210a1b3430592dfe682bddce90a 513 2016-06-28 10:20:28 S 8清单申报接口描述8.1清单申报报文描述清单报文头和报文体构成，如下所示。8.1.1接口地址新增申报正式地址： :7080/ZsInventoryDec新增申报测试地址： :7080/ZsInventoryDec重复申报正式地址： :7080/ZsInventoryDecRpt重复申报测试地址： :7080/ZsInventoryDecRpt8.1.2接口说明该接口用于向海关进行清单申报，申请成功后，会即时向企业发送海关清单即时返回报文（具体报文结构详见8.1.6）。清单申报返回接受成

23、功，即表示单一窗口已经成功接受清单，并不表示清单已经发往海关。重复申报必须符合以下条件1 要重推的清单必须存在且唯一2 要重推的清单，状态必须是退单状态或者新增申报成功3 要重推的清单，如果正在等待总署回执，不能重推以避免通道拥堵满足重复申报条件的重推清单，如果是退单状态则可以根据新的清单信息更新之前的清单信息8.1.3清单报文根节点CEB621Message为清单报文XML根节点名称8.1.4清单表头报文节点描述中文名称英文名称数据格式必填说明系统唯一序号guidVARCHAR(36)是企业系统生成36位唯一序号（英文字母大写）。报送类型appTypeVARCHAR(1)是企业报送类型。1-新增 2-变更 3-删除。默认为1。报送时间appTimeVARCHAR(14)是企业报送时间。格式:YYYYMMDDhhmmss。业务状态appStatusVARCHAR(1)是2-申报,订单编号orderNoVARCHAR(60)是交易平台的订单编号，同一交易平台的订单编号应唯一。订单编号长度不能超过60位。电商平台代码ebpCodeVARCHAR(18)是电商平台的海关注册登记编号；电商平台未在海关注册登记，由电商企业发送订单的，以中国电子口岸发布的电商平台标识编号为准。