diff --git a/backend/app/service/externalPrintOrder.js b/backend/app/service/externalPrintOrder.js index 84c8e97..c6ae0ea 100644 --- a/backend/app/service/externalPrintOrder.js +++ b/backend/app/service/externalPrintOrder.js @@ -190,10 +190,29 @@ class ExternalPrintOrderService extends Service { supplementHosts: result.supplementHosts || [], hint: this.buildZeroOrderHint(shopPlain, result, { startTime, endTime }) || this.buildSupplementHint(shopPlain, result) - || this.buildFallbackHint(result), + || this.buildFallbackHint(result) + || this.buildRefreshHint(saved), }; } + /** + * 「本次全是更新、没有新增」时的说明 + * + * 拉单按平台单号(老表 `orders.order_no = 平台code-平台单号`)去重:已在系统里的单只刷新平台状态/收件人, + * 不会重复新增,也不会把已审核过的单退回「待审核」。没有这条提示时,「新增 0、更新 N」 + * 看起来很像「拉到了却没落库」。 + * @param {Object} saved saveOrders 的写入统计 + * @return {string} 提示(无需提示时为空字符串) + */ + buildRefreshHint(saved) { + const created = Number((saved && saved.created) || 0); + const updated = Number((saved && saved.updated) || 0); + if (created > 0 || updated <= 0) return ''; + return `本次拉到的 ${updated} 单在系统里都已存在(按平台单号去重),只刷新了平台状态与收件信息;` + + '若在「待审核」看不到,说明它们已审核过——可能已在「待推送 / 配送 / 历史」,或因平台侧已发货被自动作废,' + + '可用平台单号在对应视图搜索'; + } + /** * 有分区走了「不支持状态过滤 → 时间窗全量」兜底时的提示 * diff --git a/backend/test/app/lib/pullOrderHint.test.js b/backend/test/app/lib/pullOrderHint.test.js index 8e4d81d..ba0697e 100644 --- a/backend/test/app/lib/pullOrderHint.test.js +++ b/backend/test/app/lib/pullOrderHint.test.js @@ -84,4 +84,17 @@ describe('service/externalPrintOrder 拉单 0 单的排查提示', () => { assert.strictEqual(service.buildFallbackHint({ total: 0, fallbackHosts: [] }), ''); assert.strictEqual(service.buildFallbackHint(null), ''); }); + + it('全部都是更新、没有新增时说明「已在系统里、不会退回待审核」', () => { + const hint = service.buildRefreshHint({ created: 0, updated: 8 }); + console.log('全更新提示:', hint); + assert.match(hint, /8 单/); + assert.match(hint, /都已存在/); + assert.match(hint, /待推送/); + assert.match(hint, /自动作废/); + // 有新增时不提示 + assert.strictEqual(service.buildRefreshHint({ created: 2, updated: 8 }), ''); + assert.strictEqual(service.buildRefreshHint({ created: 0, updated: 0 }), ''); + assert.strictEqual(service.buildRefreshHint(null), ''); + }); });