@kreiseck/kasseneck-api 0.29.0 → 0.31.0

package/CHANGELOG.md

@@ -4,6 +4,180 @@ 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.31.0
+
+Texte und Einstellung für „Getrennt zahlen" an der Kasse (ein Tisch zahlt in Teilen, ein Beleg mit
+mehreren Zahlungen). Nur Texte, eine Einstellung und eine Tasten-Aktion; kein Aufruf und kein
+Rechenweg ändert sich.
+
+- **`tenderedCents` an jeder Barzahlung**: die Doku an `ReceiptPaymentInput` und
+  `PAYMENT_TENDERED_INVALID` sagte „höchstens an einer Zahlung“. Das Backend erlaubt jetzt jeder
+  Barzahlung ihren eigenen gegebenen Betrag. Grund: beim getrennten Zahlen gibt jeder Gast selbst,
+  der Bon zeigte Gegeben/Rückgeld aber nur beim letzten. Der Bon druckte schon je Zahlung; ein Test
+  hält drei Barzahlungen mit je eigenem Rückgeld fest.
+- **Neue Sätze in `MELDUNGEN`** unter `getrennt.*` (Hinweis zur Einstellung, Prüfungen der
+  Teilzahlung, gesperrter Warenkorb, Rückbuchung bar/Terminal/Karte ohne Anbindung, angefangene
+  Sitzung nach dem Neuladen) und unter `storno.*` (Rückgabe je Zahlung, Karten nach dem Storno von Hand gutschreiben).
+  Grund: Browser-Kasse und Kassen-App sollen am Tresen dieselben Worte sagen; eine schon belastete
+  Karte nennt in jedem Satz den Betrag, und keiner rät zum zweiten Kassieren.
+- **`STORNO_ZAHLUNG_FEHLER`**: Zuordnung der Backend-Codes `STORNO_PAYMENTS_REQUIRED`,
+  `STORNO_REFUND_EXCEEDS_PAYMENT`, `STORNO_REFUND_REFERENCE_REQUIRED`,
+  `STORNO_REFUND_REFERENCE_UNKNOWN` und `PAYMENTS_SUM_MISMATCH` zu ihrem Satz, auch in
+  `fixtures/kasse-texte.json` (`stornoZahlungFehler`). Grund: beide Kassen entscheiden am Code,
+  nie am Wortlaut des Backends. `stornoZahlungFehler(code)` liefert den Schlüssel dazu, ein
+  unbekannter Code fällt auf `storno.fehlgeschlagen` (wie `belegMailFehler`).
+- **Neuer Storno-Code `STORNO_OUTCOME_UNKNOWN`** am Ende von `CANCELLATION_ERROR_CODES` (Zwilling
+  von `STORNO_FEHLERCODES` in `functions/gemeinsam/storno-core.js`; unter `/v3`
+  `cancellation_outcome_unknown`, `isCancellationErrorCode` prüft weiter exakt) mit dem Satz
+  `storno.ergebnis_unklar`. Grund: der Storno-Beleg kann schon signiert sein, obwohl der Ausgang
+  offen ist; wer dann noch einmal storniert, storniert womöglich doppelt. Der Satz rät darum,
+  nicht zu wiederholen und die Belegliste später neu zu laden.
+- **Aufteilung als eigener Schritt**: neue Beschriftungen `getrennt.weiter` („Weiter · {betrag}
+  getrennt“), `getrennt.aufteilung`, `getrennt.zurueck_zahlart`, `getrennt.tab_positionen`,
+  `getrennt.tab_betrag`, `getrennt.stueck_mehr`/`_weniger`,
+  `getrennt.gegeben`, `getrennt.gegeben_rueckgeld` und die Sätze
+  `getrennt.positionen_gesperrt` und `getrennt.positionen_waehlen`. Grund: Nutzertest – erst
+  „Weiter“, dann je Zahlung nach Positionen (stückweise) oder als Betrag. Nach einer Zahlung als
+  Betrag ist „Nach Positionen“ gesperrt, weil sich Beträge keinen Stücken zuordnen lassen; der
+  Satz sagt das.
+- **Zahlart je Zahlung, ein Knopf zum Hinzufügen**: `getrennt.zahlart` („Zahlart“),
+  `getrennt.art_bar`/`getrennt.art_karte` („Bar“/„Karte“) als Umschalter oben in der Zahlung,
+  `getrennt.zahlung_hinzufuegen` („Zahlung hinzufügen · {betrag}“) für den einen Knopf unten
+  rechts und der Satz `getrennt.gegeben_fehlt` (Barzahlung ohne „Gegeben“ bei eingeschaltetem
+  Rückgeld-Rechner, Wortlaut wie beim Abschluss). `getrennt.bar_kassieren`/`getrennt.karte_kassieren`
+  und `getrennt.kassieren` („Zahlung {n} kassieren“) entfallen (noch nie veröffentlicht). Grund: Nutzertest – zwei Knöpfe, die sofort kassieren,
+  lagen zu nah beieinander; jetzt wählt der Kassier die Zahlart wie jede andere Eingabe, und nur
+  ein Knopf löst die Zahlung aus. Offen 0 macht aus demselben Knopf „Abschließen“.
+- **Nach Positionen als Kacheln**: `getrennt.offene_positionen`, `getrennt.stueck_offen`
+  („{n} offen“), `getrennt.stueck_gewaehlt` („{n} von {offen}“), `getrennt.nichts_gewaehlt` und
+  `getrennt.alles_bezahlt`. `getrennt.stueck_bezahlt` entfällt (noch nie veröffentlicht): bezahlte
+  Stück verschwinden aus der Auswahl. Grund: Nutzertest – in der großen Fläche stehen nur noch die
+  offenen Produkte als Kacheln, der Kassier tippt dort an, was dieser Gast zahlt.
+- **`BESCHRIFTUNGEN` und `beschriftung()`**: ein zweiter Katalog für Knöpfe und Zeilennamen
+  („Getrennt", „Zahlung {n}", „Offen", „Rest", „÷ {n}", „davon Trinkgeld {betrag}", „Wie
+  zurückgeben?", „Alles bar", „Mehrere" …), in `fixtures/kasse-texte.json` unter `beschriftungen`.
+  Grund: `MELDUNGEN` führt nur Sätze (die Wächter beider Kassen erkennen Sätze daran), „Rest" ist
+  keiner – muss aber in beiden Kassen gleich heißen. Die Zahlarten folgen dem Bon
+  („Kartenzahlung", „Barzahlung").
+- **Vier weitere Sätze unter `getrennt.*`**: `sitzung_unlesbar` (eine auf dem Gerät abgelegte
+  Sitzung lässt sich nicht mehr lesen – auf schon belastete Karten hinweisen, im Panel oder am
+  Terminal nachsehen lassen), `ablage_fehlgeschlagen` (die Ablage schlägt fehl – vor dem
+  Neuladen warnen, sonst verschwinden belastete Karten aus der Liste), `zu_viele_zahlungen`
+  (höchstens 20 Zahlungen je Beleg) und `entkoppeln_offene_karten` (ein entkoppeltes Gerät hatte
+  noch offene Kartenzahlungen – die Beträge stehen daneben, der Satz selbst bleibt ohne
+  Platzhalter). Grund: die Ablage der Teilzahlung läuft rein lokal auf dem Gerät; geht sie
+  verloren oder lässt sie sich nicht lesen, ist eine schon belastete Karte das teure Risiko, und
+  der Satz muss zum Nachschauen anleiten statt zum Weiterkassieren zu verleiten.
+- **Einstellung `zahlGetrennt`** (Betrieb, Standard `false`) und **Tasten-Aktion `getrennt`**
+  (ohne Vorgabe-Taste). Grund: für Betriebe ohne Bedarf bleibt die Kasse, wie sie ist; eine
+  unerprobte Vorgabe-Taste finge womöglich der Browser ab. Das Backend (`kasse-settings-core.js`)
+  muss beide nachziehen, sonst verwirft sein Validator den Wert beim Speichern.
+- **Vorgabe `kassierenModus` jetzt `'panel'`** (vorher `'seite'`): kassiert wird im Korb-Panel,
+  die Kacheln bleiben stehen. Grund: Nutzertest – so bleibt der Kachelbereich beim Kassieren
+  sichtbar, auch beim getrennten Zahlen. Ein gespeichertes `'seite'` bleibt; gespeichert werden
+  aber nur geänderte Felder, darum wechselt jedes Konto, das den Schalter nie angefasst hat, mit
+  dem Backend-Standard auf das Korb-Panel. Das Backend (`BETRIEB_STANDARD` in
+  `kasse-settings-core.js`) und der Dart-Zwilling ziehen denselben Wert nach.
+- **Texte, die bisher nur in der Browser-Kasse standen, jetzt im Katalog**: Sätze
+  `kassieren.nichts_erfasst`, `kassieren.gegeben_fehlt`, `kassieren.gegeben_zu_wenig`,
+  `kassieren.gesperrt` („Kassieren gesperrt: {grund}“), `trinkgeld.ueber_haelfte`,
+  `sitzung.meldet_ab` („Kasse meldet in {sekunden} s ab …“), `abmelden.noch_einmal`,
+  `kartenzahlung.terminal_bricht_ab` und `connect.entkoppeln_frage` (nur Web); Beschriftungen
+  `kassieren.trinkgeld`, `kassieren.kein`, `kassieren.eigener_betrag`, `kassieren.passend`,
+  `kassieren.gegeben_loeschen`, `kassieren.es_fehlen_noch`, `kassieren.rueckgeld`,
+  `kartenzahlung.betrag_am_terminal`, `kartenzahlung.karte_vorhalten` („… · noch {zeit}“),
+  `kopplung.neu_koppeln`, `abmelden.frage`, `abmelden.weiter_arbeiten`, `geraet.entkoppeln`,
+  `connect.entkoppeln_bestaetigen` (nur Web), `storno.titel` („Storno zu {beleg}“),
+  `meldung.ausblenden` („Meldung ausblenden: {meldung}“) und `meldung.warnung_ausblenden`
+  („Verstanden – Warnung ausblenden: {meldung}“). Wortlaut wie bisher in der Browser-Kasse.
+  Grund: Oberflächen-Vertrag – beide Kassen zeigen dieselben Wörter; das X an einer Meldung nennt
+  jetzt, welche Meldung es ausblendet (in der Ecke stehen oft mehrere).
+- **Halbgeviertstrich statt Geviertstrich** in allen sichtbaren Texten von `MELDUNGEN` (u. a.
+  `abschluss.unklar`, `kartenzahlung.unklar`, `kartenzahlung.karte_gebucht_beleg_offen`,
+  `connect.*`, `druck.*`) und in den Sätzen der Hobex-Antwortcodes (`transaction-response.ts`,
+  auch `fixtures/hobex-hps-codes.json`): „ – “ statt „ — “. Nur das Zeichen ändert sich, kein
+  Wortlaut und kein Schlüssel. Wer einen dieser Sätze wörtlich vergleicht, muss nachziehen.
+  Grund: einheitliche Typografie am Bildschirm; der Geviertstrich wirkt dort wie ein
+  Maschinenzeichen. Die Rechnungstexte (`rechnung/texte.ts`, PDF) bleiben unverändert.
+- **`Cancellation` trägt `refundedByPayment`** (Zahlungs-ID auf positive Cent), Zwilling der
+  gleichnamigen Backend-Ablage (`functions/gemeinsam/storno-core.js`). Die Lesung
+  (`fromReceiptPayload`) behält nur ganzzahlige, nicht negative Werte, verwirft ungültige
+  Einträge einzeln statt den ganzen Eintrag zu verwerfen, und lässt das Feld weg, wenn die
+  Nutzlast es nicht trägt – bestehende Belege lesen sich unverändert. Auch am `pending`-Eintrag
+  vorhanden. Grund: über alle Storno-Einträge darf je Zahlung nie mehr zurückgehen, als bezahlt
+  wurde; ohne das Feld ließe sich das am Client nicht nachvollziehen.
+- **Weitere Sätze in `MELDUNGEN`**: `getrennt.karte_bereits_zurueckgebucht` (das Terminal meldet
+  eine Gutschrift, die hier noch als offene Rückbuchung steht), `abschluss.erledigen_frage` (nur erledigen, was wirklich in der Belegliste steht),
+  `kartenzahlung.korb_gesperrt_karte_belastet` und `kartenzahlung.entkoppeln_karte_belastet`.
+  Grund: jeder dieser Zustände ist eine schon belastete oder gutgeschriebene Karte ohne
+  passenden Beleg – der teuerste Fehler am Tresen ist die doppelte Buchung, und kein Satz davon
+  darf zum Wiederholen raten, ohne vorher den Terminal-Beleg zu nennen.
+- **Weitere `BESCHRIFTUNGEN`**: `allgemein.abbrechen`, `abschluss.beleg_vorhanden`,
+  `abschluss.erledigen`, `getrennt.karte_zurueckbuchen`, `getrennt.trotzdem_neu_koppeln`,
+  `getrennt.zahlung_behalten`, `getrennt.klaeren`, `getrennt.wurde_belastet`,
+  `getrennt.nicht_belastet`, `getrennt.erneut_zurueckbuchen`, `storno.differenz`. Grund: Knöpfe
+  zu den neuen Sätzen oben, in beiden Kassen gleich beschriftet.
+- **Storno eines Belegs mit mehreren Zahlungen: Karten gehen von Hand zurück.**
+  `storno.karten_gutschreiben` steht nach dem gebuchten Storno über der Liste der Karten zum
+  Abhaken (eine oder mehrere, mit oder ohne Anbindung); `storno.ergebnis_unklar_karten` ersetzt
+  `storno.ergebnis_unklar`, wenn der gesendete Vorschlag Karten enthielt – erst die Belegliste
+  neu laden, erst dann gutschreiben (`STORNO_ZAHLUNG_FEHLER` zeigt weiter auf
+  `storno.ergebnis_unklar`, die Wahl trifft die Kasse am Vorschlag). Die Sätze und Knöpfe einer
+  Gutschrift am Terminal VOR dem Senden (`storno.gutschrift_laeuft`,
+  `storno.gutschrift_fehlgeschlagen`, `storno.gutschrift_unklar`,
+  `storno.gutgeschrieben_nicht_gebucht`, `storno.gutschrift_pruefen`,
+  `storno.extern_gutschreiben`, `storno.am_terminal_gutgeschrieben`,
+  `storno.nicht_gutgeschrieben`) sind wieder entfernt; sie waren nie veröffentlicht. Grund:
+  eine Gutschrift vor dem gebuchten Storno lässt Geld zurückgehen, ohne dass ein Storno-Beleg
+  sicher entsteht; die automatische Gutschrift kommt als eigener Schritt mit
+  Server-Unterstützung.
+- **`storno.karten_nicht_abgehakt`**: wird die Liste der Karten nach dem gebuchten Storno
+  geschlossen, obwohl nicht jede Karte abgehakt ist, fragt die Kasse einmal nach. Grund: eine
+  vergessene Gutschrift fällt sonst erst dem Gast auf, und am Storno-Beleg sieht sie niemand mehr.
+
+## 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,

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/kasse/index.d.ts

@@ -10,4 +10,4 @@ export { verteileRabatt } from '../receipt/discount.js';
 export { cancelScopeOf, receiptsScopeOf, type RegisterScope, type RegisterUserPerms } from '../register/pairing.js';
 export { type NetzDrucker, type DruckJob, type DruckJobStatus, type CreatePrintJobOptions, listMyPrinters, createPrintJob, getPrintJob } from './drucker.js';
 export { listMyTipRecipients } from './trinkgeld.js';
-export { MELDUNGEN, FEHLERREGELN, meldung, meldungGiltFuer, BELEG_MAIL_FEHLER, belegMailFehler, type Meldung, type MeldungsSchluessel, type Fehlerart, type Seite, type BelegMailFehlercode, } from './texte.js';
+export { MELDUNGEN, FEHLERREGELN, meldung, meldungGiltFuer, BELEG_MAIL_FEHLER, belegMailFehler, STORNO_ZAHLUNG_FEHLER, stornoZahlungFehler, BESCHRIFTUNGEN, beschriftung, type Meldung, type MeldungsSchluessel, type Fehlerart, type Seite, type BelegMailFehlercode, type StornoZahlungFehlercode, type BeschriftungsSchluessel, } from './texte.js';

package/dist/cjs/kasse/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createPrintJob = exports.listMyPrinters = exports.receiptsScopeOf = exports.cancelScopeOf = exports.verteileRabatt = exports.setMyRegisterDeviceSettings = exports.setMyKasseSettings = exports.getKasseSettings = exports.mengeErlaubt = exports.mengenVorgabe = exports.mengenregelFuerEinheit = exports.listMyArticles = exports.listMyArticleGroups = exports.fromKasseArtikelPayload = exports.fromArticleGroupPayload = exports.FERTIG_SEKUNDEN = exports.WZ_SKALA = exports.LOGO_SKALA = exports.WZ_STAERKE = exports.WZ_SEITE = exports.RABATT = exports.AUTO_AB_MIN = exports.KACHELSTIL = exports.SCHRIFT_EINST = exports.LOGO_GROESSE = exports.TASTEN_AKTIONEN = exports.QR_MODUS = exports.LADE_AUTO = exports.SCHNITT = exports.ZEICHENSATZ = exports.PAPIER = exports.TERMINAL_ART = exports.TERMINAL_VIA = exports.DRUCKER_ART = exports.HOEHE = exports.KATPOS = exports.LAYOUT = exports.BELEG_AUSGABE = exports.KASSIEREN_MODUS = exports.TG_MODUS = exports.MENGE = exports.WASSERZEICHEN = exports.SCHRIFT = exports.STIL = exports.mergeKasseSettings = exports.KASSE_GERAET_STANDARD = exports.KASSE_BETRIEB_STANDARD = exports.KASSE_TASTEN_STANDARD = exports.KASSE_TASTEN_AKTIONEN = exports.KARTENANBIETER = void 0;
-exports.belegMailFehler = exports.BELEG_MAIL_FEHLER = exports.meldungGiltFuer = exports.meldung = exports.FEHLERREGELN = exports.MELDUNGEN = exports.listMyTipRecipients = exports.getPrintJob = void 0;
+exports.beschriftung = exports.BESCHRIFTUNGEN = exports.stornoZahlungFehler = exports.STORNO_ZAHLUNG_FEHLER = exports.belegMailFehler = exports.BELEG_MAIL_FEHLER = exports.meldungGiltFuer = exports.meldung = exports.FEHLERREGELN = exports.MELDUNGEN = exports.listMyTipRecipients = exports.getPrintJob = void 0;
 /**
  * Kachel-Kasse: Einstellungen, Artikelgruppen/Artikel fuer Kacheln,
  * Rabattverteilung. Die Aufrufe heissen 1:1 wie die Backend-Functions
@@ -77,3 +77,7 @@ Object.defineProperty(exports, "meldung", { enumerable: true, get: function () {
 Object.defineProperty(exports, "meldungGiltFuer", { enumerable: true, get: function () { return texte_js_1.meldungGiltFuer; } });
 Object.defineProperty(exports, "BELEG_MAIL_FEHLER", { enumerable: true, get: function () { return texte_js_1.BELEG_MAIL_FEHLER; } });
 Object.defineProperty(exports, "belegMailFehler", { enumerable: true, get: function () { return texte_js_1.belegMailFehler; } });
+Object.defineProperty(exports, "STORNO_ZAHLUNG_FEHLER", { enumerable: true, get: function () { return texte_js_1.STORNO_ZAHLUNG_FEHLER; } });
+Object.defineProperty(exports, "stornoZahlungFehler", { enumerable: true, get: function () { return texte_js_1.stornoZahlungFehler; } });
+Object.defineProperty(exports, "BESCHRIFTUNGEN", { enumerable: true, get: function () { return texte_js_1.BESCHRIFTUNGEN; } });
+Object.defineProperty(exports, "beschriftung", { enumerable: true, get: function () { return texte_js_1.beschriftung; } });

package/dist/cjs/kasse/settings.d.ts

@@ -156,6 +156,8 @@ export interface KasseSettingsBetrieb {
     rueckgeld: boolean;
     schnellbar: boolean;
     kassierenModus: KasseKassierenModus;
+    /** Getrennt zahlen: dritter Knopf neben Bar und Karte, ein Beleg mit mehreren Zahlungen. */
+    zahlGetrennt: boolean;
     /** Trinkgeld-Chips in Prozent (eine Nachkommastelle, max 5, eindeutig, Reihenfolge des Chefs). */
     tgChips: number[];
     /** Rabatt-Chips in Prozent — dieselben Regeln wie tgChips, vom Chef einstellbar. */
@@ -168,10 +170,10 @@ export interface KasseSettingsBetrieb {
     hinweise: boolean;
 }
 /** Aktionen der Kasse, die eine Taste bekommen koennen. */
-export declare const KASSE_TASTEN_AKTIONEN: readonly ["kassieren", "abschliessen", "abbrechen", "frei", "bar", "karte", "passend", "belege", "letzteZurueck", "einstellungen", "abmelden", "trinkgeld", "vollbild", "gegebenLeeren", "korbLeeren"];
+export declare const KASSE_TASTEN_AKTIONEN: readonly ["kassieren", "abschliessen", "abbrechen", "frei", "bar", "karte", "passend", "belege", "letzteZurueck", "einstellungen", "abmelden", "trinkgeld", "vollbild", "gegebenLeeren", "korbLeeren", "getrennt"];
 export type KasseTastenAktion = typeof KASSE_TASTEN_AKTIONEN[number];
 /** Kurzer Name, damit alle Enum-Listen gleich heissen; der alte bleibt gueltig. */
-export declare const TASTEN_AKTIONEN: readonly ["kassieren", "abschliessen", "abbrechen", "frei", "bar", "karte", "passend", "belege", "letzteZurueck", "einstellungen", "abmelden", "trinkgeld", "vollbild", "gegebenLeeren", "korbLeeren"];
+export declare const TASTEN_AKTIONEN: readonly ["kassieren", "abschliessen", "abbrechen", "frei", "bar", "karte", "passend", "belege", "letzteZurueck", "einstellungen", "abmelden", "trinkgeld", "vollbild", "gegebenLeeren", "korbLeeren", "getrennt"];
 /** Tastenkarte: Aktion -> Tasten (`Mod+F`, `Enter`, `Escape`, `F5` ...; `Mod` = ⌘ auf dem Mac, Strg sonst). */
 export type KasseTastenkarte = Record<KasseTastenAktion, string[]>;
 export declare const KASSE_TASTEN_STANDARD: Readonly<KasseTastenkarte>;

package/dist/cjs/kasse/settings.js

@@ -92,7 +92,7 @@ exports.WZ_SKALA = ['S', 'M', 'L', 'XL'];
 /** Wie lange die Fertig-Seite stehen bleibt, in Sekunden; 0 = bis zum Tippen. */
 exports.FERTIG_SEKUNDEN = [0, 3, 5, 10, 15, 30, 60];
 /** Aktionen der Kasse, die eine Taste bekommen koennen. */
-exports.KASSE_TASTEN_AKTIONEN = ['kassieren', 'abschliessen', 'abbrechen', 'frei', 'bar', 'karte', 'passend', 'belege', 'letzteZurueck', 'einstellungen', 'abmelden', 'trinkgeld', 'vollbild', 'gegebenLeeren', 'korbLeeren'];
+exports.KASSE_TASTEN_AKTIONEN = ['kassieren', 'abschliessen', 'abbrechen', 'frei', 'bar', 'karte', 'passend', 'belege', 'letzteZurueck', 'einstellungen', 'abmelden', 'trinkgeld', 'vollbild', 'gegebenLeeren', 'korbLeeren', 'getrennt'];
 /** Kurzer Name, damit alle Enum-Listen gleich heissen; der alte bleibt gueltig. */
 exports.TASTEN_AKTIONEN = exports.KASSE_TASTEN_AKTIONEN;
 exports.KASSE_TASTEN_STANDARD = Object.freeze({
@@ -114,6 +114,9 @@ exports.KASSE_TASTEN_STANDARD = Object.freeze({
     // verschiedenen Momenten (Korb vor dem Kassieren, Gegeben-Feld darin) —
     // der Verteiler laesst die nicht zustaendige Aktion durchfallen.
     korbLeeren: ['Mod+C'],
+    // Bewusst ohne Vorgabe: jede freie Mod-Taste ist in irgendeinem Browser
+    // belegt oder am Geraet unerprobt. Der Chef vergibt sie, wenn er sie braucht.
+    getrennt: [],
 });
 exports.KASSE_BETRIEB_STANDARD = Object.freeze({
     // Das Petrol der Marke: die Aktionsfarbe des Design-Systems (Rolle `brand`).
@@ -128,7 +131,7 @@ exports.KASSE_BETRIEB_STANDARD = Object.freeze({
     menge: 'x', notiz: false, suche: false, rabatt: 'aus',
     zahlBar: true, zahlKarte: false, kartenanbieter: 'keiner', trinkgeld: false, tgModus: 'beides',
     tgStufen: { 5: true, 10: true, 15: false, 20: false }, tgChips: [5, 10], tgSplit: true, rueckgeld: true,
-    schnellbar: false, kassierenModus: 'seite',
+    schnellbar: false, kassierenModus: 'panel', zahlGetrennt: false,
     // 'fragen' = Fertig-Seite bietet QR und Bon an — sicherster Standard.
     logoBild: '', wzSeite: 'mitte', wzPos: 50, wzPosV: 50, wzStaerke: 6, logoSkala: 'M', wzSkala: 'M',
     glas: true, hinweise: true,