From 1b36e34f61d17b837748d657ce5005be5e390f3e Mon Sep 17 00:00:00 2001 From: liufumingren Date: Sat, 7 Nov 2026 22:52:44 +0800 Subject: [PATCH] =?UTF-8?q?feat(send):=20=E5=B9=B3=E5=8F=B0=E5=9B=9E?= =?UTF-8?q?=E3=80=8C=E5=AD=98=E5=9C=A8=E4=B8=8D=E6=98=AF=E5=BE=85=E5=8F=91?= =?UTF-8?q?=E8=B4=A7=E7=9A=84=E5=95=86=E5=93=81=E3=80=8D=E6=97=B6=E6=8C=89?= =?UTF-8?q?=E5=B7=B2=E5=90=8C=E6=AD=A5=E5=A4=84=E7=90=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit dbname 修正后,同一批单平台改回业务提示 `存在不是待发货的商品,发货失败;`。 这类说明该单平台侧已经不在待发货(已发货/已取消),再重试也没意义,应直接按「已同步」。 - dgj.sendOrders:单包裹发送时整包 Success=false 且 Message 命中 「不是待发货 / 已发货 / 已取消 / 已关闭」→ 记 info 日志并直接返回(不发异常); 多包裹场景不套用(分不清是哪一单),仍按失败抛出 - 与原有「逐单 IsSuccess=false + 不是待发货状态」幂等口径保持一致 - 单测 dgjSendIdempotent.test.js 3 例(整包幂等 / 逐单幂等 / 其它整包失败仍抛错) - 文档 §2.1 补整包幂等口径,§2.1.2 补「修正后返回变成业务提示」 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- backend/app/lib/printPlatform/dgj.js | 9 +++ .../test/app/lib/dgjSendIdempotent.test.js | 79 +++++++++++++++++++ 店管家取号-旧系统提取.md | 7 ++ 3 files changed, 95 insertions(+) create mode 100644 backend/test/app/lib/dgjSendIdempotent.test.js diff --git a/backend/app/lib/printPlatform/dgj.js b/backend/app/lib/printPlatform/dgj.js index ecc7b0b..f1a9abf 100644 --- a/backend/app/lib/printPlatform/dgj.js +++ b/backend/app/lib/printPlatform/dgj.js @@ -3111,6 +3111,15 @@ class DgjService extends PrintPlatformService { if (res.status === 401) { throw buildPlatformError(`店管家登录已失效:${(res.json && res.json.Message) || 'token is invalid'}`, res); } + // 单包裹发送时,平台整包回「存在不是待发货的商品,发货失败」= 这一单已经不在待发货 + // (平台侧已发货/已取消),属于幂等:直接按成功返回,避免反复重试被打成「异常」 + const topMessage = String((res.json && res.json.Message) || ''); + if (res.json && res.json.Success !== true && orders.length === 1 && /不是待发货|已发货|已取消|已关闭/.test(topMessage)) { + if (this.logger && typeof this.logger.info === 'function') { + this.logger.info('[dgj.sendOrders] 平台侧该单已不是待发货,按已同步处理:%s %s', orders[0].LogicOrderId, topMessage); + } + return res.json; + } if (!res.json || res.json.Success !== true) { const json = res.json || {}; const hints = []; diff --git a/backend/test/app/lib/dgjSendIdempotent.test.js b/backend/test/app/lib/dgjSendIdempotent.test.js new file mode 100644 index 0000000..3063479 --- /dev/null +++ b/backend/test/app/lib/dgjSendIdempotent.test.js @@ -0,0 +1,79 @@ +'use strict'; + +const { assert } = require('egg-mock/bootstrap'); +const DgjService = require('../../../app/lib/printPlatform/dgj'); + +/** + * 造一个只调本模块自身方法的服务实例(不打网络) + * @return {Object} dgj 服务实例 + */ +function buildService() { + const service = new DgjService({ platform: { code: 'dgj', name: '店管家' }, account: { token: 'token', cookie: 'cookie' } }); + service.logger = { info() {}, warn() {}, error() {} }; + return service; +} + +/** 单条订单行(OnlineSend 只需要能拼出 LogicOrderId 等字段) */ +const ROW = { + Id: 51757087, + LogicOrderId: '875172836006880609', + PlatformOrderId: '6919339119937728149', + PathFlowCode: 'b676e3c07457bf8e', + ShopId: 4500493, + FxUserId: 751728, + UpFxUserId: 953516, + LastWaybillCode: '321450799451452', + WaybillCodes: [{ WaybillCode: '321450799451452', ExpressCpCode: 'YUNDA', WaybillCodeId: 68998609 }], + SubOrders: [{ OrderItemId: 118342400, OrderItemCode: 'c6ee12d85619a5ab' }], +}; + +/** + * 让 postPlatformForm 直接回指定响应 + * @param {Object} service 服务实例 + * @param {Object} json 平台响应 + * @return {Object} 服务实例 + */ +function stubResponse(service, json) { + service.postPlatformForm = async () => ({ status: 200, json, text: '' }); + return service; +} + +describe('dgj.sendOrders 幂等口径', () => { + it('整包回「存在不是待发货的商品」时按已同步处理(单包裹)', async () => { + const service = stubResponse(buildService(), { + Success: false, + ErrorCode: null, + Message: '存在不是待发货的商品,发货失败;', + }); + const out = await service.sendOrders('fxdd.dgjapp.com', { + traceId: 't', dbname: '', rows: [ ROW ], templateId: '12360764', expressCompanyId: 7, expressCode: 'YUNDA', + }); + assert.strictEqual(out.Message, '存在不是待发货的商品,发货失败;'); + }); + + it('逐单回「不是待发货状态」也按已同步处理', async () => { + const service = stubResponse(buildService(), { + Success: true, + ErrorCode: '200', + Data: { Orders: [{ LogicOrderId: 875172836006880609, IsSuccess: false, ErrorMessage: '订单不是待发货状态,请检查' }] }, + }); + const out = await service.sendOrders('fxdd.dgjapp.com', { + traceId: 't', dbname: '', rows: [ ROW ], templateId: '12360764', expressCompanyId: 7, expressCode: 'YUNDA', + }); + assert.strictEqual(out.Success, true); + }); + + it('其它整包失败仍然抛错(不能被当成已同步)', async () => { + const service = stubResponse(buildService(), { + Success: false, + ErrorCode: '500', + Message: '12', + }); + await assert.rejects( + () => service.sendOrders('fxdd.dgjapp.com', { + traceId: 't', dbname: '', rows: [ ROW ], templateId: '12360764', expressCompanyId: 7, expressCode: 'YUNDA', + }), + /店管家发货同步失败:12;ErrorCode=500/ + ); + }); +}); diff --git a/店管家取号-旧系统提取.md b/店管家取号-旧系统提取.md index d079939..2f1ee50 100644 --- a/店管家取号-旧系统提取.md +++ b/店管家取号-旧系统提取.md @@ -77,6 +77,10 @@ Orders[0][Sender][SenderCompany/CompanyName] / [ReceiverIsEmpty]=0 / [PrintInfo] OMS 口径:逐单 `IsSuccess=false` 时,除「不是待发货状态 / 已发货 / 已取消 / 已关闭」(幂等,视为已同步)外都算失败。 +整包层面也有一种幂等:单包裹发送时若平台整包回 +`{"Success":false,"Message":"存在不是待发货的商品,发货失败;"}`,说明这一单平台侧已不在待发货 +(已发货/已取消),同样**按已同步处理**(`dgj.sendOrders` 直接返回,不发异常),否则会被重试 3 次打成「同步异常」。 + OMS 实现: | 位置 | 作用 | @@ -186,6 +190,9 @@ NOT_MATCH_SEGMENT_CHANNEL#…此运单号非抖音的运单号…`。 因此 §2.1.1 的「改用实时订单行重试」只有在 `dbname` 正确后才有意义——之前回读订单行也在错的区,拿不到行。 +修正后同一批单的返回变成 `存在不是待发货的商品,发货失败;`(业务类),这类按幂等处理即「已同步」, +见 §2.1 的 OMS 口径。 + **失败单不转表**:进了配送说明仓库已打包发货,是既成事实,必须留在配送表可见/可导出;