商家发货¶

场景：商家对"待发货"订单执行发货的全流程 实际路径：商户后台 → 订单管理 → 待发货订单

📋 演示脚本¶

演示准备：

已上架商品 + 有"待发货"订单
准备快递单号（演示用 SF1234561）

演示步骤：

步骤 1：登录商家后台¶

打开 https://mall.ijcode.com/merchant/login，输入 admin1 / Mer@2026 登录：

商家后台登录页

实际架构说明

商家后台（mer SPA）实际只有 dashboard + 极少数设置页，业务操作（订单/发货/退款/提现）目前主要通过 admin 后台代操作完成。

步骤 2：admin 代操作订单列表¶

admin 后台 → 订单 → 订单列表（admin 代商家发货）：

admin 订单列表

顶部筛选：时间、店铺、订单号、商品类型、支付方式等
全部分组：待付款/待发货/待收货/待评价/交易完成/已退款/已删除

步骤 3：选择待发货订单¶

筛选状态：待发货

（演示流程同 admin 后台订单管理）

步骤 2：选择订单¶

点击订单进入详情
查看：
- 商品明细
- 收货地址
- 用户备注
- 下单时间

步骤 3：发货操作¶

点击 "发货" 按钮
选择快递公司（顺丰 / 圆通 / 中通 / 韵达 / EMS 等）
输入快递单号
（可选）填写发货备注
点击 "确认发货"

步骤 4：状态变化¶

订单状态变为 "已发货"
用户会收到发货通知（短信/微信）
用户可查看物流轨迹

🎓 培训材料¶

发货时效要求¶

用户付款后 48 小时内必须发货
超时未发货 → 平台介入处理
多次超时 → 店铺扣分

物流单号规范¶

真实单号（用户可在快递官网查询）
单号长度符合快递公司规范
不能使用重复单号（系统会校验）

快递公司配置¶

后台位置：设置 → 配置管理 → 物流配置

常见已配置：顺丰（SF）、圆通（YT）、中通（ZTO）、韵达（YD）、EMS

🔧 故障排查¶

场景 A：发货按钮点击无反应¶

原因：

订单状态已变化（不再是"待发货"）
系统缓存延迟

排查：

刷新订单详情确认状态
仍是"待发货" → 看是否网络异常
已变化（已发货/已取消）→ 不需操作

场景 B：发货后用户看不到物流¶

原因：

快递公司配置缺失
物流接口未对接

排查：

后台查发货记录是否成功写入
用户查快递公司官网能否查到
查不到 → 快递单号有问题（联系快递公司）
能查到但平台没显示 → 物流接口问题，联系技术

场景 C：48 小时未发货被处罚¶

原因：

商家忘记发货
库存不足无法发货
快递问题

处理：

用户可申请退款（未收到货）
商家会被扣分
建议商家开启发货提醒

⚙️ 后端关键点¶

表变化¶

表	字段	变化
`ij_store_order`	`status`	1 → 2 (已发货)
`ij_store_order`	`delivery_name`	NULL → "顺丰"
`ij_store_order`	`delivery_id`	NULL → "SF1234561"
`ij_store_order`	`delivery_time`	NULL → 时间戳

关键接口¶

GET /mer/order/lst — 订单列表
POST /mer/order/delivery/:id — 发货
GET /mer/order/delivery/:id — 物流轨迹