@kreiseck/kasseneck-api 0.31.0 → 1.0.0-rc.2

package/dist/esm/{rechnung → invoice}/endpunkte.js

@@ -2,7 +2,7 @@
  * Die Aufrufe der Rechnungs-API — Kunden, Rechnungen, Gutschriften, Dateien.
  *
  * Jede Funktion nimmt den Transport als ersten Parameter und ist einzeln
- * importierbar; die Fassade [createRechnungApi] bindet ihn nur einmal.
+ * importierbar; die Fassade [createInvoiceApi] bindet ihn nur einmal.
  *
  * **Geprueft wird hier nichts Fachliches.** Die Anfrage geht unveraendert an
  * das Backend, das sie gegen denselben Vertrag prueft (`vertrag.ts`) und einen
@@ -17,6 +17,7 @@
  * der Aufruf `KasseneckValidationError` mit `scope:'response'`.
  */
 import { KasseneckValidationError } from '../client/errors.js';
+import { EINVOICE_FORMATS } from './vertrag.js';
 function objekt(wert) {
     return wert !== null && typeof wert === 'object' && !Array.isArray(wert)
         ? wert
@@ -69,30 +70,30 @@ function kennungVerlangen(aufruf, kennung, felder) {
 /** Anfrageobjekt als Nutzlast — flache Kopie, damit der Aufrufer sein Objekt behaelt. */
 const nutzlast = (anfrage) => ({ ...anfrage });
 // ---- Kunden -----------------------------------------------------------------
-export async function createCustomer(rufen, customer, optionen = {}) {
+export async function createCustomer(transport, customer, options = {}) {
     const params = { customer };
-    if (optionen.idempotencyKey)
-        params['idempotencyKey'] = optionen.idempotencyKey;
-    const daten = await rufen('createCustomer', params);
+    if (options.idempotencyKey)
+        params['idempotencyKey'] = options.idempotencyKey;
+    const daten = await transport('createCustomer', params);
     return pflichtObjekt('createCustomer', daten, 'customer');
 }
-export async function getCustomer(rufen, kennung) {
-    kennungVerlangen('getCustomer', kennung, '{ customerId } oder { externalId }');
-    const daten = await rufen('getCustomer', nutzlast(kennung));
+export async function getCustomer(transport, ref) {
+    kennungVerlangen('getCustomer', ref, '{ customerId } oder { externalId }');
+    const daten = await transport('getCustomer', nutzlast(ref));
     return pflichtObjekt('getCustomer', daten, 'customer');
 }
-export async function updateCustomer(rufen, customerId, patch) {
-    const daten = await rufen('updateCustomer', { customerId, customer: patch });
+export async function updateCustomer(transport, customerId, patch) {
+    const daten = await transport('updateCustomer', { customerId, customer: patch });
     return pflichtObjekt('updateCustomer', daten, 'customer');
 }
-export async function searchCustomers(rufen, suche) {
-    const daten = await rufen('searchCustomers', nutzlast(suche));
+export async function searchCustomers(transport, search) {
+    const daten = await transport('searchCustomers', nutzlast(search));
     const { eintraege, nextCursor } = seite('searchCustomers', daten, 'customers');
     return { customers: eintraege, nextCursor };
 }
 // ---- Rechnungen -------------------------------------------------------------
-export async function issueInvoice(rufen, anfrage) {
-    const daten = await rufen('issueInvoice', nutzlast(anfrage));
+export async function issueInvoice(transport, request) {
+    const daten = await transport('issueInvoice', nutzlast(request));
     const ergebnis = {
         invoice: pflichtObjekt('issueInvoice', daten, 'invoice'),
         replayed: objekt(daten)['replayed'] === true,
@@ -112,16 +113,16 @@ export async function issueInvoice(rufen, anfrage) {
  * danach unveraendert ausstellen. Verbindlich ist das Ausstellen — zwischen
  * Probelauf und Ausstellen kann sich der Kunde oder das Konto aendern.
  */
-export async function previewInvoice(rufen, anfrage) {
-    const daten = await rufen('issueInvoice', { ...nutzlast(anfrage), dryRun: true });
+export async function previewInvoice(transport, request) {
+    const daten = await transport('issueInvoice', { ...nutzlast(request), dryRun: true });
     const ergebnis = { preview: pflichtObjekt('issueInvoice', daten, 'preview') };
     const notice = hinweise(daten);
     if (notice)
         ergebnis.notice = notice;
     return ergebnis;
 }
-export async function cancelInvoice(rufen, anfrage) {
-    const daten = await rufen('cancelInvoice', nutzlast(anfrage));
+export async function cancelInvoice(transport, request) {
+    const daten = await transport('cancelInvoice', nutzlast(request));
     return {
         creditNote: pflichtObjekt('cancelInvoice', daten, 'creditNote'),
         original: pflichtObjekt('cancelInvoice', daten, 'original'),
@@ -129,21 +130,21 @@ export async function cancelInvoice(rufen, anfrage) {
         replayed: objekt(daten)['replayed'] === true,
     };
 }
-export async function createCreditNote(rufen, anfrage) {
-    const daten = await rufen('createCreditNote', nutzlast(anfrage));
+export async function createCreditNote(transport, request) {
+    const daten = await transport('createCreditNote', nutzlast(request));
     return {
         creditNote: pflichtObjekt('createCreditNote', daten, 'creditNote'),
         remainingCents: zahl(objekt(daten)['remainingCents']),
         replayed: objekt(daten)['replayed'] === true,
     };
 }
-export async function getInvoice(rufen, kennung) {
-    kennungVerlangen('getInvoice', kennung, '{ invoiceId } oder { number }');
-    const daten = await rufen('getInvoice', nutzlast(kennung));
+export async function getInvoice(transport, ref) {
+    kennungVerlangen('getInvoice', ref, '{ invoiceId } oder { number }');
+    const daten = await transport('getInvoice', nutzlast(ref));
     return pflichtObjekt('getInvoice', daten, 'invoice');
 }
-export async function listInvoices(rufen, abfrage = {}) {
-    const daten = await rufen('listInvoices', nutzlast(abfrage));
+export async function listInvoices(transport, query = {}) {
+    const daten = await transport('listInvoices', nutzlast(query));
     const { eintraege, nextCursor } = seite('listInvoices', daten, 'invoices');
     return { invoices: eintraege, nextCursor };
 }
@@ -153,8 +154,8 @@ export async function listInvoices(rufen, abfrage = {}) {
  * ohne Freigabe und vor der Live-Freischaltung — genau dann braucht man die
  * Antwort. Vor dem ersten `issueInvoice` aufrufen und `missing` anzeigen.
  */
-export async function getInvoiceSetupStatus(rufen) {
-    const daten = objekt(await rufen('getInvoiceSetupStatus', {}));
+export async function getInvoiceSetupStatus(transport) {
+    const daten = objekt(await transport('getInvoiceSetupStatus', {}));
     if (typeof daten['ready'] !== 'boolean' || !Array.isArray(daten['missing'])) {
         throw new KasseneckValidationError('getInvoiceSetupStatus', 'Antwort ohne ready/missing', 'response');
     }
@@ -171,11 +172,11 @@ export async function getInvoiceSetupStatus(rufen) {
  * eine **Uebersetzungskopie**: dieselbe Nummer, auf jeder Seite als Uebersetzung
  * gekennzeichnet, ohne eingebettete E-Rechnung — keine eigene Rechnung.
  */
-export function getInvoicePdf(rufenBinaer, invoiceId, optionen = {}) {
+export function getInvoicePdf(binaryTransport, invoiceId, options = {}) {
     const params = { invoiceId };
-    if (optionen.language)
-        params['language'] = optionen.language;
-    return rufenBinaer('getInvoicePdf', params);
+    if (options.language)
+        params['language'] = options.language;
+    return binaryTransport('getInvoicePdf', params);
 }
 /**
  * Eine Zahlung nachtragen, die nach dem Ausstellen eingetroffen ist
@@ -186,8 +187,8 @@ export function getInvoicePdf(rufenBinaer, invoiceId, optionen = {}) {
  * zusaetzlich `notice` — eine Barzahlung ist ein Barumsatz und braucht einen
  * Beleg (§ 132a BAO), den dieser Vermerk nicht ersetzt.
  */
-export async function recordInvoicePayment(rufen, anfrage) {
-    const daten = await rufen('recordInvoicePayment', nutzlast(anfrage));
+export async function recordInvoicePayment(transport, request) {
+    const daten = await transport('recordInvoicePayment', nutzlast(request));
     const roh = objekt(daten);
     const ergebnis = {
         invoice: pflichtObjekt('recordInvoicePayment', daten, 'invoice'),
@@ -200,22 +201,31 @@ export async function recordInvoicePayment(rufen, anfrage) {
     return ergebnis;
 }
 /** Die Marken des Kontos — die Kennung geht als `brandId` in `issueInvoice`. */
-export async function listBrands(rufen) {
-    const brands = objekt(await rufen('listBrands', {}))['brands'];
+export async function listBrands(transport) {
+    const brands = objekt(await transport('listBrands', {}))['brands'];
     if (!Array.isArray(brands))
         throw new KasseneckValidationError('listBrands', 'Antwort ohne brands', 'response');
     return brands;
 }
 /**
- * Die E-Rechnung als XML-Text. Sie kommt im gewohnten Umschlag (`data.xml`)
- * und nicht als rohe Datei: so bleibt ein fachlicher Fehler
- * (`einvoice_incomplete` mit `missing[]`) ein gewoehnlicher Fehler.
+ * Die E-Rechnung samt Format und Dateiname, genau wie der Server sie schickt.
+ * Sie kommt im gewohnten Umschlag (`data.xml`) und nicht als rohe Datei: so
+ * bleibt ein fachlicher Fehler (`einvoice_incomplete` mit `missing[]`) ein
+ * gewoehnlicher Fehler. Den Dateinamen nicht selbst bauen, sondern
+ * `filename` nehmen (`invoice-<Nummer>.xml`).
  */
-export async function getInvoiceXml(rufen, invoiceId, format = 'ubl') {
-    const daten = await rufen('getInvoiceXml', { invoiceId, format });
-    const xml = objekt(daten)['xml'];
+export async function getInvoiceXml(transport, invoiceId, format = 'ubl') {
+    const daten = objekt(await transport('getInvoiceXml', { invoiceId, format }));
+    const { xml, filename } = daten;
+    const gesendet = daten['format'];
     if (typeof xml !== 'string' || !xml) {
         throw new KasseneckValidationError('getInvoiceXml', 'Antwort ohne xml', 'response');
     }
-    return xml;
+    if (typeof gesendet !== 'string' || !EINVOICE_FORMATS.includes(gesendet)) {
+        throw new KasseneckValidationError('getInvoiceXml', 'Antwort ohne gueltiges format', 'response');
+    }
+    if (typeof filename !== 'string' || !filename) {
+        throw new KasseneckValidationError('getInvoiceXml', 'Antwort ohne filename', 'response');
+    }
+    return { xml, format: gesendet, filename };
 }

package/dist/esm/invoice/fehler.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Fehler der Rechnungs-API auswerten: am Code, nie am Text.
+ *
+ * Es zaehlen die Codes des Vertrags ([INVOICE_ERROR_CODES]) und die, die
+ * Anmeldung und Rand auf jedem Rechnungsaufruf erzeugen koennen
+ * ([INVOICE_REQUEST_ERROR_CODES], z. B. `dialect_mismatch`, `not_found`,
+ * `route_missing`). Ein fremder Code ist fuer diese Helfer kein
+ * Rechnungs-Fehler: wer darauf verzweigt, soll es bewusst ueber
+ * `KasseneckApiError.code` tun.
+ */
+import type { KasseneckApiError } from '../client/errors.js';
+import { type InvoiceErrorCode, type InvoiceRequestErrorCode } from './vertrag.js';
+/** Ein Code, den ein Rechnungsaufruf liefern kann. */
+export type InvoiceApiErrorCode = InvoiceErrorCode | InvoiceRequestErrorCode;
+/** `true` fuer einen Code aus [INVOICE_ERROR_CODES] oder [INVOICE_REQUEST_ERROR_CODES]. */
+export declare function isInvoiceErrorCode(value: unknown): value is InvoiceApiErrorCode;
+/** Der Fehlercode eines geworfenen Fehlers; `undefined`, wenn es keiner der Rechnungs-API ist. */
+export declare function invoiceErrorCode(error: unknown): InvoiceApiErrorCode | undefined;
+/**
+ * Kurzform fuer `catch (e) { if (isInvoiceError(e, 'customer_exists')) … }`.
+ * Ohne `code`: ist es ueberhaupt ein Fehler der Rechnungs-API?
+ */
+export declare function isInvoiceError(error: unknown, code?: InvoiceApiErrorCode): error is KasseneckApiError;
+/** Ein Feldfehler aus `data.errors[]` einer `validation`-Antwort. */
+export interface InvoiceFieldError {
+    /** Feldpfad in der gesendeten Anfrage, z. B. `items[2].vatRate` oder `customer.vatId`. */
+    field: string;
+    message: string;
+}
+/** Die Feldfehler einer `validation`-Antwort; leer, wenn es keine sind. */
+export declare function invoiceFieldErrors(error: unknown): InvoiceFieldError[];

package/dist/esm/invoice/fehler.js

@@ -0,0 +1,33 @@
+/**
+ * Fehler der Rechnungs-API auswerten: am Code, nie am Text.
+ *
+ * Es zaehlen die Codes des Vertrags ([INVOICE_ERROR_CODES]) und die, die
+ * Anmeldung und Rand auf jedem Rechnungsaufruf erzeugen koennen
+ * ([INVOICE_REQUEST_ERROR_CODES], z. B. `dialect_mismatch`, `not_found`,
+ * `route_missing`). Ein fremder Code ist fuer diese Helfer kein
+ * Rechnungs-Fehler: wer darauf verzweigt, soll es bewusst ueber
+ * `KasseneckApiError.code` tun.
+ */
+import { bekannterCode, feldfehlerVon } from '../client/fehlercodes.js';
+import { INVOICE_ERROR_CODES, INVOICE_REQUEST_ERROR_CODES, } from './vertrag.js';
+const BEKANNT = new Set([...INVOICE_ERROR_CODES, ...INVOICE_REQUEST_ERROR_CODES]);
+/** `true` fuer einen Code aus [INVOICE_ERROR_CODES] oder [INVOICE_REQUEST_ERROR_CODES]. */
+export function isInvoiceErrorCode(value) {
+    return typeof value === 'string' && BEKANNT.has(value);
+}
+/** Der Fehlercode eines geworfenen Fehlers; `undefined`, wenn es keiner der Rechnungs-API ist. */
+export function invoiceErrorCode(error) {
+    return bekannterCode(error, BEKANNT);
+}
+/**
+ * Kurzform fuer `catch (e) { if (isInvoiceError(e, 'customer_exists')) … }`.
+ * Ohne `code`: ist es ueberhaupt ein Fehler der Rechnungs-API?
+ */
+export function isInvoiceError(error, code) {
+    const gefunden = invoiceErrorCode(error);
+    return gefunden !== undefined && (code === undefined || gefunden === code);
+}
+/** Die Feldfehler einer `validation`-Antwort; leer, wenn es keine sind. */
+export function invoiceFieldErrors(error) {
+    return feldfehlerVon(error);
+}

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

@@ -0,0 +1,21 @@
+/**
+ * `@kreiseck/kasseneck-api/invoice` – Rechnungen (§ 11 UStG, keine Belege)
+ * und Kunden ueber die Rechnungs-API.
+ *
+ * Ein eigener Unterpfad wie `partner`: der `api_key` eines Kontos, mit dem
+ * Rechnungen ausgestellt werden, gehoert auf einen **Server** und soll nicht
+ * versehentlich in ein Browser-Buendel der Kasse wandern.
+ *
+ * Die Beschreibung der Endpunkte steht in der Referenz des Backends
+ * (`docs/api/rechnungen.md`). Was hier steht, ist der Vertrag als Daten und die
+ * Benutzung des Clients.
+ */
+export { createInvoiceApi, type InvoiceApi, type InvoiceApiOptions } from './api.js';
+export { invoiceKeyAuth, type InvoiceKeyAuthOptions } from './auth.js';
+export { isInvoiceError, isInvoiceErrorCode, invoiceErrorCode, invoiceFieldErrors, type InvoiceApiErrorCode, type InvoiceFieldError, } from './fehler.js';
+export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, previewInvoice, recordInvoicePayment, searchCustomers, updateCustomer, } from './endpunkte.js';
+export type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceDetailPayment, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceSetupGap, InvoiceSetupStatus, InvoiceTotals, InvoiceXml, InvoiceNotice, InvoicePayment, InvoicePreview, InvoiceRateTotals, IssueInvoiceRequest, IssueResult, PaymentInput, PreviewResult, RecordPaymentRequest, RecordPaymentResult, } from './typen.js';
+export { INVOICE_TEXTS, invoiceText, type InvoiceTextKey } from './texte.js';
+export { computeInvoiceTotals, ZERO_RATED_TAX_SCHEMES, type TotalsItem } from './summen.js';
+export { proratedPriceMicros, MAX_AMOUNT_CENTS, itemFromEuro, formatUnitPrice, CalcError, calculateInvoice, roundDiv, vatRateMapKey, formatVatRate, type CalcResult, type CalcErrorCode, type CalcOptions, type CalcItem, type RateTotal, type ItemConversion, type ConversionReason, type LineAmount, } from './calc.js';
+export { INVOICE_CONTRACT_VERSION, INVOICE_ENDPOINTS, INVOICE_ERROR_CODES, INVOICE_REQUEST_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, EINVOICE_MISSING_CODES, WRITE_OFF_REASON_CODES, INVOICE_LANGUAGES, INVOICE_PAYMENT_METHODS, ITEM_KINDS, REVERSE_CHARGE_REASONS, INVOICE_NOTICE_CODES, INVOICE_UNITS, INVOICE_UNIT_CODES, INVOICE_SETUP_REQUIREMENTS, CUSTOMER_FIELDS, ITEM_FIELDS, ITEM_PRICE_EXACTLY_ONE, INVOICE_REQUESTS, INVOICE_EXACTLY_ONE, INVOICE_AT_LEAST_ONE, type InvoiceEndpoint, type InvoiceErrorCode, type InvoiceRequestErrorCode, type CreditNoteReason, type TaxScheme, type PriceMode, type VatRatePercent, type CustomerType, type InvoiceListStatus, type DocType, type EInvoiceFormat, type EInvoiceMissingCode, type WriteOffReasonCode, type InvoiceLanguage, type InvoicePaymentMethod, type ItemKind, type ReverseChargeReason, type InvoiceNoticeCode, type InvoiceUnit, type InvoiceSetupRequirement, type FieldFormat, type Field, } from './vertrag.js';

package/dist/esm/invoice/index.js

@@ -0,0 +1,20 @@
+/**
+ * `@kreiseck/kasseneck-api/invoice` – Rechnungen (§ 11 UStG, keine Belege)
+ * und Kunden ueber die Rechnungs-API.
+ *
+ * Ein eigener Unterpfad wie `partner`: der `api_key` eines Kontos, mit dem
+ * Rechnungen ausgestellt werden, gehoert auf einen **Server** und soll nicht
+ * versehentlich in ein Browser-Buendel der Kasse wandern.
+ *
+ * Die Beschreibung der Endpunkte steht in der Referenz des Backends
+ * (`docs/api/rechnungen.md`). Was hier steht, ist der Vertrag als Daten und die
+ * Benutzung des Clients.
+ */
+export { createInvoiceApi } from './api.js';
+export { invoiceKeyAuth } from './auth.js';
+export { isInvoiceError, isInvoiceErrorCode, invoiceErrorCode, invoiceFieldErrors, } from './fehler.js';
+export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, previewInvoice, recordInvoicePayment, searchCustomers, updateCustomer, } from './endpunkte.js';
+export { INVOICE_TEXTS, invoiceText } from './texte.js';
+export { computeInvoiceTotals, ZERO_RATED_TAX_SCHEMES } from './summen.js';
+export { proratedPriceMicros, MAX_AMOUNT_CENTS, itemFromEuro, formatUnitPrice, CalcError, calculateInvoice, roundDiv, vatRateMapKey, formatVatRate, } from './calc.js';
+export { INVOICE_CONTRACT_VERSION, INVOICE_ENDPOINTS, INVOICE_ERROR_CODES, INVOICE_REQUEST_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, EINVOICE_MISSING_CODES, WRITE_OFF_REASON_CODES, INVOICE_LANGUAGES, INVOICE_PAYMENT_METHODS, ITEM_KINDS, REVERSE_CHARGE_REASONS, INVOICE_NOTICE_CODES, INVOICE_UNITS, INVOICE_UNIT_CODES, INVOICE_SETUP_REQUIREMENTS, CUSTOMER_FIELDS, ITEM_FIELDS, ITEM_PRICE_EXACTLY_ONE, INVOICE_REQUESTS, INVOICE_EXACTLY_ONE, INVOICE_AT_LEAST_ONE, } from './vertrag.js';

package/dist/esm/{rechnung → invoice}/summen.d.ts

@@ -3,14 +3,14 @@
  * 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
+ * Rechnung ueber den exakten Ganzzahl-Kern aus (`calculateInvoice` in
+ * `…/invoice/calc`). 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`.
+ * Dart-Zwilling pruefen gegen `fixtures/invoice-totals.json`. Neuer Code
+ * nimmt `calculateInvoice` oder `previewInvoice`.
  *
  * Die Regel (je USt-Satz, Betraege in Cent, kaufmaennisch gerundet):
  *
@@ -23,17 +23,17 @@
  * ist das Brutto der vereinbarte Preis und bleibt, wie die Zeilen es ergeben.
  * Bei einem steuerfreien Steuerfall zaehlt jede Zeile zu 0 %.
  *
- * `fixtures/rechnung-summen.json` haelt die Prueffaelle; Backend und
+ * `fixtures/invoice-totals.json` haelt die Prueffaelle; Backend und
  * Dart-Zwilling pruefen gegen dieselbe Datei. Verbindlich bleibt, was der
  * Server rechnet — mit `previewInvoice` laesst sich das vorab abfragen.
  */
 import type { InvoiceTotals } from './typen.js';
 import type { PriceMode, TaxScheme } from './vertrag.js';
-import { STEUERFREIE_FAELLE } from './rechnen.js';
+import { ZERO_RATED_TAX_SCHEMES } from './calc.js';
 /** Aus dem Kern uebernommen, damit Kern und Huelle nie auseinanderlaufen. */
-export { STEUERFREIE_FAELLE };
+export { ZERO_RATED_TAX_SCHEMES };
 /** Was fuer die Summe zaehlt — `InvoiceItemInput` passt unveraendert. */
-export interface SummenPosition {
+export interface TotalsItem {
     quantity: number;
     unitPriceCents: number;
     vatRate: number;
@@ -50,8 +50,8 @@ export interface SummenPosition {
  *
  * @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.
+ * Rechnung abweichen. Stattdessen `calculateInvoice` aus
+ * `@kreiseck/kasseneck-api/invoice/calc` (Euro-Positionen ueber
+ * `itemFromEuro`) oder `previewInvoice` verwenden.
  */
-export declare function rechnungSummen(items: readonly SummenPosition[], priceMode: PriceMode, taxScheme?: TaxScheme): InvoiceTotals;
+export declare function computeInvoiceTotals(items: readonly TotalsItem[], priceMode: PriceMode, taxScheme?: TaxScheme): InvoiceTotals;

package/dist/esm/{rechnung → invoice}/summen.js

@@ -3,14 +3,14 @@
  * 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
+ * Rechnung ueber den exakten Ganzzahl-Kern aus (`calculateInvoice` in
+ * `…/invoice/calc`). 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`.
+ * Dart-Zwilling pruefen gegen `fixtures/invoice-totals.json`. Neuer Code
+ * nimmt `calculateInvoice` oder `previewInvoice`.
  *
  * Die Regel (je USt-Satz, Betraege in Cent, kaufmaennisch gerundet):
  *
@@ -23,13 +23,13 @@
  * ist das Brutto der vereinbarte Preis und bleibt, wie die Zeilen es ergeben.
  * Bei einem steuerfreien Steuerfall zaehlt jede Zeile zu 0 %.
  *
- * `fixtures/rechnung-summen.json` haelt die Prueffaelle; Backend und
+ * `fixtures/invoice-totals.json` haelt die Prueffaelle; Backend und
  * Dart-Zwilling pruefen gegen dieselbe Datei. Verbindlich bleibt, was der
  * Server rechnet — mit `previewInvoice` laesst sich das vorab abfragen.
  */
-import { STEUERFREIE_FAELLE } from './rechnen.js';
+import { ZERO_RATED_TAX_SCHEMES } from './calc.js';
 /** Aus dem Kern uebernommen, damit Kern und Huelle nie auseinanderlaufen. */
-export { STEUERFREIE_FAELLE };
+export { ZERO_RATED_TAX_SCHEMES };
 /** Auf Cent gerundete Euro — dieselbe Rundung wie am Server (halber Cent vom Nullpunkt weg). */
 function euroRund(n) {
     return ((n < 0 ? -1 : 1) * Math.round((Math.abs(n) + Number.EPSILON) * 100)) / 100;
@@ -51,12 +51,12 @@ function centRund(x) {
  *
  * @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.
+ * Rechnung abweichen. Stattdessen `calculateInvoice` aus
+ * `@kreiseck/kasseneck-api/invoice/calc` (Euro-Positionen ueber
+ * `itemFromEuro`) oder `previewInvoice` verwenden.
  */
-export function rechnungSummen(items, priceMode, taxScheme = 'normal') {
-    const steuerfrei = STEUERFREIE_FAELLE.includes(taxScheme);
+export function computeInvoiceTotals(items, priceMode, taxScheme = 'normal') {
+    const steuerfrei = ZERO_RATED_TAX_SCHEMES.includes(taxScheme);
     const bruttoPreise = priceMode === 'gross' && !steuerfrei;
     // Ungerundete Zeilen je Satz, in Euro wie am Server.
     const jeSatz = new Map();

package/dist/esm/invoice/texte.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Texte von Rechnung und Gutschrift in jeder Sprache der Rechnungs-API — eine
+ * Quelle fuer das Backend (PDF, E-Rechnung, Mail) und das Web (Statusseite).
+ * Das Backend liest sie aus `fixtures/invoice-texts.json` (`npm run
+ * fixtures:rechnungstexte`).
+ *
+ * Datum und Betraege stehen NICHT hier: sie bleiben in jeder Sprache
+ * oesterreichisch formatiert (15.09.2026, € 1.234,56) und werden vom Aufrufer
+ * eingesetzt. Platzhalter in {geschweiften} Klammern; jede Sprache hat dieselben
+ * Schluessel und je Schluessel dieselben Platzhalter (test/rechnung-texte.test.ts).
+ * Die Schluessel sind seit 1.0 englisch (alt und neu in
+ * `fixtures/renames-1.0.json`), die Texte bleiben, wie sie sind.
+ *
+ * Steuerhinweise nennen in jeder Sprache die Gesetzesstelle — § 11 UStG verlangt
+ * einen Hinweis, keinen Wortlaut; die Fundstelle macht ihn eindeutig.
+ */
+import type { InvoiceLanguage } from './vertrag.js';
+declare const DE: {
+    readonly 'pdf.title.invoice': "RECHNUNG";
+    readonly 'pdf.title.credit_note': "GUTSCHRIFT";
+    readonly 'pdf.badge.paid': "BEZAHLT";
+    readonly 'pdf.badge.direct_debit': "SEPA-LASTSCHRIFT";
+    readonly 'pdf.meta.number.invoice': "Rechnungsnr.";
+    readonly 'pdf.meta.number.credit_note': "Gutschriftsnr.";
+    readonly 'pdf.meta.date.invoice': "Rechnungsdatum";
+    readonly 'pdf.meta.date.credit_note': "Gutschriftsdatum";
+    readonly 'pdf.meta.service_period': "Leistungszeitraum";
+    readonly 'pdf.meta.due_date': "Fälligkeit";
+    readonly 'pdf.reference.credit_note': "Gutschrift zu Rechnung {number}";
+    readonly 'pdf.reference.dated': " vom {date}";
+    readonly 'pdf.label.invoice': "Rechnung {number}";
+    readonly 'pdf.label.credit_note': "Gutschrift {number}";
+    readonly 'pdf.vat_id': "UID: {vatId}";
+    readonly 'pdf.table.pos': "POS";
+    readonly 'pdf.table.description': "BESCHREIBUNG";
+    readonly 'pdf.table.quantity': "MENGE";
+    readonly 'pdf.table.vat': "UST";
+    readonly 'pdf.table.unit_net': "EINZEL NETTO";
+    readonly 'pdf.table.amount_net': "BETRAG NETTO";
+    readonly 'pdf.table.unit_gross': "EINZEL BRUTTO";
+    readonly 'pdf.table.amount_gross': "BETRAG BRUTTO";
+    readonly 'pdf.item.discount': "abzüglich {percent} % Rabatt";
+    readonly 'pdf.totals.subtotal': "Zwischensumme netto";
+    readonly 'pdf.totals.vat': "Umsatzsteuer {rate}%";
+    readonly 'pdf.totals.included_vat': "darin {rate}% USt von {net} netto";
+    readonly 'pdf.totals.grand_total.invoice': "Gesamtbetrag";
+    readonly 'pdf.totals.grand_total.credit_note': "Gutschriftsbetrag";
+    readonly 'tax.small_business': "Gemäß § 6 Abs. 1 Z 27 UStG wird keine Umsatzsteuer verrechnet (Kleinunternehmer).";
+    readonly 'tax.intra_community_supply.title': "Steuerfreie innergemeinschaftliche Lieferung. ";
+    readonly 'tax.intra_community_supply.text': "Gemäß Art. 6 Abs. 1 UStG (Art. 138 MwSt-RL 2006/112/EG). Die Erwerbsbesteuerung erfolgt durch den Abnehmer im Bestimmungsland.";
+    readonly 'tax.export_third_country': "Steuerfreie Ausfuhrlieferung (§ 6 Abs. 1 Z 1 UStG).";
+    readonly 'tax.reverse_charge.title': "Steuerschuldnerschaft des Leistungsempfängers. ";
+    readonly 'tax.reverse_charge.text': "Übergang der Steuerschuld gem. Art. 196 MwSt-RL 2006/112/EG (innergemeinschaftliche Leistung). Die Leistung ist nicht steuerfrei — die Umsatzsteuer schuldet und entrichtet der Leistungsempfänger in seinem Land.";
+    readonly 'tax.vat_id_line': "UID Leistungserbringer: {seller}   ·   UID Leistungsempfänger: {buyer}";
+    readonly 'tax.reverse_charge_reason.construction': "Bauleistung gemäß § 19 Abs. 1a UStG.";
+    readonly 'tax.reverse_charge_reason.scrap': "Schrott und Abfallstoffe gemäß Schrott-Umsatzsteuerverordnung (BGBl. II Nr. 129/2007).";
+    readonly 'tax.reverse_charge_reason.mobile_devices': "Mobilfunkgeräte bzw. integrierte Schaltkreise gemäß § 19 Abs. 1e lit. b UStG.";
+    readonly 'tax.reverse_charge_reason.it_devices': "Laptops, Tablets bzw. Videospielkonsolen gemäß § 2 Z 1 Umsatzsteuerbetrugsbekämpfungsverordnung (BGBl. II Nr. 369/2013).";
+    readonly 'tax.reverse_charge_reason.metals': "Metalle gemäß § 2 Z 4 Umsatzsteuerbetrugsbekämpfungsverordnung.";
+    readonly 'tax.reverse_charge_reason.emission_certificates': "Treibhausgasemissionszertifikate gemäß § 19 Abs. 1e lit. a UStG.";
+    readonly 'tax.reverse_charge_reason.gas_electricity': "Lieferung von Gas oder Elektrizität an einen Wiederverkäufer gemäß § 2 Z 2 Umsatzsteuerbetrugsbekämpfungsverordnung.";
+    readonly 'tax.reverse_charge_reason.energy_certificates': "Gas- und Elektrizitätszertifikate gemäß § 2 Z 3 Umsatzsteuerbetrugsbekämpfungsverordnung.";
+    readonly 'tax.reverse_charge_reason.investment_gold': "Steuerpflichtige Lieferung von Anlagegold gemäß § 2 Z 5 Umsatzsteuerbetrugsbekämpfungsverordnung.";
+    readonly 'tax.reverse_charge_reason.security_transfer': "Lieferung von Sicherungs- bzw. Vorbehaltseigentum gemäß § 19 Abs. 1b UStG.";
+    readonly 'tax.reverse_charge_reason.foreign_supplier': "Leistung eines nicht im Inland ansässigen Unternehmers gemäß § 19 Abs. 1 zweiter Satz UStG.";
+    readonly 'tax.domestic_reverse_charge.text': "Die Umsatzsteuer schuldet und entrichtet der Leistungsempfänger. Die Leistung ist nicht steuerfrei.";
+    readonly 'tax.outside_scope.title': "Nicht steuerbarer Umsatz. ";
+    readonly 'tax.outside_scope.text': "Der Leistungsort liegt gemäß § 3a Abs. 6 UStG im Ansässigkeitsstaat des Leistungsempfängers; in Österreich fällt keine Umsatzsteuer an.";
+    readonly 'pdf.payment.title': "ZAHLUNGSINFORMATIONEN";
+    readonly 'pdf.payment.recipient': "Empfänger";
+    readonly 'pdf.payment.iban': "IBAN";
+    readonly 'pdf.payment.bic': "BIC";
+    readonly 'pdf.payment.payment_reference': "Verwendungszweck";
+    readonly 'pdf.payment.note_until': "Zahlbar ohne Abzug bis {date}. Vielen Dank für Ihren Auftrag.";
+    readonly 'pdf.payment.note': "Zahlbar ohne Abzug. Vielen Dank für Ihren Auftrag.";
+    readonly 'pdf.payment.qr': "Mit Banking-App scannen & zahlen";
+    readonly 'pdf.paid.text': "Diese Rechnung ist beglichen. Es ist nichts weiter zu tun.";
+    readonly 'pdf.paid.date': "Bezahlt am";
+    readonly 'pdf.paid.payment_method': "Zahlungsart";
+    readonly 'payment_method.cash': "Bar";
+    readonly 'payment_method.transfer': "Überweisung";
+    readonly 'payment_method.card': "Karte";
+    readonly 'payment_method.online': "Online";
+    readonly 'pdf.direct_debit.text': "Der Betrag wird per SEPA-Lastschrift eingezogen. Sie müssen nichts veranlassen.";
+    readonly 'pdf.direct_debit.collection_date': "Einzug am";
+    readonly 'pdf.direct_debit.account': "Konto";
+    readonly 'pdf.direct_debit.mandate_reference': "Mandatsreferenz";
+    readonly 'pdf.direct_debit.mandate_date': "Mandat vom";
+    readonly 'pdf.direct_debit.warning': "Bitte für Deckung sorgen — die Kosten einer Rücklastschrift werden weiterverrechnet.";
+    readonly 'pdf.refund.text': "Der Betrag wird auf dem ursprünglichen Zahlungsweg erstattet. Sie müssen nichts veranlassen.";
+    readonly 'pdf.refund.reference': "Bezug";
+    readonly 'pdf.refund.amount': "Erstattungsbetrag";
+    readonly 'pdf.status.title': "Zahlungsstatus online verfolgen";
+    readonly 'pdf.status.text': "Zahlung bzw. Einzug prüfen und Benachrichtigungen aktivieren.";
+    readonly 'pdf.status.link': "Link";
+    readonly 'pdf.status.password': "Passwort";
+    readonly 'pdf.footer.contact': "Kontakt";
+    readonly 'pdf.footer.register': "Register & Steuer";
+    readonly 'pdf.footer.registered_office': "Sitz: {place}";
+    readonly 'pdf.footer.note': "Erstellt mit Kasseneck — ein Produkt der Kreiseck";
+    readonly 'pdf.page': "Seite {number} / {total}";
+    readonly 'country.AT': "Österreich";
+    readonly 'country.DE': "Deutschland";
+    readonly 'country.CH': "Schweiz";
+    readonly 'country.IT': "Italien";
+    readonly 'country.LI': "Liechtenstein";
+    readonly 'copy.invoice': "Übersetzung – keine eigene Rechnung · Original: Rechnung Nr. {number} vom {date}";
+    readonly 'copy.credit_note': "Übersetzung – keine eigene Gutschrift · Original: Gutschrift Nr. {number} vom {date}";
+    readonly 'credit_note.intro': "Grund: {reason}";
+    readonly 'credit_note.reason.cancellation': "Stornierung";
+    readonly 'credit_note.reason.price_reduction': "Preisnachlass";
+    readonly 'credit_note.reason.return': "Rücksendung";
+    readonly 'credit_note.reason.incorrect_invoice': "Fehlerhafte Rechnung";
+    readonly 'credit_note.reason.other': "Sonstiges";
+    readonly 'einvoice.exemption.reverse_charge': "Steuerschuldnerschaft des Leistungsempfängers (Reverse Charge)";
+    readonly 'einvoice.exemption.small_business': "Steuerbefreit — Kleinunternehmer gemäß §6 Abs. 1 Z 27 UStG";
+    readonly 'einvoice.exemption.intra_community_supply': "Steuerfreie innergemeinschaftliche Lieferung gemäß Art. 6 Abs. 1 UStG";
+    readonly 'einvoice.exemption.outside_scope': "Nicht steuerbarer Umsatz — Leistungsort im Ausland (§ 3a Abs. 6 UStG)";
+    readonly 'einvoice.exemption.export_third_country': "Steuerfreie Ausfuhrlieferung gemäß §6 Abs. 1 Z 1 UStG";
+    readonly 'einvoice.payable_until': "Zahlbar bis {date}";
+    readonly 'unit_symbol.piece': "Stk";
+    readonly 'unit_symbol.pair': "Paar";
+    readonly 'unit_symbol.set': "Set";
+    readonly 'unit_symbol.dozen': "Dtzd.";
+    readonly 'unit_symbol.second': "Sek.";
+    readonly 'unit_symbol.minute': "Min.";
+    readonly 'unit_symbol.hour': "Std";
+    readonly 'unit_symbol.day': "Tag";
+    readonly 'unit_symbol.night': "Nacht";
+    readonly 'unit_symbol.week': "Woche";
+    readonly 'unit_symbol.month': "Monat";
+    readonly 'unit_symbol.quarter': "Quartal";
+    readonly 'unit_symbol.half_year': "Halbjahr";
+    readonly 'unit_symbol.year': "Jahr";
+    readonly 'unit_symbol.milligram': "mg";
+    readonly 'unit_symbol.gram': "g";
+    readonly 'unit_symbol.kilogram': "kg";
+    readonly 'unit_symbol.tonne': "t";
+    readonly 'unit_symbol.millimetre': "mm";
+    readonly 'unit_symbol.centimetre': "cm";
+    readonly 'unit_symbol.metre': "m";
+    readonly 'unit_symbol.running_metre': "lfm";
+    readonly 'unit_symbol.kilometre': "km";
+    readonly 'unit_symbol.square_metre': "m²";
+    readonly 'unit_symbol.hectare': "ha";
+    readonly 'unit_symbol.millilitre': "ml";
+    readonly 'unit_symbol.litre': "l";
+    readonly 'unit_symbol.cubic_metre': "m³";
+    readonly 'unit_symbol.kilowatt_hour': "kWh";
+    readonly 'unit_symbol.megawatt_hour': "MWh";
+    readonly 'unit_symbol.gigabyte': "GB";
+    readonly 'unit_symbol.terabyte': "TB";
+    readonly 'unit_symbol.flat_rate': "Pauschal";
+    readonly 'unit_symbol.person': "Pers.";
+    readonly 'unit_symbol.licence': "Lizenz";
+    readonly 'unit_symbol.user': "Benutzer";
+    readonly 'unit_symbol.device': "Gerät";
+    readonly 'unit_symbol.session': "Sitzung";
+    readonly 'unit_symbol.trip': "Fahrt";
+    readonly 'unit_symbol.page': "Seite";
+    readonly 'unit_symbol.sheet': "Blatt";
+    readonly 'unit_symbol.package': "Pkg.";
+    readonly 'unit_symbol.box': "Box";
+    readonly 'unit_symbol.carton': "Karton";
+    readonly 'unit_symbol.bottle': "Fl.";
+    readonly 'unit_symbol.can': "Dose";
+    readonly 'unit_symbol.roll': "Rolle";
+    readonly 'unit_symbol.bag': "Sack";
+    readonly 'unit_symbol.pallet': "Palette";
+    readonly 'unit_name.piece': "Stück";
+    readonly 'unit_name.pair': "Paar";
+    readonly 'unit_name.set': "Set";
+    readonly 'unit_name.dozen': "Dutzend";
+    readonly 'unit_name.second': "Sekunde";
+    readonly 'unit_name.minute': "Minute";
+    readonly 'unit_name.hour': "Stunde";
+    readonly 'unit_name.day': "Tag";
+    readonly 'unit_name.night': "Nacht";
+    readonly 'unit_name.week': "Woche";
+    readonly 'unit_name.month': "Monat";
+    readonly 'unit_name.quarter': "Quartal";
+    readonly 'unit_name.half_year': "Halbjahr";
+    readonly 'unit_name.year': "Jahr";
+    readonly 'unit_name.milligram': "Milligramm";
+    readonly 'unit_name.gram': "Gramm";
+    readonly 'unit_name.kilogram': "Kilogramm";
+    readonly 'unit_name.tonne': "Tonne";
+    readonly 'unit_name.millimetre': "Millimeter";
+    readonly 'unit_name.centimetre': "Zentimeter";
+    readonly 'unit_name.metre': "Meter";
+    readonly 'unit_name.running_metre': "Laufmeter";
+    readonly 'unit_name.kilometre': "Kilometer";
+    readonly 'unit_name.square_metre': "Quadratmeter";
+    readonly 'unit_name.hectare': "Hektar";
+    readonly 'unit_name.millilitre': "Milliliter";
+    readonly 'unit_name.litre': "Liter";
+    readonly 'unit_name.cubic_metre': "Kubikmeter";
+    readonly 'unit_name.kilowatt_hour': "Kilowattstunde";
+    readonly 'unit_name.megawatt_hour': "Megawattstunde";
+    readonly 'unit_name.gigabyte': "Gigabyte";
+    readonly 'unit_name.terabyte': "Terabyte";
+    readonly 'unit_name.flat_rate': "Pauschale";
+    readonly 'unit_name.person': "Person";
+    readonly 'unit_name.licence': "Lizenz";
+    readonly 'unit_name.user': "Benutzer";
+    readonly 'unit_name.device': "Gerät";
+    readonly 'unit_name.session': "Sitzung";
+    readonly 'unit_name.trip': "Fahrt";
+    readonly 'unit_name.page': "Seite";
+    readonly 'unit_name.sheet': "Blatt";
+    readonly 'unit_name.package': "Packung";
+    readonly 'unit_name.box': "Box";
+    readonly 'unit_name.carton': "Karton";
+    readonly 'unit_name.bottle': "Flasche";
+    readonly 'unit_name.can': "Dose";
+    readonly 'unit_name.roll': "Rolle";
+    readonly 'unit_name.bag': "Sack";
+    readonly 'unit_name.pallet': "Palette";
+};
+export type InvoiceTextKey = keyof typeof DE;
+export declare const INVOICE_TEXTS: Readonly<Record<InvoiceLanguage, Readonly<Record<InvoiceTextKey, string>>>>;
+/** Ein Text der gewaehlten Sprache mit eingesetzten Werten; ein fehlender Wert ist ein Programmierfehler. */
+export declare function invoiceText(language: InvoiceLanguage, key: InvoiceTextKey, values?: Readonly<Record<string, string | number>>): string;
+export {};