@kreiseck/kasseneck-api 0.20.0 → 0.22.0

package/dist/esm/rechnung/endpunkte.js

@@ -39,6 +39,33 @@ function seite(aufruf, daten, feld) {
     return { eintraege: o[feld], nextCursor: typeof o['nextCursor'] === 'string' ? o['nextCursor'] : null };
 }
 const zahl = (wert) => (typeof wert === 'number' && Number.isFinite(wert) ? wert : 0);
+/**
+ * Die Hinweise einer Antwort (`data.notice`) — immer eine Liste, `undefined`
+ * ohne Hinweis. Ein einzelnes Objekt (Server vor der Vereinheitlichung) wird
+ * zur Liste.
+ *
+ * Ein unbrauchbarer Eintrag wird uebergangen, nicht geworfen: der Aufruf hat
+ * schon gewirkt (die Rechnung ist ausgestellt, die Zahlung gebucht). Ein
+ * Fehler an dieser Stelle liesse den Aufrufer glauben, es sei nichts
+ * entstanden — und eine Wiederholung liefert die Hinweise nicht noch einmal.
+ */
+function hinweise(daten) {
+    const roh = objekt(daten)['notice'];
+    if (roh === undefined || roh === null)
+        return undefined;
+    const liste = (Array.isArray(roh) ? roh : [roh]).filter((h) => typeof objekt(h)['code'] === 'string' && typeof objekt(h)['message'] === 'string');
+    return liste.length ? liste : undefined;
+}
+/**
+ * Eine Kennung muss ein Objekt sein (`{ invoiceId }`, `{ customerId }` …). Ein
+ * blosser Text wuerde sonst Zeichen fuer Zeichen zu Feldern `0`, `1`, …
+ * zerlegt, und der Server koennte nur „Bitte Eingaben pruefen" antworten.
+ */
+function kennungVerlangen(aufruf, kennung, felder) {
+    if (kennung === null || typeof kennung !== 'object' || Array.isArray(kennung)) {
+        throw new KasseneckValidationError(aufruf, `Kennung als Objekt erwartet: ${felder}`, 'request');
+    }
+}
 /** Anfrageobjekt als Nutzlast — flache Kopie, damit der Aufrufer sein Objekt behaelt. */
 const nutzlast = (anfrage) => ({ ...anfrage });
 // ---- Kunden -----------------------------------------------------------------
@@ -50,6 +77,7 @@ export async function createCustomer(rufen, customer, optionen = {}) {
     return pflichtObjekt('createCustomer', daten, 'customer');
 }
 export async function getCustomer(rufen, kennung) {
+    kennungVerlangen('getCustomer', kennung, '{ customerId } oder { externalId }');
     const daten = await rufen('getCustomer', nutzlast(kennung));
     return pflichtObjekt('getCustomer', daten, 'customer');
 }
@@ -65,10 +93,32 @@ export async function searchCustomers(rufen, suche) {
 // ---- Rechnungen -------------------------------------------------------------
 export async function issueInvoice(rufen, anfrage) {
     const daten = await rufen('issueInvoice', nutzlast(anfrage));
-    return {
+    const ergebnis = {
         invoice: pflichtObjekt('issueInvoice', daten, 'invoice'),
         replayed: objekt(daten)['replayed'] === true,
     };
+    const notice = hinweise(daten);
+    if (notice)
+        ergebnis.notice = notice;
+    return ergebnis;
+}
+/**
+ * Probelauf von `issueInvoice`: dieselbe Anfrage wird geprueft und gerechnet
+ * wie beim Ausstellen, aber nichts festgeschrieben. Die Antwort nennt Summen,
+ * Steuerfall, Sprache, Marke und die Hinweise — oder scheitert mit demselben
+ * Fehlercode, mit dem das Ausstellen scheitern wuerde.
+ *
+ * Der `idempotencyKey` wird nicht verbraucht: dieselbe Anfrage laesst sich
+ * 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 });
+    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));
@@ -88,6 +138,7 @@ export async function createCreditNote(rufen, anfrage) {
     };
 }
 export async function getInvoice(rufen, kennung) {
+    kennungVerlangen('getInvoice', kennung, '{ invoiceId } oder { number }');
     const daten = await rufen('getInvoice', nutzlast(kennung));
     return pflichtObjekt('getInvoice', daten, 'invoice');
 }
@@ -143,8 +194,9 @@ export async function recordInvoicePayment(rufen, anfrage) {
         payment: pflichtObjekt('recordInvoicePayment', daten, 'payment'),
         replayed: roh['replayed'] === true,
     };
-    if (roh['notice'])
-        ergebnis.notice = roh['notice'];
+    const notice = hinweise(daten);
+    if (notice)
+        ergebnis.notice = notice;
     return ergebnis;
 }
 /** Die Marken des Kontos — die Kennung geht als `brandId` in `issueInvoice`. */

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

@@ -13,7 +13,8 @@
 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, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, recordInvoicePayment, 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, InvoiceNotice, InvoicePayment, IssueInvoiceRequest, IssueResult, PaymentInput, RecordPaymentRequest, RecordPaymentResult, } from './typen.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, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceSetupGap, InvoiceSetupStatus, InvoiceTotals, InvoiceNotice, InvoicePayment, InvoicePreview, InvoiceRateTotals, IssueInvoiceRequest, IssueResult, PaymentInput, PreviewResult, RecordPaymentRequest, RecordPaymentResult, } from './typen.js';
 export { RECHNUNG_TEXTE, rechnungText, type RechnungTextSchluessel } from './texte.js';
-export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, INVOICE_LANGUAGES, INVOICE_PAYMENT_METHODS, INVOICE_NOTICE_CODES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, type RechnungAufruf, type InvoiceErrorCode, type CreditNoteReason, type TaxScheme, type PriceMode, type VatRatePercent, type CustomerType, type InvoiceListStatus, type DocType, type EInvoiceFormat, type InvoiceLanguage, type InvoicePaymentMethod, type InvoiceNoticeCode, type InvoiceUnit, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.js';
+export { rechnungSummen, STEUERFREIE_FAELLE, type SummenPosition } from './summen.js';
+export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, INVOICE_LANGUAGES, INVOICE_PAYMENT_METHODS, ITEM_KINDS, REVERSE_CHARGE_REASONS, INVOICE_NOTICE_CODES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, type RechnungAufruf, type InvoiceErrorCode, type CreditNoteReason, type TaxScheme, type PriceMode, type VatRatePercent, type CustomerType, type InvoiceListStatus, type DocType, type EInvoiceFormat, type InvoiceLanguage, type InvoicePaymentMethod, type ItemKind, type ReverseChargeReason, type InvoiceNoticeCode, type InvoiceUnit, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.js';

package/dist/esm/rechnung/index.js

@@ -13,6 +13,7 @@
 export { createRechnungApi } from './api.js';
 export { rechnungKeyAuth } from './auth.js';
 export { istRechnungFehler, rechnungFehlerCode, rechnungFeldFehler, } from './fehler.js';
-export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, recordInvoicePayment, searchCustomers, updateCustomer, } from './endpunkte.js';
+export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, previewInvoice, recordInvoicePayment, 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_PAYMENT_METHODS, INVOICE_NOTICE_CODES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, } from './vertrag.js';
+export { rechnungSummen, STEUERFREIE_FAELLE } from './summen.js';
+export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, INVOICE_LANGUAGES, INVOICE_PAYMENT_METHODS, ITEM_KINDS, REVERSE_CHARGE_REASONS, INVOICE_NOTICE_CODES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, } from './vertrag.js';

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

@@ -0,0 +1,41 @@
+/**
+ * Summen einer Rechnung vorab rechnen — genau so, wie der Server sie beim
+ * Ausstellen rechnet. Fuer Shops, die kassieren, bevor die Rechnung entsteht,
+ * und denselben Betrag brauchen, den die Rechnung spaeter ausweist.
+ *
+ * Die Regel (je USt-Satz, Betraege in Cent, kaufmaennisch gerundet):
+ *
+ * | Modus   | Netto                          | USt                        | Brutto             |
+ * |---------|--------------------------------|----------------------------|--------------------|
+ * | `net`   | round(Σ Zeilen)                | round(Σ Zeilen × Satz/100) | Netto + USt        |
+ * | `gross` | round(B × 100 / (100 + Satz))  | B − Netto                  | B = round(Σ Zeilen)|
+ *
+ * Zeile = Einzelpreis × Menge × (1 − Rabatt/100), ungerundet. Im Brutto-Modus
+ * 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
+ * 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';
+/** Was fuer die Summe zaehlt — `InvoiceItemInput` passt unveraendert. */
+export interface SummenPosition {
+    quantity: number;
+    unitPriceCents: number;
+    vatRate: number;
+    discountPct?: number;
+}
+/** Steuerfaelle, in denen die Rechnung keine Steuer ausweist: jede Zeile zaehlt zu 0 %. */
+export declare const STEUERFREIE_FAELLE: readonly TaxScheme[];
+/**
+ * Netto, USt und Brutto einer Rechnung in Cent, je Satz absteigend — dieselbe
+ * Form wie `invoice.totals` in den Antworten.
+ *
+ * `taxScheme` ist der Steuerfall der Rechnung; ohne Angabe `normal`. Leitet der
+ * Server einen steuerfreien Fall ab (etwa eine ig. Lieferung), gehoert dieser
+ * Fall hierher — sonst rechnet die Funktion Steuer, die die Rechnung nicht
+ * ausweist.
+ */
+export declare function rechnungSummen(items: readonly SummenPosition[], priceMode: PriceMode, taxScheme?: TaxScheme): InvoiceTotals;

package/dist/esm/rechnung/summen.js

@@ -0,0 +1,77 @@
+/**
+ * Summen einer Rechnung vorab rechnen — genau so, wie der Server sie beim
+ * Ausstellen rechnet. Fuer Shops, die kassieren, bevor die Rechnung entsteht,
+ * und denselben Betrag brauchen, den die Rechnung spaeter ausweist.
+ *
+ * Die Regel (je USt-Satz, Betraege in Cent, kaufmaennisch gerundet):
+ *
+ * | Modus   | Netto                          | USt                        | Brutto             |
+ * |---------|--------------------------------|----------------------------|--------------------|
+ * | `net`   | round(Σ Zeilen)                | round(Σ Zeilen × Satz/100) | Netto + USt        |
+ * | `gross` | round(B × 100 / (100 + Satz))  | B − Netto                  | B = round(Σ Zeilen)|
+ *
+ * Zeile = Einzelpreis × Menge × (1 − Rabatt/100), ungerundet. Im Brutto-Modus
+ * 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
+ * Dart-Zwilling pruefen gegen dieselbe Datei. Verbindlich bleibt, was der
+ * Server rechnet — mit `previewInvoice` laesst sich das vorab abfragen.
+ */
+/** Steuerfaelle, in denen die Rechnung keine Steuer ausweist: jede Zeile zaehlt zu 0 %. */
+export const STEUERFREIE_FAELLE = Object.freeze([
+    'smallBusiness',
+    'reverseCharge',
+    'igLieferung',
+    'exportThirdCountry',
+    'domesticReverseCharge',
+    'outsideScope',
+]);
+/** 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;
+}
+const euroZuCent = (euro) => Math.round(euroRund(euro) * 100) || 0;
+/** Ganze Cent kaufmaennisch; ein Gleitkomma-Rest wie x,4999999… zaehlt als halber Cent. */
+function centRund(x) {
+    const betrag = Math.round(Math.abs(x) * 1e6) / 1e6;
+    return (x < 0 ? -1 : 1) * Math.round(betrag) || 0;
+}
+/**
+ * Netto, USt und Brutto einer Rechnung in Cent, je Satz absteigend — dieselbe
+ * Form wie `invoice.totals` in den Antworten.
+ *
+ * `taxScheme` ist der Steuerfall der Rechnung; ohne Angabe `normal`. Leitet der
+ * Server einen steuerfreien Fall ab (etwa eine ig. Lieferung), gehoert dieser
+ * Fall hierher — sonst rechnet die Funktion Steuer, die die Rechnung nicht
+ * ausweist.
+ */
+export function rechnungSummen(items, priceMode, taxScheme = 'normal') {
+    const steuerfrei = STEUERFREIE_FAELLE.includes(taxScheme);
+    const bruttoPreise = priceMode === 'gross' && !steuerfrei;
+    // Ungerundete Zeilen je Satz, in Euro wie am Server.
+    const jeSatz = new Map();
+    for (const p of items) {
+        const satz = steuerfrei ? 0 : p.vatRate;
+        const zeile = (p.unitPriceCents / 100) * p.quantity * (1 - (p.discountPct ?? 0) / 100);
+        jeSatz.set(satz, (jeSatz.get(satz) ?? 0) + zeile);
+    }
+    const byRate = [];
+    for (const [rate, roh] of jeSatz) {
+        let netCents;
+        let vatCents;
+        if (bruttoPreise) {
+            const grossCents = euroZuCent(roh);
+            netCents = centRund((grossCents * 100) / (100 + rate));
+            vatCents = grossCents - netCents;
+        }
+        else {
+            netCents = euroZuCent(roh);
+            vatCents = euroZuCent((roh * rate) / 100);
+        }
+        byRate.push({ rate, netCents, vatCents, grossCents: netCents + vatCents });
+    }
+    byRate.sort((a, b) => b.rate - a.rate);
+    const summe = (feld) => byRate.reduce((s, r) => s + r[feld], 0);
+    return { netCents: summe('netCents'), vatCents: summe('vatCents'), grossCents: summe('grossCents'), byRate };
+}

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

@@ -35,8 +35,12 @@ declare const DE: {
     readonly 'pdf.tabelle.ust': "UST";
     readonly 'pdf.tabelle.einzelNetto': "EINZEL NETTO";
     readonly 'pdf.tabelle.betragNetto': "BETRAG NETTO";
+    readonly 'pdf.tabelle.einzelBrutto': "EINZEL BRUTTO";
+    readonly 'pdf.tabelle.betragBrutto': "BETRAG BRUTTO";
+    readonly 'pdf.position.rabatt': "abzüglich {prozent} % Rabatt";
     readonly 'pdf.summe.zwischensumme': "Zwischensumme netto";
     readonly 'pdf.summe.umsatzsteuer': "Umsatzsteuer {satz}%";
+    readonly 'pdf.summe.darinUst': "darin {satz}% USt von {netto} netto";
     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).";
@@ -46,6 +50,20 @@ declare const DE: {
     readonly 'steuer.reverseCharge.titel': "Steuerschuldnerschaft des Leistungsempfängers. ";
     readonly 'steuer.reverseCharge.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 'steuer.uidZeile': "UID Leistungserbringer: {verkaeufer}   ·   UID Leistungsempfänger: {kaeufer}";
+    readonly 'steuer.rcGrund.construction': "Bauleistung gemäß § 19 Abs. 1a UStG.";
+    readonly 'steuer.rcGrund.scrap': "Schrott und Abfallstoffe gemäß Schrott-Umsatzsteuerverordnung (BGBl. II Nr. 129/2007).";
+    readonly 'steuer.rcGrund.mobile_devices': "Mobilfunkgeräte bzw. integrierte Schaltkreise gemäß § 19 Abs. 1e lit. b UStG.";
+    readonly 'steuer.rcGrund.it_devices': "Laptops, Tablets bzw. Videospielkonsolen gemäß § 2 Z 1 Umsatzsteuerbetrugsbekämpfungsverordnung (BGBl. II Nr. 369/2013).";
+    readonly 'steuer.rcGrund.metals': "Metalle gemäß § 2 Z 4 Umsatzsteuerbetrugsbekämpfungsverordnung.";
+    readonly 'steuer.rcGrund.emission_certificates': "Treibhausgasemissionszertifikate gemäß § 19 Abs. 1e lit. a UStG.";
+    readonly 'steuer.rcGrund.gas_electricity': "Lieferung von Gas oder Elektrizität an einen Wiederverkäufer gemäß § 2 Z 2 Umsatzsteuerbetrugsbekämpfungsverordnung.";
+    readonly 'steuer.rcGrund.energy_certificates': "Gas- und Elektrizitätszertifikate gemäß § 2 Z 3 Umsatzsteuerbetrugsbekämpfungsverordnung.";
+    readonly 'steuer.rcGrund.investment_gold': "Steuerpflichtige Lieferung von Anlagegold gemäß § 2 Z 5 Umsatzsteuerbetrugsbekämpfungsverordnung.";
+    readonly 'steuer.rcGrund.security_transfer': "Lieferung von Sicherungs- bzw. Vorbehaltseigentum gemäß § 19 Abs. 1b UStG.";
+    readonly 'steuer.rcGrund.foreign_supplier': "Leistung eines nicht im Inland ansässigen Unternehmers gemäß § 19 Abs. 1 zweiter Satz UStG.";
+    readonly 'steuer.domestic.text': "Die Umsatzsteuer schuldet und entrichtet der Leistungsempfänger. Die Leistung ist nicht steuerfrei.";
+    readonly 'steuer.outsideScope.titel': "Nicht steuerbarer Umsatz. ";
+    readonly 'steuer.outsideScope.text': "Der Leistungsort liegt gemäß § 3a Abs. 6 UStG im Ansässigkeitsstaat des Leistungsempfängers; in Österreich fällt keine Umsatzsteuer an.";
     readonly 'pdf.zahlung.titel': "ZAHLUNGSINFORMATIONEN";
     readonly 'pdf.zahlung.empfaenger': "Empfänger";
     readonly 'pdf.zahlung.iban': "IBAN";
@@ -95,6 +113,7 @@ declare const DE: {
     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.outsideScope': "Nicht steuerbarer Umsatz — Leistungsort im Ausland (§ 3a Abs. 6 UStG)";
     readonly 'einvoice.befreiung.ausfuhr': "Steuerfreie Ausfuhrlieferung gemäß §6 Abs. 1 Z 1 UStG";
     readonly 'einvoice.zahlbarBis': "Zahlbar bis {datum}";
     readonly 'einheit.piece': "Stk";

package/dist/esm/rechnung/texte.js

@@ -20,8 +20,12 @@ const DE = {
     'pdf.tabelle.ust': 'UST',
     'pdf.tabelle.einzelNetto': 'EINZEL NETTO',
     'pdf.tabelle.betragNetto': 'BETRAG NETTO',
+    'pdf.tabelle.einzelBrutto': 'EINZEL BRUTTO',
+    'pdf.tabelle.betragBrutto': 'BETRAG BRUTTO',
+    'pdf.position.rabatt': 'abzüglich {prozent} % Rabatt',
     'pdf.summe.zwischensumme': 'Zwischensumme netto',
     'pdf.summe.umsatzsteuer': 'Umsatzsteuer {satz}%',
+    'pdf.summe.darinUst': 'darin {satz}% USt von {netto} netto',
     'pdf.summe.gesamt.rechnung': 'Gesamtbetrag',
     'pdf.summe.gesamt.gutschrift': 'Gutschriftsbetrag',
     'steuer.kleinunternehmer': 'Gemäß § 6 Abs. 1 Z 27 UStG wird keine Umsatzsteuer verrechnet (Kleinunternehmer).',
@@ -37,6 +41,22 @@ const DE = {
     // Beide UID-Nummern: bei Reverse Charge § 11 Abs. 1a, bei der ig. Lieferung
     // Art. 11 Abs. 2 UStG.
     'steuer.uidZeile': 'UID Leistungserbringer: {verkaeufer}   ·   UID Leistungsempfänger: {kaeufer}',
+    // Inlands-Reverse-Charge: je Grund ein Satz, der die Gesetzesstelle nennt —
+    // sie traegt den Hinweis nach § 11 Abs. 1a UStG.
+    'steuer.rcGrund.construction': 'Bauleistung gemäß § 19 Abs. 1a UStG.',
+    'steuer.rcGrund.scrap': 'Schrott und Abfallstoffe gemäß Schrott-Umsatzsteuerverordnung (BGBl. II Nr. 129/2007).',
+    'steuer.rcGrund.mobile_devices': 'Mobilfunkgeräte bzw. integrierte Schaltkreise gemäß § 19 Abs. 1e lit. b UStG.',
+    'steuer.rcGrund.it_devices': 'Laptops, Tablets bzw. Videospielkonsolen gemäß § 2 Z 1 Umsatzsteuerbetrugsbekämpfungsverordnung (BGBl. II Nr. 369/2013).',
+    'steuer.rcGrund.metals': 'Metalle gemäß § 2 Z 4 Umsatzsteuerbetrugsbekämpfungsverordnung.',
+    'steuer.rcGrund.emission_certificates': 'Treibhausgasemissionszertifikate gemäß § 19 Abs. 1e lit. a UStG.',
+    'steuer.rcGrund.gas_electricity': 'Lieferung von Gas oder Elektrizität an einen Wiederverkäufer gemäß § 2 Z 2 Umsatzsteuerbetrugsbekämpfungsverordnung.',
+    'steuer.rcGrund.energy_certificates': 'Gas- und Elektrizitätszertifikate gemäß § 2 Z 3 Umsatzsteuerbetrugsbekämpfungsverordnung.',
+    'steuer.rcGrund.investment_gold': 'Steuerpflichtige Lieferung von Anlagegold gemäß § 2 Z 5 Umsatzsteuerbetrugsbekämpfungsverordnung.',
+    'steuer.rcGrund.security_transfer': 'Lieferung von Sicherungs- bzw. Vorbehaltseigentum gemäß § 19 Abs. 1b UStG.',
+    'steuer.rcGrund.foreign_supplier': 'Leistung eines nicht im Inland ansässigen Unternehmers gemäß § 19 Abs. 1 zweiter Satz UStG.',
+    'steuer.domestic.text': 'Die Umsatzsteuer schuldet und entrichtet der Leistungsempfänger. Die Leistung ist nicht steuerfrei.',
+    'steuer.outsideScope.titel': 'Nicht steuerbarer Umsatz. ',
+    'steuer.outsideScope.text': 'Der Leistungsort liegt gemäß § 3a Abs. 6 UStG im Ansässigkeitsstaat des Leistungsempfängers; in Österreich fällt keine Umsatzsteuer an.',
     'pdf.zahlung.titel': 'ZAHLUNGSINFORMATIONEN',
     'pdf.zahlung.empfaenger': 'Empfänger',
     'pdf.zahlung.iban': 'IBAN',
@@ -86,6 +106,7 @@ const DE = {
     '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.outsideScope': 'Nicht steuerbarer Umsatz — Leistungsort im Ausland (§ 3a Abs. 6 UStG)',
     'einvoice.befreiung.ausfuhr': 'Steuerfreie Ausfuhrlieferung gemäß §6 Abs. 1 Z 1 UStG',
     'einvoice.zahlbarBis': 'Zahlbar bis {datum}',
     'einheit.piece': 'Stk',
@@ -209,8 +230,12 @@ const EN = {
     'pdf.tabelle.ust': 'VAT',
     'pdf.tabelle.einzelNetto': 'UNIT NET',
     'pdf.tabelle.betragNetto': 'AMOUNT NET',
+    'pdf.tabelle.einzelBrutto': 'UNIT GROSS',
+    'pdf.tabelle.betragBrutto': 'AMOUNT GROSS',
+    'pdf.position.rabatt': 'less {prozent}% discount',
     'pdf.summe.zwischensumme': 'Subtotal net',
     'pdf.summe.umsatzsteuer': 'VAT {satz}%',
+    'pdf.summe.darinUst': 'incl. {satz}% VAT on {netto} net',
     '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).',
@@ -220,6 +245,20 @@ const EN = {
     'steuer.reverseCharge.titel': 'Reverse charge – VAT liability of the recipient. ',
     'steuer.reverseCharge.text': 'VAT liability transferred pursuant to Art. 196 of VAT Directive 2006/112/EC (intra-Community service). The service is not VAT-exempt — the recipient owes and accounts for the VAT in their country.',
     'steuer.uidZeile': 'VAT ID supplier: {verkaeufer}   ·   VAT ID recipient: {kaeufer}',
+    'steuer.rcGrund.construction': 'Construction work pursuant to § 19 (1a) UStG.',
+    'steuer.rcGrund.scrap': 'Scrap and waste materials pursuant to the Austrian scrap VAT regulation (BGBl. II No. 129/2007).',
+    'steuer.rcGrund.mobile_devices': 'Mobile phones or integrated circuits pursuant to § 19 (1e) (b) UStG.',
+    'steuer.rcGrund.it_devices': 'Laptops, tablets or games consoles pursuant to § 2 no. 1 of the Austrian VAT anti-fraud regulation (BGBl. II No. 369/2013).',
+    'steuer.rcGrund.metals': 'Metals pursuant to § 2 no. 4 of the Austrian VAT anti-fraud regulation.',
+    'steuer.rcGrund.emission_certificates': 'Greenhouse gas emission allowances pursuant to § 19 (1e) (a) UStG.',
+    'steuer.rcGrund.gas_electricity': 'Supply of gas or electricity to a reseller pursuant to § 2 no. 2 of the Austrian VAT anti-fraud regulation.',
+    'steuer.rcGrund.energy_certificates': 'Gas and electricity certificates pursuant to § 2 no. 3 of the Austrian VAT anti-fraud regulation.',
+    'steuer.rcGrund.investment_gold': 'Taxable supply of investment gold pursuant to § 2 no. 5 of the Austrian VAT anti-fraud regulation.',
+    'steuer.rcGrund.security_transfer': 'Supply of goods under a security or retention of title arrangement pursuant to § 19 (1b) UStG.',
+    'steuer.rcGrund.foreign_supplier': 'Supply by a business not established in Austria pursuant to § 19 (1) second sentence UStG.',
+    'steuer.domestic.text': 'The recipient owes and accounts for the VAT. The supply is not VAT-exempt.',
+    'steuer.outsideScope.titel': 'Outside the scope of Austrian VAT. ',
+    'steuer.outsideScope.text': 'The place of supply is the recipient\'s country pursuant to § 3a (6) UStG; no Austrian VAT applies.',
     'pdf.zahlung.titel': 'PAYMENT DETAILS',
     'pdf.zahlung.empfaenger': 'Payee',
     'pdf.zahlung.iban': 'IBAN',
@@ -269,6 +308,7 @@ const EN = {
     '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.outsideScope': 'Outside the scope of VAT — place of supply abroad (§ 3a (6) UStG)',
     'einvoice.befreiung.ausfuhr': 'VAT-exempt export delivery pursuant to § 6 (1) no. 1 UStG',
     'einvoice.zahlbarBis': 'Payable by {datum}',
     'einheit.piece': 'pcs',

package/dist/esm/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, InvoiceLanguage, InvoiceNoticeCode, InvoicePaymentMethod, InvoiceUnit, InvoiceSetupRequirement, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent } from './vertrag.js';
+import type { CreditNoteReason, CustomerType, DocType, InvoiceLanguage, InvoiceNoticeCode, ItemKind, ReverseChargeReason, InvoicePaymentMethod, InvoiceUnit, InvoiceSetupRequirement, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent } from './vertrag.js';
 export interface CustomerInput {
     type: CustomerType;
     name: string;
@@ -71,6 +71,8 @@ export interface InvoiceItemInput {
     quantity: number;
     /** Einheit aus `INVOICE_UNITS`; ohne Angabe `piece`. */
     unit?: InvoiceUnit;
+    /** Ware oder Leistung; ohne Angabe `goods`. Entscheidet ueber den Steuerfall. */
+    kind?: ItemKind;
     /** Einzelpreis in ganzen Cent, im `priceMode` der Rechnung (netto oder brutto). */
     unitPriceCents: number;
     vatRate: VatRatePercent;
@@ -82,7 +84,10 @@ export interface IssueInvoiceRequest {
     idempotencyKey: string;
     /** Pflicht ueber 400 € brutto sowie bei Reverse Charge und ig. Lieferung. */
     customerId?: string;
-    taxScheme: TaxScheme;
+    /** Optional: der Server leitet den Fall ab und prueft eine Angabe dagegen. */
+    taxScheme?: TaxScheme;
+    /** Pflicht bei `domesticReverseCharge`. */
+    reverseChargeReason?: ReverseChargeReason;
     priceMode: PriceMode;
     /** Leistungsdatum bzw. Beginn des Leistungszeitraums. */
     serviceStart: string;
@@ -141,7 +146,7 @@ export interface InvoicePayment {
 }
 /**
  * Ein Hinweis zu einer erfolgreichen Antwort — kein Fehler, sondern etwas,
- * das der Aufrufer wissen sollte (heute nur `cash_receipt_required`).
+ * das der Aufrufer wissen sollte. Die Codes stehen in `INVOICE_NOTICE_CODES`.
  */
 export interface InvoiceNotice {
     code: InvoiceNoticeCode;
@@ -151,7 +156,11 @@ export interface RecordPaymentResult {
     invoice: Invoice;
     payment: InvoicePayment;
     replayed: boolean;
-    notice?: InvoiceNotice;
+    /**
+     * Hinweise zu dieser Zahlung — eine **Liste** wie bei `issueInvoice`
+     * (bis 0.21.0 ein einzelnes Objekt). Fehlt, wenn es keinen gibt.
+     */
+    notice?: InvoiceNotice[];
 }
 export interface CancelInvoiceRequest {
     idempotencyKey: string;
@@ -162,15 +171,23 @@ export interface CancelInvoiceRequest {
 export interface CreditNoteRequest extends CancelInvoiceRequest {
     items: InvoiceItemInput[];
 }
+/**
+ * Summen einer Rechnung in Cent, **immer positiv** — auch bei einer Gutschrift
+ * (`docType: 'GU'`); das Vorzeichen steht im Belegtyp, nicht im Betrag.
+ * Gerechnet wird je Satz wie in [rechnungSummen].
+ */
 export interface InvoiceTotals {
     netCents: number;
     vatCents: number;
     grossCents: number;
-    byRate: {
-        rate: number;
-        netCents: number;
-        vatCents: number;
-    }[];
+    /** Je USt-Satz, absteigend. `grossCents` ist `netCents + vatCents` (seit 0.22.0 mitgeliefert). */
+    byRate: InvoiceRateTotals[];
+}
+export interface InvoiceRateTotals {
+    rate: number;
+    netCents: number;
+    vatCents: number;
+    grossCents: number;
 }
 export interface EInvoiceStatus {
     level: string;
@@ -227,6 +244,8 @@ export interface InvoiceItem {
     subtitle: string;
     quantity: number;
     unit: string;
+    /** Ware oder Leistung — Altbestand ohne Angabe zaehlt als `goods`. */
+    kind: ItemKind;
     unitPriceCents: number;
     vatRate: number;
     discountPct: number;
@@ -235,6 +254,10 @@ export interface InvoiceDetail extends Invoice {
     items: InvoiceItem[];
     customer: InvoiceRecipient | null;
     taxScheme: TaxScheme;
+    /** Nur bei `domesticReverseCharge`. */
+    reverseChargeReason: ReverseChargeReason | null;
+    /** Land, dessen Steuer die Rechnung traegt; Altbestand `AT`. */
+    taxCountry: string;
     priceMode: PriceMode;
     serviceStart: string | null;
     serviceEnd: string | null;
@@ -280,6 +303,45 @@ export interface IssueResult {
     invoice: Invoice;
     /** `true`, wenn die Anfrage schon einmal ausgefuehrt wurde und die bestehende Rechnung zurueckkommt. */
     replayed: boolean;
+    /**
+     * Hinweise zu dieser Rechnung — kein Fehler, sondern etwas, das der Aufrufer
+     * wissen sollte. Eine **Liste**, weil mehrere zugleich anfallen koennen: eine
+     * bar bezahlte ig. Lieferung traegt sowohl `cash_receipt_required` als auch
+     * `recapitulative_statement_due`.
+     */
+    notice?: InvoiceNotice[];
+}
+/**
+ * Was `issueInvoice` mit dieser Anfrage ausstellen wuerde — ohne Nummer, ohne
+ * Dokument, ohne Zahlung. Der Probelauf prueft wie das Ausstellen (Einrichtung,
+ * Kunde, Steuerfall, Pflichtangaben, Marke, Zahlung) und scheitert mit
+ * denselben Fehlercodes.
+ */
+export interface InvoicePreview {
+    docType: 'RE';
+    /** Heutiger Wiener Tag — der Tag, den eine sofort ausgestellte Rechnung truege. */
+    invoiceDate: string;
+    dueDate: string | null;
+    customerId: string | null;
+    /** Der abgeleitete Steuerfall. */
+    taxScheme: TaxScheme;
+    /** Warum dieser Fall gilt (z. B. `customer_country_eu_with_vat_id`). */
+    taxSchemeReason: string;
+    reverseChargeReason: ReverseChargeReason | null;
+    taxCountry: string;
+    priceMode: PriceMode;
+    totals: InvoiceTotals;
+    language: InvoiceLanguage;
+    brand: {
+        id: string | null;
+        name: string | null;
+    } | null;
+    einvoice: EInvoiceStatus;
+}
+export interface PreviewResult {
+    preview: InvoicePreview;
+    /** Dieselben Hinweise, die das Ausstellen liefern wuerde. */
+    notice?: InvoiceNotice[];
 }
 export interface CancelResult {
     creditNote: Invoice;

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

@@ -24,13 +24,88 @@ 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", "language_not_allowed", "brand_not_found", "not_payable", "payment_exceeds_invoice"];
+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", "tax_scheme_mismatch", "vat_rate_not_in_country", "reverse_charge_reason_required", "reverse_charge_threshold", "mixed_supply_not_allowed", "oss_not_enabled"];
 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"];
 export type CreditNoteReason = (typeof CREDIT_NOTE_REASONS)[number];
-export declare const TAX_SCHEMES: readonly ["normal", "smallBusiness", "reverseCharge", "igLieferung", "exportThirdCountry"];
+/**
+ * Der Steuerfall einer Rechnung. Er wird vom Server **abgeleitet** (Kundenland,
+ * Kundenart, UID, Ware oder Leistung); eine mitgeschickte Angabe muss dazu
+ * passen, sonst `tax_scheme_mismatch`. Neue Faelle stehen hinten, damit
+ * gespeicherte Reihenfolgen gueltig bleiben.
+ *
+ * - `normal`                oesterreichische Umsatzsteuer
+ * - `smallBusiness`         Kleinunternehmer (§ 6 Abs. 1 Z 27 UStG)
+ * - `reverseCharge`         Leistung an ein Unternehmen in der EU (Art. 196 MwSt-RL)
+ * - `igLieferung`           Ware an ein Unternehmen in der EU (Art. 6 Abs. 1 UStG)
+ * - `exportThirdCountry`    Ware ins Drittland (§ 6 Abs. 1 Z 1 UStG)
+ * - `domesticReverseCharge` Uebergang der Steuerschuld im Inland, Grund aus `REVERSE_CHARGE_REASONS`
+ * - `oss`                   B2C in der EU ueber den One-Stop-Shop, Satz des Ziellandes
+ * - `outsideScope`          Leistung an ein Drittlandsunternehmen — in Oesterreich nicht steuerbar
+ */
+export declare const TAX_SCHEMES: readonly ["normal", "smallBusiness", "reverseCharge", "igLieferung", "exportThirdCountry", "domesticReverseCharge", "oss", "outsideScope"];
 export type TaxScheme = (typeof TAX_SCHEMES)[number];
+/**
+ * Gruende fuer den Uebergang der Steuerschuld **im Inland**. Ohne Grund gibt es
+ * kein `domesticReverseCharge`: die Bedingungen sind je Fall verschieden, und
+ * keine davon laesst sich aus Betrag und Land erraten.
+ *
+ * `schwelleCents` ist das Entgelt, ab dem der Fall greift — maßgeblich ist das
+ * **in der Rechnung ausgewiesene** Entgelt, nicht der Einzelpreis; ein
+ * einheitlicher Liefervorgang darf dafuer nicht auf mehrere Rechnungen
+ * aufgeteilt werden (UStR Rz 2605d).
+ */
+export declare const REVERSE_CHARGE_REASONS: Readonly<{
+    construction: {
+        stelle: string;
+        schwelleCents: null;
+    };
+    scrap: {
+        stelle: string;
+        schwelleCents: null;
+    };
+    mobile_devices: {
+        stelle: string;
+        schwelleCents: number;
+    };
+    it_devices: {
+        stelle: string;
+        schwelleCents: number;
+    };
+    metals: {
+        stelle: string;
+        schwelleCents: null;
+    };
+    emission_certificates: {
+        stelle: string;
+        schwelleCents: null;
+    };
+    gas_electricity: {
+        stelle: string;
+        schwelleCents: null;
+    };
+    energy_certificates: {
+        stelle: string;
+        schwelleCents: null;
+    };
+    investment_gold: {
+        stelle: string;
+        schwelleCents: null;
+    };
+    security_transfer: {
+        stelle: string;
+        schwelleCents: null;
+    };
+    foreign_supplier: {
+        stelle: string;
+        schwelleCents: null;
+    };
+}>;
+export type ReverseChargeReason = keyof typeof REVERSE_CHARGE_REASONS;
+/** Ware oder Leistung — ohne das laesst sich ig. Lieferung nicht von Reverse Charge trennen. */
+export declare const ITEM_KINDS: readonly ["goods", "service"];
+export type ItemKind = (typeof ITEM_KINDS)[number];
 export declare const PRICE_MODES: readonly ["net", "gross"];
 export type PriceMode = (typeof PRICE_MODES)[number];
 export declare const VAT_RATES: readonly [0, 10, 13, 20];
@@ -66,7 +141,7 @@ 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 declare const INVOICE_NOTICE_CODES: readonly ["cash_receipt_required", "recapitulative_statement_due", "place_of_supply_check"];
 export type InvoiceNoticeCode = (typeof INVOICE_NOTICE_CODES)[number];
 /**
  * Einheiten einer Position. Die API nimmt nur diese Schluessel an; gedruckt