@pisell/pisellos 2.3.101 → 2.3.103

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

@@ -1,7 +1,7 @@
 import { CartItem } from '../Cart/types';
 import type { DiscountModule } from '../Discount';
 import type { RulesModule } from '../Rules';
-import type { Discount } from '../Discount/types';
+import type { Discount, VirtualCurrencyAsset } from '../Discount/types';
 import type { UnavailableReason } from '../Rules/types';
 import type { SubmitPayloadEnhancer } from './utils';
 import type { PaymentItem } from '../Payment/types';
@@ -117,7 +117,7 @@ export interface OrderLastGiftActions {
     }>;
     toRemove: string[];
 }
-/** onPromotionApplied 事件 payload */
+/** onPromotionApplied 稳定态事件 payload（促销、折扣与 summary 均已完成）。 */
 export interface OrderPromotionAppliedPayload {
     unfulfilledPromotions: OrderUnfulfilledPromotion[];
     giftActions: OrderLastGiftActions;
@@ -131,7 +131,7 @@ export interface OrderPromotionAppliedPayload {
             product_variant_id: number;
         }>;
     }>;
-    /** 处理后的商品列表 */
+    /** 折扣重算后的最终商品列表 */
     products: OrderProduct[];
 }
 /**
@@ -205,6 +205,7 @@ export interface OrderProduct extends OrderProductIdentity {
     gift_card?: number;
     selling_price: string;
     original_price: string;
+    payment_price?: string;
     tax_fee: string;
     is_charge_tax: number;
     discount_list: OrderProductDiscountItem[];
@@ -353,6 +354,7 @@ export interface OrderTempOrder {
     notes: SalesNote[];
     bookings: any[];
     payments: any[];
+    refunds?: any[];
     surcharges: any[];
     discount_list?: any[];
     relation_forms: any[];
@@ -372,8 +374,9 @@ export interface OrderSubmitProduct extends Omit<OrderProduct, 'unique_identific
     payment_price: string;
     product_sku: OrderProductSku;
 }
-export interface OrderSubmitPayload extends Omit<OrderTempOrder, 'platform' | 'products' | 'notes' | '_extend' | 'customer' | 'discount_list' | 'created_at'> {
+export interface OrderSubmitPayload extends Omit<OrderTempOrder, 'platform' | 'products' | 'notes' | '_extend' | 'customer' | 'discount_list' | 'created_at' | 'payment_status'> {
     platform: string;
+    payment_status?: string;
     created_at?: string | undefined;
     request_unique_idempotency_token?: string;
     form_record_ids?: Array<{
@@ -392,6 +395,7 @@ export interface OrderState {
     syncState?: OrderSyncState;
     discountList: any[];
     availableWalletIds?: number[];
+    virtualCurrencyList?: VirtualCurrencyAsset[];
     discount: DiscountModule | null;
     rules: RulesModule | null;
 }
@@ -530,7 +534,7 @@ export interface SubmitSalesOrderParams {
         sales_channel: string;
         order_sales_channel: string;
         status: string;
-        payment_status: string;
+        payment_status?: string;
         shipping_status: string;
         customer_id: number | null;
         customer_name: string;
@@ -794,6 +798,8 @@ export interface OrderModuleAPI {
     addNewOrder: () => Promise<OrderTempOrder>;
     restoreOrder: () => OrderTempOrder;
     getOrderProducts: () => OrderProduct[];
+    getVirtualCurrencyList: () => VirtualCurrencyAsset[];
+    clearOrderForSettlementSwitch: () => Promise<OrderTempOrder>;
     getOrderSummary: () => Promise<OrderSummary>;
     recalculateSummary: (options?: {
         createIfMissing?: boolean;
@@ -864,6 +870,8 @@ export interface OrderModuleAPI {
     isTempOrderPersistEnabled: () => boolean;
     /** 提交 tempOrder 变更并触发 `{moduleName}:changed` 事件 */
     notifyTempOrderChanged: () => void;
+    /** PC/H5 为在线店铺；其它或缺失平台统一按 POS 处理。 */
+    isOnlineStorePlatform: () => boolean;
     submitTempOrder: <T = any>(params?: {
         cacheId?: string;
         platform?: string;
@@ -971,7 +979,7 @@ export interface OrderModuleAPI {
      */
     appendPromotionTags: <T extends Record<string, any>>(products: T[]) => T[];
     /**
-     * 应用购物车促销（评估 → 差异化赠品 → 写回 tempOrder.products → emit onPromotionApplied）。
+     * 应用购物车促销（评估 → 差异化赠品 → 折扣/summary 重算 → emit onPromotionApplied）。
      *
      * 自动在 addProductToOrder / updateOrderProductQuantity / removeProductFromOrder /
      * clearOrderCartLines / setOrderCustomer 等写路径末尾触发，业务一般无需手动调用。

package/lib/modules/Order/types.js

@@ -40,7 +40,7 @@ let OrderHooks = exports.OrderHooks = /*#__PURE__*/function (OrderHooks) {
  */
 /** 未满足的促销策略（购物车底部 alert 渲染源） */
 /** 上一次 applyPromotion 计算出的赠品操作（仅供调试/读取使用） */
-/** onPromotionApplied 事件 payload */
+/** onPromotionApplied 稳定态事件 payload（促销、折扣与 summary 均已完成）。 */
 /**
  * tempOrder 上的下单客户协议字段视图。
  * 这些字段会随订单提交到后端。

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

@@ -0,0 +1,63 @@
+import type { OrderProduct, OrderTempOrder } from '../types';
+export interface SelectedSettlementSnapshot extends Record<string, any> {
+    settlement_type: 'legal_currency' | 'virtual_currency';
+    currency_product_id?: number;
+    price: string | number;
+    unit_label?: any;
+    symbol?: any;
+    amount_format?: string;
+}
+export interface LegalCurrencySnapshot {
+    currency_code: string;
+    currency_symbol: string;
+    currency_format: string;
+}
+export interface CurrencyDisplaySnapshot {
+    amount_format: string;
+    symbol: unknown;
+    unit_label: unknown;
+}
+export declare function buildCurrencyDisplaySnapshot(snapshot: Pick<SelectedSettlementSnapshot, 'amount_format' | 'symbol' | 'unit_label'>): CurrencyDisplaySnapshot;
+export declare function resolveSettlementDisplayValue(value: unknown): string;
+export declare class OrderSettlementConflictError extends Error {
+    readonly currentSettlementKey: string;
+    readonly incomingSettlementKey: string;
+    readonly code = "ORDER_SETTLEMENT_CONFLICT";
+    constructor(currentSettlementKey: string, incomingSettlementKey: string);
+}
+export declare class VirtualCurrencyAssetNotFoundError extends Error {
+    readonly currencyProductId: number;
+    readonly code = "VIRTUAL_CURRENCY_ASSET_NOT_FOUND";
+    constructor(currencyProductId: number);
+}
+export declare class VirtualCurrencyBalanceError extends Error {
+    readonly balance: string;
+    readonly requiredAmount: string;
+    readonly code = "VIRTUAL_CURRENCY_BALANCE_INSUFFICIENT";
+    constructor(balance: string, requiredAmount: string);
+}
+export declare function getSelectedSettlementSnapshot(product: Partial<OrderProduct> | null | undefined): SelectedSettlementSnapshot | null;
+export declare function getTempOrderSettlementSnapshot(tempOrder: OrderTempOrder | null | undefined): SelectedSettlementSnapshot | null;
+export declare function isVirtualSettlementProduct(product: Partial<OrderProduct> | null | undefined): boolean;
+export declare function getSettlementKey(snapshot: SelectedSettlementSnapshot | null | undefined): string | null;
+export declare function getTempOrderSettlementKey(tempOrder: OrderTempOrder | null | undefined): string | null;
+export declare function isVirtualSettlementOrder(tempOrder: OrderTempOrder | null | undefined): boolean;
+/**
+ * 详情展示识别同时支持已提交订单的 currency_settlement_config。
+ * cart_settlement_* 是交易过程内部状态，服务端详情不保证返回。
+ */
+export declare function isVirtualSettlementDisplayOrder(tempOrder: OrderTempOrder | null | undefined): boolean;
+/**
+ * 将购物车锁定的结算单位提升为订单级状态。
+ * 商品行快照同时负责价格归一化和生成订单级多语言展示快照；
+ * 交易中的即时展示仍统一读取 tempOrder.currency_*。
+ */
+export declare function applyTempOrderSettlementState(tempOrder: OrderTempOrder, snapshot: SelectedSettlementSnapshot): void;
+/** 清空购物车结算锁，并恢复进入虚拟币结算前的店铺法币。 */
+export declare function releaseTempOrderSettlementState(tempOrder: OrderTempOrder): void;
+/**
+ * 将已选择虚拟币的订单商品行固化为最终价语义。
+ * 函数幂等，可安全用于加车、合并、hydrate 和提交前兜底。
+ */
+export declare function normalizeVirtualSettlementOrderProduct<T extends Partial<OrderProduct>>(product: T): T;
+export declare function normalizeVirtualSettlementProducts<T extends Partial<OrderProduct>>(products: T[]): T[];

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, {