@kreiseck/kasseneck-api 0.20.0 → 0.22.0

package/dist/cjs/rechnung/texte.js

@@ -24,8 +24,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).',
@@ -41,6 +45,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',
@@ -90,6 +110,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',
@@ -213,8 +234,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).',
@@ -224,6 +249,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',
@@ -273,6 +312,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/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, 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/cjs/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

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.PAYMENT_FELDER = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.INVOICE_PAYMENT_METHODS = exports.INVOICE_LANGUAGES = exports.EINVOICE_FORMATS = exports.DOC_TYPES = exports.INVOICE_LIST_STATUS = exports.CUSTOMER_TYPES = exports.VAT_RATES = exports.PRICE_MODES = exports.TAX_SCHEMES = exports.CREDIT_NOTE_REASONS = exports.INVOICE_ERROR_CODES = exports.RECHNUNG_AUFRUFE = exports.RECHNUNG_VERTRAG_VERSION = void 0;
+exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.PAYMENT_FELDER = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.INVOICE_PAYMENT_METHODS = exports.INVOICE_LANGUAGES = exports.EINVOICE_FORMATS = exports.DOC_TYPES = exports.INVOICE_LIST_STATUS = exports.CUSTOMER_TYPES = exports.VAT_RATES = exports.PRICE_MODES = exports.ITEM_KINDS = exports.REVERSE_CHARGE_REASONS = 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',
@@ -63,6 +63,12 @@ exports.INVOICE_ERROR_CODES = [
     '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',
 ];
 /** Gruende einer Gutschrift. Der Server druckt den deutschen Anzeigetext. */
 exports.CREDIT_NOTE_REASONS = [
@@ -72,7 +78,56 @@ exports.CREDIT_NOTE_REASONS = [
     'incorrect_invoice',
     'other',
 ];
-exports.TAX_SCHEMES = ['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
+ */
+exports.TAX_SCHEMES = [
+    'normal',
+    'smallBusiness',
+    'reverseCharge',
+    'igLieferung',
+    'exportThirdCountry',
+    'domesticReverseCharge',
+    'oss',
+    'outsideScope',
+];
+/**
+ * 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).
+ */
+exports.REVERSE_CHARGE_REASONS = Object.freeze({
+    construction: { stelle: '§ 19 Abs. 1a UStG', schwelleCents: null },
+    scrap: { stelle: 'Schrott-UStV, BGBl. II Nr. 129/2007', schwelleCents: null },
+    mobile_devices: { stelle: '§ 19 Abs. 1e lit. b UStG', schwelleCents: 500_000 },
+    it_devices: { stelle: '§ 2 Z 1 UStBBKV, BGBl. II Nr. 369/2013', schwelleCents: 500_000 },
+    metals: { stelle: '§ 2 Z 4 UStBBKV', schwelleCents: null },
+    emission_certificates: { stelle: '§ 19 Abs. 1e lit. a UStG', schwelleCents: null },
+    gas_electricity: { stelle: '§ 2 Z 2 UStBBKV', schwelleCents: null },
+    energy_certificates: { stelle: '§ 2 Z 3 UStBBKV', schwelleCents: null },
+    investment_gold: { stelle: '§ 2 Z 5 UStBBKV', schwelleCents: null },
+    security_transfer: { stelle: '§ 19 Abs. 1b UStG', schwelleCents: null },
+    foreign_supplier: { stelle: '§ 19 Abs. 1 zweiter Satz UStG', schwelleCents: null },
+});
+/** Ware oder Leistung — ohne das laesst sich ig. Lieferung nicht von Reverse Charge trennen. */
+exports.ITEM_KINDS = ['goods', 'service'];
 exports.PRICE_MODES = ['net', 'gross'];
 exports.VAT_RATES = [0, 10, 13, 20];
 exports.CUSTOMER_TYPES = ['private', 'company'];
@@ -100,7 +155,15 @@ exports.INVOICE_PAYMENT_METHODS = ['transfer', 'card', 'online', 'cash'];
  * Hinweise, die eine erfolgreiche Antwort zusaetzlich tragen kann (`data.notice`).
  * Sie sind keine Fehler: der Aufruf hat gewirkt, es gibt nur etwas zu wissen.
  */
-exports.INVOICE_NOTICE_CODES = ['cash_receipt_required'];
+exports.INVOICE_NOTICE_CODES = [
+    'cash_receipt_required',
+    /** Ig. Lieferung und grenzueberschreitendes Reverse Charge: die Zusammenfassende
+     *  Meldung ist materielle Voraussetzung (Art. 7 Abs. 1 Z 5 UStG). */
+    'recapitulative_statement_due',
+    /** Leistung an eine Privatperson im Drittland: der Leistungsort haengt von der
+     *  Art der Leistung ab — wir nehmen den oesterreichischen Fall an. */
+    'place_of_supply_check',
+];
 /**
  * Einheiten einer Position. Die API nimmt nur diese Schluessel an; gedruckt
  * wird das Kuerzel in der Sprache der Rechnung (`RECHNUNG_TEXTE`,
@@ -277,6 +340,8 @@ exports.POSITION_FELDER = Object.freeze({
     quantity: { typ: 'number', pflicht: true, min: 0, exklusivMin: true, max: 1_000_000, nachkomma: 3 },
     /** Einheit aus `INVOICE_UNITS`; ohne Angabe `piece`. */
     unit: { typ: 'enum', pflicht: false, werte: exports.INVOICE_UNITS },
+    /** Ware oder Leistung; ohne Angabe `goods`. Entscheidet ueber den Steuerfall. */
+    kind: { typ: 'enum', pflicht: false, werte: exports.ITEM_KINDS },
     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 },
@@ -325,7 +390,14 @@ exports.RECHNUNG_ANFRAGEN = Object.freeze({
     issueInvoice: {
         idempotencyKey: idempotencyKey(true),
         customerId: id,
-        taxScheme: { typ: 'enum', pflicht: true, werte: exports.TAX_SCHEMES },
+        /**
+         * Optional: der Server leitet den Fall ab. Eine Angabe wird geprueft und
+         * muss passen (`tax_scheme_mismatch`) — so faellt eine falsche Zuordnung
+         * im Fremdsystem auf, statt eine falsche Rechnung zu erzeugen.
+         */
+        taxScheme: { typ: 'enum', pflicht: false, werte: exports.TAX_SCHEMES },
+        /** Pflicht bei `domesticReverseCharge`, sonst nicht erlaubt. */
+        reverseChargeReason: { typ: 'enum', pflicht: false, werte: Object.keys(exports.REVERSE_CHARGE_REASONS) },
         priceMode: { typ: 'enum', pflicht: true, werte: exports.PRICE_MODES },
         serviceStart: datum(true),
         serviceEnd: datum(),
@@ -348,6 +420,12 @@ exports.RECHNUNG_ANFRAGEN = Object.freeze({
          * und ein sofort geholtes PDF Zahlungsinformationen traegt.
          */
         payment: { typ: 'object', pflicht: false, felder: exports.PAYMENT_FELDER },
+        /**
+         * Probelauf: alles pruefen und rechnen wie beim Ausstellen, aber nichts
+         * festschreiben — keine Nummer, kein Dokument, keine Zahlung, kein
+         * Idempotenz-Eintrag. Die Antwort traegt `preview` statt `invoice`.
+         */
+        dryRun: { typ: 'boolean', pflicht: false },
     },
     cancelInvoice: {
         idempotencyKey: idempotencyKey(true),

package/dist/esm/client/errors.d.ts

@@ -87,7 +87,6 @@ export declare function causeDigest(ursache: unknown, geheimnisse: readonly stri
  * demselben Grund **keinen** Vorgabewert.
  */
 export declare function fehlerDetails(daten: unknown, geheimnisse: readonly string[]): Record<string, unknown>;
-/** Fachlicher Fehler: HTTP 200, aber `status: 'error'` im Rumpf. */
 export declare class KasseneckApiError extends Error {
     readonly name = "KasseneckApiError";
     /** Aufgerufene Backend-Funktion, z. B. `createReceipt`. */

package/dist/esm/client/errors.js

@@ -164,6 +164,29 @@ function sieben(wert, geheimnisse, tiefe) {
     return raus;
 }
 /** Fachlicher Fehler: HTTP 200, aber `status: 'error'` im Rumpf. */
+/**
+ * Die Feldfehler einer Pruefantwort (`errors: [{ field, message }]`) als
+ * Anhang der Fehlermeldung — sonst stuende im Log nur „Bitte Eingaben
+ * pruefen." und niemand wuesste, welches Feld gemeint ist. Hoechstens fuenf;
+ * vollstaendig bleiben sie in `details.errors`.
+ */
+function feldHinweis(details) {
+    const roh = details['errors'];
+    if (!Array.isArray(roh))
+        return '';
+    const teile = [];
+    for (const e of roh) {
+        if (e === null || typeof e !== 'object')
+            continue;
+        const { field, message } = e;
+        if (typeof field === 'string' && typeof message === 'string')
+            teile.push(`${field}: ${message}`);
+    }
+    if (!teile.length)
+        return '';
+    const mehr = teile.length > 5 ? ` (+${teile.length - 5} weitere)` : '';
+    return ` [${teile.slice(0, 5).join('; ')}${mehr}]`;
+}
 export class KasseneckApiError extends Error {
     name = 'KasseneckApiError';
     /** Aufgerufene Backend-Funktion, z. B. `createReceipt`. */
@@ -187,7 +210,7 @@ export class KasseneckApiError extends Error {
      */
     details;
     constructor(functionName, serverMessage, details = {}, code) {
-        super(`${functionName} fehlgeschlagen: ${serverMessage}`);
+        super(`${functionName} fehlgeschlagen: ${serverMessage}${feldHinweis(details)}`);
         this.functionName = functionName;
         this.serverMessage = serverMessage;
         this.details = details;

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

@@ -6,7 +6,7 @@
  */
 import { type FetchLike } from '../client/transport.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, RecordPaymentRequest, RecordPaymentResult } from './typen.js';
+import type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult, PreviewResult, RecordPaymentRequest, RecordPaymentResult } from './typen.js';
 export interface RechnungApiOptions {
     /** `api_key` des Kontos (`kr_live_…` / `kr_test_…`). Gehoert auf einen Server. */
     apiKey: string;
@@ -29,6 +29,8 @@ export interface RechnungApi {
     updateCustomer(customerId: string, patch: Partial<CustomerInput>): Promise<Customer>;
     searchCustomers(suche: CustomerSearch): Promise<CustomerPage>;
     issueInvoice(anfrage: IssueInvoiceRequest): Promise<IssueResult>;
+    /** Probelauf: pruefen und rechnen wie `issueInvoice`, ohne auszustellen. */
+    previewInvoice(anfrage: IssueInvoiceRequest): Promise<PreviewResult>;
     cancelInvoice(anfrage: CancelInvoiceRequest): Promise<CancelResult>;
     createCreditNote(anfrage: CreditNoteRequest): Promise<CreditNoteResult>;
     getInvoice(kennung: {

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, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, recordInvoicePayment, searchCustomers, updateCustomer, } from './endpunkte.js';
+import { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, previewInvoice, listInvoices, recordInvoicePayment, searchCustomers, updateCustomer, } from './endpunkte.js';
 export function createRechnungApi(optionen) {
     const transportOptionen = {
         auth: rechnungKeyAuth({ apiKey: optionen.apiKey }),
@@ -22,6 +22,7 @@ export function createRechnungApi(optionen) {
         updateCustomer: (id, patch) => updateCustomer(rufen, id, patch),
         searchCustomers: (suche) => searchCustomers(rufen, suche),
         issueInvoice: (anfrage) => issueInvoice(rufen, anfrage),
+        previewInvoice: (anfrage) => previewInvoice(rufen, anfrage),
         cancelInvoice: (anfrage) => cancelInvoice(rufen, anfrage),
         createCreditNote: (anfrage) => createCreditNote(rufen, anfrage),
         getInvoice: (kennung) => getInvoice(rufen, kennung),

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

@@ -18,7 +18,7 @@
  */
 import type { InternerBinaerTransport, InternerTransport } from '../client/aufrufe.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, RecordPaymentRequest, RecordPaymentResult } from './typen.js';
+import type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, InvoiceSetupStatus, IssueInvoiceRequest, IssueResult, PreviewResult, RecordPaymentRequest, RecordPaymentResult } from './typen.js';
 export declare function createCustomer(rufen: InternerTransport, customer: CustomerInput, optionen?: {
     idempotencyKey?: string;
 }): Promise<Customer>;
@@ -30,6 +30,17 @@ export declare function getCustomer(rufen: InternerTransport, kennung: {
 export declare function updateCustomer(rufen: InternerTransport, customerId: string, patch: Partial<CustomerInput>): Promise<Customer>;
 export declare function searchCustomers(rufen: InternerTransport, suche: CustomerSearch): Promise<CustomerPage>;
 export declare function issueInvoice(rufen: InternerTransport, anfrage: IssueInvoiceRequest): Promise<IssueResult>;
+/**
+ * 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 declare function previewInvoice(rufen: InternerTransport, anfrage: IssueInvoiceRequest): Promise<PreviewResult>;
 export declare function cancelInvoice(rufen: InternerTransport, anfrage: CancelInvoiceRequest): Promise<CancelResult>;
 export declare function createCreditNote(rufen: InternerTransport, anfrage: CreditNoteRequest): Promise<CreditNoteResult>;
 export declare function getInvoice(rufen: InternerTransport, kennung: {