大客户、临采与渠道订单专题

本文在“外部渠道、全车件与大客户订单”基础上继续细分大客户、临采、渠道订单、渠道售后、签收和自动发货/退款确认。

业务目标

• 大客户平台订单进入 DGJ。
• 支持临采、渠道发货、渠道签收、渠道售后。
• 支持渠道订单自动发货、自动退款确认等临时补偿。
• 渠道状态和销售/库存保持一致。

入口文件

• 渠道控制器：application/controllers/inner/channel/*
• 渠道任务：application/controllers/tasks/ChannelOrderNotify.php
• 临时渠道任务：application/controllers/tasks/TmpChannelOrder.php
• 大客户：application/Services/BigCustomer/*
• 渠道服务：application/Services/Channel/*

核心表

| 表 | 用途 | | --- | --- | | t_channel_order | 渠道订单主表 | | t_channel_order_info | 渠道订单明细 | | t_channel_aftersale | 渠道售后 | | t_channel_aftersale_info | 渠道售后明细 | | t_channel_order_sign_detail | 渠道签收明细 | | t_scm_big_order | 大客户销售主单 | | t_scm_big_order_info | 大客户销售明细 | | t_scm_big_lincai_whitelist | 大客户临采白名单 |

核心事件

• channel_order_manual_create：人工创建平台订单。
• channel_order_delivery：渠道发货。
• channel_refund_action：渠道售后动作。
• channel_order_approve：渠道订单审核。

主流程

flowchart TD
  A["渠道/大客户平台下单"] --> B["DGJ 创建渠道订单"]
  B --> C["审核"]
  C --> D["发货/出库"]
  D --> E["签收"]
  E --> F["完成"]
  D --> G["售后/退货"]
  G --> H["退款或退货入库"]

异常流程

• 渠道订单重复：查平台单号和重复锁。
• 发货失败：查库存、销售出库、渠道发货事件。
• 签收数量不一致：查签收明细和出库明细。
• 售后失败：查渠道售后主表、售后明细和退货入库。
• 临采白名单异常：查 t_scm_big_lincai_whitelist。

常用排查命令

rg -n "ChannelOrderNotify|TYPE_CHANNEL|channel_order|channel_refund" application/controllers/tasks application/KzData/Enums
rg -n "TmpChannelOrder|autoDelivery|autoRefundConfirm" application/controllers/tasks
rg -n "CHANNEL_ORDER|CHANNEL_AFTERSALE|CHANNEL_ORDER_SIGN_DETAIL|SCM_BIG_LINCAI_WHITELIST" application/config/tables.php application
rg -n "BigCustomer|Channel\\\\|Czg|Dcd|Fc" application/Services application/controllers/inner/channel

改动风险和回归清单

• 渠道创建、审核、拒绝、取消。
• 部分发货、整单发货、签收。
• 渠道售后、退款、退货入库。
• 大客户临采白名单和库存。
• 自动发货/退款确认脚本幂等。