{跨境一步达}

1、物流企业数据交换接口报文规范1 跨跨境境一一步步达达 跨跨境境贸贸易易电电子子商商务务通通关关服服务务平平台台 物物流流 企企业业数数据据交交换换接接口口报报文文规规范范（进进口口）物流企业数据交换接口报文规范2浙江电子口岸2014 年 2 月 21 日变更纪录变更纪录版本号变更日期变更人主要变动备注1.02014-2-21楼建华初稿创建2.02014-6-27楼建华物流接口字段变更2.12015-01-22吴晓峰2.2 运单接口：1） 邮编改为非必填2） 直邮模式下，总运单号必填物流企业数据交换接口报文规范31概述概述1.1 规范说明规范说明 跨境一步达是浙江电子口岸面向跨境贸易电子商务提供

2、集通关申报、信息服务和查询服务为一体的信息平台。跨境贸易电子商务通关服务平台（以下简称“通关服务平台” ）是跨境一步达平台下实现电商企业、仓储物流企业、支付企业等向海关、检验检验等实现通关业务申报的业务申报平台。 电商企业数据交换接口报文规范（进口） （以下简称规范 ） ，描述跨境贸易进口电子商务业务中电商企业信息平台与跨境一步达平台之间数据交互的报文接口规范。1.2 数据交换方式数据交换方式数据交换目前提供 WebService 三种数据交换方式.1.3 术语与缩写解释术语与缩写解释表 1. 术语与缩写解释缩写、术语缩写、术语解解 释释跨境一步达跨境一步达是浙江电子口岸面向跨境贸易电子商务提

3、供集通关申报、信息服务和查询服务为一体的信息平台1.4 数据交换接口说明数据交换接口说明跨境贸易进口电子商务业务中物流企业信息平台与跨境一步达之间数据交互的数据交换接口定义如下：序号序号接口名称接口名称包含内容包含内容签名信息1运单信息写入跨境电子商务平台运单信息签名信息2物流数据写入跨境电子商务平台物流信息签名信息3个人物品申报单写入跨境电子商务平台个人物品申报单信息物流企业数据交换接口报文规范4签名信息4个人物品申报单海关审批结果接收审批信息签名信息处理结果处理结果文字信息记录列表处理结果文字信息记录明细5回执报文处理结果文字 注： 跨境电子商务平台系统发送给企业的业务报文（系统回执除外）

4、不包含签名信息。其中每一个 XML 接口文件都对应一个独立业务功能点，其中的数据定义包括了各个功能所需的完整业务数据。XML 接口文件具有统一数据格式，数据组织都以相对独立的数据段形式集中组织，除“回执”接口外，基本上划分为签名信息段、业务数据表头段、业务数据表体段。1.1代码说明代码说明在接口中，有很多字段要求用户准备数据时要填写相对应的代码， 关区、包装种类、物流跟踪状态代码表请参考跨境贸易电子商务通关服务平台-企业数据交换报文参数说明.xlsx参数参数取值取值备注备注系统类型JKF固定为 JKFLOGISTICS_INFO物流状态IMPORTBILL商品运单RESULT回执业务类型PER

5、SONAL_GOODS_DECLAR个人物品申报单1新增申报类型2修改1业务数据结果类型2回执数据物流企业数据交换接口报文规范5运单号加物流状态码邮包编号+状态码业务编号运单号邮包编号交换时间yyyymmddhh24miss如: 201008030910222接口规范说明接口规范说明2.1 报文命名规范报文命名规范无无2.2运单信息发送跨境电子商务平台运单信息发送跨境电子商务平台2.2.1业务流程图业务流程图电商跨境一步达平台海关物流企业6、物流状态数据国检2、订单1、2、3、4、5、67、审单回执支付企业1、24、运单（5、个人物品申报单）1、企业、商品备案信息清关公司5、个人物品申报单信息

6、3、支付数据海关回执海关回执海关回执注注:该接口的申报环节对应图中画红色部分线条该接口的申报环节对应图中画红色部分线条2.2.2报文结构报文结构XML 报文结构标志报文结构标志说明说明备注备注物流企业数据交换接口报文规范6签名信息运单信息2.2.3XML 格式格式 IMPORTBILL 企业备案编号企业备案编号 运单号运单号 IMPORTBILL 1 备注备注 分运单号分运单号 总运单号总运单号 件数件数 毛重毛重 净重净重 主要货物名称主要货物名称 发件地区发件地区 收件地区收件地区 物流企业数据交换接口报文规范7收件人名称收件人名称 收件人地址收件人地址 收件人联系方式收件人联系方式 邮编

7、邮编 关区代码关区代码 价值价值币制币制 进口日期进口日期 物流企业备案编号物流企业备案名称备注2.2.4签名信息签名信息 序号序号XMLXML 标签项标签项中文说明中文说明数据类型数据类型是否是否必填必填备注备注1 企业备案编号VARCHAR2(20)非空发送方备案编号,不可随意填写2业务编号VARCHAR2(100)非空可以是运单号, 主要作用是回执给到企业的时候通过这个编号企业能认出对应之前发送的哪个单子3业务类型VARCHAR2(10)非空业务类型 IMPORTBILL4申报类型CHAR(1)非空申报类型代码固定填写 1物流企业数据交换接口报文规范85备注VARCHAR2(256)可空

8、2.2.5运单信息运单信息 序号序号XMLXML 标签项标签项中文说明中文说明数据类型数据类型是否是否必填必填备注备注1运单号VARCHAR2(50)必填运单号2总运单号VARCHAR2(50)非必填 总运单号直邮模式下，总运单号必填3件数NUMBER必填件数4毛重NUMBER(15,4)必填毛重5净重NUMBER(15,4)非必填 净重6主要货物名称NVARCHAR2(255)必填主要货物名称7发件地区NVARCHAR2(100)必填发件地区8收件地区NVARCHAR2(100)必填收件地区9收件人名称NVARCHAR2(60) 必填收件人名称10收件人地址VARCHAR2(255) 必填收

9、件人地址11收件人联系方式 VARCHAR2(60)必填收件人联系方式12邮编VARCHAR2(20)非必填 收件人邮编13关区代码VARCHAR2(4)必填关区代码，见参数表14价值NUMBER(15,4)必填应与订单货款一致15进口日期DATE必填格式要求：2012-04-23物流企业数据交换接口报文规范916币制VARCHAR2(3)必填见参数表17 物流企业备案编号码VARCHAR2(20)必填国内派送物流企业备案编号18物流企业备案名称NVARCHAR2(200)必填国内派送物流企业备案名称19备注VARCHAR2(1000)非必填2.3物流数据发送跨境电子商务平台物流数据发送跨境电

10、子商务平台2.3.1业务流程图业务流程图电商跨境一步达平台海关物流企业6、物流状态数据国检2、订单1、2、3、4、5、67、审单回执支付企业1、24、运单（5、个人物品申报单）1、企业、商品备案信息清关公司5、个人物品申报单信息3、支付数据海关回执海关回执海关回执注注:该接口的申报环节对应图中画红色部分线条该接口的申报环节对应图中画红色部分线条2.3.2报文结构报文结构XML 报文结构标志报文结构标志说明说明备注备注 物流企业数据交换接口报文规范10 签名信息 物流数据信息2.3.3XML 格式格式 LOGISTICS_INFO 发送方企业备案编号 业务编码 LOGISTICS_INFO 1

11、备注 物流企业备案编号 物流企业备案名称 物流运单号物流内部编号 物流跟踪状态 重量(kg) 件数物流企业数据交换接口报文规范11 操作时间 场站代码 车牌号 2.3.4签名信息签名信息 序号序号XMLXML 标签项标签项中文说明中文说明数据类型数据类型是否是否必填必填备注备注1 企业备案编号 VARCHAR2(20)是发送方备案编号,不可随意填写2业务编号VARCHAR2(100) 是运单号加物流跟踪状态,如运单 111，状态20 填写 111203业务类型VARCHAR2(30)是业务类型 LOGISTICS_INFO4申报类型CHAR(1)是申报类型代码固定填写 15备注VARCHAR2

12、(256) 否2.3.5物流数据信息物流数据信息 序号序号XMLXML 标签项标签项中文说明中文说明数据类型数据类型是否是否必填必填备注备注1 物流企业备案编号码VARCHAR2(20)是物流企业备案编号2物流企业备案名称NVARCHAR2(200)是物流企业备案名称3 物流运单号VARCHAR2(30)是物流运单号4物流内部编号 VARCHAR2(30)否物流内部编号5物流跟踪状态,CHAR(2)是10（启运）：物流企业数据交换接口报文规范12直邮需要发送10-50 状态，保税发送 40-50 状态20（抵港）：抵达机场30（到货）：包裹运抵至监管中心40（离开）：放行包裹离开监管中心50（

13、签收）：买家签收60（到货确认）：买家退货后，货退回到商家手中的确认点。6重量(kg)NUMBER是重量(kg)7件数NUMBER是件数8操作时间DATETIME是yyyy-MM-dd HH:mm:ss9场站代码VARCHAR2(20)是见参数文档10车牌号VARCHAR2(24)否转入/出的车牌物流企业数据交换接口报文规范132.4企业接收跨境电子商务平台回执企业接收跨境电子商务平台回执 2.4.1业务流程图业务流程图电商跨境一步达平台海关物流企业6、物流状态数据国检2、订单1、2、3、4、5、67、审单回执支付企业1、24、运单（5、个人物品申报单）1、企业、商品备案信息清关公司5、个人物

14、品申报单信息3、支付数据海关回执海关回执海关回执电子口岸回执注注:该接口的数据接收环节对应图中画红色部分线条该接口的数据接收环节对应图中画红色部分线条2.4.2报文结构报文结构报文结构采用 XML 标准设计，XML 报文结构标志报文结构标志说明说明备注备注处理结果处理结果处理结果文字信息记录列表处理结果文字信息记录列表处理结果文字信息记录明细处理结果文字处理结果文字2.4.3XML 格式格式RESULT物流企业数据交换接口报文规范14 企业备案编号企业备案编号 企业业务编号企业业务编号 业务类型业务类型 申报类型申报类型 处理结果处理结果 通知日期通知日期 通知时间通知时间 备注备注 5 位数

15、据校验状态码位数据校验状态码+冒号冒号+处理结果文字信息处理结果文字信息 . . 2.4.4处理结果处理结果 序号序号XMLXML 标签项标签项中文说明中文说明数据类型数据类型是否是否必填必填备注备注1企业编码VARCHAR2(20)非空接收方备案编号2业务编号VARCHAR2(24)非空企业系统根据该字段识别对应原发送记录3业务类型VARCHAR2(20)非空业务类型代码4申报类型CHAR(1)非空申报类型代码物流企业数据交换接口报文规范155处理结果CHAR(1)非空成功 1，失败 2，已存在 36通知日期DATE非空YYYY-MM-DD7通知时间VARCHAR2(8)非空HH:MM8备注

16、VARCHAR2(254) 可空ZJPORTRESULT 表示浙江电子口岸反馈处理结果2.4.5处理结果文字信息记录明细处理结果文字信息记录明细 序号序号XMLXML 标签项标签项中文说明中文说明数据类型数据类型是否是否必填必填备注备注15 位数据校验状态码+冒号+处理结果文字信息VARCHAR2(70)非空5 位校验状态码+冒号+处理结果文字信息，格式类似：22001:企业编号未备5 位校验码定义见文档2.5报文举例报文举例2.5.1运单报文样例运单报文样例 IMPORTBILL 3301968800 RC219262556CN IMPORTBILL物流企业数据交换接口报文规范16 1 备注 RC219262556CN test0001 3 45.0 34.4 红酒 浙江杭州 浙江金华 lucy 浙江杭州 124235353 320000 2900 600.34 5022012-09-23 000332 电子口岸备注 2.5.2