@pisell/pisellos 2.2.147 → 2.2.149

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

@@ -1,12 +1,191 @@
 import { CartItem } from '../Cart/types';
+import type { DiscountModule } from '../Discount';
+import type { RulesModule } from '../Rules';
+import type { Discount } from '../Discount/types';
+import type { SubmitPayloadEnhancer } from './utils';
+import type { PaymentItem } from '../Payment/types';
+import type { ICustomer } from '../AccountList/types';
 export declare enum OrderHooks {
     OnOrderCreate = "order:onOrderCreate",
     OnOrderUpdate = "order:onOrderUpdate",
     OnOrderCancel = "order:onOrderCancel",
-    OnOrderStatusChange = "order:onOrderStatusChange"
+    OnOrderStatusChange = "order:onOrderStatusChange",
+    OnOrderCustomerChange = "order:onOrderCustomerChange"
+}
+/**
+ * tempOrder 上的下单客户协议字段视图。
+ * 这些字段会随订单提交到后端。
+ *
+ * customer_id 与 OrderTempOrder.customer_id 保持一致（number | null），
+ * 调用方若持有 string id（如 ICustomer.id 联合类型），需自行 Number() 转型。
+ */
+export interface OrderCustomerView {
+    customer_id: number | null;
+    customer_name: string;
+    phone: string;
+    email: string;
+    country_calling_code: string;
+}
+/**
+ * 写入下单客户的协议字段输入。
+ * `customer_id` 必传（null 表示无客户）；其余字段缺省视为「清空」（全量覆盖语义）。
+ */
+export interface OrderCustomerPatch {
+    customer_id: number | null;
+    id?: number | null;
+    customer_name?: string;
+    phone?: string;
+    email?: string;
+    country_calling_code?: string;
+}
+/**
+ * 下单客户变更事件 payload。
+ * - `patch`：tempOrder 上的协议字段视图（会随订单提交）
+ * - `snapshot`：UI 富字段快照（仅本地，不随订单提交）
+ * 清空时整个 payload 为 null。
+ */
+export interface OrderCustomerChangePayload {
+    patch: OrderCustomerView;
+    snapshot: ICustomer | null;
+}
+export interface OrderProductIdentity {
+    product_id: number | null;
+    product_variant_id: number;
+    unique_identification_number?: string;
+    product_option_item?: any[];
+    product_bundle?: any[];
+}
+export interface OrderProduct extends OrderProductIdentity {
+    order_detail_id: number | null;
+    num: number;
+    bundle_edit?: number;
+    product_option_item: any[];
+    product_sku?: Record<string, any>;
+    gift_card?: number;
+    selling_price: string;
+    original_price: string;
+    tax_fee: string;
+    is_charge_tax: number;
+    discount_list: any[];
+    product_bundle: any[];
+    booking_uid?: string;
+    metadata: Record<string, any>;
+    note?: string;
+}
+export interface OrderSummary {
+    product_quantity: number;
+    product_original_amount: string;
+    product_amount: string;
+    product_expect_amount: string;
+    product_tax_fee: string;
+    shipping_fee: string;
+    shipping_tax_fee: string;
+    tax_fee: string;
+    surcharge_fee: string;
+    discount_amount: string;
+    deposit_amount: string;
+    deposit?: {
+        total: string;
+        deposit_policy_ids: number[];
+        hasDeposit: boolean;
+    };
+    expect_amount: string;
+    total_amount: string;
+    total_refund_amount: string;
+    customer_paid_amount: string;
+    order_paid_amount: string;
+    amount_gap: string;
+    rounding_amount: string;
+    pay_service_charge_amount: string;
+    tax_title?: string;
+    tax_rate?: number;
+}
+export interface OrderTempOrder {
+    order_id: number | null;
+    external_sale_number: string;
+    order_number: string;
+    shop_order_number: string;
+    shop_full_order_number: string;
+    type: string;
+    business_code: string;
+    platform: string;
+    sales_channel: string;
+    order_sales_channel: string;
+    status: string;
+    payment_status: string;
+    shipping_status: string;
+    customer_id: number | null;
+    customer_name: string;
+    country_calling_code: string;
+    phone: string;
+    email: string;
+    customer?: Record<string, any> | null;
+    is_price_include_tax: number;
+    tax_title: string;
+    tax_country_code: string;
+    currency_code: string;
+    currency_symbol: string;
+    currency_format: string;
+    is_deposit: number;
+    deposit_amount: string;
+    shop_discount: string;
+    surcharge_fee: string;
+    note: string;
+    buzzer?: string;
+    delivery_type?: string;
+    table_number?: Record<string, any>;
+    schedule_date: string;
+    created_at: string;
+    request_unique_idempotency_token?: string;
+    products: OrderProduct[];
+    bookings: any[];
+    payments: any[];
+    surcharges: any[];
+    discount_list: any[];
+    relation_forms: any[];
+    contacts: any[];
+    contacts_info: Record<string, any> | null;
+    holder: Record<string, any> | null;
+    metadata: Record<string, any>;
+    _extend?: {
+        productsByUid?: Record<string, Record<string, any>>;
+        [key: string]: any;
+    };
+}
+export interface OrderSubmitProduct extends Omit<OrderProduct, 'unique_identification_number' | 'num' | 'product_option_item'> {
+    product_quantity: number;
+    payment_price: string;
+    product_sku: Record<string, any>;
+}
+export interface OrderSubmitPayload extends Omit<OrderTempOrder, 'platform' | 'products' | '_extend' | 'customer' | 'shop_full_order_number'> {
+    platform: string;
+    request_unique_idempotency_token?: string;
+    form_record_ids?: Array<{
+        form_id: number | string;
+        form_record_id: number | string;
+    }>;
+    products: OrderSubmitProduct[];
+    small_ticket_data_flag?: number;
 }
 export interface OrderState {
+    tempOrder: OrderTempOrder | null;
+    summary?: OrderSummary;
+    lastOrderInfo?: Record<string, any>;
+    syncState?: OrderSyncState;
+    discountList: any[];
+    discount: DiscountModule | null;
+    rules: RulesModule | null;
+}
+/** 更新购物车行：仅传 SKU 时命中同 SKU 第一行；多行同 SKU 须传 unique_identification_number / 选项指纹等 */
+export interface UpdateProductInOrderParams {
+    product_id: number | null;
+    product_variant_id: number;
+    updates: Partial<OrderProduct>;
+    unique_identification_number?: string;
+    product_option_item?: any[];
+    product_bundle?: any[];
 }
+export type AddProductBookingInput = Record<string, any>;
 /**
  * 订单信息
  */
@@ -15,10 +194,74 @@ export interface CommitOrderParams {
     query: {
         cartItems: CartItem[];
         type: 'virtual' | 'appointment_booking';
-        platform?: 'pc' | 'h5';
+        platform?: string;
         extraData?: Record<string, any>;
     };
 }
+export interface OrderSubmitBooking {
+    relation_id?: string;
+    form_id?: string;
+    collect_pax?: number;
+    start_time?: string;
+    end_time?: string;
+    metadata?: Record<string, any>;
+    resources?: Array<Record<string, any>>;
+    product_uid?: string;
+}
+export interface OrderSubmitFormRecord {
+    form_id: number | string;
+    form_record_id: number | string;
+}
+export interface SubmitSalesOrderParams {
+    url?: string;
+    query: {
+        order_id: number | null;
+        external_sale_number: string;
+        order_number: string;
+        shop_order_number: string;
+        type: string;
+        business_code: string;
+        platform: string;
+        request_unique_idempotency_token?: string;
+        sales_channel: string;
+        order_sales_channel: string;
+        status: string;
+        payment_status: string;
+        shipping_status: string;
+        customer_id: number | null;
+        customer_name: string;
+        country_calling_code: string;
+        phone: string;
+        email: string;
+        is_price_include_tax: number;
+        tax_title: string;
+        tax_country_code: string;
+        currency_code: string;
+        currency_symbol: string;
+        currency_format: string;
+        is_deposit: number;
+        deposit_amount: string;
+        shop_discount: string;
+        surcharge_fee: string;
+        note: string;
+        delivery_type?: string;
+        table_number?: Record<string, any>;
+        schedule_date: string;
+        created_at: string;
+        products: OrderSubmitProduct[];
+        bookings: OrderSubmitBooking[];
+        payments: any[];
+        surcharges?: any[];
+        discount_list: any[];
+        relation_forms: any[];
+        form_record_ids?: OrderSubmitFormRecord[];
+        contacts: any[];
+        contacts_info: Record<string, any> | null;
+        holder: Record<string, any> | null;
+        metadata: Record<string, any>;
+        small_ticket_data_flag?: number;
+    };
+}
 /**
  * 支付项数据
  */
@@ -29,15 +272,105 @@ export interface PaymentItemData {
     amount: string;
     /** 支付类型代码 */
     code: string;
-    /** 支付类型id */
-    id: number;
+    /** @deprecated use custom_payment_id */
+    id?: number;
+    /** 支付方式 ID */
+    custom_payment_id?: number;
     /** 支付类型名称 */
     name: string;
     /** 支付类型 */
     type: string;
-    /** 是否已同步到后端 */
+    /** @deprecated BaseSales/Sales 协议不提交该字段；旧 Checkout/Payment 内部仍可能使用 */
     isSynced?: boolean;
 }
+export interface OrderPaymentMetadata {
+    rounding_rule?: Record<string, any>;
+    unique_payment_number?: string;
+    shop_wallet_pass_id?: number | string;
+    actual_paid_amount?: number | string;
+    change_given_amount?: number | string;
+    [key: string]: any;
+}
+export interface OrderPaymentData {
+    amount: string;
+    code: string;
+    custom_payment_id: number;
+    name: string;
+    type: string;
+    voucher_id?: string | number;
+    origin_amount?: string;
+    service_fee?: string;
+    status?: 'active' | 'voided' | string;
+    payment_time?: string;
+    wallet_pass_usage_unit?: unknown;
+    wallet_pass_use_value?: string | number | null;
+    metadata: OrderPaymentMetadata;
+    rounding_amount?: string;
+    service_charge?: {
+        percentage?: string;
+        amount?: string;
+    };
+    order_payment_type?: 'normal' | 'deposit';
+    created_at?: string;
+    updated_at?: string;
+}
+export type OrderPaymentSource = PaymentItem | OrderPaymentData | Record<string, any>;
+export interface MapOrderPaymentsOptions {
+    includeVoided?: boolean;
+}
+export type OrderSyncState = 'local' | 'submitting' | 'submitted' | 'failed' | 'remoteLoaded';
+export interface LoadSalesDetailParams {
+    orderId?: number | string;
+    orderNumber?: string;
+    externalSaleNumber?: string;
+    external_sale_number?: string;
+    forceRemote?: boolean;
+}
+export interface SyncPaymentsToOrderParams {
+    payments: OrderPaymentSource[];
+    paymentStatus?: SubmitSalesOrderParams['query']['payment_status'];
+    submitWhenPaid?: boolean;
+    smallTicketDataFlag?: number;
+}
+export interface SyncPaymentsToOrderResult<T = any> {
+    isFullyPaid: boolean;
+    submitResult?: T;
+}
+export interface OrderIdentitySnapshot {
+    localId?: string;
+    orderId?: number | string | null;
+    externalSaleNumber?: string;
+    orderNumber?: string;
+    shopOrderNumber?: string;
+    shopFullOrderNumber?: string;
+    isSubmitted: boolean;
+}
+export interface OrderAmountSnapshot {
+    isDeposit: boolean;
+    depositAmount: string;
+    expectAmount: string;
+    totalAmount: string;
+    amountGap: string;
+    summary: OrderSummary;
+}
+export interface OrderSnapshot {
+    identity: OrderIdentitySnapshot;
+    syncState: OrderSyncState;
+    amount: OrderAmountSnapshot;
+    status: string;
+    paymentStatus: string;
+    shippingStatus: string;
+    note: string;
+    customer: {
+        customerId: number | null;
+        customerName: string;
+        phone: string;
+        email: string;
+    };
+    productCount: number;
+    lastOrderInfo?: Record<string, any>;
+    tempOrder: OrderTempOrder;
+}
 /**
  * Checkout 专用订单创建参数
  */
@@ -75,23 +408,11 @@ export interface ChangeBookingStatusParams {
  * 订单模块 API
  */
 export interface OrderModuleAPI {
-    /**
-     * 创建订单
-     * @param params 订单信息
-     * @returns 订单信息
-     */
     createOrder: (params: CommitOrderParams['query']) => any;
-    /**
-     * 检查购物车提交订单前是否符合条件
-     */
     checkBeforeSubmitOrder: (params: {
         cartItems: CartItem[];
         type: 'holder' | 'account';
     }) => boolean;
-    /**
-     * 提交订单
-     * @param params 订单信息
-     */
     submitOrder: (params: CommitOrderParams) => Promise<void>;
     /**
      * Checkout 专用：创建订单到后端
@@ -99,11 +420,92 @@ export interface OrderModuleAPI {
      * @returns 后端返回的订单数据
      */
     createOrderByCheckout: (params: CheckoutOrderParams) => Promise<any>;
+    submitSalesOrder: <T = any>(params: SubmitSalesOrderParams) => Promise<T>;
+    initTempOrder: (params: {
+        cacheId?: string;
+        salesSummaryModuleName?: string;
+    }) => void;
+    getTempOrder: () => OrderTempOrder | null;
+    ensureTempOrder: () => OrderTempOrder;
+    addNewOrder: () => Promise<OrderTempOrder>;
+    restoreOrder: () => OrderTempOrder;
+    getOrderProducts: () => OrderProduct[];
+    getOrderSummary: () => Promise<OrderSummary>;
+    recalculateSummary: (options?: {
+        createIfMissing?: boolean;
+    }) => Promise<OrderSummary | null>;
+    getOrderIdentity: () => OrderIdentitySnapshot | null;
+    getOrderSnapshot: () => OrderSnapshot | null;
+    getOrderSyncState: () => OrderSyncState;
+    getOrderAmountSnapshot: () => OrderAmountSnapshot | null;
+    getTempOrderNote: () => string;
+    updateTempOrderNote: (note: string) => string;
+    updateTempOrderShopDiscount: (amount: string | number) => string;
+    updateTempOrderCustomer: (customer: UpdateTempOrderCustomerInput) => OrderSnapshot['customer'];
+    updateTempOrderBuzzer: (buzzer: string) => string;
+    updateTempOrderContactsInfo: (contactsInfo: Record<string, any> | null) => Record<string, any> | null;
+    addProductToOrder: (product: Partial<OrderProduct> & OrderProductIdentity, booking?: AddProductBookingInput) => Promise<OrderProduct[]>;
+    updateProductInOrder: (params: UpdateProductInOrderParams) => Promise<OrderProduct[]>;
+    removeProductFromOrder: (identity: OrderProductIdentity) => Promise<OrderProduct[]>;
+    persistTempOrder: () => void;
+    submitTempOrder: <T = any>(params?: {
+        cacheId?: string;
+        platform?: string;
+        businessCode?: string;
+        channel?: string;
+        type?: string;
+        payments?: OrderPaymentSource[];
+        paymentStatus?: SubmitSalesOrderParams['query']['payment_status'];
+        smallTicketDataFlag?: number;
+        enhancePayload?: SubmitPayloadEnhancer;
+    }) => Promise<T>;
+    getOrderPayments: () => OrderPaymentData[];
+    setOrderPayments: (payments: OrderPaymentSource[]) => OrderPaymentData[];
+    addOrderPayment: (payment: OrderPaymentSource) => OrderPaymentData[];
+    updateOrderPayment: (paymentIdentity: string | number, updates: Partial<OrderPaymentData> & Record<string, any>) => OrderPaymentData[];
+    deleteOrderPayment: (paymentIdentity: string | number) => OrderPaymentData[];
+    updateVoucherOrderPayments: (payments: OrderPaymentSource[]) => OrderPaymentData[];
+    sendCustomerPayLink: <T = any>(params: SendCustomerPayLinkParams) => Promise<T>;
+    saveDraft: () => Promise<void>;
+    hasLocalDatabase: () => boolean;
+    getLocalOrderByOrderId: (orderId: number | string) => Promise<Record<string, any> | null>;
+    getLocalOrderByExternalSaleNumber: (externalSaleNumber: string) => Promise<Record<string, any> | null>;
+    getLocalOrderByOrderNumber: (orderNumber: string) => Promise<Record<string, any> | null>;
+    hydrateTempOrderFromRecord: (record: Record<string, any>, options?: {
+        recalcOnHydrate?: boolean;
+    }) => Promise<OrderTempOrder>;
+    syncPaymentsToOrder: <T = any>(params: SyncPaymentsToOrderParams) => Promise<SyncPaymentsToOrderResult<T>>;
+    getOrderInfoByRemote: (order_id: number) => Promise<any>;
+    getLastOrderInfo: () => Record<string, any> | undefined;
+    getOrderInfo: (order_id: number) => Promise<any>;
     /**
-     * 取消订单
-     * @param params 取消订单参数
-     * @returns 后端返回结果
+     * 写入当前下单客户。
+     *
+     * 语义为「全量覆盖」：`patch` 中未提供的协议字段会被清空（写为 ''）。
+     * snapshot 用于保存 UI 富字段（wallet/会员/地址等），不会随订单提交。
+     *
+     * @param patch    tempOrder 协议字段；传 null 等价于 clearOrderCustomer。
+     * @param snapshot UI 富字段快照。undefined 表示不动既有 snapshot；
+     *                 null 表示显式清空 snapshot；ICustomer 写入并 cloneDeep。
      */
+    setOrderCustomer: (patch: OrderCustomerPatch | null, snapshot?: ICustomer | null) => void;
+    /** 读取 tempOrder 的客户协议字段；customer_id 缺失时返回 null。 */
+    getOrderCustomer: () => OrderCustomerView | null;
+    /** 读取 _extend.customerSnapshot；不存在时返回 null。 */
+    getOrderCustomerSnapshot: () => ICustomer | null;
+    /** 清空 tempOrder 协议字段 + _extend.customerSnapshot，并 emit 变更事件 payload=null。 */
+    clearOrderCustomer: () => void;
+    loadDiscountConfig: (params: {
+        customerId: number;
+        action?: 'create';
+    }) => Promise<void>;
+    getDiscountList: () => Discount[];
+    applyDiscount: () => void;
+    /**
+   * 取消订单
+   * @param params 取消订单参数
+   * @returns 后端返回结果
+   */
     cancelOrder: (params: CancelOrderParams) => Promise<any>;
     /**
      * 变更预约状态
@@ -112,3 +514,22 @@ export interface OrderModuleAPI {
      */
     changeBookingStatus: (params: ChangeBookingStatusParams) => Promise<any>;
 }
+export interface UpdateTempOrderCustomerInput {
+    customer_id?: number | string | null;
+    customerId?: number | string | null;
+    id?: number | string | null;
+    customer_name?: string;
+    customerName?: string;
+    display_name?: string;
+    name?: string;
+    country_calling_code?: string;
+    countryCallingCode?: string;
+    phone?: string;
+    email?: string;
+}
+export interface SendCustomerPayLinkParams {
+    emails: string[];
+    orderIds?: Array<number | string>;
+    order_ids?: Array<number | string>;
+    notify_action?: string;
+}

package/lib/modules/Order/types.js

@@ -27,6 +27,7 @@ var OrderHooks = /* @__PURE__ */ ((OrderHooks2) => {
   OrderHooks2["OnOrderUpdate"] = "order:onOrderUpdate";
   OrderHooks2["OnOrderCancel"] = "order:onOrderCancel";
   OrderHooks2["OnOrderStatusChange"] = "order:onOrderStatusChange";
+  OrderHooks2["OnOrderCustomerChange"] = "order:onOrderCustomerChange";
   return OrderHooks2;
 })(OrderHooks || {});
 // Annotate the CommonJS export names for ESM import in node:

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

@@ -1,4 +1,71 @@
+import Decimal from 'decimal.js';
 import { CartItem } from "../Cart";
+import type { OrderSubmitPayload, OrderSubmitProduct, OrderSummary, OrderTempOrder } from './types';
+import type { RulesParamsHooks } from '../Rules/types';
+import type { MapOrderPaymentsOptions, OrderPaymentData, OrderPaymentSource } from './types';
+/**
+ * 把"含 option 的主商品单价"与 bundle 合成"单行 composite 单价"。
+ *
+ * 新语义 v2 约定：
+ * - `mainPrice` 必须是**已经包含 option 的主商品单价**（即 `metadata.main_product_selling_price`
+ *   或 `metadata.main_product_original_price`），option 价格不由本函数叠加。
+ * - 套餐价：Σ((bundle.bundle_selling_price ?? bundle.price) × (bundle.num ?? bundle.quantity ?? 1))
+ *   当 `useOriginalBundle=true` 时，改用 `bundle.original_price ?? bundle.product_price ?? bundle.price`。
+ * - 返回值：保留 2 位小数的字符串，方便直接写回 `selling_price` / `original_price` 字段。
+ *
+ * 被 `normalizeOrderProduct`、Rules setProduct 钩子、各 Solution 的 setDiscountSelected 共用，
+ * 保证合成逻辑单点来源。
+ */
+export declare function composeLinePrice(params: {
+    mainPrice: string | number | null | undefined;
+    bundle?: Array<{
+        bundle_selling_price?: any;
+        price?: any;
+        num?: any;
+        quantity?: any;
+        original_price?: any;
+        product_price?: any;
+    }> | null;
+    useOriginalBundle?: boolean;
+}): string;
+/**
+ * 计算 option 单价合计：Σ(option.price × option.num)。
+ * 在新语义 v2 下，main_product_original_price = source_product_price + 本函数结果。
+ */
+export declare function sumOptionUnitPrice(options?: Array<{
+    price?: any;
+    num?: any;
+}> | null): Decimal;
+/**
+ * OrderModule 默认 Rules 钩子工厂。
+ *
+ * 价格语义约定（订单域，v2 composite 口径）：
+ * - `selling_price`：券后 **行 composite 单价**
+ *   = `metadata.main_product_selling_price` + Σ(bundle_selling_price × num)。
+ * - `original_price`：券前 **行 composite 单价**
+ *   = `metadata.main_product_original_price` + Σ(bundle 原价 × num)。
+ * - `metadata.source_product_price`：主商品/variant 基础价（已应用报价单），不含 option、
+ *   不含折扣。**权威源**。
+ * - `metadata.main_product_original_price` = source + Σ(option.price × option.num)（含 option、不含折扣）。
+ * - `metadata.main_product_selling_price` = main_original − 主商品券 per-unit amount（含 option、含折扣）。
+ * - `payment_price`：出站 payload 中由 `selling_price` 派生以兼容后端（composite）。
+ *
+ * Rules 钩子契约（hook_adapt 方案，Rules 内部保持不变）：
+ * - `getProduct.price` / `getProduct.original_price` 回传 **source-level 主价**
+ *   （`metadata.source_product_price`）。Rules 内部 `getProductTotalPrice` /
+ *   `getProductOriginTotalPrice` 会自行叠加 option + bundle，喂 source 可避免 option 双加。
+ * - `getProduct.total` = `selling_price × num`（行 composite × num），与 Rules 内部产出的
+ *   total（source + option + bundle）对齐。
+ * - `setProduct` 反向流程：把 Rules 返回的 source-level `main_product_selling_price` / `price`
+ *   加回 Σoptions，重新合成含 option 的 main_product_* 并派生 composite。
+ *   优先级：
+ *     1. `values.main_product_selling_price`（券应用分支，per-unit 券后 source-level 主价）
+ *     2. `values.price`（还原分支 `restoredPrice`、good_pass 归零）
+ *     3. `values.total / num`（仅当 Rules 只给出总价时的兜底）
+ *
+ * 导出为纯函数方便单测直接驱动钩子，不依赖 OrderModule 实例。
+ */
+export declare function createDefaultOrderRulesHooks(): RulesParamsHooks;
 /**
  * 通过 session 类商品的开始时间结束时间生成商品的时长
  * @param {CartItem} cartItem
@@ -21,3 +88,56 @@ export declare const mergeRelationForms: (relationForms: {
     form_record_ids: number[];
 }[];
 export declare const getAllDiscountList: (cartItem: CartItem) => any;
+export declare function createUuidV4(): string;
+export declare function isTempOrder(data: any): data is OrderTempOrder;
+export declare function formatDateTime(date: Date): string;
+export declare function normalizeBookingIsAll(booking: Record<string, any>): 0 | 1;
+export declare function normalizeBookingSubType(booking: Record<string, any>): string;
+export declare function normalizeSubmitBooking<T extends {
+    metadata?: Record<string, any>;
+}>(booking: T): T;
+/** 提交用人数：有限且为正则向下取整，否则为 1 */
+export declare function normalizeSubmitCollectPaxValue(value: unknown): number;
+/** 从临时订单 metadata 解析合成 booking 的 collect_pax */
+export declare function resolveSubmitCollectPax(tempOrder: OrderTempOrder): number;
+export declare function createDefaultTempOrder(params: {
+    now: string;
+    summary?: OrderSummary;
+}): OrderTempOrder;
+export interface SubmitPayloadEnhancerContext {
+    tempOrder: OrderTempOrder;
+    bookingUuid: string;
+    now: Date;
+}
+export type SubmitPayloadEnhancer = (payload: OrderSubmitPayload, ctx: SubmitPayloadEnhancerContext) => OrderSubmitPayload;
+export declare function buildSubmitPayload(params: {
+    tempOrder: OrderTempOrder;
+    cacheId?: string;
+    now?: Date;
+    platform?: string;
+    businessCode?: string;
+    channel?: string;
+    type?: string;
+    enhance?: SubmitPayloadEnhancer;
+}): OrderSubmitPayload;
+export declare function mapPaymentItemToOrderPayment(paymentItem: OrderPaymentSource): OrderPaymentData;
+export declare function mapPaymentItemsToOrderPayments(paymentItems: OrderPaymentSource[], options?: MapOrderPaymentsOptions): OrderPaymentData[];
+/**
+ * 历史 V1 加餐结构映射器。
+ *
+ * @deprecated 标准 Sales checkout 已统一提交结构。
+ * 本函数仅保留以兼容历史接入方，未来会移除。新代码请勿再调用。
+ */
+export declare function formatV1Product(products: OrderSubmitProduct[]): {
+    bundle: any[];
+    key: number | null;
+    option: any;
+    product_id: number | null;
+    product_variant_id: number;
+    num: number;
+    note: string;
+    rowKey: number | null;
+    session: null;
+    unique: string;
+}[];
+export { createEmptySummary } from '../../solution/ScanOrder/utils';