@kreiseck/kasseneck-api 0.15.0 → 0.17.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.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.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_VERTRAG_VERSION = 1;
 exports.RECHNUNG_AUFRUFE = [
     'createCustomer',
@@ -33,6 +33,8 @@ exports.RECHNUNG_AUFRUFE = [
     'listInvoices',
     'getInvoicePdf',
     'getInvoiceXml',
+    'getInvoiceSetupStatus',
+    'listBrands',
 ];
 /**
  * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
@@ -54,6 +56,10 @@ exports.INVOICE_ERROR_CODES = [
     'partial_credit_exists',
     'credit_exceeds_invoice',
     'einvoice_incomplete',
+    'invoice_api_not_enabled',
+    'invoice_setup_incomplete',
+    'language_not_allowed',
+    'brand_not_found',
 ];
 /** Gruende einer Gutschrift. Der Server druckt den deutschen Anzeigetext. */
 exports.CREDIT_NOTE_REASONS = [
@@ -70,6 +76,153 @@ exports.CUSTOMER_TYPES = ['private', 'company'];
 exports.INVOICE_LIST_STATUS = ['final', 'paid', 'cancelled', 'open', 'overdue'];
 exports.DOC_TYPES = ['RE', 'GU'];
 exports.EINVOICE_FORMATS = ['ubl', 'cii'];
+/**
+ * Sprachen einer Rechnung. Die Sprache wird beim Festschreiben eingefroren;
+ * fehlt sie an Kunde oder Rechnung, gilt `de`. Behoerden bekommen immer `de`
+ * (`language_not_allowed`). Datum und Betraege bleiben in jeder Sprache
+ * oesterreichisch formatiert.
+ */
+exports.INVOICE_LANGUAGES = ['de', 'en'];
+/**
+ * Einheiten einer Position. Die API nimmt nur diese Schluessel an; gedruckt
+ * wird das Kuerzel in der Sprache der Rechnung (`RECHNUNG_TEXTE`,
+ * `einheit.<schluessel>`), die E-Rechnung fuehrt den UN/ECE-Code
+ * (`RECHNUNG_EINHEITEN_CODES`). Ohne Angabe gilt `piece`.
+ */
+exports.INVOICE_UNITS = [
+    'piece',
+    'pair',
+    'set',
+    'dozen',
+    'second',
+    'minute',
+    'hour',
+    'day',
+    'night',
+    'week',
+    'month',
+    'quarter',
+    'half_year',
+    'year',
+    'milligram',
+    'gram',
+    'kilogram',
+    'tonne',
+    'millimetre',
+    'centimetre',
+    'metre',
+    'running_metre',
+    'kilometre',
+    'square_metre',
+    'hectare',
+    'millilitre',
+    'litre',
+    'cubic_metre',
+    'kilowatt_hour',
+    'megawatt_hour',
+    'gigabyte',
+    'terabyte',
+    'flat_rate',
+    'person',
+    'licence',
+    'user',
+    'device',
+    'session',
+    'trip',
+    'page',
+    'sheet',
+    'package',
+    'box',
+    'carton',
+    'bottle',
+    'can',
+    'roll',
+    'bag',
+    'pallet',
+];
+/**
+ * UN/ECE-Code je Einheit (Recommendation 20, Verpackungen aus Recommendation 21
+ * mit `X`). Mehrere Einheiten duerfen denselben Code tragen (Meter und
+ * Laufmeter; Lizenz, Benutzer, Geraet als Stueck). Die Validatoren der
+ * E-Rechnung pruefen jeden Code im Backend (Beispiel `api-einheiten`).
+ */
+exports.RECHNUNG_EINHEITEN_CODES = Object.freeze({
+    piece: 'C62',
+    pair: 'PR',
+    set: 'SET',
+    dozen: 'DZN',
+    second: 'SEC',
+    minute: 'MIN',
+    hour: 'HUR',
+    day: 'DAY',
+    night: 'C62',
+    week: 'WEE',
+    month: 'MON',
+    quarter: 'QAN',
+    half_year: 'SAN',
+    year: 'ANN',
+    milligram: 'MGM',
+    gram: 'GRM',
+    kilogram: 'KGM',
+    tonne: 'TNE',
+    millimetre: 'MMT',
+    centimetre: 'CMT',
+    metre: 'MTR',
+    running_metre: 'MTR',
+    kilometre: 'KMT',
+    square_metre: 'MTK',
+    // Rec 20 fuehrt fuer Hektar HAR, EN 16931 laesst davon nur H18
+    // („square hectometre", Synonym hectare) zu.
+    hectare: 'H18',
+    millilitre: 'MLT',
+    litre: 'LTR',
+    cubic_metre: 'MTQ',
+    kilowatt_hour: 'KWH',
+    megawatt_hour: 'MWH',
+    gigabyte: 'E34',
+    terabyte: 'E35',
+    flat_rate: 'LS',
+    person: 'IE',
+    licence: 'C62',
+    user: 'C62',
+    device: 'C62',
+    session: 'C62',
+    trip: 'C62',
+    page: 'ZP',
+    // Ebenso: ST („sheet") steht nicht in der Liste von EN 16931, LEF („leaf") schon.
+    sheet: 'LEF',
+    package: 'XPK',
+    box: 'XBX',
+    carton: 'XCT',
+    bottle: 'XBO',
+    can: 'XCA',
+    roll: 'XRO',
+    bag: 'XSA',
+    pallet: 'XPX',
+});
+/**
+ * Was erfuellt sein muss, bevor ueber die API ausgestellt werden darf — in
+ * dieser Reihenfolge meldet `getInvoiceSetupStatus`, was fehlt, und dieselben
+ * Schluessel stehen in `invoice_setup_incomplete`.
+ *
+ * - `module_active`  Modul Rechnung aktiv
+ * - `api_enabled`    Rechnungs-API fuer das Konto von Kasseneck freigegeben (nur live)
+ * - `live_enabled`   Konto live freigeschaltet (nur live)
+ * - `business_name`, `address`, `vat_id`  Pflichtangaben des Ausstellers (§ 11 UStG;
+ *   `vat_id` entfaellt bei Kleinunternehmern)
+ * - `bank_account`   IBAN und Kontoinhaber
+ * - `number_format`  Rechnungsnummern-Format bewusst gespeichert
+ */
+exports.INVOICE_SETUP_REQUIREMENTS = [
+    'module_active',
+    'api_enabled',
+    'live_enabled',
+    'business_name',
+    'address',
+    'vat_id',
+    'bank_account',
+    'number_format',
+];
 const text = (max, pflicht = false, extra = {}) => ({ typ: 'string', pflicht, max, ...(pflicht && extra.min === undefined ? { min: 1 } : {}), ...extra });
 const idempotencyKey = (pflicht) => ({ typ: 'string', pflicht, min: 1, max: 120 });
 const id = { typ: 'string', pflicht: false, min: 1, max: 128 };
@@ -94,6 +247,8 @@ exports.KUNDE_FELDER = Object.freeze({
     isAuthority: { typ: 'boolean', pflicht: false },
     note: text(1000),
     externalId: { typ: 'string', pflicht: false, min: 1, max: 120 },
+    /** Sprache der Rechnungen an diesen Kunden; fehlt = `de`. */
+    language: { typ: 'enum', pflicht: false, werte: exports.INVOICE_LANGUAGES },
 });
 /** Beim Aendern ist jedes Kundenfeld optional. */
 const KUNDE_PATCH = Object.freeze(Object.fromEntries(Object.entries(exports.KUNDE_FELDER).map(([name, feld]) => [name, { ...feld, pflicht: false }])));
@@ -102,7 +257,8 @@ exports.POSITION_FELDER = Object.freeze({
     description: text(300, true),
     subtitle: text(1000),
     quantity: { typ: 'number', pflicht: true, min: 0, exklusivMin: true, max: 1_000_000, nachkomma: 3 },
-    unit: text(20),
+    /** Einheit aus `INVOICE_UNITS`; ohne Angabe `piece`. */
+    unit: { typ: 'enum', pflicht: false, werte: exports.INVOICE_UNITS },
     unitPriceCents: { typ: 'integer', pflicht: true, min: 0, max: 100_000_000 },
     vatRate: { typ: 'enum', pflicht: true, werte: exports.VAT_RATES },
     discountPct: { typ: 'number', pflicht: false, min: 0, max: 100, nachkomma: 2 },
@@ -145,6 +301,10 @@ exports.RECHNUNG_ANFRAGEN = Object.freeze({
         tracking: { typ: 'boolean', pflicht: false },
         items: positionen,
         metadata: { typ: 'map', pflicht: false, maxSchluessel: 20, schluesselMuster: '^[a-zA-Z0-9_]{1,40}$', wertMax: 500 },
+        /** Sprache dieser Rechnung; sonst die des Kunden, sonst `de`. */
+        language: { typ: 'enum', pflicht: false, werte: exports.INVOICE_LANGUAGES },
+        /** Marke (Kennung aus `listBrands`); sonst die Standardmarke. */
+        brandId: id,
     },
     cancelInvoice: {
         idempotencyKey: idempotencyKey(true),
@@ -174,11 +334,15 @@ exports.RECHNUNG_ANFRAGEN = Object.freeze({
     },
     getInvoicePdf: {
         invoiceId: idPflicht,
+        /** Andere Sprache als die der Rechnung: gekennzeichnete Uebersetzungskopie, keine eigene Rechnung. */
+        language: { typ: 'enum', pflicht: false, werte: exports.INVOICE_LANGUAGES },
     },
     getInvoiceXml: {
         invoiceId: idPflicht,
         format: { typ: 'enum', pflicht: false, werte: exports.EINVOICE_FORMATS },
     },
+    getInvoiceSetupStatus: {},
+    listBrands: {},
 });
 /** 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", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "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", "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

@@ -23,6 +23,7 @@ export const AUFRUFE = [
     'getFirstReceiptDate',
     'getInvoice',
     'getInvoicePdf',
+    'getInvoiceSetupStatus',
     'getInvoiceXml',
     'getKasseSettings',
     'getPartnerCustomer',
@@ -34,6 +35,7 @@ export const AUFRUFE = [
     'issueInvoice',
     'listCustomerCashregisters',
     'listInvoices',
+    'listBrands',
     'listMyArticleGroups',
     'listMyArticles',
     'listMyCashregisters',

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

@@ -5,8 +5,8 @@
  * Funktionen (endpunkte.ts) und bleiben einzeln importierbar.
  */
 import { type FetchLike } from '../client/transport.js';
-import type { EInvoiceFormat } from './vertrag.js';
-import type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, IssueInvoiceRequest, IssueResult } from './typen.js';
+import type { EInvoiceFormat, InvoiceLanguage } from './vertrag.js';
+import type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.js';
 export interface RechnungApiOptions {
     /** `api_key` des Kontos (`kr_live_…` / `kr_test_…`). Gehoert auf einen Server. */
     apiKey: string;
@@ -37,7 +37,14 @@ export interface RechnungApi {
         number: string;
     }): Promise<InvoiceDetail>;
     listInvoices(abfrage?: InvoiceListQuery): Promise<InvoicePage>;
-    getInvoicePdf(invoiceId: string): Promise<Uint8Array>;
+    /** Mit `language` ungleich der Rechnungssprache: gekennzeichnete Uebersetzungskopie. */
+    getInvoicePdf(invoiceId: string, optionen?: {
+        language?: InvoiceLanguage;
+    }): Promise<Uint8Array>;
     getInvoiceXml(invoiceId: string, format?: EInvoiceFormat): Promise<string>;
+    /** Darf dieses Konto ausstellen, und was fehlt noch? Laeuft auch ohne Freigabe. */
+    getInvoiceSetupStatus(): Promise<InvoiceSetupStatus>;
+    /** Die Marken des Kontos; `id` geht als `brandId` in `issueInvoice`. */
+    listBrands(): Promise<Brand[]>;
 }
 export declare function createRechnungApi(optionen: RechnungApiOptions): RechnungApi;

package/dist/esm/rechnung/api.js

@@ -6,7 +6,7 @@
  */
 import { createBinaryTransport, createTransport } from '../client/transport.js';
 import { rechnungKeyAuth } from './auth.js';
-import { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceXml, issueInvoice, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
+import { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
 export function createRechnungApi(optionen) {
     const transportOptionen = {
         auth: rechnungKeyAuth({ apiKey: optionen.apiKey }),
@@ -26,7 +26,9 @@ export function createRechnungApi(optionen) {
         createCreditNote: (anfrage) => createCreditNote(rufen, anfrage),
         getInvoice: (kennung) => getInvoice(rufen, kennung),
         listInvoices: (abfrage) => listInvoices(rufen, abfrage),
-        getInvoicePdf: (id) => getInvoicePdf(rufenBinaer, id),
+        getInvoicePdf: (id, o) => getInvoicePdf(rufenBinaer, id, o),
         getInvoiceXml: (id, format) => getInvoiceXml(rufen, id, format),
+        getInvoiceSetupStatus: () => getInvoiceSetupStatus(rufen),
+        listBrands: () => listBrands(rufen),
     };
 }

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

@@ -17,8 +17,8 @@
  * der Aufruf `KasseneckValidationError` mit `scope:'response'`.
  */
 import type { InternerBinaerTransport, InternerTransport } from '../client/aufrufe.js';
-import type { EInvoiceFormat } from './vertrag.js';
-import type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, IssueInvoiceRequest, IssueResult } from './typen.js';
+import type { EInvoiceFormat, InvoiceLanguage } from './vertrag.js';
+import type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult } from './typen.js';
 export declare function createCustomer(rufen: InternerTransport, customer: CustomerInput, optionen?: {
     idempotencyKey?: string;
 }): Promise<Customer>;
@@ -38,8 +38,23 @@ export declare function getInvoice(rufen: InternerTransport, kennung: {
     number: string;
 }): Promise<InvoiceDetail>;
 export declare function listInvoices(rufen: InternerTransport, abfrage?: InvoiceListQuery): Promise<InvoicePage>;
-/** Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter Factur-X-Datei. */
-export declare function getInvoicePdf(rufenBinaer: InternerBinaerTransport, invoiceId: string): Promise<Uint8Array>;
+/**
+ * Darf dieses Konto ueber die API ausstellen, und was fehlt noch? Laeuft auch
+ * ohne Freigabe und vor der Live-Freischaltung — genau dann braucht man die
+ * Antwort. Vor dem ersten `issueInvoice` aufrufen und `missing` anzeigen.
+ */
+export declare function getInvoiceSetupStatus(rufen: InternerTransport): Promise<InvoiceSetupStatus>;
+/**
+ * Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter
+ * Factur-X-Datei. Mit `language` in der anderen Sprache als der Rechnung kommt
+ * eine **Uebersetzungskopie**: dieselbe Nummer, auf jeder Seite als Uebersetzung
+ * gekennzeichnet, ohne eingebettete E-Rechnung — keine eigene Rechnung.
+ */
+export declare function getInvoicePdf(rufenBinaer: InternerBinaerTransport, invoiceId: string, optionen?: {
+    language?: InvoiceLanguage;
+}): Promise<Uint8Array>;
+/** Die Marken des Kontos — die Kennung geht als `brandId` in `issueInvoice`. */
+export declare function listBrands(rufen: InternerTransport): Promise<Brand[]>;
 /**
  * Die E-Rechnung als XML-Text. Sie kommt im gewohnten Umschlag (`data.xml`)
  * und nicht als rohe Datei: so bleibt ein fachlicher Fehler

package/dist/esm/rechnung/endpunkte.js

@@ -96,10 +96,42 @@ export async function listInvoices(rufen, abfrage = {}) {
     const { eintraege, nextCursor } = seite('listInvoices', daten, 'invoices');
     return { invoices: eintraege, nextCursor };
 }
+// ---- Freigabe und Einrichtung ---------------------------------------------------
+/**
+ * Darf dieses Konto ueber die API ausstellen, und was fehlt noch? Laeuft auch
+ * 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', {}));
+    if (typeof daten['ready'] !== 'boolean' || !Array.isArray(daten['missing'])) {
+        throw new KasseneckValidationError('getInvoiceSetupStatus', 'Antwort ohne ready/missing', 'response');
+    }
+    return {
+        ready: daten['ready'],
+        environment: daten['environment'] === 'test' ? 'test' : 'live',
+        missing: daten['missing'],
+    };
+}
 // ---- Dateien ----------------------------------------------------------------
-/** Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter Factur-X-Datei. */
-export function getInvoicePdf(rufenBinaer, invoiceId) {
-    return rufenBinaer('getInvoicePdf', { invoiceId });
+/**
+ * Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter
+ * Factur-X-Datei. Mit `language` in der anderen Sprache als der Rechnung kommt
+ * eine **Uebersetzungskopie**: dieselbe Nummer, auf jeder Seite als Uebersetzung
+ * gekennzeichnet, ohne eingebettete E-Rechnung — keine eigene Rechnung.
+ */
+export function getInvoicePdf(rufenBinaer, invoiceId, optionen = {}) {
+    const params = { invoiceId };
+    if (optionen.language)
+        params['language'] = optionen.language;
+    return rufenBinaer('getInvoicePdf', params);
+}
+/** Die Marken des Kontos — die Kennung geht als `brandId` in `issueInvoice`. */
+export async function listBrands(rufen) {
+    const brands = objekt(await rufen('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`)

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

@@ -13,6 +13,7 @@
 export { createRechnungApi, type RechnungApi, type RechnungApiOptions } from './api.js';
 export { rechnungKeyAuth, type RechnungKeyAuthOptions } from './auth.js';
 export { istRechnungFehler, rechnungFehlerCode, rechnungFeldFehler, type RechnungFeldFehler, } from './fehler.js';
-export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceXml, issueInvoice, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
-export type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceTotals, IssueInvoiceRequest, IssueResult, } from './typen.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, 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 Format, type Feld, } from './vertrag.js';
+export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
+export type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceSetupGap, InvoiceSetupStatus, InvoiceTotals, IssueInvoiceRequest, IssueResult, } from './typen.js';
+export { RECHNUNG_TEXTE, rechnungText, type RechnungTextSchluessel } from './texte.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_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 InvoiceUnit, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.js';

package/dist/esm/rechnung/index.js

@@ -13,5 +13,6 @@
 export { createRechnungApi } from './api.js';
 export { rechnungKeyAuth } from './auth.js';
 export { istRechnungFehler, rechnungFehlerCode, rechnungFeldFehler, } from './fehler.js';
-export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceXml, issueInvoice, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.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, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, } from './vertrag.js';
+export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, searchCustomers, updateCustomer, } from './endpunkte.js';
+export { RECHNUNG_TEXTE, rechnungText } from './texte.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_UNITS, RECHNUNG_EINHEITEN_CODES, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, } from './vertrag.js';

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

@@ -0,0 +1,202 @@
+/**
+ * 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/rechnung-texte.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).
+ *
+ * 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.titel.rechnung': "RECHNUNG";
+    readonly 'pdf.titel.gutschrift': "GUTSCHRIFT";
+    readonly 'pdf.pille.bezahlt': "BEZAHLT";
+    readonly 'pdf.pille.lastschrift': "SEPA-LASTSCHRIFT";
+    readonly 'pdf.meta.nummer.rechnung': "Rechnungsnr.";
+    readonly 'pdf.meta.nummer.gutschrift': "Gutschriftsnr.";
+    readonly 'pdf.meta.datum.rechnung': "Rechnungsdatum";
+    readonly 'pdf.meta.datum.gutschrift': "Gutschriftsdatum";
+    readonly 'pdf.meta.leistungszeitraum': "Leistungszeitraum";
+    readonly 'pdf.meta.faelligkeit': "Fälligkeit";
+    readonly 'pdf.bezug.gutschrift': "Gutschrift zu Rechnung {nummer}";
+    readonly 'pdf.bezug.vom': " vom {datum}";
+    readonly 'pdf.bezeichnung.rechnung': "Rechnung {nummer}";
+    readonly 'pdf.bezeichnung.gutschrift': "Gutschrift {nummer}";
+    readonly 'pdf.uid': "UID: {uid}";
+    readonly 'pdf.tabelle.pos': "POS";
+    readonly 'pdf.tabelle.beschreibung': "BESCHREIBUNG";
+    readonly 'pdf.tabelle.menge': "MENGE";
+    readonly 'pdf.tabelle.ust': "UST";
+    readonly 'pdf.tabelle.einzelNetto': "EINZEL NETTO";
+    readonly 'pdf.tabelle.betragNetto': "BETRAG NETTO";
+    readonly 'pdf.summe.zwischensumme': "Zwischensumme netto";
+    readonly 'pdf.summe.umsatzsteuer': "Umsatzsteuer {satz}%";
+    readonly 'pdf.summe.gesamt.rechnung': "Gesamtbetrag";
+    readonly 'pdf.summe.gesamt.gutschrift': "Gutschriftsbetrag";
+    readonly 'steuer.kleinunternehmer': "Gemäß § 6 Abs. 1 Z 27 UStG wird keine Umsatzsteuer verrechnet (Kleinunternehmer).";
+    readonly 'steuer.igLieferung': "Steuerfreie innergemeinschaftliche Lieferung (Art. 6 Abs. 1 UStG).";
+    readonly 'steuer.ausfuhr': "Steuerfreie Ausfuhrlieferung (§ 6 Abs. 1 Z 1 UStG).";
+    readonly 'steuer.reverseCharge.titel': "Steuerfreie Leistung – Reverse Charge. ";
+    readonly 'steuer.reverseCharge.text': "Übergang der Steuerschuldnerschaft auf den Leistungsempfänger gem. Art. 196 MwSt-RL 2006/112/EG (innergemeinschaftliche Leistung). Die Umsatzsteuer ist vom Leistungsempfänger im Bestimmungsland abzuführen.";
+    readonly 'steuer.reverseCharge.uid': "UID Leistungserbringer: {verkaeufer}   ·   UID Leistungsempfänger: {kaeufer}";
+    readonly 'pdf.zahlung.titel': "ZAHLUNGSINFORMATIONEN";
+    readonly 'pdf.zahlung.empfaenger': "Empfänger";
+    readonly 'pdf.zahlung.iban': "IBAN";
+    readonly 'pdf.zahlung.bic': "BIC";
+    readonly 'pdf.zahlung.verwendungszweck': "Verwendungszweck";
+    readonly 'pdf.zahlung.hinweisBis': "Zahlbar ohne Abzug bis {datum}. Vielen Dank für Ihren Auftrag.";
+    readonly 'pdf.zahlung.hinweis': "Zahlbar ohne Abzug. Vielen Dank für Ihren Auftrag.";
+    readonly 'pdf.zahlung.qr': "Mit Banking-App scannen & zahlen";
+    readonly 'pdf.bezahlt.text': "Diese Rechnung ist beglichen. Es ist nichts weiter zu tun.";
+    readonly 'pdf.bezahlt.am': "Bezahlt am";
+    readonly 'pdf.bezahlt.zahlungsart': "Zahlungsart";
+    readonly 'zahlungsart.cash': "Bar";
+    readonly 'zahlungsart.transfer': "Überweisung";
+    readonly 'zahlungsart.card': "Karte";
+    readonly 'zahlungsart.online': "Online";
+    readonly 'pdf.lastschrift.text': "Der Betrag wird per SEPA-Lastschrift eingezogen. Sie müssen nichts veranlassen.";
+    readonly 'pdf.lastschrift.einzugAm': "Einzug am";
+    readonly 'pdf.lastschrift.konto': "Konto";
+    readonly 'pdf.lastschrift.mandatsreferenz': "Mandatsreferenz";
+    readonly 'pdf.lastschrift.mandatVom': "Mandat vom";
+    readonly 'pdf.lastschrift.warnung': "Bitte für Deckung sorgen — die Kosten einer Rücklastschrift werden weiterverrechnet.";
+    readonly 'pdf.erstattung.text': "Der Betrag wird auf dem ursprünglichen Zahlungsweg erstattet. Sie müssen nichts veranlassen.";
+    readonly 'pdf.erstattung.bezug': "Bezug";
+    readonly 'pdf.erstattung.betrag': "Erstattungsbetrag";
+    readonly 'pdf.status.titel': "Zahlungsstatus online verfolgen";
+    readonly 'pdf.status.text': "Zahlung bzw. Einzug prüfen und Benachrichtigungen aktivieren.";
+    readonly 'pdf.status.link': "Link";
+    readonly 'pdf.status.passwort': "Passwort";
+    readonly 'pdf.fuss.kontakt': "Kontakt";
+    readonly 'pdf.fuss.register': "Register & Steuer";
+    readonly 'pdf.fuss.sitz': "Sitz: {ort}";
+    readonly 'pdf.fuss.hinweis': "Erstellt mit Kasseneck — ein Produkt der Kreiseck";
+    readonly 'pdf.seite': "Seite {nummer} / {gesamt}";
+    readonly 'land.AT': "Österreich";
+    readonly 'land.DE': "Deutschland";
+    readonly 'land.CH': "Schweiz";
+    readonly 'land.IT': "Italien";
+    readonly 'land.LI': "Liechtenstein";
+    readonly 'kopie.rechnung': "Übersetzung – keine eigene Rechnung · Original: Rechnung Nr. {nummer} vom {datum}";
+    readonly 'kopie.gutschrift': "Übersetzung – keine eigene Gutschrift · Original: Gutschrift Nr. {nummer} vom {datum}";
+    readonly 'gutschrift.einleitung': "Grund: {grund}";
+    readonly 'gutschrift.grund.cancellation': "Stornierung";
+    readonly 'gutschrift.grund.price_reduction': "Preisnachlass";
+    readonly 'gutschrift.grund.return': "Rücksendung";
+    readonly 'gutschrift.grund.incorrect_invoice': "Fehlerhafte Rechnung";
+    readonly 'gutschrift.grund.other': "Sonstiges";
+    readonly 'einvoice.befreiung.reverseCharge': "Steuerschuldnerschaft des Leistungsempfängers (Reverse Charge)";
+    readonly 'einvoice.befreiung.kleinunternehmer': "Steuerbefreit — Kleinunternehmer gemäß §6 Abs. 1 Z 27 UStG";
+    readonly 'einvoice.befreiung.igLieferung': "Steuerfreie innergemeinschaftliche Lieferung gemäß Art. 6 Abs. 1 UStG";
+    readonly 'einvoice.befreiung.ausfuhr': "Steuerfreie Ausfuhrlieferung gemäß §6 Abs. 1 Z 1 UStG";
+    readonly 'einvoice.zahlbarBis': "Zahlbar bis {datum}";
+    readonly 'einheit.piece': "Stk";
+    readonly 'einheit.pair': "Paar";
+    readonly 'einheit.set': "Set";
+    readonly 'einheit.dozen': "Dtzd.";
+    readonly 'einheit.second': "Sek.";
+    readonly 'einheit.minute': "Min.";
+    readonly 'einheit.hour': "Std";
+    readonly 'einheit.day': "Tag";
+    readonly 'einheit.night': "Nacht";
+    readonly 'einheit.week': "Woche";
+    readonly 'einheit.month': "Monat";
+    readonly 'einheit.quarter': "Quartal";
+    readonly 'einheit.half_year': "Halbjahr";
+    readonly 'einheit.year': "Jahr";
+    readonly 'einheit.milligram': "mg";
+    readonly 'einheit.gram': "g";
+    readonly 'einheit.kilogram': "kg";
+    readonly 'einheit.tonne': "t";
+    readonly 'einheit.millimetre': "mm";
+    readonly 'einheit.centimetre': "cm";
+    readonly 'einheit.metre': "m";
+    readonly 'einheit.running_metre': "lfm";
+    readonly 'einheit.kilometre': "km";
+    readonly 'einheit.square_metre': "m²";
+    readonly 'einheit.hectare': "ha";
+    readonly 'einheit.millilitre': "ml";
+    readonly 'einheit.litre': "l";
+    readonly 'einheit.cubic_metre': "m³";
+    readonly 'einheit.kilowatt_hour': "kWh";
+    readonly 'einheit.megawatt_hour': "MWh";
+    readonly 'einheit.gigabyte': "GB";
+    readonly 'einheit.terabyte': "TB";
+    readonly 'einheit.flat_rate': "Pauschal";
+    readonly 'einheit.person': "Pers.";
+    readonly 'einheit.licence': "Lizenz";
+    readonly 'einheit.user': "Benutzer";
+    readonly 'einheit.device': "Gerät";
+    readonly 'einheit.session': "Sitzung";
+    readonly 'einheit.trip': "Fahrt";
+    readonly 'einheit.page': "Seite";
+    readonly 'einheit.sheet': "Blatt";
+    readonly 'einheit.package': "Pkg.";
+    readonly 'einheit.box': "Box";
+    readonly 'einheit.carton': "Karton";
+    readonly 'einheit.bottle': "Fl.";
+    readonly 'einheit.can': "Dose";
+    readonly 'einheit.roll': "Rolle";
+    readonly 'einheit.bag': "Sack";
+    readonly 'einheit.pallet': "Palette";
+    readonly 'einheitName.piece': "Stück";
+    readonly 'einheitName.pair': "Paar";
+    readonly 'einheitName.set': "Set";
+    readonly 'einheitName.dozen': "Dutzend";
+    readonly 'einheitName.second': "Sekunde";
+    readonly 'einheitName.minute': "Minute";
+    readonly 'einheitName.hour': "Stunde";
+    readonly 'einheitName.day': "Tag";
+    readonly 'einheitName.night': "Nacht";
+    readonly 'einheitName.week': "Woche";
+    readonly 'einheitName.month': "Monat";
+    readonly 'einheitName.quarter': "Quartal";
+    readonly 'einheitName.half_year': "Halbjahr";
+    readonly 'einheitName.year': "Jahr";
+    readonly 'einheitName.milligram': "Milligramm";
+    readonly 'einheitName.gram': "Gramm";
+    readonly 'einheitName.kilogram': "Kilogramm";
+    readonly 'einheitName.tonne': "Tonne";
+    readonly 'einheitName.millimetre': "Millimeter";
+    readonly 'einheitName.centimetre': "Zentimeter";
+    readonly 'einheitName.metre': "Meter";
+    readonly 'einheitName.running_metre': "Laufmeter";
+    readonly 'einheitName.kilometre': "Kilometer";
+    readonly 'einheitName.square_metre': "Quadratmeter";
+    readonly 'einheitName.hectare': "Hektar";
+    readonly 'einheitName.millilitre': "Milliliter";
+    readonly 'einheitName.litre': "Liter";
+    readonly 'einheitName.cubic_metre': "Kubikmeter";
+    readonly 'einheitName.kilowatt_hour': "Kilowattstunde";
+    readonly 'einheitName.megawatt_hour': "Megawattstunde";
+    readonly 'einheitName.gigabyte': "Gigabyte";
+    readonly 'einheitName.terabyte': "Terabyte";
+    readonly 'einheitName.flat_rate': "Pauschale";
+    readonly 'einheitName.person': "Person";
+    readonly 'einheitName.licence': "Lizenz";
+    readonly 'einheitName.user': "Benutzer";
+    readonly 'einheitName.device': "Gerät";
+    readonly 'einheitName.session': "Sitzung";
+    readonly 'einheitName.trip': "Fahrt";
+    readonly 'einheitName.page': "Seite";
+    readonly 'einheitName.sheet': "Blatt";
+    readonly 'einheitName.package': "Packung";
+    readonly 'einheitName.box': "Box";
+    readonly 'einheitName.carton': "Karton";
+    readonly 'einheitName.bottle': "Flasche";
+    readonly 'einheitName.can': "Dose";
+    readonly 'einheitName.roll': "Rolle";
+    readonly 'einheitName.bag': "Sack";
+    readonly 'einheitName.pallet': "Palette";
+};
+export type RechnungTextSchluessel = keyof typeof DE;
+export declare const RECHNUNG_TEXTE: Readonly<Record<InvoiceLanguage, Readonly<Record<RechnungTextSchluessel, string>>>>;
+/** Ein Text der gewaehlten Sprache mit eingesetzten Werten; ein fehlender Wert ist ein Programmierfehler. */
+export declare function rechnungText(sprache: InvoiceLanguage, schluessel: RechnungTextSchluessel, werte?: Readonly<Record<string, string | number>>): string;
+export {};