@pisell/pisellos 2.2.302 → 2.2.303

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");
@@ -37,6 +38,8 @@ var _quotationPrice = require("./utils/quotationPrice");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const SERVER_ORDER_CHANGED_EVENT = 'order:onOrdersChanged';
 const OS_FULFILLMENT_REF_MODE_FIELD = '_os_fulfillment_ref_mode';
+const OS_INVOICE_LAYOUT_CONFIG_FIELD = '_os_invoice_layout_config';
+const OS_INVOICE_TEMPLATE_SETTINGS_FIELD = '_os_invoice_template_settings';
 const WALLET_PAYMENT_CODE_BY_TAG = {
   product_voucher: 'PRODUCTVOUCHER',
   gift_card: 'GIFTCARD',
@@ -256,6 +259,22 @@ function normalizeBaseSalesRecordCollections(sourceRecord, options) {
   }
   return normalizedRecord;
 }
+function isValidBaseSalesSmallTicketDataSnapshot(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return false;
+  const localeSnapshots = Object.values(value);
+  return localeSnapshots.length > 0 && localeSnapshots.some(localeSnapshot => localeSnapshot !== null && typeof localeSnapshot === 'object' && !Array.isArray(localeSnapshot));
+}
+function mergeBaseSalesSmallTicketDataSnapshot(currentValue, loadedValue) {
+  if (isValidBaseSalesSmallTicketDataSnapshot(loadedValue)) {
+    return (0, _lodashEs.cloneDeep)(loadedValue);
+  }
+  if (isValidBaseSalesSmallTicketDataSnapshot(currentValue)) {
+    return (0, _lodashEs.cloneDeep)(currentValue);
+  }
+  if (loadedValue !== undefined) return (0, _lodashEs.cloneDeep)(loadedValue);
+  if (currentValue !== undefined) return (0, _lodashEs.cloneDeep)(currentValue);
+  return undefined;
+}
 function getBaseSalesMetadataUid(item, metadataKey) {
   const uid = item?.metadata?.[metadataKey] ?? item?.[metadataKey];
   if (uid === undefined || uid === null || uid === '') return null;
@@ -283,7 +302,56 @@ function mergeBaseSalesUniqueArray(currentValue, loadedValue, metadataKey) {
   loadedValue.forEach(appendOrReplaceByUid);
   return result;
 }
+
+// checkout / realtime snapshots may reorder protocol arrays or append persistence fields.
+// Compare only the Sales Note protocol fields so a matching remote echo can acknowledge dirty state.
+function normalizeBaseSalesNotesForComparison(value, options) {
+  if (!Array.isArray(value)) return null;
+  const unresolvedOrderTargetUuid = String(options?.unresolvedOrderTargetUuid ?? '').trim();
+  return value.map(note => {
+    if (!note || typeof note !== 'object' || Array.isArray(note)) {
+      return (0, _lodashEs.cloneDeep)(note);
+    }
+    const noteRecord = note;
+    const relations = Array.isArray(noteRecord.note_relations) ? noteRecord.note_relations.map(relation => {
+      if (!relation || typeof relation !== 'object' || Array.isArray(relation)) {
+        return (0, _lodashEs.cloneDeep)(relation);
+      }
+      const shouldResolveOrderTarget = relation.is_primary === 0 && relation.relation_type === 'related_to' && relation.target_type === 'order' && String(relation.target_uuid ?? '').trim() === '' && unresolvedOrderTargetUuid.length > 0;
+      return {
+        uuid: relation.uuid,
+        relation_type: relation.relation_type,
+        target_type: relation.target_type,
+        target_uuid: shouldResolveOrderTarget ? unresolvedOrderTargetUuid : relation.target_uuid,
+        is_primary: relation.is_primary
+      };
+    }).sort((left, right) => String(left?.uuid ?? '').localeCompare(String(right?.uuid ?? ''))) : (0, _lodashEs.cloneDeep)(noteRecord.note_relations);
+    return {
+      uuid: noteRecord.uuid,
+      note_type: noteRecord.note_type,
+      content: {
+        text: (0, _lodashEs.cloneDeep)(noteRecord.content?.text)
+      },
+      importance: noteRecord.importance,
+      note_relations: relations
+    };
+  }).sort((left, right) => String(left?.uuid ?? '').localeCompare(String(right?.uuid ?? '')));
+}
+function areBaseSalesNotesEquivalent(currentValue, loadedValue, options) {
+  const currentNotes = normalizeBaseSalesNotesForComparison(currentValue, {
+    unresolvedOrderTargetUuid: options?.currentOrderTargetUuid
+  });
+  const loadedNotes = normalizeBaseSalesNotesForComparison(loadedValue);
+  return currentNotes !== null && loadedNotes !== null && (0, _lodashEs.isEqual)(currentNotes, loadedNotes);
+}
 function mergeSalesDetailRecordWithTempOrder(currentTempOrder, loadedRecord, strategy) {
+  const loadedHasSalesNotes = Object.prototype.hasOwnProperty.call(loadedRecord || {}, 'notes');
+  const hasDirtyLocalSalesNotes = currentTempOrder?._extend?.salesNotesState?.dirty === true;
+  const incomingSalesNotesMatchLocal = loadedHasSalesNotes && areBaseSalesNotesEquivalent(currentTempOrder?.notes, loadedRecord.notes, {
+    currentOrderTargetUuid: loadedRecord?.shop_order_number || currentTempOrder?.shop_order_number
+  });
+  const shouldAwaitAuthoritativeSalesNotes = strategy === 'authoritative-incoming' && hasDirtyLocalSalesNotes && (Number(loadedRecord?.need_sync) === 1 || !incomingSalesNotesMatchLocal);
+  const preserveDirtyLocalSalesNotes = hasDirtyLocalSalesNotes && (strategy === 'preserve-local' || shouldAwaitAuthoritativeSalesNotes);
   const normalizedLoadedRecord = normalizeBaseSalesRecordCollections(loadedRecord || {}, {
     ensureUid: false
   });
@@ -295,6 +363,17 @@ function mergeSalesDetailRecordWithTempOrder(currentTempOrder, loadedRecord, str
   });
   const uidRemaps = [];
   const mergedRecord = (0, _lodashEs.mergeWith)(normalizedCurrentTempOrder, normalizedLoadedRecord, (currentValue, loadedValue, key) => {
+    if (key === 'notes') {
+      if (preserveDirtyLocalSalesNotes && Array.isArray(currentValue)) {
+        return (0, _lodashEs.cloneDeep)(currentValue);
+      }
+      if (Array.isArray(loadedValue)) return (0, _lodashEs.cloneDeep)(loadedValue);
+    }
+    // small_ticket_data 是由 Server 一次性生成的完整展示快照，不能递归进入
+    // locale 内部继续套用订单集合或普通数组的合并规则。
+    if (key === 'small_ticket_data') {
+      return mergeBaseSalesSmallTicketDataSnapshot(currentValue, loadedValue);
+    }
     const collectionKind = getBaseSalesOrderCollectionKind(key);
     if (collectionKind && Array.isArray(loadedValue)) {
       return mergeBaseSalesOrderCollection(collectionKind, Array.isArray(currentValue) ? currentValue : [], loadedValue, strategy, uidRemaps);
@@ -318,7 +397,24 @@ function mergeSalesDetailRecordWithTempOrder(currentTempOrder, loadedRecord, str
     return undefined;
   });
   delete mergedRecord.request_unique_idempotency_token;
-  return normalizeBaseSalesRecordCollections((0, _orderCollectionIdentity.applyOrderCollectionUidRemaps)(mergedRecord, uidRemaps));
+  const normalizedMergedRecord = normalizeBaseSalesRecordCollections((0, _orderCollectionIdentity.applyOrderCollectionUidRemaps)(mergedRecord, uidRemaps));
+  normalizedMergedRecord._extend = {
+    ...(normalizedMergedRecord._extend || {}),
+    salesNotesState: preserveDirtyLocalSalesNotes ? {
+      loaded: true,
+      dirty: true
+    } : loadedHasSalesNotes ? {
+      loaded: true,
+      dirty: normalizedLoadedRecord._extend?.salesNotesState?.dirty === true
+    } : {
+      loaded: false,
+      dirty: false
+    }
+  };
+  if (!loadedHasSalesNotes && !preserveDirtyLocalSalesNotes) {
+    delete normalizedMergedRecord.notes;
+  }
+  return normalizedMergedRecord;
 }
 function filterPendingPaymentsFromLoadedSalesDetail(sourceRecord) {
   if (!sourceRecord || typeof sourceRecord !== 'object') return sourceRecord;
@@ -1042,6 +1138,11 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
   getSubmitOrderSalesChannel() {
     return this.otherParams?.channel;
   }
+
+  /** Subclasses with target-scoped OpenData override this guard before reusing the cache. */
+  isInvoiceOpenDataCacheCurrent() {
+    return true;
+  }
   getFulfillmentRefModeConfigs() {
     const candidates = [this.otherParams?.openData, this.otherParams?.dineInConfig, this.store?.openData?.getOpenData?.()];
     return candidates.filter(candidate => candidate && typeof candidate === 'object' && !Array.isArray(candidate));
@@ -1055,14 +1156,52 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     }
     return undefined;
   }
-  buildSubmitPayloadEnhancerWithFulfillmentRefMode(enhancePayload) {
+  getCachedInvoiceLayoutConfig() {
+    const openDataModule = this.store?.openData;
+    if (typeof openDataModule?.getInvoiceLayoutConfig !== 'function') return undefined;
+    if (!this.isInvoiceOpenDataCacheCurrent()) return undefined;
+    try {
+      return openDataModule.getInvoiceLayoutConfig();
+    } catch (error) {
+      this.logWarning('读取 Invoice OpenData 布局失败，提交时不注入布局配置', {
+        error: error instanceof Error ? error.message : String(error)
+      });
+      return undefined;
+    }
+  }
+  getCachedInvoiceTemplateSettings() {
+    const openDataModule = this.store?.openData;
+    if (typeof openDataModule?.getInvoiceTemplateSettings !== 'function') return undefined;
+    if (!this.isInvoiceOpenDataCacheCurrent()) return undefined;
+    try {
+      return openDataModule.getInvoiceTemplateSettings();
+    } catch (error) {
+      this.logWarning('读取 Invoice OpenData 模板配置失败，提交时不注入模板配置', {
+        error: error instanceof Error ? error.message : String(error)
+      });
+      return undefined;
+    }
+  }
+  buildSubmitPayloadEnhancerWithOpenDataConfig(enhancePayload) {
     const fulfillmentRefMode = this.getFulfillmentRefMode();
-    if (!fulfillmentRefMode) return enhancePayload;
+    const invoiceLayoutConfig = this.getCachedInvoiceLayoutConfig();
+    const invoiceTemplateSettings = this.getCachedInvoiceTemplateSettings();
+    if (!fulfillmentRefMode && !invoiceLayoutConfig && !invoiceTemplateSettings) {
+      return enhancePayload;
+    }
     return (payload, ctx) => {
       const enhancedPayload = enhancePayload ? enhancePayload(payload, ctx) : payload;
       return {
         ...enhancedPayload,
-        [OS_FULFILLMENT_REF_MODE_FIELD]: fulfillmentRefMode
+        ...(fulfillmentRefMode ? {
+          [OS_FULFILLMENT_REF_MODE_FIELD]: fulfillmentRefMode
+        } : {}),
+        ...(invoiceLayoutConfig ? {
+          [OS_INVOICE_LAYOUT_CONFIG_FIELD]: (0, _lodashEs.cloneDeep)(invoiceLayoutConfig)
+        } : {}),
+        ...(invoiceTemplateSettings ? {
+          [OS_INVOICE_TEMPLATE_SETTINGS_FIELD]: (0, _lodashEs.cloneDeep)(invoiceTemplateSettings)
+        } : {})
       };
     };
   }
@@ -1181,11 +1320,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);
@@ -1201,14 +1353,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;
@@ -1426,6 +1590,30 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     if (!this.store.order) return '';
     return this.store.order.getTempOrderNote();
   }
+  getSalesNotes() {
+    if (!this.store.order) return [];
+    return this.store.order.getSalesNotes();
+  }
+  createSalesNotesMutationSnapshot() {
+    if (!this.store.order) throw new Error('order 模块未初始化');
+    return this.store.order.createSalesNotesMutationSnapshot();
+  }
+  restoreSalesNotesMutationSnapshot(snapshot) {
+    if (!this.store.order) throw new Error('order 模块未初始化');
+    this.store.order.restoreSalesNotesMutationSnapshot(snapshot);
+  }
+  async setSalesNote(input) {
+    if (!this.store.order) throw new Error('order 模块未初始化');
+    return this.store.order.setSalesNote(input);
+  }
+  async removeSalesNote(uuid) {
+    if (!this.store.order) throw new Error('order 模块未初始化');
+    await this.store.order.removeSalesNote(uuid);
+  }
+  async clearSalesNotes() {
+    if (!this.store.order) throw new Error('order 模块未初始化');
+    await this.store.order.clearSalesNotes();
+  }
   updateTempOrderNote(note, sync = false) {
     try {
       if (!this.store.order) throw new Error('order 模块未初始化');
@@ -1453,6 +1641,14 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     if (!this.store.order) throw new Error('order 模块未初始化');
     return this.store.order.updateTempOrderDepositAmount(amount);
   }
+  setPickupReferenceMode(mode) {
+    if (!this.store.order) throw new Error('order 模块未初始化');
+    return this.store.order.updateTempOrderPickupReferenceMode(mode);
+  }
+  setServiceType(serviceType) {
+    if (!this.store.order) throw new Error('order 模块未初始化');
+    return this.store.order.updateTempOrderServiceType(serviceType);
+  }
   updateTempOrderContactsInfo(contactsInfo) {
     if (!this.store.order) throw new Error('order 模块未初始化');
     return this.store.order.updateTempOrderContactsInfo(contactsInfo);
@@ -1556,6 +1752,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();
@@ -1681,9 +1895,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({
@@ -1696,11 +1915,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 || []);
@@ -1726,7 +1958,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) {
@@ -1782,16 +2015,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;
@@ -1899,6 +2145,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,
@@ -2037,6 +2294,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 订单。
@@ -2048,10 +2400,11 @@ 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();
-    const enhancePayload = this.buildSubmitPayloadEnhancerWithFulfillmentRefMode(params?.enhancePayload);
+    const enhancePayload = this.buildSubmitPayloadEnhancerWithOpenDataConfig(params?.enhancePayload);
     const submitParams = {
       cacheId: this.cacheId,
       platform: this.otherParams?.platform,
@@ -2059,7 +2412,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 ? {
@@ -2068,10 +2423,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
       } : {})
     };
@@ -2098,7 +2475,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     }
     const inferredPaymentStatus = this.getSubmitPaymentStatus(params?.paymentStatus);
     const smallTicketDataFlag = params?.smallTicketDataFlag ?? this.getDefaultCheckoutSmallTicketDataFlag();
-    const enhancePayload = this.buildSubmitPayloadEnhancerWithFulfillmentRefMode(params?.enhancePayload);
+    const enhancePayload = this.buildSubmitPayloadEnhancerWithOpenDataConfig(params?.enhancePayload);
     const submitParams = {
       cacheId: this.cacheId,
       platform: this.otherParams?.platform,
@@ -2169,7 +2546,18 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       channel: context.channel,
       type: context.type
     });
-    const response = await this.request.post('/local/print-order', payload, {
+    const invoiceLayoutConfig = this.getCachedInvoiceLayoutConfig();
+    const invoiceTemplateSettings = this.getCachedInvoiceTemplateSettings();
+    const printPayload = {
+      ...payload,
+      ...(invoiceLayoutConfig ? {
+        invoice: (0, _lodashEs.cloneDeep)(invoiceLayoutConfig)
+      } : {}),
+      ...(invoiceTemplateSettings ? {
+        template_settings: (0, _lodashEs.cloneDeep)(invoiceTemplateSettings)
+      } : {})
+    };
+    const response = await this.request.post('/local/print-order', printPayload, {
       osServer: true,
       customToast: () => {}
     });
@@ -2192,7 +2580,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     if (!this.store.order) throw new Error('order 模块未初始化');
     const businessCode = params.businessCode ?? this.otherParams?.businessCode ?? this.otherParams?.business_code;
     const channel = params.channel ?? this.getSubmitOrderSalesChannel();
-    const enhancePayload = this.buildSubmitPayloadEnhancerWithFulfillmentRefMode(params.enhancePayload);
+    const enhancePayload = this.buildSubmitPayloadEnhancerWithOpenDataConfig(params.enhancePayload);
     const syncParams = {
       ...params,
       checkoutSyncTaskEnabled: this.shouldUseCheckoutSyncTask(),
@@ -2483,7 +2871,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;
   }
@@ -2629,9 +3017,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;
   }
@@ -2764,7 +3153,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       source: params.source
     });
     await this.syncSelectedWalletAssets(state);
-    return this.publishWalletAssetsState(state);
+    return this.publishWalletAssetsState(state, 'local');
   }
 
   /** 更新已选钱包资产的手动使用金额，并同步 pending payment。 */
@@ -2772,7 +3161,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');
   }
 
   /** 扫码精确查券；仅可用资产会被自动选中。 */
@@ -2787,7 +3176,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;
   }
@@ -2797,7 +3186,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');
   }
 
   /**
@@ -2893,10 +3282,24 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     if (!this.store.order) throw new Error('order 模块未初始化');
     const beforePayments = (0, _lodashEs.cloneDeep)(this.store.order.getOrderPayments());
     const pendingWalletAmount = this.getPendingWalletPaymentAmount(beforePayments);
+    const amountSnapshot = this.store.order.getOrderAmountSnapshot?.();
     if (pendingWalletAmount.lte(0)) {
-      throw new Error('当前订单没有待确认的 Wallet 支付');
+      this.logWarning('confirmWalletPayment: 未发现待确认 Wallet 支付，跳过 Wallet 确认并按普通订单提交', {
+        amountGap: amountSnapshot?.amountGap
+      });
+      const submitResult = await this.submitSalesOrder({
+        smallTicketDataFlag: 1
+      });
+      if (isRejectedSalesSubmitResult(submitResult)) {
+        throw new Error(getSalesSubmitErrorMessage(submitResult, '订单提交失败'));
+      }
+      const latestAmountSnapshot = this.store.order.getOrderAmountSnapshot?.();
+      return {
+        submitResult,
+        payments: this.store.order.getOrderPayments(),
+        isOrderFullyPaid: new _decimal.default(latestAmountSnapshot?.amountGap || 0).lte(0)
+      };
     }
-    const amountSnapshot = this.store.order.getOrderAmountSnapshot?.();
     const effectiveAmountDue = _decimal.default.max(new _decimal.default(amountSnapshot?.amountGap || 0).minus(pendingWalletAmount), 0);
     if (effectiveAmountDue.gt(0.01)) {
       throw new Error('Wallet 支付尚未覆盖全部待支付金额');
@@ -2927,7 +3330,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)
@@ -3011,7 +3414,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 || {},
@@ -3117,7 +3520,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 || {},