@pisell/pisellos 0.10.56 → 0.10.58

package/lib/shared/receipt/small-ticket.js

@@ -8,8 +8,49 @@ exports.hasSmallTicketData = hasSmallTicketData;
 var _dayjs = _interopRequireDefault(require("dayjs"));
 var _decimal = _interopRequireDefault(require("decimal.js"));
 var _pickupTiming = require("../../modules/Order/pickupTiming");
+var _templateVisibility = require("./templateVisibility");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const DEFAULT_LOCALES = ['en', 'zh_CN'];
+
+// Attach provenance to a private copy BEFORE any locale-dependent filtering.
+// Symbols survive the existing spread-based normalization, never enter JSON,
+// and leave both the caller's snapshot and the default native contract intact.
+const RECEIPT_SOURCE = Symbol('customerReceiptSource');
+function copyReceiptSource(value, path = 'order') {
+  if (Array.isArray(value)) return value.map((item, index) => copyReceiptSource(item, `${path}/${index}`));
+  if (!value || typeof value !== 'object' || Object.getPrototypeOf(value) !== Object.prototype) return value;
+  const id = value.metadata?.unique_identification_number ?? value.product_uid ?? value.booking_uid ?? value.order_payment_id ?? value.payment_number ?? value.order_refund_id ?? value.refund_number ?? value.id;
+  const source = Object.fromEntries(Object.entries(value).map(([key, item]) => [key, copyReceiptSource(item, `${path}/${key}`)]));
+  // Retain the original occurrence even when a catalogue ID appears twice.
+  return {
+    ...source,
+    [RECEIPT_SOURCE]: `${path}${id != null ? `@${encodeURIComponent(String(id))}` : ''}`
+  };
+}
+function receiptKey(source, kind, valueKind = 'shared') {
+  const key = source?.[RECEIPT_SOURCE];
+  return typeof key === 'string' ? {
+    receipt_key: `${key}#${kind}`,
+    receipt_value_kind: valueKind
+  } : {};
+}
+function receiptSourceIndex(source, index) {
+  return source?.[RECEIPT_SOURCE] ? {
+    receipt_source_index: index
+  } : {};
+}
+function removePrivateReceiptSource(value) {
+  if (!value || typeof value !== 'object') return;
+  delete value[RECEIPT_SOURCE];
+  Object.values(value).forEach(removePrivateReceiptSource);
+}
+function receiptTimeKey(source, kind) {
+  const identity = receiptKey(source, kind);
+  return identity.receipt_key ? {
+    ...identity,
+    receipt_item_kind: 'shared'
+  } : {};
+}
 const SERVICE_TYPE_LABEL_KEYS = {
   takeaway: 'takeAway',
   pick_up: 'pickUp',
@@ -247,19 +288,23 @@ const LABELS = {
   }
 };
 function buildSmallTicketData(params) {
-  const order = params.order || {};
+  const order = params.includeReceiptKeys ? copyReceiptSource(params.order || {}) : params.order || {};
   const shopInfo = params.shopInfo || {};
   const locales = resolveLocales(shopInfo, params.locales);
   const productMap = params.productMap || {};
-  return locales.reduce((data, locale) => {
+  const visibility = (0, _templateVisibility.resolveInvoiceDataVisibility)(params.templateSettings);
+  const result = locales.reduce((data, locale) => {
     data[locale] = buildLocaleData({
       order,
       shopInfo,
       locale,
-      productMap
+      productMap,
+      visibility
     });
     return data;
   }, {});
+  if (params.includeReceiptKeys) removePrivateReceiptSource(result);
+  return result;
 }
 function hasSmallTicketData(value) {
   return !!value && typeof value === 'object' && Object.keys(value).length > 0;
@@ -269,13 +314,14 @@ function buildLocaleData(params) {
     order,
     shopInfo,
     locale,
-    productMap
+    productMap,
+    visibility
   } = 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);
+  const delivery = buildDelivery(order, locale, visibility.handover);
   return {
     base_data: buildBaseData({
       order,
@@ -294,7 +340,7 @@ function buildLocaleData(params) {
       currencySymbol,
       financials
     }),
-    customer: buildCustomer(order, locale),
+    customer: buildCustomer(order, locale, visibility.customer),
     appointment: buildAppointment(order, locale),
     ...(delivery.length ? {
       delivery
@@ -305,12 +351,18 @@ function buildLocaleData(params) {
       locale,
       currencySymbol
     }),
-    wallets: buildWallets({
+    wallets: visibility.card.show ? buildWallets({
       order,
       locale,
-      currencySymbol
-    }),
-    tickets: Array.isArray(order.tickets) ? order.tickets : [],
+      currencySymbol,
+      passTypes: visibility.card.passTypes
+    }) : [],
+    // Native printers fall back to tickets when wallets is empty. Legacy rows
+    // have no trustworthy asset tags, so they cannot bypass a card whitelist.
+    tickets: visibility.card.show && visibility.card.passTypes === null && Array.isArray(order.tickets) ? order.tickets.map(group => Array.isArray(group) ? group.map(row => row && typeof row === 'object' ? {
+      ...row,
+      ...receiptKey(row, 'ticket')
+    } : row) : group) : [],
     source_shop: [],
     refund_data: buildRefundData({
       order,
@@ -354,7 +406,7 @@ function buildBaseData(params) {
 function buildProducts(order, locale, productMap) {
   const products = Array.isArray(order.products) ? order.products : [];
   const allergyByProductUid = buildProductAllergyMap(order, locale);
-  return products.map(rawProduct => {
+  return products.map((rawProduct, sourceIndex) => {
     const product = restoreReceiptDiscountHierarchy(rawProduct);
     const quantity = toNumber(product.product_quantity ?? product.quantity ?? product.num ?? 1, 1);
     const originalPrice = product.original_price ?? product.selling_price ?? product.payment_price ?? product.price ?? 0;
@@ -399,6 +451,10 @@ function buildProducts(order, locale, productMap) {
     const resolvedCombinations = Array.isArray(product.combinations) && product.combinations.length ? normalizeExistingCombinations(product.combinations, locale, currencySymbol) : combinations;
     const shouldIncludeBasePrice = options.length > 0 || resolvedCombinations.length > 0 || hasProductDiscount(product, extensionList);
     return {
+      ...receiptKey(rawProduct, 'product'),
+      ...(rawProduct[RECEIPT_SOURCE] ? {
+        receipt_source_index: sourceIndex
+      } : {}),
       product_title: productTitle,
       product_quantity: quantity,
       selling_price: formatMoney(sellingPrice, currencySymbol),
@@ -542,6 +598,7 @@ function normalizeProductDiscounts(params) {
     const totalAmount = new _decimal.default(toMoneyNumber(amount)).mul(isAggregatedBundleDiscount || isEntitlementPass ? 1 : quantity);
     const formattedAmount = isMarkup ? formatMoney(totalAmount.abs(), currencySymbol) : formatNegativeMoney(totalAmount, currencySymbol);
     return {
+      ...receiptKey(discount, 'discount'),
       item: title,
       value: formattedAmount,
       isMarkup
@@ -581,6 +638,7 @@ function buildProductExtensionList(params) {
     locale,
     currencySymbol
   }), ...(quantity > 1 ? [{
+    ...receiptTimeKey(product, 'quantity-price'),
     item: buildProductQuantityPriceText({
       quantity,
       currencySymbol,
@@ -588,7 +646,10 @@ function buildProductExtensionList(params) {
     }),
     value: ''
   }] : [])];
-  const productExtensionList = extensionList.length ? extensionList : normalizeArray(product.extension_list);
+  const productExtensionList = extensionList.length ? extensionList : normalizeArray(product.extension_list).map(row => ({
+    ...row,
+    ...receiptKey(row, 'extension')
+  }));
   return [...productExtensionList, ...discountList];
 }
 function buildProductOpenWeightRows(params) {
@@ -605,10 +666,12 @@ function buildProductOpenWeightRows(params) {
   const rows = [];
   if (hasTare) {
     rows.push({
+      ...receiptKey(product, 'gross'),
       item: `${manualFlag}${label(locale, 'gross')}: ${productSku.weight ?? 0}${unit}`,
       value: ''
     });
     rows.push({
+      ...receiptKey(product, 'tare'),
       item: `${label(locale, 'tare')}: ${productSku.tare_weight}${unit}`,
       value: ''
     });
@@ -617,6 +680,7 @@ function buildProductOpenWeightRows(params) {
   const unitPrice = productSku.unit_price ?? 0;
   const netItem = `${netWeight} ${unit} NET @ ${currencySymbol}${unitPrice}/${unit}`;
   rows.push({
+    ...receiptTimeKey(product, 'net-weight'),
     item: hasTare ? netItem : `${manualFlag}${netItem}`,
     value: ''
   });
@@ -672,7 +736,7 @@ function normalizeProductOptions(params) {
     parentProduct
   } = params;
   const rawOptions = Array.isArray(params.options) ? params.options : Array.isArray(product.options) ? product.options : Array.isArray(product.product_sku?.option) ? product.product_sku.option : [];
-  return rawOptions.map(option => {
+  return rawOptions.map((option, sourceIndex) => {
     const price = option.original_price ?? option.add_price ?? option.price;
     const quantity = toNumber(option.num ?? option.quantity ?? 1, 1);
     const value = option.value ?? option.option ?? option.item;
@@ -682,6 +746,8 @@ function normalizeProductOptions(params) {
       locale
     });
     return {
+      ...receiptKey(option, 'option'),
+      ...receiptSourceIndex(option, sourceIndex),
       name,
       ...(option.num !== undefined || option.quantity !== undefined ? {
         num: quantity
@@ -705,7 +771,7 @@ function normalizeProductCombinations(params) {
     parentProduct
   } = params;
   const bundles = Array.isArray(product.product_bundle) ? product.product_bundle : [];
-  return bundles.map(bundle => {
+  return bundles.map((bundle, sourceIndex) => {
     const combinationsOptions = normalizeProductOptions({
       product: {},
       locale,
@@ -735,6 +801,8 @@ function normalizeProductCombinations(params) {
     });
     const shouldIncludeBasePrice = combinationsOptions.length > 0 || nestedCombinations.length > 0 || hasProductDiscount(bundle, extensionList);
     return {
+      ...receiptKey(bundle, 'combination'),
+      ...receiptSourceIndex(bundle, sourceIndex),
       product_title: baseTitle,
       product_quantity: quantity,
       price: formattedPrice,
@@ -762,7 +830,7 @@ function normalizeProductCombinations(params) {
   });
 }
 function normalizeExistingCombinations(combinations, locale, currencySymbol) {
-  return combinations.map(combination => {
+  return combinations.map((combination, sourceIndex) => {
     if (!combination || typeof combination !== 'object' || Array.isArray(combination)) {
       return combination;
     }
@@ -799,6 +867,8 @@ function normalizeExistingCombinations(combinations, locale, currencySymbol) {
     const shouldIncludeBasePrice = normalizedOptions.length > 0 || nestedCombinations.length > 0 || hasProductDiscount(combination, extensionList);
     return {
       ...snapshot,
+      ...receiptKey(combination, 'combination'),
+      ...receiptSourceIndex(combination, sourceIndex),
       ...(productTitle ? {
         product_title: productTitle
       } : {}),
@@ -953,7 +1023,7 @@ function resolveVariantItem(group, itemPositionId) {
 }
 function getProductTitleSource(source, locale) {
   if (!source || typeof source !== 'object') return '';
-  return resolveTitleValue(source.product_title, locale) || resolveTitleValue(source.title_i18n, locale) || resolveTitleValue(source.title, locale) || resolveTitleValue(source.name, locale);
+  return resolveTitleValue(source.product_title, locale) || resolveTitleValue(source.title_i18n, locale) || resolveTitleValue(source.title, locale) || resolveTitleValue(source.name_i18n, locale) || resolveTitleValue(source.name, locale);
 }
 function getBundleProductTitleSource(source, locale) {
   if (!source || typeof source !== 'object') return '';
@@ -1072,6 +1142,7 @@ function buildFees(params) {
     const value = surcharge.amount ?? surcharge.value ?? surcharge.total_amount;
     if (!isNonZero(value)) continue;
     fees.push({
+      ...receiptKey(surcharge, 'surcharge'),
       item: getLocalizedValue(surcharge.name || surcharge.title || surcharge.item, locale),
       value: formatMoney(value, currencySymbol)
     });
@@ -1079,6 +1150,7 @@ function buildFees(params) {
   const discountAmount = firstPresentValue(order.shop_discount, summary.discount_amount, order.discount_amount);
   if (isNonZero(discountAmount)) {
     fees.push({
+      ...receiptKey(order, 'order-discount'),
       item: label(locale, 'orderDiscount'),
       value: formatNegativeMoney(discountAmount, currencySymbol)
     });
@@ -1095,6 +1167,7 @@ function buildFees(params) {
   const payProcessingFee = financials.payProcessingFee;
   if (isNonZero(payProcessingFee)) {
     fees.push({
+      ...receiptKey(order, 'payment-processing-fee'),
       item: label(locale, 'payProcessingFee'),
       value: formatMoney(payProcessingFee, currencySymbol)
     });
@@ -1174,17 +1247,22 @@ function calculateProductOriginalAmount(order) {
     return total.plus(new _decimal.default(toMoneyNumber(originalPrice)).mul(quantity));
   }, new _decimal.default(0));
 }
-function buildCustomer(order, locale) {
+function buildCustomer(order, locale, visibility) {
+  if (!visibility.show) return [];
+  const fields = [visibility.name, visibility.phone, visibility.email];
   return [{
+    ...receiptKey(order, 'customer.contactName'),
     item: label(locale, 'contactName'),
     value: normalizeCustomerDisplayValue(order.customer_name || order.customer?.name || order.customer?.display_name)
   }, {
+    ...receiptKey(order, 'customer.contactMobile'),
     item: label(locale, 'contactMobile'),
     value: stringify(order.phone || order.customer?.phone)
   }, {
+    ...receiptKey(order, 'customer.email'),
     item: label(locale, 'email'),
     value: stringify(order.email || order.customer?.email)
-  }];
+  }].filter((_row, index) => fields[index]);
 }
 function normalizeCustomerDisplayValue(value) {
   const text = stringify(value).trim();
@@ -1192,19 +1270,23 @@ function normalizeCustomerDisplayValue(value) {
   if (text.toLowerCase() === 'select a customer') return 'Walk-In';
   return text;
 }
-function buildDelivery(order, locale) {
+function buildDelivery(order, locale, visibility) {
+  if (!visibility.show) return [];
   const serviceType = stringify(order.metadata?.shop_service_data?.service_type).trim();
   const serviceTypeLabelKey = resolveServiceTypeLabelKey(serviceType);
   if (!serviceTypeLabelKey) return [];
-  const items = [{
+  const items = visibility.method ? [{
+    ...receiptKey(order, 'service-type'),
     item: label(locale, serviceTypeLabelKey),
     value: '',
     size: 2
-  }];
+  }] : [];
+  if (!visibility.fulfillmentTime) return items;
   if (serviceType === 'pick_up') {
     const pickupTime = formatPickupBookingStart(order.bookings, locale);
     if (pickupTime) {
       items.push({
+        ...receiptTimeKey(order, 'pickup-time'),
         item: pickupTime,
         value: '',
         size: 2
@@ -1215,6 +1297,7 @@ function buildDelivery(order, locale) {
   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({
+      ...receiptKey(order, 'handover-time'),
       item: label(locale, 'handoverTime'),
       value: formatDateTime(handoverTime, locale)
     });
@@ -1254,6 +1337,7 @@ function buildAppointment(order, locale) {
   const tableName = order.table_name || order.metadata?.table_name || order.metadata?.table?.name || order.form_data?.table_name;
   if (!tableName) return [];
   return [{
+    ...receiptKey(order, 'table', 'text'),
     item: label(locale, 'table'),
     value: getLocalizedValue(tableName, locale)
   }];
@@ -1289,18 +1373,22 @@ function buildAppointmentRows(params) {
   const resourceText = formatBookingResources(resolveBookingResourcesForReceipt(booking, allResources, bookingCount), locale);
   const holder = getLocalizedValue(booking.holder?.name ?? booking.metadata?.holder?.name, locale).trim();
   return [{
+    ...receiptKey(booking, 'booking-id'),
     item: label(locale, 'bookingId'),
     value: bookingId,
     ...association
   }, {
+    ...receiptKey(booking, 'booking-time', 'shared'),
     item: label(locale, 'bookingDateTime'),
     value: bookingTime,
     ...association
   }, {
+    ...receiptKey(booking, 'booking-resource', 'text'),
     item: label(locale, 'bookingResource'),
     value: resourceText,
     ...association
   }, {
+    ...receiptKey(booking, 'booking-holder', 'text'),
     item: label(locale, 'bookingHolder'),
     value: holder,
     ...association
@@ -1386,6 +1474,7 @@ function compareOptionalValues(left, right) {
 }
 function buildResources(order, locale) {
   return normalizeArray(order.resources || order.resource_list).map(resource => ({
+    ...receiptKey(resource, 'resource', 'text'),
     id: resource.id || resource.resource_id || '',
     code: '',
     title: getLocalizedValue(resource.title || resource.name, locale),
@@ -1431,12 +1520,14 @@ function buildRefundData(params) {
     const methodName = paymentMethodName(payment, params.locale) || label(params.locale, 'refund');
     const amount = firstPresentValue(refund.amount, refund.refund_amount, refund.total_amount) ?? 0;
     const items = [{
+      ...receiptKey(refund, 'refund'),
       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({
+        ...receiptTimeKey(refund, 'refund-time'),
         item: formatDateTime(occurredAt, params.locale),
         value: ''
       });
@@ -1483,9 +1574,77 @@ function resolveRefundPayment(refund, payments) {
   const matchedPayment = payments.find(payment => isSameId(firstPresentValue(payment.order_payment_id, payment.id), orderPaymentId));
   return matchedPayment || refund;
 }
+function getPaymentWalletAssetIdentity(payment) {
+  const record = getFundRecord(payment);
+  return {
+    id: firstNormalizedWalletAssetId(record?.voucher_id, payment.voucher_id),
+    codes: normalizeWalletAssetCodes(record?.code, record?.encoded)
+  };
+}
+function getProductWalletAssetTag(record) {
+  // Rules normalizes product_discount_card to type=discount_card. That
+  // ambiguous alias cannot establish the original asset tag for a whitelist.
+  for (const tag of [record.tag, record.discount?.tag]) {
+    if (typeof tag === 'string' && tag) return tag;
+  }
+  for (const type of [record.type, record.discount?.type]) {
+    if (typeof type === 'string' && type !== 'discount_card' && PRODUCT_WALLET_DISCOUNT_TYPES.has(type)) return type;
+  }
+  return undefined;
+}
+function createWalletAssetFilter(order, passTypes) {
+  if (passTypes === null) return () => true;
+  const assets = [];
+  const remember = (identity, tag) => {
+    if (typeof tag === 'string' && tag && (identity.id || identity.codes.length)) assets.push({
+      identity,
+      tag
+    });
+  };
+  for (const asset of [...normalizeArray(order.vouchers), ...normalizeArray(order.order_meta_list?.point_cards_snapshot), ...normalizeArray(order.order_meta_list?.virtual_currency_snapshot)]) {
+    if (asset && typeof asset === 'object') remember(getVoucherAssetIdentity(asset), asset.tag);
+  }
+  // Some order snapshots retain the original selected assets at the root.
+  // Only their explicit tag is authoritative; do not infer it from type.
+  for (const record of normalizeArray(order.discount_list)) {
+    if (!record || typeof record !== 'object') continue;
+    remember({
+      id: getProductWalletDiscountAssetId(record),
+      codes: getProductWalletDiscountCodes(record)
+    }, record.tag ?? record.discount?.tag);
+  }
+  const visit = product => {
+    if (!product || typeof product !== 'object') return;
+    for (const record of normalizeArray(product.discount_list)) {
+      if (!record || typeof record !== 'object') continue;
+      remember({
+        id: getProductWalletDiscountAssetId(record),
+        codes: getProductWalletDiscountCodes(record)
+      }, getProductWalletAssetTag(record));
+    }
+    for (const key of ['combinations', 'product_bundle', 'bundle']) normalizeArray(product[key]).forEach(visit);
+  };
+  normalizeArray(order.products).forEach(product => {
+    if (product && typeof product === 'object') visit(restoreReceiptDiscountHierarchy(product));
+  });
+  return (identity, tag, resolvePaymentSource = false) => {
+    const directTag = typeof tag === 'string' && tag ? tag : undefined;
+    if (directTag && !resolvePaymentSource) return passTypes.has(directTag);
+    const exactMatches = identity.id ? assets.filter(asset => asset.identity.id === identity.id) : [];
+    // A known asset ID is stronger than an unrelated code-only snapshot.
+    const matches = exactMatches.length ? exactMatches : assets.filter(asset => isSameWalletAssetIdentity(asset.identity, identity));
+    const tags = new Set(matches.map(asset => asset.tag));
+    if (!tags.size) return !!directTag && passTypes.has(directTag);
+    // A conflicting fund record is not reliable evidence for a payment's tag.
+    // It must not claim the identity ahead of the original typed asset.
+    if (tags.size !== 1 || directTag && !tags.has(directTag)) return false;
+    return passTypes.has(matches[0].tag);
+  };
+}
 function buildWallets(params) {
-  const virtualCurrencySnapshots = collectVirtualCurrencySnapshots(params.order);
-  const displayedWalletPayments = normalizeArray(params.order.payments).filter(payment => isPrintablePayment(payment) && !!getFundRecord(payment));
+  const allowAsset = createWalletAssetFilter(params.order, params.passTypes);
+  const virtualCurrencySnapshots = collectVirtualCurrencySnapshots(params.order, allowAsset);
+  const displayedWalletPayments = normalizeArray(params.order.payments).filter(payment => isPrintablePayment(payment) && !!getFundRecord(payment) && allowAsset(getPaymentWalletAssetIdentity(payment), getFundRecord(payment)?.tag, true));
   const paymentWallets = displayedWalletPayments.map(payment => {
     const virtualCurrencySnapshot = findVirtualCurrencySnapshotForPayment(payment, virtualCurrencySnapshots.byId);
     return buildPaymentItems({
@@ -1501,20 +1660,24 @@ function buildWallets(params) {
   const displayedWalletAssetIdentities = collectDisplayedWalletAssetIdentities(displayedWalletPayments);
   const voucherWallets = buildVoucherAssets({
     ...params,
+    allowAsset,
     displayedWalletAssetIdentities
   });
   const productDiscountWallets = buildProductDiscountAssets({
     ...params,
+    allowAsset,
     displayedWalletAssetIdentities
   });
   return [...paymentWallets, ...voucherWallets, ...productDiscountWallets, ...buildPointCardSnapshotAssets({
     order: params.order,
     locale: params.locale,
+    allowAsset,
     displayedWalletAssetIdentities
   }), ...buildVirtualCurrencySnapshotAssets({
     snapshots: virtualCurrencySnapshots.items,
     order: params.order,
     locale: params.locale,
+    allowAsset,
     displayedWalletAssetIdentities
   })];
 }
@@ -1543,7 +1706,7 @@ function collectDisplayedWalletAssetIdentities(payments) {
 const PRODUCT_WALLET_DISCOUNT_TYPES = new Set(['good_pass', 'discount_card', 'product_discount_card', 'entitlement_pass']);
 function buildProductDiscountAssets(params) {
   const fallbackAssetTime = firstPresentValue(params.order.updated_at, params.order.created_at);
-  return collectProductWalletDiscountAssets(params.order).flatMap(asset => {
+  return collectProductWalletDiscountAssets(params.order, params.allowAsset).flatMap(asset => {
     if (!claimWalletAssetIdentity(params.displayedWalletAssetIdentities, {
       id: asset.id,
       codes: asset.codes
@@ -1551,15 +1714,18 @@ function buildProductDiscountAssets(params) {
     const name = getProductWalletDiscountName(asset, params.locale);
     const assetTime = getProductWalletDiscountTime(asset) ?? fallbackAssetTime;
     const timeRow = isPresentId(assetTime) ? {
+      ...receiptTimeKey(asset.records[0], 'asset-time'),
       item: formatDateTime(assetTime, params.locale),
       value: ''
     } : null;
     if (asset.type === 'entitlement_pass') {
       const remaining = getProductEntitlementBalance(asset);
       return [[{
+        ...receiptKey(asset.records[0], 'asset-name'),
         item: name,
         value: ''
       }, ...(remaining ? [{
+        ...receiptKey(asset.records[0], 'entitlementRemaining'),
         item: label(params.locale, 'entitlementRemaining'),
         value: formatEntitlementUses(remaining, params.locale)
       }] : []), ...(timeRow ? [timeRow] : [])]];
@@ -1567,30 +1733,33 @@ function buildProductDiscountAssets(params) {
     const percent = getProductWalletDiscountPercent(asset);
     if (percent) {
       return [[{
+        ...receiptKey(asset.records[0], 'asset-discount'),
         item: appendPercentToVoucherName(name, percent),
         value: formatVoucherDiscount(percent, params.locale)
       }, ...(timeRow ? [timeRow] : [])]];
     }
     const balance = getProductWalletMoneyBalance(asset);
     return [[{
+      ...receiptKey(asset.records[0], 'asset-name'),
       item: name,
       value: ''
     }, ...(balance ? [{
+      ...receiptKey(asset.records[0], 'balance'),
       item: label(params.locale, 'balance'),
       value: formatMoney(balance, params.currencySymbol)
     }] : []), ...(timeRow ? [timeRow] : [])]];
   });
 }
-function collectProductWalletDiscountAssets(order) {
+function collectProductWalletDiscountAssets(order, allowAsset) {
   const assets = [];
   const assetsById = new Map();
   normalizeArray(order.products).forEach(rawProduct => {
     if (!rawProduct || typeof rawProduct !== 'object') return;
-    visitProductWalletDiscounts(restoreReceiptDiscountHierarchy(rawProduct), assets, assetsById);
+    visitProductWalletDiscounts(restoreReceiptDiscountHierarchy(rawProduct), assets, assetsById, allowAsset);
   });
   return assets;
 }
-function visitProductWalletDiscounts(product, assets, assetsById) {
+function visitProductWalletDiscounts(product, assets, assetsById, allowAsset) {
   normalizeArray(product.discount_list).forEach(record => {
     if (!record || typeof record !== 'object' || Array.isArray(record)) return;
     const type = getProductWalletDiscountType(record);
@@ -1598,6 +1767,10 @@ function visitProductWalletDiscounts(product, assets, assetsById) {
     const id = getProductWalletDiscountAssetId(record);
     if (!id) return;
     const codes = getProductWalletDiscountCodes(record);
+    if (allowAsset && !allowAsset({
+      id,
+      codes
+    }, getProductWalletAssetTag(record))) return;
     const existing = assetsById.get(id);
     if (existing) {
       existing.records.push(record);
@@ -1616,7 +1789,7 @@ function visitProductWalletDiscounts(product, assets, assetsById) {
   for (const childKey of ['combinations', 'product_bundle', 'bundle']) {
     normalizeArray(product[childKey]).forEach(child => {
       if (!child || typeof child !== 'object' || Array.isArray(child)) return;
-      visitProductWalletDiscounts(child, assets, assetsById);
+      visitProductWalletDiscounts(child, assets, assetsById, allowAsset);
     });
   }
 }
@@ -1732,23 +1905,27 @@ function buildPointCardSnapshotAssets(params) {
     const pointCard = snapshot;
     if (stringify(pointCard.tag).trim().toLowerCase() !== 'point_card') return [];
     const assetId = normalizeWalletPassId(pointCard.id);
+    if (!params.allowAsset(getVoucherAssetIdentity(pointCard), pointCard.tag)) return [];
     if (!assetId || !claimWalletAssetIdentity(params.displayedWalletAssetIdentities, {
       id: assetId,
       codes: []
     })) return [];
     const rows = [{
+      ...receiptKey(pointCard, 'asset-name'),
       item: appendMaskedCardCode(stringify(pointCard.product_name).trim() || label(params.locale, 'pointCard'), pointCard.code),
       value: ''
     }];
     const remainingPoints = getPointCardSnapshotRemainingPoints(pointCard);
     if (remainingPoints) {
       rows.push({
+        ...receiptKey(pointCard, 'remainingPoints'),
         item: label(params.locale, 'remainingPoints'),
         value: trimDecimal(remainingPoints)
       });
     }
     if (isPresentId(snapshotTime)) {
       rows.push({
+        ...receiptTimeKey(pointCard, 'asset-time'),
         item: formatDateTime(snapshotTime, params.locale),
         value: ''
       });
@@ -1756,7 +1933,7 @@ function buildPointCardSnapshotAssets(params) {
     return [rows];
   });
 }
-function collectVirtualCurrencySnapshots(order) {
+function collectVirtualCurrencySnapshots(order, allowAsset) {
   const items = [];
   const byId = new Map();
   const snapshots = order.order_meta_list?.virtual_currency_snapshot;
@@ -1768,6 +1945,7 @@ function collectVirtualCurrencySnapshots(order) {
     if (!snapshot || typeof snapshot !== 'object' || Array.isArray(snapshot)) return;
     const virtualCurrency = snapshot;
     if (stringify(virtualCurrency.tag).trim().toLowerCase() !== 'virtual_currency') return;
+    if (!allowAsset(getVoucherAssetIdentity(virtualCurrency), virtualCurrency.tag)) return;
     const id = normalizeWalletPassId(virtualCurrency.id);
     if (!id || byId.has(id)) return;
     byId.set(id, virtualCurrency);
@@ -1792,23 +1970,27 @@ function buildVirtualCurrencySnapshotAssets(params) {
   const snapshotTime = firstPresentValue(params.order.updated_at, params.order.created_at);
   return params.snapshots.flatMap(virtualCurrency => {
     const assetId = normalizeWalletPassId(virtualCurrency.id);
+    if (!params.allowAsset(getVoucherAssetIdentity(virtualCurrency), virtualCurrency.tag)) return [];
     if (!assetId || !claimWalletAssetIdentity(params.displayedWalletAssetIdentities, {
       id: assetId,
       codes: []
     })) return [];
     const rows = [{
+      ...receiptKey(virtualCurrency, 'asset-name'),
       item: stringify(virtualCurrency.product_name).trim(),
       value: ''
     }];
     const balance = getVirtualCurrencySnapshotBalance(virtualCurrency);
     if (balance) {
       rows.push({
+        ...receiptKey(virtualCurrency, 'balance'),
         item: label(params.locale, 'balance'),
         value: formatVirtualCurrencyBalance(balance, getVirtualCurrencySnapshotUnit(virtualCurrency, params.locale))
       });
     }
     if (isPresentId(snapshotTime)) {
       rows.push({
+        ...receiptTimeKey(virtualCurrency, 'asset-time'),
         item: formatDateTime(snapshotTime, params.locale),
         value: ''
       });
@@ -1899,19 +2081,23 @@ function buildVoucherAssets(params) {
   const fallbackAssetTime = firstPresentValue(params.order.updated_at, params.order.created_at);
   return normalizeArray(params.order.vouchers).flatMap(voucher => {
     if (!voucher || typeof voucher !== 'object' || Array.isArray(voucher)) return [];
+    if (!params.allowAsset(getVoucherAssetIdentity(voucher), voucher.tag)) return [];
     if (!claimWalletAssetIdentity(params.displayedWalletAssetIdentities, getVoucherAssetIdentity(voucher))) return [];
     const name = getVoucherAssetName(voucher, params.locale);
     const assetTime = firstPresentValue(voucher.updated_at, voucher.created_at, voucher.collection_time, fallbackAssetTime);
     const timeRow = isPresentId(assetTime) ? {
+      ...receiptTimeKey(voucher, 'asset-time'),
       item: formatDateTime(assetTime, params.locale),
       value: ''
     } : null;
     if (isEntitlementVoucher(voucher)) {
       const remaining = getEntitlementBalance(voucher.metadata?.balance, voucher.balance);
       return [[{
+        ...receiptKey(voucher, 'asset-name'),
         item: name,
         value: ''
       }, ...(remaining ? [{
+        ...receiptKey(voucher, 'entitlementRemaining'),
         item: label(params.locale, 'entitlementRemaining'),
         value: formatEntitlementUses(remaining, params.locale)
       }] : []), ...(timeRow ? [timeRow] : [])]];
@@ -1919,9 +2105,11 @@ function buildVoucherAssets(params) {
     if (isTicketVoucher(voucher)) {
       const validity = getVoucherValidity(voucher, params.locale);
       return [[{
+        ...receiptKey(voucher, 'asset-name'),
         item: name,
         value: ''
       }, ...(validity ? [{
+        ...receiptKey(voucher, 'validity'),
         item: label(params.locale, 'validity'),
         value: validity
       }] : [])]];
@@ -1929,15 +2117,18 @@ function buildVoucherAssets(params) {
     const percent = getVoucherDiscountPercent(voucher);
     if (percent) {
       return [[{
+        ...receiptKey(voucher, 'asset-discount'),
         item: appendPercentToVoucherName(name, percent),
         value: formatVoucherDiscount(percent, params.locale)
       }, ...(timeRow ? [timeRow] : [])]];
     }
     const balance = getVoucherBalance(voucher);
     return [[{
+      ...receiptKey(voucher, 'asset-name'),
       item: name,
       value: ''
     }, {
+      ...receiptKey(voucher, 'balance'),
       item: label(params.locale, 'balance'),
       value: formatMoney(balance, params.currencySymbol)
     }, ...(timeRow ? [timeRow] : [])]];
@@ -2071,6 +2262,7 @@ function buildPaymentItems(params) {
   } = params;
   const serviceFee = getPaymentServiceFee(payment);
   const items = [{
+    ...receiptKey(payment, 'payment'),
     item: paymentMethodName(payment, locale),
     value: includePaymentAmount ? formatMoney(resolveReceiptPaymentAmount(payment, serviceFee), currencySymbol) : ''
   }];
@@ -2081,6 +2273,7 @@ function buildPaymentItems(params) {
   }));
   if (serviceFee.gt(0)) {
     items.push({
+      ...receiptKey(payment, 'surchargeIncluded'),
       item: label(locale, 'surchargeIncluded'),
       value: formatMoney(serviceFee, currencySymbol)
     });
@@ -2100,16 +2293,21 @@ function buildPaymentItems(params) {
     const remainingAmount = payment.remaining_amount ?? payment.balance ?? payment.metadata?.remaining_amount;
     if (remainingAmount !== undefined && remainingAmount !== null) {
       items.push({
+        ...receiptKey(payment, 'remainingAmount'),
         item: label(locale, 'remainingAmount'),
         value: formatMoney(remainingAmount, currencySymbol)
       });
     }
   }
   items.push({
+    ...receiptTimeKey(payment, 'payment-time'),
     item: formatDateTime(payment.paid_at || payment.created_at || payment.updated_at || new Date(), locale),
     value: ''
   });
-  return items;
+  return items.map(item => item.receipt_key ? {
+    ...item,
+    receipt_key: `${item.receipt_key}/${includeFundRecordBalance ? 'wallet' : 'history'}`
+  } : item);
 }
 function getPaymentServiceFee(payment) {
   return new _decimal.default(toMoneyNumber(payment.service_fee));
@@ -2130,9 +2328,11 @@ function buildCashChangePaymentItems(params) {
   } = params;
   if (!shouldDisplayCashChange(payment)) return [];
   return [{
+    ...receiptKey(payment, 'cashReceived'),
     item: label(locale, 'cashReceived'),
     value: formatMoney(payment.metadata.actual_paid_amount, currencySymbol)
   }, {
+    ...receiptKey(payment, 'changeDue'),
     item: label(locale, 'changeDue'),
     value: formatMoney(payment.metadata.change_given_amount, currencySymbol)
   }];
@@ -2169,12 +2369,14 @@ function buildFundRecordPaymentItems(params) {
     const usedPoints = new _decimal.default(toMoneyNumber(usingBeforeValue)).minus(toMoneyNumber(usingAfterValue));
     if (includeUsage) {
       items.push({
+        ...receiptKey(payment, 'redeemPoints'),
         item: label(locale, 'redeemPoints'),
         value: trimDecimal(usedPoints)
       });
     }
     if (includeBalance) {
       items.push({
+        ...receiptKey(payment, 'remainingPoints'),
         item: label(locale, 'remainingPoints'),
         value: trimDecimal(new _decimal.default(toMoneyNumber(usingAfterValue)))
       });
@@ -2185,12 +2387,14 @@ function buildFundRecordPaymentItems(params) {
     if (virtualCurrencyUnit !== undefined) {
       if (!isNumericAmount(usingAfterValue)) return items;
       items.push({
+        ...receiptKey(payment, 'balance'),
         item: label(locale, 'balance'),
         value: formatVirtualCurrencyBalance(new _decimal.default(usingAfterValue), virtualCurrencyUnit)
       });
       return items;
     }
     items.push({
+      ...receiptKey(payment, 'balance'),
       item: label(locale, 'balance'),
       value: formatMoney(usingAfterValue, currencySymbol)
     });