oTMS EC 介绍

一、EC主要的功能点

1、oTMS EC standard Open API List

EC作为oTMS SaaS系统以外的系统，为客户的快递业务提供一个运输管理工具，接口如下：

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、顺丰订单通过子单号申请接口，申请子单号，子单号和母单号不一致

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分钟）