统一状态码,优化对应逻辑
This commit is contained in:
@@ -1,36 +1,43 @@
|
||||
# 状态映射表(Mock 承运方 Server -> 平台统一状态)
|
||||
# 状态映射表(第三方/Mock -> 平台统一状态)
|
||||
|
||||
本表用于将 Mock Server 产生的 `event_code/event_text` 映射为平台统一 `status_code`,以保证前端时间线与告警规则可复用。
|
||||
本表用于将第三方(或 Mock Server)产生的 `event_code/event_text` 映射为平台统一 `status_code`,以保证前端时间线与告警规则可复用。
|
||||
|
||||
关联文档:
|
||||
- `接口规范.md`:统一事件模型与接入模式
|
||||
- `前端字段清单.md`:时间线字段契约(status_history/status_code)
|
||||
|
||||
平台统一状态(建议):
|
||||
- PENDING:待揽收
|
||||
- IN_TRANSIT:运输中
|
||||
- ARRIVED_HUB:到达中转/分拨中心
|
||||
平台统一状态(建议,尽量少且稳定):
|
||||
- ORDER_PLACED:已下单(平台侧订单状态;通常不是第三方快递事件)
|
||||
- SHIPPED:已发货(已绑定运单/待揽收)
|
||||
- IN_TRANSIT:运输中(含“中转中/发往下一站/分拨/到达节点/在途”等)
|
||||
- OUT_FOR_DELIVERY:派送中
|
||||
- DELIVERED:已签收
|
||||
- EXCEPTION:异常
|
||||
- RETURNED:退回
|
||||
- READY_FOR_PICKUP:待取件(到驿站/自提柜等,等待收件人取件)
|
||||
- DELIVERED:已签收(含本人签收/代收点签收)
|
||||
- EXCEPTION:异常(地址不详、拒收、破损、丢件、派送失败等)
|
||||
- RETURNED:退回/退件
|
||||
|
||||
Mock 事件码(建议) -> 平台统一状态
|
||||
- CREATED / ORDERED -> PENDING
|
||||
- PICKED / COLLECTED -> IN_TRANSIT
|
||||
- ARRIVED_HUB -> ARRIVED_HUB
|
||||
- DEPARTED_HUB / IN_TRANSIT -> IN_TRANSIT
|
||||
说明:
|
||||
- `ORDER_PLACED` 通常来自平台订单系统(下单成功),不一定存在 `tracking_no`;在“统一时间线展示”场景下可作为平台生成事件出现在物流时间线里。
|
||||
- 第三方事件原文(`event_text`)尽量保留;平台只用 `status_code` 做标签/筛选/告警。
|
||||
|
||||
第三方/Mock 事件码(建议) -> 平台统一状态(示例映射)
|
||||
- ORDERED / CREATED -> SHIPPED(若该事件表示“快递单已创建/已出库”,而非平台下单)
|
||||
- PICKED / COLLECTED -> IN_TRANSIT(已揽收后进入物流网络)
|
||||
- ARRIVED_HUB / ARRIVAL -> IN_TRANSIT(中转/到达节点统一视为运输中)
|
||||
- DEPARTED_HUB / TRANSIT / IN_TRANSIT -> IN_TRANSIT
|
||||
- ARRIVED_DEST_CITY -> IN_TRANSIT
|
||||
- OUT_FOR_DELIVERY -> OUT_FOR_DELIVERY
|
||||
- AT_PICKUP_POINT / READY_FOR_PICKUP / DELIVERED_TO_PICKUP -> READY_FOR_PICKUP
|
||||
- SIGNED / DELIVERED -> DELIVERED
|
||||
- REJECTED -> EXCEPTION
|
||||
- ADDRESS_INVALID -> EXCEPTION
|
||||
- DAMAGED -> EXCEPTION
|
||||
- LOST -> EXCEPTION
|
||||
- FAILED_DELIVERY / REJECTED / ADDRESS_INVALID / DAMAGED / LOST -> EXCEPTION
|
||||
- RETURNED / RETURNING -> RETURNED
|
||||
|
||||
平台生成事件(用于统一时间线,可选) -> 平台统一状态
|
||||
- ORDER_PLACED -> ORDER_PLACED
|
||||
- MERCHANT_CONFIRMED_SHIPMENT / SHIPPED -> SHIPPED
|
||||
|
||||
示例(用于 UI 文案)
|
||||
- ARRIVED_HUB:到达北京分拨中心
|
||||
- IN_TRANSIT:运输中
|
||||
- OUT_FOR_DELIVERY:快件正在派送中
|
||||
- SIGNED:客户已签收(可带 POD 图片)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user