...
4、Generic EC Express Integration 最新已对接快递公司
二、客户接入EC流程
2、对接的各家快递公司接口文档
...
FJCPL-API-for-LINING.doc
EMS自助服务系统和大客户接口规范V1.0(取单号打印后回传数据).doc
FJCPL-API (EMS)-v1.1.doc
区域表.xlsx
...
5、商家ERP对接青龙系统流程（2015-12-31）.pdf
http://jos.jd.com/api/list.htm?id=64
...
圆通电子面单接口文档 2.2(B+).doc
圆通速递交互接口1.7_电商平台版.doc
http://open.yto.net.cn/openplatform/home
...
http://zop.zto.com/
http://testpartner.zto.cn/
...
O2O标准接口文档（新）.docx
百世系统集成协议说明（直客）.docx
百世运输标准接口文档0220.docx
...
O2O-OMS接口规范_V2.3.docx
同城配状态码.xls
...
...
http://dev.yundasys.com:15105/join/index.php
(usr:test, pwd:U2FsdGj4HbfxcRzG)
...
宅急送电子面单接口v1.1（预提供单号）.pdf
宅急送标准对接文档v4.02.pdf
...
POP开发说明V2.2.3.docx
POP开发说明V2.2.7.docx
...
联邦快递国内服务web service开发规范V1.3.4.pdf
接口扫描点信息V1.3.4-201312 - Copy.pdf
3、各家快递公司对接详情
| 快递公司 | 接口类型 | 客户 | 说明 |
| EMS | 福建中邮 | 李宁 | 福建中邮提供的接口，目前只能应用于于福建中邮签合同的客户 |
| BS | BS | 定制化接口，不可复用 | |
| 全国 | 神威、默克、探路者、安正、方太 | EMS提供的全国标准接口，可复用，但不确定客户是否会和李宁一样使用区域接口文档，项目上可以提供文档和开发进行确认 | |
| 顺丰 | 标准快递 | 李宁、BS、百丽、安琪酵母、航天云网、奥宝、安正、默克、罗氏。。 | 全国快递接口通用 |
| 京东 | 青龙 | 地素、安正 | 全国快递业务 |
| 沧海 | 安踏、BS | 全国B2B纯配业务 | |
| 中通 | 快递 | 安正、惠氏、BS、探路者、新辉 | 中通开放平台标注接口，总对总寄件下单接口 |
| O2O | 融速达（衣架） | 融速达项定制化接口 | |
| 百世 | 供应链 | 灰度、李宁 | 百世开放平台供应链接口，可复用 |
| 快递 | 惠氏、BS | 百世开放平台快递接口，可复用 | |
| 如风达 | 快递业务已经暂停 | ||
| 美食送 | BS | ||
| 韵达 | 惠氏、依阳贸易、探路者 | 下单接口版本v1.4.21 | |
| 德邦 | 新辉物流、好孩子、方太 | 对接德邦开放平台 | |
| 中铁快运 | 安踏 | 中铁CRE（订单管理系统）接口开发文档V1.1.0.docx 物流信息追踪平台接口开发设计说明V4.docx | |
| 跨越速运 | 探路者、安正、安踏 | ||
| 全一快递 | 无 | 不也确定可用性 | |
| 宅急送 | Lily、李宁、安踏、方太、BS | 宅急送下单接口V1.4.pdf 宅急送分单接口V1.02.pdf 宅急送快递单号获取接口v1.0.pdf 宅急送物流轨迹查询接口V1.0.pdf 宅急送状态推送接口V1.2.pdf | |
| 品骏 | 无 | 品骏标注接口，已经停止合作 | |
| 联邦快递 | 无 | 只对接查询接口，目前无客户使用 | |
| 申通 | BS、惠氏、安琪酵母、探路者 | 下单接口基于BS有对接，但不确定是否可以服用 追踪接口全国业务复用 | |
| 圆通 | 安正、探路者、BS | 对接圆通开放平台，可复用 | |
| 快递鸟 | 限3000次/天（即时查询）每间隔6小时抓一次状态 | ||
| 快递100 | 无 | 已经停止合作 |
EMS：目前BS（BS EC）、LiNing（EC Platform）使用中国邮政全国接口下单，使用福建中邮的接口查询物流状态（目前福建中邮不支持状态推送），和福建中邮技术进行沟通，对方建议的解决方式1、和区域中邮对接查询接口 ，实现下单、追踪的需求 2、找邮政总局要状态查询全国接口（对方也不确定是否有） 3、推动区域中邮和福建中邮沟通，将客户配置信息给一份至福建中邮，实现通过福建邮政接口查询区域中邮订单的目的， 全国追踪接口已经对接
顺丰：企业服务平台接入技术规范-V3.6 ，支持全国区域快递（B2C）业务，不支持顺丰仓业务
京东：青龙系统，支持全国快递业务，快运业务目前不确定是否可以使用
圆通：可复用于全国电商快递（B2C）业务，不过为取保接口的契合度，建议在业务沟通时将对应的圆通对接文档提供给开发进行评估
中通：对接文档http://testpartner.zto.cn/，目前和中通的开发平台对接，适用于客户直接和中通全国网点结算的快递B2C业务，同时基于oRange业务完成同中通总对总结算对接
百世汇通：目前百世内部分为供应链、快递、快运事业部，目前以及对接的运输API接口属于供应链事业部，供应链事业部业务范围覆盖百世内部所有业务，如果客户和供应链事业部签订合作协议，该接口可复用于全国快递（B2C）、O2O、B2B等业务，供应链系统会根据业务类型在内部将订单分发至不同的系统。如果客户和百世快递、快运事业部合作，则需要对接对应的快递、快运API
如风达：物流配送平台接口文档V1.5.6，支持全国区域，目前探路者使用中
顺丰同城：O2O-OMS接口规范_V2.3，支持全国范围同城业务，目前停止合作
美食送：http://docs.o3cloud.cn/uplink_port.html，支持北京同城业务，目前BS使用中
韵达：基于探路者ec业务对接，但上线后探路者并没有应用，不确定是否能复用与所有快递业务
中铁快运：目前无客户使用，不确定是否可以复用
跨越速运：目前无客户使用，不确定是否可以复用
全一快递：基于oSuper项目，未上线，其他客户使用需重新评估
快递100：目前已停用，每单产生0.1元物流追踪费用
德邦：德邦开放平台和第三方接入商交互方案V1.9，支持全国快运业务，下单接口对接a模式，目前无客户在生产环境使用
申通：基于BS项目对接“物流状态查询”接口，其他项目不可复用已经调整，目前查询接口可复用，百丽项目已经正常使用
品骏：POP开发说明V2.2.7，支持全国快递O2O、门店调拨业务，目前作为orange承运商职业门、百丽使用中
宅急送：快递接口，可复用，BS、LILY有使用
联邦快递：基于方太项目只对接联邦快递“物流状态查询”接口，其他项目不可复用
快递鸟：免费物流状态追踪平台，使用有限制，对于顺丰、如风达等快递公司订单有访问限制，同时快递鸟的物流追踪每12小时获取一次物流状态
三、客户接入EC流程
1、EC MAM
QA环境 http://192.168.6.206:8080/management/
2、EC系统配置需要的信息
EC系统分为SR、SP账号，正常业务上线需要配置SR和SP的合作管理，目前EC系统相关配置由开发同事在EC MAM中完成，但需联系客户提供如下信息
系统 | 角色 | 信息名称 | 功能 |
oTMS | 客户 | 公司代码 | oTMS的“我的快递“ |
API帐号密码 | 账单、运输时间获取、根据价格文件选择快递 | ||
承运商 | 公司代码 | ||
快递 | 客户 | 客户在快递系统中的帐号密码、月结账号等 | 向快递系统下单、查询物流信息 |
客户 | 客户 | 上游系统接收物流事件、快递单号的URL | 接受EC推送的运单号、物流节点 |
备注： 需要提供客户使用的快递承运商，如同时使用多家快递，还需要提供快递使用规则 账单推送功能需要提供生成账期（自然月）启始时间规则（如导入时间、提货时间），以及其他账单生成规则 | |||
3、客户系统对接沟通流程
客户系统对接沟通流程
备注：
1）如涉及到需求开发，具体人天根据项目进行评估
2）如需要使用Billing功能，Core的账号创建、价格文件配置等配置工作由SD同事按oneTMS标准客户上线流程进行操作
4、对接各家快递公司需要提供的信息
目前整理出来的需要各家快递公司提供的API账号、密码在快递公司内部的名称
...
各家快递公司提供的账号、密码列表
...
参数类型
...
参数名称
...
说明
...
EMS
...
大客户号
...
sysAccount
...
...
下订单
...
appkey
...
...
password
...
...
物流追踪
...
api_key
...
...
api_secret
...
...
Access Token
...
appid
...
secret
...
SF
...
通用
...
接入编码
...
Checkword
...
...
YTO
...
通用
...
客户编码（电商标识）
...
...
partnerId
...
ZTO
...
下订单
...
partner
...
合作方代码
...
pass
...
物流追踪
...
company_id
...
合作商编码
...
签名key
...
KYE
...
下订单
...
key
...
组织机构代码
...
accesskey
...
密钥
...
物流追踪
...
uuid
...
客户编码
...
key
...
密钥
...
德邦
...
通用
...
companyCode
...
渠道代码
...
appKey
...
customerCode
...
客户编码
...
品骏
...
通用
...
appKey
...
appSecret
...
运单号接口
...
userCode
...
areaName
...
...
...
oTMS系统配置
角色 | 配置 | 功能 |
客户 | 开通“我的快递”权限 | oTMS的“我的快递“ |
四、客户订单通过oTMS SaaS导入EC（oSuper）
Core账号和EC账号的映射关系，由开发同事在EC MAM中配置
1、EC系统的配置由开发同事在EC MAM中完成，需要客户根据功能需求提供如下信息
系统 | 角色 | 信息名称 | 功能 |
oTMS | 客户 | 公司代码 | 导入EC |
| API帐号密码 | 快递回传重量 | |
承运商 | 公司代码 | 导入EC | |
| API帐号密码 | 导入EC | |
虚拟车牌 | 导入EC | ||
快递 | 客户 | 客户在快递系统中的帐号密码、月结账号等 | 向快递系统下单、查询物流信息 |
| 客户 | 客户 | 上游系统接收物流事件、快递单号的URL | 接受EC推送的运单号、物流节点 |
2、 需要客户在oTMS SaaS中进行配置
角色 | 配置 | 功能 |
客户 | 开通“我的快递”权限 | oTMS的“我的快递“ |
承运商 | 开通事件订阅权限 | 导入EC |
| 设置事件订阅地址为： 生产环境：https://ec.otms.cn/gw/otms/{vendorCode}/event demo环境：https://ec.demo.otms.cn/gw/otms/{vendorCode}/event {vendorCode}为承运商公司代码 将“订单释放”移入已选事件中（必须） EC同步订单召回：将“订单异常”移入已选事件中 注：只选择需要的事件类型 | 导入EC |
对应客户设置自动发送 | 导入EC |
...
三、客户订单通过oTMS SaaS导入EC（oSuper）
订单通过oTMS SaaS导入EC流程
1）OTMS系统中，客户下发订单到承运商并释放（承运商账户里对客户设置自动发送），OTMS推送承运商的已释放事件到gateway（事件订阅地址）
...
2）2、3、4中任意一个失败，oTMS推送时间会重试（次数5，每次间隔10分钟）
五、百丽项目案例分享
百丽一期EC项目
一期业务全部为O2O业务为主，目前月均单量稳定在30W-40W，百丽POS已接对接SF，客户和oTMS合作主要的需求点是异常事件管理
RSD-百丽项目
基于17年的合作，百丽希望在O2O业务在正常服务标准在可接受范围内，同时能适当的降低快递成本，希望可以通过oTMS EC引入更多的运输资源和服务模式，满足消费者个性化的购物需求
