@pisell/pisellos 2.2.301 → 2.2.303

package/lib/server/modules/order/types.d.ts

@@ -75,6 +75,10 @@ export interface OrderProductBundleItem {
     extension_type?: string;
     /** 选项 */
     option?: unknown[];
+    /** 套餐子商品备注快照 */
+    note?: string | Record<string, unknown> | null;
+    /** 兼容已经规范化的商品备注字段 */
+    product_note?: string | Record<string, unknown> | null;
 }
 /** 商品行 metadata，常含 unique_identification_number */
 export interface OrderProductMetadata {
@@ -108,6 +112,10 @@ export interface OrderProductLineItem {
     product_title?: OrderProductTitleSnapshot | string | null;
     /** 商品封面图 */
     product_cover?: string | null;
+    /** 商品备注快照 */
+    note?: string | Record<string, unknown> | null;
+    /** 兼容已经规范化的商品备注字段 */
+    product_note?: string | Record<string, unknown> | null;
     /** 多规格 ID。来源：Detail.product_variant_id */
     product_variant_id?: number;
     /**
@@ -262,6 +270,23 @@ export interface OrderPaymentItem {
     /** 元数据；三方支付成功后可含 unique_payment_number */
     metadata?: OrderPaymentMetadata | null;
 }
+/** 订单退款记录（仅使用真实退款记录构造退款历史） */
+export interface OrderRefundItem {
+    order_refund_id?: number | string;
+    refund_number?: string;
+    order_payment_id?: number | string;
+    payment_id?: number | string;
+    amount?: OrderMoneyString | number;
+    refund_amount?: OrderMoneyString | number;
+    total_amount?: OrderMoneyString | number;
+    status?: string;
+    refund_time?: string | null;
+    refunded_at?: string | null;
+    created_at?: string | null;
+    updated_at?: string | null;
+    payment?: Partial<OrderPaymentItem> & Record<string, unknown>;
+    [key: string]: unknown;
+}
 /**
  * 订单附加费（3.6 surcharges）
  */
@@ -284,6 +309,8 @@ export interface OrderSurchargeItem {
     amount: OrderMoneyString;
 }
 export interface OrderSummary {
+    /** 兼容部分历史详情把支付状态放在 summary 中 */
+    payment_status?: OrderPaymentStatus;
     /** 商品总数量。来源：Order.product_quantity */
     product_quantity?: number;
     /** 商品原价总额。来源：Order.product_original_amount */
@@ -316,6 +343,16 @@ export interface OrderSummary {
     rounding_amount?: OrderMoneyString;
     /** 支付手续费。来源：Order.pay_service_charge_amount */
     pay_service_charge_amount?: OrderMoneyString;
+    /** 已应用到订单的支付金额。来源：Order.order_paid_amount */
+    order_paid_amount?: OrderMoneyString;
+    /** 顾客实际支付金额。来源：Order.customer_paid_amount */
+    customer_paid_amount?: OrderMoneyString;
+    /** 已退款总金额。来源：Order.total_refund_amount */
+    total_refund_amount?: OrderMoneyString;
+    /** 税种名称。来源：Order.tax_title */
+    tax_title?: string;
+    /** 是否含税 0/1。来源：Order.is_price_include_tax */
+    is_price_include_tax?: 0 | 1;
 }
 /**
  * 订单数据结构（Server 侧对齐《统一 Sales 数据协议》）
@@ -395,6 +432,8 @@ export interface OrderData {
     bookings?: OrderBookingItem[];
     /** 支付数组 */
     payments?: OrderPaymentItem[];
+    /** 真实退款记录数组 */
+    refunds?: OrderRefundItem[];
     /** 附加费数组 */
     surcharges?: OrderSurchargeItem[];
     /** 整单/订单级折扣列表（结构与 3.3.1 商品折扣项一致时可复用） */
@@ -407,6 +446,17 @@ export interface OrderData {
     contacts_info?: unknown[];
     /** 订单级主体参数 */
     holder?: Record<string, unknown> | null;
+    /** 订单前端扩展快照 */
+    order_meta_list?: {
+        point_cards_snapshot?: Array<{
+            id: number | string;
+            tag: 'point_card';
+            product_id?: number | string;
+            product_name: string;
+            par_value: string;
+            used_par_value: string;
+        }>;
+    };
     /**
      * 金额汇总（仅输出）。
      * 由服务端 OrderV2Service::computeOrderSummaryData() 生成；离线可按同算法本地计算。

package/lib/server/modules/order/types.js

@@ -60,6 +60,7 @@ exports.OrderHooks = void 0;
 /**
  * 支付记录（3.5 payments）
  */
+/** 订单退款记录（仅使用真实退款记录构造退款历史） */
 // ─────────────────────────────────────────────────────────────────
 // 3.6 surcharges
 // ─────────────────────────────────────────────────────────────────

package/lib/server/utils/small-ticket.d.ts

@@ -10,6 +10,7 @@ export interface SmallTicketShopInfo {
     zip?: string;
     tax_number?: string;
     tax_title?: string;
+    is_price_include_tax?: 0 | 1 | boolean;
     currency_symbol?: string;
     currency_code?: string;
     primary_locale?: string;
@@ -33,10 +34,12 @@ export interface SmallTicketProduct {
     product_quantity: number;
     selling_price: string;
     original_price: string;
+    base_price?: string;
     total_original_price: string;
     extension_list: any[];
     product_uid?: string | number;
     booking_uid?: string | number;
+    product_note?: string;
     options?: Array<{
         name: string;
         num?: number;
@@ -71,7 +74,7 @@ export interface SmallTicketLocaleData {
     wallets: SmallTicketItem[][];
     tickets: any[];
     source_shop: any[];
-    refund_data: any[];
+    refund_data: SmallTicketItem[][];
     expend_data: any[];
 }
 export type SmallTicketData = Record<string, SmallTicketLocaleData>;