@ticketboothapp/booking 1.2.76 → 1.2.78

package/CHANGE_BOOKING_BE_HANDOFF.md

@@ -100,3 +100,39 @@ Pickers show **catalog** prices by default (same booking **currency** as the ori
 - **Provider change API:** When `pricingAdjustment.additionalAdjustments` includes the same rows, persist them on the new receipt and charge the **same** total as `newTotalAmount` (within your rounding rules).
 
 If the server ignores `manualLineAdjustments` or `additionalAdjustments`, the customer will see the FE total but pay a different amount.
+
+---
+
+## Admin FE-authoritative quote path (new)
+
+For provider dashboard / admin tooling, we need a dedicated quote route where the **frontend is authoritative** for
+the full receipt preview (totals + line items), and BE does not re-price those values.
+
+### Endpoint
+
+- **`POST /1/admin/bookings/:bookingReference/change/quote?lastName=...`**
+
+Keep the public self-serve endpoint unchanged.
+
+### Request contract (admin)
+
+Same selection fields as `ChangeBookingQuoteRequest`, plus:
+
+- `feReceipt`:
+  - `subtotal` (major units)
+  - `tax` (major units)
+  - `total` (major units)
+  - `currency?`
+  - `lineItems: Array<{ label?: string; amount?: number; type?: string; quantity?: number }>`
+- `feAmountDueMajorUnits?` (optional signed delta the FE displays; `newTotal - previousTotal`)
+
+### Backend expectations
+
+- Validate admin auth + booking/availability eligibility only.
+- Persist `feReceipt` on the change intent as the quote source-of-truth.
+- Return a `ChangeBookingQuoteResponse`-compatible payload using the stored FE receipt:
+  - `newReceipt` / `proposed` line items from `feReceipt.lineItems`
+  - `newReceipt.subtotal/tax/total` from `feReceipt`
+  - `amountDueCents` / `balanceDeltaMajorUnits` / `priceDiff` coherent with stored totals
+  - `changeIntentId`, `canProceed`, `reasonIfBlocked`
+- Payment intent + apply/confirm for this change intent must use persisted FE totals/lines (no repricing).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ticketboothapp/booking",
-  "version": "1.2.76",
+  "version": "1.2.78",
   "private": false,
   "sideEffects": [
     "**/*.css",

package/src/components/booking/AdminChangeBookingFlow.tsx

@@ -9,6 +9,7 @@ import {
   cancelReservationBestEffort,
   createPaymentIntent,
   quoteChangeBooking,
+  quoteChangeBookingAdminFeReceipt,
   confirmFreeChangeBooking,
   createChangeBookingPaymentIntent,
   confirmBookingWithoutPayment,
@@ -25,6 +26,7 @@ import {
   isInsufficientCapacityReserveError,
   describeStandardTourCapacityConflictMessage,
   reportReserveCapacityConflictClientContext,
+  type AdminFeAuthoritativeReceipt,
 } from '../../lib/booking-api';
 import {
   EARLIEST_AVAILABILITY_DATE,
@@ -102,6 +104,7 @@ import type { BookingFlowUiOptions } from './booking-flow-ui';
 import type { ProviderDashboardChangeBookingPayload } from './provider-dashboard-change-booking';
 import type { ChangeBookingFlowProps, ChangeFlowSelectionPreview } from './booking-flow-types';
 import { BOOKING_FLOW_ABANDON_EVENT } from '../../providers/booking-dialog-provider';
+import { useEditableSummaryLines } from './useEditableSummaryLines';
 
 /**
  * ## Pricing contract (customer self-serve)
@@ -148,6 +151,26 @@ function omitZeroAmountPromoDiscountSummaryLines(lines: PriceSummaryLine[]): Pri
   });
 }
 
+function mapSummaryLinesToFeReceiptLineItems(lines: PriceSummaryLine[]): NonNullable<AdminFeAuthoritativeReceipt['lineItems']> {
+  return lines.map((line) => {
+    if (line.kind === 'ticket') {
+      return {
+        label: line.category,
+        amount: roundMoney(line.itemTotal),
+        type: 'TICKET',
+        quantity: line.qty,
+      };
+    }
+    const normalizedType = String(line.type ?? '').trim().toUpperCase();
+    return {
+      label: line.label,
+      amount: roundMoney(line.amount),
+      type: normalizedType || undefined,
+      quantity: line.quantity ?? undefined,
+    };
+  });
+}
+
 function formatTicketLineItemsForSummary(lines: Array<{ category: string; qty: number }>): string {
   const labels: Record<string, string> = {
     ADULT: 'adult',
@@ -831,6 +854,10 @@ export function AdminChangeBookingFlow({
     }
   }, [initialValues?.dateTime, companyTimezone]);
   const isProviderDashboardChange = Boolean(onChangeBooking);
+  const useAdminFeAuthoritativeQuote =
+    isAdmin &&
+    isProviderDashboardChange &&
+    Boolean(flowUi?.adminFeAuthoritativeQuoteEnabled);
   /** Any change from an existing booking (public or provider). */
   const isChangeBookingContext = Boolean(initialValues?.bookingReference?.trim());
   /**
@@ -3120,6 +3147,24 @@ export function AdminChangeBookingFlow({
       ),
     [checkoutPriceSummaryLinesForCheckout],
   );
+  const {
+    editableCheckoutPriceSummaryLines,
+    editableSummaryLineAmountInputs,
+    editableSummaryLineLabelInputs,
+    editableSummaryPreSubtotalDelta,
+    editableSummaryPreSubtotalDebugRows,
+    onLineAmountInputChange: handleEditableLineAmountInputChange,
+    onLineAmountInputBlur: handleEditableLineAmountInputBlur,
+    onLineAmountReset: handleEditableLineAmountReset,
+  } = useEditableSummaryLines(
+    checkoutPriceSummaryLinesForCheckout,
+    {
+      enabled: showProviderPricingInlineEditor,
+      onChange: providerPricingUi?.onLineAmountInputChange,
+      onBlur: providerPricingUi?.onLineAmountInputBlur,
+      onReset: providerPricingUi?.onLineAmountReset,
+    },
+  );
 
   // Promo discount from backend (order-level only; rates are pre-promo)
   const [promoDiscountAmount, setPromoDiscountAmount] = useState(0);
@@ -3709,7 +3754,11 @@ export function AdminChangeBookingFlow({
    * UI-only gate — does not alter ticket line items or receipt-floor rules.
    */
   const showChangeFlowManualPriceLines =
-    changeFlowFinalPricePending || selfServePricingConfirmed;
+    hasEffectiveChangeSelection && (changeFlowFinalPricePending || selfServePricingConfirmed);
+  const showAdminCustomLineEditor =
+    isAdmin &&
+    selectedAvailability != null &&
+    totalQuantity > 0;
 
   const displayedChangeAmountsRaw = resolveChangeFlowDisplayedAmounts({
     providerPreview: providerTotalsPreview,
@@ -3741,8 +3790,46 @@ export function AdminChangeBookingFlow({
       ? displayedChangeAmountsRaw.total + adminCustomAdjustmentTotal + adminTaxDeltaForExternalDisplay
       : displayedChangeAmountsRaw.total
   );
+  const displayChangeFlowProposedTotalWithEditableLines = roundMoney(
+    displayChangeFlowProposedTotal + editableSummaryPreSubtotalDelta
+  );
+  const adminFeAuthoritativeReceipt = useMemo((): AdminFeAuthoritativeReceipt => {
+    const hasTaxLine = editableCheckoutPriceSummaryLines.some(
+      (line) => line.kind === 'line' && String(line.type ?? '').toUpperCase() === 'TAX'
+    );
+    const lineItems = mapSummaryLinesToFeReceiptLineItems(editableCheckoutPriceSummaryLines);
+    if (!hasTaxLine && Math.abs(displayChangeFlowTax) >= 0.0005) {
+      lineItems.push({
+        label: t('booking.tax') !== 'booking.tax' ? t('booking.tax') : 'Taxes and fees',
+        amount: roundMoney(displayChangeFlowTax),
+        type: 'TAX',
+      });
+    }
+    let subtotal = roundMoney(displayChangeFlowSubtotal + editableSummaryPreSubtotalDelta);
+    const tax = roundMoney(displayChangeFlowTax);
+    const expectedTotal = roundMoney(displayChangeFlowProposedTotalWithEditableLines);
+    const recomputed = roundMoney(subtotal + tax);
+    if (Math.abs(recomputed - expectedTotal) >= 0.005) {
+      subtotal = roundMoney(expectedTotal - tax);
+    }
+    return {
+      subtotal,
+      tax,
+      total: expectedTotal,
+      currency,
+      lineItems,
+    };
+  }, [
+    editableCheckoutPriceSummaryLines,
+    displayChangeFlowTax,
+    displayChangeFlowSubtotal,
+    editableSummaryPreSubtotalDelta,
+    displayChangeFlowProposedTotalWithEditableLines,
+    currency,
+    t,
+  ]);
 
-  const changeFlowClientEstimateDue = (() => {
+  const changeFlowClientEstimateDueBase = (() => {
     if (!originalReceipt) return totalPrice;
     // Self-serve quote: match BE receipt / intent: (newTotalCents − previousTotalCents) / 100.
     if (isCustomerSelfServeChange && latestChangeQuote != null && !changeQuoteFetchError) {
@@ -3764,6 +3851,9 @@ export function AdminChangeBookingFlow({
       audience: 'admin',
     });
   })();
+  const changeFlowClientEstimateDue = normalizeNearZeroOwed(
+    roundMoney(changeFlowClientEstimateDueBase + editableSummaryPreSubtotalDelta)
+  );
 
   const changeFlowAmountDueRaw = changeFlowClientEstimateDue;
   const changeFlowAmountDue = normalizeNearZeroOwed(changeFlowAmountDueRaw);
@@ -3797,18 +3887,33 @@ export function AdminChangeBookingFlow({
         <pre className="mt-2 max-h-64 overflow-auto whitespace-pre-wrap break-words font-mono text-[11px] leading-relaxed text-stone-800">
           {[
             `Amount-due path: ${path}`,
+            `adminFeAuthoritativeQuoteEnabled: ${String(useAdminFeAuthoritativeQuote)}`,
             `displayLayerUsesExternalPricing: ${String(displayLayerUsesExternalPricing)} (server/provider totals omit FE admin lines until overlaid)`,
             `selfServePricingConfirmed: ${String(selfServePricingConfirmed)} · changeQuoteLoading: ${String(changeQuoteLoading)}`,
             `Cart subtotal (excl. admin custom lines): ${fmt(effectiveSubtotal)}`,
             `Admin custom lines (sum): ${fmt(adminCustomAdjustmentTotal)}`,
+            `Pre-subtotal line overrides:`,
+            ...editableSummaryPreSubtotalDebugRows.map(
+              (row, idx) =>
+                `  ${idx + 1}. ${row.label} | baseline ${fmt(row.baseline)} -> edited ${fmt(row.edited)} (delta ${fmt(row.delta)})`
+            ),
             `Checkout subtotal (incl. admin lines): ${fmt(effectiveSubtotalForCheckout)}`,
             `effectiveTax · promo discount: ${fmt(effectiveTax)} · ${fmt(effectivePromoDiscountAmount)}`,
             `totalPrice (subtotal + tax − promo): ${fmt(totalPrice)}`,
             `changeFlowNewBookingTotal (after cent reconcile vs receipt): ${fmt(changeFlowNewBookingTotal)}`,
             `Displayed layer subtotal / tax / total: ${fmt(displayedChangeAmountsRaw.subtotal)} / ${fmt(displayedChangeAmountsRaw.tax)} / ${fmt(displayedChangeAmountsRaw.total)}`,
-            `displayChangeFlowProposedTotal (summary / preview footer): ${fmt(displayChangeFlowProposedTotal)}`,
+            `Pre-subtotal editable lines delta: ${fmt(editableSummaryPreSubtotalDelta)}`,
+            `displayChangeFlowProposedTotal (base): ${fmt(displayChangeFlowProposedTotal)}`,
+            `displayChangeFlowProposedTotal (with editable lines): ${fmt(displayChangeFlowProposedTotalWithEditableLines)}`,
+            `feReceipt sent subtotal/tax/total: ${fmt(adminFeAuthoritativeReceipt.subtotal)} / ${fmt(adminFeAuthoritativeReceipt.tax)} / ${fmt(adminFeAuthoritativeReceipt.total)}`,
+            `feReceipt sent lineItems count: ${String(adminFeAuthoritativeReceipt.lineItems.length)}`,
             originalReceipt ? `originalReceipt.total: ${fmt(originalReceipt.total)}` : 'originalReceipt: —',
             `Quote serverDisplay.total (if any): ${quoteTotalPreview}`,
+            `Quote serverDisplay subtotal/tax/total: ${
+              latestChangeQuote?.serverDisplay
+                ? `${fmt(latestChangeQuote.serverDisplay.subtotal)} / ${fmt(latestChangeQuote.serverDisplay.tax)} / ${fmt(latestChangeQuote.serverDisplay.total)}`
+                : '—'
+            }`,
             `changeFlowClientEstimateDue (before near-zero): ${fmt(changeFlowClientEstimateDue)}`,
             `changeFlowAmountDue (PriceSummary total row): ${fmt(changeFlowAmountDue)}`,
           ].join('\n')}
@@ -3819,6 +3924,7 @@ export function AdminChangeBookingFlow({
     isAdmin,
     selectedAvailability,
     totalQuantity,
+    useAdminFeAuthoritativeQuote,
     currency,
     locale,
     originalReceipt,
@@ -3830,6 +3936,7 @@ export function AdminChangeBookingFlow({
     changeQuoteLoading,
     effectiveSubtotal,
     adminCustomAdjustmentTotal,
+    editableSummaryPreSubtotalDebugRows,
     effectiveSubtotalForCheckout,
     effectiveTax,
     effectivePromoDiscountAmount,
@@ -3838,7 +3945,10 @@ export function AdminChangeBookingFlow({
     displayedChangeAmountsRaw.subtotal,
     displayedChangeAmountsRaw.tax,
     displayedChangeAmountsRaw.total,
+    editableSummaryPreSubtotalDelta,
     displayChangeFlowProposedTotal,
+    displayChangeFlowProposedTotalWithEditableLines,
+    adminFeAuthoritativeReceipt,
     changeFlowClientEstimateDue,
     changeFlowAmountDue,
   ]);
@@ -3966,7 +4076,7 @@ export function AdminChangeBookingFlow({
         originalReceipt
           ? suppressSelfServeCurrencyUi && !selfServePricingConfirmed
             ? null
-            : displayChangeFlowProposedTotal
+            : displayChangeFlowProposedTotalWithEditableLines
           : totalPrice,
       selectionCurrency: currency,
     };
@@ -3980,7 +4090,7 @@ export function AdminChangeBookingFlow({
     totalPrice,
     currency,
     originalReceipt,
-    displayChangeFlowProposedTotal,
+    displayChangeFlowProposedTotalWithEditableLines,
     suppressSelfServeCurrencyUi,
     selfServePricingConfirmed,
   ]);
@@ -4018,14 +4128,14 @@ export function AdminChangeBookingFlow({
       return;
     }
     onPricePreviewChange({
-      subtotal: originalReceipt ? displayChangeFlowSubtotal : effectiveSubtotalForCheckout,
+      subtotal: originalReceipt ? adminFeAuthoritativeReceipt.subtotal : effectiveSubtotalForCheckout,
       tax:
         !isTaxIncludedInPrice
           ? originalReceipt
-            ? displayChangeFlowTax
+            ? adminFeAuthoritativeReceipt.tax
             : effectiveTax
           : 0,
-      total: originalReceipt ? displayChangeFlowProposedTotal : totalPrice,
+      total: originalReceipt ? displayChangeFlowProposedTotalWithEditableLines : totalPrice,
       currency,
     });
   }, [
@@ -4034,9 +4144,9 @@ export function AdminChangeBookingFlow({
     totalQuantity,
     effectiveSubtotalForCheckout,
     effectiveTax,
-    displayChangeFlowProposedTotal,
-    displayChangeFlowSubtotal,
-    displayChangeFlowTax,
+    displayChangeFlowProposedTotalWithEditableLines,
+    adminFeAuthoritativeReceipt.subtotal,
+    adminFeAuthoritativeReceipt.tax,
     currency,
     isTaxIncludedInPrice,
     originalReceipt,
@@ -4086,7 +4196,7 @@ export function AdminChangeBookingFlow({
           .filter(([, count]) => count > 0)
           .map(([category, count]) => ({ category, count }));
         try {
-          const quote = await quoteChangeBooking({
+          const quoteRequestBase = {
             bookingReference: bookingReferenceForQuote,
             lastName: lastName.trim(),
             newProductId: optionId,
@@ -4107,7 +4217,14 @@ export function AdminChangeBookingFlow({
               previousAvailabilityId: initialValues.availabilityId ?? null,
               previousReturnAvailabilityId: initialValues.returnAvailabilityId ?? null,
             },
-          });
+          };
+          const quote = useAdminFeAuthoritativeQuote
+            ? await quoteChangeBookingAdminFeReceipt({
+                ...quoteRequestBase,
+                feReceipt: adminFeAuthoritativeReceipt,
+                feAmountDueMajorUnits: roundMoney(changeFlowClientEstimateDue),
+              })
+            : await quoteChangeBooking(quoteRequestBase);
           if (seq !== changeQuoteRequestSeq.current) return;
           const slice = sliceChangeQuoteForUi(
             quote,
@@ -4155,6 +4272,7 @@ export function AdminChangeBookingFlow({
     addOnSelections,
     changeFlowInitialTicketCount,
     changeFlowNewBookingTotal,
+    changeFlowClientEstimateDue,
     effectiveSubtotalForCheckout,
     effectiveTax,
     totalPrice,
@@ -4163,6 +4281,8 @@ export function AdminChangeBookingFlow({
     initialValues?.availabilityId,
     initialValues?.returnAvailabilityId,
     adminCustomLinesAsAdditionalAdjustments,
+    adminFeAuthoritativeReceipt,
+    useAdminFeAuthoritativeQuote,
   ]);
 
   // Auto-select product option when date is selected: most popular if set, otherwise first available.
@@ -4683,7 +4803,7 @@ export function AdminChangeBookingFlow({
         if (!changeBookingReference || !changeLastName) {
           throw new Error('Missing booking reference or last name for change quote');
         }
-        const quote = await quoteChangeBooking({
+        const quoteRequestBase = {
           bookingReference: changeBookingReference,
           lastName: changeLastName,
           newProductId: availabilityProductOptionId,
@@ -4698,7 +4818,14 @@ export function AdminChangeBookingFlow({
             : {}),
           clientProposedTotal:
             latestChangeQuote?.serverDisplay?.total ?? changeFlowNewBookingTotal,
-        });
+        };
+        const quote = useAdminFeAuthoritativeQuote
+          ? await quoteChangeBookingAdminFeReceipt({
+              ...quoteRequestBase,
+              feReceipt: adminFeAuthoritativeReceipt,
+              feAmountDueMajorUnits: roundMoney(changeFlowClientEstimateDue),
+            })
+          : await quoteChangeBooking(quoteRequestBase);
         const quoteSlice = sliceChangeQuoteForUi(
           quote,
           {
@@ -5052,7 +5179,7 @@ export function AdminChangeBookingFlow({
           isCustomerSelfServeChange && originalReceipt
             ? {
                 previousTotal: originalReceipt.total,
-                newTotal: displayChangeFlowProposedTotal,
+                newTotal: displayChangeFlowProposedTotalWithEditableLines,
                 differenceTotal: amountDueForCheckout,
               }
             : undefined,
@@ -5158,7 +5285,7 @@ export function AdminChangeBookingFlow({
           addOnSelections: addOnSelections.length > 0 ? addOnSelections : null,
           cancellationPolicyId: cancellationPolicyId ?? initialValues?.cancellationPolicyId ?? null,
           promoCode: appliedPromoCode ?? null,
-          newTotalAmount: displayChangeFlowProposedTotal,
+          newTotalAmount: displayChangeFlowProposedTotalWithEditableLines,
           additionalHoursCount: null,
           pricingAdjustment:
             providerPricingOverrides.length > 0 || mergedProviderAdditionalAdjustments.length > 0
@@ -5531,8 +5658,8 @@ export function AdminChangeBookingFlow({
           {selectedAvailability && (
             <>
             <CheckoutForm
-                priceSummaryLines={checkoutPriceSummaryLinesForCheckout}
-                replacePriceSummary={selfServeCheckoutPlaceholder}
+                priceSummaryLines={editableCheckoutPriceSummaryLines}
+                replacePriceSummary={hasChangeSelection ? selfServeCheckoutPlaceholder : undefined}
                 totalPrice={changeFlowAmountDue}
                 totalSummaryLabel={
                   changeFlowAmountDue < -0.005
@@ -5542,12 +5669,12 @@ export function AdminChangeBookingFlow({
                       ? t('booking.totalOwedForBookingChange')
                       : 'Total owed for booking difference'
                 }
-                subtotal={displayChangeFlowSubtotal}
+                subtotal={adminFeAuthoritativeReceipt.subtotal}
                 taxAmount={
                   !isTaxIncludedInPrice &&
-                  displayChangeFlowTax > 0 &&
+                  adminFeAuthoritativeReceipt.tax > 0 &&
                   !priceSummaryLinesIncludeTaxRow
-                    ? displayChangeFlowTax
+                    ? adminFeAuthoritativeReceipt.tax
                     : 0
                 }
                 taxRate={pricingConfig?.taxRate}
@@ -5573,9 +5700,11 @@ export function AdminChangeBookingFlow({
                   </>
                 }
                 extraBeforeSubtotal={
-                  showChangeFlowManualPriceLines ? (
+                  (showChangeFlowManualPriceLines || showAdminCustomLineEditor) ? (
                   <>
-                    {showProviderPricingInlineEditor && (providerPricingUi?.additionalAdjustments?.length ?? 0) > 0 ? (
+                    {showChangeFlowManualPriceLines &&
+                    showProviderPricingInlineEditor &&
+                    (providerPricingUi?.additionalAdjustments?.length ?? 0) > 0 ? (
                       <div className="space-y-1">
                         {providerPricingUi?.additionalAdjustments?.map((adj) => (
                           <div key={adj.id} className="flex items-center justify-between gap-2 text-sm">
@@ -5589,7 +5718,7 @@ export function AdminChangeBookingFlow({
                               </button>
                               <input
                                 type="text"
-                                className="w-40 rounded border border-stone-300 px-2 py-0.5 text-sm"
+                                className="admin-custom-receipt-input w-40 rounded border border-stone-300 bg-white text-sm text-stone-800 placeholder:text-stone-400"
                                 placeholder="Line description"
                                 value={adj.label}
                                 onChange={(e) =>
@@ -5613,7 +5742,7 @@ export function AdminChangeBookingFlow({
                               <input
                                 type="text"
                                 inputMode="decimal"
-                                className="h-6 w-24 rounded border border-stone-300 bg-white px-2 py-0.5 text-right text-sm font-medium leading-none text-stone-700"
+                                className="admin-custom-receipt-input-amount w-[7rem] shrink-0 rounded-md border border-stone-300 bg-white text-right text-sm font-medium tabular-nums text-stone-800 placeholder:text-stone-400 focus:outline-none focus:ring-2 focus:ring-stone-400/80"
                                 placeholder="0.00"
                                 value={adj.amountInput}
                                 onChange={(e) =>
@@ -5633,7 +5762,7 @@ export function AdminChangeBookingFlow({
                           + add line item
                         </button>
                       </div>
-                    ) : showProviderPricingInlineEditor ? (
+                    ) : showChangeFlowManualPriceLines && showProviderPricingInlineEditor ? (
                       <button
                         type="button"
                         className="rounded border border-stone-300 px-2 py-0.5 text-xs text-stone-600 hover:bg-stone-100"
@@ -5642,6 +5771,7 @@ export function AdminChangeBookingFlow({
                         + add line item
                       </button>
                     ) : null}
+                    {showAdminCustomLineEditor ? (
                     <div className="space-y-3">
                       <div className="flex justify-center">
                         <button
@@ -5755,6 +5885,7 @@ export function AdminChangeBookingFlow({
                         );
                       })}
                     </div>
+                    ) : null}
                   </>
                   ) : null
                 }
@@ -5820,16 +5951,11 @@ export function AdminChangeBookingFlow({
                 attributionConfirmLabel={flowUi?.partnerAttributionConfirmLabel}
                 attributionConfirmed={partnerAttributionConfirmed}
                 onAttributionConfirmedChange={setPartnerAttributionConfirmed}
-                lineAmountInputs={showProviderPricingInlineEditor ? providerPricingUi?.lineAmountInputs : undefined}
-                onLineAmountInputChange={
-                  showProviderPricingInlineEditor ? providerPricingUi?.onLineAmountInputChange : undefined
-                }
-                onLineAmountInputBlur={
-                  showProviderPricingInlineEditor ? providerPricingUi?.onLineAmountInputBlur : undefined
-                }
-                onLineAmountReset={
-                  showProviderPricingInlineEditor ? providerPricingUi?.onLineAmountReset : undefined
-                }
+                lineAmountInputs={editableSummaryLineAmountInputs}
+                onLineAmountInputChange={handleEditableLineAmountInputChange}
+                onLineAmountInputBlur={handleEditableLineAmountInputBlur}
+                onLineAmountReset={handleEditableLineAmountReset}
+                lineLabelInputs={editableSummaryLineLabelInputs}
               />
             </>
           )}

package/src/components/booking/CheckoutForm.tsx

@@ -32,6 +32,9 @@ interface CheckoutFormProps {
   onLineAmountInputChange?: (lineKey: string, value: string) => void;
   onLineAmountInputBlur?: (lineKey: string) => void;
   onLineAmountReset?: (lineKey: string) => void;
+  /** Optional map + handler for inline editable labels in PriceSummary. */
+  lineLabelInputs?: Record<string, string>;
+  onLineLabelInputChange?: (lineKey: string, value: string) => void;
   extraBeforeSubtotal?: ReactNode;
   // Promo (passed as extraBetweenTaxAndTotal content - we'll keep it in parent for now)
   // Contact info
@@ -95,6 +98,8 @@ export function CheckoutForm({
   onLineAmountInputChange,
   onLineAmountInputBlur,
   onLineAmountReset,
+  lineLabelInputs,
+  onLineLabelInputChange,
   extraBeforeSubtotal,
   firstName,
   lastName,
@@ -168,6 +173,8 @@ export function CheckoutForm({
             onLineAmountInputChange={onLineAmountInputChange}
             onLineAmountInputBlur={onLineAmountInputBlur}
             onLineAmountReset={onLineAmountReset}
+            lineLabelInputs={lineLabelInputs}
+            onLineLabelInputChange={onLineLabelInputChange}
             extraBeforeSubtotal={extraBeforeSubtotal}
           />
         )}

package/src/components/booking/PriceBreakdown.tsx

@@ -20,6 +20,8 @@ export interface PriceBreakdownProps {
   onEditableChange?: (value: string) => void;
   onEditableBlur?: () => void;
   onEditableReset?: () => void;
+  editableLabelValue?: string;
+  onEditableLabelChange?: (value: string) => void;
 }
 
 /**
@@ -65,6 +67,8 @@ export function PriceBreakdown({
   onEditableChange,
   onEditableBlur,
   onEditableReset,
+  editableLabelValue,
+  onEditableLabelChange,
 }: PriceBreakdownProps) {
   const [showTooltip, setShowTooltip] = useState(false);
   const { t } = useTranslations();
@@ -81,9 +85,19 @@ export function PriceBreakdown({
   if (!breakdown) {
     return (
       <div className="flex items-center justify-between">
-        <span className="text-sm text-stone-600">
-          {category} {qty > 1 ? `× ${qty}` : ''}
-        </span>
+        {editable && onEditableLabelChange ? (
+          <input
+            type="text"
+            className="h-7 min-w-[10rem] max-w-[16rem] rounded border border-stone-300 bg-white px-2 text-sm text-stone-700"
+            value={editableLabelValue ?? category}
+            onChange={(e) => onEditableLabelChange(e.target.value)}
+            aria-label={`Edit ${category} label`}
+          />
+        ) : (
+          <span className="text-sm text-stone-600">
+            {category} {qty > 1 ? `× ${qty}` : ''}
+          </span>
+        )}
         {editable && onEditableChange ? (
           <div className="flex items-center gap-1">
             {onEditableReset ? (
@@ -101,7 +115,7 @@ export function PriceBreakdown({
             <input
               type="text"
               inputMode="decimal"
-              className="h-6 w-24 rounded border border-stone-300 bg-white px-2 py-0.5 text-right text-sm font-medium leading-none text-stone-700"
+              className="admin-editable-summary-amount-input w-[7rem] shrink-0 rounded-md border border-stone-300 bg-white text-right text-sm font-medium tabular-nums text-stone-800 placeholder:text-stone-400 focus:outline-none focus:ring-2 focus:ring-stone-400/80"
               value={editableValue ?? String(itemTotal)}
               onChange={(e) => onEditableChange(e.target.value)}
               onBlur={onEditableBlur}
@@ -118,9 +132,19 @@ export function PriceBreakdown({
 
   return (
     <div className="flex items-center justify-between gap-3 min-w-0">
-      <span className="text-sm text-stone-600 min-w-0 truncate">
-        {category} {qty > 1 ? `× ${qty}` : ''}
-      </span>
+      {editable && onEditableLabelChange ? (
+        <input
+          type="text"
+          className="h-7 min-w-[10rem] max-w-[16rem] rounded border border-stone-300 bg-white px-2 text-sm text-stone-700"
+          value={editableLabelValue ?? category}
+          onChange={(e) => onEditableLabelChange(e.target.value)}
+          aria-label={`Edit ${category} label`}
+        />
+      ) : (
+        <span className="text-sm text-stone-600 min-w-0 truncate">
+          {category} {qty > 1 ? `× ${qty}` : ''}
+        </span>
+      )}
       <div className="relative flex-shrink-0 whitespace-nowrap">
         {editable && onEditableChange ? (
           <div className="flex items-center gap-1">
@@ -139,7 +163,7 @@ export function PriceBreakdown({
             <input
               type="text"
               inputMode="decimal"
-              className="h-6 w-24 rounded border border-stone-300 bg-white px-2 py-0.5 text-right text-sm font-medium leading-none text-stone-700"
+              className="admin-editable-summary-amount-input w-[7rem] shrink-0 rounded-md border border-stone-300 bg-white text-right text-sm font-medium tabular-nums text-stone-800 placeholder:text-stone-400 focus:outline-none focus:ring-2 focus:ring-stone-400/80"
               value={editableValue ?? String(itemTotal)}
               onChange={(e) => onEditableChange(e.target.value)}
               onBlur={onEditableBlur}

package/src/components/booking/PriceSummary.tsx

@@ -73,8 +73,12 @@ export interface PriceSummaryProps {
   extraAfterTotal?: ReactNode;
   /** Optional map of editable line input values by line key. */
   lineAmountInputs?: Record<string, string>;
+  /** Optional map of editable line label values by line key. */
+  lineLabelInputs?: Record<string, string>;
   /** Optional change handler for inline editable line amounts. */
   onLineAmountInputChange?: (lineKey: string, value: string) => void;
+  /** Optional change handler for inline editable line labels. */
+  onLineLabelInputChange?: (lineKey: string, value: string) => void;
   /** Optional blur handler for enforcing display format (e.g. 2 decimals). */
   onLineAmountInputBlur?: (lineKey: string) => void;
   /** Optional reset handler for inline editable line amounts. */
@@ -102,6 +106,24 @@ function formatLineAmount(
   return formatted;
 }
 
+function shouldAppendQuantitySuffix(type: string | undefined, label: string, quantity: number | null | undefined): boolean {
+  if (quantity == null || quantity <= 1) return false;
+  const normalizedType = String(type ?? '').trim().toUpperCase();
+  const eligibleType =
+    normalizedType === 'TICKET' ||
+    normalizedType === 'FEE' ||
+    normalizedType === 'RETURN_OPTION' ||
+    normalizedType === 'RETURNOPTION' ||
+    normalizedType === 'RETURN';
+  if (!eligibleType) return false;
+  const normalizedLabel = label.toLowerCase();
+  const alreadyHasCountHint =
+    /\bx\s*\d+\b/.test(normalizedLabel) ||
+    /\(\s*x\s*\d+\s*\)/.test(normalizedLabel) ||
+    /\b\d+\s*(person|people|pax|traveler|travellers|ticket|tickets)\b/.test(normalizedLabel);
+  return !alreadyHasCountHint;
+}
+
 function getCurrencySymbol(currency: Currency, locale: Locale): string {
   return formatCurrencyAmount(0, currency, locale).replace(/[0-9\s,.-]/g, '') || currency;
 }
@@ -134,7 +156,9 @@ export function PriceSummary({
   totalLabel,
   extraAfterTotal,
   lineAmountInputs,
+  lineLabelInputs,
   onLineAmountInputChange,
+  onLineLabelInputChange,
   onLineAmountInputBlur,
   onLineAmountReset,
 }: PriceSummaryProps) {
@@ -161,6 +185,7 @@ export function PriceSummary({
   return (
     <div className={`space-y-2 min-w-0 ${className}`}>
       {lines.map((row, index) => {
+        const isBeforeSubtotalBoundary = firstTaxLineIndex < 0 || index < firstTaxLineIndex;
         if (row.kind === 'ticket') {
           return (
             <PriceBreakdown
@@ -171,23 +196,29 @@ export function PriceSummary({
               breakdown={row.breakdown ?? null}
               currency={currency}
               locale={locale}
-              editable={row.editable}
+              editable={Boolean(row.editable && isBeforeSubtotalBoundary)}
               editableValue={row.lineKey ? lineAmountInputs?.[row.lineKey] : undefined}
               onEditableChange={
-                row.editable && row.lineKey && onLineAmountInputChange
+                row.editable && isBeforeSubtotalBoundary && row.lineKey && onLineAmountInputChange
                   ? (value) => onLineAmountInputChange(row.lineKey!, value)
                   : undefined
               }
               onEditableBlur={
-                row.editable && row.lineKey && onLineAmountInputBlur
+                row.editable && isBeforeSubtotalBoundary && row.lineKey && onLineAmountInputBlur
                   ? () => onLineAmountInputBlur(row.lineKey!)
                   : undefined
               }
               onEditableReset={
-                row.editable && row.lineKey && onLineAmountReset
+                row.editable && isBeforeSubtotalBoundary && row.lineKey && onLineAmountReset
                   ? () => onLineAmountReset(row.lineKey!)
                   : undefined
               }
+              editableLabelValue={row.lineKey ? lineLabelInputs?.[row.lineKey] : undefined}
+              onEditableLabelChange={
+                row.editable && isBeforeSubtotalBoundary && row.lineKey && onLineLabelInputChange
+                  ? (value) => onLineLabelInputChange(row.lineKey!, value)
+                  : undefined
+              }
             />
           );
         }
@@ -209,10 +240,20 @@ export function PriceSummary({
             )}
             <div className={`flex justify-between gap-3 min-w-0 ${textSize}`}>
               <span className="text-stone-600 min-w-0 flex items-center gap-1">
-                <span className="min-w-0 truncate">
-                  {label}
-                  {type === 'TICKET' && quantity != null && quantity > 1 ? ` (x${quantity})` : ''}
-                </span>
+                {editable && isBeforeSubtotalBoundary && lineKey && onLineLabelInputChange ? (
+                  <input
+                    type="text"
+                    className="h-7 min-w-[10rem] max-w-[16rem] rounded border border-stone-300 bg-white px-2 text-sm text-stone-700"
+                    value={lineLabelInputs?.[lineKey] ?? label}
+                    onChange={(e) => onLineLabelInputChange(lineKey, e.target.value)}
+                    aria-label={`Edit ${label} label`}
+                  />
+                ) : (
+                  <span className="min-w-0 truncate">
+                    {label}
+                    {shouldAppendQuantitySuffix(type, label, quantity) ? ` (x${quantity})` : ''}
+                  </span>
+                )}
                 {tooltip && <InfoTooltip text={tooltip} />}
               </span>
               {editable && lineKey && onLineAmountInputChange ? (
@@ -232,7 +273,7 @@ export function PriceSummary({
                   <input
                     type="text"
                     inputMode="decimal"
-                    className="h-6 w-24 rounded border border-stone-300 bg-white px-2 py-0.5 text-right text-sm font-medium leading-none text-stone-700"
+                    className="admin-editable-summary-amount-input w-[7rem] shrink-0 rounded-md border border-stone-300 bg-white text-right text-sm font-medium tabular-nums text-stone-800 placeholder:text-stone-400 focus:outline-none focus:ring-2 focus:ring-stone-400/80"
                     value={lineAmountInputs?.[lineKey] ?? String(amount)}
                     onChange={(e) => onLineAmountInputChange(lineKey, e.target.value)}
                     onBlur={() => onLineAmountInputBlur?.(lineKey)}

package/src/components/booking/booking-flow-ui.ts

@@ -65,6 +65,11 @@ export interface BookingFlowUiOptions {
   itineraryStickyTopOffsetPx?: number;
   /** Provider dashboard change flow: quote/override panel shown immediately before confirm CTA. */
   providerDashboardChangePricingUi?: ProviderDashboardChangePricingUi;
+  /**
+   * Admin/provider-dashboard change flow: when true, use the admin FE-authoritative quote API.
+   * This is a rollout flag; public self-serve must stay on the existing public quote endpoint.
+   */
+  adminFeAuthoritativeQuoteEnabled?: boolean;
 }
 
 /**

package/src/components/booking/booking-flow.css

@@ -293,6 +293,14 @@
   padding: 0.5rem 0.75rem;
   min-height: 2.75rem;
 }
+.booking-flow-preflight input.admin-editable-summary-amount-input[type='text'] {
+  box-sizing: border-box;
+  padding: 0.5rem 0.75rem;
+  min-height: 2.75rem;
+  font-size: 0.875rem;
+  line-height: 1.25rem;
+  font-weight: 500;
+}
 .booking-flow-preflight .admin-custom-receipt-line .admin-custom-receipt-segment {
   box-sizing: border-box;
   padding: 0.5rem 0.65rem;

package/src/components/booking/useEditableSummaryLines.ts

@@ -0,0 +1,244 @@
+import { useEffect, useMemo, useState } from 'react';
+import type { PriceSummaryLine } from './PriceSummary';
+import { roundMoney } from '../../lib/booking/change-flow-pricing';
+
+type EditableSummaryLineInputState = {
+  amountInput: string;
+  labelInput: string;
+  amountDirty: boolean;
+  labelDirty: boolean;
+};
+
+type ProviderAmountSync = {
+  enabled: boolean;
+  onChange?: (lineKey: string, value: string) => void;
+  onBlur?: (lineKey: string) => void;
+  onReset?: (lineKey: string) => void;
+};
+
+function getEditableSummaryLineKey(line: PriceSummaryLine, index: number): string {
+  if (line.lineKey) return line.lineKey;
+  return line.kind === 'ticket'
+    ? `change-ticket-${line.category}-${index}`
+    : `change-line-${line.label}-${line.type ?? 'line'}-${index}`;
+}
+
+export function useEditableSummaryLines(
+  checkoutPriceSummaryLinesForCheckout: PriceSummaryLine[],
+  providerAmountSync: ProviderAmountSync,
+) {
+  const [editableSummaryInputsByKey, setEditableSummaryInputsByKey] = useState<
+    Record<string, EditableSummaryLineInputState>
+  >({});
+
+  const editableSummaryLineAmountInputs = useMemo(() => {
+    const out: Record<string, string> = {};
+    for (const [lineKey, state] of Object.entries(editableSummaryInputsByKey)) {
+      out[lineKey] = state.amountInput;
+    }
+    return out;
+  }, [editableSummaryInputsByKey]);
+
+  const editableSummaryLineLabelInputs = useMemo(() => {
+    const out: Record<string, string> = {};
+    for (const [lineKey, state] of Object.entries(editableSummaryInputsByKey)) {
+      out[lineKey] = state.labelInput;
+    }
+    return out;
+  }, [editableSummaryInputsByKey]);
+
+  const editableCheckoutPriceSummaryLines = useMemo((): PriceSummaryLine[] => {
+    const firstTaxLineIndex = checkoutPriceSummaryLinesForCheckout.findIndex(
+      (line) => line.kind === 'line' && String(line.type ?? '').toUpperCase() === 'TAX',
+    );
+    return checkoutPriceSummaryLinesForCheckout.map((line, index) => {
+      const isBeforeSubtotal = firstTaxLineIndex < 0 || index < firstTaxLineIndex;
+      const lineKey = getEditableSummaryLineKey(line, index);
+      const lineInputState = editableSummaryInputsByKey[lineKey];
+      if (line.kind === 'ticket') {
+        const amountInput = lineInputState?.amountInput;
+        const parsedAmount = amountInput == null || amountInput.trim() === '' ? line.itemTotal : Number(amountInput);
+        return {
+          ...line,
+          lineKey,
+          editable: isBeforeSubtotal,
+          category: lineInputState?.labelInput ?? line.category,
+          itemTotal: Number.isFinite(parsedAmount) ? roundMoney(parsedAmount) : line.itemTotal,
+        };
+      }
+      const amountInput = lineInputState?.amountInput;
+      const parsedAmount = amountInput == null || amountInput.trim() === '' ? line.amount : Number(amountInput);
+      return {
+        ...line,
+        lineKey,
+        editable: isBeforeSubtotal,
+        label: lineInputState?.labelInput ?? line.label,
+        amount: Number.isFinite(parsedAmount) ? roundMoney(parsedAmount) : line.amount,
+      };
+    });
+  }, [checkoutPriceSummaryLinesForCheckout, editableSummaryInputsByKey]);
+
+  useEffect(() => {
+    setEditableSummaryInputsByKey((prev) => {
+      const next: Record<string, EditableSummaryLineInputState> = {};
+      for (let i = 0; i < checkoutPriceSummaryLinesForCheckout.length; i += 1) {
+        const line = checkoutPriceSummaryLinesForCheckout[i];
+        const key = getEditableSummaryLineKey(line, i);
+        const baselineAmount =
+          line.kind === 'ticket' ? String(roundMoney(line.itemTotal)) : String(roundMoney(line.amount));
+        const baselineLabel = line.kind === 'ticket' ? line.category : line.label;
+        const current = prev[key];
+        const amountDirty = current?.amountDirty === true;
+        const labelDirty = current?.labelDirty === true;
+        next[key] = {
+          amountInput: amountDirty ? (current?.amountInput ?? baselineAmount) : baselineAmount,
+          labelInput: labelDirty ? (current?.labelInput ?? baselineLabel) : baselineLabel,
+          amountDirty,
+          labelDirty,
+        };
+      }
+      const prevKeys = Object.keys(prev);
+      const nextKeys = Object.keys(next);
+      if (prevKeys.length !== nextKeys.length) return next;
+      const unchanged = nextKeys.every((key) => {
+        const a = prev[key];
+        const b = next[key];
+        return (
+          a?.amountInput === b.amountInput &&
+          a?.labelInput === b.labelInput &&
+          a?.amountDirty === b.amountDirty &&
+          a?.labelDirty === b.labelDirty
+        );
+      });
+      return unchanged ? prev : next;
+    });
+  }, [checkoutPriceSummaryLinesForCheckout]);
+
+  const editableSummaryPreSubtotalDelta = useMemo(() => {
+    const firstTaxLineIndex = checkoutPriceSummaryLinesForCheckout.findIndex(
+      (line) => line.kind === 'line' && String(line.type ?? '').toUpperCase() === 'TAX',
+    );
+    let delta = 0;
+    for (let i = 0; i < checkoutPriceSummaryLinesForCheckout.length; i += 1) {
+      if (firstTaxLineIndex >= 0 && i >= firstTaxLineIndex) break;
+      const line = checkoutPriceSummaryLinesForCheckout[i];
+      const lineKey = getEditableSummaryLineKey(line, i);
+      const baselineAmount = line.kind === 'ticket' ? line.itemTotal : line.amount;
+      const raw = editableSummaryLineAmountInputs[lineKey];
+      const parsed = raw == null || raw.trim() === '' ? baselineAmount : Number(raw);
+      const editedAmount = Number.isFinite(parsed) ? roundMoney(parsed) : baselineAmount;
+      delta += editedAmount - baselineAmount;
+    }
+    return roundMoney(delta);
+  }, [checkoutPriceSummaryLinesForCheckout, editableSummaryLineAmountInputs]);
+
+  const editableSummaryPreSubtotalDebugRows = useMemo(() => {
+    const firstTaxLineIndex = checkoutPriceSummaryLinesForCheckout.findIndex(
+      (line) => line.kind === 'line' && String(line.type ?? '').toUpperCase() === 'TAX',
+    );
+    const rows: Array<{ label: string; baseline: number; edited: number; delta: number }> = [];
+    for (let i = 0; i < checkoutPriceSummaryLinesForCheckout.length; i += 1) {
+      if (firstTaxLineIndex >= 0 && i >= firstTaxLineIndex) break;
+      const line = checkoutPriceSummaryLinesForCheckout[i];
+      const lineKey = getEditableSummaryLineKey(line, i);
+      const baselineAmount = line.kind === 'ticket' ? line.itemTotal : line.amount;
+      const raw = editableSummaryLineAmountInputs[lineKey];
+      const parsed = raw == null || raw.trim() === '' ? baselineAmount : Number(raw);
+      const editedAmount = Number.isFinite(parsed) ? roundMoney(parsed) : baselineAmount;
+      const delta = roundMoney(editedAmount - baselineAmount);
+      rows.push({
+        label: line.kind === 'ticket' ? line.category : line.label,
+        baseline: roundMoney(baselineAmount),
+        edited: editedAmount,
+        delta,
+      });
+    }
+    return rows;
+  }, [checkoutPriceSummaryLinesForCheckout, editableSummaryLineAmountInputs]);
+
+  const onLineAmountInputChange = (lineKey: string, value: string) => {
+    const sanitized = value.replace(/[^0-9.-]/g, '');
+    setEditableSummaryInputsByKey((prev) => {
+      const current = prev[lineKey] ?? {
+        amountInput: '',
+        labelInput: '',
+        amountDirty: false,
+        labelDirty: false,
+      };
+      return {
+        ...prev,
+        [lineKey]: { ...current, amountInput: sanitized, amountDirty: true },
+      };
+    });
+    if (providerAmountSync.enabled) providerAmountSync.onChange?.(lineKey, sanitized);
+  };
+
+  const onLineAmountInputBlur = (lineKey: string) => {
+    setEditableSummaryInputsByKey((prev) => {
+      const current = prev[lineKey];
+      if (!current) return prev;
+      const raw = current.amountInput ?? '';
+      if (raw.trim() === '' || raw === '-' || raw === '.' || raw === '-.') {
+        return prev;
+      }
+      const parsed = Number(raw);
+      if (!Number.isFinite(parsed)) return prev;
+      const normalized = roundMoney(parsed).toFixed(2);
+      if (normalized === raw) return prev;
+      return {
+        ...prev,
+        [lineKey]: { ...current, amountInput: normalized },
+      };
+    });
+    if (providerAmountSync.enabled) providerAmountSync.onBlur?.(lineKey);
+  };
+
+  const onLineAmountReset = (lineKey: string) => {
+    const original = checkoutPriceSummaryLinesForCheckout.find(
+      (line, index) => getEditableSummaryLineKey(line, index) === lineKey,
+    );
+    if (!original) return;
+    const nextValue =
+      original.kind === 'ticket' ? String(roundMoney(original.itemTotal)) : String(roundMoney(original.amount));
+    setEditableSummaryInputsByKey((prev) => {
+      const current = prev[lineKey] ?? {
+        amountInput: nextValue,
+        labelInput: '',
+        amountDirty: false,
+        labelDirty: false,
+      };
+      return {
+        ...prev,
+        [lineKey]: { ...current, amountInput: nextValue, amountDirty: false },
+      };
+    });
+    if (providerAmountSync.enabled) providerAmountSync.onReset?.(lineKey);
+  };
+
+  const onLineLabelInputChange = (lineKey: string, value: string) => {
+    setEditableSummaryInputsByKey((prev) => {
+      const current = prev[lineKey] ?? {
+        amountInput: '',
+        labelInput: '',
+        amountDirty: false,
+        labelDirty: false,
+      };
+      return {
+        ...prev,
+        [lineKey]: { ...current, labelInput: value, labelDirty: true },
+      };
+    });
+  };
+
+  return {
+    editableCheckoutPriceSummaryLines,
+    editableSummaryLineAmountInputs,
+    editableSummaryLineLabelInputs,
+    editableSummaryPreSubtotalDelta,
+    editableSummaryPreSubtotalDebugRows,
+    onLineAmountInputChange,
+    onLineAmountInputBlur,
+    onLineAmountReset,
+    onLineLabelInputChange,
+  };
+}

package/src/lib/booking/change-booking-server-preview.ts

@@ -97,6 +97,7 @@ export function mapQuoteLineItemsToPriceSummaryLines(
       label: label || type || 'Line',
       amount,
       type: summaryType,
+      quantity: qty > 0 ? qty : null,
     });
   }
   return out;

package/src/lib/booking-api.ts

@@ -870,6 +870,30 @@ export interface ChangeBookingQuoteRequest {
   } | null;
 }
 
+/** FE-authored receipt payload for admin quote path (major units, booking currency). */
+export interface AdminFeAuthoritativeReceipt {
+  subtotal: number;
+  tax: number;
+  total: number;
+  currency?: string;
+  lineItems: Array<{
+    label?: string;
+    amount?: number;
+    type?: string;
+    quantity?: number;
+  }>;
+}
+
+/**
+ * Admin quote path where FE is authoritative for receipt lines/totals.
+ * Mirrors {@link ChangeBookingQuoteRequest} selection fields and adds a full receipt payload.
+ */
+export interface AdminChangeBookingQuoteRequest extends ChangeBookingQuoteRequest {
+  feReceipt: AdminFeAuthoritativeReceipt;
+  /** Optional explicit signed delta shown by FE (new total − original total), major units. */
+  feAmountDueMajorUnits?: number;
+}
+
 export interface ChangeBookingQuoteReceipt {
   subtotal?: number;
   tax?: number;
@@ -1108,6 +1132,31 @@ export async function quoteChangeBooking(
     data) as ChangeBookingQuoteResponse;
 }
 
+/** Admin-only quote endpoint: FE-authored receipt totals + line items are authoritative. */
+export async function quoteChangeBookingAdminFeReceipt(
+  request: AdminChangeBookingQuoteRequest
+): Promise<ChangeBookingQuoteResponse> {
+  const { bookingReference, lastName, ...payload } = request;
+  const res = await fetch(
+    `${API_BASE}/1/admin/bookings/${encodeURIComponent(bookingReference)}/change/quote?lastName=${encodeURIComponent(lastName)}`,
+    {
+      method: 'POST',
+      headers: getAuthHeaders(),
+      body: JSON.stringify(payload),
+    }
+  );
+  if (!res.ok) {
+    const err = await parseJsonSafely(res);
+    const message = isApiErrorPayload(err)
+      ? err.errorMessage || err.error || 'Failed to quote admin booking change'
+      : 'Failed to quote admin booking change';
+    throw new Error(message);
+  }
+  const data = await parseJsonSafely(res);
+  return ((data as { data?: ChangeBookingQuoteResponse } | null)?.data ??
+    data) as ChangeBookingQuoteResponse;
+}
+
 export async function createChangeBookingPaymentIntent(
   changeIntentId: string
 ): Promise<CreateChangePaymentIntentResponse> {