@kreiseck/kasseneck-api 0.17.0 → 0.19.0

package/dist/cjs/rechnung/vertrag.js

@@ -19,7 +19,7 @@
  * Nummer, Summen — ist bewusst **nicht** setzbar.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = exports.INVOICE_UNITS = exports.INVOICE_LANGUAGES = exports.EINVOICE_FORMATS = exports.DOC_TYPES = exports.INVOICE_LIST_STATUS = exports.CUSTOMER_TYPES = exports.VAT_RATES = exports.PRICE_MODES = exports.TAX_SCHEMES = exports.CREDIT_NOTE_REASONS = exports.INVOICE_ERROR_CODES = exports.RECHNUNG_AUFRUFE = exports.RECHNUNG_VERTRAG_VERSION = void 0;
+exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.PAYMENT_FELDER = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.INVOICE_PAYMENT_METHODS = exports.INVOICE_LANGUAGES = exports.EINVOICE_FORMATS = exports.DOC_TYPES = exports.INVOICE_LIST_STATUS = exports.CUSTOMER_TYPES = exports.VAT_RATES = exports.PRICE_MODES = exports.TAX_SCHEMES = exports.CREDIT_NOTE_REASONS = exports.INVOICE_ERROR_CODES = exports.RECHNUNG_AUFRUFE = exports.RECHNUNG_VERTRAG_VERSION = void 0;
 exports.RECHNUNG_VERTRAG_VERSION = 1;
 exports.RECHNUNG_AUFRUFE = [
     'createCustomer',
@@ -35,6 +35,7 @@ exports.RECHNUNG_AUFRUFE = [
     'getInvoiceXml',
     'getInvoiceSetupStatus',
     'listBrands',
+    'recordInvoicePayment',
 ];
 /**
  * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
@@ -60,6 +61,8 @@ exports.INVOICE_ERROR_CODES = [
     'invoice_setup_incomplete',
     'language_not_allowed',
     'brand_not_found',
+    'not_payable',
+    'payment_exceeds_invoice',
 ];
 /** Gruende einer Gutschrift. Der Server druckt den deutschen Anzeigetext. */
 exports.CREDIT_NOTE_REASONS = [
@@ -83,6 +86,18 @@ exports.EINVOICE_FORMATS = ['ubl', 'cii'];
  * oesterreichisch formatiert.
  */
 exports.INVOICE_LANGUAGES = ['de', 'en'];
+/**
+ * Wie eine Rechnung bezahlt wurde. Der Vermerk ist Buchhaltung, kein Beleg:
+ * `cash` wird gebucht, die Antwort traegt dann zusaetzlich den Hinweis
+ * `cash_receipt_required` — eine Barzahlung ist ein Barumsatz und braucht
+ * einen Beleg (§ 132a BAO), bei Registrierkassenpflicht ueber die Kasse.
+ */
+exports.INVOICE_PAYMENT_METHODS = ['transfer', 'card', 'online', 'cash'];
+/**
+ * Hinweise, die eine erfolgreiche Antwort zusaetzlich tragen kann (`data.notice`).
+ * Sie sind keine Fehler: der Aufruf hat gewirkt, es gibt nur etwas zu wissen.
+ */
+exports.INVOICE_NOTICE_CODES = ['cash_receipt_required'];
 /**
  * Einheiten einer Position. Die API nimmt nur diese Schluessel an; gedruckt
  * wird das Kuerzel in der Sprache der Rechnung (`RECHNUNG_TEXTE`,
@@ -264,6 +279,19 @@ exports.POSITION_FELDER = Object.freeze({
     discountPct: { typ: 'number', pflicht: false, min: 0, max: 100, nachkomma: 2 },
 });
 const positionen = { typ: 'list', pflicht: true, min: 1, max: 500, eintrag: { typ: 'object', pflicht: true, felder: exports.POSITION_FELDER } };
+/**
+ * Eine Zahlung zu einer Rechnung. Ohne `amountCents` gilt der volle
+ * Bruttobetrag, ohne `paidAt` der heutige Wiener Tag. `reference` ist die
+ * Zahlungskennung des Fremdsystems (z. B. `pi_3Q...`) — sie wird gespeichert,
+ * aber **nicht gedruckt**: die Rechnung wird aufbewahrt und vervielfaeltigt,
+ * und dem Empfaenger nuetzt sie nichts.
+ */
+exports.PAYMENT_FELDER = Object.freeze({
+    method: { typ: 'enum', pflicht: true, werte: exports.INVOICE_PAYMENT_METHODS },
+    amountCents: { typ: 'integer', pflicht: false, min: 1, max: 100_000_000 },
+    paidAt: datum(),
+    reference: text(100),
+});
 exports.RECHNUNG_ANFRAGEN = Object.freeze({
     createCustomer: {
         customer: { typ: 'object', pflicht: true, felder: exports.KUNDE_FELDER },
@@ -305,6 +333,12 @@ exports.RECHNUNG_ANFRAGEN = Object.freeze({
         language: { typ: 'enum', pflicht: false, werte: exports.INVOICE_LANGUAGES },
         /** Marke (Kennung aus `listBrands`); sonst die Standardmarke. */
         brandId: id,
+        /**
+         * Schon bezahlt: die Zahlung entsteht in **derselben** Transaktion wie das
+         * Festschreiben. Sonst gaebe es einen Moment, in dem die Rechnung offen ist
+         * und ein sofort geholtes PDF Zahlungsinformationen traegt.
+         */
+        payment: { typ: 'object', pflicht: false, felder: exports.PAYMENT_FELDER },
     },
     cancelInvoice: {
         idempotencyKey: idempotencyKey(true),
@@ -343,6 +377,14 @@ exports.RECHNUNG_ANFRAGEN = Object.freeze({
     },
     getInvoiceSetupStatus: {},
     listBrands: {},
+    recordInvoicePayment: {
+        idempotencyKey: idempotencyKey(true),
+        invoiceId: idPflicht,
+        method: { typ: 'enum', pflicht: true, werte: exports.INVOICE_PAYMENT_METHODS },
+        amountCents: { typ: 'integer', pflicht: false, min: 1, max: 100_000_000 },
+        paidAt: datum(),
+        reference: text(100),
+    },
 });
 /** Genau eines dieser Felder muss gesetzt sein (je Aufruf, je Gruppe). */
 exports.RECHNUNG_GENAU_EINS = Object.freeze({

package/dist/esm/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/esm/client/aufrufe.js

@@ -48,6 +48,7 @@ export const AUFRUFE = [
     'listRegisterUsersForDevice',
     'listRegisterSessionsForDevice',
     'pairRegisterDevice',
+    'recordInvoicePayment',
     'registerPinLogin',
     'registerUserLogin',
     'renewRegisterSession',

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, 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/esm/payments/hobex-hps/index.js

@@ -22,5 +22,5 @@ export { HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, H
 export { isHostUncertainResult, mayRetrySafely, } from './outcome.js';
 export { createHpsPayments, } from './payments.js';
 export { MAX_TRANSACTION_ID_LENGTH, createHpsTransactionIdGenerator, isValidHpsTransactionId, newHpsTransactionId, } 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, } 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, } from './transaction-response.js';
 export { hobexReceiptFromHps } from './receipt.js';

package/dist/esm/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/esm/payments/hobex-hps/payments.js

@@ -1,8 +1,13 @@
 import { HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsPreflightError, } from './errors.js';
 import { newHpsTransactionId } from './transaction-id.js';
-import { hpsCodeInfo, hpsCodeReason, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isHostUncertain, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, NOT_ABORTABLE_CODE, NOT_FOUND_CODE, TECHNICAL_ERROR_CODE, TRANSACTION_CANCELED_CODE, } from './transaction-response.js';
+import { hpsCodeInfo, hpsCodeReason, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isHostUncertain, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, needsReversal, NOT_ABORTABLE_CODE, NOT_FOUND_CODE, TECHNICAL_ERROR_CODE, TRANSACTION_CANCELED_CODE, } from './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;
 export function createHpsPayments(client, target, options = {}) {
     const resolveBudgetMs = options.resolveBudgetMs ?? 90_000;
     const maxBackoffMs = options.maxBackoffMs ?? 10_000;
@@ -11,6 +16,7 @@ export 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;
@@ -67,8 +73,12 @@ export function createHpsPayments(client, target, options = {}) {
         const info = 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
@@ -341,6 +351,37 @@ export 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 (!isApproved(res)) {
+            const titel = 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.
@@ -353,7 +394,7 @@ export 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;
@@ -362,6 +403,9 @@ export function createHpsPayments(client, target, options = {}) {
         // Statusabfrage sie nennt und danach 9027 kommt.
         let stoerungsAntwort = antwort && 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)
@@ -372,6 +416,13 @@ export 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 (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;
@@ -406,6 +457,24 @@ export function createHpsPayments(client, target, options = {}) {
             if (isHostUncertain(status))
                 stoerungsAntwort ??= status;
             const hostUngewiss = stoerungsAntwort !== undefined;
+            if (stornoGesendet && isCanceled(status)) {
+                steps.push(`Status: Zahlung aufgehoben (${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 && 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
@@ -607,7 +676,7 @@ export 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/esm/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[];