feat(dgj): 1688 明文分销单一律按淘宝出号

渠道标签成对出现:密文 `douyin`/`kuaishou`(订单带原单号,能用抖店/快手电子面单);
明文 `*_plaintext`(店管家侧没有原单信息,`Order.ExtraJson.extField7` 为空,
抖店/快手面单会被平台拒绝:ErrCode=15002「非抖店订单,无法使用抖音电子面单取号打印」)。

实测佐证:
- 店管家 UI 对明文单的打印弹窗默认模板是「【菜鸟】国内邮政小包一联3」(13873834),
  正是我们库里 TB 平台下的模板,`LoadWaybillAccountDetailInfo` 也用 expressCode=POSTB
- 1688 单用菜鸟(TB)面单在生产成功过 11+ 单;TB + custom_code=YUNDA 唯一命中 12362952,不会撞多模板

改动:
- 新增 isPlaintextDistributeChannel(`*_plaintext` 结尾)
- normalizeOrder 的 1688 换算:明文 → TB;密文走 DISTRIBUTE_CHANNEL_PLATFORM
  (douyin→DYXD、kuaishou→KS);未映射的非明文渠道仍 → OTHER;无渠道 → TB
- 渠道原值仍留痕在 extend_props.distribute_channel(如 douyin_plaintext)
- 单测:douyin_plaintext/kuaishou_plaintext/thyny_plaintext → TB,thyny → OTHER(12 例)
- 文档 §4.2 换算表与 §4.4.1 同步说明「明文单为什么按淘宝出」

存量:生产仅 2 张明文单,待审核单重新拉单即变淘宝(另一张已作废)。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
liufumingren 2026-11-08 19:20:57 +08:00
parent e1f49451c0
commit 6587e9b937
3 changed files with 72 additions and 18 deletions

View File

@ -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} 分销渠道标识(原样保留标签值,无则空串)

View File

@ -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');

View File

@ -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 侧重试即可。