@kreiseck/kasseneck-api 0.31.0 → 1.0.0-rc.2

package/dist/cjs/models/cancellation.js

@@ -1,9 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_REASONS = void 0;
+exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_STATUSES = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_REASONS = void 0;
 exports.isCancellationReason = isCancellationReason;
 exports.isCancellationErrorCode = isCancellationErrorCode;
+exports.cancellationErrorCode = cancellationErrorCode;
+exports.isCancellationError = isCancellationError;
 exports.remainingQuantities = remainingQuantities;
+exports.cancellationFieldErrors = cancellationFieldErrors;
+const fehlercodes_js_1 = require("../client/fehlercodes.js");
 /**
  * Storno-Metadaten — Zwilling von `functions/storno-core.js`.
  *
@@ -13,65 +17,105 @@ exports.remainingQuantities = remainingQuantities;
  * Storno-Beleg) und die Liste der Stornos am Original (`cancellations`), aus
  * der sich die Restmengen ergeben.
  */
-/** Grund-Katalog: Codes wie im Backend, Anzeigetext fuer Bon und Bedienung. */
+/**
+ * Grund-Katalog: Codes wie unter `/v3` (Katalog `STORNO_GRUND` des
+ * Backends), Anzeigetext fuer Bon und Bedienung. Der Anzeigetext bleibt
+ * deutsch, er steht so am Beleg.
+ */
 exports.CANCELLATION_REASONS = Object.freeze({
-    fehleingabe: 'Fehleingabe',
-    kunde_storniert: 'Kunde hat storniert',
-    falsche_zahlart: 'Falsche Zahlart',
-    doppelt_erfasst: 'Doppelt erfasst',
-    sonstiges: 'Sonstiges',
+    input_error: 'Fehleingabe',
+    customer_cancelled: 'Kunde hat storniert',
+    wrong_payment_method: 'Falsche Zahlart',
+    duplicate: 'Doppelt erfasst',
+    other: 'Sonstiges',
 });
 function isCancellationReason(value) {
     return typeof value === 'string' && Object.prototype.hasOwnProperty.call(exports.CANCELLATION_REASONS, value);
 }
 /**
- * Stabile Fehlercodes von `cancelReceipt` — Zwilling von
- * `functions/gemeinsam/storno-core.js` STORNO_FEHLERCODES. Das Backend legt sie bei
+ * Stabile Fehlercodes von `cancelReceipt` unter `/v3` (Vokabular
+ * `errorCodes.cancellation`, gleiche Reihenfolge). Das Backend legt sie bei
  * jedem fachlichen Fehler als `code` neben die Meldung; das Paket reicht sie
- * als [KasseneckApiError.code] durch. **Entscheide am Code, nie am Text** —
+ * als [KasseneckApiError.code] durch. **Entscheide am Code, nie am Text:**
  * die deutsche Meldung darf sich aendern, der Code nicht.
  *
- * Nur Auth-/Parameterfehler (Sitzung abgelaufen, Pflichtfeld fehlt) kommen
- * ohne Code; dort bleibt `code` undefined.
+ * Formfehler an `payments` selbst melden die Codes aus
+ * [PAYMENT_ERROR_CODES]. `cancellation_outcome_unknown` heisst: der Storno
+ * ist moeglicherweise gebucht (`outcome: 'unknown'`). Nie wiederholen,
+ * sondern das Original nachlesen (`getReceipt`, `cancellations[]`).
  *
- * Die vier `STORNO_PAYMENTS_…`/`STORNO_REFUND_…`-Codes gehoeren zur
- * Rueckzahlung je Zahlung (mehrere Zahlungen je Beleg); Formfehler an
- * `payments` selbst melden die Codes aus [PAYMENT_ERROR_CODES].
- * `STORNO_OUTCOME_UNKNOWN` heisst: der Storno-Beleg kann schon signiert sein,
- * die Reservierung bleibt offen – nicht erneut stornieren, die Belegliste
- * nach ein paar Minuten neu laden (unter `/v3`: `cancellation_outcome_unknown`).
- *
- * Die Werte hier sind die von `/v1` und intern. Unter `/v3` heissen die
- * Storno-Codes nach dem /v3-Vokabular anders (`already_cancelled`,
- * `cancellation_payments_required`, functions/gemeinsam/api-vokabular-v3.js);
- * diese Namen kommen mit der Umstellung des Pakets auf `/v3`.
- * [isCancellationErrorCode] prueft darum exakt.
+ * Dahinter (ab 1.0) die Codes, die Anmeldung und Rand auf diesem Endpunkt
+ * erzeugen koennen: `errorCodes.auth` ohne die sieben des Partner-Zugangs und
+ * `errorCodes.edge` (`not_found`, `dialect_mismatch`, `response_translation_failed`
+ * ...), zuletzt die Codes des Pakets (`route_missing`, `response_unreadable`).
+ * Die Zahlungscodes (`payment_method_not_supported` ...) stehen in
+ * [PAYMENT_ERROR_CODES]. Ein Code ausserhalb bleibt ueber
+ * `KasseneckApiError.code` lesbar.
  */
-exports.CANCELLATION_ERROR_CODES = [
-    'beleg_nicht_gefunden', // Original fehlt oder gehoert nicht zu dieser Kasse
-    'belegart_nicht_stornierbar', // Original ist selbst Storno-, Null- oder Startbeleg
-    'trainingsbeleg', // Trainingsbelege werden nicht storniert
-    'bereits_storniert', // keine Restmenge mehr (auch beim positionslosen Beleg)
-    'position_ungueltig', // Index unbekannt oder doppelt
-    'menge_ueber_rest', // Menge nicht ganzzahlig >= 1 oder groesser als der Rest
-    'grund_unbekannt', // reason fehlt oder nicht im Katalog
-    'anmerkung_zu_lang', // note laenger als 200 Zeichen
-    'items_ungueltig', // items ist keine Liste
-    'kasse_nicht_zugewiesen', // Register-Benutzer darf diese Kasse nicht
-    'keine_berechtigung', // Register-Benutzer ohne Storno-Recht
-    'nur_eigene_belege', // Recht "eigene", fremder Beleg
-    'kasse_unvollstaendig', // api_key/token fehlen am Konto bzw. an der Kasse
-    'storno_fehlgeschlagen', // der Storno-Beleg selbst wurde abgelehnt (z. B. Signatur)
-    // Mehrere Zahlungen je Beleg (Rueckzahlung je Zahlung):
-    'STORNO_PAYMENTS_REQUIRED', // Teilstorno eines Belegs mit mehreren Zahlungen ohne payments
-    'STORNO_REFUND_EXCEEDS_PAYMENT', // Rueckzahlungen auf eine Zahlung uebersteigen deren Rest
-    'STORNO_REFUND_REFERENCE_REQUIRED', // Karten-Rueckzahlung ohne refundOf einer Kartenzahlung
-    'STORNO_REFUND_REFERENCE_UNKNOWN', // refundOf nennt keine Zahlung des Originals
-    'STORNO_OUTCOME_UNKNOWN', // Ausgang offen: Storno-Beleg evtl. schon signiert, nicht wiederholen
-];
+exports.CANCELLATION_ERROR_CODES = Object.freeze([
+    'receipt_not_found', // Original fehlt oder gehoert nicht zu dieser Kasse
+    'receipt_type_not_cancellable', // Original ist selbst Storno-, Null- oder Startbeleg
+    'training_receipt', // Trainingsbelege werden nicht storniert
+    'already_cancelled', // keine Restmenge mehr
+    'invalid_line', // Index unbekannt oder doppelt
+    'quantity_exceeds_remaining', // Menge nicht ganzzahlig >= 1 oder groesser als der Rest
+    'unknown_reason', // reason fehlt oder nicht im Katalog
+    'note_too_long', // note laenger als 200 Zeichen
+    'invalid_items', // items ist keine Liste
+    'cashregister_not_assigned', // Kassen-Benutzer darf diese Kasse nicht
+    'not_permitted', // Kassen-Benutzer ohne Storno-Recht
+    'own_receipts_only', // Recht "eigene", fremder Beleg
+    'cashregister_incomplete', // api_key/token fehlen am Konto bzw. an der Kasse
+    'cancellation_failed', // der Storno-Beleg selbst wurde abgelehnt (z. B. Signatur)
+    'cancellation_payments_required', // Teilstorno eines Belegs mit mehreren Zahlungen ohne payments
+    'cancellation_refund_exceeds_payment', // Rueckzahlungen auf eine Zahlung uebersteigen deren Rest
+    'cancellation_refund_reference_required', // Karten-Rueckzahlung ohne refundOf einer Kartenzahlung
+    'cancellation_refund_reference_unknown', // refundOf nennt keine Zahlung des Originals
+    'cancellation_outcome_unknown', // Ausgang unklar: nachlesen, nie wiederholen
+    // Anmeldung und Rand (errorCodes.auth ohne Partner-Zugang, errorCodes.edge)
+    'account_not_found',
+    'admin_required',
+    'cashregister_not_found',
+    'cashregister_token_invalid',
+    'cashregister_token_missing',
+    'dialect_mismatch',
+    'internal_translation_error',
+    'live_not_enabled',
+    'method_not_allowed',
+    'mfa_required',
+    'not_found',
+    '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',
+    // Codes des Pakets (CLIENT_ERROR_CODES)
+    'route_missing',
+    'response_unreadable',
+]);
 function isCancellationErrorCode(value) {
     return typeof value === 'string' && exports.CANCELLATION_ERROR_CODES.includes(value);
 }
+const CANCELLATION_BEKANNT = new Set(exports.CANCELLATION_ERROR_CODES);
+/** Der Code eines geworfenen Fehlers, wenn er in [CANCELLATION_ERROR_CODES] steht; sonst `undefined`. */
+function cancellationErrorCode(error) {
+    return (0, fehlercodes_js_1.bekannterCode)(error, CANCELLATION_BEKANNT);
+}
+/**
+ * Kurzform fuer `catch (e) { if (isCancellationError(e, 'already_cancelled')) … }`.
+ * Ohne `code`: traegt der Fehler ueberhaupt einen Code aus [CANCELLATION_ERROR_CODES]?
+ */
+function isCancellationError(error, code) {
+    const gefunden = cancellationErrorCode(error);
+    return gefunden !== undefined && (code === undefined || gefunden === code);
+}
+/** Stornostand eines Belegs in der Belegliste (Katalog `STORNO_STAND`). */
+exports.CANCELLATION_STATUSES = Object.freeze(['none', 'partial', 'full']);
 /** Ab wann eine liegengebliebene Reservierung nicht mehr zaehlt (wie im Backend). */
 exports.CANCELLATION_RESERVATION_MS = 120_000;
 /**
@@ -92,3 +136,7 @@ function remainingQuantities(receipt, nowMs = Date.now()) {
     }
     return rest;
 }
+/** Die Feldfehler einer `validation`-Antwort; leer, wenn es keine sind. */
+function cancellationFieldErrors(error) {
+    return (0, fehlercodes_js_1.feldfehlerVon)(error);
+}

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

@@ -51,13 +51,13 @@ export interface HobexReceiptPayload {
     tip: number;
     cvm: string | number;
 }
-export declare function toHobexReceiptPayload(beleg: HobexReceipt): HobexReceiptPayload;
+export declare function toHobexReceiptPayload(receipt: HobexReceipt): HobexReceiptPayload;
 export declare function fromHobexReceiptPayload(payload: HobexReceiptPayload): HobexReceipt;
 /**
  * Wandelt den Beleg in die `cardPaymentData`-Map, die auf dem Kasseneck-Beleg
  * landet (siehe [Receipt.cardPaymentData]). Bei HPS-Zahlungen kommen weitere
  * Felder dazu, die nur das lokale Terminal liefert.
  */
-export declare function hobexReceiptToCardPaymentData(beleg: HobexReceipt): Record<string, string>;
+export declare function hobexReceiptToCardPaymentData(receipt: HobexReceipt): Record<string, string>;
 /** Kartenzahlung erfordert eine Unterschrift (CVM-Code `"1"`). */
-export declare function hobexReceiptNeedsSignature(beleg: HobexReceipt): boolean;
+export declare function hobexReceiptNeedsSignature(receipt: HobexReceipt): boolean;

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

@@ -6,25 +6,25 @@ exports.hobexReceiptToCardPaymentData = hobexReceiptToCardPaymentData;
 exports.hobexReceiptNeedsSignature = hobexReceiptNeedsSignature;
 const index_js_1 = require("../enums/index.js");
 const money_js_1 = require("../money.js");
-function toHobexReceiptPayload(beleg) {
+function toHobexReceiptPayload(receipt) {
     return {
-        transactionId: beleg.transactionId,
-        tid: beleg.tid,
-        receipt: beleg.receipt,
-        approvalCode: beleg.approvalCode,
-        reference: beleg.reference ?? null,
-        transactionDate: beleg.transactionDate,
-        cardNumber: beleg.cardNumber,
-        cardExpiry: beleg.cardExpiry,
-        brand: beleg.brand,
-        cardIssuer: beleg.cardIssuer,
-        responseCode: beleg.responseCode,
-        transactionType: beleg.transactionType,
-        currency: beleg.currency,
+        transactionId: receipt.transactionId,
+        tid: receipt.tid,
+        receipt: receipt.receipt,
+        approvalCode: receipt.approvalCode,
+        reference: receipt.reference ?? null,
+        transactionDate: receipt.transactionDate,
+        cardNumber: receipt.cardNumber,
+        cardExpiry: receipt.cardExpiry,
+        brand: receipt.brand,
+        cardIssuer: receipt.cardIssuer,
+        responseCode: receipt.responseCode,
+        transactionType: receipt.transactionType,
+        currency: receipt.currency,
         // Euro-Umwandlung nur hier, an der Terminal-API-Grenze — siehe Kommentar oben.
-        amount: (0, money_js_1.centsToEuro)(beleg.amountCents),
-        tip: (0, money_js_1.centsToEuro)(beleg.tipCents),
-        cvm: beleg.cvm,
+        amount: (0, money_js_1.centsToEuro)(receipt.amountCents),
+        tip: (0, money_js_1.centsToEuro)(receipt.tipCents),
+        cvm: receipt.cvm,
     };
 }
 function fromHobexReceiptPayload(payload) {
@@ -66,28 +66,28 @@ function fromHobexReceiptPayload(payload) {
  * landet (siehe [Receipt.cardPaymentData]). Bei HPS-Zahlungen kommen weitere
  * Felder dazu, die nur das lokale Terminal liefert.
  */
-function hobexReceiptToCardPaymentData(beleg) {
+function hobexReceiptToCardPaymentData(receipt) {
     const data = {
-        transactionId: beleg.transactionId,
-        date: beleg.transactionDate,
-        tid: beleg.tid,
-        no: beleg.receipt,
-        type: beleg.transactionType,
-        cardBrand: beleg.brand,
-        cardNumber: beleg.cardNumber,
-        responseCode: beleg.responseCode,
-        cvm: beleg.cvm,
+        transactionId: receipt.transactionId,
+        date: receipt.transactionDate,
+        tid: receipt.tid,
+        no: receipt.receipt,
+        type: receipt.transactionType,
+        cardBrand: receipt.brand,
+        cardNumber: receipt.cardNumber,
+        responseCode: receipt.responseCode,
+        cvm: receipt.cvm,
     };
-    if (beleg.creditCardProvider === index_js_1.CreditCardProvider.hobexHps) {
-        data.approvalCode = beleg.approvalCode;
-        data.cardExpiry = beleg.cardExpiry;
-        data.cardIssuer = beleg.cardIssuer;
-        data.amount = (0, money_js_1.centsToEuro)(beleg.amountCents).toFixed(2);
-        data.currency = beleg.currency;
+    if (receipt.creditCardProvider === index_js_1.CreditCardProvider.hobexHps) {
+        data.approvalCode = receipt.approvalCode;
+        data.cardExpiry = receipt.cardExpiry;
+        data.cardIssuer = receipt.cardIssuer;
+        data.amount = (0, money_js_1.centsToEuro)(receipt.amountCents).toFixed(2);
+        data.currency = receipt.currency;
     }
     return data;
 }
 /** Kartenzahlung erfordert eine Unterschrift (CVM-Code `"1"`). */
-function hobexReceiptNeedsSignature(beleg) {
-    return beleg.cvm === '1';
+function hobexReceiptNeedsSignature(receipt) {
+    return receipt.cvm === '1';
 }

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

@@ -1,13 +1,14 @@
 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 ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, } from './receipt.js';
-export { type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, CANCELLATION_REASONS, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, remainingQuantities, } from './cancellation.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, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, remainingQuantities, } from './cancellation.js';
 export { type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, } from './receipt-payment.js';
-export { type PaymentErrorCode, PAYMENT_ERROR_CODES, isPaymentErrorCode } from './payment-errors.js';
-export { type ReceiptEmailErrorCode, RECEIPT_EMAIL_ERROR_CODES, isReceiptEmailErrorCode, } from './receipt-email.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';
+export { type ReceiptErrorCode, type ReceiptFieldError, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, } from './receipt-errors.js';
 export { type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, } from './receipt-company.js';
 export { type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, } from './cashregister.js';
-export { type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, istZeroKind } from './receipt-summary.js';
+export { type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, isZeroKind } from './receipt-summary.js';
 export { type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, } from './report-month.js';
 export { type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, } from './stripe-url-session.js';
 export { type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './hobex-receipt.js';

package/dist/cjs/models/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.istZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_ERROR_CODES = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.remainingQuantities = exports.isCancellationErrorCode = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_REASONS = exports.receiptSumCents = exports.receiptSubSumCents = 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.isZeroKind = exports.ZERO_KINDS = 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.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = 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 = 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; } });
@@ -16,14 +17,19 @@ Object.defineProperty(exports, "voucherIsValid", { enumerable: true, get: functi
 var receipt_js_1 = require("./receipt.js");
 Object.defineProperty(exports, "toReceiptPayload", { enumerable: true, get: function () { return receipt_js_1.toReceiptPayload; } });
 Object.defineProperty(exports, "fromReceiptPayload", { enumerable: true, get: function () { return receipt_js_1.fromReceiptPayload; } });
+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; } });
 var cancellation_js_1 = require("./cancellation.js");
 Object.defineProperty(exports, "CANCELLATION_REASONS", { enumerable: true, get: function () { return cancellation_js_1.CANCELLATION_REASONS; } });
+Object.defineProperty(exports, "CANCELLATION_STATUSES", { enumerable: true, get: function () { return cancellation_js_1.CANCELLATION_STATUSES; } });
 Object.defineProperty(exports, "CANCELLATION_ERROR_CODES", { enumerable: true, get: function () { return cancellation_js_1.CANCELLATION_ERROR_CODES; } });
 Object.defineProperty(exports, "CANCELLATION_RESERVATION_MS", { enumerable: true, get: function () { return cancellation_js_1.CANCELLATION_RESERVATION_MS; } });
 Object.defineProperty(exports, "isCancellationReason", { enumerable: true, get: function () { return cancellation_js_1.isCancellationReason; } });
 Object.defineProperty(exports, "isCancellationErrorCode", { enumerable: true, get: function () { return cancellation_js_1.isCancellationErrorCode; } });
+Object.defineProperty(exports, "cancellationErrorCode", { enumerable: true, get: function () { return cancellation_js_1.cancellationErrorCode; } });
+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; } });
 var receipt_payment_js_1 = require("./receipt-payment.js");
 Object.defineProperty(exports, "fromReceiptPaymentPayload", { enumerable: true, get: function () { return receipt_payment_js_1.fromReceiptPaymentPayload; } });
@@ -31,9 +37,23 @@ Object.defineProperty(exports, "toReceiptPaymentPayload", { enumerable: true, ge
 var payment_errors_js_1 = require("./payment-errors.js");
 Object.defineProperty(exports, "PAYMENT_ERROR_CODES", { enumerable: true, get: function () { return payment_errors_js_1.PAYMENT_ERROR_CODES; } });
 Object.defineProperty(exports, "isPaymentErrorCode", { enumerable: true, get: function () { return payment_errors_js_1.isPaymentErrorCode; } });
+Object.defineProperty(exports, "paymentErrorCode", { enumerable: true, get: function () { return payment_errors_js_1.paymentErrorCode; } });
+Object.defineProperty(exports, "isPaymentError", { enumerable: true, get: function () { return payment_errors_js_1.isPaymentError; } });
+Object.defineProperty(exports, "paymentFieldErrors", { enumerable: true, get: function () { return payment_errors_js_1.paymentFieldErrors; } });
 var receipt_email_js_1 = require("./receipt-email.js");
 Object.defineProperty(exports, "RECEIPT_EMAIL_ERROR_CODES", { enumerable: true, get: function () { return receipt_email_js_1.RECEIPT_EMAIL_ERROR_CODES; } });
+Object.defineProperty(exports, "RECEIPT_EMAIL_SEND_ERROR_CODES", { enumerable: true, get: function () { return receipt_email_js_1.RECEIPT_EMAIL_SEND_ERROR_CODES; } });
+Object.defineProperty(exports, "RECEIPT_EMAIL_VIAS", { enumerable: true, get: function () { return receipt_email_js_1.RECEIPT_EMAIL_VIAS; } });
 Object.defineProperty(exports, "isReceiptEmailErrorCode", { enumerable: true, get: function () { return receipt_email_js_1.isReceiptEmailErrorCode; } });
+Object.defineProperty(exports, "receiptEmailErrorCode", { enumerable: true, get: function () { return receipt_email_js_1.receiptEmailErrorCode; } });
+Object.defineProperty(exports, "isReceiptEmailError", { enumerable: true, get: function () { return receipt_email_js_1.isReceiptEmailError; } });
+Object.defineProperty(exports, "receiptEmailFieldErrors", { enumerable: true, get: function () { return receipt_email_js_1.receiptEmailFieldErrors; } });
+var receipt_errors_js_1 = require("./receipt-errors.js");
+Object.defineProperty(exports, "RECEIPT_ERROR_CODES", { enumerable: true, get: function () { return receipt_errors_js_1.RECEIPT_ERROR_CODES; } });
+Object.defineProperty(exports, "isReceiptErrorCode", { enumerable: true, get: function () { return receipt_errors_js_1.isReceiptErrorCode; } });
+Object.defineProperty(exports, "receiptErrorCode", { enumerable: true, get: function () { return receipt_errors_js_1.receiptErrorCode; } });
+Object.defineProperty(exports, "isReceiptError", { enumerable: true, get: function () { return receipt_errors_js_1.isReceiptError; } });
+Object.defineProperty(exports, "receiptFieldErrors", { enumerable: true, get: function () { return receipt_errors_js_1.receiptFieldErrors; } });
 var receipt_company_js_1 = require("./receipt-company.js");
 Object.defineProperty(exports, "fromReceiptCompanyPayload", { enumerable: true, get: function () { return receipt_company_js_1.fromReceiptCompanyPayload; } });
 Object.defineProperty(exports, "receiptCompanyTaxInfo", { enumerable: true, get: function () { return receipt_company_js_1.receiptCompanyTaxInfo; } });
@@ -42,7 +62,7 @@ Object.defineProperty(exports, "fromCashregisterPayload", { enumerable: true, ge
 var receipt_summary_js_1 = require("./receipt-summary.js");
 Object.defineProperty(exports, "fromReceiptSummaryPayload", { enumerable: true, get: function () { return receipt_summary_js_1.fromReceiptSummaryPayload; } });
 Object.defineProperty(exports, "ZERO_KINDS", { enumerable: true, get: function () { return receipt_summary_js_1.ZERO_KINDS; } });
-Object.defineProperty(exports, "istZeroKind", { enumerable: true, get: function () { return receipt_summary_js_1.istZeroKind; } });
+Object.defineProperty(exports, "isZeroKind", { enumerable: true, get: function () { return receipt_summary_js_1.isZeroKind; } });
 var report_month_js_1 = require("./report-month.js");
 Object.defineProperty(exports, "reportMonthFromDate", { enumerable: true, get: function () { return report_month_js_1.reportMonthFromDate; } });
 Object.defineProperty(exports, "previousReportMonth", { enumerable: true, get: function () { return report_month_js_1.previousReportMonth; } });

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

@@ -1,22 +1,39 @@
+import { KasseneckApiError } from '../client/errors.js';
 /**
- * Mehrere Zahlungen je Beleg — Fehlercode-Katalog, Zwilling von
- * `functions/gemeinsam/zahlungen-core.js` ZAHLUNGS_FEHLERCODES (gleiche
- * Codes, gleiche Reihenfolge).
+ * Mehrere Zahlungen je Beleg: Fehlercodes unter `/v3` (Vokabular
+ * `errorCodes.payments`, gleiche Codes, gleiche Reihenfolge).
  *
  * `createReceipt` und `cancelReceipt` legen sie bei jedem Fehler rund um
- * `payments` (und bei den Aufrufer-Vorbedingungen wie `PAYMENTS_CONFLICT`)
- * als `code` neben die Meldung; das Paket reicht sie als
- * [KasseneckApiError.code] durch. **Entscheide am Code, nie am Text** — die
+ * `payments` als `code` neben die Meldung; das Paket reicht sie als
+ * [KasseneckApiError.code] durch. **Entscheide am Code, nie am Text:** die
  * deutsche Meldung darf sich aendern, der Code nicht.
  *
- * Schreibweise: auf `/v1`, `/v2` und intern kommen die Codes gross
- * (`PAYMENTS_SUM_MISMATCH`), unter `/v3` schreibt der Rand des Backends sie
- * klein (`payments_sum_mismatch`, functions/gemeinsam/api-vokabular-v3.js:
- * jeder dieser Codes 1:1 in Kleinschreibung, anders als die Storno-Codes).
- * [isPaymentErrorCode] erkennt beide; wer selbst vergleicht, vergleicht
- * `code.toUpperCase()`.
+ * `payments_sum_mismatch` traegt den Zahlbetrag des Servers in
+ * `details.expectedCents` (siehe [paymentsExpectedCents]). Der Fehler
+ * verbraucht keine Belegnummer; das Paket wiederholt trotzdem nie selbst,
+ * denn eine Kartenzahlung ist schon belastet.
+ *
+ * Dahinter (ab 1.0) die Codes, die Anmeldung und Rand auf diesem Endpunkt
+ * erzeugen koennen: `errorCodes.auth` ohne die sieben des Partner-Zugangs und
+ * `errorCodes.edge` (`not_found`, `dialect_mismatch`, `response_translation_failed`
+ * ...) 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"];
+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", "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", "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 type PaymentErrorCode = (typeof PAYMENT_ERROR_CODES)[number];
-/** Erkennt einen Code aus [PAYMENT_ERROR_CODES] — gross (`/v1`) wie klein (`/v3`). */
-export declare function isPaymentErrorCode(value: unknown): value is PaymentErrorCode | Lowercase<PaymentErrorCode>;
+/** Erkennt einen Code aus [PAYMENT_ERROR_CODES], exakt (klein, wie unter `/v3`). */
+export declare function isPaymentErrorCode(value: unknown): value is PaymentErrorCode;
+/** Der Code eines geworfenen Fehlers, wenn er in [PAYMENT_ERROR_CODES] steht; sonst `undefined`. */
+export declare function paymentErrorCode(error: unknown): PaymentErrorCode | undefined;
+/**
+ * Kurzform fuer `catch (e) { if (isPaymentError(e, 'payments_sum_mismatch')) … }`.
+ * Ohne `code`: traegt der Fehler ueberhaupt einen Code aus [PAYMENT_ERROR_CODES]?
+ */
+export declare function isPaymentError(error: unknown, code?: PaymentErrorCode): error is KasseneckApiError;
+/** Ein Feldfehler aus `data.errors[]` einer `validation`-Antwort von `payments[]`. */
+export interface PaymentFieldError {
+    field: string;
+    message: string;
+}
+/** Die Feldfehler einer `validation`-Antwort; leer, wenn es keine sind. */
+export declare function paymentFieldErrors(error: unknown): PaymentFieldError[];

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

@@ -2,45 +2,93 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PAYMENT_ERROR_CODES = void 0;
 exports.isPaymentErrorCode = isPaymentErrorCode;
+exports.paymentErrorCode = paymentErrorCode;
+exports.isPaymentError = isPaymentError;
+exports.paymentFieldErrors = paymentFieldErrors;
+const fehlercodes_js_1 = require("../client/fehlercodes.js");
 /**
- * Mehrere Zahlungen je Beleg — Fehlercode-Katalog, Zwilling von
- * `functions/gemeinsam/zahlungen-core.js` ZAHLUNGS_FEHLERCODES (gleiche
- * Codes, gleiche Reihenfolge).
+ * Mehrere Zahlungen je Beleg: Fehlercodes unter `/v3` (Vokabular
+ * `errorCodes.payments`, gleiche Codes, gleiche Reihenfolge).
  *
  * `createReceipt` und `cancelReceipt` legen sie bei jedem Fehler rund um
- * `payments` (und bei den Aufrufer-Vorbedingungen wie `PAYMENTS_CONFLICT`)
- * als `code` neben die Meldung; das Paket reicht sie als
- * [KasseneckApiError.code] durch. **Entscheide am Code, nie am Text** — die
+ * `payments` als `code` neben die Meldung; das Paket reicht sie als
+ * [KasseneckApiError.code] durch. **Entscheide am Code, nie am Text:** die
  * deutsche Meldung darf sich aendern, der Code nicht.
  *
- * Schreibweise: auf `/v1`, `/v2` und intern kommen die Codes gross
- * (`PAYMENTS_SUM_MISMATCH`), unter `/v3` schreibt der Rand des Backends sie
- * klein (`payments_sum_mismatch`, functions/gemeinsam/api-vokabular-v3.js:
- * jeder dieser Codes 1:1 in Kleinschreibung, anders als die Storno-Codes).
- * [isPaymentErrorCode] erkennt beide; wer selbst vergleicht, vergleicht
- * `code.toUpperCase()`.
+ * `payments_sum_mismatch` traegt den Zahlbetrag des Servers in
+ * `details.expectedCents` (siehe [paymentsExpectedCents]). Der Fehler
+ * verbraucht keine Belegnummer; das Paket wiederholt trotzdem nie selbst,
+ * denn eine Kartenzahlung ist schon belastet.
+ *
+ * Dahinter (ab 1.0) die Codes, die Anmeldung und Rand auf diesem Endpunkt
+ * erzeugen koennen: `errorCodes.auth` ohne die sieben des Partner-Zugangs und
+ * `errorCodes.edge` (`not_found`, `dialect_mismatch`, `response_translation_failed`
+ * ...) und zuletzt `route_missing` (Code des Pakets). Ein Code ausserhalb
+ * bleibt ueber `KasseneckApiError.code` lesbar.
  */
 exports.PAYMENT_ERROR_CODES = Object.freeze([
-    'PAYMENTS_INVALID', // payments ist keine Liste oder hat mehr als 20 Eintraege
-    'PAYMENT_METHOD_INVALID', // Zahlart unbekannt oder mixed
-    'PAYMENT_AMOUNT_INVALID', // amountCents keine Ganzzahl, 0 oder falsches Vorzeichen
-    'PAYMENT_TENDERED_INVALID', // tenderedCents an Nicht-Bar-Zahlung, zu klein oder am Storno
-    'PAYMENT_PROVIDER_INVALID', // Karte ohne/mit unbekanntem provider, providerPaymentId fehlt
-    'PAYMENT_PROVIDER_NOT_ALLOWED', // Anbieterfelder an einer Zahlung, die weder Karte noch online ist
-    'PAYMENTS_SUM_MISMATCH', // Summe != Zahlbetrag (Antwort nennt data.expectedCents)
-    'PAYMENTS_DUE_NEGATIVE', // Zahlbetrag < 0 (Wertgutschein groesser als der Beleg)
-    'PAYMENTS_NOT_ALLOWED', // Null-/Startbeleg mit Zahlungen, alter Storno-Weg
-    'PAYMENTS_CONFLICT', // payments zusammen mit paymentMethod oder Kartenfeldern
-    'PAYMENTS_REQUIRED', // /v3 ohne payments
-    'PAYMENT_METHOD_NOT_SUPPORTED', // paymentMethod/Kartenfelder unter /v3
-    'TIP_PAYMENT_METHOD_INVALID', // Trinkgeld-Zahlart kommt in payments nicht vor
-    'TIP_PAYMENT_METHOD_REQUIRED', // mehrere Zahlarten, tip.paymentMethod fehlt
-    'TIP_EXCEEDS_PAYMENT', // Trinkgeld uebersteigt die Zahlungen seiner Zahlart
-    'PAYMENT_REFUND_NOT_ALLOWED', // refundOf ausserhalb eines Stornos oder kein String
-    'PAYMENT_TIP_INVALID', // tipCents keine Ganzzahl, <= 0, > amountCents oder nicht am Verkauf
-    'TIP_CONFLICT', // tip und payments[].tipCents zugleich
+    'payments_invalid', // payments ist keine Liste oder hat mehr als 20 Eintraege
+    'payment_method_invalid', // Zahlart unbekannt oder mixed
+    'payment_amount_invalid', // amountCents keine Ganzzahl, 0 oder falsches Vorzeichen
+    'payment_tendered_invalid', // tenderedCents an Nicht-Bar-Zahlung, zu klein oder am Storno
+    'payment_provider_invalid', // Karte ohne/mit unbekanntem provider, providerPaymentId fehlt
+    'payment_provider_not_allowed', // Anbieterfelder an einer Zahlung, die weder Karte noch online ist
+    'payments_sum_mismatch', // Summe != Zahlbetrag (details.expectedCents)
+    'payments_due_negative', // Zahlbetrag < 0 (Wertgutschein groesser als der Beleg)
+    'payments_not_allowed', // Null-/Startbeleg mit Zahlungen
+    'payments_conflict', // payments zusammen mit paymentMethod oder Kartenfeldern
+    'payments_required', // ohne payments
+    'payment_method_not_supported', // paymentMethod/Kartenfelder am Beleg
+    'tip_payment_method_invalid', // Trinkgeld-Zahlart kommt in payments nicht vor
+    'tip_payment_method_required', // mehrere Zahlarten, tip.paymentMethod fehlt
+    'tip_exceeds_payment', // Trinkgeld uebersteigt die Zahlungen seiner Zahlart
+    'payment_refund_not_allowed', // refundOf ausserhalb eines Stornos oder kein String
+    'payment_tip_invalid', // tipCents keine Ganzzahl, <= 0, > amountCents oder nicht am Verkauf
+    'tip_conflict', // tip und payments[].tipCents zugleich
+    // Anmeldung und Rand (errorCodes.auth ohne Partner-Zugang, errorCodes.edge)
+    'account_not_found',
+    'admin_required',
+    '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',
+    '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',
+    // Code des Pakets (CLIENT_ERROR_CODES; response_unreadable nur an signierenden Aufrufen)
+    'route_missing',
 ]);
-/** Erkennt einen Code aus [PAYMENT_ERROR_CODES] — gross (`/v1`) wie klein (`/v3`). */
+/** Erkennt einen Code aus [PAYMENT_ERROR_CODES], exakt (klein, wie unter `/v3`). */
 function isPaymentErrorCode(value) {
-    return typeof value === 'string' && exports.PAYMENT_ERROR_CODES.includes(value.toUpperCase());
+    return typeof value === 'string' && exports.PAYMENT_ERROR_CODES.includes(value);
+}
+const PAYMENT_BEKANNT = new Set(exports.PAYMENT_ERROR_CODES);
+/** Der Code eines geworfenen Fehlers, wenn er in [PAYMENT_ERROR_CODES] steht; sonst `undefined`. */
+function paymentErrorCode(error) {
+    return (0, fehlercodes_js_1.bekannterCode)(error, PAYMENT_BEKANNT);
+}
+/**
+ * Kurzform fuer `catch (e) { if (isPaymentError(e, 'payments_sum_mismatch')) … }`.
+ * Ohne `code`: traegt der Fehler ueberhaupt einen Code aus [PAYMENT_ERROR_CODES]?
+ */
+function isPaymentError(error, code) {
+    const gefunden = paymentErrorCode(error);
+    return gefunden !== undefined && (code === undefined || gefunden === code);
+}
+/** Die Feldfehler einer `validation`-Antwort; leer, wenn es keine sind. */
+function paymentFieldErrors(error) {
+    return (0, fehlercodes_js_1.feldfehlerVon)(error);
 }

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

@@ -4,7 +4,8 @@
  * (`toMetadataJson`/`fromMetadata`).
  *
  * Das Backend liefert sie **neben** dem Beleg: `getReceipt` und `createReceipt`
- * legen Firma, Anschrift, Steuernummer, UID, Fusszeilen, Logo-Adresse und das
+ * legen Firma, Anschrift, Steuernummer (`taxNumber`), UID (`vatId`),
+ * Fusszeilen, Logo-Adresse und das
  * Kleinunternehmer-Kennzeichen direkt in die Antwort (functions/index.js).
  * Zum RKSV-Kernbeleg gehoeren sie nicht — sie betreffen ausschliesslich die
  * Darstellung. Deshalb stehen sie hier als eigenes Modell und nicht in
@@ -23,9 +24,9 @@ export interface ReceiptCompany {
     city: string;
     phone: string;
     /** UID (Umsatzsteuer-Identifikationsnummer); fehlt bei Kleinunternehmern. */
-    uid?: string;
+    vatId?: string;
     /** Steuernummer des Finanzamts. */
-    taxnr: string;
+    taxNumber: string;
     /** Kleinunternehmer nach § 6 Abs 1 Z 27 UStG (keine USt im Ausweis). */
     isSmallBusiness: boolean;
     footer1: string;
@@ -51,8 +52,8 @@ export interface ReceiptCompanyPayload {
     zip?: string | null;
     city?: string | null;
     phone?: string | null;
-    uid?: string | null;
-    taxnr?: string | null;
+    vatId?: string | null;
+    taxNumber?: string | null;
     is_small_business?: boolean | null;
     footer1?: string | null;
     footer2?: string | null;