@kreiseck/kasseneck-api 1.10.1 → 1.11.1

package/dist/cjs/inventory/vertrag.js

@@ -300,6 +300,7 @@ exports.INVENTORY_ERROR_CODES = [
  */
 exports.INVENTORY_REQUEST_ERROR_CODES = [
     'account_not_found',
+    'action_confirmation_required',
     'admin_required',
     'api_not_approved',
     'app_check_invalid',
@@ -319,6 +320,7 @@ exports.INVENTORY_REQUEST_ERROR_CODES = [
     'register_user_not_allowed',
     'register_user_not_found',
     'response_translation_failed',
+    'second_factor_required',
     'session_expired',
     'session_other_cashregister',
     'unauthorized',

package/dist/cjs/invoice/vertrag.d.ts

@@ -37,7 +37,7 @@ export type InvoiceErrorCode = (typeof INVOICE_ERROR_CODES)[number];
  * genau der Katalog des Servers (das Backend vergleicht ihn mit dem Schema);
  * die Helfer in `./invoice` erkennen beide Listen.
  */
-export declare const INVOICE_REQUEST_ERROR_CODES: readonly ["account_not_found", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "route_missing"];
+export declare const INVOICE_REQUEST_ERROR_CODES: readonly ["account_not_found", "action_confirmation_required", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "second_factor_required", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "route_missing"];
 export type InvoiceRequestErrorCode = (typeof INVOICE_REQUEST_ERROR_CODES)[number];
 /** Gruende einer Gutschrift. Der Server druckt den deutschen Anzeigetext. */
 export declare const CREDIT_NOTE_REASONS: readonly ["cancellation", "price_reduction", "return", "incorrect_invoice", "other"];

package/dist/cjs/invoice/vertrag.js

@@ -91,6 +91,7 @@ exports.INVOICE_ERROR_CODES = [
  */
 exports.INVOICE_REQUEST_ERROR_CODES = [
     'account_not_found',
+    'action_confirmation_required',
     'admin_required',
     'api_not_approved',
     'app_check_invalid',
@@ -110,6 +111,7 @@ exports.INVOICE_REQUEST_ERROR_CODES = [
     'register_user_not_allowed',
     'register_user_not_found',
     'response_translation_failed',
+    'second_factor_required',
     'session_expired',
     'session_other_cashregister',
     'unauthorized',

package/dist/cjs/models/cancellation.d.ts

@@ -1,5 +1,6 @@
 import { KasseneckApiError } from '../client/errors.js';
 import type { Receipt } from './receipt.js';
+import type { ReceiptPaymentInput } from './receipt-payment.js';
 /**
  * Storno-Metadaten — Zwilling von `functions/storno-core.js`.
  *
@@ -53,7 +54,7 @@ export declare function isReturnDisposition(value: unknown): value is ReturnDisp
  * [PAYMENT_ERROR_CODES]. Ein Code ausserhalb bleibt ueber
  * `KasseneckApiError.code` lesbar.
  */
-export declare const CANCELLATION_ERROR_CODES: readonly ["receipt_not_found", "receipt_type_not_cancellable", "training_receipt", "already_cancelled", "invalid_line", "quantity_exceeds_remaining", "unknown_reason", "note_too_long", "invalid_items", "cashregister_not_assigned", "not_permitted", "own_receipts_only", "cashregister_incomplete", "cancellation_failed", "cancellation_payments_required", "cancellation_refund_exceeds_payment", "cancellation_refund_reference_required", "cancellation_refund_reference_unknown", "cancellation_outcome_unknown", "invalid_return_disposition", "account_not_found", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing", "response_unreadable"];
+export declare const CANCELLATION_ERROR_CODES: readonly ["receipt_not_found", "receipt_type_not_cancellable", "training_receipt", "already_cancelled", "invalid_line", "quantity_exceeds_remaining", "unknown_reason", "note_too_long", "invalid_items", "cashregister_not_assigned", "not_permitted", "own_receipts_only", "cashregister_incomplete", "cancellation_failed", "cancellation_payments_required", "cancellation_refund_exceeds_payment", "cancellation_refund_reference_required", "cancellation_refund_reference_unknown", "cancellation_outcome_unknown", "invalid_return_disposition", "tip_refund_conflict", "invalid_tip_refund_source", "tip_refund_source_requires_cash", "tip_keep_not_possible_with_voucher", "account_not_found", "action_confirmation_required", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "second_factor_required", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing", "response_unreadable"];
 export type CancellationErrorCode = (typeof CANCELLATION_ERROR_CODES)[number];
 export declare function isCancellationErrorCode(value: unknown): value is CancellationErrorCode;
 /** Der Code eines geworfenen Fehlers, wenn er in [CANCELLATION_ERROR_CODES] steht; sonst `undefined`. */
@@ -131,3 +132,50 @@ export interface CancellationFieldError {
 }
 /** Die Feldfehler einer `validation`-Antwort; leer, wenn es keine sind. */
 export declare function cancellationFieldErrors(error: unknown): CancellationFieldError[];
+/**
+ * Woher das Trinkgeld beim Storno zurueckkommt: `drawer` – die Lade zahlt es aus („offen“ sinkt,
+ * kann negativ werden); `employee` – die Mitarbeiterin gibt es selbst („verdient“ und „schon
+ * genommen“ sinken, die Lade bleibt unberuehrt). Nur bei Barrueckgabe.
+ */
+export declare const TIP_REFUND_SOURCES: readonly ["drawer", "employee"];
+export type TipRefundSource = (typeof TIP_REFUND_SOURCES)[number];
+export declare function isTipRefundSource(value: unknown): value is TipRefundSource;
+/**
+ * Noch nicht storniertes Mitarbeiter-Trinkgeld in Cent. Groesser 0 heisst: das Storno fragt
+ * „Trinkgeld auch zurueckgeben?“ (auch beim Teilstorno). Inhaber-Trinkgeld ist Umsatz und folgt
+ * der Ware -- dafuer gibt es keine Frage.
+ */
+export declare function openStaffTipCents(receipt: Receipt, nowMs?: number): number;
+/**
+ * Fragt das Storno „Trinkgeld auch zurueckgeben?“ – nur bei noch offenem Mitarbeiter-Trinkgeld und
+ * ohne Wertgutschein am Beleg. Einen Wertgutschein spiegelt nur ein Storno, der alles nimmt; darum
+ * geht das Trinkgeld dort immer mit (der Server weist `refundTip: false` mit
+ * `tip_keep_not_possible_with_voucher` ab), die Kasse zeigt stattdessen
+ * `cancellation.tip_refunded_with_voucher` und sendet `refundTip: true`. Die Frage nach der Quelle
+ * bleibt ([asksTipRefundSource]).
+ */
+export declare function asksRefundTip(receipt: Receipt, nowMs?: number): boolean;
+/**
+ * Die Positionen, die nach der Antwort auf „Trinkgeld auch zurueckgeben?“ hinausgehen -- dieselbe
+ * Regel wie im Backend. `items` fehlt = ganzer Beleg.
+ * - Ja: zum Teilstorno kommt das offene Trinkgeld dazu; der ganze Beleg bleibt `undefined`.
+ * - Nein: ohne das Mitarbeiter-Trinkgeld; der ganze Beleg wird zur Liste aller Restmengen ausser dem
+ *   Trinkgeld (leer = nichts mehr zu stornieren). Ist kein Mitarbeiter-Trinkgeld mehr offen (keines
+ *   oder schon storniert), bleibt der Wunsch, wie er ist – „Nein“ wirkt dann wie keine Wahl.
+ */
+export declare function cancellationItemsForTip(receipt: Receipt, items: readonly CancellationItem[] | undefined, refundTip: boolean, nowMs?: number): CancellationItem[] | undefined;
+/**
+ * Was dieses Storno bar zurueckgibt (positiv, Cent): mit Rueckzahlungen deren Barteil; ohne
+ * (der Server spiegelt die eine Zahlung des Originals) alles, wenn das Original bar bezahlt war.
+ * Bei mehr als einer Zahlung ohne Angabe 0: welcher Teil bar zurueckgeht, ist dann offen (ein
+ * Teilstorno verlangt ohnehin `payments`). Beide Kassen schicken bei mehr als einer Zahlung darum
+ * immer die Rueckzahlungen mit und rechnen hier mit ihnen.
+ */
+export declare function cancellationCashRefundCents(receipt: Receipt, payments: readonly ReceiptPaymentInput[] | undefined, dueCents: number): number;
+/**
+ * Fragt das Storno nach „Ja“ auch „Woher kommt das Trinkgeld zurueck?“ – nur, wenn das Bargeld des
+ * Stornos (`cashRefundCents`, siehe [cancellationCashRefundCents]) das offene Mitarbeiter-Trinkgeld
+ * deckt und die Mitarbeiterin wenigstens eines davon schon hatte. Bei Kartenrueckgabe geht es auf
+ * die Karte zurueck; ueber Lohn behaltenes Trinkgeld kommt immer aus der Lade.
+ */
+export declare function asksTipRefundSource(receipt: Receipt, cashRefundCents: number, nowMs?: number): boolean;

package/dist/cjs/models/cancellation.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_STATUSES = exports.CANCELLATION_ERROR_CODES = exports.RETURN_DISPOSITIONS = exports.CANCELLATION_REASONS = void 0;
+exports.TIP_REFUND_SOURCES = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_STATUSES = exports.CANCELLATION_ERROR_CODES = exports.RETURN_DISPOSITIONS = exports.CANCELLATION_REASONS = void 0;
 exports.isCancellationReason = isCancellationReason;
 exports.isReturnDisposition = isReturnDisposition;
 exports.isCancellationErrorCode = isCancellationErrorCode;
@@ -8,7 +8,14 @@ exports.cancellationErrorCode = cancellationErrorCode;
 exports.isCancellationError = isCancellationError;
 exports.remainingQuantities = remainingQuantities;
 exports.cancellationFieldErrors = cancellationFieldErrors;
+exports.isTipRefundSource = isTipRefundSource;
+exports.openStaffTipCents = openStaffTipCents;
+exports.asksRefundTip = asksRefundTip;
+exports.cancellationItemsForTip = cancellationItemsForTip;
+exports.cancellationCashRefundCents = cancellationCashRefundCents;
+exports.asksTipRefundSource = asksTipRefundSource;
 const fehlercodes_js_1 = require("../client/fehlercodes.js");
+const receipt_item_js_1 = require("./receipt-item.js");
 /**
  * Storno-Metadaten — Zwilling von `functions/storno-core.js`.
  *
@@ -85,8 +92,14 @@ exports.CANCELLATION_ERROR_CODES = Object.freeze([
     'cancellation_refund_reference_unknown', // refundOf nennt keine Zahlung des Originals
     'cancellation_outcome_unknown', // Ausgang unklar: nachlesen, nie wiederholen
     'invalid_return_disposition', // Rueckgabe-Wahl nicht restock, defective oder disposed (Lager)
+    // Trinkgeld beim Storno (refundTip/tipRefundSource, Schichten-Spec Nachtrag 5)
+    'tip_refund_conflict', // Wahl passt nicht zum Storno (Trinkgeld trotz Nein, Quelle ohne Trinkgeld)
+    'invalid_tip_refund_source', // tipRefundSource nicht drawer oder employee
+    'tip_refund_source_requires_cash', // eine Quelle nur, wenn das Bargeld des Stornos das Trinkgeld deckt
+    'tip_keep_not_possible_with_voucher', // refundTip false an einem Beleg mit Wertgutschein (das Trinkgeld geht mit)
     // Anmeldung und Rand (errorCodes.auth ohne Partner-Zugang, errorCodes.edge)
     'account_not_found',
+    'action_confirmation_required',
     'admin_required',
     'api_not_approved',
     'app_check_invalid',
@@ -105,6 +118,7 @@ exports.CANCELLATION_ERROR_CODES = Object.freeze([
     'register_user_not_allowed',
     'register_user_not_found',
     'response_translation_failed',
+    'second_factor_required',
     'session_expired',
     'session_other_cashregister',
     'unauthorized',
@@ -157,3 +171,127 @@ function remainingQuantities(receipt, nowMs = Date.now()) {
 function cancellationFieldErrors(error) {
     return (0, fehlercodes_js_1.feldfehlerVon)(error);
 }
+// --- Trinkgeld beim Storno (Schichten-Spec, Nachtrag 5, R56–R58) --------------------------------
+//
+// Enthaelt ein Beleg noch nicht storniertes Mitarbeiter-Trinkgeld, fragt die Kasse „Trinkgeld auch
+// zurueckgeben?“ (`refundTip`) und bei Barrueckgabe „Woher kommt das Trinkgeld zurueck?“
+// (`tipRefundSource`). Die Regeln stehen hier, damit Web-Kasse und Kassen-App dasselbe fragen;
+// Zwilling von functions/gemeinsam/storno-core.js (wunschMitTrinkgeld, trinkgeldQuelleAnwenden).
+// Faelle mit dem Dart-Zwilling: fixtures/cancellation-tip-cases.json.
+/**
+ * Woher das Trinkgeld beim Storno zurueckkommt: `drawer` – die Lade zahlt es aus („offen“ sinkt,
+ * kann negativ werden); `employee` – die Mitarbeiterin gibt es selbst („verdient“ und „schon
+ * genommen“ sinken, die Lade bleibt unberuehrt). Nur bei Barrueckgabe.
+ */
+exports.TIP_REFUND_SOURCES = Object.freeze(['drawer', 'employee']);
+function isTipRefundSource(value) {
+    return typeof value === 'string' && exports.TIP_REFUND_SOURCES.includes(value);
+}
+/** Barzahlarten -- Zwilling von `BAR_ZAHLARTEN` (functions/gemeinsam/tip-core.js). */
+const BAR_ZAHLARTEN = ['cash', 'uberCash', 'boltCash'];
+/** Zahlart als Nutzlast-Schluessel (Enum-Objekt oder Text). */
+function zahlartWert(m) {
+    if (m !== null && typeof m === 'object' && typeof m.value === 'string')
+        return m.value;
+    return typeof m === 'string' ? m : '';
+}
+const istMitarbeiterTrinkgeld = (item) => (0, receipt_item_js_1.isTipItem)(item) && item.recipient?.owner !== true;
+/**
+ * Hatte die Mitarbeiterin dieses Trinkgeld schon in der Hand (sofort erhalten, mit Empfaenger)?
+ * Ohne Merkmal (Altbestand) gilt wie im Backend: bar = erhalten, sonst nicht.
+ */
+function hatteSie(item, receipt) {
+    if (!item.recipient?.registerUserId)
+        return false;
+    if (typeof item.receivedImmediately === 'boolean')
+        return item.receivedImmediately;
+    return BAR_ZAHLARTEN.includes(zahlartWert(item.paymentMethod ?? receipt.paymentMethod));
+}
+/** Indizes des noch nicht stornierten Mitarbeiter-Trinkgelds mit ihrem Rest. */
+function offenesTrinkgeld(receipt, nowMs) {
+    const rest = remainingQuantities(receipt, nowMs);
+    return receipt.items
+        .map((item, index) => ({ item, index, quantity: rest[index] ?? 0 }))
+        .filter(({ item, quantity }) => quantity > 0 && istMitarbeiterTrinkgeld(item))
+        .map(({ index, quantity }) => ({ index, quantity }));
+}
+/**
+ * Noch nicht storniertes Mitarbeiter-Trinkgeld in Cent. Groesser 0 heisst: das Storno fragt
+ * „Trinkgeld auch zurueckgeben?“ (auch beim Teilstorno). Inhaber-Trinkgeld ist Umsatz und folgt
+ * der Ware -- dafuer gibt es keine Frage.
+ */
+function openStaffTipCents(receipt, nowMs = Date.now()) {
+    return offenesTrinkgeld(receipt, nowMs).reduce((s, { index, quantity }) => s + quantity * (receipt.items[index]?.priceCents ?? 0), 0);
+}
+/** Traegt der Beleg einen Wertgutschein (verkauft oder eingeloest)? Zwilling von storno-core.hatWertgutschein. */
+function hatWertgutschein(receipt) {
+    return (receipt.vouchers ?? []).some((v) => v != null && zahlartWert(v.type) === 'value');
+}
+/**
+ * Fragt das Storno „Trinkgeld auch zurueckgeben?“ – nur bei noch offenem Mitarbeiter-Trinkgeld und
+ * ohne Wertgutschein am Beleg. Einen Wertgutschein spiegelt nur ein Storno, der alles nimmt; darum
+ * geht das Trinkgeld dort immer mit (der Server weist `refundTip: false` mit
+ * `tip_keep_not_possible_with_voucher` ab), die Kasse zeigt stattdessen
+ * `cancellation.tip_refunded_with_voucher` und sendet `refundTip: true`. Die Frage nach der Quelle
+ * bleibt ([asksTipRefundSource]).
+ */
+function asksRefundTip(receipt, nowMs = Date.now()) {
+    return openStaffTipCents(receipt, nowMs) > 0 && !hatWertgutschein(receipt);
+}
+/**
+ * Die Positionen, die nach der Antwort auf „Trinkgeld auch zurueckgeben?“ hinausgehen -- dieselbe
+ * Regel wie im Backend. `items` fehlt = ganzer Beleg.
+ * - Ja: zum Teilstorno kommt das offene Trinkgeld dazu; der ganze Beleg bleibt `undefined`.
+ * - Nein: ohne das Mitarbeiter-Trinkgeld; der ganze Beleg wird zur Liste aller Restmengen ausser dem
+ *   Trinkgeld (leer = nichts mehr zu stornieren). Ist kein Mitarbeiter-Trinkgeld mehr offen (keines
+ *   oder schon storniert), bleibt der Wunsch, wie er ist – „Nein“ wirkt dann wie keine Wahl.
+ */
+function cancellationItemsForTip(receipt, items, refundTip, nowMs = Date.now()) {
+    const trinkgeld = new Set(receipt.items.map((item, i) => (istMitarbeiterTrinkgeld(item) ? i : -1)).filter((i) => i >= 0));
+    if (trinkgeld.size === 0)
+        return items === undefined ? undefined : [...items];
+    if (refundTip) {
+        if (items === undefined)
+            return undefined;
+        const genannt = new Set(items.map((x) => x.index));
+        return [...items, ...offenesTrinkgeld(receipt, nowMs).filter((x) => !genannt.has(x.index))];
+    }
+    if (items !== undefined)
+        return items.filter((x) => !trinkgeld.has(x.index));
+    if (offenesTrinkgeld(receipt, nowMs).length === 0)
+        return undefined;
+    const rest = remainingQuantities(receipt, nowMs);
+    return rest.map((quantity, index) => ({ index, quantity })).filter((x) => x.quantity > 0 && !trinkgeld.has(x.index));
+}
+/**
+ * Was dieses Storno bar zurueckgibt (positiv, Cent): mit Rueckzahlungen deren Barteil; ohne
+ * (der Server spiegelt die eine Zahlung des Originals) alles, wenn das Original bar bezahlt war.
+ * Bei mehr als einer Zahlung ohne Angabe 0: welcher Teil bar zurueckgeht, ist dann offen (ein
+ * Teilstorno verlangt ohnehin `payments`). Beide Kassen schicken bei mehr als einer Zahlung darum
+ * immer die Rueckzahlungen mit und rechnen hier mit ihnen.
+ */
+function cancellationCashRefundCents(receipt, payments, dueCents) {
+    if (payments !== undefined) {
+        return payments.reduce((s, z) => (zahlartWert(z.method) === 'cash' ? s - z.amountCents : s), 0);
+    }
+    const zahlungen = receipt.payments ?? [];
+    if (zahlungen.length > 1)
+        return 0;
+    const methode = zahlungen.length === 1 ? zahlartWert(zahlungen[0].method) : zahlartWert(receipt.paymentMethod);
+    return methode === 'cash' ? dueCents : 0;
+}
+/**
+ * Fragt das Storno nach „Ja“ auch „Woher kommt das Trinkgeld zurueck?“ – nur, wenn das Bargeld des
+ * Stornos (`cashRefundCents`, siehe [cancellationCashRefundCents]) das offene Mitarbeiter-Trinkgeld
+ * deckt und die Mitarbeiterin wenigstens eines davon schon hatte. Bei Kartenrueckgabe geht es auf
+ * die Karte zurueck; ueber Lohn behaltenes Trinkgeld kommt immer aus der Lade.
+ */
+function asksTipRefundSource(receipt, cashRefundCents, nowMs = Date.now()) {
+    // Ohne diese Frage (Karte) und mit `refundTip: true` gilt beim Server: aus der Lade, kein `direkt`.
+    const offen = offenesTrinkgeld(receipt, nowMs);
+    if (offen.length === 0)
+        return false;
+    if (!offen.some(({ index }) => hatteSie(receipt.items[index], receipt)))
+        return false;
+    return cashRefundCents >= openStaffTipCents(receipt, nowMs);
+}

package/dist/cjs/models/index.d.ts

@@ -1,7 +1,7 @@
 export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, isDiscountItem, } from './receipt-item.js';
 export { type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid } from './voucher.js';
-export { type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, readRegistrationInfo, receiptSubSumCents, receiptSumCents, } from './receipt.js';
-export { type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, type ReturnDisposition, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, remainingQuantities, } from './cancellation.js';
+export { type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, readRegistrationInfo, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, } from './receipt.js';
+export { type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, type ReturnDisposition, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, remainingQuantities, TIP_REFUND_SOURCES, type TipRefundSource, isTipRefundSource, openStaffTipCents, cancellationItemsForTip, cancellationCashRefundCents, asksTipRefundSource, asksRefundTip, } from './cancellation.js';
 export { type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, } from './receipt-payment.js';
 export { type PaymentErrorCode, PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors, type PaymentFieldError } from './payment-errors.js';
 export { type ReceiptEmailErrorCode, type ReceiptEmailVia, RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, type ReceiptEmailSendErrorCode, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, type ReceiptEmailFieldError, } from './receipt-email.js';

package/dist/cjs/models/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.remainingQuantities = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptSumCents = exports.receiptSubSumCents = exports.readRegistrationInfo = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isDiscountItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = void 0;
-exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isZeroKind = exports.ZERO_KINDS = void 0;
+exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.asksRefundTip = exports.asksTipRefundSource = exports.cancellationCashRefundCents = exports.cancellationItemsForTip = exports.openStaffTipCents = exports.isTipRefundSource = exports.TIP_REFUND_SOURCES = exports.remainingQuantities = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptValueVoucherSign = exports.receiptSumCents = exports.receiptSubSumCents = exports.readRegistrationInfo = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isDiscountItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = void 0;
+exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = void 0;
 var receipt_item_js_1 = require("./receipt-item.js");
 Object.defineProperty(exports, "toReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.toReceiptItemPayload; } });
 Object.defineProperty(exports, "fromReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.fromReceiptItemPayload; } });
@@ -20,6 +20,7 @@ Object.defineProperty(exports, "fromReceiptPayload", { enumerable: true, get: fu
 Object.defineProperty(exports, "readRegistrationInfo", { enumerable: true, get: function () { return receipt_js_1.readRegistrationInfo; } });
 Object.defineProperty(exports, "receiptSubSumCents", { enumerable: true, get: function () { return receipt_js_1.receiptSubSumCents; } });
 Object.defineProperty(exports, "receiptSumCents", { enumerable: true, get: function () { return receipt_js_1.receiptSumCents; } });
+Object.defineProperty(exports, "receiptValueVoucherSign", { enumerable: true, get: function () { return receipt_js_1.receiptValueVoucherSign; } });
 var cancellation_js_1 = require("./cancellation.js");
 Object.defineProperty(exports, "RETURN_DISPOSITIONS", { enumerable: true, get: function () { return cancellation_js_1.RETURN_DISPOSITIONS; } });
 Object.defineProperty(exports, "CANCELLATION_REASONS", { enumerable: true, get: function () { return cancellation_js_1.CANCELLATION_REASONS; } });
@@ -33,6 +34,13 @@ Object.defineProperty(exports, "cancellationErrorCode", { enumerable: true, get:
 Object.defineProperty(exports, "isCancellationError", { enumerable: true, get: function () { return cancellation_js_1.isCancellationError; } });
 Object.defineProperty(exports, "cancellationFieldErrors", { enumerable: true, get: function () { return cancellation_js_1.cancellationFieldErrors; } });
 Object.defineProperty(exports, "remainingQuantities", { enumerable: true, get: function () { return cancellation_js_1.remainingQuantities; } });
+Object.defineProperty(exports, "TIP_REFUND_SOURCES", { enumerable: true, get: function () { return cancellation_js_1.TIP_REFUND_SOURCES; } });
+Object.defineProperty(exports, "isTipRefundSource", { enumerable: true, get: function () { return cancellation_js_1.isTipRefundSource; } });
+Object.defineProperty(exports, "openStaffTipCents", { enumerable: true, get: function () { return cancellation_js_1.openStaffTipCents; } });
+Object.defineProperty(exports, "cancellationItemsForTip", { enumerable: true, get: function () { return cancellation_js_1.cancellationItemsForTip; } });
+Object.defineProperty(exports, "cancellationCashRefundCents", { enumerable: true, get: function () { return cancellation_js_1.cancellationCashRefundCents; } });
+Object.defineProperty(exports, "asksTipRefundSource", { enumerable: true, get: function () { return cancellation_js_1.asksTipRefundSource; } });
+Object.defineProperty(exports, "asksRefundTip", { enumerable: true, get: function () { return cancellation_js_1.asksRefundTip; } });
 var receipt_payment_js_1 = require("./receipt-payment.js");
 Object.defineProperty(exports, "fromReceiptPaymentPayload", { enumerable: true, get: function () { return receipt_payment_js_1.fromReceiptPaymentPayload; } });
 Object.defineProperty(exports, "toReceiptPaymentPayload", { enumerable: true, get: function () { return receipt_payment_js_1.toReceiptPaymentPayload; } });

package/dist/cjs/models/payment-errors.d.ts

@@ -19,7 +19,7 @@ import { KasseneckApiError } from '../client/errors.js';
  * ...) und zuletzt `route_missing` (Code des Pakets). Ein Code ausserhalb
  * bleibt ueber `KasseneckApiError.code` lesbar.
  */
-export declare const PAYMENT_ERROR_CODES: readonly ["payments_invalid", "payment_method_invalid", "payment_amount_invalid", "payment_tendered_invalid", "payment_provider_invalid", "payment_provider_not_allowed", "payments_sum_mismatch", "payments_due_negative", "payments_not_allowed", "payments_conflict", "payments_required", "payment_method_not_supported", "tip_payment_method_invalid", "tip_payment_method_required", "tip_exceeds_payment", "payment_refund_not_allowed", "payment_tip_invalid", "tip_conflict", "account_not_found", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
+export declare const PAYMENT_ERROR_CODES: readonly ["payments_invalid", "payment_method_invalid", "payment_amount_invalid", "payment_tendered_invalid", "payment_provider_invalid", "payment_provider_not_allowed", "payments_sum_mismatch", "payments_due_negative", "payments_not_allowed", "payments_conflict", "payments_required", "payment_method_not_supported", "tip_payment_method_invalid", "tip_payment_method_required", "tip_exceeds_payment", "payment_refund_not_allowed", "payment_tip_invalid", "tip_conflict", "account_not_found", "action_confirmation_required", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "second_factor_required", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
 export type PaymentErrorCode = (typeof PAYMENT_ERROR_CODES)[number];
 /** Erkennt einen Code aus [PAYMENT_ERROR_CODES], exakt (klein, wie unter `/v3`). */
 export declare function isPaymentErrorCode(value: unknown): value is PaymentErrorCode;

package/dist/cjs/models/payment-errors.js

@@ -47,6 +47,7 @@ exports.PAYMENT_ERROR_CODES = Object.freeze([
     'tip_conflict', // tip und payments[].tipCents zugleich
     // Anmeldung und Rand (errorCodes.auth ohne Partner-Zugang, errorCodes.edge)
     'account_not_found',
+    'action_confirmation_required',
     'admin_required',
     'api_not_approved',
     'app_check_invalid',
@@ -66,6 +67,7 @@ exports.PAYMENT_ERROR_CODES = Object.freeze([
     'register_user_not_allowed',
     'register_user_not_found',
     'response_translation_failed',
+    'second_factor_required',
     'session_expired',
     'session_other_cashregister',
     'unauthorized',

package/dist/cjs/models/receipt-email.d.ts

@@ -11,7 +11,7 @@ export type ReceiptEmailSendErrorCode = (typeof RECEIPT_EMAIL_SEND_ERROR_CODES)[
  * als [KasseneckApiError.code] durch; ein Code ausserhalb bleibt dort lesbar.
  * Zuletzt `route_missing` (Code des Pakets).
  */
-export declare const RECEIPT_EMAIL_ERROR_CODES: readonly ["invalid_address", "receipt_not_found", "too_many_requests", "send_failed", "account_not_found", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
+export declare const RECEIPT_EMAIL_ERROR_CODES: readonly ["invalid_address", "receipt_not_found", "too_many_requests", "send_failed", "account_not_found", "action_confirmation_required", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "second_factor_required", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
 export type ReceiptEmailErrorCode = (typeof RECEIPT_EMAIL_ERROR_CODES)[number];
 export declare function isReceiptEmailErrorCode(value: unknown): value is ReceiptEmailErrorCode;
 /** Der Code eines geworfenen Fehlers, wenn er in [RECEIPT_EMAIL_ERROR_CODES] steht; sonst `undefined`. */

package/dist/cjs/models/receipt-email.js

@@ -26,6 +26,7 @@ exports.RECEIPT_EMAIL_ERROR_CODES = Object.freeze([
     ...exports.RECEIPT_EMAIL_SEND_ERROR_CODES,
     // Anmeldung und Rand (errorCodes.auth ohne Partner-Zugang, errorCodes.edge)
     'account_not_found',
+    'action_confirmation_required',
     'admin_required',
     'api_not_approved',
     'app_check_invalid',
@@ -45,6 +46,7 @@ exports.RECEIPT_EMAIL_ERROR_CODES = Object.freeze([
     'register_user_not_allowed',
     'register_user_not_found',
     'response_translation_failed',
+    'second_factor_required',
     'session_expired',
     'session_other_cashregister',
     'unauthorized',

package/dist/cjs/models/receipt-errors.d.ts

@@ -16,7 +16,7 @@ import { KasseneckApiError } from '../client/errors.js';
  * ...) stehen in [PAYMENT_ERROR_CODES]. Ein Code ausserhalb bleibt ueber
  * `KasseneckApiError.code` lesbar.
  */
-export declare const RECEIPT_ERROR_CODES: readonly ["cancellation_reference_unavailable", "cashregister_closed", "cashregister_decommissioned", "final_receipt_expired", "final_receipt_not_allowed", "module_inactive", "not_permitted", "receipt_limit_exceeded", "receipt_not_found", "receipt_outcome_unknown", "receipt_type_invalid", "signature_incomplete", "signature_missing", "signing_failed", "small_business_vat_not_allowed", "tip_invalid", "tip_not_allowed", "tip_recipient_unknown", "validation", "account_not_found", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "route_missing", "response_unreadable"];
+export declare const RECEIPT_ERROR_CODES: readonly ["cancellation_reference_unavailable", "cashregister_closed", "cashregister_decommissioned", "final_receipt_expired", "final_receipt_not_allowed", "module_inactive", "not_permitted", "receipt_limit_exceeded", "receipt_not_found", "receipt_outcome_unknown", "receipt_type_invalid", "signature_incomplete", "signature_missing", "signing_failed", "small_business_vat_not_allowed", "tip_invalid", "tip_not_allowed", "tip_recipient_unknown", "validation", "account_not_found", "action_confirmation_required", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "second_factor_required", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "route_missing", "response_unreadable"];
 export type ReceiptErrorCode = (typeof RECEIPT_ERROR_CODES)[number];
 export declare function isReceiptErrorCode(value: unknown): value is ReceiptErrorCode;
 /** Der Code eines geworfenen Fehlers, wenn er in [RECEIPT_ERROR_CODES] steht; sonst `undefined`. */

package/dist/cjs/models/receipt-errors.js

@@ -45,6 +45,7 @@ exports.RECEIPT_ERROR_CODES = Object.freeze([
     'validation',
     // Anmeldung und Rand (errorCodes.auth ohne Partner-Zugang, errorCodes.edge)
     'account_not_found',
+    'action_confirmation_required',
     'admin_required',
     'api_not_approved',
     'app_check_invalid',
@@ -64,6 +65,7 @@ exports.RECEIPT_ERROR_CODES = Object.freeze([
     'register_user_not_allowed',
     'register_user_not_found',
     'response_translation_failed',
+    'second_factor_required',
     'session_expired',
     'session_other_cashregister',
     'unauthorized',

package/dist/cjs/models/receipt-item.d.ts

@@ -46,6 +46,12 @@ export interface ReceiptItem {
      * behaelt der Betrieb es und schuldet es (`false`)? Fehlt bei Altbelegen.
      */
     receivedImmediately?: boolean;
+    /**
+     * Nur Personal-Trinkgeld bar: die Mitarbeiterin hat es beim Verkauf gleich
+     * eingesteckt („gleich behalten“). Nur ein Merkmal fuer den Kassenstand;
+     * fehlt sonst.
+     */
+    keptByEmployee?: boolean;
     /**
      * Artikel-Verweis (Artikelstamm) — Grundlage der Erloesgruppen-Zuordnung
      * im Bericht. Optional; Handeingaben haben keinen.
@@ -81,6 +87,8 @@ export interface ReceiptItemPayload {
     recipient?: TipRecipient | null;
     paymentMethod?: string;
     receivedImmediately?: boolean;
+    /** Trinkgeld-Position, siehe [ReceiptItem.keptByEmployee]; nur `true`. */
+    keptByEmployee?: boolean;
     /** Artikel-Verweis, siehe [ReceiptItem.articleId]. */
     articleId?: string;
 }
@@ -106,6 +114,8 @@ export interface ReceiptItemPayloadRead {
     paymentMethod?: string | null;
     /** Trinkgeld-Position, siehe [ReceiptItem.receivedImmediately]. */
     receivedImmediately?: boolean | null;
+    /** Trinkgeld-Position, siehe [ReceiptItem.keptByEmployee]. */
+    keptByEmployee?: boolean | null;
     /** v2: Menge */
     quantity?: number | null;
     /** v2: Einzelpreis in Cent */

package/dist/cjs/models/receipt-item.js

@@ -39,6 +39,8 @@ function toReceiptItemPayload(item) {
             nutzlast.paymentMethod = item.paymentMethod;
         if (typeof item.receivedImmediately === 'boolean')
             nutzlast.receivedImmediately = item.receivedImmediately;
+        if (item.keptByEmployee === true)
+            nutzlast.keptByEmployee = true;
     }
     // Rabatt-Kennzeichnung reist mit — sonst kaeme ein Storno dieser Position
     // am Bon wieder als gewoehnliche Warenzeile mit "1 x" an.
@@ -84,6 +86,7 @@ function fromReceiptItemPayload(payload) {
                 recipient: payload.recipient ?? null,
                 ...(payload.paymentMethod != null ? { paymentMethod: payload.paymentMethod } : {}),
                 ...(typeof payload.receivedImmediately === 'boolean' ? { receivedImmediately: payload.receivedImmediately } : {}),
+                ...(payload.keptByEmployee === true ? { keptByEmployee: true } : {}),
             }
             : payload.kind === 'discount'
                 ? { kind: 'discount' }

package/dist/cjs/models/receipt.d.ts

@@ -143,11 +143,29 @@ export declare function readRegistrationInfo(roh: {
     cardRegisteredAt?: unknown;
     cashregisterRegisteredAt?: unknown;
 }): RegistrationInfo;
+/**
+ * Vorzeichen der Wertgutscheine am Beleg: am Storno-Beleg -1, sonst 1.
+ *
+ * Das Backend spiegelt Wertgutscheine beim Vollstorno mit UNVERAENDERTER
+ * `action` und positivem Wert (storno-core.stornoVouchers); der Fluss dreht
+ * sich am Storno um (zahlungen-core.wertgutscheinFlussCents, hier
+ * `receiptDueCents`): ein verkaufter Gutschein wird zurueckgezahlt, ein
+ * eingeloester mindert die Rueckzahlung.
+ */
+export declare function receiptValueVoucherSign(receipt: Receipt): 1 | -1;
 /**
  * Zwischensumme in **Cent** — Positionen plus verkaufte Wertgutscheine minus
  * eingeloeste Promotionsgutscheine. Wertgutschein-Einloesungen wirken erst auf
  * [receiptSumCents], nicht hier (siehe Dart-Vorbild `subSumCents`/`sumCents`).
+ * Am Storno-Beleg zaehlen Wertgutscheine mit umgekehrtem Vorzeichen
+ * ([receiptValueVoucherSign]), und ein gespiegelter Promotionsgutschein
+ * mindert nichts: den Rabatt nimmt der Server dort ueber Ausgleichspositionen
+ * (`kind: 'discount'`) zurueck, und belegToepfe verteilt einen Promo-Eintrag
+ * nur auf eine positive Topfsumme, die ein Storno nie hat.
  */
 export declare function receiptSubSumCents(receipt: Receipt): number;
-/** Gesamtsumme in **Cent** — Zwischensumme minus eingeloeste Wertgutscheine. */
+/**
+ * Gesamtsumme in **Cent** — Zwischensumme minus eingeloeste Wertgutscheine
+ * (am Storno-Beleg plus, siehe [receiptValueVoucherSign]).
+ */
 export declare function receiptSumCents(receipt: Receipt): number;

package/dist/cjs/models/receipt.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.toReceiptPayload = toReceiptPayload;
 exports.fromReceiptPayload = fromReceiptPayload;
 exports.readRegistrationInfo = readRegistrationInfo;
+exports.receiptValueVoucherSign = receiptValueVoucherSign;
 exports.receiptSubSumCents = receiptSubSumCents;
 exports.receiptSumCents = receiptSumCents;
 const index_js_1 = require("../enums/index.js");
@@ -134,29 +135,52 @@ function gueltigeRueckzahlungen(rueckzahlungen) {
     }
     return raus;
 }
+/**
+ * Vorzeichen der Wertgutscheine am Beleg: am Storno-Beleg -1, sonst 1.
+ *
+ * Das Backend spiegelt Wertgutscheine beim Vollstorno mit UNVERAENDERTER
+ * `action` und positivem Wert (storno-core.stornoVouchers); der Fluss dreht
+ * sich am Storno um (zahlungen-core.wertgutscheinFlussCents, hier
+ * `receiptDueCents`): ein verkaufter Gutschein wird zurueckgezahlt, ein
+ * eingeloester mindert die Rueckzahlung.
+ */
+function receiptValueVoucherSign(receipt) {
+    const typ = typeof receipt.receiptType === 'object' ? receipt.receiptType.value : receipt.receiptType;
+    return typ === index_js_1.ReceiptType.cancellation.value ? -1 : 1;
+}
 /**
  * Zwischensumme in **Cent** — Positionen plus verkaufte Wertgutscheine minus
  * eingeloeste Promotionsgutscheine. Wertgutschein-Einloesungen wirken erst auf
  * [receiptSumCents], nicht hier (siehe Dart-Vorbild `subSumCents`/`sumCents`).
+ * Am Storno-Beleg zaehlen Wertgutscheine mit umgekehrtem Vorzeichen
+ * ([receiptValueVoucherSign]), und ein gespiegelter Promotionsgutschein
+ * mindert nichts: den Rabatt nimmt der Server dort ueber Ausgleichspositionen
+ * (`kind: 'discount'`) zurueck, und belegToepfe verteilt einen Promo-Eintrag
+ * nur auf eine positive Topfsumme, die ein Storno nie hat.
  */
 function receiptSubSumCents(receipt) {
+    const vz = receiptValueVoucherSign(receipt);
     let cents = receipt.items.reduce((acc, item) => acc + (0, receipt_item_js_1.receiptItemTotalCents)(item), 0);
     for (const voucher of receipt.vouchers) {
-        if (voucher.action === index_js_1.VoucherAction.redeem && voucher.type === index_js_1.VoucherType.promo) {
+        if (vz === 1 && voucher.action === index_js_1.VoucherAction.redeem && voucher.type === index_js_1.VoucherType.promo) {
             cents -= voucher.valueCents ?? 0;
         }
         if (voucher.action === index_js_1.VoucherAction.sell && voucher.type === index_js_1.VoucherType.value) {
-            cents += voucher.valueCents ?? 0;
+            cents += vz * (voucher.valueCents ?? 0);
         }
     }
     return cents;
 }
-/** Gesamtsumme in **Cent** — Zwischensumme minus eingeloeste Wertgutscheine. */
+/**
+ * Gesamtsumme in **Cent** — Zwischensumme minus eingeloeste Wertgutscheine
+ * (am Storno-Beleg plus, siehe [receiptValueVoucherSign]).
+ */
 function receiptSumCents(receipt) {
+    const vz = receiptValueVoucherSign(receipt);
     let cents = receiptSubSumCents(receipt);
     for (const voucher of receipt.vouchers) {
         if (voucher.action === index_js_1.VoucherAction.redeem && voucher.type === index_js_1.VoucherType.value) {
-            cents -= voucher.valueCents ?? 0;
+            cents -= vz * (voucher.valueCents ?? 0);
         }
     }
     return cents;

package/dist/cjs/pos/client.js

@@ -139,6 +139,16 @@ function pruefeTeil(name, teil, block, standard, werte) {
         throw new errors_js_1.KasseneckValidationError(name, `${teil}: keine Einstellungen uebergeben`, 'request');
     }
     for (const [schluessel, wert] of gesendet) {
+        if (teil === 'device' && settings_js_1.POS_DEVICE_OPTIONAL_FIELDS.includes(schluessel)) {
+            if (!(0, settings_js_1._optionalerWert)(wert, true))
+                throw new errors_js_1.KasseneckValidationError(name, `${teil}.${schluessel}: Kennung oder null erwartet`, 'request');
+            continue;
+        }
+        if (teil === 'business' && settings_js_1.POS_BUSINESS_OPTIONAL_FIELDS.includes(schluessel)) {
+            if (typeof wert !== 'boolean')
+                throw new errors_js_1.KasseneckValidationError(name, `${teil}.${schluessel}: true oder false erwartet`, 'request');
+            continue;
+        }
         if (!Object.prototype.hasOwnProperty.call(standard, schluessel)) {
             throw new errors_js_1.KasseneckValidationError(name, `${teil}.${schluessel}: unbekanntes Feld`, 'request');
         }