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

package/CHANGELOG.md

@@ -126,6 +126,42 @@ an upgrade as long as `/v1` is served.
   Reason: an app that read `'rejected'` could charge or refund a card twice;
   a silent resend below the package does the same without any error. Same
   change as in the Dart twin `kasseneck_api` (no `RetryClient`).
+- **Findings of the Dart twin (1.0.0-rc.3).** `listMyCashregisters` reads
+  the start receipt under `onboarding.start_receipt_created`/`_transmitted`
+  (`_at`) as `/v3` sends it; rc.1 and rc.2 read the internal
+  `startbeleg_*` names and reported every register as having no start
+  receipt (`CashregisterOnboardingPayload` changes accordingly). The fields
+  of `CashregisterOnboarding` are English now as well: `startbelegCreated`
+  is `startReceiptCreated`, `startbelegTransmitted` is
+  `startReceiptTransmitted`, `startbelegCreatedAt` is `startReceiptCreatedAt`,
+  `startbelegTransmittedAt` is `startReceiptTransmittedAt`; the German-name
+  guard no longer exempts `startbeleg`.
+  `sendReceiptEmail` reads its success reply leniently: without `to` it
+  returns the address you sent, without `at` it returns `at: null`
+  (`SendReceiptEmailResult.at` is `string | null`); throwing there would
+  invite a second email. `listMyPrinters` without `data.printers` and
+  `createPrintJob`/`getPrintJob` without `data.jobId` throw a
+  `KasseneckValidationError` (`scope: 'response'`) instead of returning an
+  empty list or an empty id: "no printer yet" must not look like a broken
+  reply, and a job without an id cannot be polled, so the cashier would print
+  again. `setMyRegisterDeviceSettings` takes `shortcuts` only as the whole map
+  of known actions (as `posSettingsChanges` produces it): the server checks
+  keys bound twice only within the map it receives.
+- **Money calls: an error envelope is not a rejection (1.0.0-rc.4).** On
+  `hobexPayApi`, `hobexRefundApi` and `stripeCaptureIntent` an error envelope
+  without a code is `outcome: 'unknown'`, and so is every code outside the
+  23 rejection codes, all raised before the provider is called: the
+  sign-in codes (`errorCodes.auth` without the seven of the partner
+  access), the edge codes `validation`, `not_found` and
+  `internal_translation_error`, the gates `module_inactive` and
+  `not_permitted`, and `route_missing`. `dialect_mismatch` and `response_translation_failed` (also
+  with `handled: false`) stay `'unknown'` there. rc.2 and rc.3 read an
+  envelope without a code as `'rejected'`, and the README called a retry
+  after `'rejected'` safe. Reason: the Hobex and Stripe handlers also answer
+  with a plain error message after the provider was called ("Error hobex
+  details", "Fehler beim Capturing"), so the card may be charged, the refund
+  paid or the payment captured. Same list as in the Dart twin
+  `kasseneck_api`.
 - **Strict validation before sending.** The 0.x payment fields
   (`paymentMethod`, `paymentMethodFromServer`, `creditCardProvider`,
   `cardPaymentId`, `cardPaymentData`) throw, also from plain JavaScript.
@@ -252,7 +288,7 @@ texts are English: `storno.ergebnis_unklar` is `cancellation.outcome_unknown`,
 `tax.intra_community_supply.title`. Every part is lower case with underscores,
 only country codes stay upper case (`country.AT`). Placeholders are English
 too: `{betrag}` is `{amount}`, `{grund}` is `{reason}`, `{sekunden}` is
-`{seconds}`, `{uid}` is `{vatId}`, and so on for 23 of 30 names; pass the
+`{seconds}`, `{uid}` is `{vatId}`, and so on for 25 of 30 names; pass the
 values under the new names (`messageText('checkout.locked', { reason })`). An
 old name throws as a missing value. `ERROR_RULES` entries use
 `kind`/`behavior`/`key` with the kinds `api`, `plain_text`, `timeout`,

package/README.md

@@ -427,10 +427,9 @@ silently. For a layout option of 0.x the message names its English successor.
 ### `outcome: 'unknown'`: never retry, look it up
 
 `KasseneckApiError`, `KasseneckHttpError` and `KasseneckNetworkError` carry
-`outcome`. `'rejected'` means no operation with an effect is left open: no
-receipt was signed, nothing went to FinanzOnline and no money moved, so
-retrying the same request does not create a second receipt or charge (whether
-it helps depends on the code). `'unknown'` means the operation **may have been carried out**, for
+`outcome`. `'rejected'` means the server turned the request down; whether
+anything else is safe to do depends on the code, and on the money calls it
+is only set for the codes listed below. `'unknown'` means the operation **may have been carried out**, for
 `createReceipt` a signed receipt in the chain. Then never send it again: read
 the result back (`getReceipt`, `listMyReceipts`, the original of a
 cancellation) and continue from there. `isOutcomeUnknown(error)` covers all
@@ -448,13 +447,39 @@ three classes. The outcome is unknown for:
   5xx, and HTTP 200 with the `Kasseneck-Api-Version: v3` marker but an empty,
   non-JSON (also `text/html`) or status-less body (`KasseneckHttpError`,
   `reason` `empty-body`, `not-json` or `missing-status`). HTML without the
-  marker stays `route_missing` with `'rejected'`: no function saw the call.
+  marker stays `route_missing` with `'rejected'`: no function saw the call;
+- on the money calls: every error envelope **without a code**, and every
+  code that is not one of the rejection codes below. The Hobex and Stripe
+  handlers also answer with a plain error message after the provider was
+  called, so an envelope alone does not prove that nothing happened.
+
+On the money calls (`hobexPayApi`, `hobexRefundApi`, `stripeCaptureIntent`)
+`outcome` is `'rejected'` only for codes that are produced before the
+provider is called, taken from the `/v3` contract (`errorCodes`):
+
+- the sign-in codes (`errorCodes.auth` without the seven of the partner
+  access, which never applies to these calls), raised before the handler
+  goes on: `method_not_allowed`, `validation` (a required field is missing
+  or has the wrong type), `cashregister_token_missing`,
+  `cashregister_token_invalid`, `cashregister_not_found`,
+  `account_not_found`, `live_not_enabled`, `unauthorized`, `mfa_required`,
+  `user_verification_failed`, `admin_required`, `register_user_not_allowed`,
+  `register_user_no_business`, `register_user_not_found`, `user_disabled`,
+  `session_expired`, `cashregister_not_assigned`,
+  `session_other_cashregister`;
+- the edge codes that stop the call before the handler (`errorCodes.edge`):
+  `validation` (unknown fields), `not_found`, `internal_translation_error`;
+- the module and permission gates: `module_inactive`, `not_permitted`;
+- `route_missing` (set by the package: no function saw the call).
+
+`dialect_mismatch` and `response_translation_failed` (also with
+`handled: false`) stay `'unknown'` there: the handler may have run.
 
 On the money calls an unknown outcome means the card may have been charged,
 the refund may have gone through, the payment may have been captured. A
-rejection of `hobexRefund` throws a `KasseneckApiError` with its `code`; it
-never returns `false`, because a `false` on an unclear outcome invites a
-second refund.
+failed `hobexRefund` throws a `KasseneckApiError`; it never returns `false`,
+because a `false` on an unclear outcome invites a second refund. Even a
+`'rejected'` is no invitation to resend blindly: fix the cause first.
 
 **Never retry these six calls, and never put a retrying layer under the
 package.** A `fetch` passed in `options.fetch` (or a proxy or service worker in
@@ -615,10 +640,14 @@ const confirmation = await api.sendReceiptEmail({
   language: 'de',                        // optional; the backend currently only uses 'de'
 });
 confirmation.to;   // address as the backend logged it (trimmed, lower case)
-confirmation.at;   // time, ISO with Vienna offset
+confirmation.at;   // time, ISO with Vienna offset, or null
 confirmation.via;  // 'own' | 'platform' | 'platform_fallback' | null
 ```
 
+A success response means the email has gone out. If it lacks `to` or `at`,
+the call still succeeds: `to` falls back to the address you sent and `at` is
+`null`. Throwing there would invite sending the email a second time.
+
 The email contains a **link to the public receipt page**, not a PDF
 attachment: the receipt page uses the same line model as screen and printed
 receipt and offers a PDF there. The receipt itself stays untouched (BAO § 131,

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

@@ -110,6 +110,34 @@ export declare function fehlerDetails(daten: unknown, geheimnisse: readonly stri
  * das Ergebnis nachlesen.
  */
 export type ErrorOutcome = 'unknown' | 'rejected';
+/**
+ * Codes, die auf einem Geldweg `outcome: 'rejected'` ergeben; jeder andere
+ * Code und eine Huelle ohne Code sind dort `'unknown'`. Aufgenommen ist nur,
+ * was entsteht, bevor das Backend den Zahlungsanbieter anspricht (Vertrag
+ * v3, `errorCodes`; dieselbe Liste wie `paymentCallRejectedCodes` im
+ * Dart-Zwilling):
+ *
+ * - `errorCodes.auth` ohne die sieben des Partner-Zugangs (18 Codes):
+ *   Anmeldung und Pruefung in `checkRequest` laufen vor jeder Zeile des
+ *   Handlers; `validation` heisst dort Pflichtfeld fehlt oder falscher Typ.
+ *   Der Partner-Zugang trifft diese `api_key`-Aufrufe mit Kassen-Token nie.
+ * - aus `errorCodes.edge`: `not_found` (unbekannter Endpunkt, HTTP 404) und
+ *   `internal_translation_error` (die Anfrage liess sich nicht uebersetzen,
+ *   es wurde nichts ausgefuehrt); `validation` des Rands (unbekannte Felder,
+ *   Rumpf ohne Objekt) steht schon oben.
+ * - `module_inactive` und `not_permitted`: das Modul- bzw. Rechte-Tor steht
+ *   ebenfalls vor dem Anbieter.
+ * - `route_missing` (vergibt das Paket): HTML ohne `/v3`-Kennzeichen, keine
+ *   Function hat den Aufruf gesehen.
+ *
+ * Nicht darin: `dialect_mismatch` (das Paket vergibt ihn auch, wenn ein Rand
+ * ohne `/v3` geantwortet hat, dessen Handler gelaufen sein kann) und
+ * `response_translation_failed` (der Handler lief; auch `handled: false`
+ * heisst nur, dass seine Antwort ein Fehler war, und der kann hinter dem
+ * Anbieteraufruf entstanden sein). Der Sammelfang der Handler ("Error hobex
+ * details", "Fehler beim Capturing") antwortet ohne Code.
+ */
+export declare const PAYMENT_CALL_REJECTED_CODES: readonly string[];
 /**
  * Codes, die das Paket selbst vergibt, nicht der Server: `route_missing`
  * (HTML statt Backend, der Aufruf kam nie an) und `response_unreadable`
@@ -146,7 +174,10 @@ export declare class KasseneckApiError extends Error {
      * `cancellation_outcome_unknown`, `response_unreadable` (Erfolg gemeldet,
      * Antwort eines Aufrufs mit Wirkung aber unlesbar) und
      * `response_translation_failed` (ausser mit `details.handled === false`);
-     * sonst `'rejected'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
+     * sonst `'rejected'`. Auf den Geldwegen (`hobexPayApi`, `hobexRefundApi`,
+     * `stripeCaptureIntent`) umgekehrt: `'rejected'` nur mit einem Code aus
+     * [PAYMENT_CALL_REJECTED_CODES], ohne Code und mit jedem anderen Code
+     * `'unknown'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
      */
     readonly outcome: ErrorOutcome;
     constructor(functionName: string, serverMessage: string, details?: Record<string, unknown>, code?: string);

package/dist/cjs/client/errors.js

@@ -73,7 +73,7 @@
  * als die Zusage.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KasseneckValidationError = exports.KasseneckAuthError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckApiError = exports.CLIENT_ERROR_CODES = void 0;
+exports.KasseneckValidationError = exports.KasseneckAuthError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckApiError = exports.CLIENT_ERROR_CODES = exports.PAYMENT_CALL_REJECTED_CODES = void 0;
 exports.causeDigest = causeDigest;
 exports.fehlerDetails = fehlerDetails;
 exports.isOutcomeUnknown = isOutcomeUnknown;
@@ -227,7 +227,77 @@ const AUSGANG_UNKLAR_CODES = new Set([
     'cancellation_outcome_unknown',
     'response_unreadable',
 ]);
-function ausgangAusCode(code, details) {
+/**
+ * Aufrufe, die Geld bewegen: `hobexPayApi` belastet eine Karte,
+ * `hobexRefundApi` erstattet, `stripeCaptureIntent` zieht eine vorgemerkte
+ * Zahlung ein. Ihre Handler antworten auch NACH dem Anbieteraufruf mit einer
+ * Fehlerhuelle ohne Code ("Error hobex details", "Fehler beim Capturing");
+ * dort gilt darum umgekehrt: Ausgang unklar, ausser der Code belegt, dass der
+ * Anbieter nie gerufen wurde.
+ */
+const GELDWEGE = new Set(['hobexPayApi', 'hobexRefundApi', 'stripeCaptureIntent']);
+/**
+ * Codes, die auf einem Geldweg `outcome: 'rejected'` ergeben; jeder andere
+ * Code und eine Huelle ohne Code sind dort `'unknown'`. Aufgenommen ist nur,
+ * was entsteht, bevor das Backend den Zahlungsanbieter anspricht (Vertrag
+ * v3, `errorCodes`; dieselbe Liste wie `paymentCallRejectedCodes` im
+ * Dart-Zwilling):
+ *
+ * - `errorCodes.auth` ohne die sieben des Partner-Zugangs (18 Codes):
+ *   Anmeldung und Pruefung in `checkRequest` laufen vor jeder Zeile des
+ *   Handlers; `validation` heisst dort Pflichtfeld fehlt oder falscher Typ.
+ *   Der Partner-Zugang trifft diese `api_key`-Aufrufe mit Kassen-Token nie.
+ * - aus `errorCodes.edge`: `not_found` (unbekannter Endpunkt, HTTP 404) und
+ *   `internal_translation_error` (die Anfrage liess sich nicht uebersetzen,
+ *   es wurde nichts ausgefuehrt); `validation` des Rands (unbekannte Felder,
+ *   Rumpf ohne Objekt) steht schon oben.
+ * - `module_inactive` und `not_permitted`: das Modul- bzw. Rechte-Tor steht
+ *   ebenfalls vor dem Anbieter.
+ * - `route_missing` (vergibt das Paket): HTML ohne `/v3`-Kennzeichen, keine
+ *   Function hat den Aufruf gesehen.
+ *
+ * Nicht darin: `dialect_mismatch` (das Paket vergibt ihn auch, wenn ein Rand
+ * ohne `/v3` geantwortet hat, dessen Handler gelaufen sein kann) und
+ * `response_translation_failed` (der Handler lief; auch `handled: false`
+ * heisst nur, dass seine Antwort ein Fehler war, und der kann hinter dem
+ * Anbieteraufruf entstanden sein). Der Sammelfang der Handler ("Error hobex
+ * details", "Fehler beim Capturing") antwortet ohne Code.
+ */
+exports.PAYMENT_CALL_REJECTED_CODES = Object.freeze([
+    // errorCodes.auth ohne Partner-Zugang
+    'method_not_allowed',
+    'validation',
+    'cashregister_token_missing',
+    'cashregister_token_invalid',
+    'cashregister_not_found',
+    'account_not_found',
+    'live_not_enabled',
+    'unauthorized',
+    'mfa_required',
+    'user_verification_failed',
+    'admin_required',
+    'register_user_not_allowed',
+    'register_user_no_business',
+    'register_user_not_found',
+    'user_disabled',
+    'session_expired',
+    'cashregister_not_assigned',
+    'session_other_cashregister',
+    // errorCodes.edge vor dem Handler (validation steht oben)
+    'not_found',
+    'internal_translation_error',
+    // Modul- und Rechte-Tor
+    'module_inactive',
+    'not_permitted',
+    // vom Paket vergeben
+    'route_missing',
+]);
+const GELDWEG_ABGELEHNT = new Set(exports.PAYMENT_CALL_REJECTED_CODES);
+function ausgangAusCode(functionName, code, details) {
+    // `functionName` kann den Vorgang tragen (`financeWebService/<method>`).
+    if (GELDWEGE.has(functionName.split('/')[0])) {
+        return code !== undefined && GELDWEG_ABGELEHNT.has(code) ? 'rejected' : 'unknown';
+    }
     if (code === undefined)
         return 'rejected';
     if (AUSGANG_UNKLAR_CODES.has(code))
@@ -271,7 +341,10 @@ class KasseneckApiError extends Error {
      * `cancellation_outcome_unknown`, `response_unreadable` (Erfolg gemeldet,
      * Antwort eines Aufrufs mit Wirkung aber unlesbar) und
      * `response_translation_failed` (ausser mit `details.handled === false`);
-     * sonst `'rejected'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
+     * sonst `'rejected'`. Auf den Geldwegen (`hobexPayApi`, `hobexRefundApi`,
+     * `stripeCaptureIntent`) umgekehrt: `'rejected'` nur mit einem Code aus
+     * [PAYMENT_CALL_REJECTED_CODES], ohne Code und mit jedem anderen Code
+     * `'unknown'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
      */
     outcome;
     constructor(functionName, serverMessage, details = {}, code) {
@@ -283,7 +356,7 @@ class KasseneckApiError extends Error {
         // den Details. So bleibt die Klasse fuer beide Ablageorte dieselbe.
         const kandidat = code !== undefined ? code : details['code'];
         this.code = typeof kandidat === 'string' && BEZEICHNER.test(kandidat) ? kandidat : undefined;
-        this.outcome = ausgangAusCode(this.code, details);
+        this.outcome = ausgangAusCode(functionName, this.code, details);
     }
 }
 exports.KasseneckApiError = KasseneckApiError;

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

@@ -315,10 +315,17 @@ export interface SendReceiptEmailOptions {
 }
 /** Was der Versand bestaetigt (Backend: beleg-mail-endpoints.js). */
 export interface SendReceiptEmailResult {
-    /** Adresse in der Form, in der das Backend sie protokolliert hat (getrimmt, klein). */
+    /**
+     * Adresse in der Form, in der das Backend sie protokolliert hat (getrimmt,
+     * klein). Nennt die Antwort keine, die gesendete (getrimmte) Adresse.
+     */
     to: string;
-    /** Zeitpunkt des Versands, ISO mit Wiener Zonenoffset (`2026-09-11T14:05:00+02:00`). */
-    at: string;
+    /**
+     * Zeitpunkt des Versands, ISO mit Wiener Zonenoffset
+     * (`2026-09-11T14:05:00+02:00`). `null`, wenn die Antwort keinen nennt: der
+     * Versand ist trotzdem bestaetigt.
+     */
+    at: string | null;
     /**
      * Versandweg: `own` (Postfach des Betriebs), `platform` oder
      * `platform_fallback` ([RECEIPT_EMAIL_VIAS]). `null`, wenn die Antwort ihn

package/dist/cjs/client/receipts.js

@@ -395,14 +395,17 @@ async function sendReceiptEmail(transport, options) {
     if (options.language !== undefined && options.language !== '')
         params.language = options.language;
     const daten = await transport('sendReceiptEmail', params);
-    if (typeof daten?.to !== 'string' || daten.to === '') {
-        throw antwortfehler('sendReceiptEmail', 'Antwort nennt keine Empfaengeradresse (data.to fehlt)');
-    }
-    if (typeof daten.at !== 'string' || daten.at === '') {
-        throw antwortfehler('sendReceiptEmail', 'Antwort nennt keinen Zeitpunkt (data.at fehlt)');
-    }
-    const via = index_js_2.RECEIPT_EMAIL_VIAS.includes(daten.via) ? daten.via : null;
-    return { to: daten.to, at: daten.at, via };
+    // Nachsichtig gelesen (wie der Dart-Zwilling): eine Erfolgsantwort heisst,
+    // die Mail ist schon verschickt. Ein Fehler wegen eines fehlenden
+    // Antwortfelds luede zum zweiten Versand ein; also zurueck, was da ist.
+    const gemeldet = daten?.to;
+    const zeit = daten?.at;
+    const via = index_js_2.RECEIPT_EMAIL_VIAS.includes(daten?.via) ? daten.via : null;
+    return {
+        to: typeof gemeldet === 'string' && gemeldet.trim() !== '' ? gemeldet : to,
+        at: typeof zeit === 'string' && zeit !== '' ? zeit : null,
+        via,
+    };
 }
 /**
  * Prueft die Gutschein-Kombination eines Belegs und liefert den ersten

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

@@ -45,11 +45,11 @@ export interface Cashregister {
  */
 export interface CashregisterOnboarding {
     cashboxRegistered: boolean;
-    startbelegCreated: boolean;
-    startbelegTransmitted: boolean;
+    startReceiptCreated: boolean;
+    startReceiptTransmitted: boolean;
     cashboxRegisteredAt?: Date;
-    startbelegCreatedAt?: Date;
-    startbelegTransmittedAt?: Date;
+    startReceiptCreatedAt?: Date;
+    startReceiptTransmittedAt?: Date;
 }
 /** Nutzlast-Form, die dieses Paket liest — die Feldnamen von `listMyCashregisters`. */
 export interface CashregisterPayload {
@@ -61,13 +61,19 @@ export interface CashregisterPayload {
     token?: string | null;
     onboarding?: CashregisterOnboardingPayload | null;
 }
+/**
+ * `onboarding` am Draht `/v3` (fixtures/v3/antworten/kasse.json): der
+ * Startbeleg heisst dort `start_receipt_*`. Die inneren Namen
+ * `startbeleg_*` sendet nur `/v1`; wer sie hier laese, meldete jede Kasse
+ * als „Startbeleg fehlt“.
+ */
 export interface CashregisterOnboardingPayload {
     cashbox_registered?: boolean | null;
-    startbeleg_created?: boolean | null;
-    startbeleg_transmitted?: boolean | null;
+    start_receipt_created?: boolean | null;
+    start_receipt_transmitted?: boolean | null;
     cashbox_registered_at?: string | null;
-    startbeleg_created_at?: string | null;
-    startbeleg_transmitted_at?: string | null;
+    start_receipt_created_at?: string | null;
+    start_receipt_transmitted_at?: string | null;
 }
 /**
  * Liest eine Kasse aus der Antwort. `id` gewinnt aus der Nutzlast, faellt aber

package/dist/cjs/models/cashregister.js

@@ -18,11 +18,11 @@ function fromCashregisterPayload(payload, id) {
         ...(payload.signature_id ? { signatureId: payload.signature_id } : {}),
         onboarding: {
             cashboxRegistered: ob.cashbox_registered === true,
-            startbelegCreated: ob.startbeleg_created === true,
-            startbelegTransmitted: ob.startbeleg_transmitted === true,
+            startReceiptCreated: ob.start_receipt_created === true,
+            startReceiptTransmitted: ob.start_receipt_transmitted === true,
             ...zeitfeld('cashboxRegisteredAt', ob.cashbox_registered_at),
-            ...zeitfeld('startbelegCreatedAt', ob.startbeleg_created_at),
-            ...zeitfeld('startbelegTransmittedAt', ob.startbeleg_transmitted_at),
+            ...zeitfeld('startReceiptCreatedAt', ob.start_receipt_created_at),
+            ...zeitfeld('startReceiptTransmittedAt', ob.start_receipt_transmitted_at),
         },
     };
 }

package/dist/cjs/payments/hobex.d.ts

@@ -47,8 +47,9 @@ export interface HobexTransactionIdOptions {
  * nicht.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann die Karte belastet sein: den Stand ueber die
- * Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann die Karte belastet sein: den Stand
+ * ueber die Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
  */
 export declare function hobexPay(transport: InternerTransport, options: HobexPayOptions): Promise<HobexReceipt>;
 /**
@@ -62,8 +63,10 @@ export declare function hobexPay(transport: InternerTransport, options: HobexPay
  * Wahrheitswert waere hier also immer `true` — eine Luege ueber den
  * Informationsgehalt, an der ein Aufrufer ein `if` aufhaengt, das nie greift.
  * Misserfolg kommt als geworfener Fehler: eine Fehlerhuelle als
- * [KasseneckApiError] mit Code, Netz, Zeitlimit, HTTP 5xx und eine unlesbare
- * Erfolgsantwort mit `outcome: 'unknown'` (die Erstattung kann gelaufen sein).
+ * [KasseneckApiError], `'rejected'` nur mit einem der Ablehnungscodes
+ * (README `outcome`); ohne Code oder mit anderem Code, bei Netz,
+ * Zeitlimit, HTTP 5xx und unlesbarer Erfolgsantwort `outcome: 'unknown'`
+ * (die Erstattung kann gelaufen sein).
  * Ein `false` an dieser Stelle luede zum zweiten Versuch ein, also zur
  * doppelten Erstattung. **Nie wiederholen**, sondern den Stand nachlesen.
  *

package/dist/cjs/payments/hobex.js

@@ -43,8 +43,9 @@ const ENDPUNKT_REFUND = 'hobexRefundApi';
  * nicht.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann die Karte belastet sein: den Stand ueber die
- * Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann die Karte belastet sein: den Stand
+ * ueber die Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
  */
 async function hobexPay(transport, options) {
     const params = zahlungsNutzlast(ENDPUNKT_PAY, options);
@@ -69,8 +70,10 @@ async function hobexPay(transport, options) {
  * Wahrheitswert waere hier also immer `true` — eine Luege ueber den
  * Informationsgehalt, an der ein Aufrufer ein `if` aufhaengt, das nie greift.
  * Misserfolg kommt als geworfener Fehler: eine Fehlerhuelle als
- * [KasseneckApiError] mit Code, Netz, Zeitlimit, HTTP 5xx und eine unlesbare
- * Erfolgsantwort mit `outcome: 'unknown'` (die Erstattung kann gelaufen sein).
+ * [KasseneckApiError], `'rejected'` nur mit einem der Ablehnungscodes
+ * (README `outcome`); ohne Code oder mit anderem Code, bei Netz,
+ * Zeitlimit, HTTP 5xx und unlesbarer Erfolgsantwort `outcome: 'unknown'`
+ * (die Erstattung kann gelaufen sein).
  * Ein `false` an dieser Stelle luede zum zweiten Versuch ein, also zur
  * doppelten Erstattung. **Nie wiederholen**, sondern den Stand nachlesen.
  *

package/dist/cjs/payments/stripe.d.ts

@@ -59,6 +59,8 @@ export declare function createStripeLink(transport: InternerTransport, options:
  * Pflichtparameter.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann der Einzug gelaufen sein: den Stand nachlesen.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann der Einzug gelaufen sein: den Stand
+ * nachlesen.
  */
 export declare function stripeCaptureIntent(transport: InternerTransport, stripeSessionId: string): Promise<StripeCaptureResult>;

package/dist/cjs/payments/stripe.js

@@ -74,7 +74,9 @@ async function createStripeLink(transport, options) {
  * Pflichtparameter.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann der Einzug gelaufen sein: den Stand nachlesen.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann der Einzug gelaufen sein: den Stand
+ * nachlesen.
  */
 async function stripeCaptureIntent(transport, stripeSessionId) {
     if (typeof stripeSessionId !== 'string' || !stripeSessionId.trim()) {

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

@@ -11,7 +11,12 @@ export declare function posSettingsFromWire(data: {
 } | null | undefined): PosSettings;
 /** Betriebsweite Einstellungen schreiben (Recht `layout`); liefert den gemischten Stand. */
 export declare function setMyPosSettings(transport: InternerTransport, business: Partial<PosBusinessSettings>): Promise<PosBusinessSettings>;
-/** Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten Stand. */
+/**
+ * Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten
+ * Stand. `shortcuts` nur als ganze Karte aller bekannten Aktionen
+ * ([posSettingsChanges] liefert sie bei jeder Tastenaenderung), sonst wirft
+ * der Aufruf vor dem Senden.
+ */
 export declare function setMyRegisterDeviceSettings(transport: InternerTransport, deviceId: string, device: Partial<PosDeviceSettings>): Promise<PosDeviceSettings>;
 /** Eingabe von [setMyPosLogo]: ein Bild als Data-URL (PNG, JPEG, SVG) oder das Entfernen. */
 export type SetMyPosLogoOptions = {

package/dist/cjs/pos/client.js

@@ -57,7 +57,12 @@ async function setMyPosSettings(transport, business) {
     const daten = await transport(name, { business });
     return (0, settings_js_1.mergePosSettings)(settings_js_1.POS_BUSINESS_DEFAULTS, objekt(daten?.business));
 }
-/** Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten Stand. */
+/**
+ * Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten
+ * Stand. `shortcuts` nur als ganze Karte aller bekannten Aktionen
+ * ([posSettingsChanges] liefert sie bei jeder Tastenaenderung), sonst wirft
+ * der Aufruf vor dem Senden.
+ */
 async function setMyRegisterDeviceSettings(transport, deviceId, device) {
     const name = 'setMyRegisterDeviceSettings';
     if (typeof deviceId !== 'string' || deviceId.trim() === '') {
@@ -77,8 +82,15 @@ async function setMyRegisterDeviceSettings(transport, deviceId, device) {
                 throw new errors_js_1.KasseneckValidationError(name, `device.shortcuts.${aktion}: unbekannte Aktion`, 'request');
             }
         }
-        // Doppelbelegung innerhalb der gesendeten Karte; posSettingsChanges sendet
-        // bei jeder Tastenaenderung die ganze Karte, so ist das die ganze Belegung.
+        // Nur die ganze Karte: der Server prueft Doppelbelegungen nur in der
+        // gesendeten Karte, eine halbe (`{cash: ['Mod+K']}`) liesse eine
+        // Doppelbelegung mit einer gespeicherten Taste durch. posSettingsChanges
+        // liefert bei jeder Tastenaenderung die ganze Karte.
+        const fehlt = settings_js_1.POS_SHORTCUT_ACTIONS.filter((a) => karte[a] === undefined);
+        if (fehlt.length > 0) {
+            throw new errors_js_1.KasseneckValidationError(name, `device.shortcuts: ganze Karte senden (posSettingsChanges), es fehlen ${fehlt.join(', ')}`, 'request');
+        }
+        // Doppelbelegung in der ganzen Karte, also in der ganzen Belegung.
         const konflikt = (0, settings_js_1.posShortcutConflict)(karte);
         if (konflikt) {
             throw new errors_js_1.KasseneckValidationError(name, `device.shortcuts.${konflikt.action}: Taste ${konflikt.key} schon belegt (${konflikt.heldBy})`, 'request');

package/dist/cjs/pos/drucker.js

@@ -5,6 +5,7 @@ exports.isPrintJobFinished = isPrintJobFinished;
 exports.listMyPrinters = listMyPrinters;
 exports.createPrintJob = createPrintJob;
 exports.getPrintJob = getPrintJob;
+const errors_js_1 = require("../client/errors.js");
 const index_js_1 = require("../printing/index.js");
 /** Stand eines Druckjobs (Katalog `DRUCKJOB`). */
 exports.PRINT_JOB_STATUSES = ['pending', 'sent', 'printed', 'failed', 'expired'];
@@ -29,9 +30,27 @@ const STATUS = new Set(exports.PRINT_JOB_STATUSES);
 function status(v) {
     return typeof v === 'string' && STATUS.has(v) ? v : 'unknown';
 }
+/**
+ * Die Kennung eines Jobs aus der Antwort. Ohne sie kann niemand den Job
+ * abfragen; ein leerer Text waere ein angeblich angelegter Job, und der
+ * Kassier druckte ein zweites Mal.
+ */
+function jobKennung(name, d) {
+    const id = d?.jobId;
+    if (typeof id !== 'string' || id === '') {
+        throw new errors_js_1.KasseneckValidationError(name, 'Antwort enthaelt keine Kennung (data.jobId fehlt)', 'response');
+    }
+    return id;
+}
 async function listMyPrinters(transport) {
     const daten = await transport('listMyPrinters', {});
-    return (Array.isArray(daten?.printers) ? daten.printers : []).map((r) => {
+    const liste = daten?.printers;
+    if (!Array.isArray(liste)) {
+        // Keine Liste ist etwas anderes als eine leere Liste: „noch kein Drucker“
+        // darf nicht aussehen wie „Antwort kaputt“.
+        throw new errors_js_1.KasseneckValidationError('listMyPrinters', 'Antwort enthaelt keine Liste (data.printers fehlt)', 'response');
+    }
+    return liste.map((r) => {
         const d = (r ?? {});
         const e = d.lastResult && typeof d.lastResult === 'object' ? d.lastResult : null;
         return {
@@ -60,7 +79,7 @@ async function createPrintJob(transport, o) {
     if (o.brandMark === true)
         params.brand = true;
     const daten = await transport('createPrintJob', params);
-    return { jobId: String(daten?.jobId ?? ''), status: status(daten?.status), result: null };
+    return { jobId: jobKennung('createPrintJob', daten), status: status(daten?.status), result: null };
 }
 /**
  * Stand eines Druckjobs abfragen. Der Aufrufer fragt, bis [isPrintJobFinished]
@@ -71,7 +90,7 @@ async function getPrintJob(transport, o) {
     const d = await transport('getPrintJob', { printerId: o.printerId, jobId: o.jobId });
     const e = d?.result && typeof d.result === 'object' ? d.result : null;
     return {
-        jobId: String(d?.jobId ?? o.jobId), status: status(d?.status),
+        jobId: jobKennung('getPrintJob', d), status: status(d?.status),
         createdAt: zahl(d?.createdAt), sentAt: zahl(d?.sentAt),
         result: e ? { success: e.success === true, code: text(e.code), status: text(e.status), at: zahl(e.at) ?? undefined } : null,
     };

package/dist/cjs/version.d.ts

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export declare const PACKAGE_VERSION = "1.0.0-rc.2";
+export declare const PACKAGE_VERSION = "1.0.0-rc.4";

package/dist/cjs/version.js

@@ -7,4 +7,4 @@ exports.PACKAGE_VERSION = void 0;
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-exports.PACKAGE_VERSION = '1.0.0-rc.2';
+exports.PACKAGE_VERSION = '1.0.0-rc.4';

package/dist/esm/client/errors.d.ts

@@ -110,6 +110,34 @@ export declare function fehlerDetails(daten: unknown, geheimnisse: readonly stri
  * das Ergebnis nachlesen.
  */
 export type ErrorOutcome = 'unknown' | 'rejected';
+/**
+ * Codes, die auf einem Geldweg `outcome: 'rejected'` ergeben; jeder andere
+ * Code und eine Huelle ohne Code sind dort `'unknown'`. Aufgenommen ist nur,
+ * was entsteht, bevor das Backend den Zahlungsanbieter anspricht (Vertrag
+ * v3, `errorCodes`; dieselbe Liste wie `paymentCallRejectedCodes` im
+ * Dart-Zwilling):
+ *
+ * - `errorCodes.auth` ohne die sieben des Partner-Zugangs (18 Codes):
+ *   Anmeldung und Pruefung in `checkRequest` laufen vor jeder Zeile des
+ *   Handlers; `validation` heisst dort Pflichtfeld fehlt oder falscher Typ.
+ *   Der Partner-Zugang trifft diese `api_key`-Aufrufe mit Kassen-Token nie.
+ * - aus `errorCodes.edge`: `not_found` (unbekannter Endpunkt, HTTP 404) und
+ *   `internal_translation_error` (die Anfrage liess sich nicht uebersetzen,
+ *   es wurde nichts ausgefuehrt); `validation` des Rands (unbekannte Felder,
+ *   Rumpf ohne Objekt) steht schon oben.
+ * - `module_inactive` und `not_permitted`: das Modul- bzw. Rechte-Tor steht
+ *   ebenfalls vor dem Anbieter.
+ * - `route_missing` (vergibt das Paket): HTML ohne `/v3`-Kennzeichen, keine
+ *   Function hat den Aufruf gesehen.
+ *
+ * Nicht darin: `dialect_mismatch` (das Paket vergibt ihn auch, wenn ein Rand
+ * ohne `/v3` geantwortet hat, dessen Handler gelaufen sein kann) und
+ * `response_translation_failed` (der Handler lief; auch `handled: false`
+ * heisst nur, dass seine Antwort ein Fehler war, und der kann hinter dem
+ * Anbieteraufruf entstanden sein). Der Sammelfang der Handler ("Error hobex
+ * details", "Fehler beim Capturing") antwortet ohne Code.
+ */
+export declare const PAYMENT_CALL_REJECTED_CODES: readonly string[];
 /**
  * Codes, die das Paket selbst vergibt, nicht der Server: `route_missing`
  * (HTML statt Backend, der Aufruf kam nie an) und `response_unreadable`
@@ -146,7 +174,10 @@ export declare class KasseneckApiError extends Error {
      * `cancellation_outcome_unknown`, `response_unreadable` (Erfolg gemeldet,
      * Antwort eines Aufrufs mit Wirkung aber unlesbar) und
      * `response_translation_failed` (ausser mit `details.handled === false`);
-     * sonst `'rejected'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
+     * sonst `'rejected'`. Auf den Geldwegen (`hobexPayApi`, `hobexRefundApi`,
+     * `stripeCaptureIntent`) umgekehrt: `'rejected'` nur mit einem Code aus
+     * [PAYMENT_CALL_REJECTED_CODES], ohne Code und mit jedem anderen Code
+     * `'unknown'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
      */
     readonly outcome: ErrorOutcome;
     constructor(functionName: string, serverMessage: string, details?: Record<string, unknown>, code?: string);

package/dist/esm/client/errors.js

@@ -215,7 +215,77 @@ const AUSGANG_UNKLAR_CODES = new Set([
     'cancellation_outcome_unknown',
     'response_unreadable',
 ]);
-function ausgangAusCode(code, details) {
+/**
+ * Aufrufe, die Geld bewegen: `hobexPayApi` belastet eine Karte,
+ * `hobexRefundApi` erstattet, `stripeCaptureIntent` zieht eine vorgemerkte
+ * Zahlung ein. Ihre Handler antworten auch NACH dem Anbieteraufruf mit einer
+ * Fehlerhuelle ohne Code ("Error hobex details", "Fehler beim Capturing");
+ * dort gilt darum umgekehrt: Ausgang unklar, ausser der Code belegt, dass der
+ * Anbieter nie gerufen wurde.
+ */
+const GELDWEGE = new Set(['hobexPayApi', 'hobexRefundApi', 'stripeCaptureIntent']);
+/**
+ * Codes, die auf einem Geldweg `outcome: 'rejected'` ergeben; jeder andere
+ * Code und eine Huelle ohne Code sind dort `'unknown'`. Aufgenommen ist nur,
+ * was entsteht, bevor das Backend den Zahlungsanbieter anspricht (Vertrag
+ * v3, `errorCodes`; dieselbe Liste wie `paymentCallRejectedCodes` im
+ * Dart-Zwilling):
+ *
+ * - `errorCodes.auth` ohne die sieben des Partner-Zugangs (18 Codes):
+ *   Anmeldung und Pruefung in `checkRequest` laufen vor jeder Zeile des
+ *   Handlers; `validation` heisst dort Pflichtfeld fehlt oder falscher Typ.
+ *   Der Partner-Zugang trifft diese `api_key`-Aufrufe mit Kassen-Token nie.
+ * - aus `errorCodes.edge`: `not_found` (unbekannter Endpunkt, HTTP 404) und
+ *   `internal_translation_error` (die Anfrage liess sich nicht uebersetzen,
+ *   es wurde nichts ausgefuehrt); `validation` des Rands (unbekannte Felder,
+ *   Rumpf ohne Objekt) steht schon oben.
+ * - `module_inactive` und `not_permitted`: das Modul- bzw. Rechte-Tor steht
+ *   ebenfalls vor dem Anbieter.
+ * - `route_missing` (vergibt das Paket): HTML ohne `/v3`-Kennzeichen, keine
+ *   Function hat den Aufruf gesehen.
+ *
+ * Nicht darin: `dialect_mismatch` (das Paket vergibt ihn auch, wenn ein Rand
+ * ohne `/v3` geantwortet hat, dessen Handler gelaufen sein kann) und
+ * `response_translation_failed` (der Handler lief; auch `handled: false`
+ * heisst nur, dass seine Antwort ein Fehler war, und der kann hinter dem
+ * Anbieteraufruf entstanden sein). Der Sammelfang der Handler ("Error hobex
+ * details", "Fehler beim Capturing") antwortet ohne Code.
+ */
+export const PAYMENT_CALL_REJECTED_CODES = Object.freeze([
+    // errorCodes.auth ohne Partner-Zugang
+    'method_not_allowed',
+    'validation',
+    'cashregister_token_missing',
+    'cashregister_token_invalid',
+    'cashregister_not_found',
+    'account_not_found',
+    'live_not_enabled',
+    'unauthorized',
+    'mfa_required',
+    'user_verification_failed',
+    'admin_required',
+    'register_user_not_allowed',
+    'register_user_no_business',
+    'register_user_not_found',
+    'user_disabled',
+    'session_expired',
+    'cashregister_not_assigned',
+    'session_other_cashregister',
+    // errorCodes.edge vor dem Handler (validation steht oben)
+    'not_found',
+    'internal_translation_error',
+    // Modul- und Rechte-Tor
+    'module_inactive',
+    'not_permitted',
+    // vom Paket vergeben
+    'route_missing',
+]);
+const GELDWEG_ABGELEHNT = new Set(PAYMENT_CALL_REJECTED_CODES);
+function ausgangAusCode(functionName, code, details) {
+    // `functionName` kann den Vorgang tragen (`financeWebService/<method>`).
+    if (GELDWEGE.has(functionName.split('/')[0])) {
+        return code !== undefined && GELDWEG_ABGELEHNT.has(code) ? 'rejected' : 'unknown';
+    }
     if (code === undefined)
         return 'rejected';
     if (AUSGANG_UNKLAR_CODES.has(code))
@@ -259,7 +329,10 @@ export class KasseneckApiError extends Error {
      * `cancellation_outcome_unknown`, `response_unreadable` (Erfolg gemeldet,
      * Antwort eines Aufrufs mit Wirkung aber unlesbar) und
      * `response_translation_failed` (ausser mit `details.handled === false`);
-     * sonst `'rejected'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
+     * sonst `'rejected'`. Auf den Geldwegen (`hobexPayApi`, `hobexRefundApi`,
+     * `stripeCaptureIntent`) umgekehrt: `'rejected'` nur mit einem Code aus
+     * [PAYMENT_CALL_REJECTED_CODES], ohne Code und mit jedem anderen Code
+     * `'unknown'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
      */
     outcome;
     constructor(functionName, serverMessage, details = {}, code) {
@@ -271,7 +344,7 @@ export class KasseneckApiError extends Error {
         // den Details. So bleibt die Klasse fuer beide Ablageorte dieselbe.
         const kandidat = code !== undefined ? code : details['code'];
         this.code = typeof kandidat === 'string' && BEZEICHNER.test(kandidat) ? kandidat : undefined;
-        this.outcome = ausgangAusCode(this.code, details);
+        this.outcome = ausgangAusCode(functionName, this.code, details);
     }
 }
 const GRUND_TEXT = {

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

@@ -315,10 +315,17 @@ export interface SendReceiptEmailOptions {
 }
 /** Was der Versand bestaetigt (Backend: beleg-mail-endpoints.js). */
 export interface SendReceiptEmailResult {
-    /** Adresse in der Form, in der das Backend sie protokolliert hat (getrimmt, klein). */
+    /**
+     * Adresse in der Form, in der das Backend sie protokolliert hat (getrimmt,
+     * klein). Nennt die Antwort keine, die gesendete (getrimmte) Adresse.
+     */
     to: string;
-    /** Zeitpunkt des Versands, ISO mit Wiener Zonenoffset (`2026-09-11T14:05:00+02:00`). */
-    at: string;
+    /**
+     * Zeitpunkt des Versands, ISO mit Wiener Zonenoffset
+     * (`2026-09-11T14:05:00+02:00`). `null`, wenn die Antwort keinen nennt: der
+     * Versand ist trotzdem bestaetigt.
+     */
+    at: string | null;
     /**
      * Versandweg: `own` (Postfach des Betriebs), `platform` oder
      * `platform_fallback` ([RECEIPT_EMAIL_VIAS]). `null`, wenn die Antwort ihn

package/dist/esm/client/receipts.js

@@ -376,14 +376,17 @@ export async function sendReceiptEmail(transport, options) {
     if (options.language !== undefined && options.language !== '')
         params.language = options.language;
     const daten = await transport('sendReceiptEmail', params);
-    if (typeof daten?.to !== 'string' || daten.to === '') {
-        throw antwortfehler('sendReceiptEmail', 'Antwort nennt keine Empfaengeradresse (data.to fehlt)');
-    }
-    if (typeof daten.at !== 'string' || daten.at === '') {
-        throw antwortfehler('sendReceiptEmail', 'Antwort nennt keinen Zeitpunkt (data.at fehlt)');
-    }
-    const via = RECEIPT_EMAIL_VIAS.includes(daten.via) ? daten.via : null;
-    return { to: daten.to, at: daten.at, via };
+    // Nachsichtig gelesen (wie der Dart-Zwilling): eine Erfolgsantwort heisst,
+    // die Mail ist schon verschickt. Ein Fehler wegen eines fehlenden
+    // Antwortfelds luede zum zweiten Versand ein; also zurueck, was da ist.
+    const gemeldet = daten?.to;
+    const zeit = daten?.at;
+    const via = RECEIPT_EMAIL_VIAS.includes(daten?.via) ? daten.via : null;
+    return {
+        to: typeof gemeldet === 'string' && gemeldet.trim() !== '' ? gemeldet : to,
+        at: typeof zeit === 'string' && zeit !== '' ? zeit : null,
+        via,
+    };
 }
 /**
  * Prueft die Gutschein-Kombination eines Belegs und liefert den ersten

package/dist/esm/models/cashregister.d.ts

@@ -45,11 +45,11 @@ export interface Cashregister {
  */
 export interface CashregisterOnboarding {
     cashboxRegistered: boolean;
-    startbelegCreated: boolean;
-    startbelegTransmitted: boolean;
+    startReceiptCreated: boolean;
+    startReceiptTransmitted: boolean;
     cashboxRegisteredAt?: Date;
-    startbelegCreatedAt?: Date;
-    startbelegTransmittedAt?: Date;
+    startReceiptCreatedAt?: Date;
+    startReceiptTransmittedAt?: Date;
 }
 /** Nutzlast-Form, die dieses Paket liest — die Feldnamen von `listMyCashregisters`. */
 export interface CashregisterPayload {
@@ -61,13 +61,19 @@ export interface CashregisterPayload {
     token?: string | null;
     onboarding?: CashregisterOnboardingPayload | null;
 }
+/**
+ * `onboarding` am Draht `/v3` (fixtures/v3/antworten/kasse.json): der
+ * Startbeleg heisst dort `start_receipt_*`. Die inneren Namen
+ * `startbeleg_*` sendet nur `/v1`; wer sie hier laese, meldete jede Kasse
+ * als „Startbeleg fehlt“.
+ */
 export interface CashregisterOnboardingPayload {
     cashbox_registered?: boolean | null;
-    startbeleg_created?: boolean | null;
-    startbeleg_transmitted?: boolean | null;
+    start_receipt_created?: boolean | null;
+    start_receipt_transmitted?: boolean | null;
     cashbox_registered_at?: string | null;
-    startbeleg_created_at?: string | null;
-    startbeleg_transmitted_at?: string | null;
+    start_receipt_created_at?: string | null;
+    start_receipt_transmitted_at?: string | null;
 }
 /**
  * Liest eine Kasse aus der Antwort. `id` gewinnt aus der Nutzlast, faellt aber

package/dist/esm/models/cashregister.js

@@ -15,11 +15,11 @@ export function fromCashregisterPayload(payload, id) {
         ...(payload.signature_id ? { signatureId: payload.signature_id } : {}),
         onboarding: {
             cashboxRegistered: ob.cashbox_registered === true,
-            startbelegCreated: ob.startbeleg_created === true,
-            startbelegTransmitted: ob.startbeleg_transmitted === true,
+            startReceiptCreated: ob.start_receipt_created === true,
+            startReceiptTransmitted: ob.start_receipt_transmitted === true,
             ...zeitfeld('cashboxRegisteredAt', ob.cashbox_registered_at),
-            ...zeitfeld('startbelegCreatedAt', ob.startbeleg_created_at),
-            ...zeitfeld('startbelegTransmittedAt', ob.startbeleg_transmitted_at),
+            ...zeitfeld('startReceiptCreatedAt', ob.start_receipt_created_at),
+            ...zeitfeld('startReceiptTransmittedAt', ob.start_receipt_transmitted_at),
         },
     };
 }

package/dist/esm/payments/hobex.d.ts

@@ -47,8 +47,9 @@ export interface HobexTransactionIdOptions {
  * nicht.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann die Karte belastet sein: den Stand ueber die
- * Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann die Karte belastet sein: den Stand
+ * ueber die Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
  */
 export declare function hobexPay(transport: InternerTransport, options: HobexPayOptions): Promise<HobexReceipt>;
 /**
@@ -62,8 +63,10 @@ export declare function hobexPay(transport: InternerTransport, options: HobexPay
  * Wahrheitswert waere hier also immer `true` — eine Luege ueber den
  * Informationsgehalt, an der ein Aufrufer ein `if` aufhaengt, das nie greift.
  * Misserfolg kommt als geworfener Fehler: eine Fehlerhuelle als
- * [KasseneckApiError] mit Code, Netz, Zeitlimit, HTTP 5xx und eine unlesbare
- * Erfolgsantwort mit `outcome: 'unknown'` (die Erstattung kann gelaufen sein).
+ * [KasseneckApiError], `'rejected'` nur mit einem der Ablehnungscodes
+ * (README `outcome`); ohne Code oder mit anderem Code, bei Netz,
+ * Zeitlimit, HTTP 5xx und unlesbarer Erfolgsantwort `outcome: 'unknown'`
+ * (die Erstattung kann gelaufen sein).
  * Ein `false` an dieser Stelle luede zum zweiten Versuch ein, also zur
  * doppelten Erstattung. **Nie wiederholen**, sondern den Stand nachlesen.
  *

package/dist/esm/payments/hobex.js

@@ -38,8 +38,9 @@ const ENDPUNKT_REFUND = 'hobexRefundApi';
  * nicht.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann die Karte belastet sein: den Stand ueber die
- * Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann die Karte belastet sein: den Stand
+ * ueber die Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
  */
 export async function hobexPay(transport, options) {
     const params = zahlungsNutzlast(ENDPUNKT_PAY, options);
@@ -64,8 +65,10 @@ export async function hobexPay(transport, options) {
  * Wahrheitswert waere hier also immer `true` — eine Luege ueber den
  * Informationsgehalt, an der ein Aufrufer ein `if` aufhaengt, das nie greift.
  * Misserfolg kommt als geworfener Fehler: eine Fehlerhuelle als
- * [KasseneckApiError] mit Code, Netz, Zeitlimit, HTTP 5xx und eine unlesbare
- * Erfolgsantwort mit `outcome: 'unknown'` (die Erstattung kann gelaufen sein).
+ * [KasseneckApiError], `'rejected'` nur mit einem der Ablehnungscodes
+ * (README `outcome`); ohne Code oder mit anderem Code, bei Netz,
+ * Zeitlimit, HTTP 5xx und unlesbarer Erfolgsantwort `outcome: 'unknown'`
+ * (die Erstattung kann gelaufen sein).
  * Ein `false` an dieser Stelle luede zum zweiten Versuch ein, also zur
  * doppelten Erstattung. **Nie wiederholen**, sondern den Stand nachlesen.
  *

package/dist/esm/payments/stripe.d.ts

@@ -59,6 +59,8 @@ export declare function createStripeLink(transport: InternerTransport, options:
  * Pflichtparameter.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann der Einzug gelaufen sein: den Stand nachlesen.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann der Einzug gelaufen sein: den Stand
+ * nachlesen.
  */
 export declare function stripeCaptureIntent(transport: InternerTransport, stripeSessionId: string): Promise<StripeCaptureResult>;

package/dist/esm/payments/stripe.js

@@ -70,7 +70,9 @@ export async function createStripeLink(transport, options) {
  * Pflichtparameter.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann der Einzug gelaufen sein: den Stand nachlesen.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann der Einzug gelaufen sein: den Stand
+ * nachlesen.
  */
 export async function stripeCaptureIntent(transport, stripeSessionId) {
     if (typeof stripeSessionId !== 'string' || !stripeSessionId.trim()) {

package/dist/esm/pos/client.d.ts

@@ -11,7 +11,12 @@ export declare function posSettingsFromWire(data: {
 } | null | undefined): PosSettings;
 /** Betriebsweite Einstellungen schreiben (Recht `layout`); liefert den gemischten Stand. */
 export declare function setMyPosSettings(transport: InternerTransport, business: Partial<PosBusinessSettings>): Promise<PosBusinessSettings>;
-/** Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten Stand. */
+/**
+ * Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten
+ * Stand. `shortcuts` nur als ganze Karte aller bekannten Aktionen
+ * ([posSettingsChanges] liefert sie bei jeder Tastenaenderung), sonst wirft
+ * der Aufruf vor dem Senden.
+ */
 export declare function setMyRegisterDeviceSettings(transport: InternerTransport, deviceId: string, device: Partial<PosDeviceSettings>): Promise<PosDeviceSettings>;
 /** Eingabe von [setMyPosLogo]: ein Bild als Data-URL (PNG, JPEG, SVG) oder das Entfernen. */
 export type SetMyPosLogoOptions = {

package/dist/esm/pos/client.js

@@ -50,7 +50,12 @@ export async function setMyPosSettings(transport, business) {
     const daten = await transport(name, { business });
     return mergePosSettings(POS_BUSINESS_DEFAULTS, objekt(daten?.business));
 }
-/** Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten Stand. */
+/**
+ * Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten
+ * Stand. `shortcuts` nur als ganze Karte aller bekannten Aktionen
+ * ([posSettingsChanges] liefert sie bei jeder Tastenaenderung), sonst wirft
+ * der Aufruf vor dem Senden.
+ */
 export async function setMyRegisterDeviceSettings(transport, deviceId, device) {
     const name = 'setMyRegisterDeviceSettings';
     if (typeof deviceId !== 'string' || deviceId.trim() === '') {
@@ -70,8 +75,15 @@ export async function setMyRegisterDeviceSettings(transport, deviceId, device) {
                 throw new KasseneckValidationError(name, `device.shortcuts.${aktion}: unbekannte Aktion`, 'request');
             }
         }
-        // Doppelbelegung innerhalb der gesendeten Karte; posSettingsChanges sendet
-        // bei jeder Tastenaenderung die ganze Karte, so ist das die ganze Belegung.
+        // Nur die ganze Karte: der Server prueft Doppelbelegungen nur in der
+        // gesendeten Karte, eine halbe (`{cash: ['Mod+K']}`) liesse eine
+        // Doppelbelegung mit einer gespeicherten Taste durch. posSettingsChanges
+        // liefert bei jeder Tastenaenderung die ganze Karte.
+        const fehlt = POS_SHORTCUT_ACTIONS.filter((a) => karte[a] === undefined);
+        if (fehlt.length > 0) {
+            throw new KasseneckValidationError(name, `device.shortcuts: ganze Karte senden (posSettingsChanges), es fehlen ${fehlt.join(', ')}`, 'request');
+        }
+        // Doppelbelegung in der ganzen Karte, also in der ganzen Belegung.
         const konflikt = posShortcutConflict(karte);
         if (konflikt) {
             throw new KasseneckValidationError(name, `device.shortcuts.${konflikt.action}: Taste ${konflikt.key} schon belegt (${konflikt.heldBy})`, 'request');

package/dist/esm/pos/drucker.js

@@ -1,3 +1,4 @@
+import { KasseneckValidationError } from '../client/errors.js';
 import { rasterRowsBase64 } from '../printing/index.js';
 /** Stand eines Druckjobs (Katalog `DRUCKJOB`). */
 export const PRINT_JOB_STATUSES = ['pending', 'sent', 'printed', 'failed', 'expired'];
@@ -22,9 +23,27 @@ const STATUS = new Set(PRINT_JOB_STATUSES);
 function status(v) {
     return typeof v === 'string' && STATUS.has(v) ? v : 'unknown';
 }
+/**
+ * Die Kennung eines Jobs aus der Antwort. Ohne sie kann niemand den Job
+ * abfragen; ein leerer Text waere ein angeblich angelegter Job, und der
+ * Kassier druckte ein zweites Mal.
+ */
+function jobKennung(name, d) {
+    const id = d?.jobId;
+    if (typeof id !== 'string' || id === '') {
+        throw new KasseneckValidationError(name, 'Antwort enthaelt keine Kennung (data.jobId fehlt)', 'response');
+    }
+    return id;
+}
 export async function listMyPrinters(transport) {
     const daten = await transport('listMyPrinters', {});
-    return (Array.isArray(daten?.printers) ? daten.printers : []).map((r) => {
+    const liste = daten?.printers;
+    if (!Array.isArray(liste)) {
+        // Keine Liste ist etwas anderes als eine leere Liste: „noch kein Drucker“
+        // darf nicht aussehen wie „Antwort kaputt“.
+        throw new KasseneckValidationError('listMyPrinters', 'Antwort enthaelt keine Liste (data.printers fehlt)', 'response');
+    }
+    return liste.map((r) => {
         const d = (r ?? {});
         const e = d.lastResult && typeof d.lastResult === 'object' ? d.lastResult : null;
         return {
@@ -53,7 +72,7 @@ export async function createPrintJob(transport, o) {
     if (o.brandMark === true)
         params.brand = true;
     const daten = await transport('createPrintJob', params);
-    return { jobId: String(daten?.jobId ?? ''), status: status(daten?.status), result: null };
+    return { jobId: jobKennung('createPrintJob', daten), status: status(daten?.status), result: null };
 }
 /**
  * Stand eines Druckjobs abfragen. Der Aufrufer fragt, bis [isPrintJobFinished]
@@ -64,7 +83,7 @@ export async function getPrintJob(transport, o) {
     const d = await transport('getPrintJob', { printerId: o.printerId, jobId: o.jobId });
     const e = d?.result && typeof d.result === 'object' ? d.result : null;
     return {
-        jobId: String(d?.jobId ?? o.jobId), status: status(d?.status),
+        jobId: jobKennung('getPrintJob', d), status: status(d?.status),
         createdAt: zahl(d?.createdAt), sentAt: zahl(d?.sentAt),
         result: e ? { success: e.success === true, code: text(e.code), status: text(e.status), at: zahl(e.at) ?? undefined } : null,
     };

package/dist/esm/version.d.ts

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export declare const PACKAGE_VERSION = "1.0.0-rc.2";
+export declare const PACKAGE_VERSION = "1.0.0-rc.4";

package/dist/esm/version.js

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export const PACKAGE_VERSION = '1.0.0-rc.2';
+export const PACKAGE_VERSION = '1.0.0-rc.4';

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.4",
   "measuredOn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/invoice-api.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "Kasseneck Rechnungs-API",
   "version": 2,
-  "package": "1.0.0-rc.2",
+  "package": "1.0.0-rc.4",
   "endpoints": {
     "createCustomer": {
       "request": {

package/fixtures/invoice-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.4",
   "languages": [
     "de",
     "en"

package/fixtures/pos-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.4",
   "messages": {
     "network.no_connection": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."

package/fixtures/surface.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.4",
   "baseUrls": {
     "public": "https://api.kasseneck.at/v3",
     "pos": "https://kasse.kasseneck.at/api/v3"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.4",
   "description": "Austrian fiscal cash register (RKSV) client for JavaScript and TypeScript: signed receipts, cancellations, card payments, receipt printing (ESC/POS), invoices. RKSV-Registrierkasse für JavaScript und TypeScript.",
   "license": "Apache-2.0",
   "author": "Kreiseck",