外部系统对接清单

本文按外部系统整理 DGJ2.0 发送和接收的消息、入口文件、幂等关注点和补偿方向。联调或排查外部系统问题时,先按系统定位。

订单中心

DGJ 接收:

  • 采购订单审核:ordercenter_order_audit
  • 采购售后审核/更新/关闭:ordercenter_aftersale_*
  • 在线支付订单取消:ordercenter_order_cancel
  • OPS 自制订单下发/关闭:ordercenter_order_sync_dgjordercenter_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_paymentt_scm_payment_infot_scm_po_order_payinfo、采购单、账户流水。

幂等关注:支付流水号、业务单号、支付状态、金额。

OA

DGJ 接收:

  • OA 审批回调:oa_audit
  • OA 结果同步:oa_result_notify_sync

入口:

  • application/controllers/tasks/OaNotify.php
  • application/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_ordert_channel_order_infot_channel_aftersalet_channel_aftersale_info

状态:createdwait_shippart_shipfinishcancel

全车件 / QCJ / QPay

入口:

  • 路由:application/config/routes.php
  • 控制器:application/controllers/allcarpart/*
  • 支付回调:application/controllers/tasks/QPayCenterNotify.php
  • MQ 常量:MqEventEnums::QCJ_NOTIFYDEST_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 业务表、外部系统、报表是否最终一致。