@tallyui/pos 3.2.0 → 3.2.1

package/dist/index.d.ts

@@ -245,6 +245,8 @@ interface Order {
     id: string;
     status: 'draft' | 'parked' | 'saved' | 'completed';
     lineItems: LineItem[];
+    fees?: FeeLine[];
+    shipping?: ShippingLine[];
     discounts: AppliedDiscount[];
     payments: Payment[];
     customer: CustomerSummary | null;
@@ -281,6 +283,16 @@ interface DisplayTotals {
     taxMinor: number;
     totalMinor: number;
     lines: DisplayLine[];
+    fees?: Array<{
+        id: string;
+        name: string;
+        amountMinor: number;
+    }>;
+    shipping?: Array<{
+        id: string;
+        name: string;
+        amountMinor: number;
+    }>;
     orderDiscountMinor: number;
 }
 /** One line in the display mode (ADR-063): before any discount, with its own discounts as sub-rows. */
@@ -295,6 +307,8 @@ interface DisplayLine {
 }
 interface LineItem {
     id: string;
+    custom?: true;
+    taxStatus?: 'none';
     productId: string;
     variantId?: string;
     name: string;
@@ -312,6 +326,27 @@ interface LineItem {
     /** Set only when the price's tax mode differs from the order's; named price mode → order mode. */
     priceTaxModeConverted?: 'inclusive-to-exclusive' | 'exclusive-to-inclusive';
 }
+interface ChargeLine {
+    id: string;
+    name: string;
+    amountMinor: number;
+    taxClass?: string;
+    taxStatus: 'taxable' | 'none';
+    taxLines: LineItem['taxLines'];
+    netMinor: number;
+    taxMicros: number;
+}
+interface FeeLine extends ChargeLine {
+}
+interface ShippingLine extends ChargeLine {
+    methodId?: string;
+}
+interface ChargeInput {
+    name: string;
+    amountMinor: number;
+    taxClass?: string;
+    taxStatus?: 'taxable' | 'none';
+}
 interface LineTaxLine {
     code?: string;
     ratePpm: number;
@@ -348,6 +383,8 @@ interface PaymentMethod {
 }
 interface AddLineInput {
     productId: string;
+    custom?: true;
+    taxStatus?: 'taxable' | 'none';
     variantId?: string;
     name: string;
     sku?: string;
@@ -375,6 +412,16 @@ interface OrderBuilder {
         quantity?: number;
     }): string;
     addLine(input: AddLineInput): string;
+    addFee(input: ChargeInput): string;
+    updateFee(id: string, patch: Partial<ChargeInput>): void;
+    removeFee(id: string): void;
+    addShipping(input: ChargeInput & {
+        methodId?: string;
+    }): string;
+    updateShipping(id: string, patch: Partial<ChargeInput & {
+        methodId?: string;
+    }>): void;
+    removeShipping(id: string): void;
     updateQuantity(lineId: string, quantity: number): void;
     /** Sets a line's unit price (a till price edit), in minor units of the order's currency and the line's own tax mode; its discounts and tax are recomputed. */
     setUnitPrice(lineId: string, amountMinor: number): void;
@@ -496,6 +543,14 @@ interface ReceiptData {
         register?: string;
     };
     lineItems: ReceiptLineItem[];
+    fees: Array<{
+        name: string;
+        amountMinor: number;
+    }>;
+    shipping: Array<{
+        name: string;
+        amountMinor: number;
+    }>;
     discounts: {
         label: string;
         amountMinor: number;
@@ -1886,6 +1941,37 @@ declare function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
     canContinue: boolean;
     add(entry: CatalogueEntry<any>, traits: ProductTraits<any>): void;
     setQuantity(lineId: string, quantity: number): void;
+    /** ADR-075: adds a fee; returns its id or the builder's refusal. */
+    addFee(input: ChargeInput): {
+        id: string;
+    } | string;
+    /** ADR-075: updates a fee; returns a refusal or null. */
+    updateFee(id: string, patch: Partial<ChargeInput>): string | null;
+    /** ADR-075: removes a fee; returns a refusal or null. */
+    removeFee(id: string): string | null;
+    /** ADR-075: adds shipping; returns its id or the builder's refusal. */
+    addShipping(input: ChargeInput & {
+        methodId?: string;
+    }): {
+        id: string;
+    } | string;
+    /** ADR-075: updates shipping; returns a refusal or null. */
+    updateShipping(id: string, patch: Partial<ChargeInput & {
+        methodId?: string;
+    }>): string | null;
+    /** ADR-075: removes shipping; returns a refusal or null. */
+    removeShipping(id: string): string | null;
+    /** ADR-075: adds a distinct custom product line; returns its id or the builder's refusal. */
+    addCustomLine(input: {
+        name: string;
+        priceMinor: number;
+        quantity?: number;
+        taxClass?: string;
+        taxStatus?: "taxable" | "none";
+        sku?: string;
+    }): {
+        id: string;
+    } | string;
     /** Sets a line's unit price in minor units of its own tax mode, recomputing discounts and tax; returns a refusal or null. */
     setUnitPrice(lineId: string, amountMinor: number): string | null;
     remove(lineId: string): void;
@@ -2329,4 +2415,4 @@ declare function planLegs(plan: TenderPlan, rowsSinceFrom: {
     };
 };
 
-export { type Actor, type AddLineInput, type AppliedDiscount, type BackendNotFound, type BasketLine, CartError, type CashMovement, type CashMovementCollection, type CatalogueEntry, type Closure, type ClosureCollection, type ClosureContext, type ClosureScope, type CommandTransport, type Correction, CurrencyProvider, type CurrencyProviderProps, type CustomerSummary, DISCOUNTS_UNSUPPORTED, type Discount, type DisplayLine, type DisplayTotals, type FinalizeOptions, type HttpTransportOptions, type LedgerRow, type LineItem, type LineTaxLine, type LogEntry, type LogLevel, type LogSink, type Logger, MAX_TENDER_MINOR, MICROS_PER_MINOR, type Movement$1 as Movement, type MovementType, type Order, type OrderBuilder, type OrderBuilderOptions, OrderContentMismatchError, type OrderManager, type OrderManagerOptions, type OrderOutbox, type OrderOutboxOptions, type OrderTaxTotals, type OutboxState, type ParkedOrderSummary, type Payment, type PaymentMethod, type PaymentTransport, type PlanLeg, type PosOrder, type PosOrderLine, type PosOrderLocalWarning, PosOrderOpenClosedError, type PosOrderPayment, type PosOrderServerFailures, type PosOrderSyncStatus, type RateTaxLine, type ReceiptConfig, type ReceiptData, type ReceiptLineItem, type RecordedFigures, RegisterApprovalRequiredError, type RegisterBucket, RegisterCloseIncompleteError, type RegisterCommand, type RegisterCommandCollection, type RegisterCounters, type RegisterDocument, type RegisterFact, type RegisterHost, RegisterIdInvalidError, RegisterMovementAmountError, RegisterMovementReasonError, RegisterMovementStrandedError, type RegisterOutbox, type RegisterOutboxOptions, type RegisterSession, RegisterSessionAlreadyOpenError, RegisterSessionClosedError, type RegisterSessionCollection, RegisterSessionRequiredError, type RegisterStore, RegisterTenderInProgressError, type Repository, type ResolveStoreSettingsOptions, SALE_SAVING, type SaleStage, type SentOrder, type SplitTab, type StoreSettingsResolution, type StoreSettingsState, TAX_ROUNDING_MIXED_NOTE, type TaxContext, type TaxLineInput, TaxProvider, type TaxProviderProps, type TaxRateMap, type TenderAction, type TenderKey, type TenderLineId, type TenderPlan, type TenderState, type TenderView, type TransportOutcome, UnsupportedOrderVersionError, type UseOrderOutboxOptions, type UseOrderOutboxResult, type UseRegisterOutboxOptions, type UseRegisterOutboxResult, type UseRegisterSessionOptions, activePlan, addEntryToCart, addPosOrderCollection, advancePerpetual, allocateOrderDiscount, appliedMinor, backToSelling, bindRegister, buildClosureDocument, buildReceiptData, buildXReportDocument, callbackSink, cashMovementSchema, catalogueEntries, changeMinor, clampClosureScope, closeNeedsApproval, closeSession, closureCommand, closureSchema, computeOrderTax, consoleSink, countVariance, createBackendNotFound, createHttpCommandTransport, createLogger, createOrderBuilder, createOrderManager, createOrderOutbox, createRegisterOutbox, createRepository, denominationTotal, denominations, deriveExpected, deriveSettled, ensureRegister, evenSplitShareMinor, exportCsv, finalizeOrder, findEntryByCode, formatClosureDate, getBoundRegisterId, getDeviceId, initTenderState, initialTenderState, isServerDecimal, labelKeys, minorToDecimal, mintClosureNumber, mintUuid, movementCommand, movementFieldError, needsAttention, nextSaleCounter, normalizeAmount, observeRegister$, openSession, openSessionSelector, orderDraftSchema, outboxLogger, overThreshold, parkedOrderSummaries$, parseMinor, planLegs, posOrderCollection, posOrderSchema, posOrdersLogger, quickTenderedAmounts, ratePpmFromPercent, readBoundRegister, readRegister, reconcileRegisterCommands, recordMovement, recordRegisterFact, registerCommandCollection, registerCommandSchema, registerCommandsLogger, registerFactsLogger, registerSessionCollection, registerSessionSchema, requireOpenSession, resolveStoreSettings, restoreOrderDraft, roundMicrosToMinor, saleLogger, sameSale, searchProducts, selectClosureRows, sessionOpenCommand, sessionTransitionCommand, stampSession, startCounting, stockOverlay$, stockOverlayAsOf$, taxFiguresForBasket, taxLinesByRate, taxLogger, taxMicros, taxProviderProps, tenderReducer, toOrderCreateEnvelope, unbindRegister, useCurrencyCode, useCurrencyFormatter, useOrderOutbox, useParkedSales, useRegisterOutbox, useRegisterSession, useSale, useStoreSettings, useTax, uuidv7, validAmount, varianceText, variantPriceLabel, voidMovement, withPricingContext, writeClosure, writeOrderDraft };
+export { type Actor, type AddLineInput, type AppliedDiscount, type BackendNotFound, type BasketLine, CartError, type CashMovement, type CashMovementCollection, type CatalogueEntry, type ChargeInput, type ChargeLine, type Closure, type ClosureCollection, type ClosureContext, type ClosureScope, type CommandTransport, type Correction, CurrencyProvider, type CurrencyProviderProps, type CustomerSummary, DISCOUNTS_UNSUPPORTED, type Discount, type DisplayLine, type DisplayTotals, type FeeLine, type FinalizeOptions, type HttpTransportOptions, type LedgerRow, type LineItem, type LineTaxLine, type LogEntry, type LogLevel, type LogSink, type Logger, MAX_TENDER_MINOR, MICROS_PER_MINOR, type Movement$1 as Movement, type MovementType, type Order, type OrderBuilder, type OrderBuilderOptions, OrderContentMismatchError, type OrderManager, type OrderManagerOptions, type OrderOutbox, type OrderOutboxOptions, type OrderTaxTotals, type OutboxState, type ParkedOrderSummary, type Payment, type PaymentMethod, type PaymentTransport, type PlanLeg, type PosOrder, type PosOrderLine, type PosOrderLocalWarning, PosOrderOpenClosedError, type PosOrderPayment, type PosOrderServerFailures, type PosOrderSyncStatus, type RateTaxLine, type ReceiptConfig, type ReceiptData, type ReceiptLineItem, type RecordedFigures, RegisterApprovalRequiredError, type RegisterBucket, RegisterCloseIncompleteError, type RegisterCommand, type RegisterCommandCollection, type RegisterCounters, type RegisterDocument, type RegisterFact, type RegisterHost, RegisterIdInvalidError, RegisterMovementAmountError, RegisterMovementReasonError, RegisterMovementStrandedError, type RegisterOutbox, type RegisterOutboxOptions, type RegisterSession, RegisterSessionAlreadyOpenError, RegisterSessionClosedError, type RegisterSessionCollection, RegisterSessionRequiredError, type RegisterStore, RegisterTenderInProgressError, type Repository, type ResolveStoreSettingsOptions, SALE_SAVING, type SaleStage, type SentOrder, type ShippingLine, type SplitTab, type StoreSettingsResolution, type StoreSettingsState, TAX_ROUNDING_MIXED_NOTE, type TaxContext, type TaxLineInput, TaxProvider, type TaxProviderProps, type TaxRateMap, type TenderAction, type TenderKey, type TenderLineId, type TenderPlan, type TenderState, type TenderView, type TransportOutcome, UnsupportedOrderVersionError, type UseOrderOutboxOptions, type UseOrderOutboxResult, type UseRegisterOutboxOptions, type UseRegisterOutboxResult, type UseRegisterSessionOptions, activePlan, addEntryToCart, addPosOrderCollection, advancePerpetual, allocateOrderDiscount, appliedMinor, backToSelling, bindRegister, buildClosureDocument, buildReceiptData, buildXReportDocument, callbackSink, cashMovementSchema, catalogueEntries, changeMinor, clampClosureScope, closeNeedsApproval, closeSession, closureCommand, closureSchema, computeOrderTax, consoleSink, countVariance, createBackendNotFound, createHttpCommandTransport, createLogger, createOrderBuilder, createOrderManager, createOrderOutbox, createRegisterOutbox, createRepository, denominationTotal, denominations, deriveExpected, deriveSettled, ensureRegister, evenSplitShareMinor, exportCsv, finalizeOrder, findEntryByCode, formatClosureDate, getBoundRegisterId, getDeviceId, initTenderState, initialTenderState, isServerDecimal, labelKeys, minorToDecimal, mintClosureNumber, mintUuid, movementCommand, movementFieldError, needsAttention, nextSaleCounter, normalizeAmount, observeRegister$, openSession, openSessionSelector, orderDraftSchema, outboxLogger, overThreshold, parkedOrderSummaries$, parseMinor, planLegs, posOrderCollection, posOrderSchema, posOrdersLogger, quickTenderedAmounts, ratePpmFromPercent, readBoundRegister, readRegister, reconcileRegisterCommands, recordMovement, recordRegisterFact, registerCommandCollection, registerCommandSchema, registerCommandsLogger, registerFactsLogger, registerSessionCollection, registerSessionSchema, requireOpenSession, resolveStoreSettings, restoreOrderDraft, roundMicrosToMinor, saleLogger, sameSale, searchProducts, selectClosureRows, sessionOpenCommand, sessionTransitionCommand, stampSession, startCounting, stockOverlay$, stockOverlayAsOf$, taxFiguresForBasket, taxLinesByRate, taxLogger, taxMicros, taxProviderProps, tenderReducer, toOrderCreateEnvelope, unbindRegister, useCurrencyCode, useCurrencyFormatter, useOrderOutbox, useParkedSales, useRegisterOutbox, useRegisterSession, useSale, useStoreSettings, useTax, uuidv7, validAmount, varianceText, variantPriceLabel, voidMovement, withPricingContext, writeClosure, writeOrderDraft };

package/dist/index.js

@@ -523,6 +523,8 @@ function createOrderBuilder(options) {
   const currency = options.currency.toUpperCase();
   const orderId = options.id ?? uid();
   let lineItems = [];
+  let fees = [];
+  let shipping = [];
   let orderDiscounts = [];
   let payments = [];
   let customer = null;
@@ -576,8 +578,15 @@ function createOrderBuilder(options) {
     });
     const shares = allocateOrderDiscount(lineAmounts, recalcedOrderDiscounts.reduce((sum, d) => sum + d.amountMinor, 0));
     const lines = lineItems.map((li, index) => recalculateLine(li, shares[index]));
-    const { subtotalMinor, taxMinor, totalMinor } = sumLines(lines, taxContext.rounding);
-    if (taxContext.rounding?.granularity === "per_rate_group_items" && lines.some((li) => li.taxInclusive) && !perRateGroupWarned.has(taxContext)) {
+    const { subtotalMinor } = sumLines(lines, taxContext.rounding);
+    const charges = [...fees, ...shipping];
+    const taxedLines = [...lines, ...charges.map((charge) => ({
+      ...charge,
+      taxInclusive: taxContext.pricesIncludeTax,
+      taxMicros: charge.taxLines.reduce((sum, tax) => sum + BigInt(tax.taxMicros), 0n).toString()
+    }))];
+    const { taxMinor, totalMinor } = sumLines(taxedLines, taxContext.rounding);
+    if (taxContext.rounding?.granularity === "per_rate_group_items" && taxedLines.some((li) => li.taxInclusive) && !perRateGroupWarned.has(taxContext)) {
       perRateGroupWarned.add(taxContext);
       taxLogger.warn("per_rate_group_items with inclusive lines: using per_order figures until the display has a rounding row (#287, #310)");
     }
@@ -601,7 +610,7 @@ function createOrderBuilder(options) {
       (sum, line) => line.discounts.reduce((lineSum, d) => lineSum + d.amountMinor, sum),
       orderDiscountDisplay
     );
-    const displaySubtotal = (taxInclusive ? totalMinor : totalMinor - taxMinor) + displayDiscount;
+    const displaySubtotal = (taxInclusive ? totalMinor : totalMinor - taxMinor) + displayDiscount - charges.reduce((sum, charge) => sum + charge.amountMinor, 0);
     const residue = displaySubtotal - displayLines.reduce((sum, line) => sum + line.amountMinor, 0);
     const converted = lines.flatMap((li, index) => li.taxInclusive === taxInclusive ? [] : [index]);
     const conversions = converted.reduce((count, index) => count + [
@@ -635,7 +644,9 @@ function createOrderBuilder(options) {
       taxMinor,
       totalMinor,
       lines: displayLines,
-      orderDiscountMinor: orderDiscountDisplay
+      orderDiscountMinor: orderDiscountDisplay,
+      ...fees.length ? { fees: fees.map(({ id: id2, name, amountMinor }) => ({ id: id2, name, amountMinor })) } : {},
+      ...shipping.length ? { shipping: shipping.map(({ id: id2, name, amountMinor }) => ({ id: id2, name, amountMinor })) } : {}
     };
     const paidMinor = payments.reduce((sum, p) => sum + p.amountMinor, 0);
     const balanceDueMinor = Math.max(0, totalMinor - paidMinor);
@@ -644,6 +655,8 @@ function createOrderBuilder(options) {
       id: orderId,
       status: "draft",
       lineItems: lines,
+      ...fees.length ? { fees: [...fees] } : {},
+      ...shipping.length ? { shipping: [...shipping] } : {},
       discounts: recalcedOrderDiscounts,
       payments: [...payments],
       customer,
@@ -666,6 +679,42 @@ function createOrderBuilder(options) {
   function emit() {
     subject.next(buildOrder());
   }
+  function recalculateCharge(id2, input) {
+    if (!Number.isInteger(input.amountMinor)) throw new RangeError("Amount must be integer minor units");
+    if (input.amountMinor < 0) throw new RangeError("Amount must be >= 0");
+    if (!input.name.trim()) throw new RangeError("Name must not be empty");
+    const taxStatus = input.taxStatus ?? "taxable";
+    const code = taxContext.getTaxRateCode?.(input.taxClass);
+    const line = recalculateLine({
+      id: id2,
+      productId: id2,
+      name: input.name,
+      sku: "",
+      unitPriceMinor: input.amountMinor,
+      quantity: 1,
+      taxLines: [{
+        ...code !== void 0 ? { code } : {},
+        ratePpm: taxStatus === "none" ? 0 : taxContext.getTaxRatePpm(input.taxClass),
+        taxMicros: "0"
+      }],
+      discounts: [],
+      discountMinor: 0,
+      orderDiscountMinor: 0,
+      netMinor: 0,
+      taxMicros: "0",
+      taxInclusive: taxContext.pricesIncludeTax
+    });
+    return {
+      id: id2,
+      name: input.name,
+      amountMinor: input.amountMinor,
+      taxClass: input.taxClass,
+      taxStatus,
+      taxLines: line.taxLines,
+      netMinor: line.netMinor,
+      taxMicros: Number(line.taxMicros)
+    };
+  }
   function addLine(input) {
     const { productId, variantId, unitPrice } = input;
     const quantity = input.quantity ?? 1;
@@ -673,10 +722,10 @@ function createOrderBuilder(options) {
     if (!Number.isInteger(unitPrice.amount)) throw new RangeError("Price must be integer minor units");
     if (!Number.isInteger(quantity) || quantity < 1) throw new RangeError("Quantity must be an integer >= 1");
     const code = input.taxRates ? void 0 : taxContext.getTaxRateCode?.(input.taxClass);
-    const taxRates = input.taxRates ?? [{ ...code !== void 0 ? { code } : {}, ratePpm: taxContext.getTaxRatePpm(input.taxClass) }];
+    const taxRates = input.taxStatus === "none" ? [{ ...code !== void 0 ? { code } : {}, ratePpm: 0 }] : input.taxRates ?? [{ ...code !== void 0 ? { code } : {}, ratePpm: taxContext.getTaxRatePpm(input.taxClass) }];
     const taxInclusive = unitPrice.taxInclusive ?? taxContext.pricesIncludeTax;
     const existing = lineItems.find(
-      (li) => li.productId === productId && li.variantId === variantId && li.taxInclusive === taxInclusive && li.unitPriceMinor === unitPrice.amount && li.taxLines.length === taxRates.length && li.taxLines.every((tax, index) => tax.code === taxRates[index].code && tax.ratePpm === taxRates[index].ratePpm)
+      (li) => !input.custom && !li.custom && li.productId === productId && li.variantId === variantId && li.taxInclusive === taxInclusive && li.unitPriceMinor === unitPrice.amount && li.taxLines.length === taxRates.length && li.taxLines.every((tax, index) => tax.code === taxRates[index].code && tax.ratePpm === taxRates[index].ratePpm)
     );
     if (existing) {
       lineItems = lineItems.map(
@@ -689,6 +738,8 @@ function createOrderBuilder(options) {
     const line = {
       id: lineId,
       productId,
+      ...input.custom ? { custom: true } : {},
+      ...input.taxStatus === "none" ? { taxStatus: "none" } : {},
       variantId,
       name: input.name,
       sku: input.sku ?? "",
@@ -716,6 +767,43 @@ function createOrderBuilder(options) {
   return {
     order$: subject.asObservable(),
     addLine,
+    addFee(input) {
+      const fee = recalculateCharge(uid(), input);
+      fees = [...fees, fee];
+      emit();
+      return fee.id;
+    },
+    updateFee(id2, patch) {
+      const fee = fees.find((entry) => entry.id === id2);
+      if (!fee) throw new Error(`Unknown fee ${id2}`);
+      const updated = recalculateCharge(id2, { ...fee, ...patch });
+      fees = fees.map((entry) => entry.id === id2 ? updated : entry);
+      emit();
+    },
+    removeFee(id2) {
+      if (!fees.some((entry) => entry.id === id2)) throw new Error(`Unknown fee ${id2}`);
+      fees = fees.filter((entry) => entry.id !== id2);
+      emit();
+    },
+    addShipping(input) {
+      const charge = { ...recalculateCharge(uid(), input), methodId: input.methodId };
+      shipping = [...shipping, charge];
+      emit();
+      return charge.id;
+    },
+    updateShipping(id2, patch) {
+      const charge = shipping.find((entry) => entry.id === id2);
+      if (!charge) throw new Error(`Unknown shipping ${id2}`);
+      const input = { ...charge, ...patch };
+      const updated = { ...recalculateCharge(id2, input), methodId: input.methodId };
+      shipping = shipping.map((entry) => entry.id === id2 ? updated : entry);
+      emit();
+    },
+    removeShipping(id2) {
+      if (!shipping.some((entry) => entry.id === id2)) throw new Error(`Unknown shipping ${id2}`);
+      shipping = shipping.filter((entry) => entry.id !== id2);
+      emit();
+    },
     addProduct(doc, traits, opts) {
       const productId = traits.getId(doc);
       if (!traits.isSellable(doc)) throw new Error("addProduct: this product isn't sold in this store's channel");
@@ -811,6 +899,8 @@ function createOrderBuilder(options) {
     },
     clear() {
       lineItems = [];
+      fees = [];
+      shipping = [];
       orderDiscounts = [];
       payments = [];
       customer = null;
@@ -988,6 +1078,8 @@ function restoreOrderDraft(saved, options) {
   for (const line of saved.lineItems) {
     const lineId = builder.addLine({
       productId: line.productId,
+      custom: line.custom,
+      taxStatus: line.taxStatus,
       variantId: line.variantId,
       name: line.name,
       sku: line.sku,
@@ -1005,6 +1097,8 @@ function restoreOrderDraft(saved, options) {
       });
     }
   }
+  for (const fee of saved.fees ?? []) builder.addFee(fee);
+  for (const charge of saved.shipping ?? []) builder.addShipping(charge);
   for (const discount of saved.discounts) {
     builder.applyOrderDiscount({
       type: discount.type,
@@ -1105,7 +1199,11 @@ function useParkedSales(drafts) {
 
 // src/receipt/build-receipt-data.ts
 function buildReceiptData(order, config) {
-  const taxLines = taxLinesByRate(order.lineItems, order.taxMinor, config.taxLabels, order.taxRounding).map(
+  const taxedLines = [...order.lineItems, ...[...order.fees ?? [], ...order.shipping ?? []].map((charge) => ({
+    ...charge,
+    taxInclusive: order.pricesIncludeTax
+  }))];
+  const taxLines = taxLinesByRate(taxedLines, order.taxMinor, config.taxLabels, order.taxRounding).map(
     ({ label: label2, code, ratePpm, amountMinor }) => ({ label: label2, code, ratePpm, amountMinor })
   );
   let taxSoFar = order.lineItems.reduce(
@@ -1145,6 +1243,8 @@ function buildReceiptData(order, config) {
       label: label(d),
       amountMinor: d.amountMinor
     })),
+    fees: (order.display.fees ?? []).map(({ name, amountMinor }) => ({ name, amountMinor })),
+    shipping: (order.display.shipping ?? []).map(({ name, amountMinor }) => ({ name, amountMinor })),
     orderDiscountMinor: order.display.orderDiscountMinor,
     totals: {
       taxInclusive: order.display.taxInclusive,
@@ -1321,6 +1421,9 @@ function referenceReason(value) {
   return value.includes("\0") ? "nul" : null;
 }
 function finalizeOrder(order, options = {}) {
+  if (order.fees?.length || order.shipping?.length || order.lineItems.some((line) => line.custom)) {
+    throw new Error("finalize: fees, shipping and custom lines need order.create version 5, which this release does not send yet");
+  }
   if (!order.lineItems.length) throw new Error("finalize: no lines");
   if (order.discountMinor < 0 || order.lineItems.some((line) => line.discountMinor < 0) || order.discounts.some((d) => d.amountMinor < 0)) {
     throw new Error("finalize: negative discount");
@@ -3628,10 +3731,10 @@ function useSale(settings, opts) {
     const subscription = rendered.order$.subscribe(setOrder);
     return () => subscription.unsubscribe();
   }, [rendered]);
-  const idle3 = stage.kind === "cart" && !order.lineItems.length;
+  const idle3 = stage.kind === "cart" && !order.lineItems.length && !order.fees?.length && !order.shipping?.length;
   useLayoutEffect(() => {
     const live = builderNow.current.getSnapshot();
-    const liveIdle = stageNow.current.kind === "cart" && !live.lineItems.length && !inFlight.current && !pending.current;
+    const liveIdle = stageNow.current.kind === "cart" && !live.lineItems.length && !live.fees?.length && !live.shipping?.length && !inFlight.current && !pending.current;
     if (liveIdle && (madeWith.current.taxContext !== taxContext || madeWith.current.currency !== settings.currency)) resetSale(live.customer ?? null);
   });
   useEffect4(() => () => {
@@ -3754,6 +3857,85 @@ function useSale(settings, opts) {
     setQuantity(lineId, quantity) {
       if (!locked()) builderNow.current.updateQuantity(lineId, quantity);
     },
+    /** ADR-075: adds a fee; returns its id or the builder's refusal. */
+    addFee(input) {
+      if (locked()) return SALE_SAVING;
+      try {
+        return { id: builderNow.current.addFee(input) };
+      } catch (error2) {
+        if (error2 instanceof Error) return error2.message;
+        throw error2;
+      }
+    },
+    /** ADR-075: updates a fee; returns a refusal or null. */
+    updateFee(id2, patch) {
+      if (locked()) return SALE_SAVING;
+      try {
+        builderNow.current.updateFee(id2, patch);
+        return null;
+      } catch (error2) {
+        if (error2 instanceof Error) return error2.message;
+        throw error2;
+      }
+    },
+    /** ADR-075: removes a fee; returns a refusal or null. */
+    removeFee(id2) {
+      if (locked()) return SALE_SAVING;
+      try {
+        builderNow.current.removeFee(id2);
+        return null;
+      } catch (error2) {
+        if (error2 instanceof Error) return error2.message;
+        throw error2;
+      }
+    },
+    /** ADR-075: adds shipping; returns its id or the builder's refusal. */
+    addShipping(input) {
+      if (locked()) return SALE_SAVING;
+      try {
+        return { id: builderNow.current.addShipping(input) };
+      } catch (error2) {
+        if (error2 instanceof Error) return error2.message;
+        throw error2;
+      }
+    },
+    /** ADR-075: updates shipping; returns a refusal or null. */
+    updateShipping(id2, patch) {
+      if (locked()) return SALE_SAVING;
+      try {
+        builderNow.current.updateShipping(id2, patch);
+        return null;
+      } catch (error2) {
+        if (error2 instanceof Error) return error2.message;
+        throw error2;
+      }
+    },
+    /** ADR-075: removes shipping; returns a refusal or null. */
+    removeShipping(id2) {
+      if (locked()) return SALE_SAVING;
+      try {
+        builderNow.current.removeShipping(id2);
+        return null;
+      } catch (error2) {
+        if (error2 instanceof Error) return error2.message;
+        throw error2;
+      }
+    },
+    /** ADR-075: adds a distinct custom product line; returns its id or the builder's refusal. */
+    addCustomLine(input) {
+      if (locked()) return SALE_SAVING;
+      try {
+        return { id: builderNow.current.addLine({
+          ...input,
+          custom: true,
+          productId: `custom:${uuidv7()}`,
+          unitPrice: { amount: input.priceMinor, currency: madeWith.current.currency.toUpperCase() }
+        }) };
+      } catch (error2) {
+        if (error2 instanceof Error) return error2.message;
+        throw error2;
+      }
+    },
     /** Sets a line's unit price in minor units of its own tax mode, recomputing discounts and tax; returns a refusal or null. */
     setUnitPrice(lineId, amountMinor) {
       if (locked()) return SALE_SAVING;
@@ -3921,7 +4103,7 @@ function useSale(settings, opts) {
       if (stageNow.current.kind !== "cart") return "Finish or cancel the payment before parking the sale";
       const builder = builderNow.current;
       const snapshot = builder.getSnapshot();
-      if (!snapshot.lineItems.length) return "There is nothing to park";
+      if (!snapshot.lineItems.length && !snapshot.fees?.length && !snapshot.shipping?.length) return "There is nothing to park";
       await writeOrderDraft(opts.drafts, snapshot);
       if (builderNow.current !== builder || builder.getSnapshot() !== snapshot) return "The sale changed while it was being parked; park it again";
       resetSale(null);
@@ -3933,7 +4115,7 @@ function useSale(settings, opts) {
       if (!opts.drafts) throw new Error("useSale: resume() needs the drafts option");
       const live = builderNow.current;
       const liveSnapshot = live.getSnapshot();
-      if (stageNow.current.kind !== "cart" || liveSnapshot.lineItems.length) return "Park or clear the current sale first";
+      if (stageNow.current.kind !== "cart" || liveSnapshot.lineItems.length || liveSnapshot.fees?.length || liveSnapshot.shipping?.length) return "Park or clear the current sale first";
       const doc = await opts.drafts.findOne(draftId).exec();
       if (!doc) return "That parked sale is no longer there";
       const saved = JSON.parse(doc.toJSON().data);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tallyui/pos",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "type": "module",
   "description": "Shared POS business logic for Tally UI — tax, orders, payments, discounts, receipts",
   "main": "./dist/index.js",
@@ -27,20 +27,20 @@
     "directory": "packages/pos"
   },
   "peerDependencies": {
-    "@tallyui/core": "^3.2.0",
+    "@tallyui/core": "^3.2.1",
     "react": ">=18",
     "rxdb": "~17.5.0",
     "rxjs": ">=7"
   },
   "devDependencies": {
-    "@tallyui/core": "3.2.0",
+    "@tallyui/core": "3.2.1",
     "@types/react": ">=18",
     "react": "^19.2.4",
     "rxdb": "17.5.0",
     "rxjs": "7.8.2",
-    "@tallyui/connector-medusa": "3.2.0",
-    "@tallyui/connector-woocommerce": "3.2.0",
-    "@tallyui/database": "3.2.0"
+    "@tallyui/connector-medusa": "3.2.1",
+    "@tallyui/connector-woocommerce": "3.2.1",
+    "@tallyui/database": "3.2.1"
   },
   "scripts": {
     "build": "tsup",

package/src/index.ts

@@ -37,6 +37,10 @@ export type {
   LineItem,
   LineTaxLine,
   AddLineInput,
+  ChargeLine,
+  ChargeInput,
+  FeeLine,
+  ShippingLine,
   Discount,
   AppliedDiscount,
   DisplayTotals,

package/src/order/index.ts

@@ -13,6 +13,10 @@ export type {
   LineItem,
   LineTaxLine,
   AddLineInput,
+  ChargeLine,
+  ChargeInput,
+  FeeLine,
+  ShippingLine,
   Discount,
   AppliedDiscount,
   DisplayTotals,

package/src/order/order-builder.ts

@@ -12,6 +12,7 @@ import type {
   Payment,
   CustomerSummary,
   AddLineInput,
+  ChargeInput, ChargeLine, FeeLine, ShippingLine,
 } from './types';
 
 /** Tax contexts already warned that per_rate_group_items fell back to per_order for inclusive lines (#287). */
@@ -27,7 +28,7 @@ function roundHalfAway(n: number): number {
 }
 
 /** The settlement totals of recalculated lines; the display figures derive from them (ADR-063). */
-function sumLines(lines: LineItem[], rounding?: TaxRounding): { subtotalMinor: number; taxMinor: number; totalMinor: number } {
+function sumLines(lines: Pick<LineItem, 'netMinor' | 'taxMicros' | 'taxInclusive' | 'taxLines'>[], rounding?: TaxRounding): { subtotalMinor: number; taxMinor: number; totalMinor: number } {
   // per_line_items, per_rate_group_items (#287): total = Σ rounded nets + tax (order-level-tax-calculation-strategy.js:44-49, order.entity.js:88-89).
   const rounded = roundedTaxByRate(lines, rounding);
   if (rounded) return { subtotalMinor: rounded.baseMinor, taxMinor: rounded.taxMinor, totalMinor: Math.max(0, rounded.baseMinor + rounded.taxMinor) };
@@ -70,6 +71,12 @@ export interface OrderBuilder {
   order$: Observable<Order>;
   addProduct(doc: any, traits: ProductTraits, options?: { variantId?: string; quantity?: number }): string;
   addLine(input: AddLineInput): string;
+  addFee(input: ChargeInput): string;
+  updateFee(id: string, patch: Partial<ChargeInput>): void;
+  removeFee(id: string): void;
+  addShipping(input: ChargeInput & { methodId?: string }): string;
+  updateShipping(id: string, patch: Partial<ChargeInput & { methodId?: string }>): void;
+  removeShipping(id: string): void;
   updateQuantity(lineId: string, quantity: number): void;
   /** Sets a line's unit price (a till price edit), in minor units of the order's currency and the line's own tax mode; its discounts and tax are recomputed. */
   setUnitPrice(lineId: string, amountMinor: number): void;
@@ -91,6 +98,8 @@ export function createOrderBuilder(options: OrderBuilderOptions): OrderBuilder {
   const orderId = options.id ?? uid();
 
   let lineItems: LineItem[] = [];
+  let fees: FeeLine[] = [];
+  let shipping: ShippingLine[] = [];
   let orderDiscounts: AppliedDiscount[] = [];
   let payments: Payment[] = [];
   let customer: CustomerSummary | null = null;
@@ -168,8 +177,12 @@ export function createOrderBuilder(options: OrderBuilderOptions): OrderBuilder {
     const shares = allocateOrderDiscount(lineAmounts, recalcedOrderDiscounts.reduce((sum, d) => sum + d.amountMinor, 0));
     const lines = lineItems.map((li, index) => recalculateLine(li, shares[index]));
 
-    const { subtotalMinor, taxMinor, totalMinor } = sumLines(lines, taxContext.rounding);
-    if (taxContext.rounding?.granularity === 'per_rate_group_items' && lines.some((li) => li.taxInclusive) && !perRateGroupWarned.has(taxContext)) {
+    const { subtotalMinor } = sumLines(lines, taxContext.rounding);
+    const charges = [...fees, ...shipping];
+    const taxedLines = [...lines, ...charges.map((charge) => ({ ...charge, taxInclusive: taxContext.pricesIncludeTax,
+      taxMicros: charge.taxLines.reduce((sum, tax) => sum + BigInt(tax.taxMicros), 0n).toString() }))];
+    const { taxMinor, totalMinor } = sumLines(taxedLines, taxContext.rounding);
+    if (taxContext.rounding?.granularity === 'per_rate_group_items' && taxedLines.some((li) => li.taxInclusive) && !perRateGroupWarned.has(taxContext)) {
       perRateGroupWarned.add(taxContext);
       taxLogger.warn('per_rate_group_items with inclusive lines: using per_order figures until the display has a rounding row (#287, #310)');
     }
@@ -197,7 +210,8 @@ export function createOrderBuilder(options: OrderBuilderOptions): OrderBuilder {
     const orderDiscountDisplay = figures.reduce((sum, f) => sum + f.shareMinor, 0);
     const displayDiscount = displayLines.reduce(
       (sum, line) => line.discounts.reduce((lineSum, d) => lineSum + d.amountMinor, sum), orderDiscountDisplay);
-    const displaySubtotal = (taxInclusive ? totalMinor : totalMinor - taxMinor) + displayDiscount;
+    const displaySubtotal = (taxInclusive ? totalMinor : totalMinor - taxMinor) + displayDiscount
+      - charges.reduce((sum, charge) => sum + charge.amountMinor, 0);
     const residue = displaySubtotal - displayLines.reduce((sum, line) => sum + line.amountMinor, 0);
     const converted = lines.flatMap((li, index) => li.taxInclusive === taxInclusive ? [] : [index]);
     const conversions = converted.reduce((count, index) => count + [lines[index].netMinor, lines[index].orderDiscountMinor,
@@ -230,6 +244,8 @@ export function createOrderBuilder(options: OrderBuilderOptions): OrderBuilder {
     const display = {
       taxInclusive, subtotalMinor: displaySubtotal, discountMinor: displayDiscount, taxMinor, totalMinor,
       lines: displayLines, orderDiscountMinor: orderDiscountDisplay,
+      ...(fees.length ? { fees: fees.map(({ id, name, amountMinor }) => ({ id, name, amountMinor })) } : {}),
+      ...(shipping.length ? { shipping: shipping.map(({ id, name, amountMinor }) => ({ id, name, amountMinor })) } : {}),
     };
     const paidMinor = payments.reduce((sum, p) => sum + p.amountMinor, 0);
     const balanceDueMinor = Math.max(0, totalMinor - paidMinor);
@@ -239,6 +255,8 @@ export function createOrderBuilder(options: OrderBuilderOptions): OrderBuilder {
       id: orderId,
       status: 'draft',
       lineItems: lines,
+      ...(fees.length ? { fees: [...fees] } : {}),
+      ...(shipping.length ? { shipping: [...shipping] } : {}),
       discounts: recalcedOrderDiscounts,
       payments: [...payments],
       customer,
@@ -263,6 +281,23 @@ export function createOrderBuilder(options: OrderBuilderOptions): OrderBuilder {
     subject.next(buildOrder());
   }
 
+  function recalculateCharge(id: string, input: ChargeInput): ChargeLine {
+    if (!Number.isInteger(input.amountMinor)) throw new RangeError('Amount must be integer minor units');
+    if (input.amountMinor < 0) throw new RangeError('Amount must be >= 0');
+    if (!input.name.trim()) throw new RangeError('Name must not be empty');
+    const taxStatus = input.taxStatus ?? 'taxable';
+    const code = taxContext.getTaxRateCode?.(input.taxClass);
+    const line = recalculateLine({
+      id, productId: id, name: input.name, sku: '', unitPriceMinor: input.amountMinor, quantity: 1,
+      taxLines: [{ ...(code !== undefined ? { code } : {}),
+        ratePpm: taxStatus === 'none' ? 0 : taxContext.getTaxRatePpm(input.taxClass), taxMicros: '0' }],
+      discounts: [], discountMinor: 0, orderDiscountMinor: 0, netMinor: 0, taxMicros: '0',
+      taxInclusive: taxContext.pricesIncludeTax,
+    });
+    return { id, name: input.name, amountMinor: input.amountMinor, taxClass: input.taxClass, taxStatus,
+      taxLines: line.taxLines, netMinor: line.netMinor, taxMicros: Number(line.taxMicros) };
+  }
+
   function addLine(input: AddLineInput): string {
     const { productId, variantId, unitPrice } = input;
     const quantity = input.quantity ?? 1;
@@ -271,11 +306,12 @@ export function createOrderBuilder(options: OrderBuilderOptions): OrderBuilder {
     if (!Number.isInteger(quantity) || quantity < 1) throw new RangeError('Quantity must be an integer >= 1');
     // A rate from the tax class carries the backend's name for it when one is mapped (#287, #288).
     const code = input.taxRates ? undefined : taxContext.getTaxRateCode?.(input.taxClass);
-    const taxRates = input.taxRates ?? [{ ...(code !== undefined ? { code } : {}), ratePpm: taxContext.getTaxRatePpm(input.taxClass) }];
+    const taxRates = input.taxStatus === 'none' ? [{ ...(code !== undefined ? { code } : {}), ratePpm: 0 }]
+      : input.taxRates ?? [{ ...(code !== undefined ? { code } : {}), ratePpm: taxContext.getTaxRatePpm(input.taxClass) }];
     const taxInclusive = unitPrice.taxInclusive ?? taxContext.pricesIncludeTax;
 
     const existing = lineItems.find(
-      (li) => li.productId === productId && li.variantId === variantId && li.taxInclusive === taxInclusive
+      (li) => !input.custom && !li.custom && li.productId === productId && li.variantId === variantId && li.taxInclusive === taxInclusive
         && li.unitPriceMinor === unitPrice.amount && li.taxLines.length === taxRates.length
         && li.taxLines.every((tax, index) => tax.code === taxRates[index].code && tax.ratePpm === taxRates[index].ratePpm),
     );
@@ -292,6 +328,8 @@ export function createOrderBuilder(options: OrderBuilderOptions): OrderBuilder {
     const line: LineItem = {
       id: lineId,
       productId,
+      ...(input.custom ? { custom: true as const } : {}),
+      ...(input.taxStatus === 'none' ? { taxStatus: 'none' as const } : {}),
       variantId,
       name: input.name,
       sku: input.sku ?? '',
@@ -324,6 +362,36 @@ export function createOrderBuilder(options: OrderBuilderOptions): OrderBuilder {
     order$: subject.asObservable(),
     addLine,
 
+    addFee(input) {
+      const fee = recalculateCharge(uid(), input);
+      fees = [...fees, fee]; emit(); return fee.id;
+    },
+    updateFee(id, patch) {
+      const fee = fees.find((entry) => entry.id === id);
+      if (!fee) throw new Error(`Unknown fee ${id}`);
+      const updated = recalculateCharge(id, { ...fee, ...patch });
+      fees = fees.map((entry) => entry.id === id ? updated : entry); emit();
+    },
+    removeFee(id) {
+      if (!fees.some((entry) => entry.id === id)) throw new Error(`Unknown fee ${id}`);
+      fees = fees.filter((entry) => entry.id !== id); emit();
+    },
+    addShipping(input) {
+      const charge = { ...recalculateCharge(uid(), input), methodId: input.methodId };
+      shipping = [...shipping, charge]; emit(); return charge.id;
+    },
+    updateShipping(id, patch) {
+      const charge = shipping.find((entry) => entry.id === id);
+      if (!charge) throw new Error(`Unknown shipping ${id}`);
+      const input = { ...charge, ...patch };
+      const updated = { ...recalculateCharge(id, input), methodId: input.methodId };
+      shipping = shipping.map((entry) => entry.id === id ? updated : entry); emit();
+    },
+    removeShipping(id) {
+      if (!shipping.some((entry) => entry.id === id)) throw new Error(`Unknown shipping ${id}`);
+      shipping = shipping.filter((entry) => entry.id !== id); emit();
+    },
+
     addProduct(doc, traits, opts) {
       const productId = traits.getId(doc);
       if (!traits.isSellable(doc)) throw new Error("addProduct: this product isn't sold in this store's channel");
@@ -432,6 +500,8 @@ export function createOrderBuilder(options: OrderBuilderOptions): OrderBuilder {
 
     clear() {
       lineItems = [];
+      fees = [];
+      shipping = [];
       orderDiscounts = [];
       payments = [];
       customer = null;

package/src/order/order-drafts.ts

@@ -65,6 +65,8 @@ export function restoreOrderDraft(saved: Order, options: { currency: string; tax
   for (const line of saved.lineItems) {
     const lineId = builder.addLine({
       productId: line.productId,
+      custom: line.custom,
+      taxStatus: line.taxStatus,
       variantId: line.variantId,
       name: line.name,
       sku: line.sku,
@@ -83,6 +85,9 @@ export function restoreOrderDraft(saved: Order, options: { currency: string; tax
     }
   }
 
+  for (const fee of saved.fees ?? []) builder.addFee(fee);
+  for (const charge of saved.shipping ?? []) builder.addShipping(charge);
+
   // Restore order-level discounts
   for (const discount of saved.discounts) {
     builder.applyOrderDiscount({

package/src/order/types.ts

@@ -4,6 +4,8 @@ export interface Order {
   id: string;
   status: 'draft' | 'parked' | 'saved' | 'completed';
   lineItems: LineItem[];
+  fees?: FeeLine[];
+  shipping?: ShippingLine[];
   discounts: AppliedDiscount[];
   payments: Payment[];
   customer: CustomerSummary | null;
@@ -34,11 +36,13 @@ export type SentOrder = Omit<Order, 'customer'> & { customer: (Omit<CustomerSumm
  */
 export interface DisplayTotals {
   taxInclusive: boolean;      // = order.pricesIncludeTax
-  subtotalMinor: number;      // before discounts: total − tax + discount when exclusive, total + discount when inclusive
+  subtotalMinor: number;      // product lines before discounts, excluding fees and shipping (ADR-075)
   discountMinor: number;      // Σ lines' discount rows + orderDiscountMinor, in the display mode; >= 0
   taxMinor: number;           // = order.taxMinor (added when exclusive, included when inclusive)
   totalMinor: number;         // = order.totalMinor
   lines: DisplayLine[];       // in lineItems order; Σ amountMinor = subtotalMinor
+  fees?: Array<{ id: string; name: string; amountMinor: number }>;
+  shipping?: Array<{ id: string; name: string; amountMinor: number }>;
   orderDiscountMinor: number; // the order discounts as one row, not allocated: Σ each line's share, converted on its own
 }
 
@@ -51,6 +55,8 @@ export interface DisplayLine {
 
 export interface LineItem {
   id: string;
+  custom?: true;
+  taxStatus?: 'none';
   productId: string;
   variantId?: string;
   name: string;
@@ -69,6 +75,20 @@ export interface LineItem {
   priceTaxModeConverted?: 'inclusive-to-exclusive' | 'exclusive-to-inclusive';
 }
 
+export interface ChargeLine {
+  id: string;
+  name: string;
+  amountMinor: number; // integer >= 0, in the order's tax mode (ADR-075)
+  taxClass?: string;
+  taxStatus: 'taxable' | 'none';
+  taxLines: LineItem['taxLines'];
+  netMinor: number;
+  taxMicros: number;
+}
+export interface FeeLine extends ChargeLine {}
+export interface ShippingLine extends ChargeLine { methodId?: string }
+export interface ChargeInput { name: string; amountMinor: number; taxClass?: string; taxStatus?: 'taxable' | 'none' }
+
 export interface LineTaxLine {
   code?: string;
   ratePpm: number;
@@ -113,6 +133,8 @@ export interface PaymentMethod {
 
 export interface AddLineInput {
   productId: string;
+  custom?: true;
+  taxStatus?: 'taxable' | 'none';
   variantId?: string;
   name: string;
   sku?: string;

package/src/pos-order/finalize.ts

@@ -94,6 +94,9 @@ export function referenceReason(value: string | undefined): 'long' | 'nul' | nul
  * customer email or id the shape check would refuse is left out, so `toOrderCreateEnvelope` sends it unchanged.
  */
 export function finalizeOrder(order: Order, options: FinalizeOptions = {}): PosOrder {
+  if (order.fees?.length || order.shipping?.length || order.lineItems.some((line) => line.custom)) {
+    throw new Error('finalize: fees, shipping and custom lines need order.create version 5, which this release does not send yet');
+  }
   if (!order.lineItems.length) throw new Error('finalize: no lines');
   // Defence in depth: the builder already clamps every discount to >= 0, so this should never fire.
   if (order.discountMinor < 0

package/src/receipt/build-receipt-data.ts

@@ -5,7 +5,10 @@ import type { ReceiptConfig, ReceiptData } from './types';
 export function buildReceiptData(order: SentOrder, config: ReceiptConfig): ReceiptData {
   // Drops the shared helper's `netMinor` (the Z report's own use): the receipt's tax summary
   // never showed it, and an exact-shape test elsewhere in this package pins that.
-  const taxLines = taxLinesByRate(order.lineItems, order.taxMinor, config.taxLabels, order.taxRounding).map(
+  const taxedLines = [...order.lineItems, ...[...(order.fees ?? []), ...(order.shipping ?? [])].map((charge) => ({
+    ...charge, taxInclusive: order.pricesIncludeTax,
+  }))];
+  const taxLines = taxLinesByRate(taxedLines, order.taxMinor, config.taxLabels, order.taxRounding).map(
     ({ label, code, ratePpm, amountMinor }) => ({ label, code, ratePpm, amountMinor }),
   );
 
@@ -48,6 +51,8 @@ export function buildReceiptData(order: SentOrder, config: ReceiptConfig): Recei
       label: label(d),
       amountMinor: d.amountMinor,
     })),
+    fees: (order.display.fees ?? []).map(({ name, amountMinor }) => ({ name, amountMinor })),
+    shipping: (order.display.shipping ?? []).map(({ name, amountMinor }) => ({ name, amountMinor })),
     orderDiscountMinor: order.display.orderDiscountMinor,
     totals: {
       taxInclusive: order.display.taxInclusive,

package/src/receipt/types.ts

@@ -21,6 +21,8 @@ export interface ReceiptData {
     register?: string;
   };
   lineItems: ReceiptLineItem[];
+  fees: Array<{ name: string; amountMinor: number }>;
+  shipping: Array<{ name: string; amountMinor: number }>;
   discounts: { label: string; amountMinor: number }[];
   orderDiscountMinor: number;   // the order discounts as one row, in the display mode; + Σ displayDiscounts = totals.discountMinor
   totals: {

package/src/sale/use-sale.ts

@@ -1,8 +1,8 @@
 import { useEffect, useLayoutEffect, useRef, useState } from 'react';
 import type { RxCollection } from 'rxdb';
 import type { ProductTraits, ServerCapabilities, StoreSettings } from '@tallyui/core';
-import { createOrderBuilder, writeOrderDraft, restoreOrderDraft, type OrderBuilder, type CustomerSummary, type Discount, type Order, type SentOrder } from '../order';
-import { finalizeOrder, type PosOrder } from '../pos-order';
+import { createOrderBuilder, writeOrderDraft, restoreOrderDraft, type ChargeInput, type OrderBuilder, type CustomerSummary, type Discount, type Order, type SentOrder } from '../order';
+import { finalizeOrder, uuidv7, type PosOrder } from '../pos-order';
 import { MESSAGE_NAME_MAX, referenceError, referenceReason, withSentForm } from '../pos-order/finalize';
 import { CUSTOMER_REFUSALS, customerRefusal, cutText, PAYLOAD_STRING_MAX } from '../pos-order/command';
 import { useTax } from '../tax';
@@ -137,12 +137,12 @@ export function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
   }, [rendered]);
   // New tax settings or currency wait until the sale is idle (an empty cart), then start a new sale keeping its customer:
   // a sale in progress (lines, tender or receipt) finishes on the settings it started with (a money rule).
-  const idle = stage.kind === 'cart' && !order.lineItems.length;
+  const idle = stage.kind === 'cart' && !order.lineItems.length && !order.fees?.length && !order.shipping?.length;
   // A layout effect, on live idleness (#301): it runs inside the settings' commit, before any tap can be handled, and
   // the rendered `idle` would miss a line added since this render (it would then be dropped with the old builder).
   useLayoutEffect(() => {
     const live = builderNow.current.getSnapshot();
-    const liveIdle = stageNow.current.kind === 'cart' && !live.lineItems.length && !inFlight.current && !pending.current;
+    const liveIdle = stageNow.current.kind === 'cart' && !live.lineItems.length && !live.fees?.length && !live.shipping?.length && !inFlight.current && !pending.current;
     if (liveIdle && (madeWith.current.taxContext !== taxContext || madeWith.current.currency !== settings.currency)) resetSale(live.customer ?? null);
   });
   // A screen that unmounts (medusapos: Sign out) mid-save must still leave a trace of the loss.
@@ -275,6 +275,50 @@ export function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
       }
     },
     setQuantity(lineId: string, quantity: number) { if (!locked()) builderNow.current.updateQuantity(lineId, quantity); },
+    /** ADR-075: adds a fee; returns its id or the builder's refusal. */
+    addFee(input: ChargeInput): { id: string } | string {
+      if (locked()) return SALE_SAVING;
+      try { return { id: builderNow.current.addFee(input) }; }
+      catch (error) { if (error instanceof Error) return error.message; throw error; }
+    },
+    /** ADR-075: updates a fee; returns a refusal or null. */
+    updateFee(id: string, patch: Partial<ChargeInput>): string | null {
+      if (locked()) return SALE_SAVING;
+      try { builderNow.current.updateFee(id, patch); return null; }
+      catch (error) { if (error instanceof Error) return error.message; throw error; }
+    },
+    /** ADR-075: removes a fee; returns a refusal or null. */
+    removeFee(id: string): string | null {
+      if (locked()) return SALE_SAVING;
+      try { builderNow.current.removeFee(id); return null; }
+      catch (error) { if (error instanceof Error) return error.message; throw error; }
+    },
+    /** ADR-075: adds shipping; returns its id or the builder's refusal. */
+    addShipping(input: ChargeInput & { methodId?: string }): { id: string } | string {
+      if (locked()) return SALE_SAVING;
+      try { return { id: builderNow.current.addShipping(input) }; }
+      catch (error) { if (error instanceof Error) return error.message; throw error; }
+    },
+    /** ADR-075: updates shipping; returns a refusal or null. */
+    updateShipping(id: string, patch: Partial<ChargeInput & { methodId?: string }>): string | null {
+      if (locked()) return SALE_SAVING;
+      try { builderNow.current.updateShipping(id, patch); return null; }
+      catch (error) { if (error instanceof Error) return error.message; throw error; }
+    },
+    /** ADR-075: removes shipping; returns a refusal or null. */
+    removeShipping(id: string): string | null {
+      if (locked()) return SALE_SAVING;
+      try { builderNow.current.removeShipping(id); return null; }
+      catch (error) { if (error instanceof Error) return error.message; throw error; }
+    },
+    /** ADR-075: adds a distinct custom product line; returns its id or the builder's refusal. */
+    addCustomLine(input: { name: string; priceMinor: number; quantity?: number; taxClass?: string; taxStatus?: 'taxable' | 'none'; sku?: string }): { id: string } | string {
+      if (locked()) return SALE_SAVING;
+      try {
+        return { id: builderNow.current.addLine({ ...input, custom: true, productId: `custom:${uuidv7()}`,
+          unitPrice: { amount: input.priceMinor, currency: madeWith.current.currency.toUpperCase() } }) };
+      } catch (error) { if (error instanceof Error) return error.message; throw error; }
+    },
     /** Sets a line's unit price in minor units of its own tax mode, recomputing discounts and tax; returns a refusal or null. */
     setUnitPrice(lineId: string, amountMinor: number): string | null {
       if (locked()) return SALE_SAVING;
@@ -435,7 +479,7 @@ export function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
       if (stageNow.current.kind !== 'cart') return 'Finish or cancel the payment before parking the sale';
       const builder = builderNow.current;
       const snapshot = builder.getSnapshot();
-      if (!snapshot.lineItems.length) return 'There is nothing to park';
+      if (!snapshot.lineItems.length && !snapshot.fees?.length && !snapshot.shipping?.length) return 'There is nothing to park';
       await writeOrderDraft(opts.drafts, snapshot);
       if (builderNow.current !== builder || builder.getSnapshot() !== snapshot) return 'The sale changed while it was being parked; park it again';
       resetSale(null);
@@ -447,7 +491,7 @@ export function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
       if (!opts.drafts) throw new Error('useSale: resume() needs the drafts option');
       const live = builderNow.current;
       const liveSnapshot = live.getSnapshot();
-      if (stageNow.current.kind !== 'cart' || liveSnapshot.lineItems.length) return 'Park or clear the current sale first';
+      if (stageNow.current.kind !== 'cart' || liveSnapshot.lineItems.length || liveSnapshot.fees?.length || liveSnapshot.shipping?.length) return 'Park or clear the current sale first';
       const doc = await opts.drafts.findOne(draftId).exec();
       if (!doc) return 'That parked sale is no longer there';
       const saved: Order = JSON.parse(doc.toJSON().data);