@kreiseck/kasseneck-api 0.27.2 → 0.27.3

package/CHANGELOG.md

@@ -4,6 +4,25 @@ 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.27.3
+
+- **`rechnungSummen` ist als veraltet markiert** (`@deprecated`), das Rechenergebnis bleibt
+  unverändert. Grund: seit dem 23.09.2026, 17:05 Uhr stellt der Server jede neue Rechnung über den
+  exakten Kern (`rechnungRechnen`) aus; `rechnungSummen` rechnet nach Weg 2 und liegt an
+  Halbcent-Grenzen einen Cent je Satz daneben (21,35 € netto zu 10 %: 23,48 € statt 23,49 €). Auf
+  den Kern umgestellt wird bewusst nicht: der Server schaltet ihn je Konto über `ganzzahlPflicht`,
+  Entwürfe außerhalb des Ausstellens rechnet er teils weiter nach Weg 2, und
+  `fixtures/rechnung-summen.json` prüfen Backend und Dart-Zwilling. Der Kopfkommentar behauptete
+  noch, die Funktion rechne „genau so wie der Server“; das ist berichtigt, README ebenso.
+- **`HpsRefundOptions`, `HpsCancelOptions`, `HpsConnectRefundOptions` und
+  `HpsConnectCancelOptions` werden unter `…/payments` exportiert** (nur hinzugefügt). Die Aufrufe
+  `refund`/`cancel` gab es dort schon, ihre Optionstypen nicht. Der Kopfkommentar von
+  `src/payments/index.ts` sagte noch, Gutschrift und Storno gingen nur über die Flutter-App; das
+  gilt seit Connect `/v1/terminal/refund` bzw. `/cancel` nicht mehr.
+- § 131b Abs. 1 Z 3 steht in der **BAO**, nicht im UStG: an `INVOICE_PAYMENT_METHODS` und
+  `PaymentInput.onSite` berichtigt (Wortlaut gegen das RIS geprüft). Ein Test hält künftig jede
+  Zuordnung von § 131 ff. zum UStG in `src/` fest.
+
 ## 0.27.2
 
 - **README auf Englisch** und jede Angabe gegen den Code geprüft. Anfragen kommen inzwischen auch

package/README.md

@@ -839,13 +839,14 @@ positive for credit notes too; the sign is in the document type
 (`docType: 'GU'`). Test cases: `fixtures/rechnung-rechnen.json`,
 `fixtures/rechnung-rechnen-zufall.json`, `fixtures/position-aus-euro.json`.
 
-**`rechnungSummen` still uses the previous formula.** The older helper in
-`…/rechnung` works on `unitPriceCents` lines and does not yet run through the
-core. At half-cent boundaries it can differ from an invoice issued today by
-one cent per VAT rate, and by a few cents across several rates. Example:
-€ 21.35 net at 10 % gives € 23.48 gross with `rechnungSummen`, but € 23.49
-with the core and on the invoice. Use `rechnungRechnen` or `previewInvoice` in
-new code. Test cases for the old formula: `fixtures/rechnung-summen.json`.
+**`rechnungSummen` is deprecated.** The older helper in `…/rechnung` works on
+`unitPriceCents` lines with the previous floating-point formula and does not
+run through the core. At half-cent boundaries it can differ from an invoice
+issued today by one cent per VAT rate, and by a few cents across several
+rates. Example: € 21.35 net at 10 % gives € 23.48 gross with `rechnungSummen`,
+but € 23.49 with the core and on the invoice. It stays unchanged for existing
+callers; use `rechnungRechnen` or `previewInvoice` in new code. Test cases for
+the old formula: `fixtures/rechnung-summen.json`.
 
 ## Development
 

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

@@ -22,9 +22,10 @@
  * Terminal spricht. Das ist kein Widerspruch zur Umgebungsgrenze, sondern ein
  * zweiter, seit `hobex-hps.js` genutzter Weg um sie herum.
  *
- * Wer Gutschrift oder Storno am HPS-Terminal braucht, braucht weiterhin die
- * Flutter-App: Connect exponiert dafuer (noch) keinen Endpunkt, siehe
- * `hobex-hps/connect-client.ts`.
+ * Gutschrift und Storno am HPS-Terminal laufen ebenfalls ueber Connect
+ * (`POST /v1/terminal/refund` bzw. `/cancel`): `HpsPayments.refund`/`cancel`
+ * mit `HpsRefundOptions`/`HpsCancelOptions`, darunter
+ * `HpsConnectClient.refund`/`cancel`, siehe `hobex-hps/connect-client.ts`.
  *
  * **Kassen-Benutzer-Weg (`registerUserAuth`, Browser-Kasse):** **Keiner** der
  * vier Cloud-Zahlungs-Endpunkte (Stripe, Hobex-Cloud) setzt `allowRegisterUser`;
@@ -42,4 +43,4 @@
 export { StripeLinkMode, type StripeLinkModeKey } from '../enums/index.js';
 export { type CreateStripeLinkOptions, type StripeCaptureResult, createStripeLink, stripeCaptureIntent, } from './stripe.js';
 export { type HobexPayOptions, type HobexRefundOptions, type HobexTransactionIdOptions, hobexPay, hobexRefund, newHobexTransactionId, } from './hobex.js';
-export { type CardPaymentOutcome, type HpsConnectClient, type HpsConnectClientOptions, type HpsConnectFetch, type HpsConnectFetchResponse, type HpsConnectPaymentOptions, type HpsConnectTarget, type HpsConnectTransactionOptions, type HpsCode, type HpsCodeEffect, type HpsCodeReason, type HpsCodeSource, type HpsMeasuredCode, type HpsPaymentEvent, type HpsPaymentEventKind, type HpsPaymentObserver, type HpsPaymentOptions, type HpsPayments, type HpsPaymentResult, type HpsPaymentsOptions, type HpsTransactionIdGeneratorOptions, type HpsTransactionResponse, ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, createHpsConnectClient, createHpsPayments, createHpsTransactionIdGenerator, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, hpsCodeInfo, hpsCodeReason, HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, INVALID_TRANSACTION_CODE, isApproved, isConclusive, isConclusiveAsStatus, isHostUncertain, isHostUncertainResult, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, isValidHpsTransactionId, mayRetrySafely, MAX_TRANSACTION_ID_LENGTH, newHpsTransactionId, NOT_ABORTABLE_CODE, NO_STATEMENT_CODE, parseHpsTransactionResponse, PREFLIGHT_CONNECT_CODES, TECHNICAL_ERROR_CODE, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, } from './hobex-hps/index.js';
+export { type CardPaymentOutcome, type HpsConnectClient, type HpsConnectCancelOptions, type HpsConnectClientOptions, type HpsConnectFetch, type HpsConnectFetchResponse, type HpsConnectPaymentOptions, type HpsConnectRefundOptions, type HpsConnectTarget, type HpsConnectTransactionOptions, type HpsCancelOptions, type HpsCode, type HpsCodeEffect, type HpsCodeReason, type HpsCodeSource, type HpsMeasuredCode, type HpsPaymentEvent, type HpsPaymentEventKind, type HpsPaymentObserver, type HpsPaymentOptions, type HpsPayments, type HpsPaymentResult, type HpsPaymentsOptions, type HpsRefundOptions, type HpsTransactionIdGeneratorOptions, type HpsTransactionResponse, ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, createHpsConnectClient, createHpsPayments, createHpsTransactionIdGenerator, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, hpsCodeInfo, hpsCodeReason, HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, INVALID_TRANSACTION_CODE, isApproved, isConclusive, isConclusiveAsStatus, isHostUncertain, isHostUncertainResult, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, isValidHpsTransactionId, mayRetrySafely, MAX_TRANSACTION_ID_LENGTH, newHpsTransactionId, NOT_ABORTABLE_CODE, NO_STATEMENT_CODE, parseHpsTransactionResponse, PREFLIGHT_CONNECT_CODES, TECHNICAL_ERROR_CODE, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, } from './hobex-hps/index.js';

package/dist/cjs/payments/index.js

@@ -23,9 +23,10 @@
  * Terminal spricht. Das ist kein Widerspruch zur Umgebungsgrenze, sondern ein
  * zweiter, seit `hobex-hps.js` genutzter Weg um sie herum.
  *
- * Wer Gutschrift oder Storno am HPS-Terminal braucht, braucht weiterhin die
- * Flutter-App: Connect exponiert dafuer (noch) keinen Endpunkt, siehe
- * `hobex-hps/connect-client.ts`.
+ * Gutschrift und Storno am HPS-Terminal laufen ebenfalls ueber Connect
+ * (`POST /v1/terminal/refund` bzw. `/cancel`): `HpsPayments.refund`/`cancel`
+ * mit `HpsRefundOptions`/`HpsCancelOptions`, darunter
+ * `HpsConnectClient.refund`/`cancel`, siehe `hobex-hps/connect-client.ts`.
  *
  * **Kassen-Benutzer-Weg (`registerUserAuth`, Browser-Kasse):** **Keiner** der
  * vier Cloud-Zahlungs-Endpunkte (Stripe, Hobex-Cloud) setzt `allowRegisterUser`;

package/dist/cjs/rechnung/summen.d.ts

@@ -1,7 +1,16 @@
 /**
- * Summen einer Rechnung vorab rechnen — genau so, wie der Server sie beim
- * Ausstellen rechnet. Fuer Shops, die kassieren, bevor die Rechnung entsteht,
- * und denselben Betrag brauchen, den die Rechnung spaeter ausweist.
+ * Summen einer Rechnung vorab rechnen, nach der frueheren Formel (Weg 2,
+ * Gleitkomma). Gedacht fuer Shops, die kassieren, bevor die Rechnung entsteht.
+ *
+ * **Veraltet.** Seit dem 23.09.2026, 17:05 Uhr stellt der Server jede neue
+ * Rechnung ueber den exakten Ganzzahl-Kern aus (`rechnungRechnen` in
+ * `…/rechnung/rechnen`). An Halbcent-Grenzen weicht diese Funktion davon um
+ * einen Cent je Satz ab (21,35 EUR netto zu 10 %: hier 23,48 EUR, auf der
+ * Rechnung 23,49 EUR). Die Formel bleibt trotzdem, wie sie ist: der Server
+ * schaltet den Kern je Konto ueber einen Schalter und rechnet Entwuerfe
+ * ausserhalb des Ausstellens teils weiter nach Weg 2, und Backend und
+ * Dart-Zwilling pruefen gegen `fixtures/rechnung-summen.json`. Neuer Code
+ * nimmt `rechnungRechnen` oder `previewInvoice`.
  *
  * Die Regel (je USt-Satz, Betraege in Cent, kaufmaennisch gerundet):
  *
@@ -38,5 +47,11 @@ export interface SummenPosition {
  * Server einen steuerfreien Fall ab (etwa eine ig. Lieferung), gehoert dieser
  * Fall hierher — sonst rechnet die Funktion Steuer, die die Rechnung nicht
  * ausweist.
+ *
+ * @deprecated Seit 0.27.3: rechnet nach der frueheren Formel (Weg 2) und kann
+ * an Halbcent-Grenzen um einen Cent je Satz von einer heute ausgestellten
+ * Rechnung abweichen. Stattdessen `rechnungRechnen` aus
+ * `@kreiseck/kasseneck-api/rechnung/rechnen` (Euro-Positionen ueber
+ * `positionAusEuro`) oder `previewInvoice` verwenden.
  */
 export declare function rechnungSummen(items: readonly SummenPosition[], priceMode: PriceMode, taxScheme?: TaxScheme): InvoiceTotals;

package/dist/cjs/rechnung/summen.js

@@ -1,8 +1,17 @@
 "use strict";
 /**
- * Summen einer Rechnung vorab rechnen — genau so, wie der Server sie beim
- * Ausstellen rechnet. Fuer Shops, die kassieren, bevor die Rechnung entsteht,
- * und denselben Betrag brauchen, den die Rechnung spaeter ausweist.
+ * Summen einer Rechnung vorab rechnen, nach der frueheren Formel (Weg 2,
+ * Gleitkomma). Gedacht fuer Shops, die kassieren, bevor die Rechnung entsteht.
+ *
+ * **Veraltet.** Seit dem 23.09.2026, 17:05 Uhr stellt der Server jede neue
+ * Rechnung ueber den exakten Ganzzahl-Kern aus (`rechnungRechnen` in
+ * `…/rechnung/rechnen`). An Halbcent-Grenzen weicht diese Funktion davon um
+ * einen Cent je Satz ab (21,35 EUR netto zu 10 %: hier 23,48 EUR, auf der
+ * Rechnung 23,49 EUR). Die Formel bleibt trotzdem, wie sie ist: der Server
+ * schaltet den Kern je Konto ueber einen Schalter und rechnet Entwuerfe
+ * ausserhalb des Ausstellens teils weiter nach Weg 2, und Backend und
+ * Dart-Zwilling pruefen gegen `fixtures/rechnung-summen.json`. Neuer Code
+ * nimmt `rechnungRechnen` oder `previewInvoice`.
  *
  * Die Regel (je USt-Satz, Betraege in Cent, kaufmaennisch gerundet):
  *
@@ -42,6 +51,12 @@ function centRund(x) {
  * Server einen steuerfreien Fall ab (etwa eine ig. Lieferung), gehoert dieser
  * Fall hierher — sonst rechnet die Funktion Steuer, die die Rechnung nicht
  * ausweist.
+ *
+ * @deprecated Seit 0.27.3: rechnet nach der frueheren Formel (Weg 2) und kann
+ * an Halbcent-Grenzen um einen Cent je Satz von einer heute ausgestellten
+ * Rechnung abweichen. Stattdessen `rechnungRechnen` aus
+ * `@kreiseck/kasseneck-api/rechnung/rechnen` (Euro-Positionen ueber
+ * `positionAusEuro`) oder `previewInvoice` verwenden.
  */
 function rechnungSummen(items, priceMode, taxScheme = 'normal') {
     const steuerfrei = rechnen_js_1.STEUERFREIE_FAELLE.includes(taxScheme);

package/dist/cjs/rechnung/typen.d.ts

@@ -133,7 +133,7 @@ export interface PaymentInput {
     reference?: string;
     /**
      * Die Zahlung erfolgte vor Ort beim Unternehmer (Terminal an der Kasse).
-     * Dann ist sie ein Barumsatz — auch mit Karte (§ 131b Abs. 1 Z 3 UStG) — und
+     * Dann ist sie ein Barumsatz — auch mit Karte (§ 131b Abs. 1 Z 3 BAO) — und
      * die Antwort traegt den Hinweis `cash_receipt_required`. Zu `transfer`
      * passt das Kennzeichen nicht und wird abgewiesen.
      */

package/dist/cjs/rechnung/vertrag.d.ts

@@ -130,7 +130,7 @@ export type InvoiceLanguage = (typeof INVOICE_LANGUAGES)[number];
  * Wie eine Rechnung bezahlt wurde. Der Vermerk ist Buchhaltung, kein Beleg.
  *
  * Ein **Barumsatz** ist nicht nur Bargeld: als Barzahlung gilt auch die Zahlung
- * mit Bankomat- oder Kreditkarte **vor Ort** (§ 131b Abs. 1 Z 3 UStG), nicht
+ * mit Bankomat- oder Kreditkarte **vor Ort** (§ 131b Abs. 1 Z 3 BAO), nicht
  * aber dieselbe Karte im Internet. Weil `card` und `online` beides sein
  * koennen, sagt das Feld `onSite` es dem Server — und nur dann traegt die
  * Antwort den Hinweis `cash_receipt_required` (bei `cash` immer).

package/dist/cjs/rechnung/vertrag.js

@@ -147,7 +147,7 @@ exports.INVOICE_LANGUAGES = ['de', 'en'];
  * Wie eine Rechnung bezahlt wurde. Der Vermerk ist Buchhaltung, kein Beleg.
  *
  * Ein **Barumsatz** ist nicht nur Bargeld: als Barzahlung gilt auch die Zahlung
- * mit Bankomat- oder Kreditkarte **vor Ort** (§ 131b Abs. 1 Z 3 UStG), nicht
+ * mit Bankomat- oder Kreditkarte **vor Ort** (§ 131b Abs. 1 Z 3 BAO), nicht
  * aber dieselbe Karte im Internet. Weil `card` und `online` beides sein
  * koennen, sagt das Feld `onSite` es dem Server — und nur dann traegt die
  * Antwort den Hinweis `cash_receipt_required` (bei `cash` immer).

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

@@ -22,9 +22,10 @@
  * Terminal spricht. Das ist kein Widerspruch zur Umgebungsgrenze, sondern ein
  * zweiter, seit `hobex-hps.js` genutzter Weg um sie herum.
  *
- * Wer Gutschrift oder Storno am HPS-Terminal braucht, braucht weiterhin die
- * Flutter-App: Connect exponiert dafuer (noch) keinen Endpunkt, siehe
- * `hobex-hps/connect-client.ts`.
+ * Gutschrift und Storno am HPS-Terminal laufen ebenfalls ueber Connect
+ * (`POST /v1/terminal/refund` bzw. `/cancel`): `HpsPayments.refund`/`cancel`
+ * mit `HpsRefundOptions`/`HpsCancelOptions`, darunter
+ * `HpsConnectClient.refund`/`cancel`, siehe `hobex-hps/connect-client.ts`.
  *
  * **Kassen-Benutzer-Weg (`registerUserAuth`, Browser-Kasse):** **Keiner** der
  * vier Cloud-Zahlungs-Endpunkte (Stripe, Hobex-Cloud) setzt `allowRegisterUser`;
@@ -42,4 +43,4 @@
 export { StripeLinkMode, type StripeLinkModeKey } from '../enums/index.js';
 export { type CreateStripeLinkOptions, type StripeCaptureResult, createStripeLink, stripeCaptureIntent, } from './stripe.js';
 export { type HobexPayOptions, type HobexRefundOptions, type HobexTransactionIdOptions, hobexPay, hobexRefund, newHobexTransactionId, } from './hobex.js';
-export { type CardPaymentOutcome, type HpsConnectClient, type HpsConnectClientOptions, type HpsConnectFetch, type HpsConnectFetchResponse, type HpsConnectPaymentOptions, type HpsConnectTarget, type HpsConnectTransactionOptions, type HpsCode, type HpsCodeEffect, type HpsCodeReason, type HpsCodeSource, type HpsMeasuredCode, type HpsPaymentEvent, type HpsPaymentEventKind, type HpsPaymentObserver, type HpsPaymentOptions, type HpsPayments, type HpsPaymentResult, type HpsPaymentsOptions, type HpsTransactionIdGeneratorOptions, type HpsTransactionResponse, ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, createHpsConnectClient, createHpsPayments, createHpsTransactionIdGenerator, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, hpsCodeInfo, hpsCodeReason, HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, INVALID_TRANSACTION_CODE, isApproved, isConclusive, isConclusiveAsStatus, isHostUncertain, isHostUncertainResult, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, isValidHpsTransactionId, mayRetrySafely, MAX_TRANSACTION_ID_LENGTH, newHpsTransactionId, NOT_ABORTABLE_CODE, NO_STATEMENT_CODE, parseHpsTransactionResponse, PREFLIGHT_CONNECT_CODES, TECHNICAL_ERROR_CODE, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, } from './hobex-hps/index.js';
+export { type CardPaymentOutcome, type HpsConnectClient, type HpsConnectCancelOptions, type HpsConnectClientOptions, type HpsConnectFetch, type HpsConnectFetchResponse, type HpsConnectPaymentOptions, type HpsConnectRefundOptions, type HpsConnectTarget, type HpsConnectTransactionOptions, type HpsCancelOptions, type HpsCode, type HpsCodeEffect, type HpsCodeReason, type HpsCodeSource, type HpsMeasuredCode, type HpsPaymentEvent, type HpsPaymentEventKind, type HpsPaymentObserver, type HpsPaymentOptions, type HpsPayments, type HpsPaymentResult, type HpsPaymentsOptions, type HpsRefundOptions, type HpsTransactionIdGeneratorOptions, type HpsTransactionResponse, ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, createHpsConnectClient, createHpsPayments, createHpsTransactionIdGenerator, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, hpsCodeInfo, hpsCodeReason, HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, INVALID_TRANSACTION_CODE, isApproved, isConclusive, isConclusiveAsStatus, isHostUncertain, isHostUncertainResult, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, isValidHpsTransactionId, mayRetrySafely, MAX_TRANSACTION_ID_LENGTH, newHpsTransactionId, NOT_ABORTABLE_CODE, NO_STATEMENT_CODE, parseHpsTransactionResponse, PREFLIGHT_CONNECT_CODES, TECHNICAL_ERROR_CODE, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, } from './hobex-hps/index.js';

package/dist/esm/payments/index.js

@@ -22,9 +22,10 @@
  * Terminal spricht. Das ist kein Widerspruch zur Umgebungsgrenze, sondern ein
  * zweiter, seit `hobex-hps.js` genutzter Weg um sie herum.
  *
- * Wer Gutschrift oder Storno am HPS-Terminal braucht, braucht weiterhin die
- * Flutter-App: Connect exponiert dafuer (noch) keinen Endpunkt, siehe
- * `hobex-hps/connect-client.ts`.
+ * Gutschrift und Storno am HPS-Terminal laufen ebenfalls ueber Connect
+ * (`POST /v1/terminal/refund` bzw. `/cancel`): `HpsPayments.refund`/`cancel`
+ * mit `HpsRefundOptions`/`HpsCancelOptions`, darunter
+ * `HpsConnectClient.refund`/`cancel`, siehe `hobex-hps/connect-client.ts`.
  *
  * **Kassen-Benutzer-Weg (`registerUserAuth`, Browser-Kasse):** **Keiner** der
  * vier Cloud-Zahlungs-Endpunkte (Stripe, Hobex-Cloud) setzt `allowRegisterUser`;

package/dist/esm/rechnung/summen.d.ts

@@ -1,7 +1,16 @@
 /**
- * Summen einer Rechnung vorab rechnen — genau so, wie der Server sie beim
- * Ausstellen rechnet. Fuer Shops, die kassieren, bevor die Rechnung entsteht,
- * und denselben Betrag brauchen, den die Rechnung spaeter ausweist.
+ * Summen einer Rechnung vorab rechnen, nach der frueheren Formel (Weg 2,
+ * Gleitkomma). Gedacht fuer Shops, die kassieren, bevor die Rechnung entsteht.
+ *
+ * **Veraltet.** Seit dem 23.09.2026, 17:05 Uhr stellt der Server jede neue
+ * Rechnung ueber den exakten Ganzzahl-Kern aus (`rechnungRechnen` in
+ * `…/rechnung/rechnen`). An Halbcent-Grenzen weicht diese Funktion davon um
+ * einen Cent je Satz ab (21,35 EUR netto zu 10 %: hier 23,48 EUR, auf der
+ * Rechnung 23,49 EUR). Die Formel bleibt trotzdem, wie sie ist: der Server
+ * schaltet den Kern je Konto ueber einen Schalter und rechnet Entwuerfe
+ * ausserhalb des Ausstellens teils weiter nach Weg 2, und Backend und
+ * Dart-Zwilling pruefen gegen `fixtures/rechnung-summen.json`. Neuer Code
+ * nimmt `rechnungRechnen` oder `previewInvoice`.
  *
  * Die Regel (je USt-Satz, Betraege in Cent, kaufmaennisch gerundet):
  *
@@ -38,5 +47,11 @@ export interface SummenPosition {
  * Server einen steuerfreien Fall ab (etwa eine ig. Lieferung), gehoert dieser
  * Fall hierher — sonst rechnet die Funktion Steuer, die die Rechnung nicht
  * ausweist.
+ *
+ * @deprecated Seit 0.27.3: rechnet nach der frueheren Formel (Weg 2) und kann
+ * an Halbcent-Grenzen um einen Cent je Satz von einer heute ausgestellten
+ * Rechnung abweichen. Stattdessen `rechnungRechnen` aus
+ * `@kreiseck/kasseneck-api/rechnung/rechnen` (Euro-Positionen ueber
+ * `positionAusEuro`) oder `previewInvoice` verwenden.
  */
 export declare function rechnungSummen(items: readonly SummenPosition[], priceMode: PriceMode, taxScheme?: TaxScheme): InvoiceTotals;

package/dist/esm/rechnung/summen.js

@@ -1,7 +1,16 @@
 /**
- * Summen einer Rechnung vorab rechnen — genau so, wie der Server sie beim
- * Ausstellen rechnet. Fuer Shops, die kassieren, bevor die Rechnung entsteht,
- * und denselben Betrag brauchen, den die Rechnung spaeter ausweist.
+ * Summen einer Rechnung vorab rechnen, nach der frueheren Formel (Weg 2,
+ * Gleitkomma). Gedacht fuer Shops, die kassieren, bevor die Rechnung entsteht.
+ *
+ * **Veraltet.** Seit dem 23.09.2026, 17:05 Uhr stellt der Server jede neue
+ * Rechnung ueber den exakten Ganzzahl-Kern aus (`rechnungRechnen` in
+ * `…/rechnung/rechnen`). An Halbcent-Grenzen weicht diese Funktion davon um
+ * einen Cent je Satz ab (21,35 EUR netto zu 10 %: hier 23,48 EUR, auf der
+ * Rechnung 23,49 EUR). Die Formel bleibt trotzdem, wie sie ist: der Server
+ * schaltet den Kern je Konto ueber einen Schalter und rechnet Entwuerfe
+ * ausserhalb des Ausstellens teils weiter nach Weg 2, und Backend und
+ * Dart-Zwilling pruefen gegen `fixtures/rechnung-summen.json`. Neuer Code
+ * nimmt `rechnungRechnen` oder `previewInvoice`.
  *
  * Die Regel (je USt-Satz, Betraege in Cent, kaufmaennisch gerundet):
  *
@@ -39,6 +48,12 @@ function centRund(x) {
  * Server einen steuerfreien Fall ab (etwa eine ig. Lieferung), gehoert dieser
  * Fall hierher — sonst rechnet die Funktion Steuer, die die Rechnung nicht
  * ausweist.
+ *
+ * @deprecated Seit 0.27.3: rechnet nach der frueheren Formel (Weg 2) und kann
+ * an Halbcent-Grenzen um einen Cent je Satz von einer heute ausgestellten
+ * Rechnung abweichen. Stattdessen `rechnungRechnen` aus
+ * `@kreiseck/kasseneck-api/rechnung/rechnen` (Euro-Positionen ueber
+ * `positionAusEuro`) oder `previewInvoice` verwenden.
  */
 export function rechnungSummen(items, priceMode, taxScheme = 'normal') {
     const steuerfrei = STEUERFREIE_FAELLE.includes(taxScheme);

package/dist/esm/rechnung/typen.d.ts

@@ -133,7 +133,7 @@ export interface PaymentInput {
     reference?: string;
     /**
      * Die Zahlung erfolgte vor Ort beim Unternehmer (Terminal an der Kasse).
-     * Dann ist sie ein Barumsatz — auch mit Karte (§ 131b Abs. 1 Z 3 UStG) — und
+     * Dann ist sie ein Barumsatz — auch mit Karte (§ 131b Abs. 1 Z 3 BAO) — und
      * die Antwort traegt den Hinweis `cash_receipt_required`. Zu `transfer`
      * passt das Kennzeichen nicht und wird abgewiesen.
      */

package/dist/esm/rechnung/vertrag.d.ts

@@ -130,7 +130,7 @@ export type InvoiceLanguage = (typeof INVOICE_LANGUAGES)[number];
  * Wie eine Rechnung bezahlt wurde. Der Vermerk ist Buchhaltung, kein Beleg.
  *
  * Ein **Barumsatz** ist nicht nur Bargeld: als Barzahlung gilt auch die Zahlung
- * mit Bankomat- oder Kreditkarte **vor Ort** (§ 131b Abs. 1 Z 3 UStG), nicht
+ * mit Bankomat- oder Kreditkarte **vor Ort** (§ 131b Abs. 1 Z 3 BAO), nicht
  * aber dieselbe Karte im Internet. Weil `card` und `online` beides sein
  * koennen, sagt das Feld `onSite` es dem Server — und nur dann traegt die
  * Antwort den Hinweis `cash_receipt_required` (bei `cash` immer).

package/dist/esm/rechnung/vertrag.js

@@ -144,7 +144,7 @@ export const INVOICE_LANGUAGES = ['de', 'en'];
  * Wie eine Rechnung bezahlt wurde. Der Vermerk ist Buchhaltung, kein Beleg.
  *
  * Ein **Barumsatz** ist nicht nur Bargeld: als Barzahlung gilt auch die Zahlung
- * mit Bankomat- oder Kreditkarte **vor Ort** (§ 131b Abs. 1 Z 3 UStG), nicht
+ * mit Bankomat- oder Kreditkarte **vor Ort** (§ 131b Abs. 1 Z 3 BAO), nicht
  * aber dieselbe Karte im Internet. Weil `card` und `online` beides sein
  * koennen, sagt das Feld `onSite` es dem Server — und nur dann traegt die
  * Antwort den Hinweis `cash_receipt_required` (bei `cash` immer).

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.27.2",
+  "version": "0.27.3",
   "gemessenAn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/kasse-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.27.2",
+  "version": "0.27.3",
   "meldungen": {
     "netz.keine_verbindung": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."

package/fixtures/oberflaeche.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.27.2",
+  "version": "0.27.3",
   "aufrufe": [
     "activateCashregister",
     "cancelInvoice",

package/fixtures/rechnung-api.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "Kasseneck Rechnungs-API",
   "version": 1,
-  "paket": "0.27.2",
+  "paket": "0.27.3",
   "aufrufe": {
     "createCustomer": {
       "anfrage": {

package/fixtures/rechnung-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.27.2",
+  "version": "0.27.3",
   "sprachen": [
     "de",
     "en"

package/package.json

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