@kreiseck/kasseneck-api 0.7.1 → 0.8.0

package/dist/esm/kasse/texte.js

@@ -0,0 +1,145 @@
+/**
+ * Was die Kasse selbst sagt — auf dem Bildschirm, in beiden Huellen.
+ *
+ * Die Browser-Kasse und die Kassen-App sind eine Kasse. Was der Kassier bei
+ * einem Fehler liest, steht hier genau einmal; beide Apps beziehen den Satz
+ * von hier, und wer ihn aendert, aendert ihn auf beiden Seiten oder gar nicht.
+ *
+ * Nicht hier: die fachlichen Saetze des Backends („Kopplungs-Code ist
+ * abgelaufen.", „PIN falsch, noch 2 Versuche"). Die gehen unveraendert durch.
+ *
+ * Ein Satz sagt, was los ist, und was zu tun ist. Nie Innereien.
+ *
+ * Schluessel: `bereich.name`. Ein Schluessel wird nie umgedeutet — wer den
+ * Sinn aendert, legt einen neuen an. `nur` nennt die Seite, wenn ein Satz nur
+ * auf einer Plattform vorkommen kann.
+ */
+const MELDUNGEN_ROH = {
+    // --- Transport -----------------------------------------------------------
+    'netz.keine_verbindung': { text: 'Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen.' },
+    'netz.zeitablauf': { text: 'Der Server antwortet nicht. Bitte die Internetverbindung prüfen und erneut versuchen.' },
+    'server.unerwartet': { text: 'Der Server hat unerwartet geantwortet (HTTP {status}). Bitte den Support verständigen.', platzhalter: ['status'] },
+    // --- Kopplung ------------------------------------------------------------
+    'kopplung.code_fehlt': { text: 'Bitte den Kopplungs-Code eingeben.' },
+    'kopplung.fehlgeschlagen': { text: 'Die Kopplung ist fehlgeschlagen. Bitte erneut versuchen.' },
+    'kopplung.unvollstaendig': { text: 'Die Kopplung ist unvollständig zurückgekommen. Bitte im Panel einen neuen Code erzeugen und noch einmal versuchen.' },
+    'geraet.browser_speicher': { text: 'Dieses Gerät konnte nicht gespeichert werden — der Browser-Speicher steht nicht zur Verfügung. Bitte den privaten Modus verlassen.', nur: ['web'] },
+    // --- Anmeldung und Sitzung -----------------------------------------------
+    'anmeldung.pin_fehlt': { text: 'Bitte die PIN eingeben.' },
+    'anmeldung.fehlgeschlagen': { text: 'Die Anmeldung ist fehlgeschlagen. Bitte erneut versuchen.' },
+    'anmeldung.nicht_abgeschlossen': { text: 'Die Anmeldung konnte nicht abgeschlossen werden. Bitte erneut versuchen.' },
+    'anmeldung.wird_abgeschlossen': { text: 'Anmeldung wird gerade abgeschlossen — bitte gleich noch einmal drücken.' },
+    'sitzung.abgelaufen': { text: 'Die Sitzung ist abgelaufen. Bitte erneut anmelden.' },
+    'sitzung.abgelaufen_ohne_netz': { text: 'Keine Verbindung zum Server — die Sitzung ist abgelaufen. Bitte erneut anmelden.' },
+    'sitzung.keine': { text: 'Keine Sitzung.' },
+    'rechte.nicht_aenderbar': { text: 'Das darfst du nicht ändern — das Recht dafür vergibt der Inhaber im Panel.' },
+    // --- Verkauf und Positionen ----------------------------------------------
+    'kasse.laden_fehlgeschlagen': { text: 'Die Kasse konnte nicht geladen werden.' },
+    'artikel.laden_fehlgeschlagen': { text: 'Die Artikel konnten nicht geladen werden.' },
+    'artikel.keine_freigegeben': { text: 'Keine Artikel an dieser Kasse. Im Panel unter „Kacheln & Gruppen“ freischalten.' },
+    'artikel.keine_gefunden': { text: 'Keine Artikel gefunden.' },
+    'artikel.steuersatz_unbekannt': { text: '„{name}“ hat einen Steuersatz, den die Kasse nicht kennt.', platzhalter: ['name'] },
+    'position.betrag_fehlt': { text: 'Bitte einen Betrag eingeben.' },
+    'position.bezeichnung_fehlt': { text: 'Bitte eine Bezeichnung eingeben — sie steht am Beleg.' },
+    'rabatt.prozent_ungueltig': { text: 'Bitte einen Prozentwert zwischen 0,1 und 100 eingeben.' },
+    // --- Abschluss -----------------------------------------------------------
+    'abschluss.fehlgeschlagen': { text: 'Der Abschluss ist fehlgeschlagen.' },
+    'abschluss.unklar': { text: 'Unklar, ob der Beleg entstanden ist — die Antwort kam nicht an. Bitte nicht noch einmal abschließen: der Beleg kann bereits erstellt und signiert sein. Im Panel unter „Belege“ nachsehen; nur wenn er dort fehlt, den Verkauf erneut abschließen.' },
+    'abschluss.nullbeleg_fehlgeschlagen': { text: 'Der Nullbeleg konnte nicht erstellt werden.' },
+    'abschluss.signatur_ausgefallen': { text: 'Die Signatureinheit hat nicht geantwortet. Der Beleg ist gültig und trägt den Vermerk „Sicherheitseinrichtung ausgefallen“.' },
+    // --- Kartenzahlung -------------------------------------------------------
+    'kartenzahlung.nicht_moeglich': { text: 'Kartenzahlung nicht möglich.' },
+    'kartenzahlung.nicht_zustande': { text: 'Die Kartenzahlung ist nicht zustande gekommen.' },
+    'kartenzahlung.nicht_gestartet': { text: 'Kartenzahlung nicht gestartet: {grund}', platzhalter: ['grund'] },
+    'kartenzahlung.unklar': { text: 'Unklar, ob die Kartenzahlung durchgegangen ist — die Verbindung zum Terminal riss ab. Bitte am Terminal-Beleg nachsehen, BEVOR neu kassiert wird: die Karte kann belastet sein.' },
+    // Die Kennung ist der einzige Anker, um die Zahlung am Terminal-Beleg wiederzufinden — liegt sie vor, gilt dieser Satz statt kartenzahlung.unklar.
+    'kartenzahlung.unklar_mit_kennung': { text: 'Unklar, ob die Kartenzahlung durchgegangen ist — die Verbindung zum Terminal riss ab. Bitte am Terminal-Beleg nachsehen, BEVOR neu kassiert wird: die Karte kann belastet sein. Kennung der Zahlung: {kennung}.', platzhalter: ['kennung'] },
+    'kartenzahlung.connect_nicht_verbunden': { text: 'Kartenzahlung nicht möglich: Kasseneck Connect ist nicht verbunden — Einstellungen → Kasseneck Connect.', nur: ['web'] },
+    'terminal.keines_gefunden': { text: 'Kein Hobex-Terminal gefunden — ist es eingeschaltet und im selben Netz wie dieser Rechner?', nur: ['web'] },
+    'terminal.nicht_bereit': { text: 'Terminal antwortet, ist aber nicht betriebsbereit: {antwort} — TID prüfen.', platzhalter: ['antwort'], nur: ['web'] },
+    'gptom.app_fehlt': { text: 'Die GP-Tom-App ist auf diesem Gerät nicht da.', nur: ['app'] },
+    'gptom.suche_fehlgeschlagen': { text: 'GP Tom: Suche nach der App fehlgeschlagen: {grund}', platzhalter: ['grund'], nur: ['app'] },
+    'gptom.zahlung_fehlgeschlagen': { text: 'GP Tom: Zahlung fehlgeschlagen: {grund}', platzhalter: ['grund'], nur: ['app'] },
+    'gptom.terminal_antwortet_nicht': { text: 'Das Terminal hat nicht geantwortet: {grund}', platzhalter: ['grund'], nur: ['app'] },
+    'gptom.zahlung_nicht_abgeschlossen': { text: 'Die Zahlung wurde nicht abgeschlossen ({code}).', platzhalter: ['code'], nur: ['app'] },
+    // --- Belege und Storno ---------------------------------------------------
+    'belege.laden_fehlgeschlagen': { text: 'Die Belege konnten nicht geladen werden.' },
+    'belege.keine_im_zeitraum': { text: 'Keine Belege in diesem Zeitraum.' },
+    'beleg.laden_fehlgeschlagen': { text: 'Der Beleg konnte nicht geladen werden.' },
+    'beleg.nicht_gefunden': { text: 'Der Beleg wurde nicht gefunden.' },
+    'storno.fehlgeschlagen': { text: 'Das Storno ist fehlgeschlagen.' },
+    'storno.grund_fehlt': { text: 'Bitte einen Grund wählen.' },
+    'storno.position_fehlt': { text: 'Bitte mindestens eine Position wählen.' },
+    // --- Druck ---------------------------------------------------------------
+    'druck.fehlgeschlagen': { text: 'Der Ausdruck ist fehlgeschlagen.' },
+    'druck.nicht_moeglich': { text: 'Druck nicht möglich: {grund}', platzhalter: ['grund'] },
+    'druck.testdruck_fehlgeschlagen': { text: 'Der Testdruck ist fehlgeschlagen.' },
+    'druck.testdruck_nicht_moeglich': { text: 'Der Testdruck ist fehlgeschlagen: {grund}', platzhalter: ['grund'] },
+    'druck.kein_drucker': { text: 'Kein Bondrucker eingerichtet — in den Einstellungen unter Drucker & Lade.' },
+    'druck.drucker_nicht_erreichbar': { text: 'Drucker nicht erreichbar.' },
+    'druck.job_abgelaufen': { text: 'Drucker hat den Beleg nicht abgeholt (abgelaufen).', nur: ['web'] },
+    'druck.kein_drucker_gefunden': { text: 'Kein Drucker gefunden — ist er eingeschaltet und im selben Netz wie dieser Rechner?', nur: ['web'] },
+    'druck.nur_chrome': { text: '{weg}-Druck geht nur in Chrome oder Edge (Windows, Mac, Android) — nicht in Safari und nicht am iPad.', platzhalter: ['weg'], nur: ['web'] },
+    'druck.kein_weg_drucker': { text: 'Kein {weg}-Drucker verbunden — „{weg}-Drucker verbinden“ und den Drucker im Dialog wählen.', platzhalter: ['weg'], nur: ['web'] },
+    'bluetooth.aus': { text: 'Bluetooth ist ausgeschaltet. Bitte einschalten und erneut suchen.', nur: ['app'] },
+    'bluetooth.freigabe_fehlt': { text: 'Bitte die Freigabe in den Geräte-Einstellungen erteilen.', nur: ['app'] },
+    'bluetooth.suche_fehlgeschlagen': { text: 'Die Suche ist fehlgeschlagen: {grund}', platzhalter: ['grund'], nur: ['app'] },
+    // --- Kasseneck Connect (nur Browser) -------------------------------------
+    'connect.antwortet_nicht': { text: 'Kasseneck Connect antwortet nicht — läuft das Programm auf diesem Rechner?', nur: ['web'] },
+    'connect.code_abgelaufen': { text: 'Der Kopplungs-Code ist abgelaufen — im Agent einen neuen erzeugen („kasseneck-connect pair“).', nur: ['web'] },
+    'connect.zu_viele_versuche': { text: 'Zu viele Fehlversuche — eine Minute warten und noch einmal versuchen.', nur: ['web'] },
+    'connect.drucker_antwortet_nicht': { text: 'Der Drucker antwortet nicht — Strom, Netzwerk und IP prüfen.', nur: ['web'] },
+    'connect.nicht_gekoppelt': { text: 'Diese Kasse ist mit Kasseneck Connect nicht gekoppelt — in den Einstellungen „Koppeln“ drücken.', nur: ['web'] },
+    'connect.drucker_unbekannt': { text: 'Diesen Drucker kennt Kasseneck Connect nicht (mehr) — bitte neu suchen.', nur: ['web'] },
+    'connect.ursprung_nicht_freigegeben': { text: 'Kasseneck Connect nimmt von dieser Adresse nichts an (Ursprung nicht freigegeben).', nur: ['web'] },
+    'connect.nicht_installiert': { text: 'Kasseneck Connect nicht gefunden — bitte installieren.', nur: ['web'] },
+    // --- Einstellungen -------------------------------------------------------
+    'einstellungen.laden_fehlgeschlagen': { text: 'Die Einstellungen konnten nicht geladen werden.' },
+    'einstellungen.speichern_fehlgeschlagen': { text: 'Die Einstellung konnte nicht gespeichert werden.' },
+    'einstellungen.noch_nicht_geladen': { text: 'Noch nicht geladen — bitte kurz warten oder neu anmelden.' },
+    'einstellungen.ip_ungueltig': { text: 'Keine gültige IP-Adresse (z. B. 192.168.1.50).' },
+    'entkopplung.fehlgeschlagen': { text: 'Entkoppeln fehlgeschlagen.' },
+    'logo.hochladen_fehlgeschlagen': { text: 'Hochladen fehlgeschlagen.' },
+    'logo.entfernen_fehlgeschlagen': { text: 'Entfernen fehlgeschlagen.' },
+    // --- Nur App -------------------------------------------------------------
+    'app.nicht_im_browser': { text: 'Die Kassen-App läuft nicht im Browser — dafür gibt es kasse.kasseneck.at.', nur: ['app'] },
+    'app.im_browser_oeffnen': { text: 'Bitte im Browser öffnen: {ziel}', platzhalter: ['ziel'], nur: ['app'] },
+};
+// Auf den gemeinsamen Typ gebracht: `Object.entries(MELDUNGEN)` liefert sonst
+// pro Schluessel den engsten Literaltyp, und `platzhalter`/`nur` waeren nur
+// auf manchen Zweigen der Vereinigung vorhanden.
+export const MELDUNGEN = MELDUNGEN_ROH;
+/**
+ * In welcher Reihenfolge ein Fehler eingeordnet wird — auf beiden Seiten
+ * dieselbe. Die Arten:
+ *   api        — HTTP 200, `status:'error'`: der Satz des Backends, woertlich
+ *   klartext   — schon fuer den Bildschirm geschrieben: sein eigener Text
+ *   zeitablauf — die Frist lief ab, die Anfrage war draussen
+ *   netz       — keine Verbindung zustande gekommen oder abgerissen
+ *   unerwartet — der Server hat geantwortet, aber nicht wie zugesagt
+ *                (HTML statt JSON, 500, fehlende Huelle); `status` = HTTP-Code
+ *   sonst      — alles Uebrige ist technisch: der Ersatzsatz des Vorgangs
+ */
+export const FEHLERREGELN = [
+    { art: 'api', verhalten: 'server_text' },
+    { art: 'klartext', verhalten: 'eigener_text' },
+    { art: 'zeitablauf', schluessel: 'netz.zeitablauf' },
+    { art: 'netz', schluessel: 'netz.keine_verbindung' },
+    { art: 'unerwartet', schluessel: 'server.unerwartet' },
+    { art: 'sonst', verhalten: 'ersatz' },
+];
+/** Der Satz zum Schluessel, Platzhalter ersetzt. Fehlt ein Wert, wirft es — ein `{status}` am Tresen waere schlimmer. */
+export function meldung(schluessel, werte = {}) {
+    const eintrag = MELDUNGEN[schluessel];
+    return eintrag.text.replace(/\{([a-z]+)\}/g, (_, name) => {
+        const wert = werte[name];
+        if (wert === undefined)
+            throw new Error(`meldung(${schluessel}): Platzhalter {${name}} ohne Wert`);
+        return String(wert);
+    });
+}
+/** Gilt der Satz auf dieser Seite? */
+export function meldungGiltFuer(schluessel, seite) {
+    const eintrag = MELDUNGEN[schluessel];
+    return eintrag.nur === undefined || eintrag.nur.includes(seite);
+}

package/dist/esm/payments/hobex-hps/index.d.ts

@@ -23,5 +23,5 @@ export { type HpsPaymentEvent, type HpsPaymentEventKind, type HpsPaymentObserver
 export { type CardPaymentOutcome, type HpsPaymentResult, mayRetrySafely, } from './outcome.js';
 export { type HpsCancelOptions, type HpsPaymentOptions, type HpsPayments, type HpsPaymentsOptions, type HpsRefundOptions, createHpsPayments, } from './payments.js';
 export { MAX_TRANSACTION_ID_LENGTH, createHpsTransactionIdGenerator, isValidHpsTransactionId, newHpsTransactionId, type HpsTransactionIdGeneratorOptions, } from './transaction-id.js';
-export { ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, HPS_MEASURED_CODES, INVALID_TRANSACTION_CODE, NOT_ABORTABLE_CODE, INVALID_AMOUNT_CODE, AMOUNT_OUT_OF_RANGE_CODE, INVALID_TID_CODE, NO_STATEMENT_CODE, TECHNICAL_ERROR_CODE, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, isApproved, isCanceled, isConclusive, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, parseHpsTransactionResponse, type HpsMeasuredCode, type HpsTransactionResponse, } from './transaction-response.js';
+export { ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, HPS_MEASURED_CODES, INVALID_TRANSACTION_CODE, NOT_ABORTABLE_CODE, INVALID_AMOUNT_CODE, AMOUNT_OUT_OF_RANGE_CODE, INVALID_TID_CODE, WRONG_PIN_CODE, NO_STATEMENT_CODE, TECHNICAL_ERROR_CODE, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, isApproved, isCanceled, isConclusive, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, parseHpsTransactionResponse, type HpsMeasuredCode, type HpsTransactionResponse, } from './transaction-response.js';
 export { hobexReceiptFromHps } from './receipt.js';

package/dist/esm/payments/hobex-hps/index.js

@@ -22,5 +22,5 @@ export { HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, H
 export { mayRetrySafely, } from './outcome.js';
 export { createHpsPayments, } from './payments.js';
 export { MAX_TRANSACTION_ID_LENGTH, createHpsTransactionIdGenerator, isValidHpsTransactionId, newHpsTransactionId, } from './transaction-id.js';
-export { ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, HPS_MEASURED_CODES, INVALID_TRANSACTION_CODE, NOT_ABORTABLE_CODE, INVALID_AMOUNT_CODE, AMOUNT_OUT_OF_RANGE_CODE, INVALID_TID_CODE, NO_STATEMENT_CODE, TECHNICAL_ERROR_CODE, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, isApproved, isCanceled, isConclusive, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, parseHpsTransactionResponse, } from './transaction-response.js';
+export { ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, HPS_MEASURED_CODES, INVALID_TRANSACTION_CODE, NOT_ABORTABLE_CODE, INVALID_AMOUNT_CODE, AMOUNT_OUT_OF_RANGE_CODE, INVALID_TID_CODE, WRONG_PIN_CODE, NO_STATEMENT_CODE, TECHNICAL_ERROR_CODE, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, isApproved, isCanceled, isConclusive, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, parseHpsTransactionResponse, } from './transaction-response.js';
 export { hobexReceiptFromHps } from './receipt.js';

package/dist/esm/payments/hobex-hps/outcome.d.ts

@@ -18,8 +18,23 @@ export type CardPaymentOutcome = 'approved' | 'declined' | 'unresolved';
 export interface HpsPaymentResult {
     readonly outcome: CardPaymentOutcome;
     readonly transactionId: string;
-    /** Die letzte Antwort des Terminals, sofern eine schluessige ankam. */
+    /**
+     * Die Antwort des Terminals, die den Ausgang FESTGESCHRIEBEN hat -- nur
+     * bei `approved` und `declined`. Bei `unresolved` fehlt sie: eine
+     * Nicht-Aussage darf nicht als Beleg mitgegeben werden. Was das Terminal
+     * zuletzt gesagt hat, steht dann in [lastResponse].
+     */
     readonly response?: HpsTransactionResponse;
+    /**
+     * Die letzte Antwort des Terminals bei `unresolved`, sofern ueberhaupt
+     * eine ankam -- auch wenn sie nichts entschied (9027, 9900, ein
+     * unbekannter Code). NIE ein Beleg, sondern Material fuer Anzeige und
+     * Katalog: am 02.09.2026 sah der Bediener bei einer Antwort `55`
+     * "PIN falsch" nur "Ausgang unklar", musste raten und buchte eine
+     * abgelehnte Zahlung als bezahlt. Der Klartext des Terminals haette die
+     * Entscheidung getragen. Bei schluessigem Ausgang nicht gesetzt.
+     */
+    readonly lastResponse?: HpsTransactionResponse;
     /**
      * Verlauf der Klaerung, in Reihenfolge — der Nachweis, der im
      * Belastungsstreit gelesen wird. Behauptet nie eine Ursache, die nicht

package/dist/esm/payments/hobex-hps/payments.js

@@ -67,7 +67,7 @@ export function createHpsPayments(client, target, options = {}) {
             return `Antwort mit technischem Fehler (${TECHNICAL_ERROR_CODE}) -- keine Aussage ueber den Vorgang, Ausgang wird geklaert`;
         }
         if (isUnknownCode(res)) {
-            return `Terminal nennt einen unbekannten Code (${res.responseCode}) -- Ausgang wird geklaert`;
+            return `Terminal nennt einen unbekannten Code (${res.responseCode})${klartext(res)} -- Ausgang wird geklaert`;
         }
         return `Antwort ohne Aussage (${res.responseCode}) -- Ausgang wird geklaert`;
     }
@@ -80,10 +80,21 @@ export function createHpsPayments(client, target, options = {}) {
             return `Status: technischer Fehler (${TECHNICAL_ERROR_CODE}) -- keine Aussage ueber den Vorgang`;
         }
         if (isUnknownCode(status)) {
-            return `Status: unbekannter Code (${status.responseCode}) -- keine Aussage`;
+            return `Status: unbekannter Code (${status.responseCode})${klartext(status)} -- keine Aussage`;
         }
         return null;
     }
+    /**
+     * Der Klartext des Terminals zu einem UNBEKANNTEN Code, als Zusatz fuer den
+     * Nachweis -- oder leer, wenn keiner mitkam. Nur hier, nicht bei den
+     * gemessenen Codes: deren Bedeutung ist benannt. Bei einem unbekannten Code
+     * ist er dagegen das Einzige, was ein Mensch lesen kann -- "PIN falsch"
+     * neben `55` haette am 02.09.2026 gereicht, um nicht "bezahlt" zu buchen.
+     */
+    function klartext(res) {
+        const text = res.responseText?.trim();
+        return text ? ` "${text}"` : '';
+    }
     /** Ordnet eine Terminal-Antwort ein. `null`, wenn sie nichts entscheidet. */
     function fromResponse(res, id, steps) {
         if (!isConclusive(res))
@@ -185,9 +196,19 @@ export function createHpsPayments(client, target, options = {}) {
         }
         return null;
     }
-    function open(id, steps) {
+    /**
+     * [letzteAntwort] ist die letzte Antwort, die das Terminal in dieser
+     * Klaerung gab -- als `lastResponse` fuer Anzeige und Katalog,
+     * ausdruecklich NICHT als `response`.
+     */
+    function open(id, steps, letzteAntwort) {
         emit('resolved', steps[steps.length - 1], id);
-        return { outcome: 'unresolved', transactionId: id, steps: [...steps] };
+        return {
+            outcome: 'unresolved',
+            transactionId: id,
+            ...(letzteAntwort ? { lastResponse: letzteAntwort } : {}),
+            steps: [...steps],
+        };
     }
     /**
      * Fuehrt [call] aus, aber hoechstens so lange, wie vom [resolveBudgetMs]
@@ -260,7 +281,7 @@ export function createHpsPayments(client, target, options = {}) {
      * [NO_STATEMENT_CODE] (`9027`) beim Pollen einen Aussagewert, den es sonst
      * nicht hat. Siehe [ausGeschlossenerAntwort].
      */
-    async function resolve(id, steps, antwortMitCode = false) {
+    async function resolve(id, steps, antwortMitCode = false, letzteAntwort) {
         emit('resolving', 'Ausgang offen, Klaerung laeuft', id);
         const start = now();
         const elapsedMs = () => now() - start;
@@ -281,6 +302,7 @@ export function createHpsPayments(client, target, options = {}) {
             try {
                 status = await withinBudget(elapsedMs, () => client.status({ ...target, transactionId: id }));
                 transportFailures = 0;
+                letzteAntwort = status;
             }
             catch (e) {
                 transportFailures += 1;
@@ -309,7 +331,7 @@ export function createHpsPayments(client, target, options = {}) {
             wait = nextWait(wait);
         }
         steps.push('Ausgang bleibt offen');
-        return open(id, steps);
+        return open(id, steps, letzteAntwort);
     }
     /**
      * Liest `9027` beim Pollen als "nicht genehmigt" -- aber NUR, wenn das
@@ -369,7 +391,7 @@ export function createHpsPayments(client, target, options = {}) {
      * Budget, Backoff und Transportfehler-Deckelung sind unveraendert aus
      * [resolve] uebernommen.
      */
-    async function resolveCancel(id, steps) {
+    async function resolveCancel(id, steps, letzteAntwort) {
         emit('resolving', 'Ausgang offen, Klaerung laeuft', id);
         const start = now();
         const elapsedMs = () => now() - start;
@@ -390,6 +412,7 @@ export function createHpsPayments(client, target, options = {}) {
                 status = await withinBudget(elapsedMs, () => client.status({ ...target, transactionId: id }));
                 transportFailures = 0;
                 answeredQueries += 1;
+                letzteAntwort = status;
             }
             catch (e) {
                 transportFailures += 1;
@@ -413,7 +436,7 @@ export function createHpsPayments(client, target, options = {}) {
             wait = nextWait(wait);
         }
         steps.push('Ausgang bleibt offen');
-        return open(id, steps);
+        return open(id, steps, letzteAntwort);
     }
     async function pay(paymentOptions) {
         const id = paymentOptions.transactionId ?? newHpsTransactionId();
@@ -452,7 +475,7 @@ export function createHpsPayments(client, target, options = {}) {
                 return settled;
             steps.push(offeneAntwort(res));
         }
-        return resolve(id, steps, res?.responseCode !== undefined);
+        return resolve(id, steps, res?.responseCode !== undefined, res);
     }
     /**
      * Gutschrift mit geklaertem Ausgang -- EXAKT derselbe Klaerweg wie [pay]
@@ -496,7 +519,7 @@ export function createHpsPayments(client, target, options = {}) {
         // Dieselbe Klaerfunktion wie [pay]: die Kennung ist die des NEUEN
         // Vorgangs, eine Statusabfrage darauf liefert also genau dessen Ausgang,
         // und der Abbruch ist derselbe Diskriminator wie bei einer Zahlung.
-        return resolve(id, steps, res?.responseCode !== undefined);
+        return resolve(id, steps, res?.responseCode !== undefined, res);
     }
     /**
      * Aufhebung (Storno/Void) einer bestehenden Zahlung mit geklaertem Ausgang.
@@ -541,7 +564,7 @@ export function createHpsPayments(client, target, options = {}) {
             if (!isCanceled(res))
                 steps.push(offeneAntwort(res));
         }
-        return resolveCancel(id, steps);
+        return resolveCancel(id, steps, res);
     }
     return { pay, refund, cancel };
 }

package/dist/esm/payments/hobex-hps/transaction-response.d.ts

@@ -72,6 +72,18 @@ export declare const INVALID_AMOUNT_CODE = "9003";
 export declare const AMOUNT_OUT_OF_RANGE_CODE = "100019";
 /** Siehe [HPS_MEASURED_CODES]: Terminal-Kennung unbekannt. */
 export declare const INVALID_TID_CODE = "100108";
+/**
+ * Siehe [HPS_MEASURED_CODES]: Host-Ablehnung, falsche PIN -- nichts belastet.
+ *
+ * Zweistellig, weil ein Antwortcode des HOSTS (ISO 8583, 55 = "Incorrect
+ * PIN"), kein `9xxx`-Terminalcode und kein `100xxx`-Code der HPS-Anwendung.
+ * Daraus folgt KEINE Regel fuer andere zweistellige Codes: in derselben
+ * Familie stehen Genehmigungen (`08`, `10`, `11`, `85`). Jeder andere
+ * Host-Code bleibt eine Wissensluecke, bis er gemessen ist -- und die
+ * Zwei-9027-Regel in `payments.ts` faengt ihn nicht, weil die Statusabfrage
+ * dann nicht 9027 antwortet, sondern mit dem Code selbst.
+ */
+export declare const WRONG_PIN_CODE = "55";
 /**
  * HTTP `409` ("Terminal is busy"): das Terminal serialisiert und weist eine
  * zweite Anfrage ab, waehrend eine erste noch laeuft. Am 27.08.2026 gemessen:

package/dist/esm/payments/hobex-hps/transaction-response.js

@@ -84,6 +84,15 @@ export const HPS_MEASURED_CODES = [
             + 'nicht; der Vorgang wird abgewiesen, bevor etwas geschieht',
         conclusive: true,
     },
+    {
+        code: '55',
+        meaning: '"PIN falsch" -- Host-Ablehnung wegen falscher PIN, die erste '
+            + 'gemessene Host-Ablehnung ueberhaupt (02.09.2026 im Betrieb, TID '
+            + '3556988, HPS 1.11.4, Firmware 2.3.9): die Zahlung antwortete direkt '
+            + 'damit, die Statusabfrage danach elfmal in Folge ebenso -- eine '
+            + 'Host-Ablehnung bleibt am Terminal abrufbar; nichts belastet',
+        conclusive: true,
+    },
 ];
 /** `responseCode` einer genehmigten Zahlung. */
 export const APPROVED_CODE = '0';
@@ -107,6 +116,18 @@ export const INVALID_AMOUNT_CODE = '9003';
 export const AMOUNT_OUT_OF_RANGE_CODE = '100019';
 /** Siehe [HPS_MEASURED_CODES]: Terminal-Kennung unbekannt. */
 export const INVALID_TID_CODE = '100108';
+/**
+ * Siehe [HPS_MEASURED_CODES]: Host-Ablehnung, falsche PIN -- nichts belastet.
+ *
+ * Zweistellig, weil ein Antwortcode des HOSTS (ISO 8583, 55 = "Incorrect
+ * PIN"), kein `9xxx`-Terminalcode und kein `100xxx`-Code der HPS-Anwendung.
+ * Daraus folgt KEINE Regel fuer andere zweistellige Codes: in derselben
+ * Familie stehen Genehmigungen (`08`, `10`, `11`, `85`). Jeder andere
+ * Host-Code bleibt eine Wissensluecke, bis er gemessen ist -- und die
+ * Zwei-9027-Regel in `payments.ts` faengt ihn nicht, weil die Statusabfrage
+ * dann nicht 9027 antwortet, sondern mit dem Code selbst.
+ */
+export const WRONG_PIN_CODE = '55';
 /**
  * HTTP `409` ("Terminal is busy"): das Terminal serialisiert und weist eine
  * zweite Anfrage ab, waehrend eine erste noch laeuft. Am 27.08.2026 gemessen:

package/fixtures/hobex-hps-codes.json

@@ -1,11 +1,22 @@
 {
-  "version": "0.7.1",
+  "version": "0.8.0",
   "gemessenAn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",
     "firmware": "7.3.6",
     "zeitraum": "26.-28.08.2026"
   },
+  "ergaenztAn": [
+    {
+      "tid": "3556988",
+      "hpsVersion": "1.11.4",
+      "firmware": "2.3.9",
+      "zeitraum": "02.09.2026",
+      "codes": [
+        "55"
+      ]
+    }
+  ],
   "codes": [
     {
       "code": "0",
@@ -61,6 +72,11 @@
       "code": "100108",
       "meaning": "\"Invalid TID\" -- die Terminal-Kennung gibt es an diesem Geraet nicht; der Vorgang wird abgewiesen, bevor etwas geschieht",
       "conclusive": true
+    },
+    {
+      "code": "55",
+      "meaning": "\"PIN falsch\" -- Host-Ablehnung wegen falscher PIN, die erste gemessene Host-Ablehnung ueberhaupt (02.09.2026 im Betrieb, TID 3556988, HPS 1.11.4, Firmware 2.3.9): die Zahlung antwortete direkt damit, die Statusabfrage danach elfmal in Folge ebenso -- eine Host-Ablehnung bleibt am Terminal abrufbar; nichts belastet",
+      "conclusive": true
     }
   ],
   "terminalBusyHttpStatus": 409

package/fixtures/kasse-meldungen-faelle.json

@@ -0,0 +1,32 @@
+{
+  "version": 1,
+  "faelle": [
+    { "name": "api: der Satz des Backends, woertlich",
+      "fehler": { "art": "api", "serverMessage": "Kopplungs-Code ist abgelaufen." },
+      "ersatz": "Ersatz.", "erwartet": "Kopplungs-Code ist abgelaufen." },
+    { "name": "api: auch ein Satz, der wie ein Ersatz aussieht, bleibt der des Backends",
+      "fehler": { "art": "api", "serverMessage": "PIN falsch, noch 2 Versuche." },
+      "ersatz": "Die Anmeldung ist fehlgeschlagen. Bitte erneut versuchen.", "erwartet": "PIN falsch, noch 2 Versuche." },
+    { "name": "klartext: sein eigener Text",
+      "fehler": { "art": "klartext", "text": "Eigener Satz fuer den Schirm." },
+      "ersatz": "Ersatz.", "erwartet": "Eigener Satz fuer den Schirm." },
+    { "name": "zeitablauf: der Server antwortet nicht",
+      "fehler": { "art": "zeitablauf" },
+      "ersatz": "Ersatz.", "erwartet": { "schluessel": "netz.zeitablauf" } },
+    { "name": "netz: keine Verbindung",
+      "fehler": { "art": "netz" },
+      "ersatz": "Ersatz.", "erwartet": { "schluessel": "netz.keine_verbindung" } },
+    { "name": "unerwartet: HTML statt JSON (fehlender Rewrite)",
+      "fehler": { "art": "unerwartet", "status": 404 },
+      "ersatz": "Ersatz.", "erwartet": { "schluessel": "server.unerwartet", "werte": { "status": 404 } } },
+    { "name": "unerwartet: 500er",
+      "fehler": { "art": "unerwartet", "status": 500 },
+      "ersatz": "Ersatz.", "erwartet": { "schluessel": "server.unerwartet", "werte": { "status": 500 } } },
+    { "name": "unerwartet: HTTP 200 ohne Huelle",
+      "fehler": { "art": "unerwartet", "status": 200 },
+      "ersatz": "Ersatz.", "erwartet": { "schluessel": "server.unerwartet", "werte": { "status": 200 } } },
+    { "name": "sonst: Technisches bleibt beim Ersatz",
+      "fehler": { "art": "sonst" },
+      "ersatz": "Die Kopplung ist fehlgeschlagen. Bitte erneut versuchen.", "erwartet": "Die Kopplung ist fehlgeschlagen. Bitte erneut versuchen." }
+  ]
+}