@kreiseck/kasseneck-api 0.22.0 → 0.25.0

package/CHANGELOG.md

@@ -4,6 +4,56 @@ 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.25.0
+
+- ESC/POS: den Sofort-Reset der Ausrichtung direkt nach QR-Code, QR-Rasterbild und
+  Logo-Rasterbild entfernt. Er behandelte nur ein Symptom: seit 0.24.0 steht `ESC a`
+  ohnehin vor `ESC $`, und eine volle Zeile bekommt gar keinen Positionsbefehl mehr —
+  der Ausrichtungsbefehl des naechsten Elements steht damit selbst immer am
+  Zeilenanfang und gilt. Der erzeugte Bytestrom ist dadurch wieder deckungsgleich mit
+  dem Dart-Zwilling; bisher war dieser Reset der einzige Unterschied zwischen beiden.
+
+## 0.24.0
+
+- ESC/POS: `ESC a` steht vor `ESC $`, eine volle Zeile bekommt keinen Positionsbefehl mehr.
+  Der Drucker nimmt die Ausrichtung nur am Zeilenanfang an; bisher blieb nach dem QR-Code die
+  Zentrierung stehen und zentrierte jede Zeile darunter ein zweites Mal.
+
+## 0.23.0
+
+### Rechnung: der Rechenkern in ganzen Zahlen
+
+**Anlass:** Vier Umsetzungen (Server, dieses Paket, Dart, Panel) mussten dieselbe
+Reihenfolge von Gleitkomma-Schritten nachbauen, damit Grenzfälle gleich runden.
+Ein Cent Unterschied im Brutto-Modus hat das am 16.09.2026 sichtbar gemacht.
+
+- **Neu: Unterpfad `@kreiseck/kasseneck-api/rechnung/rechnen`** — rein, ohne
+  Transport, auch für den Browser. Darin:
+  - `rechnungRechnen(positionen, { priceMode, taxScheme })` rechnet exakt in
+    ganzen Zahlen (BigInt) und rundet einmal je USt-Satz. Preise in Millionstel
+    Euro, Mengen in Tausendstel, Rabatt und Satz in Hundertstel-Prozent.
+  - `positionAusEuro(item)` wandelt eine Euro-Position verlustfrei um oder
+    nennt Feld und Grund.
+  - `anteiligerPreis`, `satzSchluessel`, `satzText`, `preisText`.
+  - `RechenFehler` mit `code` (`amount_too_large`, `kein_ganzzahlwert`,
+    `ausserhalb`), Feld und Index.
+- **Prüffälle im Paket:** `fixtures/rechnung-rechnen.json` (20 Fälle von
+  Hand), `fixtures/rechnung-rechnen-zufall.json` (400 aus einer unabhängigen
+  Referenz in Python) und `fixtures/position-aus-euro.json`. Server,
+  Dart-Zwilling und Panel werden gegen dieselben Dateien prüfen.
+- **Fehlerkatalog um zwei Codes erweitert:** `einvoice_unavailable` (zu dieser
+  Rechnung entsteht keine E-Rechnung, Grund im `reason`) und
+  `amount_too_large` (Betrag über der Grenze des Ganzzahlkerns) — beide hinten
+  angehängt, damit gespeicherte Reihenfolgen gültig bleiben. Der Katalog geht
+  dem Server bewusst voraus, damit Fremdsysteme beide Codes behandeln können,
+  bevor der Server sie sendet; heute sendet der Server keinen von beiden,
+  `amount_too_large` erst ab dessen Umstieg auf den Ganzzahlkern.
+- **Unverändert:** `rechnungSummen`, `fixtures/rechnung-summen.json` und Form
+  von Anfrage und Antwort der Rechnungs-API — der Fehlerkatalog wächst nur
+  additiv (s. o.). Der Kern rundet an Halbcent-Grenzen richtig, `rechnungSummen`
+  rechnet weiterhin wie der Server heute; beides wird in 0.24.0
+  zusammengeführt. Wer schon vorab genau rechnen will, nimmt `previewInvoice`.
+
 ## 0.22.0
 
 ### Rechnung: Brutto bleibt Brutto, Hinweise kommen an, Probelauf

package/README.md

@@ -577,6 +577,37 @@ aufwärts), je Satz, dann summiert. Die Prüffälle liegen in
 `fixtures/rechnung-summen.json`. Die Summen sind auch bei Gutschriften positiv —
 das Vorzeichen steht im Belegtyp (`docType: 'GU'`).
 
+**Vorab rechnen, ohne Server.** `@kreiseck/kasseneck-api/rechnung/rechnen` ist
+der reine Rechenkern dahinter: kein Transport, kein Zugangsschlüssel, läuft
+auch im Browser (Panel). Er rechnet intern mit ganzen Zahlen (BigInt) statt
+Gleitkomma und rundet genau einmal je USt-Satz — Preise in Millionstel Euro
+(`unitPriceMicros`), Mengen in Tausendstel (`quantityMilli`), Rabatt und Satz
+in Hundertstel-Prozent (`discountBp`, `vatRateBp`):
+
+```ts
+import { rechnungRechnen } from '@kreiseck/kasseneck-api/rechnung/rechnen';
+
+rechnungRechnen(
+  [{ unitPriceMicros: 14_790_000, quantityMilli: 1000, vatRateBp: 2000 }],
+  { priceMode: 'gross' },
+);
+// { netCents: 1233, vatCents: 246, grossCents: 1479, byRate: [{ rateBp: 2000, … }], lines: […] }
+```
+
+`positionAusEuro(item)` wandelt eine Euro-Position (`unitPrice`, `quantity`,
+`vatRate`, `discountPct`) verlustfrei in diese Form um oder nennt Feld und
+Grund, wenn das nicht geht. Die Prüffälle liegen in
+`fixtures/rechnung-rechnen.json`, `fixtures/rechnung-rechnen-zufall.json` und
+`fixtures/position-aus-euro.json`. **Noch nicht zusammengeführt** mit
+`rechnungSummen`: bis 0.24.0 rechnen beide parallel und weichen an
+Halbcent-Grenzen bewusst voneinander ab — **je USt-Satz** bis zu 1 Cent bei
+einmal gerundeten Werten (Netto und USt im Netto-Modus, Brutto im
+Brutto-Modus) und bis zu 2 Cent bei abgeleiteten (Summe zweier Rundungen). Bei
+mehreren Sätzen summiert sich das: eine Rechnung über drei Sätze kann deshalb
+3 Cent auseinanderliegen. Der Kern rundet dort richtig, `rechnungSummen`
+rechnet weiterhin wie der Server heute. Verbindlich
+für den ausgewiesenen Betrag bleibt bis dahin `previewInvoice`.
+
 **Hinweise** (`notice`) sind immer eine Liste — bei `issueInvoice`,
 `previewInvoice` und `recordInvoicePayment`. Eine ig. Lieferung trägt
 `recapitulative_statement_due` (Zusammenfassende Meldung), eine bar bezahlte
@@ -621,6 +652,7 @@ gegen genau diese Datei.
 | `…/kasse` | Kachel-Kasse: Kassen-Einstellungen (betriebsweit / je Gerät), Artikelgruppen und Artikel für Kacheln, Rabattverteilung je Steuersatz, Reichweiten der Kassen-Rechte |
 | `…/partner` | Partner-API: Betriebe anlegen, FinanzOnline-Link, Signatur, Kassen, Zugangsdaten, Webhooks samt Signaturprüfung. **Gehört auf einen Server.** |
 | `…/rechnung` | Rechnungs-API: Kunden anlegen und suchen, Rechnungen festgeschrieben ausstellen, Gutschrift und Storno, PDF und E-Rechnung-XML; der Vertrag als Daten. **Gehört auf einen Server.** |
+| `…/rechnung/rechnen` | Reiner Rechenkern für Rechnungssummen (Ganzzahlen, kein Transport, keine Abhängigkeit außer Typen) — darf auch im Browser laufen. |
 | `…/react` | Dünner React-Adapter, der ein Beleg-Layout zeichnet. Braucht React. |
 | `…/fixtures/*` | Golden-Belege (JSON): Eingaben `belege/<name>.json`, zugesagte Zeilenausgabe `erwartet/<name>.lines.json`, `manifest.json` mit Prüfsummen — dieselben Dateien prüfen Backend, Browser-Kasse und Flutter-Paket. |
 

package/dist/cjs/printing/escpos.d.ts

@@ -208,10 +208,6 @@ export declare function escPosSetGlobalFont(doc: EscPosDocument, font: PosFont |
  * weglaesst, schaltet fett also ab.
  */
 export declare function escPosSetStyles(doc: EscPosDocument, styles?: PosStyles): void;
-/**
- * Interner Textdruck: absolute Position setzen (`ESC $`), Stil senden, Bytes
- * ausgeben. [colInd]/[colWidth] beschreiben die Spalte im Zwoelftel-Raster.
- */
 /**
  * Wortweiser Umbruch von (kodierten) Text-Bytes auf hoechstens `max` Zeichen
  * je Zeile: geschnitten wird am letzten Leerzeichen innerhalb der Grenze

package/dist/cjs/printing/escpos.js

@@ -344,10 +344,6 @@ function escPosSetStyles(doc, styles = {}) {
         alt.codeTable = codepage;
     }
 }
-/**
- * Interner Textdruck: absolute Position setzen (`ESC $`), Stil senden, Bytes
- * ausgeben. [colInd]/[colWidth] beschreiben die Spalte im Zwoelftel-Raster.
- */
 /**
  * Wortweiser Umbruch von (kodierten) Text-Bytes auf hoechstens `max` Zeichen
  * je Zeile: geschnitten wird am letzten Leerzeichen innerhalb der Grenze
@@ -449,27 +445,38 @@ function wortzeilenText(text, max) {
     out.push(rest.replace(/\u00a0/g, ' '));
     return out;
 }
+/**
+ * Interner Textdruck: Stil senden (Ausrichtung zuerst), absolute Position
+ * setzen (`ESC $`, ausser bei einer vollen Zeile), Bytes ausgeben. [colInd]/
+ * [colWidth] beschreiben die Spalte im Zwoelftel-Raster.
+ */
 function textIntern(doc, textBytes, optionen = {}) {
     const stile = vollstaendigeStile(optionen.styles);
     const colInd = optionen.colInd ?? 0;
     const colWidth = optionen.colWidth ?? 12;
-    const breiteJeZeichen = zeichenBreite(doc, stile);
-    let von = spaltenPosition(doc, colInd);
-    if (colWidth !== 12) {
-        const bis = spaltenPosition(doc, colInd + colWidth) - doc.spaceBetweenRows;
-        const textLaenge = textBytes.length * breiteJeZeichen;
-        if (stile.align === 'right') {
-            von = bis - textLaenge;
-        }
-        else if (stile.align === 'center') {
-            von = von + (bis - von) / 2 - textLaenge / 2;
+    // Ausrichtung vor Position -- `ESC a` gilt nur am Zeilenanfang, nach `ESC $`
+    // verwirft der Drucker ihn. Zwilling von `_text` in generator.dart.
+    escPosSetStyles(doc, optionen.styles);
+    // Eine volle Zeile beginnt am linken Rand; ein Positionsbefehl dafuer waere
+    // nicht nur ueberfluessig, er entwertet die Ausrichtung.
+    if (!(colInd === 0 && colWidth === 12)) {
+        const breiteJeZeichen = zeichenBreite(doc, stile);
+        let von = spaltenPosition(doc, colInd);
+        if (colWidth !== 12) {
+            const bis = spaltenPosition(doc, colInd + colWidth) - doc.spaceBetweenRows;
+            const textLaenge = textBytes.length * breiteJeZeichen;
+            if (stile.align === 'right') {
+                von = bis - textLaenge;
+            }
+            else if (stile.align === 'center') {
+                von = von + (bis - von) / 2 - textLaenge / 2;
+            }
+            if (von < 0)
+                von = 0;
         }
-        if (von < 0)
-            von = 0;
+        const position = runden(von);
+        anhaengen(doc, [...C_POS, position & 0xff, (position >> 8) & 0xff]);
     }
-    const position = runden(von);
-    anhaengen(doc, [...C_POS, position & 0xff, (position >> 8) & 0xff]);
-    escPosSetStyles(doc, optionen.styles);
     anhaengen(doc, textBytes);
 }
 /**
@@ -706,13 +713,6 @@ function escPosQrCode(doc, text, options = {}) {
     }
     if (drucken)
         anhaengen(doc, qrCodeBytes(text, qrOptionen));
-    // Ausrichtung SOFORT zuruecksetzen: `ESC a` gilt nur am Zeilenanfang. Die
-    // Spalten-Positionierung (`ESC $`) schickt ihren Reset sonst mitten in der
-    // Zeile — Epson ignoriert ihn, und alles nach dem QR rueckte nach rechts
-    // (belegt am TM-T20, 2026-08-20).
-    if ((options.align ?? 'center') !== 'left') {
-        escPosSetStyles(doc, { align: 'left' });
-    }
 }
 /**
  * Der Bildweg: ein fertiges QR-Raster als Rasterbild (`GS v 0`) — der
@@ -770,9 +770,6 @@ function escPosQrRaster(doc, matrix, options = {}) {
     anhaengen(doc, rasterBildKopf(breite, breite));
     anhaengen(doc, daten);
     anhaengen(doc, [ZEILENUMBRUCH]);
-    if ((options.align ?? 'center') !== 'left') {
-        escPosSetStyles(doc, { align: 'left' });
-    }
 }
 /**
  * Punkte je Modul, mit denen `escPosQrRaster` ein Raster dieser Groesse auf
@@ -845,7 +842,4 @@ function escPosRasterBild(doc, bild, options = {}) {
     escPosSetStyles(doc, { align: options.align ?? 'center' });
     anhaengen(doc, rasterBildKopf(bild.breite, bild.hoehe));
     anhaengen(doc, daten);
-    if ((options.align ?? 'center') !== 'left') {
-        escPosSetStyles(doc, { align: 'left' });
-    }
 }

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

@@ -17,4 +17,5 @@ export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoic
 export type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceSetupGap, InvoiceSetupStatus, InvoiceTotals, InvoiceNotice, InvoicePayment, InvoicePreview, InvoiceRateTotals, IssueInvoiceRequest, IssueResult, PaymentInput, PreviewResult, RecordPaymentRequest, RecordPaymentResult, } from './typen.js';
 export { RECHNUNG_TEXTE, rechnungText, type RechnungTextSchluessel } from './texte.js';
 export { rechnungSummen, STEUERFREIE_FAELLE, type SummenPosition } from './summen.js';
+export { anteiligerPreis, BETRAG_GRENZE_CENTS, positionAusEuro, preisText, RechenFehler, rechnungRechnen, rund, satzSchluessel, satzText, type RechenErgebnis, type RechenFehlerCode, type RechenOptionen, type RechenPosition, type SatzSumme, type Umwandlung, type UmwandlungsGrund, type ZeilenBetrag, } from './rechnen.js';
 export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, INVOICE_LANGUAGES, INVOICE_PAYMENT_METHODS, ITEM_KINDS, REVERSE_CHARGE_REASONS, INVOICE_NOTICE_CODES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, type RechnungAufruf, type InvoiceErrorCode, type CreditNoteReason, type TaxScheme, type PriceMode, type VatRatePercent, type CustomerType, type InvoiceListStatus, type DocType, type EInvoiceFormat, type InvoiceLanguage, type InvoicePaymentMethod, type ItemKind, type ReverseChargeReason, type InvoiceNoticeCode, type InvoiceUnit, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.js';

package/dist/cjs/rechnung/index.js

@@ -12,7 +12,8 @@
  * Benutzung des Clients.
  */
 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_NOTICE_CODES = exports.REVERSE_CHARGE_REASONS = exports.ITEM_KINDS = 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 = exports.STEUERFREIE_FAELLE = exports.rechnungSummen = exports.rechnungText = exports.RECHNUNG_TEXTE = exports.updateCustomer = exports.searchCustomers = exports.recordInvoicePayment = exports.previewInvoice = exports.listInvoices = exports.listBrands = exports.issueInvoice = exports.getInvoiceXml = exports.getInvoiceSetupStatus = exports.getInvoicePdf = exports.getInvoice = exports.getCustomer = exports.createCustomer = exports.createCreditNote = exports.cancelInvoice = exports.rechnungFeldFehler = exports.rechnungFehlerCode = exports.istRechnungFehler = exports.rechnungKeyAuth = exports.createRechnungApi = void 0;
+exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.REVERSE_CHARGE_REASONS = exports.ITEM_KINDS = 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 = exports.satzText = exports.satzSchluessel = exports.rund = exports.rechnungRechnen = exports.RechenFehler = exports.preisText = exports.positionAusEuro = exports.BETRAG_GRENZE_CENTS = exports.anteiligerPreis = exports.STEUERFREIE_FAELLE = exports.rechnungSummen = exports.rechnungText = exports.RECHNUNG_TEXTE = exports.updateCustomer = exports.searchCustomers = exports.recordInvoicePayment = exports.previewInvoice = exports.listInvoices = exports.listBrands = exports.issueInvoice = exports.getInvoiceXml = exports.getInvoiceSetupStatus = exports.getInvoicePdf = exports.getInvoice = exports.getCustomer = exports.createCustomer = exports.createCreditNote = exports.cancelInvoice = exports.rechnungFeldFehler = exports.rechnungFehlerCode = exports.istRechnungFehler = exports.rechnungKeyAuth = exports.createRechnungApi = void 0;
+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 = void 0;
 var api_js_1 = require("./api.js");
 Object.defineProperty(exports, "createRechnungApi", { enumerable: true, get: function () { return api_js_1.createRechnungApi; } });
 var auth_js_1 = require("./auth.js");
@@ -43,6 +44,16 @@ Object.defineProperty(exports, "rechnungText", { enumerable: true, get: function
 var summen_js_1 = require("./summen.js");
 Object.defineProperty(exports, "rechnungSummen", { enumerable: true, get: function () { return summen_js_1.rechnungSummen; } });
 Object.defineProperty(exports, "STEUERFREIE_FAELLE", { enumerable: true, get: function () { return summen_js_1.STEUERFREIE_FAELLE; } });
+var rechnen_js_1 = require("./rechnen.js");
+Object.defineProperty(exports, "anteiligerPreis", { enumerable: true, get: function () { return rechnen_js_1.anteiligerPreis; } });
+Object.defineProperty(exports, "BETRAG_GRENZE_CENTS", { enumerable: true, get: function () { return rechnen_js_1.BETRAG_GRENZE_CENTS; } });
+Object.defineProperty(exports, "positionAusEuro", { enumerable: true, get: function () { return rechnen_js_1.positionAusEuro; } });
+Object.defineProperty(exports, "preisText", { enumerable: true, get: function () { return rechnen_js_1.preisText; } });
+Object.defineProperty(exports, "RechenFehler", { enumerable: true, get: function () { return rechnen_js_1.RechenFehler; } });
+Object.defineProperty(exports, "rechnungRechnen", { enumerable: true, get: function () { return rechnen_js_1.rechnungRechnen; } });
+Object.defineProperty(exports, "rund", { enumerable: true, get: function () { return rechnen_js_1.rund; } });
+Object.defineProperty(exports, "satzSchluessel", { enumerable: true, get: function () { return rechnen_js_1.satzSchluessel; } });
+Object.defineProperty(exports, "satzText", { enumerable: true, get: function () { return rechnen_js_1.satzText; } });
 var vertrag_js_1 = require("./vertrag.js");
 Object.defineProperty(exports, "RECHNUNG_VERTRAG_VERSION", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_VERTRAG_VERSION; } });
 Object.defineProperty(exports, "RECHNUNG_AUFRUFE", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_AUFRUFE; } });

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

@@ -0,0 +1,123 @@
+/**
+ * Der Rechenkern der Rechnung — exakt, in ganzen Zahlen.
+ *
+ * Eine Zeile ist ein Bruch: Preis (µ€) × Menge (Tausendstel) × Rabattanteil
+ * (Hundertstel-Prozent). Multipliziert man die Skalen, ist die kleinste Einheit
+ * 10⁻¹⁷ Cent — das passt in keine Gleitkommazahl und in keine 53-Bit-Ganzzahl,
+ * also rechnet der Kern mit BigInt. Gerundet wird genau EINMAL je USt-Satz, auf
+ * dem Bruch, kaufmaennisch (halbe Einheit vom Nullpunkt weg).
+ *
+ * Warum das so streng ist: Vier Umsetzungen (Server, dieses Paket, Dart, Panel)
+ * mussten bisher dieselbe Reihenfolge von Gleitkomma-Schritten nachbauen, damit
+ * Grenzfaelle gleich runden. Mit Ganzzahlen gibt es keine Reihenfolge mehr, an
+ * der etwas auseinanderlaufen koennte.
+ *
+ * Dieser Unterpfad ist rein: kein Transport, kein Zugangsschluessel, keine
+ * Abhaengigkeit ausser Typen. Er wird im Browser gebuendelt (Panel) und im
+ * Server geladen.
+ *
+ * Spec: docs/specs/2026-09-17-rechnung-ganzzahlen-design.md § 5.
+ */
+import type { PriceMode, TaxScheme } from './vertrag.js';
+/** Hoechster Betrag je Zeile und je Rechnung: 999.999.999,99 €. */
+export declare const BETRAG_GRENZE_CENTS = 99999999999;
+/** Steuerfaelle, in denen die Rechnung keine Steuer ausweist: jede Zeile zaehlt zu 0 %. */
+export declare const STEUERFREIE_FAELLE: readonly TaxScheme[];
+/** Eine Position in gespeicherter Form — alle Werte ganzzahlig. */
+export interface RechenPosition {
+    /** Einzelpreis in Millionstel Euro, 0 … 10¹². */
+    unitPriceMicros: number;
+    /** Menge in Tausendstel; negativ = Abzugszeile, 0 = Textzeile. */
+    quantityMilli: number;
+    /** Rabatt in Hundertstel-Prozent, 0 … 10000 (ohne Angabe 0). */
+    discountBp?: number;
+    /** USt-Satz in Hundertstel-Prozent, 0 … 10000 (ohne Angabe 0). */
+    vatRateBp?: number;
+}
+export interface RechenOptionen {
+    priceMode: PriceMode;
+    /** Ohne Angabe `normal`. */
+    taxScheme?: TaxScheme;
+}
+export interface SatzSumme {
+    rateBp: number;
+    netCents: number;
+    vatCents: number;
+    grossCents: number;
+}
+export interface ZeilenBetrag {
+    netCents: number;
+    grossCents: number;
+    /** Der Satz, mit dem die Zeile gerechnet wurde (bei steuerfreiem Fall 0). */
+    rateBp: number;
+}
+export interface RechenErgebnis {
+    netCents: number;
+    vatCents: number;
+    grossCents: number;
+    /** Absteigend nach `rateBp`. */
+    byRate: SatzSumme[];
+    /** Je Position, in der Reihenfolge der Eingabe. */
+    lines: ZeilenBetrag[];
+}
+export type RechenFehlerCode = 'amount_too_large' | 'kein_ganzzahlwert' | 'ausserhalb';
+/** Fehler des Kerns — mit Code, Feld und Index, damit die API daraus einen Feldfehler machen kann. */
+export declare class RechenFehler extends Error {
+    readonly code: RechenFehlerCode;
+    readonly feld?: string;
+    readonly index?: number;
+    constructor(code: RechenFehlerCode, nachricht: string, feld?: string, index?: number);
+}
+/**
+ * `a / b` kaufmaennisch gerundet, halbe Einheit vom Nullpunkt weg; `b` > 0.
+ *
+ * Ohne Gleitkomma: `(2·|a| + b) / (2·b)` ist genau dann eins groesser, wenn der
+ * Rest mindestens die halbe Einheit betraegt.
+ */
+export declare function rund(a: bigint, b: bigint): bigint;
+export declare function rechnungRechnen(positionen: readonly RechenPosition[], optionen: RechenOptionen): RechenErgebnis;
+export type UmwandlungsGrund = 'kein_zahlwert' | 'nachkommastellen' | 'ausserhalb';
+export type Umwandlung = {
+    ok: true;
+    position: RechenPosition & Record<string, unknown>;
+} | {
+    ok: false;
+    feld: 'unitPrice' | 'quantity' | 'vatRate' | 'discountPct';
+    grund: UmwandlungsGrund;
+};
+/**
+ * Euro-Position → Ganzzahl-Form, verlustfrei oder mit Grund abgelehnt. Die
+ * EINE Stelle, die das tut: Panel (beim Lesen), SEPA-Lauf, Umrechnungsskript
+ * und das Festschreiben benutzen alle diese Funktion, damit niemand eine
+ * zweite Auslegung baut.
+ *
+ * Eine Position, die schon `unitPriceMicros` traegt, kommt unveraendert
+ * zurueck — die Funktion ist die Formweiche, nicht eine blinde Umrechnung.
+ *
+ * Fehlende Menge und fehlender Satz gelten als 0, weil der Server bisher so
+ * abgerechnet hat. Ein fehlender Preis dagegen ist NIE 0: sonst wuerde eine
+ * Position, der nur der Preis fehlt, still zur 0-€-Zeile.
+ */
+export declare function positionAusEuro(item: Record<string, unknown>): Umwandlung;
+/**
+ * Anteiliger Preis fuer einen Teilzeitraum (erste Rechnung eines Abos).
+ * War der Ursprungspreis centgenau, bleibt auch der Anteil centgenau — sonst
+ * stuende auf der ersten Rechnung ein Preis mit sechs Stellen, wo bisher zwei
+ * standen.
+ */
+export declare function anteiligerPreis(unitPriceMicros: number, monate: number, intervall: number): number;
+/**
+ * Schluessel eines USt-Satzes in den gespeicherten Maps (`creditedCents.byRate`,
+ * `invoice_stats.vatByRate`): der Prozenttext mit Punkt, genau wie
+ * `String(satz)` ihn bisher gebildet hat. NICHT fuer die Anzeige — dafuer gibt
+ * es `satzText`.
+ */
+export declare function satzSchluessel(rateBp: number): string;
+/** Ein USt-Satz fuer die Anzeige: oesterreichisch mit Komma, ohne nachlaufende Nullen. */
+export declare function satzText(rateBp: number): string;
+/**
+ * Ein Einzelpreis fuer die Anzeige: mindestens zwei, hoechstens sechs
+ * Nachkommastellen, Tausenderpunkt, Komma als Trennzeichen — in jeder Sprache
+ * oesterreichisch, wie die Betraege auf dem Blatt.
+ */
+export declare function preisText(unitPriceMicros: number): string;