@pisell/pisellos 2.3.100 → 2.3.102

package/lib/modules/Order/utils/virtualSettlement.js

@@ -0,0 +1,262 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.VirtualCurrencyBalanceError = exports.VirtualCurrencyAssetNotFoundError = exports.OrderSettlementConflictError = void 0;
+exports.applyTempOrderSettlementState = applyTempOrderSettlementState;
+exports.buildCurrencyDisplaySnapshot = buildCurrencyDisplaySnapshot;
+exports.getSelectedSettlementSnapshot = getSelectedSettlementSnapshot;
+exports.getSettlementKey = getSettlementKey;
+exports.getTempOrderSettlementKey = getTempOrderSettlementKey;
+exports.getTempOrderSettlementSnapshot = getTempOrderSettlementSnapshot;
+exports.isVirtualSettlementDisplayOrder = isVirtualSettlementDisplayOrder;
+exports.isVirtualSettlementOrder = isVirtualSettlementOrder;
+exports.isVirtualSettlementProduct = isVirtualSettlementProduct;
+exports.normalizeVirtualSettlementOrderProduct = normalizeVirtualSettlementOrderProduct;
+exports.normalizeVirtualSettlementProducts = normalizeVirtualSettlementProducts;
+exports.releaseTempOrderSettlementState = releaseTempOrderSettlementState;
+exports.resolveSettlementDisplayValue = resolveSettlementDisplayValue;
+var _decimal = _interopRequireDefault(require("decimal.js"));
+var _lodashEs = require("lodash-es");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function buildCurrencyDisplaySnapshot(snapshot) {
+  return (0, _lodashEs.cloneDeep)({
+    amount_format: String(snapshot.amount_format || '').trim(),
+    symbol: snapshot.symbol ?? {},
+    unit_label: snapshot.unit_label ?? {}
+  });
+}
+function resolveSettlementDisplayValue(value) {
+  if (value === undefined || value === null) return '';
+  if (typeof value === 'string' || typeof value === 'number') {
+    return String(value);
+  }
+  const localized = value;
+  return String(localized.auto ?? localized.default ?? localized.original ?? localized.en ?? localized['zh-CN'] ?? localized['zh-HK'] ?? '');
+}
+class OrderSettlementConflictError extends Error {
+  code = 'ORDER_SETTLEMENT_CONFLICT';
+  constructor(currentSettlementKey, incomingSettlementKey) {
+    super('Different currencies and WalletPass units cannot be mixed in one cart.');
+    this.currentSettlementKey = currentSettlementKey;
+    this.incomingSettlementKey = incomingSettlementKey;
+    this.name = 'OrderSettlementConflictError';
+  }
+}
+exports.OrderSettlementConflictError = OrderSettlementConflictError;
+class VirtualCurrencyAssetNotFoundError extends Error {
+  code = 'VIRTUAL_CURRENCY_ASSET_NOT_FOUND';
+  constructor(currencyProductId) {
+    super('No matching virtual currency card is available.');
+    this.currencyProductId = currencyProductId;
+    this.name = 'VirtualCurrencyAssetNotFoundError';
+  }
+}
+exports.VirtualCurrencyAssetNotFoundError = VirtualCurrencyAssetNotFoundError;
+class VirtualCurrencyBalanceError extends Error {
+  code = 'VIRTUAL_CURRENCY_BALANCE_INSUFFICIENT';
+  constructor(balance, requiredAmount) {
+    super('Insufficient virtual currency balance.');
+    this.balance = balance;
+    this.requiredAmount = requiredAmount;
+    this.name = 'VirtualCurrencyBalanceError';
+  }
+}
+exports.VirtualCurrencyBalanceError = VirtualCurrencyBalanceError;
+function getSelectedSettlementSnapshot(product) {
+  const snapshot = product?.metadata?.selected_settlement_snapshot;
+  if (!snapshot || typeof snapshot !== 'object') return null;
+  if (snapshot.settlement_type !== 'legal_currency' && snapshot.settlement_type !== 'virtual_currency') {
+    return null;
+  }
+  return snapshot;
+}
+function getTempOrderSettlementSnapshot(tempOrder) {
+  const snapshot = tempOrder?.metadata?.cart_settlement_snapshot;
+  if (snapshot && typeof snapshot === 'object' && (snapshot.settlement_type === 'legal_currency' || snapshot.settlement_type === 'virtual_currency')) {
+    return snapshot;
+  }
+  return getSelectedSettlementSnapshot(tempOrder?.products?.[0]);
+}
+function isVirtualSettlementProduct(product) {
+  return getSelectedSettlementSnapshot(product)?.settlement_type === 'virtual_currency';
+}
+function getSettlementKey(snapshot) {
+  if (!snapshot) return null;
+  if (snapshot.settlement_type === 'legal_currency') return 'legal_currency';
+  const currencyProductId = Number(snapshot.currency_product_id);
+  return Number.isFinite(currencyProductId) && currencyProductId > 0 ? `virtual_currency:${currencyProductId}` : null;
+}
+function getTempOrderSettlementKey(tempOrder) {
+  if (!tempOrder?.products?.length) return null;
+  const storedKey = tempOrder.metadata?.cart_settlement_key;
+  if (typeof storedKey === 'string' && storedKey) return storedKey;
+  return getSettlementKey(getTempOrderSettlementSnapshot(tempOrder)) || 'legal_currency';
+}
+function isVirtualSettlementOrder(tempOrder) {
+  return getTempOrderSettlementKey(tempOrder)?.startsWith('virtual_currency:') === true;
+}
+
+/**
+ * 详情展示识别同时支持已提交订单的 currency_settlement_config。
+ * cart_settlement_* 是交易过程内部状态，服务端详情不保证返回。
+ */
+function isVirtualSettlementDisplayOrder(tempOrder) {
+  return tempOrder?.metadata?.currency_settlement_config?.settlement_type === 'virtual_currency' || isVirtualSettlementOrder(tempOrder);
+}
+function getLegalCurrencySnapshot(tempOrder) {
+  const snapshot = tempOrder.metadata?.legal_currency_snapshot;
+  if (!snapshot || typeof snapshot !== 'object') return null;
+  return {
+    currency_code: String(snapshot.currency_code || ''),
+    currency_symbol: String(snapshot.currency_symbol || ''),
+    currency_format: String(snapshot.currency_format || 'symbol_first')
+  };
+}
+function captureLegalCurrencySnapshot(tempOrder) {
+  tempOrder.metadata = tempOrder.metadata || {};
+  if (getLegalCurrencySnapshot(tempOrder)) return;
+  tempOrder.metadata.legal_currency_snapshot = {
+    currency_code: String(tempOrder.currency_code || ''),
+    currency_symbol: String(tempOrder.currency_symbol || ''),
+    currency_format: String(tempOrder.currency_format || 'symbol_first')
+  };
+}
+
+/**
+ * 将购物车锁定的结算单位提升为订单级状态。
+ * 商品行快照同时负责价格归一化和生成订单级多语言展示快照；
+ * 交易中的即时展示仍统一读取 tempOrder.currency_*。
+ */
+function applyTempOrderSettlementState(tempOrder, snapshot) {
+  tempOrder.metadata = tempOrder.metadata || {};
+  const settlementKey = getSettlementKey(snapshot) || 'legal_currency';
+  if (snapshot.settlement_type === 'virtual_currency') {
+    captureLegalCurrencySnapshot(tempOrder);
+    const currencyProductId = Number(snapshot.currency_product_id);
+    const existingDisplaySnapshot = tempOrder.metadata.currency_settlement_config?.currency_display_snapshot;
+    tempOrder.metadata.currency_settlement_config = {
+      settlement_type: 'virtual_currency',
+      settlement_ids: Number.isFinite(currencyProductId) && currencyProductId > 0 ? [currencyProductId] : [],
+      currency_display_snapshot: existingDisplaySnapshot ? (0, _lodashEs.cloneDeep)(existingDisplaySnapshot) : buildCurrencyDisplaySnapshot(snapshot)
+    };
+  } else {
+    delete tempOrder.metadata.currency_settlement_config;
+  }
+  tempOrder.metadata.cart_settlement_key = settlementKey;
+  tempOrder.metadata.cart_settlement_snapshot = {
+    ...snapshot
+  };
+  tempOrder.currency_code = resolveSettlementDisplayValue(snapshot.unit_label) || tempOrder.currency_code;
+  tempOrder.currency_symbol = resolveSettlementDisplayValue(snapshot.symbol) || tempOrder.currency_symbol;
+  tempOrder.currency_format = String(snapshot.amount_format || tempOrder.currency_format || 'symbol_first');
+}
+
+/** 清空购物车结算锁，并恢复进入虚拟币结算前的店铺法币。 */
+function releaseTempOrderSettlementState(tempOrder) {
+  tempOrder.metadata = tempOrder.metadata || {};
+  const legalCurrency = getLegalCurrencySnapshot(tempOrder);
+  if (legalCurrency) {
+    tempOrder.currency_code = legalCurrency.currency_code;
+    tempOrder.currency_symbol = legalCurrency.currency_symbol;
+    tempOrder.currency_format = legalCurrency.currency_format;
+  }
+  delete tempOrder.metadata.cart_settlement_key;
+  delete tempOrder.metadata.cart_settlement_snapshot;
+  delete tempOrder.metadata.currency_settlement_config;
+}
+function toMoney(value) {
+  try {
+    return new _decimal.default(String(value ?? 0)).toDecimalPlaces(2).toFixed(2);
+  } catch {
+    return '0.00';
+  }
+}
+function zeroOptions(options) {
+  if (!Array.isArray(options)) return [];
+  return options.map(option => ({
+    ...option,
+    add_price: 0
+  }));
+}
+function zeroBundles(bundles) {
+  if (!Array.isArray(bundles)) return [];
+  return bundles.map(bundle => ({
+    ...bundle,
+    price: 0,
+    custom_price: 0,
+    bundle_selling_price: 0,
+    bundle_payment_price: 0,
+    surcharge_fee: 0,
+    tax_fee: 0,
+    original_tax_fee: 0,
+    is_charge_tax: 0,
+    discount_list: [],
+    relation_surcharge_ids: [],
+    option: zeroOptions(bundle?.option),
+    metadata: {
+      ...(bundle?.metadata || {}),
+      surcharge_fee: '0.00',
+      relation_surcharge_ids: [],
+      product_discount_difference: '',
+      tax_fee_rounding_remainder: '0.00',
+      surcharge_rounding_remainder: '0.00'
+    }
+  }));
+}
+
+/**
+ * 将已选择虚拟币的订单商品行固化为最终价语义。
+ * 函数幂等，可安全用于加车、合并、hydrate 和提交前兜底。
+ */
+function normalizeVirtualSettlementOrderProduct(product) {
+  const snapshot = getSelectedSettlementSnapshot(product);
+  if (snapshot?.settlement_type !== 'virtual_currency') return product;
+  const virtualPrice = toMoney(snapshot.price);
+  const metadata = {
+    ...(product.metadata || {}),
+    source_product_price: virtualPrice,
+    main_product_original_price: virtualPrice,
+    main_product_selling_price: virtualPrice,
+    main_product_attached_bundle_selling_price: virtualPrice,
+    main_product_attached_bundle_payment_price: virtualPrice,
+    main_product_attached_bundle_surcharge_fee: '0.00',
+    main_product_attached_bundle_tax_fee: '0.00',
+    surcharge_rounding_remainder: '0.00',
+    tax_fee_rounding_remainder: '0.00',
+    relation_surcharge_ids: [],
+    average_discount_amount_rate: '1',
+    product_discount_difference: '',
+    discountable_flag: 0,
+    price_schema_version: 2,
+    selected_settlement_snapshot: {
+      ...snapshot,
+      price: virtualPrice
+    }
+  };
+  return {
+    ...product,
+    selling_price: virtualPrice,
+    original_price: virtualPrice,
+    payment_price: virtualPrice,
+    discount_list: [],
+    is_charge_tax: 0,
+    tax_fee: '0.00',
+    original_tax_fee: 0,
+    tax_fee_rounding_remainder: 0,
+    original_tax_fee_rounding_remainder: 0,
+    surcharge_fee: '0.00',
+    surcharge_rounding_remainder: 0,
+    relation_surcharge_ids: [],
+    product_sku: {
+      ...(product.product_sku || {}),
+      option: zeroOptions(product.product_sku?.option)
+    },
+    product_bundle: zeroBundles(product.product_bundle),
+    metadata
+  };
+}
+function normalizeVirtualSettlementProducts(products) {
+  return (products || []).map(product => normalizeVirtualSettlementOrderProduct(product));
+}

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

@@ -232,6 +232,7 @@ export declare function buildSubmitPayload(params: {
     type?: string;
     summary?: OrderSummary | null;
     request_unique_idempotency_token?: string;
+    includePaymentStatus?: boolean;
     enhance?: SubmitPayloadEnhancer;
 }): OrderSubmitPayload;
 export declare function mapPaymentItemToOrderPayment(paymentItem: OrderPaymentSource): OrderPaymentData;

package/lib/modules/Order/utils.js

@@ -864,7 +864,7 @@ function normalizeSubmitProductionCode(value) {
 }
 
 // 后端 checkout 协议字段 option_group_item_id；tempOrder 内部也保持同一字段名。
-function formatSubmitOptionItems(options) {
+function formatSubmitOptionItems(options, formatOptions = {}) {
   if (!Array.isArray(options)) return [];
   return options.map(d => {
     const option = {
@@ -877,7 +877,11 @@ function formatSubmitOptionItems(options) {
     delete option.production_code;
     if (productionCode !== undefined) option.production_code = productionCode;
     const addPrice = d?.add_price ?? d?.price;
-    if (addPrice !== undefined) option.add_price = String(addPrice);
+    if (formatOptions.virtualSettlementMode) {
+      option.add_price = 0;
+    } else if (addPrice !== undefined) {
+      option.add_price = String(addPrice);
+    }
     delete option.price;
     return option;
   });
@@ -894,7 +898,7 @@ function toMoneyString(value) {
 }
 
 // 出站补齐：只输出后端 checkout 协议字段，运行时/详情展示字段不进入 bundle payload。
-function formatSubmitBundleItems(bundle) {
+function formatSubmitBundleItems(bundle, formatOptions = {}) {
   if (!Array.isArray(bundle)) return [];
   return bundle.map(b => {
     const rawBundle = b && typeof b === 'object' ? b : {};
@@ -906,10 +910,10 @@ function formatSubmitBundleItems(bundle) {
 
     // bundle_selling_price 出站存「正净额」：markdown 为 |price| − Σoptions（如 3.70），
     // markup/原价维持原值；与后端口径一致（price 仍为毛价）。
-    const sellingPrice = getBundleSellingMagnitude(rawBundle).toFixed(2);
+    const sellingPrice = formatOptions.virtualSettlementMode ? '0.00' : getBundleSellingMagnitude(rawBundle).toFixed(2);
     // payment 价由整单折扣均摊层产出；缺省（无折扣）时与 selling 净额同义。
-    const paymentPrice = rawBundle.bundle_payment_price !== undefined && rawBundle.bundle_payment_price !== null && rawBundle.bundle_payment_price !== '' ? toMoneyString(rawBundle.bundle_payment_price) : sellingPrice;
-    const priceValue = rawBundle.price ?? rawBundle.custom_price ?? rawBundle.bundle_selling_price;
+    const paymentPrice = formatOptions.virtualSettlementMode ? '0.00' : rawBundle.bundle_payment_price !== undefined && rawBundle.bundle_payment_price !== null && rawBundle.bundle_payment_price !== '' ? toMoneyString(rawBundle.bundle_payment_price) : sellingPrice;
+    const priceValue = formatOptions.virtualSettlementMode ? 0 : rawBundle.price ?? rawBundle.custom_price ?? rawBundle.bundle_selling_price;
     const relationSurchargeIds = Array.isArray(rawBundle.relation_surcharge_ids) ? rawBundle.relation_surcharge_ids : Array.isArray(existedMetadata.relation_surcharge_ids) ? existedMetadata.relation_surcharge_ids : [];
     const surchargeFee = toMoneyString(rawBundle.surcharge_fee ?? existedMetadata.surcharge_fee);
     const productDiscountDifference = toBundleNumber(existedMetadata.product_discount_difference, 0);
@@ -918,7 +922,7 @@ function formatSubmitBundleItems(bundle) {
     const hasSubmitBundleDiscounts = Array.isArray(rawBundle.discount_list) && rawBundle.discount_list.length > 0;
     const productionCode = normalizeSubmitProductionCode(rawBundle.production_code);
     return {
-      is_charge_tax: rawBundle.is_charge_tax ?? 0,
+      is_charge_tax: formatOptions.virtualSettlementMode ? 0 : rawBundle.is_charge_tax ?? 0,
       bundle_variant_id: rawBundle.bundle_variant_id ?? 0,
       ...(productionCode !== undefined ? {
         production_code: productionCode
@@ -932,7 +936,7 @@ function formatSubmitBundleItems(bundle) {
       price_type_ext: rawBundle.price_type_ext ?? rawBundle.custom_price_type_ext ?? '',
       bundle_selling_price: sellingPrice,
       bundle_payment_price: paymentPrice,
-      option: formatSubmitOptionItems(rawBundle.option),
+      option: formatSubmitOptionItems(rawBundle.option, formatOptions),
       bundle_group_id: rawBundle?.bundle_group_id ?? rawBundle?.group_id,
       bundle_id: rawBundle?.bundle_id ?? rawBundle?.id,
       bundle_product_id: rawBundle?.bundle_product_id ?? rawBundle?._bundle_product_id,
@@ -942,9 +946,9 @@ function formatSubmitBundleItems(bundle) {
         ...(hasSubmitBundleDiscounts && bundleMapId !== undefined ? {
           custom_product_bundle_map_id: bundleMapId
         } : {}),
-        surcharge_fee: surchargeFee,
-        relation_surcharge_ids: relationSurchargeIds,
-        product_discount_difference: productDiscountDifference
+        surcharge_fee: formatOptions.virtualSettlementMode ? '0.00' : surchargeFee,
+        relation_surcharge_ids: formatOptions.virtualSettlementMode ? [] : relationSurchargeIds,
+        product_discount_difference: formatOptions.virtualSettlementMode ? '' : productDiscountDifference
       }
     };
   });
@@ -964,9 +968,9 @@ function formatSubmitBundleItems(bundle) {
  * - `metadata.main_product_selling_price`：含 option、含主商品折扣。
  * - `metadata.price_schema_version`：schema 版本号（当前 = 2），用于跨端协商价格口径。
  *
- * 本函数不再改造价格字段形状，仅做字段/metadata 裁剪。
+ * 法币仅做字段/metadata 裁剪；虚拟币在出站前再次执行零加价与固定单价断言。
  */
-function normalizeSubmitProduct(product) {
+function normalizeSubmitProduct(product, formatOptions = {}) {
   const {
     unique_identification_number: _runtimeUid,
     ...submitProduct
@@ -994,7 +998,7 @@ function normalizeSubmitProduct(product) {
   if (rawMetadata.unique_identification_number) {
     cleanMetadata.unique_identification_number = rawMetadata.unique_identification_number;
   }
-  const priceMetaKeys = ['main_product_original_price', 'main_product_selling_price', 'main_product_attached_bundle_selling_price', 'main_product_attached_bundle_payment_price', 'average_discount_amount_rate', 'source_product_price', 'main_product_attached_bundle_surcharge_fee', 'main_product_attached_bundle_tax_fee', 'surcharge_rounding_remainder', 'tax_fee_rounding_remainder', 'relation_surcharge_ids', 'discountable_flag', 'parent_unique_identification_number', 'product_add_schedule_time'];
+  const priceMetaKeys = ['main_product_original_price', 'main_product_selling_price', 'main_product_attached_bundle_selling_price', 'main_product_attached_bundle_payment_price', 'average_discount_amount_rate', 'source_product_price', 'main_product_attached_bundle_surcharge_fee', 'main_product_attached_bundle_tax_fee', 'surcharge_rounding_remainder', 'tax_fee_rounding_remainder', 'relation_surcharge_ids', 'discountable_flag', 'price_schema_version', 'parent_unique_identification_number', 'product_add_schedule_time', 'data_variant_ids'];
   for (const key of priceMetaKeys) {
     if (rawMetadata[key] !== undefined) {
       cleanMetadata[key] = rawMetadata[key];
@@ -1010,12 +1014,36 @@ function normalizeSubmitProduct(product) {
   if (rawMetadata.holder_config !== undefined) {
     cleanMetadata.holder_config = rawMetadata.holder_config;
   }
+  const virtualPrice = toMoneyString(rawMetadata.selected_settlement_snapshot?.price ?? submitProduct.selling_price);
+  if (formatOptions.virtualSettlementMode) {
+    Object.assign(cleanMetadata, {
+      source_product_price: virtualPrice,
+      main_product_original_price: virtualPrice,
+      main_product_selling_price: virtualPrice,
+      main_product_attached_bundle_selling_price: virtualPrice,
+      main_product_attached_bundle_payment_price: virtualPrice,
+      main_product_attached_bundle_surcharge_fee: '0.00',
+      main_product_attached_bundle_tax_fee: '0.00',
+      surcharge_rounding_remainder: '0.00',
+      tax_fee_rounding_remainder: '0.00',
+      relation_surcharge_ids: [],
+      average_discount_amount_rate: '1',
+      product_discount_difference: '',
+      discountable_flag: 0,
+      price_schema_version: 2
+    });
+  }
   const productSku = {
     ...(submitProduct.product_sku && typeof submitProduct.product_sku === 'object' ? submitProduct.product_sku : {}),
-    option: formatSubmitOptionItems(submitProduct.product_sku?.option)
+    option: formatSubmitOptionItems(submitProduct.product_sku?.option, formatOptions)
   };
   return {
     ...productRest,
+    ...(formatOptions.virtualSettlementMode ? {
+      selling_price: virtualPrice,
+      original_price: virtualPrice,
+      is_charge_tax: 0
+    } : {}),
     ...(productionCode !== undefined ? {
       production_code: productionCode
     } : {}),
@@ -1027,12 +1055,12 @@ function normalizeSubmitProduct(product) {
     } : {}),
     product_quantity: toBundleNumber(num ?? submitProduct.product_quantity, 1),
     product_sku: productSku,
-    discount_list: collectSubmitProductDiscountList(submitProduct),
-    product_bundle: formatSubmitBundleItems(submitProduct.product_bundle),
+    discount_list: formatOptions.virtualSettlementMode ? [] : collectSubmitProductDiscountList(submitProduct),
+    product_bundle: formatSubmitBundleItems(submitProduct.product_bundle, formatOptions),
     metadata: cleanMetadata,
     // 出站兼容：后端消费 payment_price 字段（行 composite 已减整单折扣均摊）。
     // 由整单折扣均摊层产出；缺省（无折扣）时与 selling_price 同义。
-    payment_price: submitProduct.payment_price ?? submitProduct.selling_price
+    payment_price: formatOptions.virtualSettlementMode ? virtualPrice : submitProduct.payment_price ?? submitProduct.selling_price
   };
 }
 const SUBMIT_BOOKING_METADATA_WHITELIST = ['unique_identification_number', 'collect_pax', 'capacity', 'holder_id', 'resource_select_type', 'holder'];
@@ -1205,6 +1233,7 @@ function buildSubmitPayload(params) {
   } = params;
   const scheduleDate = tempOrder.schedule_date || tempOrder.created_at || formatDateTime(now);
   const bookingUuid = (0, _orderCollectionIdentity.createUuidV4)();
+  const virtualSettlementMode = tempOrder.metadata?.currency_settlement_config?.settlement_type === 'virtual_currency';
   const {
     _extend: _extend,
     relation_id: _relationId,
@@ -1224,6 +1253,7 @@ function buildSubmitPayload(params) {
     total_refund_amount: _totalRefundAmount,
     create_date: _createDate,
     holder_id: _holderId,
+    payment_status: _paymentStatus,
     notes: _notes,
     ...tempOrderRest
   } = tempOrder;
@@ -1253,7 +1283,9 @@ function buildSubmitPayload(params) {
     sales_channel: tempOrder.sales_channel || 'my_pisel',
     order_sales_channel: channel ?? tempOrder.order_sales_channel ?? 'online_store',
     status: tempOrder.status || 'normal',
-    payment_status: tempOrder.payment_status || 'payment_processing',
+    ...(params.includePaymentStatus !== false ? {
+      payment_status: tempOrder.payment_status || 'payment_processing'
+    } : {}),
     // shipping_status: tempOrder.shipping_status || 'unfulfilled',
     is_price_include_tax: tempOrder.is_price_include_tax ?? 1,
     currency_format: tempOrder.currency_format || 'symbol_first',
@@ -1276,6 +1308,9 @@ function buildSubmitPayload(params) {
       const {
         collect_pax: _collectPax,
         table_occupancy_duration: _tableOccupancyDuration,
+        cart_settlement_key: _cartSettlementKey,
+        cart_settlement_snapshot: _cartSettlementSnapshot,
+        legal_currency_snapshot: _legalCurrencySnapshot,
         ...rest
       } = tempOrder.metadata || {};
       return {
@@ -1287,7 +1322,9 @@ function buildSubmitPayload(params) {
         allowUnresolvedOrderTarget: true
       })
     } : {}),
-    products: (tempOrder.products || []).map(product => normalizeSubmitProduct(product))
+    products: (tempOrder.products || []).map(product => normalizeSubmitProduct(product, {
+      virtualSettlementMode
+    }))
   };
   if (!enhance) return payload;
   const enhancedPayload = enhance(payload, {

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/Rules/index.d.ts

@@ -14,6 +14,11 @@ export declare class RulesModule extends BaseModule implements Module, RulesModu
     setRulesList(rulesList: Rules[]): Promise<void>;
     getRulesList(): Rules[];
     getWalletPassEvaluator(): import("../..").WalletPassEvaluator | undefined;
+    private normalizeHolderRecordIds;
+    /**
+     * 特定 form Holder 卡只授权给绑定同一 Holder Record 的商品行。
+     * required/isNeedHolder 仅控制是否强制选择 Holder，不参与优惠资格。
+     */
     private checkHolderMatch;
     isDiscountListAvailable({ oldDiscountList, newDiscountList, productList, orderTotalAmount, holders, isFormSubject, }: {
         oldDiscountList: Discount[];

package/lib/modules/Rules/index.js

@@ -38,21 +38,30 @@ class RulesModule extends _BaseModule.BaseModule {
   getWalletPassEvaluator() {
     return this.window.getWalletPassEvaluator?.();
   }
+  normalizeHolderRecordIds(value) {
+    const records = Array.isArray(value) ? value : [value];
+    return Array.from(new Set(records.map(record => {
+      if (record && typeof record === 'object') {
+        return record.form_record_id;
+      }
+      return record;
+    }).filter(record => record !== undefined && record !== null && record !== '' && record !== 0 && record !== '0').map(String)));
+  }
 
-  // 商品不需要holder,则不需要判断，直接返回true，商品需要holder但是还没填写，那么暂时不使用带有holder的券，直到填写才去匹配
+  /**
+   * 特定 form Holder 卡只授权给绑定同一 Holder Record 的商品行。
+   * required/isNeedHolder 仅控制是否强制选择 Holder，不参与优惠资格。
+   */
   checkHolderMatch(discount, product, holders) {
     // 非表单类型 holder 视为匹配
     if (discount.holder?.holder_type !== 'form') return true;
-    // 主预约holder, 目前（20251124）默认只考虑单个holder的情况
-    // 旧版 holders[0].form_record_id 新版 holders[0]
-    const orderHolderId = Array.isArray(holders) && holders.length > 0 ? holders[0].form_record_id || holders[0] : undefined;
-    const productHolderId = Array.isArray(product.holder_id) ? product.holder_id[0] : product.holder_id;
-    // 商品不需要选holder，则不对比holder，直接返回true，
-    if (!product.isNeedHolder) return true;
-    // 商品需要holder，但父预约及商品都无holder，返回false
-    if (!orderHolderId && !productHolderId) return false;
-    // 最终直接匹配 holder 是否相同
-    return (productHolderId || orderHolderId) === discount.holder.holder_id;
+    const discountHolderIds = this.normalizeHolderRecordIds(discount.holder.holder_id);
+    if (!discountHolderIds.length) return false;
+    const productHolderIds = this.normalizeHolderRecordIds(product.holder_id);
+    const candidateHolderIds = productHolderIds.length ? productHolderIds : this.normalizeHolderRecordIds(holders);
+    if (!candidateHolderIds.length) return false;
+    const discountHolderIdSet = new Set(discountHolderIds);
+    return candidateHolderIds.some(holderId => discountHolderIdSet.has(holderId));
   }
 
   // 判断discountList 是否可以对当前productList生效

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));