统一状态码,优化对应逻辑

This commit is contained in:
not-like-juvenile
2026-02-09 16:53:20 +08:00
parent 3ea0f008b5
commit f46ec4c461
19 changed files with 591 additions and 236 deletions

View File

@@ -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 图片)