@pisell/pisellos 2.3.29 → 2.3.30

package/lib/server/modules/order/types.d.ts

@@ -213,10 +213,12 @@ export interface OrderBookingItem {
         [key: string]: unknown;
     }[];
 }
-/** 支付记录 metadata，常含 unique_payment_number */
+/** 支付记录 metadata */
 export interface OrderPaymentMetadata {
-    /** 设备端本地支付唯一标识 */
+    /** 三方支付交易流水号 */
     unique_payment_number?: string;
+    /** 刷卡机设备快照；server 不解析内部字段，仅透传并持久化 */
+    card_reader_snapshot?: Record<string, unknown>;
     [key: string]: unknown;
 }
 /**
@@ -225,6 +227,8 @@ export interface OrderPaymentMetadata {
 export interface OrderPaymentItem {
     /** 支付记录 ID；存量/更新时传。来源：OrderPayment.id */
     order_payment_id?: number | null;
+    /** 支付项稳定唯一号；历史支付项允许缺失 */
+    payment_number?: string;
     /** 支付方式 ID（设备端从本地支付方式配置取详情）。来源：OrderPayment.custom_payment_id */
     custom_payment_id?: number;
     /** 支付方式编码。来源：OrderPayment.payment_method */
@@ -249,11 +253,13 @@ export interface OrderPaymentItem {
     created_at?: string | null;
     /** 手续费配置。来源：OrderPayment.service_charge */
     service_charge?: Record<string, unknown> | null;
+    /** 已计算的支付手续费。来源：OrderPayment.service_fee */
+    service_fee?: OrderMoneyString;
     /** Wallet Pass 使用单位 */
     wallet_pass_usage_unit?: unknown[] | null;
     /** Wallet Pass 使用值 */
     wallet_pass_use_value?: number | null;
-    /** 元数据；含 unique_payment_number。来源：OrderPayment.metadata */
+    /** 元数据；三方支付成功后可含 unique_payment_number */
     metadata?: OrderPaymentMetadata | null;
 }
 /**
@@ -413,6 +419,8 @@ export interface OrderData {
     create_date?: string;
     /** 本地待同步标记：1 表示需要后续同步到云端 */
     need_sync?: 0 | 1 | number;
+    /** 本地草稿标记：1 表示仅为 POS 可恢复草稿，不代表已提交云端 */
+    is_draft_order?: 0 | 1 | number;
     /** 兼容：部分场景仍使用顶层 total_amount */
     total_amount?: OrderMoneyString | number;
     /** 扩展字段（物流、标签等）；使用 any 以便筛选与数据源扩展 */

package/lib/server/modules/products/index.d.ts

@@ -18,8 +18,7 @@ export declare class ProductsModule extends BaseModule implements Module {
     private productsPriceCache;
     private readonly CACHE_MAX_DAYS;
     private formatters;
-    private isBuiltinFormatterRegistered;
-    private isLegacyPriceFormatterEnabled;
+    private isPriceFormatterRegistered;
     private quotationPriceBridge?;
     private quotationBridgeChannel?;
     private quotationBridgeLoadedKey?;
@@ -37,8 +36,6 @@ export declare class ProductsModule extends BaseModule implements Module {
     private lastPreloadCompletedAtMs;
     /** IndexDB 写入串行队列，避免快照与 patch 并发交错 */
     private productIndexDBSaveQueue;
-    /** 最近一次智能定价评估提取的 schedule 变价时间点（HH:mm），供 Server 订阅定时刷新使用 */
-    private lastScheduleTimePoints;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: any): Promise<void>;
     /**
@@ -111,10 +108,6 @@ export declare class ProductsModule extends BaseModule implements Module {
      */
     private prepareProductsWithPrice;
     private getProductsPriceCacheKey;
-    /**
-     * 稳定序列化策略上下文，避免对象 key 顺序不同导致缓存 key 抖动。
-     */
-    private stringifyStable;
     private normalizeProductIds;
     /**
      * 按轻量范围返回商品 ID，不做 structuredClone。
@@ -129,26 +122,14 @@ export declare class ProductsModule extends BaseModule implements Module {
      */
     private applyFormatters;
     /**
-     * 注册内置商品格式化器。
-     *
-     * 智能定价默认替代报价单逻辑；报价单 formatter 仅在 enableLegacyPriceFormatter=true 时启用。
+     * 注册内置的价格格式化器
+     * 这个格式化器负责将价格数据应用到商品上
      * @private
      */
-    private registerBuiltinProductFormatters;
-    /**
-     * 是否启用旧报价单价格 formatter。
-     *
-     * 默认关闭，避免报价单逻辑覆盖智能定价结果。
-     */
-    private shouldEnableLegacyPriceFormatter;
-    /**
-     * 返回最近一次 prepareProductsWithPrice / DataVariant 评估提取的变价时间点（HH:mm）。
-     * 供 OS Server 商品 query 订阅定时刷新使用。
-     */
-    getLastScheduleTimePoints(): string[];
+    private registerBuiltinPriceFormatter;
     /**
      * 注册商品格式化器
-     * 格式化器会按注册顺序依次执行；legacy 启用时先兜底报价，再由智能定价覆盖。
+     * 格式化器会按注册顺序依次执行（内置价格格式化器始终是第一个）
      * @param formatter 格式化函数
      * @param prepend 是否插入到队列开头（默认 false，追加到末尾）
      * @example
@@ -163,8 +144,8 @@ export declare class ProductsModule extends BaseModule implements Module {
      */
     registerFormatter(formatter: ProductFormatter, prepend?: boolean): void;
     /**
-     * 清空所有格式化器（包括内置智能定价格式化器）
-     * @param keepBuiltin 是否保留内置智能定价格式化器（默认 true）
+     * 清空所有格式化器（包括内置价格格式化器）
+     * @param keepBuiltin 是否保留内置价格格式化器（默认 true）
      */
     clearFormatters(keepBuiltin?: boolean): void;
     /**

package/lib/server/modules/products/index.js

@@ -43,10 +43,8 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     // 最多缓存7天
     // 商品格式化器列表
     this.formatters = [];
-    // 是否已注册内置商品格式化器
-    this.isBuiltinFormatterRegistered = false;
-    // 旧报价单格式化器默认关闭，仅显式开启时作为兼容兜底注册
-    this.isLegacyPriceFormatterEnabled = false;
+    // 是否已注册内置价格格式化器
+    this.isPriceFormatterRegistered = false;
     this.quotationBridgeLoadedKey = "";
     this.quotationScheduleCache = /* @__PURE__ */ new Map();
     this.quotationScheduleCacheSource = null;
@@ -58,8 +56,6 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     this.lastPreloadCompletedAtMs = 0;
     /** IndexDB 写入串行队列，避免快照与 patch 并发交错 */
     this.productIndexDBSaveQueue = Promise.resolve();
-    /** 最近一次智能定价评估提取的 schedule 变价时间点（HH:mm），供 Server 订阅定时刷新使用 */
-    this.lastScheduleTimePoints = [];
   }
   async initialize(core, options) {
     var _a;
@@ -86,7 +82,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         console.warn("[Products] IndexDB Manager 未找到");
       }
     }
-    this.registerBuiltinProductFormatters();
+    this.registerBuiltinPriceFormatter();
     this.initProductDataSource();
     this.setupProductSync();
     this.logInfo("模块初始化完成", {
@@ -478,7 +474,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    * @private
    */
   async prepareProductsWithPrice(schedule_date, extraContext, options) {
-    var _a, _b, _c, _d;
+    var _a, _b;
     const tTotal = performance.now();
     const targetIds = options == null ? void 0 : options.productIds;
     const isIncremental = Array.isArray(targetIds);
@@ -503,28 +499,21 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         (0, import_product.perfMark)("prepareProducts.extractIds", performance.now() - tIds, { count: ids.length });
       }
       this.logInfo("获取到商品列表", { productCount: products.length });
-      let priceData = [];
-      if (this.isLegacyPriceFormatterEnabled) {
-        const tPrice = performance.now();
-        priceData = await this.loadProductsPrice({
-          ids,
-          schedule_date,
-          schedule_datetime: extraContext == null ? void 0 : extraContext.schedule_datetime,
-          customer_id: extraContext == null ? void 0 : extraContext.customer_id
-        });
-        (0, import_product.perfMark)("prepareProducts.loadPrice", performance.now() - tPrice, { count: ids.length });
-        this.logInfo("获取商品报价单价格成功", { priceDataCount: (priceData == null ? void 0 : priceData.length) ?? 0 });
-      }
+      const tPrice = performance.now();
+      const priceData = await this.loadProductsPrice({
+        ids,
+        schedule_date,
+        schedule_datetime: extraContext == null ? void 0 : extraContext.schedule_datetime,
+        customer_id: extraContext == null ? void 0 : extraContext.customer_id
+      });
+      (0, import_product.perfMark)("prepareProducts.loadPrice", performance.now() - tPrice, { count: ids.length });
+      this.logInfo("获取商品报价单价格成功", { priceDataCount: (priceData == null ? void 0 : priceData.length) ?? 0 });
       const context = {
         schedule_date,
         schedule_datetime: extraContext == null ? void 0 : extraContext.schedule_datetime,
         customer_id: extraContext == null ? void 0 : extraContext.customer_id,
         priceData,
         locale: (_b = (_a = this.core) == null ? void 0 : _a.context) == null ? void 0 : _b.locale,
-        dataVariantEvaluator: (extraContext == null ? void 0 : extraContext.dataVariantEvaluator) || ((_d = (_c = this.core) == null ? void 0 : _c.context) == null ? void 0 : _d.dataVariantEvaluator),
-        menuList: (extraContext == null ? void 0 : extraContext.menuList) || [],
-        scheduleList: (extraContext == null ? void 0 : extraContext.scheduleList) || [],
-        strategy_context: extraContext == null ? void 0 : extraContext.strategy_context,
         ...extraContext
       };
       const tFormat = performance.now();
@@ -564,21 +553,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
   getProductsPriceCacheKey(schedule_date, extraContext, productIds) {
     const datetime = (extraContext == null ? void 0 : extraContext.schedule_datetime) || schedule_date;
     const productScope = productIds ? `:products:${productIds.join(",")}` : "";
-    const strategyScope = this.stringifyStable((extraContext == null ? void 0 : extraContext.strategy_context) || {});
-    return `${datetime}:customer:${(extraContext == null ? void 0 : extraContext.customer_id) ?? ""}:strategy:${strategyScope}${productScope}`;
-  }
-  /**
-   * 稳定序列化策略上下文，避免对象 key 顺序不同导致缓存 key 抖动。
-   */
-  stringifyStable(value) {
-    if (value == null)
-      return "";
-    if (Array.isArray(value))
-      return `[${value.map((item) => this.stringifyStable(item)).join(",")}]`;
-    if (typeof value === "object") {
-      return `{${Object.keys(value).sort().map((key) => `${key}:${this.stringifyStable(value[key])}`).join(",")}}`;
-    }
-    return String(value);
+    return `${datetime}:customer:${(extraContext == null ? void 0 : extraContext.customer_id) ?? ""}${productScope}`;
   }
   normalizeProductIds(productIds) {
     if (!Array.isArray(productIds))
@@ -662,50 +637,21 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     return result;
   }
   /**
-   * 注册内置商品格式化器。
-   *
-   * 智能定价默认替代报价单逻辑；报价单 formatter 仅在 enableLegacyPriceFormatter=true 时启用。
+   * 注册内置的价格格式化器
+   * 这个格式化器负责将价格数据应用到商品上
    * @private
    */
-  registerBuiltinProductFormatters() {
-    if (this.isBuiltinFormatterRegistered) {
-      console.warn("[ProductsModule] 内置商品格式化器已注册，跳过");
+  registerBuiltinPriceFormatter() {
+    if (this.isPriceFormatterRegistered) {
+      console.warn("[ProductsModule] 内置价格格式化器已注册，跳过");
       return;
     }
-    this.isLegacyPriceFormatterEnabled = this.shouldEnableLegacyPriceFormatter();
-    const dataVariantFormatter = (products, context) => {
-      var _a, _b;
-      const evaluator = context.dataVariantEvaluator || ((_b = (_a = this.core) == null ? void 0 : _a.context) == null ? void 0 : _b.dataVariantEvaluator);
-      if (!evaluator || typeof evaluator.resolveProducts !== "function") {
-        this.lastScheduleTimePoints = [];
-        this.logWarning("智能定价评估器未注入，跳过 DataVariant 格式化", {
-          productCount: products.length
-        });
-        return products;
-      }
-      const strategyContext = context.strategy_context || {};
-      const businessData = {
-        products,
-        scheduleDateTime: context.schedule_datetime || context.schedule_date,
-        scheduleList: context.scheduleList || [],
-        menuList: context.menuList || [],
-        customerId: context.customer_id,
-        channel: strategyContext.channel,
-        orderType: strategyContext.orderType || strategyContext.order_type,
-        businessCode: strategyContext.business_code ?? strategyContext.businessCode,
-        availableWalletIds: strategyContext.available_wallet_ids,
-        custom: strategyContext
-      };
-      const result = evaluator.resolveProducts(businessData);
-      this.lastScheduleTimePoints = Array.isArray(result == null ? void 0 : result.scheduleTimePoints) ? [...result.scheduleTimePoints] : [];
-      return Array.isArray(result == null ? void 0 : result.products) ? result.products : products;
-    };
-    const legacyPriceFormatter = (products, context) => {
+    const priceFormatter = (products, context) => {
       if (!context.priceData || context.priceData.length === 0) {
-        console.log("[ProductsModule] 💰 没有价格数据，跳过 legacy 报价单价格应用");
+        console.log("[ProductsModule] 💰 没有价格数据，跳过价格应用");
         return products;
       }
-      console.log(`[ProductsModule] 💰 应用 legacy 报价单价格到 ${products.length} 个商品`);
+      console.log(`[ProductsModule] 💰 应用价格数据到 ${products.length} 个商品`);
       return (0, import_product.applyPriceDataToProducts)(products, context.priceData);
     };
     const i18nFormatter = (products, context) => {
@@ -714,34 +660,15 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     const detailValueFormatter = (products, context) => {
       return (0, import_product.applyDetailValueToProducts)(products, context);
     };
-    if (this.isLegacyPriceFormatterEnabled) {
-      this.formatters.push(legacyPriceFormatter);
-    }
-    this.formatters.push(dataVariantFormatter);
+    this.formatters.unshift(priceFormatter);
     this.formatters.push(i18nFormatter);
     this.formatters.push(detailValueFormatter);
-    this.isBuiltinFormatterRegistered = true;
-    console.log("[ProductsModule] ✅ 内置商品格式化器已注册（智能定价优先）");
-  }
-  /**
-   * 是否启用旧报价单价格 formatter。
-   *
-   * 默认关闭，避免报价单逻辑覆盖智能定价结果。
-   */
-  shouldEnableLegacyPriceFormatter() {
-    var _a, _b, _c;
-    return ((_a = this.otherParams) == null ? void 0 : _a.enableLegacyPriceFormatter) === true || ((_c = (_b = this.core) == null ? void 0 : _b.context) == null ? void 0 : _c.enableLegacyPriceFormatter) === true;
-  }
-  /**
-   * 返回最近一次 prepareProductsWithPrice / DataVariant 评估提取的变价时间点（HH:mm）。
-   * 供 OS Server 商品 query 订阅定时刷新使用。
-   */
-  getLastScheduleTimePoints() {
-    return [...this.lastScheduleTimePoints];
+    this.isPriceFormatterRegistered = true;
+    console.log("[ProductsModule] ✅ 内置价格格式化器已注册（第 1 个）");
   }
   /**
    * 注册商品格式化器
-   * 格式化器会按注册顺序依次执行；legacy 启用时先兜底报价，再由智能定价覆盖。
+   * 格式化器会按注册顺序依次执行（内置价格格式化器始终是第一个）
    * @param formatter 格式化函数
    * @param prepend 是否插入到队列开头（默认 false，追加到末尾）
    * @example
@@ -756,7 +683,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    */
   registerFormatter(formatter, prepend = false) {
     if (prepend) {
-      const insertIndex = this.isBuiltinFormatterRegistered ? this.isLegacyPriceFormatterEnabled ? 2 : 1 : 0;
+      const insertIndex = this.isPriceFormatterRegistered ? 1 : 0;
       this.formatters.splice(insertIndex, 0, formatter);
       console.log(`[ProductsModule] 📌 已在位置 ${insertIndex + 1} 插入格式化器，当前共 ${this.formatters.length} 个`);
     } else {
@@ -765,17 +692,16 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     }
   }
   /**
-   * 清空所有格式化器（包括内置智能定价格式化器）
-   * @param keepBuiltin 是否保留内置智能定价格式化器（默认 true）
+   * 清空所有格式化器（包括内置价格格式化器）
+   * @param keepBuiltin 是否保留内置价格格式化器（默认 true）
    */
   clearFormatters(keepBuiltin = true) {
-    if (keepBuiltin && this.isBuiltinFormatterRegistered) {
-      const builtinCount = this.isLegacyPriceFormatterEnabled ? 2 : 1;
-      this.formatters = this.formatters.slice(0, builtinCount);
-      console.log("[ProductsModule] 🧹 已清空自定义格式化器，保留内置智能定价格式化器");
+    if (keepBuiltin && this.isPriceFormatterRegistered) {
+      this.formatters = [this.formatters[0]];
+      console.log("[ProductsModule] 🧹 已清空自定义格式化器，保留内置价格格式化器");
     } else {
       this.formatters = [];
-      this.isBuiltinFormatterRegistered = false;
+      this.isPriceFormatterRegistered = false;
       console.log("[ProductsModule] 🧹 已清空所有格式化器");
     }
   }
@@ -876,8 +802,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
             "resourceRelation",
             "bundleGroup.bundleItem",
             "optionGroup.optionItem",
-            "variantGroup.variantItem",
-            "dataVariants"
+            "variantGroup.variantItem"
           ],
           open_deposit: 1,
           is_append_product_description: 1,
@@ -1322,7 +1247,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    * Server 层监听该事件后对变更商品增量执行 prepareProductsWithPrice 并更新缓存
    */
   async processProductSyncMessages() {
-    var _a, _b, _c, _d, _e, _f, _g;
+    var _a, _b, _c, _d, _e, _f;
     const messages = [...this.pendingSyncMessages];
     this.pendingSyncMessages = [];
     if (messages.length === 0)
@@ -1376,10 +1301,6 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         if ((_f = msg.relation_product_ids) == null ? void 0 : _f.length) {
           sseRefreshIds.push(...msg.relation_product_ids);
         }
-      } else if (["product_data_variant"].includes(channelKey)) {
-        if ((_g = msg.product_ids) == null ? void 0 : _g.length) {
-          sseRefreshIds.push(...msg.product_ids);
-        }
       }
     }
     const uniqueDeleteIds = [...new Set(deleteIds)];

package/lib/server/modules/products/types.d.ts

@@ -114,8 +114,6 @@ export interface ProductSyncMessage {
     change_types?: string[];
     /** 关联商品 ID（product_collection / product_category / product_quotation 变更时携带） */
     relation_product_ids?: number[];
-    /** 关联商品 ID（product_data_variant 变更时携带） */
-    product_ids?: number[];
     message_uuid?: string;
     timestamp?: string;
     /** 内部标记：来源频道 key */
@@ -130,18 +128,6 @@ export interface ProductFormatterContext {
     customer_id?: number | string;
     priceData?: LoadProductsPriceData[];
     scheduleModule?: any;
-    /** 全量餐牌列表，供智能定价 menu_match 等条件判断使用 */
-    menuList?: any[];
-    /** 全量日程列表，供智能定价 schedule_match 等条件判断使用 */
-    scheduleList?: any[];
-    /** 外部传入的策略上下文，仅承载定价条件，不参与商品集合筛选 */
-    strategy_context?: Record<string, any>;
-    /** 智能定价评估器，由宿主统一注入到 PisellOS context */
-    dataVariantEvaluator?: {
-        resolveProducts: (businessData: any) => {
-            products: ProductData[];
-        };
-    };
     locale?: string;
 }
 /**

package/lib/solution/BaseSales/index.d.ts

@@ -2,7 +2,7 @@ import { Module, ModuleOptions, PisellCore } from '../../types';
 import { BaseModule } from '../../modules/BaseModule';
 import { BaseSalesOrderProduct, BaseSalesOrderProductIdentity, BaseSalesPaymentStatus, BaseSalesUpdateOrderProductQuantityParams, BaseSalesCalculateProductBookingPriceParams, BaseSalesPriceRecalculationContextChange, BaseSalesProductBookingPriceResult, BaseSalesQuotationCustomerScopeInfo, BaseSalesScanCodeResult } from './types';
 import { OrderModule } from '../../modules/Order';
-import type { AddProductBookingInput, LoadSalesDetailParams, OrderPaymentData, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions } from '../../modules/Order/types';
+import type { AddProductBookingInput, LoadSalesDetailParams, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions } from '../../modules/Order/types';
 import type { SubmitPayloadEnhancer } from '../../modules/Order/utils';
 import type { Discount } from '../../modules/Discount/types';
 import { RequestPlugin, WindowPlugin } from '../../plugins';
@@ -24,6 +24,19 @@ export interface BaseSalesState {
     schedule?: ScheduleModule;
     quotation?: QuotationModule;
 }
+export interface BaseSalesUpdateOrderPaymentOptions extends OrderPaymentUpdateOptions {
+    persistDraft?: boolean;
+    submitWhenPaid?: boolean;
+    forceSubmitIfPaid?: boolean;
+    /** 草稿恢复时，允许将新回调字段合并进已 paid 的支付项。 */
+    applyUpdatesWhenPaid?: boolean;
+    smallTicketDataFlag?: number;
+}
+export interface BaseSalesUpdateOrderPaymentResult extends OrderPaymentUpdateResult {
+    draftResult?: unknown;
+    draftError?: unknown;
+    syncResult?: SyncPaymentsToOrderResult<any>;
+}
 export type BaseSalesPrintLocalOrderReceiptParams = string | number;
 export declare class BaseSalesImpl extends BaseModule implements Module {
     protected defaultName: string;
@@ -128,6 +141,8 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      */
     protected readSessionCacheData(): Record<string, any>;
     protected getAppData<T>(key: string): T | undefined;
+    private getPaymentNumberDevicePrefixSync;
+    private getPaymentNumberDevicePrefixAsync;
     private syncAppDataToTempOrder;
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
     destroy(): Promise<void>;
@@ -193,9 +208,7 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     }): Promise<{
         productList: Record<string, any>[];
         discountList: Discount[];
-        availableWalletIds: number[];
     }>;
-    getAvailableWalletIds(): number[];
     bestDiscount(cb?: (result: any) => void): Promise<{
         productList: Record<string, any>[];
         discountList: Discount[];
@@ -240,6 +253,13 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
         confirmPendingVoucherPayments?: boolean;
         enhancePayload?: SubmitPayloadEnhancer;
     }): Promise<T>;
+    saveSalesOrderDraft<T = any>(params?: {
+        platform?: string;
+        businessCode?: string;
+        channel?: string;
+        type?: string;
+        enhancePayload?: SubmitPayloadEnhancer;
+    }): Promise<T>;
     submitTempOrderAsync<T = any>(params?: {
         payments?: OrderPaymentSource[];
         paymentStatus?: BaseSalesPaymentStatus;
@@ -258,16 +278,24 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     private queueLatestAutoPaymentSync;
     private scheduleQueuedAutoPaymentSyncFlush;
     private flushQueuedAutoPaymentSync;
-    /** 追加单个支付项到当前订单。 */
+    /**
+     * 同步兼容入口。无法等待 IoT 短号时，按调用当下的 device_id 或 LOCAL 生成。
+     */
     addOrderPayment(payment: OrderPaymentSource): OrderPaymentData[];
+    /** 创建新支付项时读取最新设备短号，不缓存运行时设备信息。 */
+    addOrderPaymentAsync(payment: OrderPaymentSource): Promise<OrderPaymentData[]>;
+    private addOrderPaymentWithDevicePrefix;
     /** 更新当前订单中的指定支付项。 */
-    updateOrderPayment(paymentIdentity: string | number, updates: Partial<OrderPaymentData> & Record<string, any>): OrderPaymentData[];
+    updateOrderPayment(paymentIdentity: string | number, updates: Partial<OrderPaymentData> & Record<string, any>, options?: BaseSalesUpdateOrderPaymentOptions): Promise<BaseSalesUpdateOrderPaymentResult>;
     /** 删除当前订单中的指定支付项。 */
     deleteOrderPayment(paymentIdentity: string | number): OrderPaymentData[];
     /** 覆盖 wallet pass 支付项，同时保留普通支付项。 */
     updateVoucherOrderPayments(payments: OrderPaymentSource[], options?: {
         status?: 'paid' | 'payment_pending';
     }): OrderPaymentData[];
+    updateVoucherOrderPaymentsAsync(payments: OrderPaymentSource[], options?: {
+        status?: 'paid' | 'payment_pending';
+    }): Promise<OrderPaymentData[]>;
     confirmPendingVoucherPayments(): OrderPaymentData[];
     discardPendingVoucherPayments(): OrderPaymentData[];
     private getWalletProductList;