@pisell/pisellos 2.2.266 → 2.2.268

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

@@ -213,12 +213,10 @@ export interface OrderBookingItem {
         [key: string]: unknown;
     }[];
 }
-/** 支付记录 metadata */
+/** 支付记录 metadata，常含 unique_payment_number */
 export interface OrderPaymentMetadata {
-    /** 三方支付交易流水号 */
+    /** 设备端本地支付唯一标识 */
     unique_payment_number?: string;
-    /** 刷卡机设备快照；server 不解析内部字段，仅透传并持久化 */
-    card_reader_snapshot?: Record<string, unknown>;
     [key: string]: unknown;
 }
 /**
@@ -227,8 +225,6 @@ 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 */
@@ -253,13 +249,11 @@ 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 */
+    /** 元数据；含 unique_payment_number。来源：OrderPayment.metadata */
     metadata?: OrderPaymentMetadata | null;
 }
 /**
@@ -419,8 +413,6 @@ 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/solution/BaseSales/index.d.ts

@@ -2,14 +2,14 @@ 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, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions } from '../../modules/Order/types';
+import type { AddProductBookingInput, AddProductToOrderOptions, LoadSalesDetailParams, OrderPaymentData, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions } from '../../modules/Order/types';
 import type { SubmitPayloadEnhancer } from '../../modules/Order/utils';
 import type { Discount } from '../../modules/Discount/types';
 import { RequestPlugin, WindowPlugin } from '../../plugins';
 export * from './types';
 import { ProductList } from '../../modules/ProductList';
 import { PaymentModule } from '../../modules/Payment';
-import type { PaymentMethod } from '../../modules/Payment/types';
+import type { PaymentMethod, RoundingResult } from '../../modules/Payment/types';
 import type { SalesSummaryModule } from '../../modules/SalesSummary';
 import type { ScheduleModule } from '../../modules/Schedule';
 import { QuotationModule } from '../../modules/Quotation';
@@ -24,19 +24,6 @@ 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;
@@ -48,11 +35,6 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     protected store: BaseSalesState;
     protected otherParams: Record<string, any>;
     protected cacheId: string | undefined;
-    /**
-     * 由已在初始化阶段解析过设备短号的业务解决方案写入。
-     * 未设置时，支付编号仍按原逻辑实时读取设备信息。
-     */
-    protected paymentNumberDevicePrefix: string | null;
     /**
      * window / request 暴露为 public：现存外部工具（如 BookingTicket Scan）通过
      * `solution.window` / `solution.request` 直接访问插件，保持原有契约不破坏。
@@ -146,13 +128,6 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      */
     protected readSessionCacheData(): Record<string, any>;
     protected getAppData<T>(key: string): T | undefined;
-    /**
-     * 复用业务解决方案初始化时已解析的支付设备短号。
-     * 空值会清除缓存，使后续支付恢复实时读取设备信息的兼容路径。
-     */
-    protected setPaymentNumberDevicePrefix(prefix: unknown): void;
-    private getPaymentNumberDevicePrefixSync;
-    private getPaymentNumberDevicePrefixAsync;
     private syncAppDataToTempOrder;
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
     destroy(): Promise<void>;
@@ -265,13 +240,6 @@ 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;
@@ -290,27 +258,16 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     private queueLatestAutoPaymentSync;
     private scheduleQueuedAutoPaymentSyncFlush;
     private flushQueuedAutoPaymentSync;
-    /**
-     * 同步兼容入口。无法等待 IoT 短号时，按调用当下的 device_id 或 LOCAL 生成。
-     */
+    /** 追加单个支付项到当前订单。 */
     addOrderPayment(payment: OrderPaymentSource): OrderPaymentData[];
-    /**
-     * 创建新支付项时优先使用业务解决方案初始化阶段缓存的设备短号；
-     * 未缓存的通用 BaseSales 保持实时读取设备信息的兼容语义。
-     */
-    addOrderPaymentAsync(payment: OrderPaymentSource): Promise<OrderPaymentData[]>;
-    private addOrderPaymentWithDevicePrefix;
     /** 更新当前订单中的指定支付项。 */
-    updateOrderPayment(paymentIdentity: string | number, updates: Partial<OrderPaymentData> & Record<string, any>, options?: BaseSalesUpdateOrderPaymentOptions): Promise<BaseSalesUpdateOrderPaymentResult>;
+    updateOrderPayment(paymentIdentity: string | number, updates: Partial<OrderPaymentData> & Record<string, any>): OrderPaymentData[];
     /** 删除当前订单中的指定支付项。 */
     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;
@@ -333,16 +290,15 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     getPaymentMethodsAsync(): Promise<PaymentMethod[]>;
     /** 同步读取初始化时缓存的支付方式列表。 */
     getPaymentMethods(): PaymentMethod[];
-    /** 轻量舍入能力，供现金支付 UI 计算 rounding_amount。 */
+    /**
+     * 按当前店铺的现金舍入配置计算金额，供现金支付 UI 使用。
+     *
+     * 舍入开关取自 CASHMANUAL 支付方式；舍入规则取自
+     * otherParams.order_rounding_setting，金额算法统一由 PaymentModule 维护。
+     */
     roundAmount(params: {
         amount: string | number;
-        interval?: string | number;
-        rule?: 'standard_rounding' | 'standard_down' | 'always_up' | 'always_down' | string;
-    }): {
-        originalAmount: string;
-        roundedAmount: string;
-        roundingDifference: string;
-    };
+    }): Promise<RoundingResult>;
     /**
      * 发送支付链接。
      *
@@ -359,7 +315,7 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     getQuotationCustomerScopeInfo(): BaseSalesQuotationCustomerScopeInfo;
     shouldRecalculateProductBookingPricesForContextChange(params: BaseSalesPriceRecalculationContextChange): boolean;
     calculateProductBookingPrices(paramsList: BaseSalesCalculateProductBookingPriceParams[]): Promise<BaseSalesProductBookingPriceResult[]>;
-    addProductToOrder(product: Partial<BaseSalesOrderProduct> & BaseSalesOrderProductIdentity, booking?: AddProductBookingInput): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    addProductToOrder(product: Partial<BaseSalesOrderProduct> & BaseSalesOrderProductIdentity, booking?: AddProductBookingInput, options?: AddProductToOrderOptions): Promise<import("../../modules/Order/types").OrderProduct[]>;
     updateOrderProduct(params: UpdateOrderProductParams): Promise<import("../../modules/Order/types").OrderProduct[]>;
     updateOrderProducts(paramsList: UpdateOrderProductParams[]): Promise<import("../../modules/Order/types").OrderProduct[]>;
     updateOrderProductQuantity(params: BaseSalesUpdateOrderProductQuantityParams): Promise<import("../../modules/Order/types").OrderProduct[]>;
@@ -375,8 +331,8 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      * @example
      * await baseSales.removeProductsFromOrder([identityA, identityB]);
      */
-    removeProductsFromOrder(identities: BaseSalesOrderProductIdentity[]): Promise<import("../../modules/Order/types").OrderProduct[]>;
-    removeProductFromOrder(identity: BaseSalesOrderProductIdentity): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    removeProductsFromOrder(identities: BaseSalesOrderProductIdentity[], options?: RemoveProductsFromOrderOptions): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    removeProductFromOrder(identity: BaseSalesOrderProductIdentity, options?: RemoveProductsFromOrderOptions): Promise<import("../../modules/Order/types").OrderProduct[]>;
     /**
      * 注入促销评估器到底层 OrderModule。
      *

package/lib/solution/BaseSales/index.js

@@ -40,8 +40,6 @@ var import_decimal = __toESM(require("decimal.js"));
 var import_lodash_es = require("lodash-es");
 var import_types2 = require("../BookingByStep/types");
 var import_utils = require("../../modules/Order/utils");
-var import_payment_utils = require("../../modules/Order/payment-utils");
-var import_payment_number = require("../../utils/payment-number");
 var import_orderCollectionIdentity = require("../../modules/Order/utils/orderCollectionIdentity");
 var import_dayjs = __toESM(require("dayjs"));
 __reExport(BaseSales_exports, require("./types"), module.exports);
@@ -79,11 +77,6 @@ function isBaseSalesHistoricalDiscountEntry(discount) {
     (discount == null ? void 0 : discount.isEditMode) || (discount == null ? void 0 : discount.isDisabled) || (discount == null ? void 0 : discount.order_discount_id) != null
   );
 }
-function getBaseSalesUniqueArrayMetadataKey(key) {
-  if (key === "products" || key === "bookings")
-    return "unique_identification_number";
-  return null;
-}
 var BASE_SALES_PERSISTENT_ID_FIELD_BY_KIND = {
   product: "order_detail_id",
   booking: "schedule_event_id",
@@ -157,15 +150,6 @@ function mergeBaseSalesCollectionItem(kind, currentItem, incomingItem, uidRemaps
   return kind === "product" ? mergeBaseSalesProductSnapshotFields(currentItem, mergedItem) : mergedItem;
 }
 function mergeBaseSalesOrderCollection(kind, currentValue, incomingValue, strategy, uidRemaps) {
-  if (kind === "payment") {
-    return (0, import_payment_utils.mergeOrderPaymentListsByIdentity)(
-      currentValue,
-      incomingValue,
-      strategy === "preserve-local" ? { preserveUnmatchedExisting: true } : {
-        preserveUnmatchedExistingWhen: (payment) => (0, import_payment_utils.isIdentifiedPendingOrderPayment)(payment) || !(0, import_orderCollectionIdentity.getOrderCollectionPersistentId)("payment", payment)
-      }
-    );
-  }
   const currentItems = (0, import_orderCollectionIdentity.normalizeOrderCollection)(kind, currentValue, {
     ensureUid: false
   }).items;
@@ -225,35 +209,6 @@ function normalizeBaseSalesRecordCollections(sourceRecord, options) {
   }
   return normalizedRecord;
 }
-function getBaseSalesMetadataUid(item, metadataKey) {
-  var _a;
-  const uid = ((_a = item == null ? void 0 : item.metadata) == null ? void 0 : _a[metadataKey]) ?? (item == null ? void 0 : item[metadataKey]);
-  if (uid === void 0 || uid === null || uid === "")
-    return null;
-  return String(uid);
-}
-function mergeBaseSalesUniqueArray(currentValue, loadedValue, metadataKey) {
-  const result = [];
-  const indexByUid = /* @__PURE__ */ new Map();
-  const appendOrReplaceByUid = (item) => {
-    const clonedItem = (0, import_lodash_es.cloneDeep)(item);
-    const uid = getBaseSalesMetadataUid(clonedItem, metadataKey);
-    if (!uid) {
-      result.push(clonedItem);
-      return;
-    }
-    const existingIndex = indexByUid.get(uid);
-    if (existingIndex !== void 0) {
-      result[existingIndex] = clonedItem;
-      return;
-    }
-    indexByUid.set(uid, result.length);
-    result.push(clonedItem);
-  };
-  currentValue.forEach(appendOrReplaceByUid);
-  loadedValue.forEach(appendOrReplaceByUid);
-  return result;
-}
 function mergeSalesDetailRecordWithTempOrder(currentTempOrder, loadedRecord, strategy) {
   const normalizedLoadedRecord = normalizeBaseSalesRecordCollections(
     loadedRecord || {},
@@ -282,15 +237,6 @@ function mergeSalesDetailRecordWithTempOrder(currentTempOrder, loadedRecord, str
         );
       }
       if (Array.isArray(currentValue) && Array.isArray(loadedValue)) {
-        if (key === "payments" || key === "payment") {
-          return (0, import_payment_utils.mergeOrderPaymentListsByIdentity)(currentValue, loadedValue, {
-            preserveUnmatchedExisting: true
-          });
-        }
-        const metadataKey = getBaseSalesUniqueArrayMetadataKey(key);
-        if (metadataKey) {
-          return mergeBaseSalesUniqueArray(currentValue, loadedValue, metadataKey);
-        }
         return [
           ...(0, import_lodash_es.cloneDeep)(currentValue),
           ...(0, import_lodash_es.cloneDeep)(loadedValue)
@@ -309,18 +255,6 @@ function mergeSalesDetailRecordWithTempOrder(currentTempOrder, loadedRecord, str
     (0, import_orderCollectionIdentity.applyOrderCollectionUidRemaps)(mergedRecord, uidRemaps)
   );
 }
-function filterPendingPaymentsFromLoadedSalesDetail(sourceRecord) {
-  if (!sourceRecord || typeof sourceRecord !== "object")
-    return sourceRecord;
-  const record = { ...sourceRecord };
-  if (Array.isArray(sourceRecord.payments)) {
-    record.payments = sourceRecord.payments.filter((payment) => !(0, import_payment_utils.isPendingOrderPayment)(payment));
-  }
-  if (Array.isArray(sourceRecord.payment)) {
-    record.payment = sourceRecord.payment.filter((payment) => !(0, import_payment_utils.isPendingOrderPayment)(payment));
-  }
-  return record;
-}
 var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   constructor(name, version) {
     super(name, version);
@@ -332,11 +266,6 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       order: void 0
     };
     this.otherParams = {};
-    /**
-     * 由已在初始化阶段解析过设备短号的业务解决方案写入。
-     * 未设置时，支付编号仍按原逻辑实时读取设备信息。
-     */
-    this.paymentNumberDevicePrefix = null;
     // 当前缓存中已加载的最新 SalesDetail；只读 getter 走它对外暴露详情数据。
     this.currentSalesDetail = null;
     this.discountConfigCacheKey = null;
@@ -867,27 +796,6 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     const coreData = (_f = (_d = (_c = app == null ? void 0 : app.models) == null ? void 0 : _c.getStore) == null ? void 0 : (_e = _d.call(_c)).getDataByModel) == null ? void 0 : _f.call(_e, "core", "core");
     return coreData == null ? void 0 : coreData[key];
   }
-  /**
-   * 复用业务解决方案初始化时已解析的支付设备短号。
-   * 空值会清除缓存，使后续支付恢复实时读取设备信息的兼容路径。
-   */
-  setPaymentNumberDevicePrefix(prefix) {
-    const normalized = String(prefix ?? "").trim();
-    this.paymentNumberDevicePrefix = normalized || null;
-  }
-  getPaymentNumberDevicePrefixSync() {
-    if (!this.appPlugin)
-      return "LOCAL";
-    return (0, import_payment_number.resolvePaymentNumberDevicePrefixFromDeviceId)((key) => this.getAppData(key));
-  }
-  getPaymentNumberDevicePrefixAsync() {
-    if (!this.appPlugin)
-      return Promise.resolve("LOCAL");
-    if (this.paymentNumberDevicePrefix) {
-      return Promise.resolve(this.paymentNumberDevicePrefix);
-    }
-    return (0, import_payment_number.resolvePaymentNumberDevicePrefix)((key) => this.getAppData(key));
-  }
   syncAppDataToTempOrder(tempOrder) {
     const isPriceIncludeTax = this.getAppData("is_price_include_tax");
     const taxCountryCode = this.getAppData("tax_country_code");
@@ -928,7 +836,6 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     var _a, _b;
     this.core = core;
     this.initializeOptions = options || {};
-    this.paymentNumberDevicePrefix = null;
     this.otherParams = options.otherParams || {};
     this.cacheId = (_a = this.otherParams) == null ? void 0 : _a.cacheId;
     this.reusedSharedSubModuleNames.clear();
@@ -990,7 +897,6 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       }
     });
     this.currentSalesDetail = null;
-    this.paymentNumberDevicePrefix = null;
     this.queuedServerOrderChanges = [];
     this.salesDetailLoadSequence += 1;
     await this.core.effects.emit(`${this.name}:onDestroy`, {});
@@ -1024,16 +930,13 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
         const message = loadedRecord && (loadedRecord.message || loadedRecord.msg) || `加载销售详情失败: ${lookup}`;
         throw new Error(message);
       }
-      const remoteRecord = filterPendingPaymentsFromLoadedSalesDetail(
-        preloadedSalesDetail ?? loadedRecord.data
-      );
+      const remoteRecord = preloadedSalesDetail ?? loadedRecord.data;
       const currentTempOrder = params.merge ? this.store.order.getTempOrder() : null;
-      const mergedRecord = params.merge ? mergeSalesDetailRecordWithTempOrder(
+      const record = params.merge ? mergeSalesDetailRecordWithTempOrder(
         currentTempOrder,
         remoteRecord,
         "preserve-local"
       ) : remoteRecord;
-      const record = filterPendingPaymentsFromLoadedSalesDetail(mergedRecord);
       return await this.hydrateLatestLoadedSalesDetail(record, loadSequence);
     } finally {
       this.salesDetailLoadInFlightCount = Math.max(
@@ -1824,20 +1727,6 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     };
     return this.store.order.submitTempOrder(submitParams);
   }
-  async saveSalesOrderDraft(params) {
-    var _a, _b, _c, _d;
-    if (!this.store.order) {
-      throw new Error("BaseSales 解决方案需要 order 模块支持");
-    }
-    return this.store.order.saveTempOrderAsDraft({
-      cacheId: this.cacheId,
-      platform: (params == null ? void 0 : params.platform) ?? ((_a = this.otherParams) == null ? void 0 : _a.platform),
-      businessCode: (params == null ? void 0 : params.businessCode) ?? ((_b = this.otherParams) == null ? void 0 : _b.businessCode) ?? ((_c = this.otherParams) == null ? void 0 : _c.business_code),
-      channel: (params == null ? void 0 : params.channel) ?? this.getSubmitOrderSalesChannel(),
-      type: (params == null ? void 0 : params.type) ?? ((_d = this.otherParams) == null ? void 0 : _d.type),
-      ...(params == null ? void 0 : params.enhancePayload) !== void 0 ? { enhancePayload: params.enhancePayload } : {}
-    });
-  }
   async submitTempOrderAsync(params) {
     var _a, _b, _c, _d;
     if (!this.store.order) {
@@ -2038,29 +1927,8 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       }
     }
   }
-  /**
-   * 同步兼容入口。无法等待 IoT 短号时，按调用当下的 device_id 或 LOCAL 生成。
-   */
+  /** 追加单个支付项到当前订单。 */
   addOrderPayment(payment) {
-    const hasPaymentNumber = String(
-      payment.payment_number || ""
-    ).trim() !== "";
-    return this.addOrderPaymentWithDevicePrefix(
-      payment,
-      hasPaymentNumber ? "LOCAL" : this.getPaymentNumberDevicePrefixSync()
-    );
-  }
-  /**
-   * 创建新支付项时优先使用业务解决方案初始化阶段缓存的设备短号；
-   * 未缓存的通用 BaseSales 保持实时读取设备信息的兼容语义。
-   */
-  async addOrderPaymentAsync(payment) {
-    const paymentRecord = payment;
-    const hasPaymentNumber = String(paymentRecord.payment_number || "").trim() !== "";
-    const devicePrefix = hasPaymentNumber ? "LOCAL" : await this.getPaymentNumberDevicePrefixAsync();
-    return this.addOrderPaymentWithDevicePrefix(payment, devicePrefix);
-  }
-  addOrderPaymentWithDevicePrefix(payment, devicePrefix) {
     var _a;
     if (!this.store.order)
       throw new Error("order 模块未初始化");
@@ -2077,26 +1945,21 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     if (shopWalletPassId !== void 0 && shopWalletPassId !== null) {
       metadata.shop_wallet_pass_id = shopWalletPassId;
     }
-    const normalizedPaymentRecord = (0, import_payment_utils.ensureOrderPaymentNumber)(
-      paymentRecord,
-      devicePrefix,
-      import_utils.createUuidV4
-    );
+    if (!metadata.unique_payment_number) {
+      metadata.unique_payment_number = (0, import_utils.createUuidV4)();
+    }
     const paymentTimestamp = (0, import_dayjs.default)().format("YYYY-MM-DD HH:mm:ss");
     const paymentTime = paymentRecord.payment_time ?? paymentTimestamp;
     const createdAt = paymentRecord.created_at ?? paymentTimestamp;
     const serviceCharge = paymentRecord.service_charge && typeof paymentRecord.service_charge === "object" ? paymentRecord.service_charge : null;
     const calculatedServiceFee = serviceCharge ? new import_decimal.default(paymentRecord.origin_amount ?? paymentRecord.amount ?? 0).times(serviceCharge.percentage || 0).plus(serviceCharge.amount || 0).toDecimalPlaces(2).toFixed(2) : void 0;
     const payments = this.store.order.addOrderPayment({
-      ...normalizedPaymentRecord,
+      ...paymentRecord,
       ...calculatedServiceFee !== void 0 ? { service_fee: calculatedServiceFee } : {},
       metadata,
       payment_time: paymentTime,
       created_at: createdAt
     });
-    if (paymentRecord.status === "payment_pending") {
-      return payments;
-    }
     const amountSnapshot = this.store.order.getOrderAmountSnapshot();
     const syncState = this.store.order.getOrderSyncState();
     if (amountSnapshot) {
@@ -2118,73 +1981,10 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     return payments;
   }
   /** 更新当前订单中的指定支付项。 */
-  async updateOrderPayment(paymentIdentity, updates, options = {}) {
-    var _a, _b, _c;
+  updateOrderPayment(paymentIdentity, updates) {
     if (!this.store.order)
       throw new Error("order 模块未初始化");
-    const matchMode = options.matchBy === "compat" || options.matchBy === "legacy" ? "compat" : "payment_number";
-    const previousMatch = (0, import_payment_utils.resolveOrderPaymentIdentity)(
-      this.store.order.getOrderPayments(),
-      paymentIdentity,
-      matchMode
-    );
-    const previousPayment = previousMatch == null ? void 0 : previousMatch.payment;
-    if ((previousPayment == null ? void 0 : previousPayment.status) === "paid" && !options.applyUpdatesWhenPaid) {
-      const currentPayments = this.store.order.getOrderPayments();
-      let syncResult2;
-      if (options.submitWhenPaid && options.forceSubmitIfPaid) {
-        syncResult2 = await this.syncPaymentsToOrder({
-          payments: currentPayments,
-          paymentStatus: this.getPaymentStatusForSync(currentPayments),
-          submitWhenPaid: true,
-          smallTicketDataFlag: options.smallTicketDataFlag ?? 1
-        });
-      }
-      return {
-        updated: false,
-        payment: previousPayment,
-        payments: currentPayments,
-        summary: ((_a = this.store.order.getOrderAmountSnapshot()) == null ? void 0 : _a.summary) || null,
-        ...syncResult2 !== void 0 ? { syncResult: syncResult2 } : {}
-      };
-    }
-    const result = await this.store.order.updateOrderPayment(paymentIdentity, updates, {
-      matchBy: matchMode
-    });
-    let draftResult;
-    let draftError;
-    if (options.persistDraft !== false) {
-      try {
-        draftResult = await this.saveSalesOrderDraft();
-      } catch (error) {
-        draftError = error;
-        this.logError("updateOrderPayment: 保存支付草稿失败", {
-          paymentIdentity,
-          error: error instanceof Error ? error.message : String(error)
-        });
-        if (!options.submitWhenPaid)
-          throw error;
-      }
-    }
-    const becamePaid = (previousPayment == null ? void 0 : previousPayment.status) !== "paid" && ((_b = result.payment) == null ? void 0 : _b.status) === "paid";
-    const shouldSubmit = Boolean(
-      options.submitWhenPaid && ((_c = result.payment) == null ? void 0 : _c.status) === "paid" && (becamePaid || options.forceSubmitIfPaid)
-    );
-    let syncResult;
-    if (shouldSubmit) {
-      syncResult = await this.syncPaymentsToOrder({
-        payments: result.payments,
-        paymentStatus: this.getPaymentStatusForSync(result.payments),
-        submitWhenPaid: true,
-        smallTicketDataFlag: options.smallTicketDataFlag ?? 1
-      });
-    }
-    return {
-      ...result,
-      ...draftResult !== void 0 ? { draftResult } : {},
-      ...draftError !== void 0 ? { draftError } : {},
-      ...syncResult !== void 0 ? { syncResult } : {}
-    };
+    return this.store.order.updateOrderPayment(paymentIdentity, updates);
   }
   /** 删除当前订单中的指定支付项。 */
   deleteOrderPayment(paymentIdentity) {
@@ -2198,11 +1998,6 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       throw new Error("order 模块未初始化");
     return this.store.order.updateVoucherOrderPayments(payments, options);
   }
-  async updateVoucherOrderPaymentsAsync(payments, options) {
-    if (!this.store.order)
-      throw new Error("order 模块未初始化");
-    return this.store.order.updateVoucherOrderPaymentsAsync(payments, options);
-  }
   confirmPendingVoucherPayments() {
     if (!this.store.order)
       throw new Error("order 模块未初始化");
@@ -2349,28 +2144,33 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
   getPaymentMethods() {
     return [...this.paymentMethodsCache];
   }
-  /** 轻量舍入能力，供现金支付 UI 计算 rounding_amount。 */
-  roundAmount(params) {
-    const amount = new import_decimal.default(params.amount || 0);
-    const interval = new import_decimal.default(params.interval || 0.05);
-    const rule = params.rule || "standard_rounding";
-    const quotient = amount.div(interval);
-    let roundedQuotient;
-    if (rule === "always_up") {
-      roundedQuotient = quotient.ceil();
-    } else if (rule === "always_down") {
-      roundedQuotient = quotient.floor();
-    } else if (rule === "standard_down") {
-      roundedQuotient = quotient.toDecimalPlaces(0, import_decimal.default.ROUND_HALF_DOWN);
-    } else {
-      roundedQuotient = quotient.toDecimalPlaces(0, import_decimal.default.ROUND_HALF_UP);
+  /**
+   * 按当前店铺的现金舍入配置计算金额，供现金支付 UI 使用。
+   *
+   * 舍入开关取自 CASHMANUAL 支付方式；舍入规则取自
+   * otherParams.order_rounding_setting，金额算法统一由 PaymentModule 维护。
+   */
+  async roundAmount(params) {
+    var _a, _b, _c;
+    const amount = params.amount;
+    const cashManualPayment = this.paymentMethodsCache.find(
+      (paymentMethod) => paymentMethod.code === "CASHMANUAL"
+    );
+    if (!((_a = cashManualPayment == null ? void 0 : cashManualPayment.metadata) == null ? void 0 : _a.order_rounding_switch)) {
+      return {
+        originalAmount: amount.toString(),
+        roundedAmount: amount.toString(),
+        roundingDifference: "0.00"
+      };
     }
-    const roundedAmount = roundedQuotient.times(interval).toDecimalPlaces(2);
-    return {
-      originalAmount: amount.toFixed(2),
-      roundedAmount: roundedAmount.toFixed(2),
-      roundingDifference: roundedAmount.minus(amount).toFixed(2)
-    };
+    if (!this.payment) {
+      throw new Error("payment 模块未初始化");
+    }
+    return this.payment.roundAmountAsync(
+      amount,
+      (_b = this.otherParams.order_rounding_setting) == null ? void 0 : _b.interval,
+      (_c = this.otherParams.order_rounding_setting) == null ? void 0 : _c.type
+    );
   }
   /**
    * 发送支付链接。
@@ -2540,11 +2340,11 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       });
     });
   }
-  async addProductToOrder(product, booking) {
+  async addProductToOrder(product, booking, options) {
     try {
       if (!this.store.order)
         throw new Error("order 模块未初始化");
-      const products = await this.store.order.addProductToOrder(product, booking);
+      const products = await this.store.order.addProductToOrder(product, booking, options);
       return products;
     } catch (error) {
       throw error;
@@ -2620,17 +2420,17 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
    * @example
    * await baseSales.removeProductsFromOrder([identityA, identityB]);
    */
-  async removeProductsFromOrder(identities) {
+  async removeProductsFromOrder(identities, options) {
     try {
       if (!this.store.order)
         throw new Error("order 模块未初始化");
-      return await this.store.order.removeProductsFromOrder(identities);
+      return await this.store.order.removeProductsFromOrder(identities, options);
     } catch (error) {
       throw error;
     }
   }
-  async removeProductFromOrder(identity) {
-    return this.removeProductsFromOrder([identity]);
+  async removeProductFromOrder(identity, options) {
+    return this.removeProductsFromOrder([identity], options);
   }
   // ─── 促销/赠品 透传（迁移自 booking usePromotion） ────────────────
   /**

package/lib/solution/BaseSales/utils/cartPromotion.d.ts

@@ -78,7 +78,6 @@ export interface CartPromotionEvaluator {
         }>;
         hasApplicableStrategy: boolean;
     }>;
-    getStrategyConfigs?: () => unknown[];
 }
 /** 单个赠品减量项 */
 export interface GiftReduceItem {
@@ -268,8 +267,7 @@ export declare function appendPromotionTags<T extends Record<string, any>>(produ
  * 处理购物车的促销计算与赠品差异化。
  *
  * 流程：
- * 1. 分离 main / gift / edit-product 三类（普通促销下带 `booking_id` 的编辑态商品不参与；
- *    配置 ITEM_REWARD 时，编辑态商品也参与商品奖励重算）
+ * 1. 分离 main / gift / edit-product 三类（带 `booking_id` 的编辑态商品不参与促销）
  * 2. 转 PromotionProduct 喂评估器 → 拿到 `evaluateCartWithPricing` 与 `getProductsApplicableStrategies`
  * 3. 把 PricedProduct 映射回 OrderProduct 形态：
  *    - 参与促销的，写 `metadata._promotion` + 调整 `selling_price` / `main_product_selling_price`