跨境服务平台接口规范.doc

跨境电商通关API接口规范文档 版本号：V1.0.6 北京软通动力网络技术有限公司 二○一五年九月  版本修改历史 版本号. 修订日期 修订人 审核人 修改内容 V1.0.0 2015-06-07 李俊明 建立初始版本 V1.0.1 2015-05-07 丁树廷、杨迪 建立初始版本，修正字段等内容 V1.0.2 2015-07-09 丁树廷、杨迪 丰富字段相关必填等描述，并去掉没有字段 V1.0.3 2015-10-01 李俊明 调整字段名称及 删除无效字段。丰富字段描述,以及修改006接口的规则 V1.0.4 2015-12-31 丁树廷 增加 PHP算法代码样例 V1.0.5 2016-01-07 李俊明 完善附表三内容，调整 SYS0001、SYS0002、MSG0008，接口中部分字段是否必填，默认值、描述等。对08的接口交互流程描述进行调整！ V1.0.6 2016-01-07 李俊明、李旭 黄色区域(明)、蓝色区域(旭) 目 录 1. 前言 3 2. 术语、名词说明 3 3. 总体规范 4 4.1. 技术方案 4 4.2. 接口协议 4 4.2.1. 基本协议 4 4.2.2. 消息格式 4 4.2.3. 节点约束 5 4.3. 消息安全性 5 4.3.1. 数据安全 5 4.3.2. 加密算法 6 4. 接口描述 6 4.1. 订单接口 6 4.1.1. 接口描述 6 4.1.2. 交互流程 6 4.1.3. 接口规范 8 4.2. 商品备案 12 4.2.1. 接口描述 12 4.2.2. 交互流程 12 4.2.3. 接口规范 13 4.3. 数据状态查询 17 4.3.1. 接口描述 17 4.3.2. 交互流程 17 4.3.3. 接口规范 17 4.3.4. 消息类型描述 18 4.4. 物流接口 20 4.4.1. 接口描述 20 4.4.2. 交互流程 20 4.4.3. 接口规范 20 4.5. 支付接口 24 4.5.1. 接口描述 24 4.5.2. 交互流程 24 4.5.3. 接口规范 24 Token及其它相关说明 26 附录一：PDU通用HEAD（消息头） 27 附录二：数据类型 1 附录三：消息类型 1 附录四：算法说明 2 前言 为了帮助SI开发可接入应用管理平台的应用，特制定本规范。应用管理系统向应用管理平台发起和接收请求的接口都应遵从本规范。 本规范规定了应用管理系统与应用管理平台之间的接口及协议。说明了在开通、使用中小企业信息化应用业务过程中应用管理平台与应用管理系统交互的流程，并对流程中涉及的接口进行了定义。 术语、名词说明 名称 描述 SI Service Integrator，应用提供商,例如我们公司做了iecpro应用那么我们公司就算一个SI 商城应用 SI提供的付费或免费服务软件，我们所做的iecpro就算一个商城应用 应用管理平台 提供对si以及si所提供的应用的管理 UID Unified ID（统一ID），用户在系统中的唯一标识 SI_ID 业务提供商在应用管理平台中统一的ID，全局唯一 SE_ID Xing800商城中卖家的唯一标识 PV Page View，页面浏览量或点击量, PV反映的是浏览某网站的页面数，所以每刷新一次也算一次。就是说PV与来访者的数量成正比，但PV并不是页面的来访者数量，而是网站被访问的页面数量。 某IP地址的计算机访问网站的次数。这种统计方式很容易实现，具有真实性。所以是衡量网站流量的重要指标。UV 独立访客：可以理解成访问某网站的电脑的数量。网站判断来访电脑的身份是通过来访电脑的cookies实现的。如果更换了IP后但不清除cookies，再访问相同网站，该网站的统计中UV数是不变的。 甲乙丙三人某台通过ADSL的电脑，访问了“goto52”这个网站，并且每人各浏览了2个页面，那么网站的流量统计是：IP(独立IP):1,PV(访问量):6（3人乘以2个页面）,UV(独立访客):1； 若三人都是更换了IP（ADSL重新拨号）后各浏览了2个页面，则IP(独立IP):3,PV(访问量):6,UV(独立访客):1。 所以，IP(独立IP)反映的是网络地址对象的数量，UV(独立访客)反映的是实际使用者的数量，每个UV相对于每个ip更准确地对应一个实际的浏览者。 技术方案 本系统对外集成通信接口采用HTTP协议的标准request的post请求实现作为应用管理平台与外部各系统（应用）之间的主要通信接口。 接口协议 双方的消息交互采用标准的HTTP协议。通过发起H