一、EC主要的功能点
1、oTMS EC standard Open API List
EC作为oTMS SaaS系统以外的系统,为客户的快递业务提供一个运输管理工具,接口如下:
| 接口 | 说明 | |
客户 | 订单导入 | 客户系统将订单下发给EC | |
订单确认 | 客户系统确认下发给EC的订单 | ||
追加子单 | 客户系统追加子单(目前支持SF、JD),目前EC在接口级别正常一票多件订单获取运单号,不支持一票多件的展示、子件追踪、费用拆分等功能 | ||
订单取消 | 客户系统取消下发给EC的订单 | ||
订单校验 | 客户系统校验订单、运单号是否符合预设置的规则 | ||
状态推送 | EC实时推送订单物流信息至客户系统 | ||
订单查询 | 客户系统至EC查询订单信息和订单物流信息 | ||
承运商 | 订单导入 | EC将订单下发给承运商系统 | |
订单确认 | EC确认下发给承运商系统的订单 | ||
订单取消 | EC取消下发给承运商系统的订单 | ||
订单状态查询 | EC至承运商系统抓取快件物流节点信息 | ||
订单状态推送 | 承运商系统主动推送物流节点信息至EC | ||
电子回单上传 | 承运商系统回传电子回单,EC系统不做保存,直接上传Core | ||
运费回传 | 承运商系统回传订单快递费用,EC会做保存,生成EC账单后以承运商运费呈现 | ||
重量回传 | 承运商系统更新EC系统中的订单数重体,oSuper订单重量会回传至Core | ||
合作伙伴 | 订单物流信息更新 | 富勒、科捷等外部系统供应商更新订单物流节点信息 | |
电子面单打印记录更新 | 使用云打印服务后,更新订单打印记录 |
oTMS EC Standard Open API 文档在如下wiki地址下载:Generic EC Platform
在线接口文档:https://ec.demo.otms.cn/api-docs/swagger-ui.html
2、订单分配
优先级:客户指定>字段判断>价格文件>保底
客户指定:订单通过上游系统下发至EC,承运商字段已经包含承运方信息,默认使用客户指定的的承运商
字段判断:订单下发至EC,无客户指定承运商信息,系统根据订单中的信息,为订单分配承运商(提前配置规则,可以是多个字段的组合,当满足条件时,订单分配给符合调整的承运商)
价格文件:通过API访问Core的价格文件,目前支持1、最低价格2、最优时效3、最低价格list(高优先级承运商拒单后,自动将订单分配至次优先级承运商,直到承运商截单)4、最优时效list(高优先级承运商拒单后,自动将订单分配至次优先级承运商,直到承运商截单)
保底:所有承运商拒单后,默认EMS保底
3、订单取消
收派员上门收件前,支持货主通过API取消订单,同时支持订单取消后,上游系统使用相同的订单号重复下单
4、EC操作
支持货主登录oTMS EC管理下发至承运商的快递订单物流状态,货主可以在主界面按条件搜索、筛选订单。
4.1、筛选:
- EC订单追踪,默认显示当日创建的订单物流数据。控件可自由选择一个月内的数据。
- 默认固定筛选字段:订单创建时间、揽件时间、签收时间
- 更多允许灵活定义筛选字段,包括用户的自定义字段。
- 可自定义显示的列表字段
4.2 异常:
- 允许自由添加异常,但不支持批量操作
- 选择异常类型:异常类型由用户在【EC】-【设置】-【异常管理】中自定义设置。最大设置16个。
- 选择异常状态:发现异常、异常处理协商中、异常处理完毕
- 选择异常责任人:由用户在【EC】-【设置】-【异常管理】中自定义设置。其中默认有shipper,Carrier,Warehouse,Driver,四个,最大设置16个。
- 报告人文本格式填写
- 允许上传附件备注
4.3 :自定义字段
- 设置中,每个公司默认最大10个自定义字段,其中包括接口的已占用字段。
- 已占用字段不可修改
- 未占用字段允许用户自定义,有文本格式和枚举格式
- 枚举类型可自由设置选项。
- 枚举类型均以文本格式存在用户订单列表中,即用户删除/修改已有字段,不会影响旧数据。
- 订单列表可以直接添加编辑文本格式,枚举格式的自定义字段
货主可以在物流详情弹出框查询订单的详细详细
支持对状态处于异常的订单进行报警、预警
预警:分为提货预警和派送预警
提货预警:根据截单时间和订单下发时间,计算订单的计划提货时间(单位:天),支持方式1、设置偏移度,例如下单时间为12点,截单时间为16点,计算出计划提货时间当天24点,偏移度-6小时,则提货预警时间为当天18点,2、下单时间为12点,截单时间为16点,计算出计划提货时间当天24点,但客户希望下单后2小时内,承运商能上门揽收,可设置为12(下单至承运商时间)+2预警
派送预警:根据计划提货时间和订单下发时间,计算订单的计划派送时间(单位:天),可设置偏移度,如订单计划派送时间为当天24点,偏移度-7,则提货预警时间为当天17点,货主可以在上班时间对可能存在的派送异常进行跟进
备注: 1、预警只触发事件提醒货主,提醒货主快件目前状态可能存在异常,预警不会影响KPI 2、启用预警功能需要在Core中基于线路设置SLA
报警:分为时效报警和状态异常(下图)
时效报警:根据计划提货时间和订单下发时间,计算订单的计划提货时间和计划派送时间(单位:天),对超服务时效的订单进行报警,同时根据事件原因进行责任方判断,当责任方为承运商,同时订单派送超时,生成账单时,支持基于价格文件设置的KPI进行扣款
状态异常:根据订单的物流状态(抓取或推送获得),判断快件目前的状态是否异常(如消费者拒收、疑似遗失、转寄、无法联系收件人。。。等异常),提醒货主进行人工介入,如由于承运商原因,导致订单派送超时,支持基于KPI生成账单时进行扣款
备注:启用报警功能需要在Core中基于线路设置SLA
5、打印 — osuper业务
标准快递打印:为单点发货、业务模式相对单一的客户,提供打印界面,客户可以通过API将订单下发至oTMS EC,在登录oTMS EC-订单管理界面,进行快递单的逐票、批量打印(目前已经提供的标准面单有顺丰、百世、如风达、京东、EMS),订单默认在待打印界面,打印完成后(生成PDF),订单状态变更为“已打印”,可以在已发货界面查询订单
oSuper快递运单号导出:oSuper货主登录oTMS EC,导出EC单号(快递公司不支持预分配运单号)、EC单号+快递单号(快递公司支持预分配运单号),打印oSuper预置面单
oSuper运单打印:oSuper货主登录oTMS EC,直接打印oSuper预置面单
oTMS POS打印:适用于货主通过API将订单下发至Core,门店通过POS跳转至oTMS POS,进行面单打印
6、EC账单
目前EC账单复用CoreBilling模块,货主可以根据账期,提前设置账单生成规则(如:每个月10生成上个月时间等于X月1-X月31 + 承运商等于SF + 业务类型等于快递。。。),EC会按规则查询符合条件的订单,并将订单推送至Core Billing模块生成账单
同时在生成EC账单前,客户登录EC导入承运商账单,在生成的oTMS账单中会包含承运商账单,客户可以在Billing中对比oTMS账单和快递账单的差异
目前EC账单不支持FAP
目前EC订单支持的计费模式:首重+续重+附加费用
导入承运商账单:
对比EC账单和承运商账单的差异:
7、报表
目前通过Qlikview管理EC客户的报表,三张报表
日常追踪报表
管理层报表
妥投时间分析
二、已经对接的快递公司详情
1、快递功能支持清单
接口 快递 | 下单 | 确认 | 取消 | 查询 | 获取运单号 | 物流查询 | 物流推送 | 离线订单 | 离线订单 | 子母单 | 追加子单 | 分捡码 |
下单结果 | (运单池) | 物流查询 | 物流推送 | (专用) | ||||||||
EMS(中邮) | ✓ | ✓ | ✗ | ✓ | ✓ | |||||||
EMS(全国) | ✓ | ✓ | ✓ | ✗ | ✓ | |||||||
顺丰 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
京东快递 | ✓ | ✓ | ✓ | ✓ (1) | ✓ | |||||||
京东仓配 | ✓ | ✓ | ✓ | ✓ | ||||||||
中通 | ✓ | ✓ | ✓(3) | |||||||||
中通(全网) | ✓ | ✓ | ||||||||||
百世-供应链 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓(2) | ||||||
百世-快递 | ✓ | ✓ | ✓ | ✓ | ✓ | |||||||
如风达 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓(2) | ||||||
顺丰O2O | ✓ | ✓ | ✓ | |||||||||
圆通 | ✓ | ✓ | ✓ | |||||||||
美食送 | ✓ | ✓ | ||||||||||
韵达 - 查询 | ✓ | ✓ | ✓ | ✓ | ✓ | |||||||
韵达 - 下单 | ✓ | ✓ | ✓ | ✓ | ||||||||
中铁快运 | ✓ | ✓ | ||||||||||
跨越速运 | ✓ | ✓ | ||||||||||
全一快递 | ✓ | |||||||||||
德邦 | ✓ | ✗ | ✓ | ✓ | ||||||||
申通 | ✓ | ✓ | ||||||||||
品骏 | ✓ | ✓ | ✓ | ✓ | ✓ | |||||||
宅急送 | ✓ | ✓ | ✓ | ✓ | ||||||||
联邦快递 | ✓ | |||||||||||
快递100 | ✓ | ✓ | ||||||||||
快递鸟 | ✓ | ✓ | ||||||||||
(1) 子单没有单号 | ||||||||||||
(2) 子母单专用下单接口 | ||||||||||||
(3) 复用中通物流查询接口 |
1、顺丰订单通过子单号申请接口,申请子单号,子单号和母单号不一致
2、京东子单号在母单号基础上加包裹编号
3、如风达、百世汇通中有一票多件接口,但目前EC未对接
4、Generic EC Express Integration 最新已对接快递公司
2、对接的各家快递公司接口文档
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 |
3、订单通过oTMS SaaS导入EC流程
1)OTMS系统中,客户下发订单到承运商并释放(承运商账户里对客户设置自动发送),OTMS推送承运商的已释放事件到gateway(事件订阅地址)
2)EC Gateway 接到事件后,根据事件中的订单号,调用承运商的oTMS outbound接口抓取订单
3)根据订单信息中的客户代码和承运商代码,在EC中有对应关系(提前进行配置),则将订单导入EC系统
4)EC Gateway 在向EC系统导入订单成功后,调用otms的分车接口给进入EC的订单分车,到“已分配”状态
备注:
1)oTMS SaaS事件积压,会导致EC Gateway无法接收事件,会导致订单下发延迟
2)2、3、4中任意一个失败,oTMS推送时间会重试(次数5,每次间隔10分钟)
五、百丽项目案例分享
百丽一期EC项目
一期业务全部为O2O业务为主,目前月均单量稳定在30W-40W,百丽POS已接对接SF,客户和oTMS合作主要的需求点是异常事件管理
RSD-百丽项目
基于17年的合作,百丽希望在O2O业务在正常服务标准在可接受范围内,同时能适当的降低快递成本,希望可以通过oTMS EC引入更多的运输资源和服务模式,满足消费者个性化的购物需求