fix(send): 逐单形态的「存在不是待发货的商品」也按已同步

上一版只覆盖了整包 `Success:false + Message` 的形态,线上这条提示其实走的是**逐单**分支:
`{"Success":true,"Data":{"Orders":[{"IsSuccess":false,"ErrorMessage":"存在不是待发货的商品,发货失败;"}]}}`,
而逐单幂等正则要求「不是待发货状态」,少了「状态」两字没命中,于是照旧抛错重试。
用户看到的 `店管家发货同步失败:: 存在不是待发货…` 里的双冒号就是逐单分支 + 平台未回 LogicOrderId 造成的。

- 抽出 SEND_ALREADY_DONE_PATTERN(不是待发货 / 已发货 / 已取消 / 已关闭),整包与逐单共用
- 逐单失败且平台未回 LogicOrderId 时不再拼「: 」前缀,避免出现「失败:: xxx」
- 单测补 2 例(逐单幂等 / 无单号时不出现双冒号),共 5 例
- 文档补两种形态的报文明细

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
liufumingren 2026-11-07 22:56:20 +08:00
parent 1b36e34f61
commit e22dcf2ead
3 changed files with 58 additions and 8 deletions

View File

@ -137,6 +137,15 @@ function isRateLimited(json) {
return /isv\.request-limited|请求太频繁|访问QPS|限流/i.test(text);
}
/**
* 「这一单平台侧已不是待发货」类提示:已发货/已取消/已关闭都算,属幂等(本地按已同步处理)
*
* 实测两种形态:整包 `{"Success":false,"Message":"存在不是待发货的商品,发货失败;"}`
* 与逐单 `Data.Orders[] IsSuccess=false + ErrorMessage="存在不是待发货的商品,发货失败;"`
* (后者 `LogicOrderId` 常为空,拼接出来就是「店管家发货同步失败:: 存在不是待发货的商品…」)。
*/
const SEND_ALREADY_DONE_PATTERN = /不是待发货|已发货|已取消|已关闭/;
/**
* 提取发货回传的逐单失败(平台是「整包 Success + Data.Orders[] 逐单结果」)
* @param {Object} json 平台响应
@ -3114,7 +3123,7 @@ class DgjService extends PrintPlatformService {
// 单包裹发送时,平台整包回「存在不是待发货的商品,发货失败」= 这一单已经不在待发货
// (平台侧已发货/已取消),属于幂等:直接按成功返回,避免反复重试被打成「异常」
const topMessage = String((res.json && res.json.Message) || '');
if (res.json && res.json.Success !== true && orders.length === 1 && /不是待发货|已发货|已取消|已关闭/.test(topMessage)) {
if (res.json && res.json.Success !== true && orders.length === 1 && SEND_ALREADY_DONE_PATTERN.test(topMessage)) {
if (this.logger && typeof this.logger.info === 'function') {
this.logger.info('[dgj.sendOrders] 平台侧该单已不是待发货,按已同步处理:%s %s', orders[0].LogicOrderId, topMessage);
}
@ -3149,9 +3158,9 @@ class DgjService extends PrintPlatformService {
}
// 平台是「整包 Success + 逐单结果」:逐单失败要单独判,否则会把没发成功的单标成已同步。
// 例外:单子已经是已发货状态(平台早于我们手工/别处发货)视为幂等成功。
// 例外:单子已经是已发货/已取消状态(平台早于我们手工/别处发货)视为幂等成功。
const failed = extractSendOrderFailures(res.json);
const realFailures = failed.filter(item => !/不是待发货状态|已发货|已取消|已关闭/.test(item.message));
const realFailures = failed.filter(item => !SEND_ALREADY_DONE_PATTERN.test(item.message));
if (realFailures.length) {
// 风控/渠道不匹配:平台按「模板对应的电子面单渠道」校验运单号,模板与运单快递不一致就会拦截
const riskBlocked = realFailures.some(item =>
@ -3159,10 +3168,11 @@ class DgjService extends PrintPlatformService {
const hint = riskBlocked
? '(运单号不是该平台渠道分配的面单:请确认发货模板与运单快递一致,并用「对应平台 + 该快递」的电子面单模板重新取号)'
: '';
throw buildPlatformError(
`店管家发货同步失败:${realFailures.map(item => `${item.logicOrderId}: ${item.message}`).join(';')}${hint}`,
res
);
// 平台有时不回 LogicOrderId,此时不要拼出「失败:: xxx」这种双冒号
const detail = realFailures
.map(item => (item.logicOrderId ? `${item.logicOrderId}: ${item.message}` : item.message))
.join(';');
throw buildPlatformError(`店管家发货同步失败:${detail}${hint}`, res);
}
if (failed.length && this.logger && typeof this.logger.info === 'function') {
for (const item of failed) {

View File

@ -76,4 +76,34 @@ describe('dgj.sendOrders 幂等口径', () => {
/店管家发货同步失败:12;ErrorCode=500/
);
});
it('逐单回「存在不是待发货的商品」也按已同步处理(LogicOrderId 为空)', async () => {
const service = stubResponse(buildService(), {
Success: true,
ErrorCode: '200',
Data: { Orders: [{ 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: true,
ErrorCode: '200',
Data: { Orders: [{ IsSuccess: false, ErrorMessage: '运单号已被使用' }] },
});
await assert.rejects(
() => service.sendOrders('fxdd.dgjapp.com', {
traceId: 't', dbname: '', rows: [ ROW ], templateId: '12360764', expressCompanyId: 7, expressCode: 'YUNDA',
}),
err => {
assert.match(err.message, /店管家发货同步失败:运单号已被使用/);
assert.doesNotMatch(err.message, /::/);
return true;
}
);
});
});

View File

@ -75,12 +75,22 @@ Orders[0][Sender][SenderCompany/CompanyName] / [ReceiverIsEmpty]=0 / [PrintInfo]
"ErrorMessage":"订单不是待发货状态,请检查"}]}}
```
OMS 口径:逐单 `IsSuccess=false` 时,除「不是待发货状态 / 已发货 / 已取消 / 已关闭」(幂等,视为已同步)外都算失败。
OMS 口径:逐单 `IsSuccess=false` 时,除「不是待发货 / 已发货 / 已取消 / 已关闭」(幂等,视为已同步)外都算失败。
整包层面也有一种幂等:单包裹发送时若平台整包回
`{"Success":false,"Message":"存在不是待发货的商品,发货失败;"}`,说明这一单平台侧已不在待发货
(已发货/已取消),同样**按已同步处理**(`dgj.sendOrders` 直接返回,不发异常),否则会被重试 3 次打成「同步异常」。
⚠️ 这条提示**两种形态都出现过**(口径统一用 `SEND_ALREADY_DONE_PATTERN` 判):
| 形态 | 报文 |
|---|---|
| 整包失败 | `{"Success":false,"Message":"存在不是待发货的商品,发货失败;"}` |
| 逐单失败 | `{"Success":true,"Data":{"Orders":[{"IsSuccess":false,"ErrorMessage":"存在不是待发货的商品,发货失败;"}]}}` |
逐单形态平台常不回 `LogicOrderId`,旧实现会拼成 `店管家发货同步失败:: 存在不是待发货的商品…`(注意双冒号)——
看到这种双冒号就是走到了逐单分支。现在逐单失败且无单号时不再拼前缀。
OMS 实现:
| 位置 | 作用 |