@kreiseck/kasseneck-api 0.16.0 → 0.18.0

package/dist/cjs/rechnung/texte.js

@@ -0,0 +1,377 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECHNUNG_TEXTE = void 0;
+exports.rechnungText = rechnungText;
+const DE = {
+    'pdf.titel.rechnung': 'RECHNUNG',
+    'pdf.titel.gutschrift': 'GUTSCHRIFT',
+    'pdf.pille.bezahlt': 'BEZAHLT',
+    'pdf.pille.lastschrift': 'SEPA-LASTSCHRIFT',
+    'pdf.meta.nummer.rechnung': 'Rechnungsnr.',
+    'pdf.meta.nummer.gutschrift': 'Gutschriftsnr.',
+    'pdf.meta.datum.rechnung': 'Rechnungsdatum',
+    'pdf.meta.datum.gutschrift': 'Gutschriftsdatum',
+    'pdf.meta.leistungszeitraum': 'Leistungszeitraum',
+    'pdf.meta.faelligkeit': 'Fälligkeit',
+    'pdf.bezug.gutschrift': 'Gutschrift zu Rechnung {nummer}',
+    'pdf.bezug.vom': ' vom {datum}',
+    'pdf.bezeichnung.rechnung': 'Rechnung {nummer}',
+    'pdf.bezeichnung.gutschrift': 'Gutschrift {nummer}',
+    'pdf.uid': 'UID: {uid}',
+    'pdf.tabelle.pos': 'POS',
+    'pdf.tabelle.beschreibung': 'BESCHREIBUNG',
+    'pdf.tabelle.menge': 'MENGE',
+    'pdf.tabelle.ust': 'UST',
+    'pdf.tabelle.einzelNetto': 'EINZEL NETTO',
+    'pdf.tabelle.betragNetto': 'BETRAG NETTO',
+    'pdf.summe.zwischensumme': 'Zwischensumme netto',
+    'pdf.summe.umsatzsteuer': 'Umsatzsteuer {satz}%',
+    'pdf.summe.gesamt.rechnung': 'Gesamtbetrag',
+    'pdf.summe.gesamt.gutschrift': 'Gutschriftsbetrag',
+    'steuer.kleinunternehmer': 'Gemäß § 6 Abs. 1 Z 27 UStG wird keine Umsatzsteuer verrechnet (Kleinunternehmer).',
+    'steuer.igLieferung': 'Steuerfreie innergemeinschaftliche Lieferung (Art. 6 Abs. 1 UStG).',
+    'steuer.ausfuhr': 'Steuerfreie Ausfuhrlieferung (§ 6 Abs. 1 Z 1 UStG).',
+    'steuer.reverseCharge.titel': 'Steuerfreie Leistung – Reverse Charge. ',
+    '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.',
+    'steuer.reverseCharge.uid': 'UID Leistungserbringer: {verkaeufer}   ·   UID Leistungsempfänger: {kaeufer}',
+    'pdf.zahlung.titel': 'ZAHLUNGSINFORMATIONEN',
+    'pdf.zahlung.empfaenger': 'Empfänger',
+    'pdf.zahlung.iban': 'IBAN',
+    'pdf.zahlung.bic': 'BIC',
+    'pdf.zahlung.verwendungszweck': 'Verwendungszweck',
+    'pdf.zahlung.hinweisBis': 'Zahlbar ohne Abzug bis {datum}. Vielen Dank für Ihren Auftrag.',
+    'pdf.zahlung.hinweis': 'Zahlbar ohne Abzug. Vielen Dank für Ihren Auftrag.',
+    'pdf.zahlung.qr': 'Mit Banking-App scannen & zahlen',
+    'pdf.bezahlt.text': 'Diese Rechnung ist beglichen. Es ist nichts weiter zu tun.',
+    'pdf.bezahlt.am': 'Bezahlt am',
+    'pdf.bezahlt.zahlungsart': 'Zahlungsart',
+    'zahlungsart.cash': 'Bar',
+    'zahlungsart.transfer': 'Überweisung',
+    'zahlungsart.card': 'Karte',
+    'zahlungsart.online': 'Online',
+    'pdf.lastschrift.text': 'Der Betrag wird per SEPA-Lastschrift eingezogen. Sie müssen nichts veranlassen.',
+    'pdf.lastschrift.einzugAm': 'Einzug am',
+    'pdf.lastschrift.konto': 'Konto',
+    'pdf.lastschrift.mandatsreferenz': 'Mandatsreferenz',
+    'pdf.lastschrift.mandatVom': 'Mandat vom',
+    'pdf.lastschrift.warnung': 'Bitte für Deckung sorgen — die Kosten einer Rücklastschrift werden weiterverrechnet.',
+    'pdf.erstattung.text': 'Der Betrag wird auf dem ursprünglichen Zahlungsweg erstattet. Sie müssen nichts veranlassen.',
+    'pdf.erstattung.bezug': 'Bezug',
+    'pdf.erstattung.betrag': 'Erstattungsbetrag',
+    'pdf.status.titel': 'Zahlungsstatus online verfolgen',
+    'pdf.status.text': 'Zahlung bzw. Einzug prüfen und Benachrichtigungen aktivieren.',
+    'pdf.status.link': 'Link',
+    'pdf.status.passwort': 'Passwort',
+    'pdf.fuss.kontakt': 'Kontakt',
+    'pdf.fuss.register': 'Register & Steuer',
+    'pdf.fuss.sitz': 'Sitz: {ort}',
+    'pdf.fuss.hinweis': 'Erstellt mit Kasseneck — ein Produkt der Kreiseck',
+    'pdf.seite': 'Seite {nummer} / {gesamt}',
+    'land.AT': 'Österreich',
+    'land.DE': 'Deutschland',
+    'land.CH': 'Schweiz',
+    'land.IT': 'Italien',
+    'land.LI': 'Liechtenstein',
+    'kopie.rechnung': 'Übersetzung – keine eigene Rechnung · Original: Rechnung Nr. {nummer} vom {datum}',
+    'kopie.gutschrift': 'Übersetzung – keine eigene Gutschrift · Original: Gutschrift Nr. {nummer} vom {datum}',
+    'gutschrift.einleitung': 'Grund: {grund}',
+    'gutschrift.grund.cancellation': 'Stornierung',
+    'gutschrift.grund.price_reduction': 'Preisnachlass',
+    'gutschrift.grund.return': 'Rücksendung',
+    'gutschrift.grund.incorrect_invoice': 'Fehlerhafte Rechnung',
+    'gutschrift.grund.other': 'Sonstiges',
+    'einvoice.befreiung.reverseCharge': 'Steuerschuldnerschaft des Leistungsempfängers (Reverse Charge)',
+    'einvoice.befreiung.kleinunternehmer': 'Steuerbefreit — Kleinunternehmer gemäß §6 Abs. 1 Z 27 UStG',
+    'einvoice.befreiung.igLieferung': 'Steuerfreie innergemeinschaftliche Lieferung gemäß Art. 6 Abs. 1 UStG',
+    'einvoice.befreiung.ausfuhr': 'Steuerfreie Ausfuhrlieferung gemäß §6 Abs. 1 Z 1 UStG',
+    'einvoice.zahlbarBis': 'Zahlbar bis {datum}',
+    'einheit.piece': 'Stk',
+    'einheit.pair': 'Paar',
+    'einheit.set': 'Set',
+    'einheit.dozen': 'Dtzd.',
+    'einheit.second': 'Sek.',
+    'einheit.minute': 'Min.',
+    'einheit.hour': 'Std',
+    'einheit.day': 'Tag',
+    'einheit.night': 'Nacht',
+    'einheit.week': 'Woche',
+    'einheit.month': 'Monat',
+    'einheit.quarter': 'Quartal',
+    'einheit.half_year': 'Halbjahr',
+    'einheit.year': 'Jahr',
+    'einheit.milligram': 'mg',
+    'einheit.gram': 'g',
+    'einheit.kilogram': 'kg',
+    'einheit.tonne': 't',
+    'einheit.millimetre': 'mm',
+    'einheit.centimetre': 'cm',
+    'einheit.metre': 'm',
+    'einheit.running_metre': 'lfm',
+    'einheit.kilometre': 'km',
+    'einheit.square_metre': 'm²',
+    'einheit.hectare': 'ha',
+    'einheit.millilitre': 'ml',
+    'einheit.litre': 'l',
+    'einheit.cubic_metre': 'm³',
+    'einheit.kilowatt_hour': 'kWh',
+    'einheit.megawatt_hour': 'MWh',
+    'einheit.gigabyte': 'GB',
+    'einheit.terabyte': 'TB',
+    'einheit.flat_rate': 'Pauschal',
+    'einheit.person': 'Pers.',
+    'einheit.licence': 'Lizenz',
+    'einheit.user': 'Benutzer',
+    'einheit.device': 'Gerät',
+    'einheit.session': 'Sitzung',
+    'einheit.trip': 'Fahrt',
+    'einheit.page': 'Seite',
+    'einheit.sheet': 'Blatt',
+    'einheit.package': 'Pkg.',
+    'einheit.box': 'Box',
+    'einheit.carton': 'Karton',
+    'einheit.bottle': 'Fl.',
+    'einheit.can': 'Dose',
+    'einheit.roll': 'Rolle',
+    'einheit.bag': 'Sack',
+    'einheit.pallet': 'Palette',
+    'einheitName.piece': 'Stück',
+    'einheitName.pair': 'Paar',
+    'einheitName.set': 'Set',
+    'einheitName.dozen': 'Dutzend',
+    'einheitName.second': 'Sekunde',
+    'einheitName.minute': 'Minute',
+    'einheitName.hour': 'Stunde',
+    'einheitName.day': 'Tag',
+    'einheitName.night': 'Nacht',
+    'einheitName.week': 'Woche',
+    'einheitName.month': 'Monat',
+    'einheitName.quarter': 'Quartal',
+    'einheitName.half_year': 'Halbjahr',
+    'einheitName.year': 'Jahr',
+    'einheitName.milligram': 'Milligramm',
+    'einheitName.gram': 'Gramm',
+    'einheitName.kilogram': 'Kilogramm',
+    'einheitName.tonne': 'Tonne',
+    'einheitName.millimetre': 'Millimeter',
+    'einheitName.centimetre': 'Zentimeter',
+    'einheitName.metre': 'Meter',
+    'einheitName.running_metre': 'Laufmeter',
+    'einheitName.kilometre': 'Kilometer',
+    'einheitName.square_metre': 'Quadratmeter',
+    'einheitName.hectare': 'Hektar',
+    'einheitName.millilitre': 'Milliliter',
+    'einheitName.litre': 'Liter',
+    'einheitName.cubic_metre': 'Kubikmeter',
+    'einheitName.kilowatt_hour': 'Kilowattstunde',
+    'einheitName.megawatt_hour': 'Megawattstunde',
+    'einheitName.gigabyte': 'Gigabyte',
+    'einheitName.terabyte': 'Terabyte',
+    'einheitName.flat_rate': 'Pauschale',
+    'einheitName.person': 'Person',
+    'einheitName.licence': 'Lizenz',
+    'einheitName.user': 'Benutzer',
+    'einheitName.device': 'Gerät',
+    'einheitName.session': 'Sitzung',
+    'einheitName.trip': 'Fahrt',
+    'einheitName.page': 'Seite',
+    'einheitName.sheet': 'Blatt',
+    'einheitName.package': 'Packung',
+    'einheitName.box': 'Box',
+    'einheitName.carton': 'Karton',
+    'einheitName.bottle': 'Flasche',
+    'einheitName.can': 'Dose',
+    'einheitName.roll': 'Rolle',
+    'einheitName.bag': 'Sack',
+    'einheitName.pallet': 'Palette',
+};
+const EN = {
+    'pdf.titel.rechnung': 'INVOICE',
+    'pdf.titel.gutschrift': 'CREDIT NOTE',
+    'pdf.pille.bezahlt': 'PAID',
+    'pdf.pille.lastschrift': 'SEPA DIRECT DEBIT',
+    'pdf.meta.nummer.rechnung': 'Invoice no.',
+    'pdf.meta.nummer.gutschrift': 'Credit note no.',
+    'pdf.meta.datum.rechnung': 'Invoice date',
+    'pdf.meta.datum.gutschrift': 'Credit note date',
+    'pdf.meta.leistungszeitraum': 'Service period',
+    'pdf.meta.faelligkeit': 'Due date',
+    'pdf.bezug.gutschrift': 'Credit note for invoice {nummer}',
+    'pdf.bezug.vom': ' dated {datum}',
+    'pdf.bezeichnung.rechnung': 'Invoice {nummer}',
+    'pdf.bezeichnung.gutschrift': 'Credit note {nummer}',
+    'pdf.uid': 'VAT ID: {uid}',
+    'pdf.tabelle.pos': 'POS',
+    'pdf.tabelle.beschreibung': 'DESCRIPTION',
+    'pdf.tabelle.menge': 'QTY',
+    'pdf.tabelle.ust': 'VAT',
+    'pdf.tabelle.einzelNetto': 'UNIT NET',
+    'pdf.tabelle.betragNetto': 'AMOUNT NET',
+    'pdf.summe.zwischensumme': 'Subtotal net',
+    'pdf.summe.umsatzsteuer': 'VAT {satz}%',
+    'pdf.summe.gesamt.rechnung': 'Total',
+    'pdf.summe.gesamt.gutschrift': 'Credit total',
+    'steuer.kleinunternehmer': 'No VAT charged pursuant to § 6 (1) no. 27 UStG (small business exemption).',
+    'steuer.igLieferung': 'VAT-exempt intra-Community supply (Art. 6 (1) UStG).',
+    'steuer.ausfuhr': 'VAT-exempt export delivery (§ 6 (1) no. 1 UStG).',
+    'steuer.reverseCharge.titel': 'VAT-exempt service – reverse charge. ',
+    'steuer.reverseCharge.text': 'VAT liability transferred to the recipient pursuant to Art. 196 of VAT Directive 2006/112/EC (intra-Community service). VAT is to be accounted for by the recipient in the country of destination.',
+    'steuer.reverseCharge.uid': 'VAT ID supplier: {verkaeufer}   ·   VAT ID recipient: {kaeufer}',
+    'pdf.zahlung.titel': 'PAYMENT DETAILS',
+    'pdf.zahlung.empfaenger': 'Payee',
+    'pdf.zahlung.iban': 'IBAN',
+    'pdf.zahlung.bic': 'BIC',
+    'pdf.zahlung.verwendungszweck': 'Payment reference',
+    'pdf.zahlung.hinweisBis': 'Payable without deduction by {datum}. Thank you for your business.',
+    'pdf.zahlung.hinweis': 'Payable without deduction. Thank you for your business.',
+    'pdf.zahlung.qr': 'Scan with your banking app to pay',
+    'pdf.bezahlt.text': 'This invoice has been paid. No further action is required.',
+    'pdf.bezahlt.am': 'Paid on',
+    'pdf.bezahlt.zahlungsart': 'Payment method',
+    'zahlungsart.cash': 'Cash',
+    'zahlungsart.transfer': 'Bank transfer',
+    'zahlungsart.card': 'Card',
+    'zahlungsart.online': 'Online',
+    'pdf.lastschrift.text': 'The amount will be collected by SEPA direct debit. No action is required on your part.',
+    'pdf.lastschrift.einzugAm': 'Collection date',
+    'pdf.lastschrift.konto': 'Account',
+    'pdf.lastschrift.mandatsreferenz': 'Mandate reference',
+    'pdf.lastschrift.mandatVom': 'Mandate date',
+    'pdf.lastschrift.warnung': 'Please ensure sufficient funds — the costs of a returned direct debit will be charged to you.',
+    'pdf.erstattung.text': 'The amount will be refunded via the original payment method. No action is required on your part.',
+    'pdf.erstattung.bezug': 'Reference',
+    'pdf.erstattung.betrag': 'Refund amount',
+    'pdf.status.titel': 'Track payment status online',
+    'pdf.status.text': 'Check payment or direct debit status and turn on notifications.',
+    'pdf.status.link': 'Link',
+    'pdf.status.passwort': 'Password',
+    'pdf.fuss.kontakt': 'Contact',
+    'pdf.fuss.register': 'Registration & tax',
+    'pdf.fuss.sitz': 'Registered office: {ort}',
+    'pdf.fuss.hinweis': 'Created with Kasseneck — a Kreiseck product',
+    'pdf.seite': 'Page {nummer} / {gesamt}',
+    'land.AT': 'Austria',
+    'land.DE': 'Germany',
+    'land.CH': 'Switzerland',
+    'land.IT': 'Italy',
+    'land.LI': 'Liechtenstein',
+    'kopie.rechnung': 'Translation – not a separate invoice · Original: Invoice No. {nummer} dated {datum}',
+    'kopie.gutschrift': 'Translation – not a separate credit note · Original: Credit note No. {nummer} dated {datum}',
+    'gutschrift.einleitung': 'Reason: {grund}',
+    'gutschrift.grund.cancellation': 'Cancellation',
+    'gutschrift.grund.price_reduction': 'Price reduction',
+    'gutschrift.grund.return': 'Return',
+    'gutschrift.grund.incorrect_invoice': 'Incorrect invoice',
+    'gutschrift.grund.other': 'Other',
+    'einvoice.befreiung.reverseCharge': 'Reverse charge – VAT liability of the recipient',
+    'einvoice.befreiung.kleinunternehmer': 'VAT exempt — small business pursuant to § 6 (1) no. 27 UStG',
+    'einvoice.befreiung.igLieferung': 'VAT-exempt intra-Community supply pursuant to Art. 6 (1) UStG',
+    'einvoice.befreiung.ausfuhr': 'VAT-exempt export delivery pursuant to § 6 (1) no. 1 UStG',
+    'einvoice.zahlbarBis': 'Payable by {datum}',
+    'einheit.piece': 'pcs',
+    'einheit.pair': 'pair',
+    'einheit.set': 'set',
+    'einheit.dozen': 'doz.',
+    'einheit.second': 'sec',
+    'einheit.minute': 'min',
+    'einheit.hour': 'h',
+    'einheit.day': 'day',
+    'einheit.night': 'night',
+    'einheit.week': 'wk',
+    'einheit.month': 'mo',
+    'einheit.quarter': 'qtr',
+    'einheit.half_year': 'half-yr',
+    'einheit.year': 'yr',
+    'einheit.milligram': 'mg',
+    'einheit.gram': 'g',
+    'einheit.kilogram': 'kg',
+    'einheit.tonne': 't',
+    'einheit.millimetre': 'mm',
+    'einheit.centimetre': 'cm',
+    'einheit.metre': 'm',
+    'einheit.running_metre': 'rm',
+    'einheit.kilometre': 'km',
+    'einheit.square_metre': 'm²',
+    'einheit.hectare': 'ha',
+    'einheit.millilitre': 'ml',
+    'einheit.litre': 'l',
+    'einheit.cubic_metre': 'm³',
+    'einheit.kilowatt_hour': 'kWh',
+    'einheit.megawatt_hour': 'MWh',
+    'einheit.gigabyte': 'GB',
+    'einheit.terabyte': 'TB',
+    'einheit.flat_rate': 'flat',
+    'einheit.person': 'pers.',
+    'einheit.licence': 'licence',
+    'einheit.user': 'user',
+    'einheit.device': 'device',
+    'einheit.session': 'session',
+    'einheit.trip': 'trip',
+    'einheit.page': 'page',
+    'einheit.sheet': 'sheet',
+    'einheit.package': 'pkg',
+    'einheit.box': 'box',
+    'einheit.carton': 'ctn',
+    'einheit.bottle': 'btl',
+    'einheit.can': 'can',
+    'einheit.roll': 'roll',
+    'einheit.bag': 'bag',
+    'einheit.pallet': 'plt',
+    'einheitName.piece': 'piece',
+    'einheitName.pair': 'pair',
+    'einheitName.set': 'set',
+    'einheitName.dozen': 'dozen',
+    'einheitName.second': 'second',
+    'einheitName.minute': 'minute',
+    'einheitName.hour': 'hour',
+    'einheitName.day': 'day',
+    'einheitName.night': 'night',
+    'einheitName.week': 'week',
+    'einheitName.month': 'month',
+    'einheitName.quarter': 'quarter',
+    'einheitName.half_year': 'half year',
+    'einheitName.year': 'year',
+    'einheitName.milligram': 'milligram',
+    'einheitName.gram': 'gram',
+    'einheitName.kilogram': 'kilogram',
+    'einheitName.tonne': 'tonne',
+    'einheitName.millimetre': 'millimetre',
+    'einheitName.centimetre': 'centimetre',
+    'einheitName.metre': 'metre',
+    'einheitName.running_metre': 'running metre',
+    'einheitName.kilometre': 'kilometre',
+    'einheitName.square_metre': 'square metre',
+    'einheitName.hectare': 'hectare',
+    'einheitName.millilitre': 'millilitre',
+    'einheitName.litre': 'litre',
+    'einheitName.cubic_metre': 'cubic metre',
+    'einheitName.kilowatt_hour': 'kilowatt hour',
+    'einheitName.megawatt_hour': 'megawatt hour',
+    'einheitName.gigabyte': 'gigabyte',
+    'einheitName.terabyte': 'terabyte',
+    'einheitName.flat_rate': 'flat rate',
+    'einheitName.person': 'person',
+    'einheitName.licence': 'licence',
+    'einheitName.user': 'user',
+    'einheitName.device': 'device',
+    'einheitName.session': 'session',
+    'einheitName.trip': 'trip',
+    'einheitName.page': 'page',
+    'einheitName.sheet': 'sheet',
+    'einheitName.package': 'package',
+    'einheitName.box': 'box',
+    'einheitName.carton': 'carton',
+    'einheitName.bottle': 'bottle',
+    'einheitName.can': 'can',
+    'einheitName.roll': 'roll',
+    'einheitName.bag': 'bag',
+    'einheitName.pallet': 'pallet',
+};
+exports.RECHNUNG_TEXTE = Object.freeze({ de: Object.freeze({ ...DE }), en: Object.freeze({ ...EN }) });
+/** Ein Text der gewaehlten Sprache mit eingesetzten Werten; ein fehlender Wert ist ein Programmierfehler. */
+function rechnungText(sprache, schluessel, werte = {}) {
+    return exports.RECHNUNG_TEXTE[sprache][schluessel].replace(/\{([a-zA-Z]+)\}/g, (_voll, name) => {
+        if (!(name in werte))
+            throw new Error(`rechnungText ${schluessel}: Wert {${name}} fehlt`);
+        return String(werte[name]);
+    });
+}

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

@@ -5,7 +5,7 @@
  * Betraege sind ueberall ganze Cent. Datumsangaben sind `YYYY-MM-DD` nach
  * Wiener Kalender.
  */
-import type { CreditNoteReason, CustomerType, DocType, InvoiceSetupRequirement, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent } from './vertrag.js';
+import type { CreditNoteReason, CustomerType, DocType, InvoiceLanguage, InvoiceNoticeCode, InvoicePaymentMethod, InvoiceUnit, InvoiceSetupRequirement, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent } from './vertrag.js';
 export interface CustomerInput {
     type: CustomerType;
     name: string;
@@ -27,6 +27,8 @@ export interface CustomerInput {
     note?: string;
     /** Kennung im eigenen System; je Konto eindeutig. */
     externalId?: string;
+    /** Sprache der Rechnungen an diesen Kunden; fehlt = `de`. Behoerden immer `de`. */
+    language?: InvoiceLanguage;
 }
 export interface Customer {
     id: string;
@@ -45,6 +47,7 @@ export interface Customer {
     isAuthority: boolean;
     note: string | null;
     externalId: string | null;
+    language: InvoiceLanguage;
     createdAt: string | null;
     updatedAt: string | null;
 }
@@ -66,7 +69,8 @@ export interface InvoiceItemInput {
     subtitle?: string;
     /** Hoechstens drei Nachkommastellen. */
     quantity: number;
-    unit?: string;
+    /** Einheit aus `INVOICE_UNITS`; ohne Angabe `piece`. */
+    unit?: InvoiceUnit;
     /** Einzelpreis in ganzen Cent, im `priceMode` der Rechnung (netto oder brutto). */
     unitPriceCents: number;
     vatRate: VatRatePercent;
@@ -94,6 +98,53 @@ export interface IssueInvoiceRequest {
     items: InvoiceItemInput[];
     /** Eigene Merkmale (hoechstens 20), nie gedruckt. */
     metadata?: Record<string, string>;
+    /** Sprache dieser Rechnung; sonst die des Kunden, sonst `de`. Eine Rechnung, eine Nummer, eine Sprache. */
+    language?: InvoiceLanguage;
+    /** Marke (Kennung aus `listBrands`); sonst die Standardmarke. Unbekannt = `brand_not_found`. */
+    brandId?: string;
+    /**
+     * Schon bezahlt (Shop kassiert online, Rechnung folgt). Die Zahlung entsteht
+     * in derselben Transaktion wie das Festschreiben: das PDF traegt dann keine
+     * Zahlungsinformationen und keinen Giro-QR.
+     */
+    payment?: PaymentInput;
+}
+/** Eine Zahlung, wie das Fremdsystem sie meldet. */
+export interface PaymentInput {
+    method: InvoicePaymentMethod;
+    /** Ohne Angabe der volle Bruttobetrag. */
+    amountCents?: number;
+    /** Ohne Angabe der heutige Wiener Tag; nie in der Zukunft. */
+    paidAt?: string;
+    /** Zahlungskennung des Fremdsystems — gespeichert, aber nicht gedruckt. */
+    reference?: string;
+}
+export interface RecordPaymentRequest extends PaymentInput {
+    /** Pflicht: ohne ihn bucht eine Wiederholung eine zweite Zahlung. */
+    idempotencyKey: string;
+    invoiceId: string;
+}
+/** Eine gebuchte Zahlung, wie die API sie zurueckgibt. */
+export interface InvoicePayment {
+    id: string;
+    amountCents: number;
+    paidAt: string;
+    method: InvoicePaymentMethod;
+    reference: string | null;
+}
+/**
+ * Ein Hinweis zu einer erfolgreichen Antwort — kein Fehler, sondern etwas,
+ * das der Aufrufer wissen sollte (heute nur `cash_receipt_required`).
+ */
+export interface InvoiceNotice {
+    code: InvoiceNoticeCode;
+    message: string;
+}
+export interface RecordPaymentResult {
+    invoice: Invoice;
+    payment: InvoicePayment;
+    replayed: boolean;
+    notice?: InvoiceNotice;
 }
 export interface CancelInvoiceRequest {
     idempotencyKey: string;
@@ -132,6 +183,23 @@ export interface Invoice {
     statusUrl: string | null;
     statusPassword: string | null;
     metadata: Record<string, string>;
+    /** Beim Festschreiben eingefroren; aeltere Rechnungen `de`. */
+    language: InvoiceLanguage;
+    /** Die eingefrorene Marke; `id` ist `null` bei der Ersatzmarke ohne eigene Einrichtung. */
+    brand: {
+        id: string | null;
+        name: string | null;
+    } | null;
+    /** Summe der gebuchten Zahlungen. */
+    paidCents: number;
+    /** Was noch offen ist; `0` heisst bezahlt. */
+    openCents: number;
+}
+/** Eine Marke des Kontos (Logo, Farbe, Absender) — `id` geht als `brandId` in `issueInvoice`. */
+export interface Brand {
+    id: string;
+    name: string;
+    isDefault: boolean;
 }
 export interface InvoiceRecipient {
     name: string;

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

@@ -18,13 +18,13 @@
  * Nummer, Summen — ist bewusst **nicht** setzbar.
  */
 export declare const RECHNUNG_VERTRAG_VERSION = 1;
-export declare const RECHNUNG_AUFRUFE: readonly ["createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus"];
+export declare const RECHNUNG_AUFRUFE: readonly ["createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus", "listBrands", "recordInvoicePayment"];
 export type RechnungAufruf = (typeof RECHNUNG_AUFRUFE)[number];
 /**
  * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
  * aendern. `validation` traegt zusaetzlich `errors: [{ field, message }]`.
  */
-export declare const INVOICE_ERROR_CODES: readonly ["validation", "idempotency_conflict", "module_inactive", "customer_not_found", "customer_exists", "short_code_taken", "short_code_immutable", "recipient_required", "invoice_requirements_missing", "invoice_not_found", "invoice_ambiguous", "not_cancellable", "partial_credit_exists", "credit_exceeds_invoice", "einvoice_incomplete", "invoice_api_not_enabled", "invoice_setup_incomplete"];
+export declare const INVOICE_ERROR_CODES: readonly ["validation", "idempotency_conflict", "module_inactive", "customer_not_found", "customer_exists", "short_code_taken", "short_code_immutable", "recipient_required", "invoice_requirements_missing", "invoice_not_found", "invoice_ambiguous", "not_cancellable", "partial_credit_exists", "credit_exceeds_invoice", "einvoice_incomplete", "invoice_api_not_enabled", "invoice_setup_incomplete", "language_not_allowed", "brand_not_found", "not_payable", "payment_exceeds_invoice"];
 export type InvoiceErrorCode = (typeof INVOICE_ERROR_CODES)[number];
 /** Gruende einer Gutschrift. Der Server druckt den deutschen Anzeigetext. */
 export declare const CREDIT_NOTE_REASONS: readonly ["cancellation", "price_reduction", "return", "incorrect_invoice", "other"];
@@ -43,6 +43,43 @@ export declare const DOC_TYPES: readonly ["RE", "GU"];
 export type DocType = (typeof DOC_TYPES)[number];
 export declare const EINVOICE_FORMATS: readonly ["ubl", "cii"];
 export type EInvoiceFormat = (typeof EINVOICE_FORMATS)[number];
+/**
+ * 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.
+ */
+export declare const INVOICE_LANGUAGES: readonly ["de", "en"];
+export type InvoiceLanguage = (typeof INVOICE_LANGUAGES)[number];
+/**
+ * Wie eine Rechnung bezahlt wurde. Der Vermerk ist Buchhaltung, kein Beleg:
+ * `cash` wird gebucht, die Antwort traegt dann zusaetzlich den Hinweis
+ * `cash_receipt_required` — eine Barzahlung ist ein Barumsatz und braucht
+ * einen Beleg (§ 132a BAO), bei Registrierkassenpflicht ueber die Kasse.
+ */
+export declare const INVOICE_PAYMENT_METHODS: readonly ["transfer", "card", "online", "cash"];
+export type InvoicePaymentMethod = (typeof INVOICE_PAYMENT_METHODS)[number];
+/**
+ * Hinweise, die eine erfolgreiche Antwort zusaetzlich tragen kann (`data.notice`).
+ * Sie sind keine Fehler: der Aufruf hat gewirkt, es gibt nur etwas zu wissen.
+ */
+export declare const INVOICE_NOTICE_CODES: readonly ["cash_receipt_required"];
+export type InvoiceNoticeCode = (typeof INVOICE_NOTICE_CODES)[number];
+/**
+ * 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`.
+ */
+export declare const INVOICE_UNITS: readonly ["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"];
+export type InvoiceUnit = (typeof INVOICE_UNITS)[number];
+/**
+ * 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`).
+ */
+export declare const RECHNUNG_EINHEITEN_CODES: Readonly<Record<InvoiceUnit, string>>;
 /**
  * Was erfuellt sein muss, bevor ueber die API ausgestellt werden darf — in
  * dieser Reihenfolge meldet `getInvoiceSetupStatus`, was fehlt, und dieselben
@@ -106,6 +143,14 @@ export type Feld = {
 export declare const KUNDE_FELDER: Readonly<Record<string, Feld>>;
 /** Eine Rechnungs- oder Gutschriftsposition. Preise in ganzen Cent. */
 export declare const POSITION_FELDER: Readonly<Record<string, Feld>>;
+/**
+ * Eine Zahlung zu einer Rechnung. Ohne `amountCents` gilt der volle
+ * Bruttobetrag, ohne `paidAt` der heutige Wiener Tag. `reference` ist die
+ * Zahlungskennung des Fremdsystems (z. B. `pi_3Q...`) — sie wird gespeichert,
+ * aber **nicht gedruckt**: die Rechnung wird aufbewahrt und vervielfaeltigt,
+ * und dem Empfaenger nuetzt sie nichts.
+ */
+export declare const PAYMENT_FELDER: Readonly<Record<string, Feld>>;
 export declare const RECHNUNG_ANFRAGEN: Readonly<Record<RechnungAufruf, Readonly<Record<string, Feld>>>>;
 /** Genau eines dieser Felder muss gesetzt sein (je Aufruf, je Gruppe). */
 export declare const RECHNUNG_GENAU_EINS: Readonly<Partial<Record<RechnungAufruf, readonly (readonly string[])[]>>>;