@pisell/pisellos 2.2.302 → 2.2.303

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

@@ -14,6 +14,7 @@
  * - 不在此处发明等价关系；UI 侧（ticketBooking）若需要别的字段，由 view-model 适配层做转换
  */
 import type { BaseSalesOrderProduct } from '../types';
+import type { OrderMetaList } from '../../../modules/Order/types';
 export interface ISalesDetailHeader {
     order_id: number | string | null;
     order_number?: string;
@@ -47,6 +48,7 @@ export interface ISalesDetailHeader {
     schedule_date?: string;
     created_at?: string;
     updated_at?: string | number;
+    order_meta_list?: OrderMetaList;
     metadata?: Record<string, any> | null;
     total_amount?: string | number;
     [key: string]: any;

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

@@ -22,7 +22,7 @@ var _orderCollectionIdentity = require("../../../modules/Order/utils/orderCollec
  */
 
 /** OrderData 中除大数组外的"顶层 header 字段"白名单，按需扩展。 */
-const HEADER_KEYS = ['order_id', 'order_number', 'shop_order_number', 'shop_full_order_number', 'type', 'business_code', 'platform', 'sales_channel', 'order_sales_channel', 'vouchers', 'status', 'payment_status', 'shipping_status', 'customer_id', 'customer_name', 'country_calling_code', 'phone', 'email', 'is_price_include_tax', 'tax_title', 'tax_country_code', 'currency_code', 'currency_symbol', 'currency_format', 'is_deposit', 'deposit_amount', 'shop_discount', 'surcharge_fee', 'note', 'schedule_date', 'created_at', 'updated_at', 'metadata', 'total_amount', 'shop_id', 'create_date', 'holder', 'relation_forms', 'contacts', 'contacts_info'];
+const HEADER_KEYS = ['order_id', 'order_number', 'shop_order_number', 'shop_full_order_number', 'type', 'business_code', 'platform', 'sales_channel', 'order_sales_channel', 'vouchers', 'status', 'payment_status', 'shipping_status', 'customer_id', 'customer_name', 'country_calling_code', 'phone', 'email', 'is_price_include_tax', 'tax_title', 'tax_country_code', 'currency_code', 'currency_symbol', 'currency_format', 'is_deposit', 'deposit_amount', 'shop_discount', 'surcharge_fee', 'note', 'schedule_date', 'created_at', 'updated_at', 'order_meta_list', 'metadata', 'total_amount', 'shop_id', 'create_date', 'holder', 'relation_forms', 'contacts', 'contacts_info'];
 function pickHeader(raw) {
   const header = {
     order_id: raw?.order_id ?? null

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

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

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

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

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

@@ -326,7 +326,7 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
         date: string;
         status: string;
         week: string;
-        weekNum: 0 | 1 | 2 | 5 | 4 | 3 | 6;
+        weekNum: 0 | 5 | 3 | 1 | 2 | 4 | 6;
     }[]>;
     submitTimeSlot(timeSlots: TimeSliceItem): void;
     private getScheduleDataByIds;

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

@@ -1,7 +1,7 @@
 import { Module, ModuleOptions, PisellCore } from '../../types';
 import { BookingTicketCartView, BookingTicketProductCatalogView, BookingTicketState, IGetCustomerListParams, ICustomer, ILoadProductsParams, ILoadProductDetailParams, IScanResult } from './types';
 import type { ProductData } from '../../modules';
-import type { OpenDataConfig } from '../../modules/OpenData';
+import { type InvoiceLayoutConfig, type InvoiceTemplateSettings, type OpenDataConfig } from '../../modules/OpenData';
 import { type BookingContextConfig, type BookingContextDateInput, type BookingContextResource, type BookingContextResourceMap, type BookingContextState, type InitBookingContextParams, type LoadBookingConfigParams, type LoadBookingResourcesParams, type ResourceError, type BookingCalcContext } from '../../modules/BookingContext';
 import type { OrderCustomerView, OrderCustomerChangePayload } from '../../modules/Order/types';
 import { BaseSalesImpl } from '../BaseSales';
@@ -30,7 +30,9 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
     private orderCustomerDiscountRefreshInFlight;
     private orderCustomerDiscountRefreshCustomerId;
     private orderCustomerPromotionRefreshInFlight;
-    private loadOpenDataConfigInFlight;
+    protected loadOpenDataInFlight: Promise<OpenDataConfig> | null;
+    protected loadOpenDataInFlightTarget: string | null;
+    protected openDataTarget: string | null;
     /**
      * 在 BaseSales 默认模块清单（products/order/salesSummary/schedule）基础上追加 customer + bookingContext。
      * bookingContext 是 SalesSdk 加车下沉所需的「预约 UI 上下文」（bookingConfig / resourcesOrigin / date）。
@@ -43,10 +45,13 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      */
     protected createSubModule(moduleName: string): Module | null;
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
-    private getBookingTicketBusinessCode;
+    protected getBookingTicketBusinessCode(): string | null;
     private getIdGeneratorPlugin;
     private loadOpenDataConfig;
     getOpenData(): Promise<OpenDataConfig | null>;
+    getInvoiceLayoutConfig(): Promise<InvoiceLayoutConfig>;
+    getInvoiceTemplateSettings(): Promise<InvoiceTemplateSettings>;
+    protected isInvoiceOpenDataCacheCurrent(): boolean;
     /** 清除店铺级 OpenData；下一次 getOpenData 时会重新拉取。 */
     clearOpenDataCache(): void;
     private getShortNumberOrDeviceId;
@@ -334,7 +339,7 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 获取当前的客户搜索条件
      * @returns 当前搜索条件
      */
-    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "skip" | "num">;
+    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "num" | "skip">;
     /**
      * 获取客户列表状态（包含滚动加载相关状态）
      * @returns 客户状态
@@ -453,7 +458,19 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 加车两阶段主决策（规格弹窗 / 资源编辑 / 直接加车）。
      * 与 ticketBooking `handleSelectProduct` + `handleBooking4Service` 等价。
      */
-    decideAddProduct(item: any, options?: Partial<AddProductDecideContext>): import("./utils/addProductDecision").AddProductDecision;
+    decideAddProduct(item: any, options?: Partial<AddProductDecideContext>): {
+        action: "reloadCatalog";
+    } | {
+        action: "add";
+        cacheItem: any;
+    } | {
+        action: "requiresDetail";
+        payload: AddProductRequiresDetailPayload;
+    } | {
+        action: "requiresBookingEdit";
+        cacheItem: any;
+        payload: import("./utils/addProductDecision").AddProductRequiresBookingEditPayload;
+    };
     /** 规格弹窗 callback 后的第二段决策。 */
     decideAfterDetail(cacheItem: any, options?: Partial<AddProductDecideContext>): import("./utils/addProductDecision").AddProductDecision;
     /**

package/lib/solution/BookingTicket/index.js

@@ -21,6 +21,7 @@ Object.keys(_types).forEach(function (key) {
     }
   });
 });
+var _OpenData = require("../../modules/OpenData");
 var _BookingContext = require("../../modules/BookingContext");
 var _BaseSales = require("../BaseSales");
 var _scan = _interopRequireDefault(require("./utils/scan"));
@@ -39,7 +40,7 @@ var _bookingStatus = require("./utils/bookingStatus");
 var _resolveBestAddTimePlan = require("./utils/resolveBestAddTimePlan");
 var _utils = require("../../modules/Order/utils");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-const OPEN_DATA_SECTION_CODES = ['sale', 'reservation', 'fulfillment', 'menu', 'workflow'];
+const OPEN_DATA_SECTION_CODES = ['sale', 'reservation', 'fulfillment', 'menu', 'workflow', 'documents'];
 const OPEN_DATA_CACHE_TTL = 5 * 60 * 1000;
 const USER_PLATFORM = ['pc', 'h5'];
 
@@ -160,7 +161,9 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
   orderCustomerDiscountRefreshInFlight = null;
   orderCustomerDiscountRefreshCustomerId = null;
   orderCustomerPromotionRefreshInFlight = null;
-  loadOpenDataConfigInFlight = null;
+  loadOpenDataInFlight = null;
+  loadOpenDataInFlightTarget = null;
+  openDataTarget = null;
 
   /**
    * 在 BaseSales 默认模块清单（products/order/salesSummary/schedule）基础上追加 customer + bookingContext。
@@ -193,10 +196,13 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
     await this.configureIdGeneratorFromOpenData();
   }
   getBookingTicketBusinessCode() {
-    const businessCode = this.otherParams?.businessCode ?? this.otherParams?.business_code;
-    if (businessCode === undefined || businessCode === null) return null;
-    const normalized = String(businessCode).trim();
-    return normalized || null;
+    const candidates = [this.otherParams?.businessCode, this.otherParams?.business_code, this.getOrderHeader()?.business_code, this.store.order?.getTempOrder()?.business_code, this.getSalesOrder()?.raw?.business_code];
+    for (const candidate of candidates) {
+      if (candidate === undefined || candidate === null) continue;
+      const normalized = String(candidate).trim();
+      if (normalized) return normalized;
+    }
+    return null;
   }
   getIdGeneratorPlugin() {
     const appPlugin = this.core.getPlugin('app');
@@ -210,35 +216,72 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
       console.warn('[BookingTicket] businessCode 缺失，跳过 OpenData 配置加载，当前 module name: ', this.name);
       return null;
     }
+    const channel = this.getSubmitOrderSalesChannel();
+    const target = `${businessCode}+${channel}`;
     const lastFetchedAt = this.store.openData.getLastFetchedAt();
     const cachedData = this.store.openData.getOpenData();
-    if (cachedData && lastFetchedAt && Date.now() - lastFetchedAt < OPEN_DATA_CACHE_TTL) {
+    if (cachedData && this.openDataTarget === target && lastFetchedAt && Date.now() - lastFetchedAt < OPEN_DATA_CACHE_TTL) {
+      if (typeof this.store.openData.ensureInvoiceTemplateSettings === 'function') {
+        await this.store.openData.ensureInvoiceTemplateSettings(target);
+      }
       this.otherParams.openData = cachedData;
       return cachedData;
     }
-    if (this.loadOpenDataConfigInFlight) return await this.loadOpenDataConfigInFlight;
-    const channel = this.getSubmitOrderSalesChannel();
-    this.loadOpenDataConfigInFlight = this.store.openData.fetchOpenData({
+    if (this.loadOpenDataInFlight) {
+      if (this.loadOpenDataInFlightTarget === target) {
+        return await this.loadOpenDataInFlight;
+      }
+      await this.loadOpenDataInFlight;
+      return this.loadOpenDataConfig();
+    }
+    this.loadOpenDataInFlightTarget = target;
+    const request = this.store.openData.fetchOpenData({
       scope: 'board',
-      target: `${businessCode}+${channel}`,
+      target,
       // target: `dine_in+pos`,
       section_code: [...OPEN_DATA_SECTION_CODES]
     });
+    this.loadOpenDataInFlight = request;
     try {
-      const openDataConfig = await this.loadOpenDataConfigInFlight;
-      this.otherParams.openData = openDataConfig;
+      const openDataConfig = await request;
+      // clearOpenDataCache() 或新请求已接管时，旧响应只能返回给原调用方，不能复活缓存归属。
+      if (this.loadOpenDataInFlight === request) {
+        this.openDataTarget = target;
+        this.otherParams.openData = openDataConfig;
+      }
       return openDataConfig;
     } finally {
-      this.loadOpenDataConfigInFlight = null;
+      if (this.loadOpenDataInFlight === request) {
+        this.loadOpenDataInFlight = null;
+        this.loadOpenDataInFlightTarget = null;
+      }
     }
   }
   async getOpenData() {
     return this.loadOpenDataConfig();
   }
+  async getInvoiceLayoutConfig() {
+    const openData = await this.loadOpenDataConfig();
+    if (!openData) return (0, _OpenData.getDefaultInvoiceLayoutConfig)();
+    return this.store.openData.getInvoiceLayoutConfig();
+  }
+  async getInvoiceTemplateSettings() {
+    const openData = await this.loadOpenDataConfig();
+    if (!openData) return (0, _OpenData.getDefaultInvoiceTemplateSettings)();
+    return this.store.openData.getInvoiceTemplateSettings();
+  }
+  isInvoiceOpenDataCacheCurrent() {
+    const businessCode = this.getBookingTicketBusinessCode();
+    const channel = this.getSubmitOrderSalesChannel();
+    if (!businessCode || !channel) return false;
+    return this.openDataTarget === `${businessCode}+${channel}`;
+  }
 
   /** 清除店铺级 OpenData；下一次 getOpenData 时会重新拉取。 */
   clearOpenDataCache() {
-    this.loadOpenDataConfigInFlight = null;
+    this.loadOpenDataInFlight = null;
+    this.loadOpenDataInFlightTarget = null;
+    this.openDataTarget = null;
     this.otherParams.openData = null;
     this.store.openData?.clearCache();
   }
@@ -1743,6 +1786,8 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
     });
     if (params?.businessCode !== undefined || params?.business_code !== undefined) {
       await this.configureIdGeneratorFromOpenData();
+    } else if (params?.channel !== undefined) {
+      await this.loadOpenDataConfig();
     }
   }
   getDeviceTaskPlugin() {

package/lib/solution/BookingTicket/utils/addProductDecision.js

@@ -358,6 +358,7 @@ function buildBasePayloadFromCacheItem(cacheItem, ctx) {
     bundle_edit: extend?.bundle_edit,
     discount_reason: extend?.discount_reason,
     discount_list: cacheItem?.discount_list,
+    selected_settlement_snapshot: cacheItem?.metadata?.selected_settlement_snapshot ?? extend?.metadata?.selected_settlement_snapshot,
     _extend: extend
   };
 }

package/lib/solution/BookingTicket/utils/orderCustomer.js

@@ -23,7 +23,8 @@ function resolveCustomerDisplayName(customer) {
 
 /** 将 ICustomer 格式化为写入 tempOrder 的协议字段。 */
 function formatOrderCustomerPatch(customer) {
-  const rawId = customer.id;
+  const c = customer;
+  const rawId = c.customer_id ?? c.customerId ?? customer.id;
   const numericId = typeof rawId === 'number' ? rawId : rawId !== undefined && rawId !== null && rawId !== '' ? Number(rawId) : null;
   return {
     customer_id: Number.isFinite(numericId) ? numericId : null,

package/lib/solution/RegisterAndLogin/config.d.ts

@@ -10,7 +10,11 @@ export interface ApiConfig {
     method: 'GET' | 'POST' | 'PUT' | 'DELETE';
     transformParams?: (params: any) => any;
     transformResponse?: (response: any) => any;
-    options?: Record<string, any>;
+    options?: Record<string, any> | ((params: any) => Record<string, any>);
+}
+export interface ApiCallerOptions {
+    baseUrl?: string;
+    shopDomain?: string;
 }
 /**
  * 渠道配置接口
@@ -65,12 +69,14 @@ export declare function getChannelConfig(channel: string): ChannelConfig;
 export declare class ApiCaller {
     private request;
     private config;
+    private options;
     constructor(request: {
         get: <T = any>(url: string, data?: any, options?: any) => Promise<T>;
         post: <T = any>(url: string, data?: any, options?: any) => Promise<T>;
         put: <T = any>(url: string, data?: any, options?: any) => Promise<T>;
         delete: <T = any>(url: string, options?: any) => Promise<T>;
-    }, config: ChannelConfig);
+    }, config: ChannelConfig, options?: ApiCallerOptions);
+    private resolveUrl;
     /**
      * 执行 API 调用
      */
@@ -84,4 +90,4 @@ export declare function createApiCaller(request: {
     post: <T = any>(url: string, data?: any, options?: any) => Promise<T>;
     put: <T = any>(url: string, data?: any, options?: any) => Promise<T>;
     delete: <T = any>(url: string, options?: any) => Promise<T>;
-}, channel: string): ApiCaller;
+}, channel: string, options?: ApiCallerOptions): ApiCaller;

package/lib/solution/RegisterAndLogin/config.js

@@ -15,6 +15,8 @@ exports.getChannelConfig = getChannelConfig;
  * API 配置接口
  */
 
+const h5CustomerAuthApiNames = new Set(['sendEmailVerificationCode', 'sendEmailLoginCode', 'sendSmsRegisterCode', 'sendEmailRegisterLink', 'verifyEmailRegistrationLink', 'emailPasswordLogin', 'emailCodeRegister', 'phoneCodeRegister', 'resendEmailRegisterLink', 'checkEmailLinkCode', 'sendSmsLoginCode', 'phoneCodeLogin', 'guestLogin', 'checkEmailExists', 'checkEmailCode', 'checkMobileCode', 'phonePasswordLogin', 'sendPasswordResetEmail', 'sendPasswordResetSms', 'sendResetPasswordLink', 'checkResetPasswordCode', 'resetPasswordByCode', 'resetPasswordByEmail', 'resetPasswordByPhone', 'verifyCode', 'register', 'login', 'oauthLogin', 'facebookLogin', 'appleLogin']);
+
 /**
  * 渠道配置接口
  */
@@ -278,6 +280,31 @@ const onlineStoreConfig = {
     })
   }
 };
+function withH5AuthPrefix(config) {
+  const nextConfig = {};
+  Object.entries(config).forEach(([key, apiConfig]) => {
+    if (!apiConfig.url.startsWith('/auth/')) {
+      nextConfig[key] = apiConfig;
+      return;
+    }
+    nextConfig[key] = {
+      ...apiConfig,
+      url: apiConfig.url.startsWith('/h5/') ? apiConfig.url : `/h5${apiConfig.url}`,
+      options: params => {
+        const {
+          withCredentials,
+          ...baseOptions
+        } = (typeof apiConfig.options === 'function' ? apiConfig.options(params) : apiConfig.options) || {};
+        return {
+          ...baseOptions,
+          prefix: false
+        };
+      }
+    };
+  });
+  return nextConfig;
+}
+const h5OnlineStoreConfig = withH5AuthPrefix(onlineStoreConfig);
 
 /**
  * 默认配置（通用配置）
@@ -1066,6 +1093,7 @@ const shopWebposConfig = {
  */
 const channelConfigMap = exports.channelConfigMap = {
   'online-store': onlineStoreConfig,
+  'online-store-h5': h5OnlineStoreConfig,
   'default': defaultConfig,
   'webpos': webposConfig,
   'shop.webpos': shopWebposConfig
@@ -1083,9 +1111,16 @@ function getChannelConfig(channel) {
  * 负责根据配置执行 API 调用
  */
 class ApiCaller {
-  constructor(request, config) {
+  constructor(request, config, options = {}) {
     this.request = request;
     this.config = config;
+    this.options = options;
+  }
+  resolveUrl(url) {
+    if (!this.options.baseUrl || !url.startsWith('/h5/auth/')) {
+      return url;
+    }
+    return `${this.options.baseUrl.replace(/\/$/, '')}${url}`;
   }
 
   /**
@@ -1111,6 +1146,12 @@ class ApiCaller {
       ...options,
       ...additionalOptions
     };
+    if (apiConfig.url.startsWith('/h5/auth/') && h5CustomerAuthApiNames.has(apiName)) {
+      requestOptions.h5CustomerAuth = true;
+      if (this.options.shopDomain) {
+        requestOptions.h5AuthShopDomain = this.options.shopDomain;
+      }
+    }
 
     // 处理动态 headers
     if (requestOptions.headers && typeof requestOptions.headers === 'function') {
@@ -1123,19 +1164,19 @@ class ApiCaller {
     switch (apiConfig.method) {
       case 'GET':
         if (transformedParams && Object.keys(transformedParams).length > 0) {
-          response = await this.request.get(apiConfig.url, transformedParams, requestOptions);
+          response = await this.request.get(this.resolveUrl(apiConfig.url), transformedParams, requestOptions);
         } else {
-          response = await this.request.get(apiConfig.url, undefined, requestOptions);
+          response = await this.request.get(this.resolveUrl(apiConfig.url), undefined, requestOptions);
         }
         break;
       case 'POST':
-        response = await this.request.post(apiConfig.url, transformedParams, requestOptions);
+        response = await this.request.post(this.resolveUrl(apiConfig.url), transformedParams, requestOptions);
         break;
       case 'PUT':
-        response = await this.request.put(apiConfig.url, transformedParams, requestOptions);
+        response = await this.request.put(this.resolveUrl(apiConfig.url), transformedParams, requestOptions);
         break;
       case 'DELETE':
-        response = await this.request.delete(apiConfig.url, requestOptions);
+        response = await this.request.delete(this.resolveUrl(apiConfig.url), requestOptions);
         break;
       default:
         throw new Error(`不支持的 HTTP 方法: ${apiConfig.method}`);
@@ -1150,7 +1191,7 @@ class ApiCaller {
  * 创建 API 调用器
  */
 exports.ApiCaller = ApiCaller;
-function createApiCaller(request, channel) {
+function createApiCaller(request, channel, options) {
   const config = getChannelConfig(channel);
-  return new ApiCaller(request, config);
+  return new ApiCaller(request, config, options);
 }

package/lib/solution/RegisterAndLogin/index.js

@@ -227,7 +227,10 @@ class RegisterAndLoginImpl extends _BaseModule.BaseModule {
     }
 
     // 创建 API 调用器
-    this.apiCaller = (0, _config.createApiCaller)(this.request, this.channel);
+    this.apiCaller = (0, _config.createApiCaller)(this.request, this.channel, {
+      baseUrl: this.otherParams.h5AuthBaseUrl,
+      shopDomain: this.otherParams.h5AuthShopDomain
+    });
 
     // 尝试从本地存储恢复登录状态
     await this.restoreLoginState();

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

@@ -2,7 +2,7 @@ import dayjs from 'dayjs';
 import { Module, ModuleOptions, PisellCore } from '../../types';
 import { BaseModule } from '../../modules/BaseModule';
 import type { RequestPlugin } from '../../plugins/request';
-import { SalesState, SalesModuleAPI, Reservation, SalesResourceBookingItem, SalesResourceBookingItemWithGroups, SalesTimelineHighlights, ChangeBookingStatusParams, GetResourceBookingItemParams } from './types';
+import { SalesState, SalesModuleAPI, Reservation, SalesResourceBookingItem, SalesResourceBookingItemWithGroups, SalesTimelineHighlights, ChangeBookingStatusParams, GetResourceBookingItemParams, SalesPrintLocalOrderReceiptOptions } from './types';
 import type { BookingData } from '../../server/modules/order/types';
 export * from './types';
 /**
@@ -26,6 +26,10 @@ export declare class SalesImpl extends BaseModule implements Module, SalesModule
     protected otherParams: Record<string, any>;
     protected request: RequestPlugin;
     private logger;
+    private invoiceOpenDataModule;
+    private invoiceOpenDataTarget;
+    private invoiceOpenDataInFlight;
+    private invoiceOpenDataInFlightTarget;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
     /** 获取当前 store 快照 */
@@ -42,6 +46,17 @@ export declare class SalesImpl extends BaseModule implements Module, SalesModule
     resetReservationList(): Reservation[];
     cancelOrder(orderIds: Array<number | string>): Promise<any>;
     changeBookingStatus(params: ChangeBookingStatusParams): Promise<any>;
+    /**
+     * 将显式 channel 或当前运行上下文归一为 Invoice OpenData 使用的销售入口。
+     * Legacy Sales 的系统上下文没有可打印的 system target，因此统一回退 pos。
+     */
+    private getInvoiceSalesChannel;
+    private loadInvoiceOpenData;
+    private logInvoiceOpenDataFallback;
+    private resolveInvoiceConfigs;
+    printLocalOrderReceipt<T = any>(lookup: string | number, options: SalesPrintLocalOrderReceiptOptions): Promise<T>;
+    /** 清除独立 Documents 缓存；下一次打印会按当前 target 重新获取。 */
+    clearOpenDataCache(): void;
     destroy(): Promise<void>;
     /**
      * 时间轴粒度（分钟）