@kreiseck/kasseneck-api 0.28.0 → 0.30.0

package/CHANGELOG.md

@@ -4,6 +4,85 @@ Was vor 0.7.0 geschah, steht in der Commit-Historie (`git log`); ab hier wird
 es hier geführt. Ein Eintrag nennt die Änderung **und ihren Grund** —
 nur der Grund überlebt den nächsten Umbau.
 
+## 0.30.0
+
+Mehrere Zahlungen je Beleg. Setzt ein Backend mit `payments` voraus (keck, live seit
+2026-09-25); gegen einen älteren Server bleibt alles ohne `payments` wie bisher. Nichts bricht:
+ein Beleg ohne Zahlungsliste liest, sendet und druckt sich byte-gleich wie in 0.29.0.
+
+- **`Receipt` und `ReceiptSummary` tragen `payments` (`ReceiptPayment[]`), wenn der Server sie
+  liefert**, je Zahlung Zahlart, `amountCents`, bei Bar `tenderedCents`/Rückgeld, bei Karte
+  Anbieter und Terminaldaten, bei Stornos `refundOf`, dazu `tipCents` (Trinkgeld je Zahlung).
+  Grund: ein Tisch zahlt mit zwei Karten und dem Rest bar, und das Einzelfeld `paymentMethod`
+  konnte das nicht abbilden. Altbelege ohne Liste lesen sich unverändert (`payments` fehlt).
+- **`KeckPaymentMethod.mixed` („Mehrere Zahlungsarten")**, nur zum Lesen. Der Server setzt ihn als
+  `paymentMethod`, wenn die Zahlungen verschiedene Zahlarten haben; wer ihn selbst sendet, wird
+  schon im Client abgewiesen. Grund: sonst wäre ein solcher Beleg für einen älteren Leser eine
+  unbekannte Zahlart; zum Kassieren gibt es die Zahlungsliste.
+- **`payments` bei `sellReceipt`, `createReceipt` und `cancelReceipt`**, mit Form- und
+  Konfliktprüfung im Client (`payments` zusammen mit `paymentMethod` oder Kartenfeldern ergibt
+  `PAYMENTS_CONFLICT`; `payments: null` gilt als nicht angegeben). Für `sellReceipt` gibt es den
+  neuen Typ `SellReceiptWithPaymentsOptions`; `SellReceiptOptions` bleibt ein `interface` und
+  bekommt nur das optionale `payments?: undefined`, damit bestehender Code unverändert kompiliert
+  und die beiden Wege sich nicht mischen lassen. Beim Storno nennt `refundOf` die Zahlung des
+  Originals, auf die zurückgezahlt wird.
+- **`PAYMENT_ERROR_CODES` (18 Codes) und `isPaymentErrorCode`**, Zwilling von
+  `ZAHLUNGS_FEHLERCODES` im Backend (gleiche Codes, gleiche Reihenfolge). `isPaymentErrorCode`
+  erkennt auch die kleingeschriebene `/v3`-Schreibweise, weil `/v3` diese Codes 1:1 klein
+  ausliefert. Grund: am Code entscheiden, nie am Text.
+- **`CANCELLATION_ERROR_CODES` um vier `STORNO_…`-Codes ergänzt** (`STORNO_PAYMENTS_REQUIRED`,
+  `STORNO_REFUND_EXCEEDS_PAYMENT`, `STORNO_REFUND_REFERENCE_REQUIRED`,
+  `STORNO_REFUND_REFERENCE_UNKNOWN`) für die Rückzahlung je Zahlung. `isCancellationErrorCode`
+  prüft weiter exakt: unter `/v3` heißen die Storno-Codes nach dem Vokabular anders (nicht bloß
+  klein), die Namen kommen mit der Umstellung des Pakets auf `/v3`.
+- **Beleg-Layout: bei mehr als einer Zahlung eine nummerierte Aufschlüsselung** unter „Gesamt:"
+  („Zahlungsarten:", dann „1. Kartenzahlung", „2. Barzahlung" … samt Betrag; der Betrag bricht
+  auf 58 mm nie). Darunter eingerückt „davon Trinkgeld", „Gegeben" und „Rückgeld" der jeweiligen
+  Zahlung; die Kartenblöcke kommen je Zahlung in Zahlungsreihenfolge, jeweils mit derselben
+  Nummer darüber. Grund: auf dem Bon muss nachvollziehbar sein, welcher Betrag wie bezahlt wurde
+  und zu welcher Zahlung ein Terminal-Block gehört.
+- **Bei genau einer Zahlung bleibt der Beleg wie bisher**, nur „davon Trinkgeld", „Gegeben" und
+  „Rückgeld" stehen jetzt eingerückt unter „Zahlungsart:". Ohne Zahlungsliste ändert sich nichts:
+  alle bisherigen Vertragsbeispiele (`fixtures/erwartet`) und der Bytestrom-Zwilling sind
+  unverändert. Neu sind neun Beispiele `split-*`/`storno-split-*` (Karte+Karte+Bar,
+  Tischrunde mit Trinkgeld, Rückgeld, langer Betrag, Voll- und Teilstorno).
+
+## 0.29.0
+
+- **Bricht `./partner` (und nur das): `PARTNER_FEHLER_CODES` ist jetzt durchgehend englisch,
+  wie der Rest von `/v3`.** `zugang_nicht_erlaubt` → `access_not_allowed`, `kennung_fehlt` →
+  `tax_number_missing`, `vertrag_offen` → `contracts_pending` (Sätze unverändert, nur der
+  Schlüssel neu); die `RAT`-Tabelle und `partnerFehlerRat` folgen. Grund: 0.28.0 stellte den
+  Partner-Teil auf `/v3` um, liess aber ein paar Codes, die der Server bis dahin noch roh
+  durchreichte, unuebersetzt in ihrer `/v1`-Schreibweise stehen (siehe dessen Eintrag "Die
+  Fehlercodes bleiben in dieser Stufe wie in `/v1`"): der Server schickt seit dieser Version
+  wirklich nur noch englische Codes, und dieses Paket folgt.
+- **`PARTNER_FEHLER_CODES` um neun Codes von `reportCustomerContract` ergänzt**: `kind_not_allowed`,
+  `mode_not_allowed`, `power_of_attorney_missing`, `not_found`, `no_version`, `not_required`,
+  `unknown_version`, `text_changed`, `already_accepted`, mit Handlungssatz. Der Katalog des
+  Backends (`partner-core.FEHLER_KATALOG`, Fläche `api`/`beide`) führt sie für die Schnittstelle,
+  obwohl dieses Paket `reportCustomerContract` selbst nicht anbietet: derselbe Grund wie bei den
+  Portal-Codes: eine halbe Liste ist schlimmer als keine, und ein Code, den nur eine Seite kennt,
+  ist für einen Aufrufer nicht von "gibt es nicht" zu unterscheiden.
+- **`kein_partnerbetrieb` und `request_not_found` aus `PARTNER_FEHLER_CODES` entfernt.** Beide sind
+  admin-only (`partner-endpoints.js`) und stehen gar nicht in `partner-core.FEHLER_KATALOG`; ein
+  Partner-Aufruf konnte sie unter keinem Pfad je bekommen. Sie standen seit jeher versehentlich in
+  der Liste; ein Aufrufer, der auf sie prüfte, prüfte auf einen Fall, der nie eintritt.
+- `module_inactive`s Handlungssatz nennt jetzt `data.module`/`data.detail` statt `data.modul` (die
+  Werte selbst, z. B. `cash_register`, waren mit 0.28.0 schon englisch, nur der Text hier hinkte
+  nach).
+- Neuer Typ `SignatureErrorCode` (`customer_not_found` | `incomplete` | `finanzonline_error`) für
+  `SignaturAntrag.error.code` und `CustomerSignature.error.code` (bisher `string | null` ohne
+  jeden Hinweis auf die möglichen Werte), nach demselben Muster wie `SignatureHistoryReason`.
+- `PartnerFeldFehler.field`s Beispiele sind nicht mehr `address.land`/`tax_details.ustid` (Namen,
+  die `/v3` als unbekanntes Feld abweist), sondern echte `/v3`-Pfade: `address.zip`,
+  `taxDetails.taxNumber`, `contacts.0.email`.
+- Die Tests lesen wieder echte `/v3`-Fehlerantworten: `scripts/partner-v3-antworten.cjs` schickt
+  jeden Code aus `fehlerKatalogFuer('api')` jetzt durch denselben Fehlerzweig wie eine echte
+  Antwort (`antwortNachAussen` statt der rohen Katalogwerte), und `getCustomerSignatureStatus`
+  trägt in der Fixture einen zweiten, fehlgeschlagenen Antrag (`fon_fehler` → `finanzonline_error`)
+  als Beleg dafür, dass `request.error.code` denselben Rand durchläuft wie jede Fehlerhülle.
+
 ## 0.28.0
 
 - **Bricht `./partner` (und nur das): der Partner-Teil spricht jetzt die englische Partner-API

package/README.md

@@ -539,11 +539,11 @@ businesses and, with the extra scope `credentials:read`, fetch their secrets.
 
 This subpath talks to the English Partner API **`/v3`**
 (`PARTNER_BASE_URL`, `https://api.kasseneck.at/v3`): every field name and
-every value your code branches on is English. Texts for humans (`message`,
-`note`, `statusText`, `nextSteps`) stay German, and so do the error codes for
-now. Everything else in this package (receipts, invoices, the register,
-printing, payments) still uses `/v1` (`DEFAULT_BASE_URL`) until those
-endpoints have a `/v3` of their own.
+every value your code branches on is English, including every error code
+(`PARTNER_FEHLER_CODES`). Texts for humans (`message`, `note`, `statusText`,
+`nextSteps`) stay German. Everything else in this package (receipts,
+invoices, the register, printing, payments) still uses `/v1`
+(`DEFAULT_BASE_URL`) until those endpoints have a `/v3` of their own.
 
 ```ts
 import { createPartnerApi, istPartnerFehler } from '@kreiseck/kasseneck-api/partner';
@@ -621,6 +621,42 @@ await partner.updatePartnerWebhook(webhookId, { apiVersion: 'v3' });
 
 Webhook signature verification is unchanged.
 
+### Migrating from 0.28.x
+
+0.29.0 is a breaking change for `./partner` only, and only for
+`PARTNER_FEHLER_CODES`: three codes that the server still sent in their
+German `/v1` spelling under 0.28.0 now come through English, matching every
+other value on `/v3`.
+
+| 0.28.x | 0.29.0 |
+|---|---|
+| `zugang_nicht_erlaubt` | `access_not_allowed` |
+| `kennung_fehlt` | `tax_number_missing` |
+| `vertrag_offen` | `contracts_pending` |
+
+`partnerFehlerRat()` and `istPartnerFehler()` follow: look up the new,
+English key. A build that still checks the old German string will no longer
+match, silently, so this is worth a search across your codebase.
+
+Two codes that never reached this package's own error handling
+(`kein_partnerbetrieb`, `request_not_found`, both admin-only and outside the
+backend's public catalog) are gone from `PARTNER_FEHLER_CODES`. If you were
+checking for them, that check was already dead code: the server never sent
+them to a partner call.
+
+`PARTNER_FEHLER_CODES` also gained nine codes for `reportCustomerContract`
+(`kind_not_allowed`, `mode_not_allowed`, `power_of_attorney_missing`,
+`not_found`, `no_version`, `not_required`, `unknown_version`, `text_changed`,
+`already_accepted`), each with a `partnerFehlerRat()` sentence. This package
+still does not expose that endpoint; the codes are here for completeness (a
+catalog page, or code that reads the raw error yourself), not because a call
+of this client can produce them.
+
+The signature error type `SignaturAntrag.error.code` /
+`CustomerSignature.error.code` is now `SignatureErrorCode`
+(`customer_not_found` | `incomplete` | `finanzonline_error` | any other
+string), a documented union instead of a bare `string | null`.
+
 ### A test event is not a cash register
 
 `sendPartnerWebhookTest(webhookId, 'cashregister.live')` fires exactly the

package/dist/cjs/client/api.d.ts

@@ -3,7 +3,7 @@ import { type CreateStripeLinkOptions, type StripeCaptureResult } from '../payme
 import { type HobexPayOptions, type HobexRefundOptions } from '../payments/hobex.js';
 import { type TransportOptions } from './transport.js';
 import { type CashboxStatus, type SignatureStatus } from './status.js';
-import { type SendReceiptEmailOptions, type SendReceiptEmailResult, type ListMyReceiptsOptions, type ReceiptList, type ReceiptWithCompany, type SellReceiptOptions, type CancelReceiptOptions, type CancelReceiptResult, type CreateCancelReceiptOptions } from './receipts.js';
+import { type SendReceiptEmailOptions, type SendReceiptEmailResult, type ListMyReceiptsOptions, type ReceiptList, type ReceiptWithCompany, type SellReceiptOptions, type SellReceiptWithPaymentsOptions, type CancelReceiptOptions, type CancelReceiptResult, type CreateCancelReceiptOptions } from './receipts.js';
 /**
  * Schlichte Factory ueber den Endpunkt-Funktionen: bindet einen Transport
  * einmal und liefert die Aufrufe ohne den wiederkehrenden ersten Parameter.
@@ -30,9 +30,9 @@ import { type SendReceiptEmailOptions, type SendReceiptEmailResult, type ListMyR
  */
 export interface KasseneckApi {
     /** Normalbeleg (Verkauf). */
-    sellReceipt(options: SellReceiptOptions): Promise<Receipt>;
+    sellReceipt(options: SellReceiptOptions | SellReceiptWithPaymentsOptions): Promise<Receipt>;
     /** Normalbeleg samt Firmen-/Druckdaten fuer den Belegdruck. */
-    sellReceiptWithCompany(options: SellReceiptOptions): Promise<ReceiptWithCompany>;
+    sellReceiptWithCompany(options: SellReceiptOptions | SellReceiptWithPaymentsOptions): Promise<ReceiptWithCompany>;
     /** Storno eines bestehenden Belegs — voll oder in Teilen, ueber den Storno-Endpunkt. */
     cancelReceipt(options: CancelReceiptOptions): Promise<CancelReceiptResult>;
     /** Storno aus frei uebergebenen Positionen. */

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

@@ -2,7 +2,7 @@ export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type
 export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, createTransport, createBinaryTransport, } from './transport.js';
 export { AUFRUFE, type Aufruf, } from './aufrufe.js';
 export { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, } from './errors.js';
-export { type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, type CancelReceiptResult, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, } from './receipts.js';
+export { type ReceiptCommonOptions, type SellReceiptOptions, type SellReceiptWithPaymentsOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, type CancelReceiptResult, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, } from './receipts.js';
 export { listMyCashregisters } from './cashregisters.js';
 export { downloadDailyReport, downloadMonthlyReport } from './reports.js';
 export { type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, } from './status.js';

package/dist/cjs/client/receipts.d.ts

@@ -1,5 +1,5 @@
 import { ReceiptType, type ReceiptTypeKey, KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider } from '../enums/index.js';
-import { type Receipt, type ReceiptCompany, type ReceiptItem, type Voucher, type ReceiptSummary, type ReportMonth, type CancellationItem, type CancellationOf, type CancellationReason } from '../models/index.js';
+import { type Receipt, type ReceiptCompany, type ReceiptItem, type Voucher, type ReceiptSummary, type ReportMonth, type CancellationItem, type CancellationOf, type CancellationReason, type ReceiptPaymentInput } from '../models/index.js';
 import type { InternerTransport } from './aufrufe.js';
 import type { Pruefangaben, ReceiptLayout } from '../receipt/layout.js';
 import type { LogoStufe } from '../receipt/blatt.js';
@@ -90,11 +90,32 @@ export interface CreateReceiptOptions extends ReceiptCommonOptions {
      * ausdruecklich uebergebene `paymentMethod` sticht.
      */
     paymentMethodFromServer?: string;
+    /**
+     * Mehrere Zahlungen je Beleg (siehe [ReceiptPaymentInput]). Schliesst
+     * `paymentMethod`, `paymentMethodFromServer` und die Kartenfelder aus —
+     * die Kartenangaben gehoeren dann in die einzelne Zahlung (Backend:
+     * `PAYMENTS_CONFLICT`). Nur bei `standard` und `training`.
+     */
+    payments?: ReceiptPaymentInput[];
     items?: ReceiptItem[];
     vouchers?: Voucher[];
 }
+/** Verkauf mit einer Zahlungsart (`paymentMethod`, Kartenfelder aus [ReceiptCommonOptions]). */
 export interface SellReceiptOptions extends ReceiptCommonOptions {
     paymentMethod: KeckPaymentMethod | KeckPaymentMethodKey;
+    payments?: undefined;
+    items?: ReceiptItem[];
+    vouchers?: Voucher[];
+}
+/**
+ * Verkauf mit mehreren Zahlungen (`payments`, siehe [ReceiptPaymentInput]).
+ * Ohne `paymentMethod` und ohne die Kartenfelder aus [ReceiptCommonOptions] —
+ * die Kartenangaben stehen in der einzelnen Zahlung (Backend:
+ * `PAYMENTS_CONFLICT`, zur Laufzeit ebenso geprueft).
+ */
+export interface SellReceiptWithPaymentsOptions extends ReceiptCommonOptions {
+    payments: ReceiptPaymentInput[];
+    paymentMethod?: undefined;
     items?: ReceiptItem[];
     vouchers?: Voucher[];
 }
@@ -126,6 +147,14 @@ export type CancelReceiptOptions = {
     creditCardProvider?: CreditCardProvider;
     cardPaymentId?: string;
     cardPaymentData?: Record<string, unknown>;
+    /**
+     * Rueckzahlung je Zahlung (Betraege negativ, `refundOf` = `id` der
+     * Originalzahlung). Schliesst `paymentMethod` und die Kartenfelder aus
+     * (Backend: `PAYMENTS_CONFLICT`). Ohne Angabe spiegelt der Server die
+     * Restbetraege jeder Originalzahlung; ein Teilstorno eines Belegs mit
+     * mehreren Zahlungen braucht sie (`STORNO_PAYMENTS_REQUIRED`).
+     */
+    payments?: ReceiptPaymentInput[];
 } & ({
     receipt: Receipt;
     cashregisterId?: string;
@@ -183,12 +212,12 @@ export interface ReceiptWithCompany {
  */
 export declare function createReceipt(rufen: InternerTransport, options: CreateReceiptOptions): Promise<Receipt>;
 /** Normalbeleg (Verkauf) nach RKSV. */
-export declare function sellReceipt(rufen: InternerTransport, options: SellReceiptOptions): Promise<Receipt>;
+export declare function sellReceipt(rufen: InternerTransport, options: SellReceiptOptions | SellReceiptWithPaymentsOptions): Promise<Receipt>;
 /**
  * Normalbeleg wie [sellReceipt], liefert zusaetzlich die Firmen-/Druckdaten
  * aus derselben Antwort — alles, was ein Belegdruck braucht, in einem Aufruf.
  */
-export declare function sellReceiptWithCompany(rufen: InternerTransport, options: SellReceiptOptions): Promise<ReceiptWithCompany>;
+export declare function sellReceiptWithCompany(rufen: InternerTransport, options: SellReceiptOptions | SellReceiptWithPaymentsOptions): Promise<ReceiptWithCompany>;
 /**
  * Storno-Beleg zu einem bestehenden Beleg — voll oder in Teilen. Prueft die
  * Eingabe, bevor etwas hinausgeht; der Server haelt die Restmengen und die

package/dist/cjs/client/receipts.js

@@ -65,6 +65,22 @@ function createReceiptParams(options) {
     if (items != null && items.length > 0) {
         params['items'] = alsNutzlast(items, index_js_2.toReceiptItemPayload);
     }
+    // `payments: null` gilt wie im Backend (zahlungs-eingang.js) als nicht angegeben.
+    if (options.payments != null) {
+        // Der alte Storno-Weg und der Null-/Startbeleg nehmen keine Zahlungsliste
+        // (Backend: PAYMENTS_NOT_ALLOWED); ein Storno mit mehreren Zahlungen
+        // laeuft ueber cancelReceipt.
+        if (typ.value === index_js_1.ReceiptType.cancellation.value) {
+            throw eingabefehler('payments am Storno gehen nur ueber cancelReceipt.');
+        }
+        if (typ.value !== index_js_1.ReceiptType.standard.value && typ.value !== index_js_1.ReceiptType.training.value) {
+            throw eingabefehler(`payments sind bei receiptType "${typ.value}" nicht erlaubt.`);
+        }
+        const konflikt = zahlungsKonflikt(options);
+        if (konflikt != null)
+            throw eingabefehler(konflikt);
+        params['payments'] = gepruefteZahlungen(options.payments, false, 'createReceipt');
+    }
     // Vom Aufrufer kommt sie geprueft, vom Server roh — siehe die beiden Felder
     // in [CreateReceiptOptions]. Die Typpruefung allein reicht dafuer nicht: ein
     // Verbraucher ohne Typen faellt durch dieses Netz, und ein Tippfehler in der
@@ -148,11 +164,15 @@ async function cancelReceipt(rufen, options) {
     if (options.note !== undefined && options.note.length > NOTE_MAX) {
         throw new errors_js_1.KasseneckValidationError('cancelReceipt', `Anmerkung ist zu lang (hoechstens ${NOTE_MAX} Zeichen)`, 'request');
     }
+    // `payments: null` gilt wie im Backend als nicht angegeben.
+    const zahlungen = options.payments != null ? gepruefteStornoZahlungen(options) : undefined;
     const params = { cashregisterId, originalReceiptId, reason: options.reason };
     if (options.items !== undefined)
         params.items = options.items.map((p) => ({ index: p.index, quantity: p.quantity }));
     if (options.note !== undefined && options.note !== '')
         params.note = options.note;
+    if (zahlungen !== undefined)
+        params.payments = zahlungen;
     if (options.paymentMethod != null)
         params.paymentMethod = gepruefteZahlungsart(options.paymentMethod);
     const karte = options.creditCardProvider != null || options.cardPaymentId != null || options.cardPaymentData != null;
@@ -506,15 +526,110 @@ function gepruefterTip(tip) {
     }
     return nutzlast;
 }
-/** Zahlungsart des Aufrufers pruefen — unbekannt wirft, bevor etwas rausgeht. */
+/**
+ * Zahlungsart des Aufrufers pruefen — unbekannt wirft, bevor etwas rausgeht.
+ * `mixed` wirft ebenfalls: den Wert vergibt nur der Server (Beleg mit
+ * mehreren Zahlarten); gesendet wird stattdessen die Zahlungsliste.
+ */
 function gepruefteZahlungsart(wert) {
-    if (typeof wert === 'object') {
-        return wert.value;
+    let zahlungsart;
+    if (typeof wert === 'object' && wert !== null) {
+        zahlungsart = wert.value;
+    }
+    else {
+        if (typeof wert !== 'string' || !Object.prototype.hasOwnProperty.call(index_js_1.KeckPaymentMethod, wert)) {
+            throw eingabefehler(`Zahlungsart: unbekannter Schluessel "${String(wert)}"`);
+        }
+        zahlungsart = index_js_1.KeckPaymentMethod[wert].value;
     }
-    if (!Object.prototype.hasOwnProperty.call(index_js_1.KeckPaymentMethod, wert)) {
-        throw eingabefehler(`Zahlungsart: unbekannter Schluessel "${wert}"`);
+    if (zahlungsart === index_js_1.KeckPaymentMethod.mixed.value) {
+        throw eingabefehler('Zahlungsart "mixed" vergibt nur der Server – mehrere Zahlarten gehen als payments hinaus.');
     }
-    return index_js_1.KeckPaymentMethod[wert].value;
+    return zahlungsart;
+}
+/** Hoechstzahl der Zahlungen je Beleg (Backend: MAX_ZAHLUNGEN). */
+const MAX_ZAHLUNGEN = 20;
+/**
+ * `payments` neben einer Einzel-Zahlungsart oder Kartenfeldern? Liefert den
+ * Grund (Backend: PAYMENTS_CONFLICT), sonst null. Nie still eines bevorzugen.
+ */
+function zahlungsKonflikt(options) {
+    for (const feld of ['paymentMethod', 'paymentMethodFromServer', 'creditCardProvider', 'cardPaymentId', 'cardPaymentData']) {
+        if (options[feld] != null) {
+            return `payments und ${feld} duerfen nicht gemeinsam gesendet werden – Kartenangaben gehoeren in die Zahlung.`;
+        }
+    }
+    return null;
+}
+/**
+ * Zahlungsliste pruefen und in Nutzlast-Form bringen — Formpruefung wie
+ * `pruefeZahlungen` im Backend, soweit sie ohne Beleg und Zahlbetrag geht
+ * (Summe, Anbieter-Pflicht und Trinkgeld prueft der Server). Wirft, bevor
+ * etwas hinausgeht.
+ */
+function gepruefteZahlungen(roh, storno, functionName) {
+    const fehler = (grund) => new errors_js_1.KasseneckValidationError(functionName, grund, 'request');
+    if (!Array.isArray(roh))
+        throw fehler('payments muss eine Liste sein.');
+    if (roh.length > MAX_ZAHLUNGEN)
+        throw fehler(`payments: es sind hoechstens ${MAX_ZAHLUNGEN} Eintraege erlaubt.`);
+    return roh.map((eintrag, i) => {
+        const nr = i + 1;
+        if (eintrag == null || typeof eintrag !== 'object' || Array.isArray(eintrag)) {
+            throw fehler(`Zahlung ${nr}: kein gueltiges Objekt.`);
+        }
+        const z = eintrag;
+        const method = gepruefteZahlungsart(z['method']);
+        const betrag = z['amountCents'];
+        if (typeof betrag !== 'number' || !Number.isInteger(betrag) || (storno ? betrag >= 0 : betrag <= 0)) {
+            throw fehler(`Zahlung ${nr}: amountCents muss eine ganze Zahl ${storno ? 'kleiner' : 'groesser'} als 0 sein.`);
+        }
+        const aus = { method, amountCents: betrag };
+        if (z['tenderedCents'] !== undefined) {
+            const gegeben = z['tenderedCents'];
+            if (storno || typeof gegeben !== 'number' || !Number.isInteger(gegeben) || gegeben < betrag) {
+                throw fehler(`Zahlung ${nr}: tenderedCents muss eine ganze Zahl von mindestens amountCents sein (nur am Verkauf).`);
+            }
+            aus['tenderedCents'] = gegeben;
+        }
+        if (z['tipCents'] !== undefined) {
+            const trinkgeld = z['tipCents'];
+            if (typeof trinkgeld !== 'number' || !Number.isInteger(trinkgeld) || trinkgeld <= 0) {
+                throw fehler(`Zahlung ${nr}: tipCents muss eine ganze Zahl groesser als 0 sein.`);
+            }
+            aus['tipCents'] = trinkgeld;
+        }
+        if (z['provider'] !== undefined) {
+            aus['provider'] = kartenanbieter(String(z['provider']));
+        }
+        if (z['providerPaymentId'] !== undefined) {
+            if (typeof z['providerPaymentId'] !== 'string' || z['providerPaymentId'] === '') {
+                throw fehler(`Zahlung ${nr}: providerPaymentId muss ein nicht-leerer Text sein.`);
+            }
+            aus['providerPaymentId'] = z['providerPaymentId'];
+        }
+        if (z['providerData'] !== undefined) {
+            const daten = z['providerData'];
+            if (daten === null || typeof daten !== 'object' || Array.isArray(daten)) {
+                throw fehler(`Zahlung ${nr}: providerData muss ein Objekt sein.`);
+            }
+            aus['providerData'] = daten;
+        }
+        if (z['refundOf'] !== undefined) {
+            if (!storno || typeof z['refundOf'] !== 'string' || z['refundOf'] === '') {
+                throw fehler(`Zahlung ${nr}: refundOf gibt es nur am Storno, als id der Originalzahlung.`);
+            }
+            aus['refundOf'] = z['refundOf'];
+        }
+        return aus;
+    });
+}
+/** `payments` am Storno: Konflikt mit Zahlungsart/Kartenfeldern, dann Form. */
+function gepruefteStornoZahlungen(options) {
+    const konflikt = zahlungsKonflikt(options);
+    if (konflikt != null)
+        throw new errors_js_1.KasseneckValidationError('cancelReceipt', konflikt, 'request');
+    return gepruefteZahlungen(options.payments, true, 'cancelReceipt');
 }
 /** Kartenanbieter pruefen — er stammt vom Aufrufer, nicht aus Serverdaten. */
 function kartenanbieter(wert) {

package/dist/cjs/enums/keck-payment-method.d.ts

@@ -5,6 +5,11 @@
  * `label` ist das deutsche Anzeige-Label fuer die Zahlungsart-Zeile auf dem Beleg.
  * Muss 1:1 mit dem Backend-Mapping `paymentMethodToString` (functions/helper.js)
  * uebereinstimmen.
+ *
+ * `mixed` vergibt nur der Server: ein Beleg mit mehreren Zahlungen
+ * verschiedener Zahlart (`payments`) traegt ihn als Einzelfeld
+ * `paymentMethod`. Lesen ist erlaubt, Senden nicht — wer mehrere Zahlarten
+ * kassiert, schickt die Zahlungsliste, nie `mixed`.
  */
 export declare const KeckPaymentMethod: {
     readonly cash: {
@@ -52,6 +57,11 @@ export declare const KeckPaymentMethod: {
         readonly needsCreditCard: true;
         readonly label: "Bolt Card";
     };
+    readonly mixed: {
+        readonly value: "mixed";
+        readonly needsCreditCard: false;
+        readonly label: "Mehrere Zahlungsarten";
+    };
 };
 export type KeckPaymentMethodKey = keyof typeof KeckPaymentMethod;
 export type KeckPaymentMethod = (typeof KeckPaymentMethod)[KeckPaymentMethodKey];

package/dist/cjs/enums/keck-payment-method.js

@@ -9,6 +9,11 @@ const define_enum_js_1 = require("./define-enum.js");
  * `label` ist das deutsche Anzeige-Label fuer die Zahlungsart-Zeile auf dem Beleg.
  * Muss 1:1 mit dem Backend-Mapping `paymentMethodToString` (functions/helper.js)
  * uebereinstimmen.
+ *
+ * `mixed` vergibt nur der Server: ein Beleg mit mehreren Zahlungen
+ * verschiedener Zahlart (`payments`) traegt ihn als Einzelfeld
+ * `paymentMethod`. Lesen ist erlaubt, Senden nicht — wer mehrere Zahlarten
+ * kassiert, schickt die Zahlungsliste, nie `mixed`.
  */
 exports.KeckPaymentMethod = (0, define_enum_js_1.defineEnum)({
     cash: { value: 'cash', needsCreditCard: false, label: 'Barzahlung' },
@@ -20,4 +25,5 @@ exports.KeckPaymentMethod = (0, define_enum_js_1.defineEnum)({
     boltApp: { value: 'boltApp', needsCreditCard: false, label: 'Bolt App' },
     boltCash: { value: 'boltCash', needsCreditCard: false, label: 'Bolt Cash' },
     boltCard: { value: 'boltCard', needsCreditCard: true, label: 'Bolt Card' },
+    mixed: { value: 'mixed', needsCreditCard: false, label: 'Mehrere Zahlungsarten' },
 });

package/dist/cjs/index.d.ts

@@ -1,5 +1,5 @@
 export { ReceiptType, type ReceiptTypeKey, VatRate, type VatRateKey, KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider, type CreditCardProviderKey, VoucherType, type VoucherTypeKey, VoucherAction, type VoucherActionKey, StripeLinkMode, type StripeLinkModeKey, } from './enums/index.js';
-export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, CANCELLATION_REASONS, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, type ReceiptEmailErrorCode, RECEIPT_EMAIL_ERROR_CODES, isReceiptEmailErrorCode, remainingQuantities, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, istZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
-export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, AUFRUFE, type Aufruf, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
+export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, CANCELLATION_REASONS, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, type PaymentErrorCode, PAYMENT_ERROR_CODES, isPaymentErrorCode, type ReceiptEmailErrorCode, RECEIPT_EMAIL_ERROR_CODES, isReceiptEmailErrorCode, remainingQuantities, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, istZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
+export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, AUFRUFE, type Aufruf, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, type ReceiptCommonOptions, type SellReceiptOptions, type SellReceiptWithPaymentsOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
 export { parseServerTimeStamp, toViennaWallClock, type ViennaWallClock } from './vienna-time.js';
 export { type KasseSettingsBetrieb, type KasseSettingsGeraet, type KasseSettings, type ArticleGroup, type KasseArtikel, KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, fromArticleGroupPayload, fromKasseArtikelPayload, listMyArticleGroups, listMyArticles, getKasseSettings, setMyKasseSettings, setMyRegisterDeviceSettings, verteileRabatt, cancelScopeOf, receiptsScopeOf, } from './kasse/index.js';

package/dist/cjs/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AUFRUFE = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = 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.remainingQuantities = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_ERROR_CODES = 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.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = exports.StripeLinkMode = exports.VoucherAction = exports.VoucherType = exports.CreditCardProvider = exports.KeckPaymentMethod = exports.VatRate = exports.ReceiptType = void 0;
-exports.receiptsScopeOf = exports.cancelScopeOf = exports.verteileRabatt = exports.setMyRegisterDeviceSettings = exports.setMyKasseSettings = exports.getKasseSettings = exports.listMyArticles = exports.listMyArticleGroups = exports.fromKasseArtikelPayload = exports.fromArticleGroupPayload = exports.mergeKasseSettings = exports.KASSE_GERAET_STANDARD = exports.KASSE_BETRIEB_STANDARD = exports.toViennaWallClock = exports.parseServerTimeStamp = exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyCashregisters = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.createCancelReceipt = exports.cancelReceipt = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.createBinaryTransport = exports.createTransport = void 0;
+exports.apiKeyAuth = 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.remainingQuantities = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_ERROR_CODES = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = 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.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = exports.StripeLinkMode = exports.VoucherAction = exports.VoucherType = exports.CreditCardProvider = exports.KeckPaymentMethod = exports.VatRate = exports.ReceiptType = void 0;
+exports.receiptsScopeOf = exports.cancelScopeOf = exports.verteileRabatt = exports.setMyRegisterDeviceSettings = exports.setMyKasseSettings = exports.getKasseSettings = exports.listMyArticles = exports.listMyArticleGroups = exports.fromKasseArtikelPayload = exports.fromArticleGroupPayload = exports.mergeKasseSettings = exports.KASSE_GERAET_STANDARD = exports.KASSE_BETRIEB_STANDARD = exports.toViennaWallClock = exports.parseServerTimeStamp = exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyCashregisters = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.createCancelReceipt = exports.cancelReceipt = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.createBinaryTransport = exports.createTransport = exports.AUFRUFE = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_BASE_URL = exports.registerUserAuth = void 0;
 var index_js_1 = require("./enums/index.js");
 Object.defineProperty(exports, "ReceiptType", { enumerable: true, get: function () { return index_js_1.ReceiptType; } });
 Object.defineProperty(exports, "VatRate", { enumerable: true, get: function () { return index_js_1.VatRate; } });
@@ -29,6 +29,10 @@ Object.defineProperty(exports, "CANCELLATION_ERROR_CODES", { enumerable: true, g
 Object.defineProperty(exports, "CANCELLATION_RESERVATION_MS", { enumerable: true, get: function () { return index_js_2.CANCELLATION_RESERVATION_MS; } });
 Object.defineProperty(exports, "isCancellationReason", { enumerable: true, get: function () { return index_js_2.isCancellationReason; } });
 Object.defineProperty(exports, "isCancellationErrorCode", { enumerable: true, get: function () { return index_js_2.isCancellationErrorCode; } });
+Object.defineProperty(exports, "fromReceiptPaymentPayload", { enumerable: true, get: function () { return index_js_2.fromReceiptPaymentPayload; } });
+Object.defineProperty(exports, "toReceiptPaymentPayload", { enumerable: true, get: function () { return index_js_2.toReceiptPaymentPayload; } });
+Object.defineProperty(exports, "PAYMENT_ERROR_CODES", { enumerable: true, get: function () { return index_js_2.PAYMENT_ERROR_CODES; } });
+Object.defineProperty(exports, "isPaymentErrorCode", { enumerable: true, get: function () { return index_js_2.isPaymentErrorCode; } });
 Object.defineProperty(exports, "RECEIPT_EMAIL_ERROR_CODES", { enumerable: true, get: function () { return index_js_2.RECEIPT_EMAIL_ERROR_CODES; } });
 Object.defineProperty(exports, "isReceiptEmailErrorCode", { enumerable: true, get: function () { return index_js_2.isReceiptEmailErrorCode; } });
 Object.defineProperty(exports, "remainingQuantities", { enumerable: true, get: function () { return index_js_2.remainingQuantities; } });

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

@@ -27,8 +27,18 @@ export declare function isCancellationReason(value: unknown): value is Cancellat
  *
  * Nur Auth-/Parameterfehler (Sitzung abgelaufen, Pflichtfeld fehlt) kommen
  * ohne Code; dort bleibt `code` undefined.
+ *
+ * Die vier `STORNO_…`-Codes am Ende gehoeren zur Rueckzahlung je Zahlung
+ * (mehrere Zahlungen je Beleg); Formfehler an `payments` selbst melden die
+ * Codes aus [PAYMENT_ERROR_CODES].
+ *
+ * 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.
  */
-export declare const CANCELLATION_ERROR_CODES: readonly ["beleg_nicht_gefunden", "belegart_nicht_stornierbar", "trainingsbeleg", "bereits_storniert", "position_ungueltig", "menge_ueber_rest", "grund_unbekannt", "anmerkung_zu_lang", "items_ungueltig", "kasse_nicht_zugewiesen", "keine_berechtigung", "nur_eigene_belege", "kasse_unvollstaendig", "storno_fehlgeschlagen"];
+export declare const CANCELLATION_ERROR_CODES: readonly ["beleg_nicht_gefunden", "belegart_nicht_stornierbar", "trainingsbeleg", "bereits_storniert", "position_ungueltig", "menge_ueber_rest", "grund_unbekannt", "anmerkung_zu_lang", "items_ungueltig", "kasse_nicht_zugewiesen", "keine_berechtigung", "nur_eigene_belege", "kasse_unvollstaendig", "storno_fehlgeschlagen", "STORNO_PAYMENTS_REQUIRED", "STORNO_REFUND_EXCEEDS_PAYMENT", "STORNO_REFUND_REFERENCE_REQUIRED", "STORNO_REFUND_REFERENCE_UNKNOWN"];
 export type CancellationErrorCode = (typeof CANCELLATION_ERROR_CODES)[number];
 export declare function isCancellationErrorCode(value: unknown): value is CancellationErrorCode;
 /** Bezug eines Storno-Belegs auf sein Original. */

package/dist/cjs/models/cancellation.js

@@ -33,6 +33,16 @@ function isCancellationReason(value) {
  *
  * Nur Auth-/Parameterfehler (Sitzung abgelaufen, Pflichtfeld fehlt) kommen
  * ohne Code; dort bleibt `code` undefined.
+ *
+ * Die vier `STORNO_…`-Codes am Ende gehoeren zur Rueckzahlung je Zahlung
+ * (mehrere Zahlungen je Beleg); Formfehler an `payments` selbst melden die
+ * Codes aus [PAYMENT_ERROR_CODES].
+ *
+ * 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.
  */
 exports.CANCELLATION_ERROR_CODES = [
     'beleg_nicht_gefunden', // Original fehlt oder gehoert nicht zu dieser Kasse
@@ -49,6 +59,11 @@ exports.CANCELLATION_ERROR_CODES = [
     '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
 ];
 function isCancellationErrorCode(value) {
     return typeof value === 'string' && exports.CANCELLATION_ERROR_CODES.includes(value);

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

@@ -2,6 +2,8 @@ export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead,
 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 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 ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, } from './receipt-company.js';
 export { type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, } from './cashregister.js';

package/dist/cjs/models/index.js

@@ -1,6 +1,6 @@
 "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.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.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;
 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; } });
@@ -25,6 +25,12 @@ Object.defineProperty(exports, "CANCELLATION_RESERVATION_MS", { enumerable: true
 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, "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; } });
+Object.defineProperty(exports, "toReceiptPaymentPayload", { enumerable: true, get: function () { return receipt_payment_js_1.toReceiptPaymentPayload; } });
+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; } });
 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, "isReceiptEmailErrorCode", { enumerable: true, get: function () { return receipt_email_js_1.isReceiptEmailErrorCode; } });

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

@@ -0,0 +1,22 @@
+/**
+ * Mehrere Zahlungen je Beleg — Fehlercode-Katalog, Zwilling von
+ * `functions/gemeinsam/zahlungen-core.js` ZAHLUNGS_FEHLERCODES (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
+ * 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()`.
+ */
+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 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>;