diff --git a/changelogs-v2/2026-05/18_test_订单创建-修改接口-管理后台.md b/changelogs-v2/2026-05/18_test_订单创建-修改接口-管理后台.md index d4caa7e..6c5bfe2 100644 --- a/changelogs-v2/2026-05/18_test_订单创建-修改接口-管理后台.md +++ b/changelogs-v2/2026-05/18_test_订单创建-修改接口-管理后台.md @@ -83,30 +83,66 @@ v5.17 起入参扩展为 13 字段(新增 createSource / groupBatchId / roomCo ## 6. 枚举 / 数据字典 -| 所属字段 | 枚举类 | 值 | 中文 | 说明 | -|----------|--------|----|------|------| -| `createSource` | OrderCreateSource | `CUSTOMER` | 客户自助 | 客户在小程序自助下单 | -| `createSource` | OrderCreateSource | `CONSULTANT` | 定制师代下单 | 默认值,B 端代下单 | -| `createSource` | OrderCreateSource | `OTA` | OTA 渠道 | 携程 / 美团等 OTA 引流 | -| `createSource` | OrderCreateSource | `WALK_IN` | 门店步入 | 线下门店现场下单 | -| `createSource` | OrderCreateSource | `B2B` | B2B 渠道 | 旅行社代下单 | -| `createSource` | OrderCreateSource | `VIP_REPURCHASE` | VIP 复购 | 老客户回购通道 | -| `createSource` | OrderCreateSource | `REFERRAL` | 老客户转介绍 | — | -| `createSource` | OrderCreateSource | `PROMOTION` | 营销活动 | — | -| `createSource` | OrderCreateSource | `INTERNAL` | 内部测试 | 不计入业绩 | -| `orderStatus` | OrderStatus | `待支付` | — | 创单后默认状态 | -| `orderStatus` | OrderStatus | `待完善` | — | 订金到账后进入 | -| `orderStatus` | OrderStatus | `定制中` | — | 出行人 + 房车齐后 | -| `orderStatus` | OrderStatus | `已确认` | — | — | -| `orderStatus` | OrderStatus | `出行中` | — | — | -| `orderStatus` | OrderStatus | `已完成` | — | — | -| `orderStatus` | OrderStatus | `已取消` | — | — | -| `flowStatus` | OrderFlowStatus | `待支付订金` | — | 创单后默认细状态 | -| `consultantSource` | ConsultantSource | `DEFAULT_ASSIGNED` | 系统默认分配 | 走轮询规则 | -| `consultantSource` | ConsultantSource | `LINK_BOUND` | 链接绑定 | 客户扫了定制师专属码 | -| `consultantSource` | ConsultantSource | `MANUAL` | 手动指定 | B 端 admin 强制指派 | -| `paymentMode` | PaymentMode | `DEPOSIT` | 定金模式 | 30% 定金 + 余款 | -| `paymentMode` | PaymentMode | `FULL` | 全款模式 | 100% 一次付清 | +> 接口里出现的枚举按字段分开列。本接口共 5 个枚举字段。 + +### 6.1 createSource(OrderCreateSource) + +**所属字段**:入参 `createSource` | **类型**:`String` | **必填**:❌(不传默认 `CONSULTANT`) + +| 值 | 中文 | 说明 | +|----|------|------| +| `CUSTOMER` | 客户自助 | 客户在小程序自助下单 | +| `CONSULTANT` | 定制师代下单 | 默认值,B 端代下单 | +| `OTA` | OTA 渠道 | 携程 / 美团等 OTA 引流 | +| `WALK_IN` | 门店步入 | 线下门店现场下单 | +| `B2B` | B2B 渠道 | 旅行社代下单 | +| `VIP_REPURCHASE` | VIP 复购 | 老客户回购通道 | +| `REFERRAL` | 老客户转介绍 | — | +| `PROMOTION` | 营销活动 | — | +| `INTERNAL` | 内部测试 | 不计入业绩 | + +### 6.2 orderStatus(OrderStatus) + +**所属字段**:出参 `orderStatus`(订单粗状态)| **类型**:`String` + +| 值 | 中文 | 说明 | +|----|------|------| +| `待支付` | 待支付 | 创单后默认状态 | +| `待完善` | 待完善 | 订金到账后进入 | +| `定制中` | 定制中 | 出行人 + 房车齐后 | +| `已确认` | 已确认 | — | +| `出行中` | 出行中 | — | +| `已完成` | 已完成 | — | +| `已取消` | 已取消 | — | + +### 6.3 flowStatus(OrderFlowStatus) + +**所属字段**:出参 `flowStatus`(订单细状态)| **类型**:`String` + +| 值 | 中文 | 说明 | +|----|------|------| +| `待支付订金` | 待支付订金 | 创单后默认细状态 | + +> 本节仅列创单接口能返回的细状态值;完整 flowStatus 枚举见订单状态机文档。 + +### 6.4 consultantSource(ConsultantSource) + +**所属字段**:出参 `consultantSource`(定制师分配来源)| **类型**:`String` + +| 值 | 中文 | 说明 | +|----|------|------| +| `DEFAULT_ASSIGNED` | 系统默认分配 | 走轮询规则 | +| `LINK_BOUND` | 链接绑定 | 客户扫了定制师专属码 | +| `MANUAL` | 手动指定 | B 端 admin 强制指派 | + +### 6.5 paymentMode(PaymentMode) + +**所属字段**:出参 `paymentMode`(支付模式)| **类型**:`String` + +| 值 | 中文 | 说明 | +|----|------|------| +| `DEPOSIT` | 定金模式 | 30% 定金 + 余款 | +| `FULL` | 全款模式 | 100% 一次付清 | ## 7. 错误码