@pisell/pisellos 2.3.101 → 2.3.103

package/lib/modules/Product/types.d.ts

@@ -23,12 +23,25 @@ export interface ProductDataVariant {
     module_data_id: number;
     /** 关联 data_variant_rule.id */
     data_variant_rule_id: number;
+    /** 多货币结算等业务类型 */
+    business_type?: 'multi_currency_settlement' | string;
+    /** 数据状态；多货币结算仅处理 enable 记录 */
+    status?: 'enable' | 'disable' | string;
     /** 命中策略后覆盖到商品上的字段 */
     data: Record<string, any>;
     created_at: string | null;
     updated_at: string | null;
     deleted_at: string | null;
 }
+export interface ProductSettlementOption extends Record<string, any> {
+    settlement_type: 'legal_currency' | 'virtual_currency' | string;
+    currency_product_id?: number;
+    price: string;
+    data_variant_id?: number;
+    data_variant_rule_id: number | string;
+    available: boolean;
+    disabled_reason?: string;
+}
 /**
  * 商品基本信息接口
  */
@@ -61,6 +74,8 @@ export interface ProductData {
     sum_stock: number;
     /** 商品价格 */
     price: string;
+    /** 当前上下文解析出的可选结算货币 */
+    available_settlement_options?: ProductSettlementOption[];
     /** 商品原价 */
     original_price: string;
     /** 商品成本价 */
@@ -239,6 +254,14 @@ export interface ProductData {
     option_group_count: number;
     /** 智能定价变体列表，/product/query with dataVariants 返回 */
     data_variants?: ProductDataVariant[];
+    /**
+     * 商品接口规则计算结果；data_variant_ids 按优先级从高到低排列。
+     * 空数组表示规则已经计算完成但没有命中 Data Variant。
+     */
+    metadata?: {
+        data_variant_ids?: Array<number | string>;
+        [key: string]: any;
+    };
     /** 服务时长 */
     service_times?: any;
 }

package/lib/modules/SalesSummary/index.d.ts

@@ -30,6 +30,7 @@ export declare class SalesSummaryModule extends BaseModule implements Module, Sa
         taxRate?: number;
         shopDiscount?: string | number;
         channel?: string;
+        virtualSettlementMode?: boolean;
     }): Promise<{
         tax_title: string;
         tax_rate: number | undefined;

package/lib/modules/SalesSummary/index.js

@@ -126,7 +126,8 @@ class SalesSummaryModule extends _BaseModule.BaseModule {
       isPriceIncludeTax,
       taxRate,
       shopDiscount,
-      channel
+      channel,
+      virtualSettlementMode = false
     } = params;
     const summaryChannel = channel || this.resolveChannel();
     if (summaryChannel !== this.surchargeListChannel) {
@@ -151,7 +152,8 @@ class SalesSummaryModule extends _BaseModule.BaseModule {
       surchargeList: this.store.surchargeList,
       scheduleById,
       isInScheduleByDate: _Schedule.ScheduleModule.isInScheduleByDate,
-      shopDiscount
+      shopDiscount,
+      virtualSettlementMode
     });
     const summaryWithTaxMeta = {
       ...summary,

package/lib/modules/SalesSummary/types.d.ts

@@ -64,5 +64,6 @@ export interface SalesSummaryModuleAPI {
         taxRate?: number;
         shopDiscount?: string | number;
         channel?: string;
+        virtualSettlementMode?: boolean;
     }): Promise<SalesSummaryData>;
 }

package/lib/modules/SalesSummary/utils.d.ts

@@ -8,4 +8,5 @@ export declare function calculateSalesSummary(params: {
     scheduleById?: Record<string, any>;
     isInScheduleByDate?: any;
     shopDiscount?: string | number;
+    virtualSettlementMode?: boolean;
 }): SalesSummaryData;

package/lib/modules/SalesSummary/utils.js

@@ -837,11 +837,27 @@ function calculateSalesSummary(params) {
     surchargeList,
     scheduleById = {},
     isInScheduleByDate,
-    shopDiscount
+    shopDiscount,
+    virtualSettlementMode = false
   } = params;
   if (!products?.length) return createEmptySalesSummary();
   const summaryProducts = products.filter(product => !isGeneratedVoucherProduct(product));
   if (!summaryProducts.length) return createEmptySalesSummary();
+  if (virtualSettlementMode) {
+    const productQuantity = summaryProducts.reduce((sum, item) => sum + getSafeNum(item.num), 0);
+    const productAmount = summaryProducts.reduce((sum, item) => sum.plus(toDecimal(item.selling_price).times(getSafeNum(item.num))), new _decimal.default(0));
+    const amount = toFixed2(productAmount);
+    return {
+      ...createEmptySalesSummary(),
+      product_quantity: productQuantity,
+      product_original_amount: amount,
+      product_amount: amount,
+      product_expect_amount: amount,
+      expect_amount: amount,
+      total_amount: amount,
+      is_price_include_tax: isPriceIncludeTax
+    };
+  }
   const productQuantity = summaryProducts.reduce((sum, item) => sum + getSafeNum(item.num), 0);
   const productOriginalAmount = summaryProducts.reduce((sum, item) => sum.plus(getUnitOriginalTotal(item).times(getSafeNum(item.num))), new _decimal.default(0));
   const productAmount = summaryProducts.reduce((sum, item) => sum.plus(getUnitPaymentTotal(item).times(getSafeNum(item.num))), new _decimal.default(0));

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

@@ -4,7 +4,7 @@ import { BaseSalesOrderProduct, BaseSalesOrderProductIdentity, BaseSalesPaymentS
 import { OrderModule } from '../../modules/Order';
 import type { AddProductBookingInput, AddProductToOrderOptions, LoadSalesDetailParams, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions, ReplaceTempOrderOptions, SalesNote, SalesNotesMutationSnapshot, SetSalesNoteInput, PickupReferenceMode, ShopServiceData, ShopServiceType } from '../../modules/Order/types';
 import type { SubmitPayloadEnhancer } from '../../modules/Order/utils';
-import type { Discount } from '../../modules/Discount/types';
+import type { Discount, VirtualCurrencyAsset } from '../../modules/Discount/types';
 import { RequestPlugin, WindowPlugin } from '../../plugins';
 export * from './types';
 import { ProductList } from '../../modules/ProductList';
@@ -193,6 +193,9 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     protected setPaymentNumberDevicePrefix(prefix: unknown): void;
     private getPaymentNumberDevicePrefixSync;
     private getPaymentNumberDevicePrefixAsync;
+    private isMultiCurrencySettlementEnabled;
+    private isActiveVirtualSettlementOrder;
+    private isHistoricalVirtualSettlementOrder;
     private syncAppDataToTempOrder;
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
     destroy(): Promise<void>;
@@ -253,6 +256,8 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      * 同步清空内存中的 salesDetail 商品/预约视图，避免编辑态仍读到旧 bookings。
      */
     clearOrderCartLines(): Promise<OrderTempOrder>;
+    /** 切换法币 / WalletPass 单位时清空商品、折扣与支付状态，保留客户。 */
+    clearOrderForSettlementSwitch(): Promise<OrderTempOrder>;
     getOrderProducts(): import("../../modules/Order/types").OrderProduct[];
     getSummary(): Promise<OrderSummary>;
     private getHistoricalProductDiscountList;
@@ -263,12 +268,15 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     loadDiscountConfig(params?: {
         customerId?: number;
         action?: 'create' | 'edit';
+        force?: boolean;
     }): Promise<{
         productList: Record<string, any>[];
         discountList: Discount[];
         availableWalletIds: number[];
+        virtualCurrencyList: VirtualCurrencyAsset[];
     }>;
     getAvailableWalletIds(): number[];
+    getVirtualCurrencyList(): VirtualCurrencyAsset[];
     bestDiscount(cb?: (result: any) => void): Promise<{
         productList: Record<string, any>[];
         discountList: Discount[];
@@ -300,6 +308,7 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
         confirmPendingVoucherPayments?: boolean;
         enhancePayload?: SubmitPayloadEnhancer;
     }): Promise<T>;
+    private buildVirtualSettlementSubmitData;
     /**
      * 提交当前 Sales 订单。
      *

package/lib/solution/BaseSales/index.js

@@ -25,6 +25,7 @@ var _decimal = _interopRequireDefault(require("decimal.js"));
 var _lodashEs = require("lodash-es");
 var _types2 = require("../BookingByStep/types");
 var _utils = require("../../modules/Order/utils");
+var _virtualSettlement = require("../../modules/Order/utils/virtualSettlement");
 var _paymentUtils = require("../../modules/Order/payment-utils");
 var _paymentNumber = require("../../utils/payment-number");
 var _orderCollectionIdentity = require("../../modules/Order/utils/orderCollectionIdentity");
@@ -1253,11 +1254,24 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     }
     return (0, _paymentNumber.resolvePaymentNumberDevicePrefix)(key => this.getAppData(key));
   }
+  isMultiCurrencySettlementEnabled() {
+    return this.otherParams?.enableMultiCurrencySettlement === true;
+  }
+  isActiveVirtualSettlementOrder(tempOrder) {
+    return this.isMultiCurrencySettlementEnabled() && (0, _virtualSettlement.isVirtualSettlementOrder)(tempOrder);
+  }
+  isHistoricalVirtualSettlementOrder(tempOrder) {
+    return tempOrder?.metadata?.currency_settlement_config?.settlement_type === 'virtual_currency';
+  }
   syncAppDataToTempOrder(tempOrder) {
     const isPriceIncludeTax = this.getAppData('is_price_include_tax');
     const taxCountryCode = this.getAppData('tax_country_code');
     const currencyCode = this.getAppData('shop_currency_code');
     const currencySymbol = this.getAppData('shop_symbol');
+    // 历史虚拟币订单不依赖交易开关；普通 POS 不从商品行残留快照推断订单币种。
+    const isHistoricalVirtualSettlement = this.isHistoricalVirtualSettlementOrder(tempOrder);
+    const isVirtualSettlement = this.isActiveVirtualSettlementOrder(tempOrder) || isHistoricalVirtualSettlement;
+    const shouldManageLegalCurrencySnapshot = this.isMultiCurrencySettlementEnabled() || isHistoricalVirtualSettlement;
     let isChanged = false;
     if (isPriceIncludeTax !== undefined) {
       const nextIsPriceIncludeTax = Number(isPriceIncludeTax);
@@ -1273,14 +1287,26 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
         isChanged = true;
       }
     }
-    if (currencyCode !== undefined) {
+    tempOrder.metadata = tempOrder.metadata || {};
+    if (shouldManageLegalCurrencySnapshot) {
+      const legalCurrencySnapshot = {
+        currency_code: String(currencyCode ?? tempOrder.metadata.legal_currency_snapshot?.currency_code ?? tempOrder.currency_code ?? ''),
+        currency_symbol: String(currencySymbol ?? tempOrder.metadata.legal_currency_snapshot?.currency_symbol ?? tempOrder.currency_symbol ?? ''),
+        currency_format: String(tempOrder.metadata.legal_currency_snapshot?.currency_format || (isVirtualSettlement ? 'symbol_first' : tempOrder.currency_format) || 'symbol_first')
+      };
+      if (JSON.stringify(tempOrder.metadata.legal_currency_snapshot || {}) !== JSON.stringify(legalCurrencySnapshot)) {
+        tempOrder.metadata.legal_currency_snapshot = legalCurrencySnapshot;
+        isChanged = true;
+      }
+    }
+    if (!isVirtualSettlement && currencyCode !== undefined) {
       const nextCurrencyCode = String(currencyCode || '');
       if (tempOrder.currency_code !== nextCurrencyCode) {
         tempOrder.currency_code = nextCurrencyCode;
         isChanged = true;
       }
     }
-    if (currencySymbol !== undefined) {
+    if (!isVirtualSettlement && currencySymbol !== undefined) {
       const nextCurrencySymbol = String(currencySymbol || '');
       if (tempOrder.currency_symbol !== nextCurrencySymbol) {
         tempOrder.currency_symbol = nextCurrencySymbol;
@@ -1654,6 +1680,24 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       throw error;
     }
   }
+
+  /** 切换法币 / WalletPass 单位时清空商品、折扣与支付状态，保留客户。 */
+  async clearOrderForSettlementSwitch() {
+    if (!this.store.order) throw new Error('order 模块未初始化');
+    const tempOrder = await this.store.order.clearOrderForSettlementSwitch();
+    if (this.currentSalesDetail) {
+      this.currentSalesDetail = {
+        ...this.currentSalesDetail,
+        products: [],
+        bookings: [],
+        rootBooking: null,
+        bookingsByProductUid: {},
+        discount_list: [],
+        payments: []
+      };
+    }
+    return tempOrder;
+  }
   getOrderProducts() {
     if (!this.store.order) throw new Error('order 模块未初始化');
     const products = this.store.order.getOrderProducts();
@@ -1779,9 +1823,14 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     const hasManualDiscountSelection = this.hasManualDiscountSelection || currentDiscountList.some(discount => discount.isManualSelect);
     const discountAction = params?.action || (orderId ? 'edit' : 'create');
     const discountConfigCacheKey = [customerId, discountAction, Number(orderId) || 0].join(':');
-    let preparedDiscountList = [];
+
+    // Walk-In 不请求 prepare config；当前搜索/扫码券必须继续参与本次重算。
+    // current 优先于 original，保留搜索后的最新选择与可用状态。
+    const searchedDiscountList = currentDiscountList.filter(discount => discount.isScan);
+    const searchedDiscountIds = new Set(searchedDiscountList.map(discount => String(discount.id)));
+    let preparedDiscountList = [...searchedDiscountList, ...originalDiscountList.filter(discount => !searchedDiscountIds.has(String(discount.id)))];
     if (customerId && customerId !== 1) {
-      if (this.discountConfigCacheKey === discountConfigCacheKey) {
+      if (!params?.force && this.discountConfigCacheKey === discountConfigCacheKey) {
         preparedDiscountList = originalDiscountList;
       } else {
         preparedDiscountList = await this.store.order.loadDiscountConfig({
@@ -1794,11 +1843,24 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
         await discountModule?.setOriginalDiscountList?.(preparedDiscountList);
       }
     }
+    if (this.isActiveVirtualSettlementOrder(tempOrder)) {
+      await discountModule?.setOriginalDiscountList?.([]);
+      await discountModule?.setDiscountList?.([]);
+      tempOrder.discount_list = [];
+      tempOrder.shop_discount = '0.00';
+      return {
+        productList: tempOrder.products || [],
+        discountList: [],
+        availableWalletIds: this.getAvailableWalletIds(),
+        virtualCurrencyList: this.store.order.getVirtualCurrencyList()
+      };
+    }
     if (hasManualDiscountSelection && currentDiscountList.length) {
       return {
         productList: tempOrder.products || [],
         discountList: currentDiscountList,
-        availableWalletIds: this.getAvailableWalletIds()
+        availableWalletIds: this.getAvailableWalletIds(),
+        virtualCurrencyList: this.store.order.getVirtualCurrencyList()
       };
     }
     let nextDiscountList = this.mergeHistoricalDiscountList(preparedDiscountList || discountModule?.getDiscountList?.() || [], tempOrder.products || []);
@@ -1824,7 +1886,8 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       return {
         productList: tempOrder.products || [],
         discountList: nextDiscountList,
-        availableWalletIds: this.getAvailableWalletIds()
+        availableWalletIds: this.getAvailableWalletIds(),
+        virtualCurrencyList: this.store.order.getVirtualCurrencyList()
       };
     }
     if (rulesModule) {
@@ -1880,16 +1943,29 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     return {
       productList: tempOrder.products || [],
       discountList: nextDiscountList,
-      availableWalletIds: this.getAvailableWalletIds()
+      availableWalletIds: this.getAvailableWalletIds(),
+      virtualCurrencyList: this.store.order.getVirtualCurrencyList()
     };
   }
   getAvailableWalletIds() {
     if (!this.store.order?.getAvailableWalletIds) return [];
     return this.store.order.getAvailableWalletIds();
   }
+  getVirtualCurrencyList() {
+    if (!this.store.order?.getVirtualCurrencyList) return [];
+    return this.store.order.getVirtualCurrencyList();
+  }
   async bestDiscount(cb) {
     if (!this.store.order) throw new Error('order 模块未初始化');
     const tempOrder = this.store.order.ensureTempOrder();
+    if (this.isActiveVirtualSettlementOrder(tempOrder)) {
+      const result = {
+        productList: tempOrder.products || [],
+        discountList: []
+      };
+      cb?.(result);
+      return result;
+    }
     const orderStore = this.store.order.store || {};
     const discountModule = orderStore.discount;
     const rulesModule = orderStore.rules;
@@ -1997,6 +2073,17 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
   async setDiscountSelected(params) {
     try {
       if (!this.store.order) throw new Error('order 模块未初始化');
+      const currentOrder = this.store.order.ensureTempOrder();
+      if (this.isActiveVirtualSettlementOrder(currentOrder)) {
+        currentOrder.discount_list = [];
+        currentOrder.shop_discount = '0.00';
+        await this.store.order.store?.discount?.setDiscountList?.([]);
+        await this.store.order.recalculateSummary({
+          createIfMissing: true
+        });
+        this.store.order.persistTempOrder();
+        return;
+      }
       const list = this.store.order.getDiscountList();
       const updated = list.map(d => d.id === params.discountId && !isBaseSalesHistoricalDiscountEntry(d) ? {
         ...d,
@@ -2135,6 +2222,101 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     // Deprecated compatibility alias. New BaseSales callers should use submitSalesOrder.
     return this.submitSalesOrder(params);
   }
+  async buildVirtualSettlementSubmitData() {
+    if (!this.store.order) return null;
+    const tempOrder = this.store.order.getTempOrder();
+    if (!this.isActiveVirtualSettlementOrder(tempOrder)) return null;
+    const snapshot = (0, _virtualSettlement.getTempOrderSettlementSnapshot)(tempOrder);
+    const currencyProductId = Number(tempOrder?.metadata?.currency_settlement_config?.settlement_ids?.[0] ?? snapshot?.currency_product_id);
+    if (!snapshot || !Number.isFinite(currencyProductId) || currencyProductId <= 0) {
+      throw new Error('Virtual currency settlement configuration is invalid.');
+    }
+    const summary = await this.store.order.recalculateSummary({
+      createIfMissing: true
+    });
+    const amount = new _decimal.default(summary?.total_amount || 0).toDecimalPlaces(2);
+    const customerId = Number(tempOrder?.customer_id || 0);
+    if (amount.gt(0) && customerId > 0 && customerId !== 1) {
+      await this.store.order.loadDiscountConfig({
+        customerId,
+        action: tempOrder?.order_id ? 'edit' : 'create',
+        orderId: Number(tempOrder?.order_id) || undefined,
+        apply: false
+      });
+    }
+    const asset = this.store.order.getVirtualCurrencyList().find(item => Number(item?.product_id) === currencyProductId);
+    const currencyCode = String(tempOrder?.currency_code || '');
+    const currencySymbol = String(tempOrder?.currency_symbol || '');
+    const currencyFormat = String(tempOrder?.currency_format || 'symbol_first');
+    if (amount.lte(0)) {
+      return {
+        payments: [],
+        snapshot,
+        currencyProductId,
+        currencyCode,
+        currencySymbol,
+        currencyFormat
+      };
+    }
+    if (!asset) {
+      throw new Error('No matching virtual currency card is available.');
+    }
+    const balance = new _decimal.default(asset.balance || 0);
+    if (balance.lt(amount)) {
+      throw new Error('Insufficient virtual currency balance.');
+    }
+    const amountText = amount.toFixed(2);
+    const paymentNumber = `LOCAL_${(0, _utils.createUuidV4)()}`;
+    let payment;
+    if (this.store.order.isOnlineStorePlatform()) {
+      payment = {
+        payment_number: paymentNumber,
+        amount: amount.toNumber(),
+        metadata: {
+          unique_payment_number: (0, _utils.createUuidV4)()
+        },
+        tag: asset.tag,
+        voucher_id: asset.id,
+        wallet_pass_usage_unit: {
+          price: 1,
+          points: 1
+        },
+        wallet_pass_use_value: amountText
+      };
+    } else {
+      const paymentMethods = await this.getPaymentMethodsAsync();
+      const paymentMethod = paymentMethods.find(method => String(method.code || '').toUpperCase() === 'PRODUCTVOUCHER');
+      if (!paymentMethod) {
+        throw new Error('PRODUCTVOUCHER payment method is unavailable.');
+      }
+      payment = {
+        payment_number: paymentNumber,
+        amount: amountText,
+        origin_amount: amountText,
+        code: paymentMethod.code,
+        custom_payment_id: paymentMethod.id,
+        custom_payment_type: paymentMethod.custom_payment_type ?? paymentMethod.type,
+        name: paymentMethod.name,
+        type: 'normal',
+        voucher_id: asset.id,
+        order_payment_type: 'normal',
+        wallet_pass_usage_unit: {
+          price: 1,
+          points: 1
+        },
+        wallet_pass_use_value: amountText,
+        metadata: {}
+      };
+    }
+    return {
+      payments: [payment],
+      snapshot,
+      currencyProductId,
+      currencyCode,
+      currencySymbol,
+      currencyFormat
+    };
+  }
 
   /**
    * 提交当前 Sales 订单。
@@ -2146,6 +2328,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     if (!this.store.order) {
       throw new Error('BaseSales 解决方案需要 order 模块支持');
     }
+    const virtualSettlement = await this.buildVirtualSettlementSubmitData();
     // this.store.order.persistTempOrder();
     const inferredPaymentStatus = this.getSubmitPaymentStatus(params?.paymentStatus);
     const smallTicketDataFlag = params?.smallTicketDataFlag ?? this.getDefaultCheckoutSmallTicketDataFlag();
@@ -2157,7 +2340,9 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       channel: this.getSubmitOrderSalesChannel(),
       type: this.otherParams?.type,
       request_unique_idempotency_token: this.store.order.generateIdempotencyToken(),
-      ...(params?.payments !== undefined ? {
+      ...(virtualSettlement ? {
+        payments: virtualSettlement.payments
+      } : params?.payments !== undefined ? {
         payments: params.payments
       } : {}),
       ...(inferredPaymentStatus !== undefined ? {
@@ -2166,10 +2351,32 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       ...(smallTicketDataFlag !== undefined ? {
         smallTicketDataFlag
       } : {}),
-      ...(params?.confirmPendingVoucherPayments !== undefined ? {
+      ...(virtualSettlement ? {
+        confirmPendingVoucherPayments: false
+      } : params?.confirmPendingVoucherPayments !== undefined ? {
         confirmPendingVoucherPayments: params.confirmPendingVoucherPayments
       } : {}),
-      ...(enhancePayload !== undefined ? {
+      ...(virtualSettlement ? {
+        enhancePayload: (payload, ctx) => {
+          const callerPayload = enhancePayload ? enhancePayload(payload, ctx) : payload;
+          const currencySettlementConfig = callerPayload.metadata?.currency_settlement_config || {};
+          return {
+            ...callerPayload,
+            metadata: {
+              ...(callerPayload.metadata || {}),
+              currency_settlement_config: {
+                ...currencySettlementConfig,
+                settlement_type: 'virtual_currency',
+                settlement_ids: [virtualSettlement.currencyProductId],
+                currency_display_snapshot: (0, _lodashEs.cloneDeep)(currencySettlementConfig.currency_display_snapshot ?? (0, _virtualSettlement.buildCurrencyDisplaySnapshot)(virtualSettlement.snapshot))
+              }
+            },
+            currency_code: virtualSettlement.currencyCode,
+            currency_symbol: virtualSettlement.currencySymbol,
+            currency_format: virtualSettlement.currencyFormat
+          };
+        }
+      } : enhancePayload !== undefined ? {
         enhancePayload
       } : {})
     };
@@ -2581,7 +2788,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     if (this.store.payment) {
       const committed = this.getCommittedWalletAssets();
       const state = this.store.payment.wallet.setCommittedWalletAssets(committed.ids, committed.assets);
-      void this.publishWalletAssetsState(state);
+      void this.publishWalletAssetsState(state, 'local');
     }
     return payments;
   }
@@ -2727,9 +2934,10 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       })
     };
   }
-  async publishWalletAssetsState(state) {
+  async publishWalletAssetsState(state, changeSource = 'derived') {
     await this.effectsEmit(_types.BaseSalesHookNames.onWalletAssetsStateChanged, {
-      state
+      state,
+      changeSource
     });
     return state;
   }
@@ -2862,7 +3070,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       source: params.source
     });
     await this.syncSelectedWalletAssets(state);
-    return this.publishWalletAssetsState(state);
+    return this.publishWalletAssetsState(state, 'local');
   }
 
   /** 更新已选钱包资产的手动使用金额，并同步 pending payment。 */
@@ -2870,7 +3078,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     if (!this.store.payment) throw new Error('payment 模块未初始化');
     const state = this.store.payment.wallet.updateWalletAssetAmount(params.assetId, params.amount);
     await this.syncSelectedWalletAssets(state);
-    return this.publishWalletAssetsState(state);
+    return this.publishWalletAssetsState(state, 'local');
   }
 
   /** 扫码精确查券；仅可用资产会被自动选中。 */
@@ -2885,7 +3093,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     const result = await wallet.scanWalletAssetAsync(code);
     if (result.type === 'normalCode') {
       await this.syncSelectedWalletAssets(result.state);
-      await this.publishWalletAssetsState(result.state);
+      await this.publishWalletAssetsState(result.state, 'local');
     }
     return result;
   }
@@ -2895,7 +3103,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     if (!this.store.payment) throw new Error('payment 模块未初始化');
     const state = this.store.payment.wallet.clearWalletAssetSelection();
     await this.syncSelectedWalletAssets(state);
-    return this.publishWalletAssetsState(state);
+    return this.publishWalletAssetsState(state, 'local');
   }
 
   /**
@@ -3025,7 +3233,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       try {
         const committed = this.getCommittedWalletAssets();
         const walletState = this.store.payment.wallet.setCommittedWalletAssets(committed.ids, committed.assets);
-        await this.publishWalletAssetsState(walletState);
+        await this.publishWalletAssetsState(walletState, 'local');
       } catch (error) {
         this.logWarning('confirmWalletPayment: Wallet committed 状态同步失败', {
           error: error instanceof Error ? error.message : String(error)
@@ -3109,7 +3317,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       if (this.store.payment) {
         const committed = this.getCommittedWalletAssets();
         const walletState = this.store.payment.wallet.setCommittedWalletAssets(committed.ids, committed.assets);
-        await this.publishWalletAssetsState(walletState);
+        await this.publishWalletAssetsState(walletState, 'local');
       }
       return {
         payment: payment || {},
@@ -3215,7 +3423,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       if (this.store.payment) {
         const committed = this.getCommittedWalletAssets();
         const walletState = this.store.payment.wallet.setCommittedWalletAssets(committed.ids, committed.assets);
-        await this.publishWalletAssetsState(walletState);
+        await this.publishWalletAssetsState(walletState, 'local');
       }
       return {
         payment: payment || {},

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

@@ -46,6 +46,7 @@ export interface BaseProductDetailPayload {
     original_price?: number | string;
     tax_fee?: number | string;
     is_charge_tax?: number;
+    metadata?: Record<string, any>;
     note?: string;
     [key: string]: any;
 }

package/lib/solution/BaseSales/utils/transformBaseProductToOrderProduct.js

@@ -37,6 +37,34 @@ function isBlankValue(value) {
 function firstNonBlank(...values) {
   return values.find(value => !isBlankValue(value));
 }
+
+/**
+ * 取第一份接口权威 Data Variant 命中结果并复制数组。
+ * 空数组表示规则已计算但无命中，必须与字段缺失区分。
+ */
+function cloneFirstDataVariantIds(...values) {
+  const ids = values.find(value => Array.isArray(value));
+  return Array.isArray(ids) ? [...ids] : undefined;
+}
+
+/**
+ * 在接口权威命中结果后追加本地应用及最终选中的 Data Variant ID。
+ * 以字符串身份去重，同时将新增 ID 归一为正整数。
+ */
+function appendDataVariantIds(base, ...values) {
+  const result = Array.isArray(base) ? [...base] : [];
+  const seen = new Set(result.map(id => String(id)));
+  for (const value of values) {
+    const candidates = Array.isArray(value) ? value : [value];
+    for (const candidate of candidates) {
+      const id = Number(candidate);
+      if (!Number.isFinite(id) || id <= 0 || seen.has(String(id))) continue;
+      result.push(id);
+      seen.add(String(id));
+    }
+  }
+  return Array.isArray(base) || result.length ? result : undefined;
+}
 function normalizeOptionItems(optionItems) {
   if (!Array.isArray(optionItems)) return [];
   return optionItems.map(optionItem => {
@@ -111,6 +139,10 @@ function transformBaseProductToOrderProduct(params) {
     ...(sourceProduct || {}),
     ...(callbackOrigin || {})
   };
+  const authoritativeDataVariantIds = cloneFirstDataVariantIds(payload.metadata?.data_variant_ids, sourceProduct?.metadata?.data_variant_ids, callbackOrigin?.metadata?.data_variant_ids, origin?.metadata?.data_variant_ids);
+  const selectedSettlementSnapshot = firstNonBlank(payload.selected_settlement_snapshot, payload.metadata?.selected_settlement_snapshot, payload._extend?.metadata?.selected_settlement_snapshot, sourceProduct?.metadata?.selected_settlement_snapshot, sourceProduct?._extend?.metadata?.selected_settlement_snapshot, callbackOrigin?.metadata?.selected_settlement_snapshot, callbackOrigin?._extend?.metadata?.selected_settlement_snapshot);
+  const locallyAppliedVariantIds = authoritativeDataVariantIds === undefined ? cloneFirstDataVariantIds(payload._dataVariant?.appliedVariantIds, sourceProduct?._dataVariant?.appliedVariantIds, callbackOrigin?._dataVariant?.appliedVariantIds, origin?._dataVariant?.appliedVariantIds) : undefined;
+  const dataVariantIds = appendDataVariantIds(authoritativeDataVariantIds, locallyAppliedVariantIds, selectedSettlementSnapshot?.data_variant_id);
   const matchedVariant = findVariantById(callbackOrigin, productVariantId) ?? findVariantById(sourceProduct, productVariantId) ?? findVariantById(origin, productVariantId);
   const productionCode = normalizeProductionCode(Object.prototype.hasOwnProperty.call(payload, 'production_code') ? payload.production_code : productVariantId > 0 ? matchedVariant?.production_code : origin?.production_code ?? sourceProduct?.production_code);
   const hasPriceOverride = payload.price_override !== undefined && payload.price_override !== null && payload.price_override !== '';
@@ -179,6 +211,12 @@ function transformBaseProductToOrderProduct(params) {
     main_product_original_price: mainProductOriginalPrice,
     price_schema_version: 2,
     holder_config: sourceProduct?.holder_config,
+    ...(dataVariantIds !== undefined ? {
+      data_variant_ids: dataVariantIds
+    } : {}),
+    ...(selectedSettlementSnapshot ? {
+      selected_settlement_snapshot: selectedSettlementSnapshot
+    } : {}),
     ...(hasPriceOverride ? {
       price_override: String(payload.price_override),
       is_manual_discount: 1