外部系统对接清单
本文按外部系统整理 DGJ2.0 发送和接收的消息、入口文件、幂等关注点和补偿方向。联调或排查外部系统问题时,先按系统定位。
订单中心
DGJ 接收:
- 采购订单审核:
ordercenter_order_audit - 采购售后审核/更新/关闭:
ordercenter_aftersale_* - 在线支付订单取消:
ordercenter_order_cancel - OPS 自制订单下发/关闭:
ordercenter_order_sync_dgj、ordercenter_order_close
入口:application/controllers/tasks/OrderCenterNotify.php
DGJ 发送:
- 采购订单创建:
ordercenter_order_create - 采购关闭确认等事件由
MqSer.php生产。
幂等关注:外部订单号、DGJ 采购单号、售后单号、明细行 id。
支付中心
DGJ 接收:
- 支付结果:
paycenter_pay_result - 退款结果:
paycenter_refund_result - 支付异常:
paycenter_pay_exception - 白条还款支付结果:
paycenter_baitiao_return_pay_result
入口:application/controllers/tasks/PayCenterNotify.php
影响表:t_scm_payment、t_scm_payment_info、t_scm_po_order_payinfo、采购单、账户流水。
幂等关注:支付流水号、业务单号、支付状态、金额。
OA
DGJ 接收:
- OA 审批回调:
oa_audit - OA 结果同步:
oa_result_notify_sync
入口:
application/controllers/tasks/OaNotify.phpapplication/controllers/tasks/OaResultNotify.php
重点业务:秒杀活动审批,模板码 callback_20260526。
幂等关注:模板码、审批单号、业务 id、审批结果。
商品中心
DGJ 接收:
- SKU 限购配置。
- 套包状态。
- 结算价生效/失效。
- 销售限价。
- 敏感词。
入口:application/controllers/tasks/ItemCenterNotify.php
影响范围:商品主数据、采购可买、销售可卖、活动商品、缓存、ES。
调拨中心 / TMS / 配送
DGJ 接收:
- 配送出库。
- 物流信息。
- 自提通知。
- 退货确认。
入口:application/controllers/tasks/DispatchCenterNotify.php
影响范围:采购出库、采购配送状态、销售配送状态、签收、库存流水。
SAAS / APP
DGJ 发送:
- 销售单创建/更新/关闭。
- 销售出库创建/更新/取消。
- 退货申请审核/完成。
- 客户绑定、优惠券、活动开始/结束等。
入口:
- 生产者:
application/Services/Mq/MqSer.php - 同步构建:
application/Services/SyncOrder/SyncOrderBuilder.php - 同步服务:
application/Services/SyncOrder/SyncOrderSer.php - 消费相关:
application/controllers/tasks/SaasOrderNotify.php
幂等关注:销售单号、出库单号、事件类型、下游业务 id。
大客户渠道
DGJ 接收:
- 人工创建渠道订单。
- 渠道订单发货。
- 渠道售后动作。
- 渠道订单审核。
入口:application/controllers/tasks/ChannelOrderNotify.php
业务表:t_channel_order、t_channel_order_info、t_channel_aftersale、t_channel_aftersale_info。
状态:created、wait_ship、part_ship、finish、cancel。
全车件 / QCJ / QPay
入口:
- 路由:
application/config/routes.php - 控制器:
application/controllers/allcarpart/* - 支付回调:
application/controllers/tasks/QPayCenterNotify.php - MQ 常量:
MqEventEnums::QCJ_NOTIFY、DEST_QPAYCENTER_NOTIFY
关注:全车件订单、结算支付、退款、维修厂账户开通。
VIN / 数据平台 / IM
- VIN:
MqEventEnums::DEST_VIN,车型、VIN 相关。 - IM:
MqEventEnums::DEST_IMCENTER_NOTIFY,腾讯 IM 应用业务消息。 - 数据平台/BI:商品基础、报表口径、VIP 价格同步相关表。
常用 rg 命令
rg -n "DEST_ODC_NOTIFY|DEST_PAYCENTER_NOTIFY|DEST_OA_NOTIFY|DEST_ITEMCENTER_NOTIFY|DEST_DISPATCHCENTER_NOTIFY" application/KzData/Enums/MqEventEnums.php
rg -n "class .*Notify" application/controllers/tasks
rg -n "send.*Mq|sendInventoryEvent|sendPoCloseOrderConfirm|sendOAResult" application/Services/Mq/MqSer.php
rg -n "SyncOrderBuilder|SyncOrderSer|garage_repair_order" application/Services/SyncOrder application/controllers/tasks
改动风险和回归清单
- 接收外部消息:回归重复消息、乱序消息、历史消息、字段缺失。
- 发送外部消息:回归消息体字段、routing key、失败重试、下游幂等。
- 状态变更:确认 DGJ 业务表、外部系统、报表是否最终一致。