@pisell/pisellos 0.10.28 → 0.10.29

package/lib/server/utils/small-ticket.js

@@ -22,9 +22,12 @@ const LABELS = {
     pickUpTime: 'Pick-up time',
     asap: 'ASAP',
     cash: 'Cash',
+    cashReceived: 'Cash received',
+    changeDue: 'Change due',
     eftpos: 'Eftpos',
     wallet: 'Wallet',
     giftCard: 'Gift card',
+    balance: 'Balance',
     remainingAmount: 'Remaining amount',
     redeemPoints: 'Redeem points',
     remainingPoints: 'Remaining points',
@@ -32,9 +35,12 @@ const LABELS = {
     orderDiscount: 'Order discount',
     manualDiscount: 'Manual discount',
     payProcessingFee: 'Pay processing fee',
+    surchargeIncluded: 'Surcharge(Included)',
     rounding: 'Rounding',
     gross: 'Gross',
-    tare: 'Tare'
+    tare: 'Tare',
+    handoverTime: 'Handover time',
+    refund: 'Refund'
   },
   zh_CN: {
     contactName: '联系人姓名',
@@ -48,9 +54,12 @@ const LABELS = {
     pickUpTime: '取餐时间',
     asap: '尽快',
     cash: '现金支付',
+    cashReceived: '收取现金',
+    changeDue: '找零',
     eftpos: '刷卡支付',
     wallet: '钱包支付',
     giftCard: '礼品卡',
+    balance: '余额',
     remainingAmount: '剩余金额',
     redeemPoints: '本次使用积分',
     remainingPoints: '剩余积分',
@@ -58,9 +67,12 @@ const LABELS = {
     orderDiscount: '整单折扣',
     manualDiscount: '手动折扣',
     payProcessingFee: '支付手续费',
+    surchargeIncluded: '手续费(已含)',
     rounding: '抹零',
     gross: '重量',
-    tare: '去皮'
+    tare: '去皮',
+    handoverTime: '交付时间',
+    refund: '退款'
   },
   zh_HK: {
     contactName: '聯絡人姓名',
@@ -74,9 +86,12 @@ const LABELS = {
     pickUpTime: '取餐時間',
     asap: '盡快',
     cash: '現金支付',
+    cashReceived: '收取現金',
+    changeDue: '找零',
     eftpos: '刷卡支付',
     wallet: '錢包支付',
     giftCard: '禮品卡',
+    balance: '餘額',
     remainingAmount: '剩餘金額',
     redeemPoints: '本次使用積分',
     remainingPoints: '剩餘積分',
@@ -84,9 +99,12 @@ const LABELS = {
     orderDiscount: '整單折扣',
     manualDiscount: '手動折扣',
     payProcessingFee: '支付手續費',
+    surchargeIncluded: '手續費(已含)',
     rounding: '抹零',
     gross: '重量',
-    tare: '去皮'
+    tare: '去皮',
+    handoverTime: '交付時間',
+    refund: '退款'
   },
   ja: {
     contactName: '連絡先名',
@@ -103,6 +121,7 @@ const LABELS = {
     eftpos: 'カード',
     wallet: 'ウォレット',
     giftCard: 'ギフトカード',
+    balance: '残高',
     remainingAmount: '残高',
     redeemPoints: '利用ポイント',
     remainingPoints: '残りポイント',
@@ -112,7 +131,11 @@ const LABELS = {
     payProcessingFee: '決済手数料',
     rounding: '端数調整',
     gross: '総重量',
-    tare: '風袋'
+    tare: '風袋',
+    handoverTime: '受け渡し時間',
+    refund: '返金',
+    cashReceived: 'お預かり',
+    changeDue: 'お釣り'
   },
   pt: {
     contactName: 'Nome de contato',
@@ -129,6 +152,7 @@ const LABELS = {
     eftpos: 'Cartão',
     wallet: 'Carteira',
     giftCard: 'Cartão-presente',
+    balance: 'Saldo',
     remainingAmount: 'Saldo restante',
     redeemPoints: 'Pontos utilizados',
     remainingPoints: 'Pontos restantes',
@@ -138,7 +162,11 @@ const LABELS = {
     payProcessingFee: 'Taxa de processamento',
     rounding: 'Arredondamento',
     gross: 'Peso bruto',
-    tare: 'Tara'
+    tare: 'Tara',
+    handoverTime: 'Hora de entrega',
+    refund: 'Reembolso',
+    cashReceived: 'Dinheiro recebido',
+    changeDue: 'Troco'
   }
 };
 function buildSmallTicketData(params) {
@@ -169,11 +197,15 @@ function buildLocaleData(params) {
   const products = buildProducts(order, locale, productMap);
   const summary = getSummary(order);
   const currencySymbol = getCurrencySymbol(order, shopInfo);
+  const financials = resolveReceiptFinancials(order, summary);
+  const delivery = buildDelivery(order, locale);
   return {
     base_data: buildBaseData({
       order,
       shopInfo,
-      locale
+      locale,
+      currencySymbol,
+      financials
     }),
     products,
     fees: buildFees({
@@ -182,11 +214,14 @@ function buildLocaleData(params) {
       locale,
       products,
       summary,
-      currencySymbol
+      currencySymbol,
+      financials
     }),
     customer: buildCustomer(order, locale),
     appointment: buildAppointment(order, locale),
-    // delivery: buildDelivery(order, locale),
+    ...(delivery.length ? {
+      delivery
+    } : {}),
     resources: buildResources(order, locale),
     payment_data: buildPaymentData({
       order,
@@ -200,7 +235,11 @@ function buildLocaleData(params) {
     }),
     tickets: Array.isArray(order.tickets) ? order.tickets : [],
     source_shop: [],
-    refund_data: [],
+    refund_data: buildRefundData({
+      order,
+      locale,
+      currencySymbol
+    }),
     expend_data: []
   };
 }
@@ -208,7 +247,9 @@ function buildBaseData(params) {
   const {
     order,
     shopInfo,
-    locale
+    locale,
+    currencySymbol,
+    financials
   } = params;
   const orderNumber = stringify(order.buzzer || order.shop_full_order_number);
   return {
@@ -219,7 +260,13 @@ function buildBaseData(params) {
     shop_tax_number: stringify(shopInfo.tax_number || order.shop_tax_number),
     shop_phone: stringify(shopInfo.phone || order.shop_phone),
     shop_address: stringify(shopInfo.receipt_address || shopInfo.address || buildShopAddress(shopInfo) || order.shop_address),
-    original_payment_status: stringify(order.payment_status),
+    original_payment_status: financials.paymentStatus,
+    payment_status: financials.paymentStatus,
+    total_amount: formatMoney(financials.totalAmount, currencySymbol),
+    has_pay: formatMoney(financials.netPaymentApplied, currencySymbol),
+    ...(isPresentId(financials.amountGap) ? {
+      amount_gap: formatMoney(financials.amountGap, currencySymbol)
+    } : {}),
     is_repeat: 0,
     buzzer: stringify(order.buzzer || order.pickup_number || order.metadata?.buzzer),
     order_no: orderNumber,
@@ -269,11 +316,16 @@ function buildProducts(order, locale, productMap) {
       quantity,
       originalPrice
     });
+    const productNote = resolveProductNote(product, locale);
+    const basePrice = resolveProductBasePrice(product);
     return {
       product_title: productTitle,
       product_quantity: quantity,
       selling_price: formatMoney(sellingPrice, currencySymbol),
       original_price: formatMoney(originalPrice, currencySymbol),
+      ...(isPresentId(basePrice) ? {
+        base_price: formatMoney(basePrice, currencySymbol)
+      } : {}),
       total_original_price: formatMoney(new _decimal.default(toMoneyNumber(originalPrice)).mul(quantity), currencySymbol),
       extension_list: extensionList,
       ...(isPresentId(productUid) ? {
@@ -282,20 +334,31 @@ function buildProducts(order, locale, productMap) {
       ...(isPresentId(bookingUid) ? {
         booking_uid: bookingUid
       } : {}),
+      ...(productNote ? {
+        product_note: productNote
+      } : {}),
       ...(options.length ? {
         options
       } : {}),
       ...(resolvedVariant ? {
         variant: resolvedVariant
       } : {}),
-      ...(Array.isArray(product.combinations) ? {
-        combinations: product.combinations
+      ...(Array.isArray(product.combinations) && product.combinations.length ? {
+        combinations: normalizeExistingCombinations(product.combinations, locale)
       } : combinations.length ? {
         combinations
       } : {})
     };
   });
 }
+function resolveProductBasePrice(product) {
+  const metadata = product.metadata || {};
+  const origin = product._origin || metadata.origin || {};
+  const variantId = product.product_variant_id ?? product.variant_id;
+  const variant = Array.isArray(origin.variant) && isPresentId(variantId) ? origin.variant.find(item => isSameId(item?.id, variantId)) : undefined;
+  const isV2 = metadata.price_schema_version === 2 || metadata.price_schema_version === '2';
+  return firstPresentValue(metadata.source_product_price, variant?.price, product._origin?.price, product._origin?.base_price, !isV2 ? metadata.main_product_original_price : undefined, product.base_price, product.price);
+}
 function normalizeProductDiscounts(params) {
   const {
     product,
@@ -463,15 +526,50 @@ function normalizeProductCombinations(params) {
       locale,
       parentProduct
     });
-    const optionTitle = buildOptionTitleSuffix(combinationsOptions);
+    const productNote = resolveProductNote(bundle, locale);
+    const nestedCombinations = Array.isArray(bundle.combinations) ? normalizeExistingCombinations(bundle.combinations, locale) : [];
     return {
-      product_title: `${baseTitle}${optionTitle}`,
+      product_title: baseTitle,
       product_quantity: toNumber(bundle.num ?? bundle.quantity ?? 1, 1),
       price: formatBundlePrice(bundle, currencySymbol),
-      combinations_options: combinationsOptions
+      combinations_options: combinationsOptions,
+      ...(productNote ? {
+        product_note: productNote
+      } : {}),
+      ...(nestedCombinations.length ? {
+        combinations: nestedCombinations
+      } : {})
+    };
+  });
+}
+function normalizeExistingCombinations(combinations, locale) {
+  return combinations.map(combination => {
+    if (!combination || typeof combination !== 'object' || Array.isArray(combination)) {
+      return combination;
+    }
+    const productNote = resolveProductNote(combination, locale);
+    const nestedCombinations = Array.isArray(combination.combinations) ? normalizeExistingCombinations(combination.combinations, locale) : undefined;
+    const snapshot = {
+      ...combination
+    };
+    delete snapshot.product_note;
+    delete snapshot.note;
+    return {
+      ...snapshot,
+      ...(productNote ? {
+        product_note: productNote
+      } : {}),
+      ...(nestedCombinations ? {
+        combinations: nestedCombinations
+      } : {})
     };
   });
 }
+function resolveProductNote(product, locale) {
+  const productNote = getLocalizedValue(product.product_note, locale).trim();
+  if (productNote) return productNote;
+  return getLocalizedValue(product.note, locale).trim();
+}
 function resolveBundleProductTitle(params) {
   const {
     bundle,
@@ -654,15 +752,6 @@ function isSameId(left, right) {
   if (!isPresentId(left) || !isPresentId(right)) return false;
   return String(left) === String(right);
 }
-function buildOptionTitleSuffix(options) {
-  const text = options.map(option => {
-    const name = stringify(option.name).trim();
-    if (!name) return '';
-    const quantity = option.num ?? 1;
-    return `${name} x ${quantity}`;
-  }).filter(Boolean).join(', ');
-  return text ? `(${text})` : '';
-}
 function formatBundlePrice(bundle, currencySymbol) {
   const value = bundle.bundle_selling_price ?? bundle.bundle_sum_price ?? bundle.price ?? 0;
   const amount = new _decimal.default(toMoneyNumber(value));
@@ -678,7 +767,8 @@ function buildFees(params) {
     locale,
     products,
     summary,
-    currencySymbol
+    currencySymbol,
+    financials
   } = params;
   const fees = [];
   for (const surcharge of normalizeArray(order.surcharges || summary.surcharges)) {
@@ -689,64 +779,101 @@ function buildFees(params) {
       value: formatMoney(value, currencySymbol)
     });
   }
-  const discountAmount = order.shop_discount ?? summary.discount_amount ?? order.discount_amount;
+  const discountAmount = firstPresentValue(order.shop_discount, summary.discount_amount, order.discount_amount);
   if (isNonZero(discountAmount)) {
     fees.push({
       item: label(locale, 'orderDiscount'),
       value: formatNegativeMoney(discountAmount, currencySymbol)
     });
   }
-  const taxFee = summary.tax_fee || order.tax_fee;
-  if (isNonZero(taxFee)) {
-    fees.push({
-      item: stringify(summary.tax_title || order.tax_title || shopInfo.tax_title),
-      value: formatMoney(taxFee, currencySymbol)
-    });
-  }
-  const roundingAmount = summary.rounding_amount || order.rounding_amount;
+  const taxFee = firstPresentValue(summary.tax_fee, order.tax_fee);
+  const taxTitle = resolveTaxTitle({
+    summary,
+    order,
+    shopInfo,
+    locale
+  });
+  const isPriceIncludeTax = firstPresentValue(summary.is_price_include_tax, order.is_price_include_tax, shopInfo.is_price_include_tax);
+  const roundingAmount = firstPresentValue(summary.rounding_amount, order.rounding_amount);
   if (isNonZero(roundingAmount)) {
     fees.push({
       item: label(locale, 'rounding'),
       value: formatMoney(roundingAmount, currencySymbol)
     });
   }
-  const payProcessingFee = summary.pay_service_charge_amount || order.pay_service_charge_amount;
+  const payProcessingFee = financials.payProcessingFee;
   if (isNonZero(payProcessingFee)) {
     fees.push({
       item: label(locale, 'payProcessingFee'),
       value: formatMoney(payProcessingFee, currencySymbol)
     });
   }
-  const productExpectAmount = summary.product_expect_amount || summary.product_amount || order.product_expect_amount;
+  const productExpectAmount = firstPresentValue(summary.product_expect_amount, summary.product_amount, order.product_expect_amount);
   const productOriginalAmount = firstPresentValue(summary.product_original_amount, order.product_original_amount) ?? calculateProductOriginalAmount(order);
   const totalSavingsAmount = new _decimal.default(toMoneyNumber(productOriginalAmount)).minus(toMoneyNumber(productExpectAmount)).plus(toMoneyNumber(discountAmount));
   return {
     fees,
     countFee: {
-      total_amount: formatMoney(summary.total_amount || order.total_amount, currencySymbol),
+      total_amount: formatMoney(firstPresentValue(summary.total_amount, order.total_amount) ?? 0, currencySymbol),
       original_item_amount: formatMoney(productOriginalAmount, currencySymbol),
-      product_expect_amount: formatMoney(productExpectAmount, currencySymbol),
-      expect_amount: formatMoney(summary.expect_amount || order.expect_amount || summary.total_amount || order.total_amount, currencySymbol),
-      product_quantity: toNumber(summary.product_quantity || products.reduce((sum, product) => sum + product.product_quantity, 0), 0),
-      has_pay: formatMoney(calculateReceiptPaidAmount(order, summary), currencySymbol),
+      product_expect_amount: formatMoney(productExpectAmount ?? 0, currencySymbol),
+      expect_amount: formatMoney(financials.totalAmount, currencySymbol),
+      product_quantity: toNumber(firstPresentValue(summary.product_quantity, products.reduce((sum, product) => sum + product.product_quantity, 0)), 0),
+      has_pay: formatMoney(financials.orderPaidAmount, currencySymbol),
       payment_method: '',
-      tax_title: stringify(summary.tax_title || order.tax_title || shopInfo.tax_title),
-      total_refund_amount: formatMoney(summary.total_refund_amount || order.total_refund_amount, currencySymbol),
-      ...(isNonZero(roundingAmount) ? {
+      tax_title: taxTitle,
+      total_refund_amount: formatMoney(financials.totalRefundAmount, currencySymbol),
+      customer_paid_amount: formatMoney(financials.customerPaidAmount, currencySymbol),
+      net_payment_applied: formatMoney(financials.netPaymentApplied, currencySymbol),
+      ...(isPresentId(roundingAmount) ? {
         rounding_amount: formatMoney(roundingAmount, currencySymbol)
       } : {}),
       ...(isNonZero(totalSavingsAmount) ? {
         order_total_discount: formatMoney(totalSavingsAmount, currencySymbol)
       } : {}),
-      ...(isNonZero(payProcessingFee) ? {
+      ...(financials.hasPayProcessingFee ? {
         pay_processing_fee: formatMoney(payProcessingFee, currencySymbol)
       } : {}),
-      ...(isNonZero(taxFee) ? {
+      ...(isPresentId(taxFee) ? {
         tax_fee: formatMoney(taxFee, currencySymbol)
+      } : {}),
+      ...(isPresentId(isPriceIncludeTax) ? {
+        is_price_include_tax: normalizeBooleanFlag(isPriceIncludeTax)
       } : {})
     }
   };
 }
+function resolveReceiptFinancials(order, summary) {
+  const totalAmount = firstPresentValue(summary.expect_amount, order.expect_amount, summary.total_amount, order.total_amount) ?? 0;
+  const rawPayProcessingFee = firstPresentValue(summary.pay_service_charge_amount, order.pay_service_charge_amount);
+  const payProcessingFee = rawPayProcessingFee ?? 0;
+  const orderPaidAmount = firstPresentValue(summary.order_paid_amount, order.order_paid_amount, sumAppliedPayments(order.payments)) ?? 0;
+  const totalRefundAmount = firstPresentValue(summary.total_refund_amount, order.total_refund_amount) ?? 0;
+  const netPaymentApplied = _decimal.default.max(new _decimal.default(toMoneyNumber(orderPaidAmount)).minus(toMoneyNumber(totalRefundAmount)), 0);
+  const fallbackCustomerPaidAmount = _decimal.default.max(sumCustomerPaidPayments(order.payments), new _decimal.default(toMoneyNumber(orderPaidAmount)).plus(toMoneyNumber(payProcessingFee)));
+  const customerPaidAmount = firstPresentValue(summary.customer_paid_amount, order.customer_paid_amount, fallbackCustomerPaidAmount) ?? 0;
+  const amountGap = firstPresentValue(summary.amount_gap, order.amount_gap);
+  return {
+    totalAmount,
+    orderPaidAmount,
+    payProcessingFee,
+    customerPaidAmount,
+    totalRefundAmount,
+    netPaymentApplied,
+    amountGap,
+    paymentStatus: resolveReceiptPaymentStatus({
+      order,
+      summary
+    }),
+    hasPayProcessingFee: isPresentId(rawPayProcessingFee)
+  };
+}
+function resolveReceiptPaymentStatus(params) {
+  return [params.order.payment_status, params.summary.payment_status, params.order.original_payment_status].map(status => stringify(status).trim()).find(Boolean) || '';
+}
+function resolveTaxTitle(params) {
+  return [params.summary.tax_title, params.order.tax_title, params.shopInfo.tax_title].map(title => getLocalizedValue(title, params.locale).trim()).find(Boolean) || 'Tax';
+}
 function calculateProductOriginalAmount(order) {
   return normalizeArray(order.products).reduce((total, product) => {
     const quantity = toNumber(product.product_quantity ?? product.quantity ?? product.num ?? 1, 1);
@@ -773,25 +900,27 @@ function normalizeCustomerDisplayValue(value) {
   return text;
 }
 function buildDelivery(order, locale) {
-  const serviceType = stringify(order.metadata?.service_type || order.service_type || order.delivery_type);
-  if (!serviceType) return [];
-  const serviceTypeLabelKey = serviceTypeToLabelKey(serviceType);
+  const deliveryType = stringify(order.delivery_type).trim();
+  const serviceType = deliveryType || stringify(firstPresentValue(order.metadata?.service_type, order.service_type)).trim();
+  const serviceTypeLabelKey = resolveServiceTypeLabelKey(serviceType, order);
+  if (!serviceTypeLabelKey) return [];
   const items = [{
     item: '',
     value: label(locale, serviceTypeLabelKey),
     size: 2,
     align: 'left'
   }];
-  if (serviceType === 'shop_server' || serviceType === 'shop_service') {
+  const handoverTime = firstPresentValue(order.handover_time, order.handover_at, order.pickup_time, order.pickup_at, order.scheduled_pickup_time, order.delivery_time, order.delivery_at, order.scheduled_delivery_time, order.fulfillment_time, order.fulfillment_at, order.metadata?.handover_time, order.metadata?.handover_at, order.metadata?.pickup_time, order.metadata?.pickup_at, order.metadata?.scheduled_pickup_time, order.metadata?.delivery_time, order.metadata?.delivery_at, order.metadata?.scheduled_delivery_time, order.metadata?.fulfillment_time, order.metadata?.fulfillment_at);
+  if (isPresentId(handoverTime)) {
     items.push({
-      item: label(locale, 'pickUpTime'),
-      value: label(locale, 'asap')
+      item: label(locale, 'handoverTime'),
+      value: formatDateTime(handoverTime, locale)
     });
   }
   return items;
 }
 function buildAppointment(order, locale) {
-  const bookings = normalizeArray(order.bookings);
+  const bookings = sortBookings(normalizeArray(order.bookings));
   if (bookings.length) {
     return bookings.map(booking => {
       const snapshot = {
@@ -819,6 +948,43 @@ function buildAppointment(order, locale) {
     value: getLocalizedValue(tableName, locale)
   }];
 }
+function sortBookings(bookings) {
+  return bookings.map((booking, index) => ({
+    booking,
+    index
+  })).sort((left, right) => {
+    const leftStart = bookingStartTimestamp(left.booking);
+    const rightStart = bookingStartTimestamp(right.booking);
+    if (leftStart !== rightStart) return leftStart < rightStart ? -1 : 1;
+    for (const field of ['booking_id', 'schedule_event_id']) {
+      const fieldOrder = compareOptionalValues(left.booking?.[field], right.booking?.[field]);
+      if (fieldOrder !== 0) return fieldOrder;
+    }
+    const bookingUidOrder = compareOptionalValues(firstPresentValue(left.booking?.metadata?.unique_identification_number, left.booking?.booking_uid), firstPresentValue(right.booking?.metadata?.unique_identification_number, right.booking?.booking_uid));
+    return bookingUidOrder || left.index - right.index;
+  }).map(({
+    booking
+  }) => booking);
+}
+function bookingStartTimestamp(booking) {
+  const startValues = [booking?.start_at, booking?.start_datetime, booking?.booking_time, isPresentId(booking?.start_date) ? `${booking.start_date} ${stringify(booking.start_time)}`.trim() : undefined];
+  for (const startValue of startValues) {
+    if (!isPresentId(startValue)) continue;
+    const timestamp = (0, _dayjs.default)(startValue).valueOf();
+    if (Number.isFinite(timestamp)) return timestamp;
+  }
+  return Number.POSITIVE_INFINITY;
+}
+function compareOptionalValues(left, right) {
+  const hasLeft = isPresentId(left);
+  const hasRight = isPresentId(right);
+  if (!hasLeft && !hasRight) return 0;
+  if (!hasLeft) return 1;
+  if (!hasRight) return -1;
+  return String(left).localeCompare(String(right), undefined, {
+    numeric: true
+  });
+}
 function buildResources(order, locale) {
   return normalizeArray(order.resources || order.resource_list).map(resource => ({
     id: resource.id || resource.resource_id || '',
@@ -836,13 +1002,151 @@ function buildPaymentData(params) {
     includeFundRecordBalance: false
   }));
 }
+function buildRefundData(params) {
+  const payments = normalizeArray(params.order.payments);
+  const refunds = Array.from(normalizeArray(params.order.refunds).reduce((result, refund, index) => {
+    const identity = refundIdentity(refund, index);
+    const candidate = {
+      refund,
+      index
+    };
+    const existing = result.get(identity);
+    if (!existing || shouldPreferRefundCandidate(candidate, existing)) {
+      result.set(identity, candidate);
+    }
+    return result;
+  }, new Map()).values()).filter(({
+    refund
+  }) => isPrintableRefund(refund)).sort((left, right) => {
+    const leftTime = refundTimestamp(left.refund);
+    const rightTime = refundTimestamp(right.refund);
+    if (leftTime !== rightTime) return leftTime < rightTime ? -1 : 1;
+    return left.index - right.index;
+  });
+  return refunds.map(({
+    refund
+  }) => {
+    const payment = resolveRefundPayment(refund, payments);
+    const methodName = paymentMethodName(payment, params.locale) || label(params.locale, 'refund');
+    const amount = firstPresentValue(refund.amount, refund.refund_amount, refund.total_amount) ?? 0;
+    const items = [{
+      item: methodName,
+      value: formatNegativeMoney(amount, params.currencySymbol)
+    }];
+    const occurredAt = firstPresentValue(refund.refund_time, refund.refunded_at, refund.created_at, refund.updated_at);
+    if (isPresentId(occurredAt)) {
+      items.push({
+        item: formatDateTime(occurredAt, params.locale),
+        value: ''
+      });
+    }
+    return items;
+  });
+}
+function refundIdentity(refund, index) {
+  if (isPresentId(refund.order_refund_id)) return `refund-id:${refund.order_refund_id}`;
+  if (isPresentId(refund.refund_number)) return `refund-number:${refund.refund_number}`;
+  return `refund-index:${index}`;
+}
+function shouldPreferRefundCandidate(candidate, existing) {
+  const candidatePrintable = isPrintableRefund(candidate.refund);
+  const existingPrintable = isPrintableRefund(existing.refund);
+  if (candidatePrintable !== existingPrintable) return candidatePrintable;
+  const candidateTime = refundFreshnessTimestamp(candidate.refund);
+  const existingTime = refundFreshnessTimestamp(existing.refund);
+  if (candidateTime !== existingTime) return candidateTime > existingTime;
+  return candidate.index > existing.index;
+}
+function refundFreshnessTimestamp(refund) {
+  const timestampValue = firstPresentValue(refund.updated_at, refund.refunded_at, refund.refund_time, refund.created_at);
+  if (!isPresentId(timestampValue)) return Number.NEGATIVE_INFINITY;
+  const timestamp = (0, _dayjs.default)(timestampValue).valueOf();
+  return Number.isFinite(timestamp) ? timestamp : Number.NEGATIVE_INFINITY;
+}
+function refundTimestamp(refund) {
+  const occurredAt = firstPresentValue(refund.refund_time, refund.refunded_at, refund.created_at, refund.updated_at);
+  if (!isPresentId(occurredAt)) return Number.POSITIVE_INFINITY;
+  const timestamp = (0, _dayjs.default)(occurredAt).valueOf();
+  return Number.isFinite(timestamp) ? timestamp : Number.POSITIVE_INFINITY;
+}
+function isPrintableRefund(refund) {
+  const status = stringify(refund.status).trim().toLowerCase();
+  if (!status) return true;
+  return !['pending', 'payment_pending', 'payment_processing', 'refund_processing', 'processing', 'failed', 'error', 'cancelled', 'canceled', 'voided'].includes(status);
+}
+function resolveRefundPayment(refund, payments) {
+  if (refund.payment && typeof refund.payment === 'object' && !Array.isArray(refund.payment)) {
+    return refund.payment;
+  }
+  const orderPaymentId = firstPresentValue(refund.order_payment_id, refund.payment_id);
+  const matchedPayment = payments.find(payment => isSameId(firstPresentValue(payment.order_payment_id, payment.id), orderPaymentId));
+  return matchedPayment || refund;
+}
 function buildWallets(params) {
-  return normalizeArray(params.order.payments).filter(payment => isPrintablePayment(payment) && !!getFundRecord(payment)).map(payment => buildPaymentItems({
+  const paymentWallets = normalizeArray(params.order.payments).filter(payment => isPrintablePayment(payment) && !!getFundRecord(payment)).map(payment => buildPaymentItems({
     payment,
     locale: params.locale,
     currencySymbol: params.currencySymbol,
     includeFundRecordBalance: true
   }));
+  return [...paymentWallets, ...buildVoucherAssets(params)];
+}
+function buildVoucherAssets(params) {
+  const seenVoucherKeys = new Set();
+  return normalizeArray(params.order.vouchers).flatMap((voucher, index) => {
+    if (!voucher || typeof voucher !== 'object' || Array.isArray(voucher)) return [];
+    const voucherKey = getVoucherAssetKey(voucher, index);
+    if (seenVoucherKeys.has(voucherKey)) return [];
+    seenVoucherKeys.add(voucherKey);
+    const name = getVoucherAssetName(voucher, params.locale);
+    const percent = getVoucherDiscountPercent(voucher);
+    if (percent) {
+      return [[{
+        item: appendPercentToVoucherName(name, percent),
+        value: formatVoucherDiscount(percent, params.locale)
+      }]];
+    }
+    const balance = getVoucherBalance(voucher);
+    return [[{
+      item: name,
+      value: ''
+    }, {
+      item: label(params.locale, 'balance'),
+      value: formatMoney(balance, params.currencySymbol)
+    }]];
+  });
+}
+function getVoucherAssetKey(voucher, index) {
+  const identity = firstPresentValue(voucher.voucher_id, voucher.id, voucher.code, voucher.encoded);
+  return identity === undefined ? `voucher-index:${index}` : `voucher:${String(identity)}`;
+}
+function getVoucherAssetName(voucher, locale) {
+  return getLocalizedValue(voucher.product_name || voucher.name || voucher.title, locale) || stringify(voucher.encoded || voucher.code || label(locale, 'giftCard'));
+}
+function getVoucherDiscountPercent(voucher) {
+  const discountType = stringify(voucher.metadata?.discount_card_type || voucher.discount_card_type).toLowerCase();
+  if (discountType !== 'percent' && discountType !== 'percentage') return null;
+  const percent = new _decimal.default(toMoneyNumber(voucher.par_value));
+  if (!percent.isFinite() || percent.lte(0) || percent.gt(100)) return null;
+  return percent;
+}
+function appendPercentToVoucherName(name, percent) {
+  if (/\d+(?:\.\d+)?\s*(?:%|折)|\boff\b/i.test(name)) return name;
+  const separator = /^[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}]/u.test(name) ? '' : ' ';
+  return `${trimDecimal(percent)}%${separator}${name}`;
+}
+function formatVoucherDiscount(percent, locale) {
+  const normalizedLocale = normalizeLocaleKey(locale);
+  if (normalizedLocale === 'zh_CN' || normalizedLocale === 'zh_HK') {
+    return `${trimDecimal(percent)}% OFF`;
+  }
+  if (normalizedLocale === 'pt') return `Desconto ${trimDecimal(percent)}%`;
+  return normalizedLocale === 'en' ? `Discount ${trimDecimal(percent)}% OFF` : `${trimDecimal(percent)}% OFF`;
+}
+function getVoucherBalance(voucher) {
+  const parValue = new _decimal.default(toMoneyNumber(voucher.par_value));
+  const usedParValue = new _decimal.default(toMoneyNumber(voucher.used_par_value));
+  return _decimal.default.max(parValue.minus(usedParValue), 0);
 }
 function buildPaymentItems(params) {
   const {
@@ -851,10 +1155,22 @@ function buildPaymentItems(params) {
     currencySymbol,
     includeFundRecordBalance
   } = params;
+  const serviceFee = getPaymentServiceFee(payment);
   const items = [{
     item: paymentMethodName(payment, locale),
-    value: formatMoney(payment.amount ?? payment.origin_amount, currencySymbol)
+    value: formatMoney(resolveReceiptPaymentAmount(payment, serviceFee), currencySymbol)
   }];
+  items.push(...buildCashChangePaymentItems({
+    payment,
+    locale,
+    currencySymbol
+  }));
+  if (serviceFee.gt(0)) {
+    items.push({
+      item: label(locale, 'surchargeIncluded'),
+      value: formatMoney(serviceFee, currencySymbol)
+    });
+  }
   const fundRecord = getFundRecord(payment);
   if (fundRecord) {
     items.push(...buildFundRecordPaymentItems({
@@ -879,6 +1195,47 @@ function buildPaymentItems(params) {
   });
   return items;
 }
+function getPaymentServiceFee(payment) {
+  return new _decimal.default(toMoneyNumber(payment.service_fee));
+}
+function resolveReceiptPaymentAmount(payment, serviceFee) {
+  const amount = new _decimal.default(toMoneyNumber(payment.amount ?? payment.origin_amount));
+  const hasAmount = payment.amount !== undefined && payment.amount !== null && payment.amount !== '';
+  const hasOriginAmount = payment.origin_amount !== undefined && payment.origin_amount !== null && payment.origin_amount !== '';
+  if (!hasAmount || !hasOriginAmount || serviceFee.lte(0)) return amount;
+  const originAmount = new _decimal.default(toMoneyNumber(payment.origin_amount));
+  return amount.eq(originAmount) ? amount.plus(serviceFee) : amount;
+}
+function buildCashChangePaymentItems(params) {
+  const {
+    payment,
+    locale,
+    currencySymbol
+  } = params;
+  if (!shouldDisplayCashChange(payment)) return [];
+  return [{
+    item: label(locale, 'cashReceived'),
+    value: formatMoney(payment.metadata.actual_paid_amount, currencySymbol)
+  }, {
+    item: label(locale, 'changeDue'),
+    value: formatMoney(payment.metadata.change_given_amount, currencySymbol)
+  }];
+}
+function shouldDisplayCashChange(payment) {
+  if (stringify(payment.status).toLowerCase() !== 'paid') return false;
+  const paymentMethod = stringify(payment.code ?? payment.payment_method).toUpperCase();
+  if (paymentMethod !== 'CASHMANUAL') return false;
+  const actualPaidAmount = payment.metadata?.actual_paid_amount;
+  const changeGivenAmount = payment.metadata?.change_given_amount;
+  if (!isNumericAmount(actualPaidAmount) || !isNumericAmount(changeGivenAmount)) return false;
+  return new _decimal.default(changeGivenAmount).toDecimalPlaces(2).gt(0);
+}
+function isNumericAmount(value) {
+  if (typeof value === 'number') return Number.isFinite(value);
+  if (typeof value !== 'string') return false;
+  const normalized = value.trim();
+  return normalized !== '' && /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i.test(normalized);
+}
 function buildFundRecordPaymentItems(params) {
   const {
     payment,
@@ -981,13 +1338,29 @@ function getLocalizedValue(value, locale) {
   const underscoredLocale = locale.replace('-', '_');
   return stringify(value[locale] ?? value[dashedLocale] ?? value[underscoredLocale] ?? value.original ?? value.auto ?? value.default ?? value.en ?? '');
 }
-function serviceTypeToLabelKey(serviceType) {
-  const normalized = serviceType.toLowerCase();
-  if (normalized.includes('take')) return 'takeAway';
-  if (normalized.includes('delivery')) return 'delivery';
-  if (normalized.includes('pick')) return 'pickUp';
-  if (normalized.includes('shop')) return 'shopService';
-  return 'dineIn';
+function resolveServiceTypeLabelKey(serviceType, order) {
+  const normalized = serviceType.trim().toLowerCase().replace(/[\s-]+/g, '_');
+  if (['', 'nil', 'none', 'unknown'].includes(normalized)) return null;
+  if (['pickup', 'pick_up', 'self_pickup'].includes(normalized)) return 'pickUp';
+  if (['delivery', 'shipping', 'local_delivery'].includes(normalized)) return 'delivery';
+  if (['takeaway', 'take_away'].includes(normalized)) return 'takeAway';
+  if (['dine_in', 'dinein'].includes(normalized)) return 'dineIn';
+  if (['shop_service', 'shop_server'].includes(normalized)) {
+    return resolveShopServiceLabelKey(order);
+  }
+  return null;
+}
+function resolveShopServiceLabelKey(order) {
+  const rawShopServiceType = firstPresentValue(order.metadata?.shop_service_type?.server_type, order.shop_service_type?.server_type, typeof order.shop_service_type === 'string' ? order.shop_service_type : undefined);
+  if (!isPresentId(rawShopServiceType)) return 'dineIn';
+  const normalized = stringify(rawShopServiceType).trim().toLowerCase().replace(/[\s-]+/g, '_');
+  if (['takeaway', 'take_away'].includes(normalized)) return 'takeAway';
+  if (['dine_in', 'dinein'].includes(normalized)) return 'dineIn';
+  return null;
+}
+function normalizeBooleanFlag(value) {
+  if (value === true || value === 1 || stringify(value).trim() === '1') return 1;
+  return 0;
 }
 function buildShopAddress(shopInfo) {
   return [shopInfo.address_street, shopInfo.address_detail, shopInfo.city, shopInfo.province, shopInfo.country, shopInfo.zip].filter(Boolean).join(', ');
@@ -1008,17 +1381,17 @@ function formatNegativeMoney(value, currencySymbol) {
   const amount = new _decimal.default(toMoneyNumber(value)).abs();
   return `-${currencySymbol}${amount.toFixed(2)}`;
 }
-function calculateReceiptPaidAmount(order, summary) {
-  const paidAmount = sumPayments(order.payments);
-  const payProcessingFee = new _decimal.default(toMoneyNumber(summary.pay_service_charge_amount ?? order.pay_service_charge_amount));
-  if (payProcessingFee.lte(0)) return paidAmount;
-  const totalAmount = new _decimal.default(toMoneyNumber(summary.total_amount ?? order.total_amount));
-  if (totalAmount.gt(0) && paidAmount.gte(totalAmount)) return paidAmount;
-  const paidAmountWithFee = paidAmount.plus(payProcessingFee);
-  if (totalAmount.gt(0) && paidAmountWithFee.gt(totalAmount)) return totalAmount;
-  return paidAmountWithFee;
-}
-function sumPayments(payments) {
+function sumAppliedPayments(payments) {
+  return normalizeArray(payments).filter(payment => isPrintablePayment(payment)).reduce((sum, payment) => {
+    if (isPresentId(payment.origin_amount)) {
+      return sum.plus(toMoneyNumber(payment.origin_amount));
+    }
+    const amount = new _decimal.default(toMoneyNumber(payment.amount));
+    const serviceFee = _decimal.default.max(toMoneyNumber(payment.service_fee), 0);
+    return sum.plus(_decimal.default.max(amount.minus(serviceFee), 0));
+  }, new _decimal.default(0));
+}
+function sumCustomerPaidPayments(payments) {
   return normalizeArray(payments).filter(payment => isPrintablePayment(payment)).reduce((sum, payment) => {
     return sum.plus(toMoneyNumber(payment.amount ?? payment.origin_amount));
   }, new _decimal.default(0));
@@ -1026,7 +1399,7 @@ function sumPayments(payments) {
 function isPrintablePayment(payment) {
   const status = stringify(payment.status).toLowerCase();
   if (!status) return true;
-  return ['paid', 'success', 'succeeded', 'completed'].includes(status);
+  return ['paid', 'success', 'succeeded', 'completed', 'partially_refunded', 'refunded'].includes(status);
 }
 function normalizeArray(value) {
   return Array.isArray(value) ? value : [];