fix(pull): 订单查询 ErpState 过滤用单个等号,修抖店订单拉不到
用户抓包(fxdd.dgjapp.com/NewOrder/List,dbname 空)返回 6 单抖店待发货, oms 拉取却是 0 单。逐个参数复刻后定位到 Filter 操作符写错: - 平台订单页发的是 `Filters[1][Contract]=%3D`(即单个 `=`) - OMS 发的是 `Contract: '=='`,抖店老分区(dzh93a8yur84Y3Yln2ha9RbPovVMhBTc) 直接回 `Success=false`「服务器繁忙,请稍会儿再试」 - 该错误被 `isFilterUnsupportedError` 当成「分区不支持过滤」→ 退化时间窗全量拉取 - 而平台**全量列表不返回待发货单**(实测 30 天 698/710 行全是 sended/success/close), 于是 6 单待发货怎么都拉不到,且被记成「拉取成功 0 单」 修复与验证: - `fetchOrderPage` 的 ErpState 过滤改为 `Contract: '='`(与浏览器一致); 实测三个分区均生效:抖店-186 → 6 单、精选平台四区 → 6 单、新系统区 → 0 单; `UpFxUserId` 的 `in` 过滤同样正常 - 修后 shop 19 一次拉单:18 单待处理(DYXD 12 / TB 4 / PDD 2), 其中 6 单 `875172835889885066` 等真抖店单已落 order_status_pending - 退化兜底分支补 warn:平台全量列表不含待发货单,命中兜底时要能看出可能漏单 - 单测 `dgjOrderQuery.test.js`:断言过滤条件为 `CreateTime:between | ErpState:= | UpFxUserId:in` - 文档更正 4.2.1 节:抓包是 `Contract=`,并记录本次踩坑与三分区对照表 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
parent
61a9587851
commit
b22730fdcb
@ -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 过滤(实测有效,一次只回该商家的单)
|
||||
|
||||
64
backend/test/app/lib/dgjOrderQuery.test.js
Normal file
64
backend/test/app/lib/dgjOrderQuery.test.js
Normal file
@ -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');
|
||||
});
|
||||
});
|
||||
@ -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` 标志,例如
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user