一、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 最新已对接快递公司
二、客户接入EC流程
客户系统对接沟通流程
备注:
1)如涉及到需求开发,具体人天根据项目进行评估
2)如需要使用Billing功能,Core的账号创建、价格文件配置等配置工作由SD同事按oneTMS标准客户上线流程进行操作
三、客户订单通过oTMS SaaS导入EC(oSuper)
订单通过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分钟)