@kreiseck/kasseneck-api 0.18.0 → 0.20.0

package/CHANGELOG.md

@@ -4,6 +4,64 @@ 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.20.0
+
+### Rechnung: richtige Steuerhinweise, Barumsatz auch mit Karte
+
+**Anlass:** drei Befunde aus einer Durchsicht an den Primärquellen.
+
+- **Reverse Charge ist keine Steuerbefreiung.** Der Aufdruck hiess
+  „Steuerfreie Leistung – Reverse Charge" und behauptete damit eine Befreiung,
+  die es nicht gibt: der Umsatz bleibt steuerpflichtig, nur die Steuer schuldet
+  der Empfänger. Das Gesetz trennt beides (§ 11 Abs. 1 Z 3 lit. e = Hinweis auf
+  eine Befreiung, § 11 Abs. 1a = Hinweis auf die Steuerschuldnerschaft); Art. 226
+  Nr. 11a MwSt-RL nennt den Begriff wörtlich. Jetzt:
+  „Steuerschuldnerschaft des Leistungsempfängers."
+- **Ig. Lieferung** bekommt denselben Kasten wie Reverse Charge, mit **beiden**
+  UID-Nummern — Art. 11 Abs. 2 UStG verlangt sie auf der Rechnung. Der
+  Textschlüssel `steuer.reverseCharge.uid` heisst darum jetzt `steuer.uidZeile`,
+  neu sind `steuer.igLieferung.titel` und `steuer.igLieferung.text`
+  (`steuer.igLieferung` entfällt).
+- **`onSite` an der Zahlung.** Ein Barumsatz ist nicht nur Bargeld: als
+  Barzahlung gilt auch die Karte **vor Ort** (§ 131b Abs. 1 Z 3 UStG), nicht
+  aber dieselbe Karte im Internet. Weil `card`/`online` beides sein können,
+  sagt es das Fremdsystem jetzt selbst — der Hinweis `cash_receipt_required`
+  kommt bei `cash` immer und sonst nur mit `onSite: true`. `transfer` mit
+  `onSite` wird abgewiesen.
+
+## 0.19.0
+
+### hobex HPS: TECS-Antwortcodes eingeordnet, Storno nach ausbleibender Host-Antwort
+
+**Anlass:** hobex hat am 16.09.2026 bestätigt, dass das HPS die Codes der
+TECS-Plattform durchreicht, und deren Liste geschickt. Zu `9908` (im Betrieb am
+11.09.2026 gesehen, bisher unbekannt und damit offen): „ein Timeout wie jeder
+andere. Richtigerweise sollte in dem Fall ein Storno nachgeschickt werden.“
+
+- `HPS_CODES` führt jetzt 365 Codes; die TECS-Liste steht in
+  `src/payments/hobex-hps/tecs-codes.ts`, eine Zeile je Code.
+- `sendReversal` je Code und `needsReversal()`: bei ausbleibender oder
+  unbrauchbarer Host-Antwort schickt `pay` genau einmal ein Storno
+  (`/v1/terminal/cancel`) nach. Quittiert → `declined` mit
+  `'voidedAfterHostFault'`; sonst Klärung wie bisher, ein späteres `9011`
+  zählt ebenfalls als storniert. Gutschriften bekommen kein Storno (TECS:
+  `9031`).
+- `tecsTitle` je Code: der Titel in der TECS-Liste.
+- `normalizeHpsCode()`: `0055` und `55` sind derselbe Code; `responseCode`
+  kommt normalisiert an (`0000` → `0`), `raw` bleibt unverändert. Familien mit
+  Platzhalter (`81xx`) werden gefunden.
+- 16 neue Gründe in `HpsCodeReason` und `HPS_REASON_HINTS`, darunter
+  `issuerDeclined`, `insufficientFunds`, `cardExpired`, `hostTimeout`,
+  `approvedWithCondition`. **Kassen mit eigener Übersetzung brauchen dafür
+  Texte.**
+- Eine Genehmigung, die nicht `0` ist (`8`, `10`, `11`, `16`, `32`), bleibt
+  offen und wird nie zur Ablehnung.
+- `9900` ist jetzt `hostUncertain` (`internalError`) statt `noStatement`:
+  gemessen kam er nach verarbeiteter Karte, und die Zwei-9027-Regel hätte
+  daraus „nichts belastet“ gemacht.
+- `fixtures/hobex-hps-codes.json` führt je Code zusätzlich `sendReversal` und
+  `tecsTitle`.
+
 ## 0.18.0
 
 ### Rechnungs-API: bezahlte Rechnung und Zahlungen nachtragen

package/README.md

@@ -545,10 +545,23 @@ await rechnungen.recordInvoicePayment({
 ```
 
 `reference` wird gespeichert, aber **nicht gedruckt**; Kartendaten gehören
-ohnehin nicht auf eine Rechnung. Bei `method: 'cash'` wird die Zahlung gebucht
-und die Antwort trägt zusätzlich `notice.code = 'cash_receipt_required'`: eine
-Barzahlung ist ein Barumsatz und braucht einen Beleg (§ 132a BAO), bei
-Registrierkassenpflicht über die Kasse — der Vermerk hier ersetzt ihn nicht.
+ohnehin nicht auf eine Rechnung.
+
+**Barumsatz ist nicht nur Bargeld.** Als Barzahlung gilt auch die Karte **vor
+Ort** an der Kasse (§ 131b Abs. 1 Z 3 UStG) — dieselbe Karte im Internet
+dagegen nicht. Weil `card` und `online` beides sein können, sagt es das
+Fremdsystem selbst:
+
+```ts
+payment: { method: 'card', onSite: true }   // Terminal an der Kasse
+payment: { method: 'card' }                 // Kartenzahlung im Shop
+```
+
+Bei `cash` (immer) und bei `onSite: true` trägt die Antwort
+`notice.code = 'cash_receipt_required'`: ein Barumsatz braucht einen Beleg
+(§ 132a BAO), bei Registrierkassenpflicht über die Registrierkasse — der
+Vermerk an der Rechnung ersetzt ihn nicht. `transfer` mit `onSite` ist ein
+Feldfehler, eine Überweisung erfolgt nicht vor Ort.
 
 **Nach einem Zeitlimit mit demselben `idempotencyKey` wiederholen**, nie mit
 einem neuen: dann kommt die schon ausgestellte Rechnung zurück

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

@@ -23,5 +23,5 @@ export { type HpsPaymentEvent, type HpsPaymentEventKind, type HpsPaymentObserver
 export { type CardPaymentOutcome, type HpsPaymentResult, isHostUncertainResult, 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, APP_SELECT_FAILED_CODE, APPROVED_CODE, BAD_REQUEST_CODE, CARD_DECLINED_CODE, CARD_INFO_NOT_ENTERED_CODE, CARD_NOT_PRESENT_CODE, CARD_NOT_SUPPORTED_CODE, CARD_READ_FAILED_CODE, CHIP_DATA_MISMATCH_CODE, COMPLETION_FAILED_CODE, DIAGNOSIS_FAILED_CODE, HOST_COMMUNICATION_FAILED_CODE, HOST_STEP_FAILED_CODE, HOST_TIMEOUT_REVERSED_CODE, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, INTERNAL_ERROR_CODE, INVALID_MESSAGE_TYPE_CODE, INVALID_TID_DOCUMENTED_CODE, INVALID_TX_TYPE_CODE, MAX_RETRIES_EXCEEDED_CODE, NOT_FOUND_CODE, PASSWORD_NOT_ENTERED_CODE, REFUND_DISABLED_CODE, REFUND_PASSWORD_INVALID_CODE, SCEP_ENROLLMENT_FAILED_CODE, TERMINAL_BLOCKED_CODE, TERMINAL_BUSY_CODE, TIP_SELECTION_FAILED_CODE, UNSUPPORTED_USER_DATA_CODE, hpsCodeInfo, hpsCodeReason, isHostUncertain, isHostUncertainReason, 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, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, parseHpsTransactionResponse, type HpsCode, type HpsCodeEffect, type HpsCodeReason, type HpsCodeSource, type HpsMeasuredCode, type HpsTransactionResponse, } from './transaction-response.js';
+export { ABORTED_CODE, APP_SELECT_FAILED_CODE, APPROVED_CODE, BAD_REQUEST_CODE, CARD_DECLINED_CODE, CARD_INFO_NOT_ENTERED_CODE, CARD_NOT_PRESENT_CODE, CARD_NOT_SUPPORTED_CODE, CARD_READ_FAILED_CODE, CHIP_DATA_MISMATCH_CODE, COMPLETION_FAILED_CODE, DIAGNOSIS_FAILED_CODE, HOST_COMMUNICATION_FAILED_CODE, HOST_STEP_FAILED_CODE, HOST_TIMEOUT_REVERSED_CODE, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, INTERNAL_ERROR_CODE, INVALID_MESSAGE_TYPE_CODE, INVALID_TID_DOCUMENTED_CODE, INVALID_TX_TYPE_CODE, MAX_RETRIES_EXCEEDED_CODE, NOT_FOUND_CODE, PASSWORD_NOT_ENTERED_CODE, REFUND_DISABLED_CODE, REFUND_PASSWORD_INVALID_CODE, SCEP_ENROLLMENT_FAILED_CODE, TERMINAL_BLOCKED_CODE, TERMINAL_BUSY_CODE, TIP_SELECTION_FAILED_CODE, UNSUPPORTED_USER_DATA_CODE, hpsCodeInfo, hpsCodeReason, isHostUncertain, isHostUncertainReason, 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, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isInProgress, isNoStatement, isNotAbortable, needsReversal, normalizeHpsCode, isTechnicalError, isUnknownCode, parseHpsTransactionResponse, type HpsCode, type HpsCodeEffect, type HpsCodeReason, type HpsCodeSource, type HpsMeasuredCode, type HpsTransactionResponse, } from './transaction-response.js';
 export { hobexReceiptFromHps } from './receipt.js';

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

@@ -20,7 +20,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isHostUncertain = exports.hpsCodeReason = exports.hpsCodeInfo = exports.UNSUPPORTED_USER_DATA_CODE = exports.TIP_SELECTION_FAILED_CODE = exports.TERMINAL_BUSY_CODE = exports.TERMINAL_BLOCKED_CODE = exports.SCEP_ENROLLMENT_FAILED_CODE = exports.REFUND_PASSWORD_INVALID_CODE = exports.REFUND_DISABLED_CODE = exports.PASSWORD_NOT_ENTERED_CODE = exports.NOT_FOUND_CODE = exports.MAX_RETRIES_EXCEEDED_CODE = exports.INVALID_TX_TYPE_CODE = exports.INVALID_TID_DOCUMENTED_CODE = exports.INVALID_MESSAGE_TYPE_CODE = exports.INTERNAL_ERROR_CODE = exports.HPS_REASON_HINTS = exports.HPS_MEASURED_CODES = exports.HPS_CODES = exports.HOST_TIMEOUT_REVERSED_CODE = exports.HOST_STEP_FAILED_CODE = exports.HOST_COMMUNICATION_FAILED_CODE = exports.DIAGNOSIS_FAILED_CODE = exports.COMPLETION_FAILED_CODE = exports.CHIP_DATA_MISMATCH_CODE = exports.CARD_READ_FAILED_CODE = exports.CARD_NOT_SUPPORTED_CODE = exports.CARD_NOT_PRESENT_CODE = exports.CARD_INFO_NOT_ENTERED_CODE = exports.CARD_DECLINED_CODE = exports.BAD_REQUEST_CODE = exports.APPROVED_CODE = exports.APP_SELECT_FAILED_CODE = exports.ABORTED_CODE = exports.newHpsTransactionId = exports.isValidHpsTransactionId = exports.createHpsTransactionIdGenerator = exports.MAX_TRANSACTION_ID_LENGTH = exports.createHpsPayments = exports.mayRetrySafely = exports.isHostUncertainResult = exports.PREFLIGHT_CONNECT_CODES = exports.HpsTransactionIdError = exports.HpsPreflightError = exports.HpsConnectTransportError = exports.HpsConnectTerminalError = exports.HpsConnectException = exports.HpsClarifyTimeoutError = exports.createHpsConnectClient = void 0;
-exports.hobexReceiptFromHps = exports.parseHpsTransactionResponse = exports.isUnknownCode = exports.isTechnicalError = exports.isNotAbortable = exports.isNoStatement = exports.isInProgress = exports.isConclusiveAsStatus = exports.isConclusive = exports.isCanceled = exports.isApproved = exports.TRANSACTION_CANCELED_CODE = exports.TERMINAL_BUSY_HTTP_STATUS = exports.NOT_FOUND_HTTP_STATUS = exports.TECHNICAL_ERROR_CODE = exports.NO_STATEMENT_CODE = exports.WRONG_PIN_CODE = exports.INVALID_TID_CODE = exports.AMOUNT_OUT_OF_RANGE_CODE = exports.INVALID_AMOUNT_CODE = exports.NOT_ABORTABLE_CODE = exports.INVALID_TRANSACTION_CODE = exports.isHostUncertainReason = void 0;
+exports.hobexReceiptFromHps = exports.parseHpsTransactionResponse = exports.isUnknownCode = exports.isTechnicalError = exports.normalizeHpsCode = exports.needsReversal = exports.isNotAbortable = exports.isNoStatement = exports.isInProgress = exports.isConclusiveAsStatus = exports.isConclusive = exports.isCanceled = exports.isApproved = exports.TRANSACTION_CANCELED_CODE = exports.TERMINAL_BUSY_HTTP_STATUS = exports.NOT_FOUND_HTTP_STATUS = exports.TECHNICAL_ERROR_CODE = exports.NO_STATEMENT_CODE = exports.WRONG_PIN_CODE = exports.INVALID_TID_CODE = exports.AMOUNT_OUT_OF_RANGE_CODE = exports.INVALID_AMOUNT_CODE = exports.NOT_ABORTABLE_CODE = exports.INVALID_TRANSACTION_CODE = exports.isHostUncertainReason = void 0;
 var connect_client_js_1 = require("./connect-client.js");
 Object.defineProperty(exports, "createHpsConnectClient", { enumerable: true, get: function () { return connect_client_js_1.createHpsConnectClient; } });
 var errors_js_1 = require("./errors.js");
@@ -96,6 +96,8 @@ Object.defineProperty(exports, "isConclusiveAsStatus", { enumerable: true, get:
 Object.defineProperty(exports, "isInProgress", { enumerable: true, get: function () { return transaction_response_js_1.isInProgress; } });
 Object.defineProperty(exports, "isNoStatement", { enumerable: true, get: function () { return transaction_response_js_1.isNoStatement; } });
 Object.defineProperty(exports, "isNotAbortable", { enumerable: true, get: function () { return transaction_response_js_1.isNotAbortable; } });
+Object.defineProperty(exports, "needsReversal", { enumerable: true, get: function () { return transaction_response_js_1.needsReversal; } });
+Object.defineProperty(exports, "normalizeHpsCode", { enumerable: true, get: function () { return transaction_response_js_1.normalizeHpsCode; } });
 Object.defineProperty(exports, "isTechnicalError", { enumerable: true, get: function () { return transaction_response_js_1.isTechnicalError; } });
 Object.defineProperty(exports, "isUnknownCode", { enumerable: true, get: function () { return transaction_response_js_1.isUnknownCode; } });
 Object.defineProperty(exports, "parseHpsTransactionResponse", { enumerable: true, get: function () { return transaction_response_js_1.parseHpsTransactionResponse; } });

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

@@ -108,6 +108,17 @@ import type { HpsPaymentResult } from './outcome.js';
  *    solcher Code), endet sie sofort als `unresolved` -- das Terminal wird es
  *    auch in 90 Sekunden nicht wissen. Meldet sie dagegen `'0'`, ist die
  *    Zahlung genehmigt, ganz normal.
+ *
+ * ## Storno nach ausbleibender Host-Antwort (16.09.2026)
+ *
+ * Fuer einen Teil dieser Codes -- der Host hat nicht oder nicht brauchbar
+ * geantwortet, etwa `9908` -- gibt hobex vor, ein Storno nachzuschicken
+ * (`sendReversal`). [pay] tut das genau einmal, mit Kennung und Betrag der
+ * Zahlung, bevor die Statusabfrage laeuft: quittiert mit `'0'` -> `declined`
+ * mit `'voidedAfterHostFault'`; sonst weiter wie oben, und ein `9011` in der
+ * Statusabfrage heisst dann ebenfalls `declined`. Am Geraet ungemessen, siehe
+ * Dart-Zwilling. [refund] schickt kein Storno nach (TECS: `9031`), [cancel]
+ * ist selbst eines.
  */
 export interface HpsPaymentsOptions {
     /** Wie lange insgesamt geklaert wird, bevor der Ausgang offen bleibt. Vorgabe 90 s. */

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

@@ -6,6 +6,11 @@ const transaction_id_js_1 = require("./transaction-id.js");
 const transaction_response_js_1 = require("./transaction-response.js");
 /** Teiler, mit dem das Abbruchbudget aus [HpsPaymentsOptions.resolveBudgetMs] entsteht. */
 const ABORT_BUDGET_DIVISOR = 6;
+/**
+ * Teiler fuer das Budget des nachgeschickten Stornos: ein Drittel, bei der
+ * Vorgabe 30 s. Ein Storno geht ueber den Host und darf Sekunden brauchen.
+ */
+const REVERSAL_BUDGET_DIVISOR = 3;
 function createHpsPayments(client, target, options = {}) {
     const resolveBudgetMs = options.resolveBudgetMs ?? 90_000;
     const maxBackoffMs = options.maxBackoffMs ?? 10_000;
@@ -14,6 +19,7 @@ function createHpsPayments(client, target, options = {}) {
     const now = options.now ?? Date.now;
     const observer = options.observer;
     const abortBudgetMs = Math.trunc(resolveBudgetMs / ABORT_BUDGET_DIVISOR);
+    const reversalBudgetMs = Math.trunc(resolveBudgetMs / REVERSAL_BUDGET_DIVISOR);
     function emit(kind, message, transactionId) {
         if (!observer)
             return;
@@ -70,8 +76,12 @@ function createHpsPayments(client, target, options = {}) {
         const info = (0, transaction_response_js_1.hpsCodeInfo)(res.responseCode);
         const was = info.reason === 'internalError'
             ? 'interner Fehler des Terminals'
-            : 'Stoerung zwischen Terminal und hobex-Host, das Terminal storniert nicht selbst';
-        return `Terminal meldet ${was} (${info.code} "${info.title}")`;
+            : info.reason === 'approvedWithCondition'
+                ? 'Genehmigung mit Vorbehalt'
+                : info.reason === 'hostTimeout'
+                    ? 'keine rechtzeitige Antwort des hobex-Hosts, das Terminal storniert nicht selbst'
+                    : 'Stoerung zwischen Terminal und hobex-Host, das Terminal storniert nicht selbst';
+        return `Terminal meldet ${was} (${res.responseCode} "${info.title}")`;
     }
     /**
      * Der Grund eines offenen Ausgangs. [antwort] ist die Antwort auf die
@@ -344,6 +354,37 @@ function createHpsPayments(client, target, options = {}) {
         emit('resolved', steps[steps.length - 1], id);
         return { outcome: 'declined', transactionId: id, response: res, reason: 'aborted', steps: [...steps] };
     }
+    /**
+     * Schickt zu einer Zahlung, deren Host-Antwort ausblieb ([anlass] traegt
+     * `sendReversal`), GENAU EINMAL ein Storno nach. Ergebnis nur, wenn das
+     * Terminal es mit `'0'` quittiert; sonst `null`. Ohne [amountCents]
+     * (Gutschrift) wird nichts gesendet.
+     */
+    async function sendReversal(id, steps, elapsedMs, amountCents, anlass) {
+        if (amountCents === undefined) {
+            steps.push('Kein Storno nachgeschickt -- die Aufhebung einer Gutschrift laesst TECS nicht zu');
+            return null;
+        }
+        emit('resolving', `Storno wird nachgeschickt (${anlass.responseCode})`, id);
+        let res;
+        try {
+            res = await withinBudget(elapsedMs, () => client.cancel({ ...target, transactionId: id, amountCents }), reversalBudgetMs);
+        }
+        catch (e) {
+            steps.push(`Storno nachgeschickt, aber nicht bestaetigt (${describe(e)}) -- ob es wirkte, ist offen, Ausgang wird abgefragt`);
+            noteUnexpected(e, id);
+            return null;
+        }
+        if (!(0, transaction_response_js_1.isApproved)(res)) {
+            const titel = (0, transaction_response_js_1.hpsCodeInfo)(res.responseCode)?.title;
+            steps.push(`Storno nachgeschickt, nicht bestaetigt (${res.responseCode ?? 'ohne Ergebniscode'}`
+                + `${titel === undefined ? '' : ` "${titel}"`}) -- Ausgang wird abgefragt`);
+            return null;
+        }
+        steps.push('Storno nachgeschickt und bestaetigt -- die Zahlung ist aufgehoben, es ist nichts belastet');
+        emit('resolved', steps[steps.length - 1], id);
+        return { outcome: 'declined', transactionId: id, response: res, reason: 'voidedAfterHostFault', steps: [...steps] };
+    }
     /**
      * Klaert einen offenen Ausgang: erst abbrechen, dann abfragen -- bis das
      * Terminal etwas sagt oder das Budget aufgebraucht ist.
@@ -356,7 +397,7 @@ function createHpsPayments(client, target, options = {}) {
      * ([isHostUncertain]), bekommt `9027` diesen Aussagewert gerade NICHT --
      * siehe Klassendoku, "Stoerung beim Host".
      */
-    async function resolve(id, steps, antwort) {
+    async function resolve(id, steps, antwort, stornoCents) {
         emit('resolving', 'Ausgang offen, Klaerung laeuft', id);
         const start = now();
         const elapsedMs = () => now() - start;
@@ -365,6 +406,9 @@ function createHpsPayments(client, target, options = {}) {
         // Statusabfrage sie nennt und danach 9027 kommt.
         let stoerungsAntwort = antwort && (0, transaction_response_js_1.isHostUncertain)(antwort) ? antwort : undefined;
         let letzteAntwort = antwort;
+        // Das Storno wird hoechstens einmal erwogen; gesendet ist es nur mit Betrag.
+        let stornoErwogen = false;
+        let stornoGesendet = false;
         if (stoerungsAntwort === undefined) {
             const aborted = await tryAbort(id, steps, elapsedMs);
             if (aborted)
@@ -375,6 +419,13 @@ function createHpsPayments(client, target, options = {}) {
             // Host. Ein quittierter Abbruch bewiese nur, dass am Terminal nichts mehr
             // laeuft, nicht, dass der Host nichts belastet hat.
             steps.push('Kein Abbruchversuch -- das Terminal hat den Vorgang mit einer Stoerung beim hobex-Host beendet');
+            if ((0, transaction_response_js_1.needsReversal)(stoerungsAntwort)) {
+                stornoErwogen = true;
+                stornoGesendet = stornoCents !== undefined;
+                const storniert = await sendReversal(id, steps, elapsedMs, stornoCents, stoerungsAntwort);
+                if (storniert)
+                    return storniert;
+            }
         }
         let wait = 0;
         let transportFailures = 0;
@@ -409,6 +460,24 @@ function createHpsPayments(client, target, options = {}) {
             if ((0, transaction_response_js_1.isHostUncertain)(status))
                 stoerungsAntwort ??= status;
             const hostUngewiss = stoerungsAntwort !== undefined;
+            if (stornoGesendet && (0, transaction_response_js_1.isCanceled)(status)) {
+                steps.push(`Status: Zahlung aufgehoben (${transaction_response_js_1.TRANSACTION_CANCELED_CODE}) -- das nachgeschickte Storno hat gegriffen, `
+                    + 'es ist nichts belastet');
+                emit('resolved', steps[steps.length - 1], id);
+                return { outcome: 'declined', transactionId: id, response: status, reason: 'voidedAfterHostFault', steps: [...steps] };
+            }
+            if (!stornoErwogen && (0, transaction_response_js_1.needsReversal)(status)) {
+                // Die Zahlung selbst kam ohne Antwort zurueck, erst die Statusabfrage
+                // nennt die ausgebliebene Host-Antwort -- dasselbe Storno wie oben.
+                steps.push(statusOhneErgebnis(status));
+                stornoErwogen = true;
+                stornoGesendet = stornoCents !== undefined;
+                const storniert = await sendReversal(id, steps, elapsedMs, stornoCents, status);
+                if (storniert)
+                    return storniert;
+                wait = nextWait(wait);
+                continue;
+            }
             // Auf die Statusabfrage entscheidet nur ein Code, der den gesuchten
             // Vorgang beschreibt -- nicht einer, der diese Abfrage abweist
             // ([isConclusiveAsStatus]). Nach einer Stoerung beim Host entscheidet nur
@@ -610,7 +679,7 @@ function createHpsPayments(client, target, options = {}) {
                 return settled;
             steps.push(offeneAntwort(res));
         }
-        return resolve(id, steps, res);
+        return resolve(id, steps, res, paymentOptions.amountCents);
     }
     /**
      * Gutschrift mit geklaertem Ausgang -- EXAKT derselbe Klaerweg wie [pay]

package/dist/cjs/payments/hobex-hps/tecs-codes.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Die Antwortcodeliste von TECS, erhalten ueber hobex am 16.09.2026.
+ *
+ * **Zwilling:** `kasseneck_api/lib/src/hobex_hps/tecs_codes.dart` -- dort
+ * steht die Einordnung ausfuehrlich. Kurz: eine Antwort des Hosts ohne
+ * Genehmigung lehnt ab; eine Genehmigung, die nicht `0` ist, bleibt offen;
+ * keine oder keine brauchbare Host-Antwort bleibt offen und bekommt ein
+ * Storno; Codes anderer TECS-Produkte sagen nichts ueber die Zahlung.
+ *
+ * TECS fuehrt die Host-Antworten vierstellig (`0055`), das Terminal sendet
+ * sie ohne Nullen (`55`). Die Tabelle fuehrt die Form des Terminals.
+ * Gemessene Codes (`0`, `9002`, `9003`, `9011`, `9027`, `9900`, `55`)
+ * stehen in `transaction-response.ts`, hier nur die uebrigen.
+ */
+import type { HpsCode } from './transaction-response.js';
+export declare const TECS_CODES: readonly HpsCode[];