diff --git a/backend/app/lib/printPlatform/dgj.js b/backend/app/lib/printPlatform/dgj.js index 5d3bc3a..076433d 100644 --- a/backend/app/lib/printPlatform/dgj.js +++ b/backend/app/lib/printPlatform/dgj.js @@ -1892,6 +1892,11 @@ class DgjService extends PrintPlatformService { start.getTime(), end.getTime() - Math.max(1, ORDER_FALLBACK_MAX_DAYS) * 24 * 3600 * 1000 )); + // 注意:平台「全量」列表不含待发货单,退化分支只能兜住已发货/已终结的核对, + // 拉待发货单必须靠「状态过滤」——所以这里留一条 warn,0 单时不会被误当成「平台没有单」 + if (this.logger && typeof this.logger.warn === 'function') { + this.logger.warn('[dgj] %s 的 %s 不支持状态过滤,退化为时间窗全量拉取(可能漏掉待发货单)', host, areaLabel); + } fetched = await this.fetchOrderPages(host, { traceId, dbname: area.dbname, @@ -2100,6 +2105,8 @@ class DgjService extends PrintPlatformService { }, ]; // 状态过滤:与平台「待发货订单」页同口径(ErpState == waitsellersend) + // ⚠️ Contract 必须是单个 `=`(浏览器抓包口径);写成 `==` 时抖店老分区会返回 + // 「服务器繁忙,请稍会儿再试」,导致 6 单待发货被当成「该分区不支持过滤」 if (erpState) { filters.push({ TableAlias: 'o', @@ -2107,7 +2114,7 @@ class DgjService extends PrintPlatformService { TableName: 'LogicOrder', Name: 'ErpState', Value: String(erpState), - Contract: '==', + Contract: '=', }); } // 商家过滤:平台按 PathFlowNode.UpFxUserId 过滤(实测有效,一次只回该商家的单) diff --git a/backend/test/app/lib/dgjOrderQuery.test.js b/backend/test/app/lib/dgjOrderQuery.test.js new file mode 100644 index 0000000..4ab88a5 --- /dev/null +++ b/backend/test/app/lib/dgjOrderQuery.test.js @@ -0,0 +1,64 @@ +'use strict'; + +const { assert } = require('egg-mock/bootstrap'); +const DgjService = require('../../../app/lib/printPlatform/dgj'); + +describe('lib/printPlatform/dgj 订单查询报文口径', () => { + /** + * 造一个只用于报文断言的服务实例 + * @return {Object} 店管家服务实例 + */ + function buildService() { + return new DgjService({ + platform: { code: 'dgj', name: '店管家', url: 'fxdd.dgjapp.com', fetch_waybill_no: 1 }, + account: { id: 1, account: 'tester', password: 'pwd', token: 'token', cookie: '' }, + }); + } + + it('ErpState 过滤的 Contract 必须是单个等号(写成 == 抖店老分区会回「服务器繁忙」)', async () => { + const service = buildService(); + let captured = null; + service.request = async (url, options) => { + captured = new URLSearchParams(options.body); + return { status: 200, json: { Success: true, Data: { Rows: [], Total: 0 } }, text: '', setCookies: [] }; + }; + + await service.fetchOrderPage('fxdd.dgjapp.com', { + traceId: 'trace', + dbname: 'dzh93a8yur84Y3Yln2ha9RbPovVMhBTc', + startTime: new Date('2026-10-09T00:00:00+08:00'), + endTime: new Date('2026-11-07T23:59:59+08:00'), + pageIndex: 1, + erpState: 'waitsellersend', + merchantFxUserId: '953516', + }); + + const contracts = []; + for (let index = 0; index < 5; index += 1) { + const name = captured.get(`Filters[${index}][Name]`); + if (!name) break; + contracts.push(`${name}:${captured.get(`Filters[${index}][Contract]`)}`); + } + console.log('过滤条件:', contracts.join(' | ')); + assert.deepStrictEqual(contracts, [ 'CreateTime:between', 'ErpState:=', 'UpFxUserId:in' ]); + }); + + it('不传状态时只带时间窗', async () => { + const service = buildService(); + let captured = null; + service.request = async (url, options) => { + captured = new URLSearchParams(options.body); + return { status: 200, json: { Success: true, Data: { Rows: [], Total: 0 } }, text: '', setCookies: [] }; + }; + await service.fetchOrderPage('fxali.dgjapp.com', { + traceId: 'trace', + dbname: '', + startTime: new Date('2026-11-01T00:00:00+08:00'), + endTime: new Date('2026-11-07T00:00:00+08:00'), + pageIndex: 1, + }); + assert.strictEqual(captured.get('Filters[1][Name]'), null); + assert.strictEqual(captured.get('Filters[0][Contract]'), 'between'); + assert.strictEqual(captured.get('PageSize'), '500'); + }); +}); diff --git a/店管家取号-旧系统提取.md b/店管家取号-旧系统提取.md index 3758ea5..198b26e 100644 --- a/店管家取号-旧系统提取.md +++ b/店管家取号-旧系统提取.md @@ -214,23 +214,31 @@ Filters[0] TableAlias=o FieldType=DateTime TableName=LogicOrder Name=CreateTi Filters[1] TableAlias=o FieldType=string TableName=LogicOrder Name=ErpState Value=waitsellersend Contract== ``` +> ⚠️ **上一行的 `Contract=` 只有一个等号**,抓包里是 `Filters[1][Contract]=%3D`(即 `=`)。 +> 2026-11-07 线上「抖音平台的订单拉取不到」就是这个符号写错导致的: +> OMS 早期按 `Contract: '=='` 发,抖店老分区直接回「服务器繁忙,请稍会儿再试」, +> 被误判成「该分区不支持过滤」→ 退化全量拉取 → 而平台**全量列表里不含待发货单**, +> 于是抖店 6 单待发货怎么都拉不到。改成 `=` 后同一分区立刻返回 6 单。 +> 单测见 `test/app/lib/dgjOrderQuery.test.js`(断言 `ErpState:=`)。 + 按商家(店铺)过滤时平台再加一个 Filter(值就是商家的 `FxUserId`,与 `shops.external_data.FxUserId` 一致): ``` Filters[2] TableAlias=pfn FieldType=int TableName=PathFlowNode Name=UpFxUserId Value=1327427 Contract=in ``` -⚠️ **分区差异(重要)**:这两个 Filter 只在**新系统区**(`dbname=y/2wUDWCZOk=`)生效; -老分区(如「精选平台四区」`wdJM8OZZiF4gKKxb82bFQlqydSPSQ9/W`、「抖店-186」`dzh93a8yur84Y3Yln2ha9RbPovVMhBTc`) -带 `ErpState`/`UpFxUserId` 会直接返回「服务器繁忙,请稍会儿再试」。 +实测(2026-11-07,账号 15197817068)三个分区都支持「待发货 + 商家」过滤: -因此 `DgjService.listOrders` 的策略是:新系统区带「待发货 + 商家」过滤(只拉本店待发货单), -老分区捕获「服务器繁忙」后退化为只按时间窗拉全量、再在本地按商家与状态过滤(`fallbackHosts` 会带回退化分区清单, -`externalPrintOrder` 会打 warn 日志)。老分区退化时窗口封顶 `DGJ_FALLBACK_MAX_DAYS`(默认 15 天), -避免「全部待处理」这类超大窗口在只能全量拉的分区上翻上百页。 +| 分区 | 仅状态过滤 | 状态 + 商家 in | 状态 + 商家 = | +|---|---|---|---| +| 抖店-186 `dzh93a8yur84Y3Yln2ha9RbPovVMhBTc` | 6 单 | 6 单 | 6 单 | +| 新系统区 `y/2wUDWCZOk=` | 0 单 | 0 单 | 0 单 | +| 精选平台四区 `wdJM8OZZiF4gKKxb82bFQlqydSPSQ9/W` | 6 单 | 6 单 | 6 单 | -分区的能力用进程内缓存 `AREA_FILTER_SUPPORT`(key = `host|dbname`,TTL 1 小时)记住, -这样同一个老分区每小时最多只白撞一次「服务器繁忙」,之后直接走全量兜底分支。 +⚠️ **退化兜底的真实局限**:一旦某个分区真的不支持过滤(或像上面那样写错操作符), +退化分支只按时间窗拉全量,而平台全量列表**不返回待发货单**,因此「0 单」并不代表没有待发货单。 +`DgjService.listOrders` 仍然保留退化分支(防老分区彻底不可用),但会打 warn; +`externalPrintOrder.buildZeroOrderHint` 会在 0 单时把「平台实际出现的商家」写进提示,便于判断。 **按商家分区声明决定要不要拉老分区**:商家列表接口 `POST /Partner/LoadMyAgentList` 返回的 `DbAreas[]`(已整体存在 `shops.external_data`)每一项带 `IsNewSystem` 标志,例如