@kreiseck/kasseneck-api 0.17.0 → 0.19.0

package/CHANGELOG.md

@@ -4,6 +4,69 @@ 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.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
+
+**Anlass:** Die API wird vor allem von Online-Shops benutzt, die **vor** der
+Rechnung kassieren. Bisher entstand immer eine offene Rechnung — mit Giro-QR
+und Fälligkeit auf dem Blatt, obwohl das Geld längst da war.
+
+- `issueInvoice` nimmt `payment` (`method`, optional `amountCents`, `paidAt`,
+  `reference`). Die Zahlung entsteht in **derselben** Transaktion wie das
+  Festschreiben; ohne `amountCents` gilt der volle Bruttobetrag.
+- Neuer Aufruf `recordInvoicePayment` für später eintreffende Zahlungen, mit
+  **pflichtigem** `idempotencyKey` — ohne ihn bucht ein Wiederholungslauf nach
+  einem Zeitlimit eine zweite Zahlung.
+- `INVOICE_PAYMENT_METHODS` (`transfer`, `card`, `online`, `cash`);
+  `Invoice.paidCents` und `Invoice.openCents`.
+- Neue Fehlercodes `not_payable` (storniert oder Gutschrift) und
+  `payment_exceeds_invoice` (mit `remainingCents`).
+- Neu: **Hinweise** an einer erfolgreichen Antwort (`INVOICE_NOTICE_CODES`,
+  `data.notice`). Bisheriger Fall: `cash_receipt_required`. Grund: eine
+  Barzahlung ist ein Barumsatz und braucht einen Beleg (§ 132a BAO), bei
+  Registrierkassenpflicht über die Registrierkasse — der Bezahlt-Vermerk ist
+  Buchhaltung und ersetzt ihn nicht. Die Rechnung selbst ist bei jeder
+  Zahlungsart erlaubt (§ 11 UStG), deshalb wird `cash` gebucht und nicht
+  abgewiesen.
+
+`reference` wird gespeichert, aber nicht gedruckt: die Rechnung wird sieben
+Jahre aufbewahrt und vervielfältigt, und dem Empfänger nützt die Zahlungs-ID
+des Shops nichts.
+
 ## 0.17.0
 
 ### Rechnungs-API: Sprache (de/en) und Marke je Rechnung

package/README.md

@@ -524,6 +524,32 @@ bzw. `pcs` —, und die E-Rechnung trägt den UN/ECE-Code aus
 `RECHNUNG_EINHEITEN_CODES` (`C62`, `HUR`, …). Freier Text wie `"Std"` ist
 `validation` mit Feld `items[0].unit`.
 
+**Schon bezahlt?** Wer online kassiert und danach die Rechnung stellt, gibt die
+Zahlung gleich mit: sie entsteht in derselben Transaktion wie das Festschreiben,
+und das PDF trägt dann keinen Zahlungskasten und keinen Giro-QR.
+
+```ts
+const { invoice } = await rechnungen.issueInvoice({
+  idempotencyKey: `bestellung-${bestellnummer}`,
+  customerId: kunde.id,
+  taxScheme: 'normal', priceMode: 'net', serviceStart: '2026-09-16',
+  items: [{ description: 'Beratung', quantity: 2, unitPriceCents: 5000, vatRate: 20, unit: 'hour' }],
+  payment: { method: 'card', reference: zahlung.id },      // ohne amountCents: voll bezahlt
+});                                                        // invoice.openCents === 0
+
+// Trifft das Geld erst später ein (Überweisung, Teilzahlung):
+await rechnungen.recordInvoicePayment({
+  idempotencyKey: `zahlung-${zahlung.id}`,                 // Pflicht: sonst bucht eine Wiederholung zweimal
+  invoiceId: invoice.id, method: 'transfer', amountCents: 12000, paidAt: '2026-09-20',
+});
+```
+
+`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.
+
 **Nach einem Zeitlimit mit demselben `idempotencyKey` wiederholen**, nie mit
 einem neuen: dann kommt die schon ausgestellte Rechnung zurück
 (`replayed: true`). Derselbe Schlüssel mit anderen Daten ergibt

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

@@ -13,7 +13,7 @@
  * umhuellt, muss ihn weiterhin absetzen koennen.
  */
 import type { TransportBodyFields } from './transport.js';
-export declare const AUFRUFE: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "requestCustomerSignature", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook"];
+export declare const AUFRUFE: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "requestCustomerSignature", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook"];
 export type Aufruf = typeof AUFRUFE[number];
 /** Wie [KasseneckTransport], nur mit bekanntem Aufrufnamen. Nicht exportiert nach aussen. */
 export type InternerTransport = <T = unknown>(functionName: Aufruf, params?: Record<string, unknown>, extraBodyFields?: TransportBodyFields, secretParams?: readonly string[]) => Promise<T>;

package/dist/cjs/client/aufrufe.js

@@ -51,6 +51,7 @@ exports.AUFRUFE = [
     'listRegisterUsersForDevice',
     'listRegisterSessionsForDevice',
     'pairRegisterDevice',
+    'recordInvoicePayment',
     'registerPinLogin',
     'registerUserLogin',
     'renewRegisterSession',

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[];