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:
parent
e1f49451c0
commit
6587e9b937
@ -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} 分销渠道标识(原样保留标签值,无则空串)
|
||||
|
||||
@ -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');
|
||||
|
||||
@ -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 侧重试即可。
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user