diff --git a/backend/app/lib/printPlatform/dgj.js b/backend/app/lib/printPlatform/dgj.js index 334d54a..7357311 100644 --- a/backend/app/lib/printPlatform/dgj.js +++ b/backend/app/lib/printPlatform/dgj.js @@ -790,6 +790,20 @@ function normalizeDistributeChannel(value) { return text.split('_')[0].trim(); } +/** + * 是否「明文渠道」单(`*_plaintext`) + * + * 明文分销单在店管家侧没有抖店/快手的原单信息(`Order.ExtraJson.extField7` 为空, + * 取号时平台直接报 `ErrCode=15002 非抖店订单,无法使用抖音电子面单取号打印`), + * 抖店/快手电子面单必然取不到号;但 1688 单本身可以用淘宝(菜鸟)面单取号, + * 所以明文单一律按淘宝出(见 normalizeOrder 的分销换算)。 + * @param {*} value 渠道标识(标签原值) + * @return {boolean} 是否明文渠道 + */ +function isPlaintextDistributeChannel(value) { + return /_plaintext$/i.test(String(value == null ? '' : value).trim()); +} + /** * 订单明细的平台规格ID:不同平台字段口径不一致 * (抖店/淘宝用 SkuId 存规格ID,视频号则用 SkuCode 存规格ID、SkuId 存规格名称) @@ -2551,16 +2565,20 @@ class DgjService extends PrintPlatformService { const platform = resolveOrderPlatform(data.PlatformType); const distributeChannel = this.resolveOrderDistributeChannel(data); // 硬规则(分销代发业务口径):1688 单不按 1688 出号,统一换算成实际取号渠道 - // - 抖音分销单(OutChannel=douyin / douyin_plaintext)→ 抖音小店(DYXD) - // - 快手分销单(OutChannel=kuaishou)→ 快手(KS) - // - 其它分销渠道(OutChannel=未知值,如 thyny/chaoshibianli)→ 其他(OTHER),原始报文与渠道留痕,等待后续映射 + // - 明文分销单(OutChannel=*_plaintext)→ 淘宝(TB):店管家没有抖店/快手原单信息, + // 抖店/快手电子面单会被平台拒绝(ErrCode=15002),1688 单只能用淘宝(菜鸟)面单 + // - 密文抖音分销单(OutChannel=douyin)→ 抖音小店(DYXD) + // - 密文快手分销单(OutChannel=kuaishou)→ 快手(KS) + // - 其它分销渠道(OutChannel=未知值,如 thyny/chaoshibianli)→ 其他(OTHER),原始报文与渠道留痕 // - 非分销单(无 OutChannel 标签)→ 淘宝(TB) // 否则按 1688 永远匹配不到面单模板,取号必失败 let platformCode = platform.code; let platformName = platform.name; if (platform.code === '1688') { - const mapped = DISTRIBUTE_CHANNEL_PLATFORM[normalizeDistributeChannel(distributeChannel)]; - const targetCode = mapped || (distributeChannel ? 'OTHER' : 'TB'); + let targetCode = 'TB'; + if (distributeChannel && !isPlaintextDistributeChannel(distributeChannel)) { + targetCode = DISTRIBUTE_CHANNEL_PLATFORM[normalizeDistributeChannel(distributeChannel)] || 'OTHER'; + } const target = resolvePlatform(targetCode); platformCode = target.code; platformName = target.name; @@ -2609,7 +2627,8 @@ class DgjService extends PrintPlatformService { * 1688 分销/代发采购单会带这个标签,值是对下游渠道的标识(实测 `douyin`、 * `douyin_plaintext`、`kuaishou`、`chaoshibianli_plaintext`、`thyny_plaintext` 等)。 * 分销单必须用下游渠道的电子面单,所以「平台」要按下游渠道算,不能按 1688 算, - * 否则取号永远匹配不到模板。标签里的明文/密文后缀由 `normalizeDistributeChannel` 归一化。 + * 否则取号永远匹配不到模板。标签里的明文/密文后缀由 `normalizeDistributeChannel` 归一化, + * 明文单(`*_plaintext`)在 `normalizeOrder` 里一律按淘宝出(见 `isPlaintextDistributeChannel`)。 * 少数分销单没有 OutChannel 标签,但 `ExtField1` 记了同一个渠道名(实测 `douyin`),一并兜底。 * @param {Object} data 店管家订单原始结构 * @return {string} 分销渠道标识(原样保留标签值,无则空串) diff --git a/backend/test/app/lib/dgjOrderPlatformRule.test.js b/backend/test/app/lib/dgjOrderPlatformRule.test.js index e93044d..7d7c8f5 100644 --- a/backend/test/app/lib/dgjOrderPlatformRule.test.js +++ b/backend/test/app/lib/dgjOrderPlatformRule.test.js @@ -47,7 +47,7 @@ describe('printPlatform/dgj normalizeOrder 平台换算硬规则', () => { assert.strictEqual(order.platform_type, 'Alibaba'); }); - it('1688 抖音分销单(明文后缀 douyin_plaintext)同样换算成抖音小店', () => { + it('1688 明文抖音分销单(douyin_plaintext)→ 淘宝(店管家没有抖店原单号,抖店面单取不到)', () => { const row = buildRow({ ExtField1: 'douyin', Tags: [{ Tag: 'OutChannel', TagType: 'Order', TagValue: 'douyin_plaintext' }], @@ -55,12 +55,21 @@ describe('printPlatform/dgj normalizeOrder 平台换算硬规则', () => { }); const order = service.normalizeOrder(row); console.log('抖音分销(明文):', order.platform_code, order.platform_name, order.distribute_channel); - assert.strictEqual(order.platform_code, 'DYXD'); - assert.strictEqual(order.platform_name, '抖音小店'); + assert.strictEqual(order.platform_code, 'TB'); + assert.strictEqual(order.platform_name, '淘宝'); // 渠道原值留痕(归一化只用于平台换算) assert.strictEqual(order.distribute_channel, 'douyin_plaintext'); }); + it('1688 明文快手分销单(kuaishou_plaintext)→ 淘宝', () => { + const order = service.normalizeOrder(buildRow({ + ExtField1: 'kuaishou', + Tags: [{ Tag: 'OutChannel', TagType: 'Order', TagValue: 'kuaishou_plaintext' }], + })); + assert.strictEqual(order.platform_code, 'TB'); + assert.strictEqual(order.distribute_channel, 'kuaishou_plaintext'); + }); + it('1688 分销单没有 OutChannel 标签时用 ExtField1 兜底识别渠道', () => { const order = service.normalizeOrder(buildRow({ ExtField1: 'douyin', Tags: [] })); console.log('ExtField1 兜底:', order.platform_code, order.distribute_channel); @@ -103,18 +112,27 @@ describe('printPlatform/dgj normalizeOrder 平台换算硬规则', () => { it('1688 未识别的分销渠道 → 其他(保留渠道与原始报文)', () => { const order = service.normalizeOrder(buildRow({ - Tags: [{ Tag: 'OutChannel', TagValue: 'thyny_plaintext' }], + Tags: [{ Tag: 'OutChannel', TagValue: 'thyny' }], })); console.log('未知渠道:', order.platform_code, order.platform_name, order.distribute_channel); assert.strictEqual(order.platform_code, 'OTHER'); assert.strictEqual(order.platform_name, '其他'); - assert.strictEqual(order.distribute_channel, 'thyny_plaintext'); + assert.strictEqual(order.distribute_channel, 'thyny'); assert.strictEqual(order.original_platform_code, '1688'); // 原始报文完整保留(后续再做渠道映射时要用) - assert.deepStrictEqual(order.raw.Tags, [{ Tag: 'OutChannel', TagValue: 'thyny_plaintext' }]); + assert.deepStrictEqual(order.raw.Tags, [{ Tag: 'OutChannel', TagValue: 'thyny' }]); assert.strictEqual(order.platform_type, 'Alibaba'); }); + it('1688 未识别的**明文**渠道也按淘宝出(没有原单信息,只能用淘宝面单)', () => { + const order = service.normalizeOrder(buildRow({ + Tags: [{ Tag: 'OutChannel', TagValue: 'thyny_plaintext' }], + })); + assert.strictEqual(order.platform_code, 'TB'); + assert.strictEqual(order.distribute_channel, 'thyny_plaintext'); + assert.strictEqual(order.raw.Tags[0].TagValue, 'thyny_plaintext'); + }); + it('换算后取号/回读仍按原始平台选订单域名', () => { // 1688 分销单换算成抖音小店,但订单数据仍在 1688 域名下 assert.strictEqual(DgjService.resolveOrderHost(DgjService.resolvePlatformType('1688')), 'fxali.dgjapp.com'); diff --git a/店管家取号-旧系统提取.md b/店管家取号-旧系统提取.md index 81e8661..bb6dfcd 100644 --- a/店管家取号-旧系统提取.md +++ b/店管家取号-旧系统提取.md @@ -329,15 +329,28 @@ Filters[2] TableAlias=pfn FieldType=int TableName=PathFlowNode Name=UpFxUs 时间窗默认值对齐平台页面:**首次拉取回看 15 天**(平台「待发货订单」页默认下单时间范围就是近 15 天)。 **平台换算硬规则(分销代发口径)**:店管家 1688 单不按 1688 出号(平台侧没有 Alibaba 面单模板, -抖音/1688 分销单必须用下游渠道的电子面单),拉单落库时 `normalizeOrder` 直接换算电商平台: +分销单必须用下游渠道的电子面单),拉单落库时 `normalizeOrder` 直接换算电商平台: -| 原始平台 | 判定(`Tags` / `OrderTags`) | 落库平台 | +| 原始平台 | 判定(`Tags` / `OrderTags` 的 `OutChannel`) | 落库平台 | |---|---|---| -| 1688(`PlatformType=Alibaba`) | `Tag=OutChannel` 且 `TagValue=douyin`(抖音分销单) | 抖音小店 `DYXD` | -| 1688 | 有 `OutChannel` 但渠道未映射(如 `thyny_plaintext`、`chaoshibianli_plaintext`) | 其他 `OTHER`(渠道留痕,等后续映射) | -| 1688 | 无 `OutChannel`(非分销单) | 淘宝 `TB` | +| 1688(`PlatformType=Alibaba`) | `douyin`(密文抖音分销单,订单带抖店原单号) | 抖音小店 `DYXD` | +| 1688 | `kuaishou`(密文快手分销单) | 快手 `KS` | +| 1688 | **`*_plaintext`(明文分销单)**:`douyin_plaintext`、`kuaishou_plaintext`、`thyny_plaintext`… | 淘宝 `TB` | +| 1688 | 有 `OutChannel` 但渠道未映射且非明文(如 `thyny`、`chaoshibianli`) | 其他 `OTHER`(渠道留痕,等后续映射) | +| 1688 | 无 `OutChannel`(非分销单,`ExtField1` 也没有渠道名) | 淘宝 `TB` | | 其它平台 | —— | 原平台不变 | +**明文分销单为什么按淘宝出**:店管家对同一渠道给成对标签值,明文单(`*_plaintext`)在平台侧 +**没有抖店/快手原单信息**(取号响应里 `Order.ExtraJson.extField7` 为空,看不出 `outPlatformOrderNo`), +用抖店/快手电子面单取号会被平台直接拒绝: + +``` +"ErrCode":"15002","ErrMsg":"非抖店订单,无法使用抖音电子面单取号打印,请用抖店平台订单号重新创建线下单再重试。" +``` + +而 1688 单本身可以用淘宝(菜鸟)面单取号(生产实测 Alibaba→TB 成功多单),所以明文单一律换算成 `TB`。 +渠道原值仍原样留在 `extend_props.distribute_channel`(如 `douyin_plaintext`),`orders.external_data` 保留完整报文。 + 留痕:状态表 `extend_props.original_platform_code='1688'`、`extend_props.distribute_channel=<渠道>`; `orders.external_data` 保留店管家完整报文(含 `Tags`),后续做渠道映射时直接可用。 历史数据由迁移 `20261107020000-convert-1688-orders-to-real-waybill-platform` 按同一规则换算。 @@ -650,7 +663,11 @@ WaybillCodeCreateDate='2026-11-04 08:20:37' | 下游渠道 `OutChannel=douyin_plaintext`(明文渠道) | `""`(空串,没有抖店原单号/加密收件人) | 失败 `15002` | 即:**同一店铺、同一模板**下,差别只在这个字段(`RequestBatchNumber`、`AuthUrl`、`FxPathUserNodes` -在成功与失败响应里都一样,可以排除)。这类单只能在店管家侧解决: +在成功与失败响应里都一样,可以排除)。 + +⚠️ **现在的处理口径**:明文分销单(`OutChannel=*_plaintext`)在拉单时**直接换算成淘宝(TB)**, +不再走抖店/快手模板(见 §4.2),所以不会再出现这条 15002;若某单仍报 15002, +说明它是密文渠道单(`douyin`)但店管家侧丢了抖店原单信息,只能在店管家侧解决: 重新授权「抖音分销」(`https://auth.dgjapp.com/auth/douyinfx`)后同步该单, 或按平台提示用抖店平台订单号在店管家建线下单再取号 —— OMS 侧重试即可。