@kreiseck/kasseneck-api 0.19.0 → 0.21.0

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

@@ -40,11 +40,26 @@ declare const DE: {
     readonly 'pdf.summe.gesamt.rechnung': "Gesamtbetrag";
     readonly 'pdf.summe.gesamt.gutschrift': "Gutschriftsbetrag";
     readonly 'steuer.kleinunternehmer': "Gemäß § 6 Abs. 1 Z 27 UStG wird keine Umsatzsteuer verrechnet (Kleinunternehmer).";
-    readonly 'steuer.igLieferung': "Steuerfreie innergemeinschaftliche Lieferung (Art. 6 Abs. 1 UStG).";
+    readonly 'steuer.igLieferung.titel': "Steuerfreie innergemeinschaftliche Lieferung. ";
+    readonly 'steuer.igLieferung.text': "Gemäß Art. 6 Abs. 1 UStG (Art. 138 MwSt-RL 2006/112/EG). Die Erwerbsbesteuerung erfolgt durch den Abnehmer im Bestimmungsland.";
     readonly 'steuer.ausfuhr': "Steuerfreie Ausfuhrlieferung (§ 6 Abs. 1 Z 1 UStG).";
-    readonly 'steuer.reverseCharge.titel': "Steuerfreie Leistung – Reverse Charge. ";
-    readonly 'steuer.reverseCharge.text': "Übergang der Steuerschuldnerschaft auf den Leistungsempfänger gem. Art. 196 MwSt-RL 2006/112/EG (innergemeinschaftliche Leistung). Die Umsatzsteuer ist vom Leistungsempfänger im Bestimmungsland abzuführen.";
-    readonly 'steuer.reverseCharge.uid': "UID Leistungserbringer: {verkaeufer}   ·   UID Leistungsempfänger: {kaeufer}";
+    readonly '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";
@@ -94,6 +109,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

@@ -25,11 +25,34 @@ const DE = {
     '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.igLieferung.titel': 'Steuerfreie innergemeinschaftliche Lieferung. ',
+    'steuer.igLieferung.text': 'Gemäß Art. 6 Abs. 1 UStG (Art. 138 MwSt-RL 2006/112/EG). Die Erwerbsbesteuerung erfolgt durch den Abnehmer im Bestimmungsland.',
     '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}',
+    // Reverse Charge ist KEINE Steuerbefreiung: der Umsatz bleibt steuerpflichtig,
+    // nur die Steuer schuldet der Empfaenger (§ 11 Abs. 1a UStG; der Begriff steht
+    // wortgleich in Art. 226 Nr. 11a MwSt-RL). „Steuerfrei" waere sachlich falsch
+    // und erbraechte den vorgeschriebenen Hinweis nicht.
+    'steuer.reverseCharge.titel': 'Steuerschuldnerschaft des Leistungsempfängers. ',
+    '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.',
+    // 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',
@@ -79,6 +102,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',
@@ -207,11 +231,26 @@ const EN = {
     '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.igLieferung.titel': 'VAT-exempt intra-Community supply. ',
+    'steuer.igLieferung.text': 'Pursuant to Art. 6 (1) UStG (Art. 138 of VAT Directive 2006/112/EC). The acquisition is taxed by the customer in the country of destination.',
     '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}',
+    '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',
@@ -261,6 +300,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;
@@ -118,6 +123,13 @@ export interface PaymentInput {
     paidAt?: string;
     /** Zahlungskennung des Fremdsystems — gespeichert, aber nicht gedruckt. */
     reference?: string;
+    /**
+     * Die Zahlung erfolgte vor Ort beim Unternehmer (Terminal an der Kasse).
+     * Dann ist sie ein Barumsatz — auch mit Karte (§ 131b Abs. 1 Z 3 UStG) — und
+     * die Antwort traegt den Hinweis `cash_receipt_required`. Zu `transfer`
+     * passt das Kennzeichen nicht und wird abgewiesen.
+     */
+    onSite?: boolean;
 }
 export interface RecordPaymentRequest extends PaymentInput {
     /** Pflicht: ohne ihn bucht eine Wiederholung eine zweite Zahlung. */
@@ -220,6 +232,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;
@@ -228,6 +242,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;
@@ -273,6 +291,13 @@ 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[];
 }
 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];
@@ -52,10 +127,13 @@ export type EInvoiceFormat = (typeof EINVOICE_FORMATS)[number];
 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.
+ * Wie eine Rechnung bezahlt wurde. Der Vermerk ist Buchhaltung, kein Beleg.
+ *
+ * Ein **Barumsatz** ist nicht nur Bargeld: als Barzahlung gilt auch die Zahlung
+ * mit Bankomat- oder Kreditkarte **vor Ort** (§ 131b Abs. 1 Z 3 UStG), nicht
+ * aber dieselbe Karte im Internet. Weil `card` und `online` beides sein
+ * koennen, sagt das Feld `onSite` es dem Server — und nur dann traegt die
+ * Antwort den Hinweis `cash_receipt_required` (bei `cash` immer).
  */
 export declare const INVOICE_PAYMENT_METHODS: readonly ["transfer", "card", "online", "cash"];
 export type InvoicePaymentMethod = (typeof INVOICE_PAYMENT_METHODS)[number];
@@ -63,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/esm/rechnung/vertrag.js

@@ -60,6 +60,12 @@ export const 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. */
 export const CREDIT_NOTE_REASONS = [
@@ -69,7 +75,56 @@ export const CREDIT_NOTE_REASONS = [
     'incorrect_invoice',
     'other',
 ];
-export const 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
+ */
+export const 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).
+ */
+export const 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. */
+export const ITEM_KINDS = ['goods', 'service'];
 export const PRICE_MODES = ['net', 'gross'];
 export const VAT_RATES = [0, 10, 13, 20];
 export const CUSTOMER_TYPES = ['private', 'company'];
@@ -84,17 +139,28 @@ export const EINVOICE_FORMATS = ['ubl', 'cii'];
  */
 export const INVOICE_LANGUAGES = ['de', 'en'];
 /**
- * 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.
+ * Wie eine Rechnung bezahlt wurde. Der Vermerk ist Buchhaltung, kein Beleg.
+ *
+ * Ein **Barumsatz** ist nicht nur Bargeld: als Barzahlung gilt auch die Zahlung
+ * mit Bankomat- oder Kreditkarte **vor Ort** (§ 131b Abs. 1 Z 3 UStG), nicht
+ * aber dieselbe Karte im Internet. Weil `card` und `online` beides sein
+ * koennen, sagt das Feld `onSite` es dem Server — und nur dann traegt die
+ * Antwort den Hinweis `cash_receipt_required` (bei `cash` immer).
  */
 export const 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.
  */
-export const INVOICE_NOTICE_CODES = ['cash_receipt_required'];
+export const 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`,
@@ -271,6 +337,8 @@ export const 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: INVOICE_UNITS },
+    /** Ware oder Leistung; ohne Angabe `goods`. Entscheidet ueber den Steuerfall. */
+    kind: { typ: 'enum', pflicht: false, werte: ITEM_KINDS },
     unitPriceCents: { typ: 'integer', pflicht: true, min: 0, max: 100_000_000 },
     vatRate: { typ: 'enum', pflicht: true, werte: VAT_RATES },
     discountPct: { typ: 'number', pflicht: false, min: 0, max: 100, nachkomma: 2 },
@@ -288,6 +356,12 @@ export const PAYMENT_FELDER = Object.freeze({
     amountCents: { typ: 'integer', pflicht: false, min: 1, max: 100_000_000 },
     paidAt: datum(),
     reference: text(100),
+    /**
+     * Die Zahlung erfolgte **vor Ort** beim Unternehmer (Terminal an der Kasse,
+     * Zahlung per App am Tresen). Dann ist sie ein Barumsatz. Zu `transfer` passt
+     * das nicht — eine Ueberweisung erfolgt nie vor Ort — und wird abgewiesen.
+     */
+    onSite: { typ: 'boolean', pflicht: false },
 });
 export const RECHNUNG_ANFRAGEN = Object.freeze({
     createCustomer: {
@@ -313,7 +387,14 @@ export const RECHNUNG_ANFRAGEN = Object.freeze({
     issueInvoice: {
         idempotencyKey: idempotencyKey(true),
         customerId: id,
-        taxScheme: { typ: 'enum', pflicht: true, werte: 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: TAX_SCHEMES },
+        /** Pflicht bei `domesticReverseCharge`, sonst nicht erlaubt. */
+        reverseChargeReason: { typ: 'enum', pflicht: false, werte: Object.keys(REVERSE_CHARGE_REASONS) },
         priceMode: { typ: 'enum', pflicht: true, werte: PRICE_MODES },
         serviceStart: datum(true),
         serviceEnd: datum(),
@@ -381,6 +462,7 @@ export const RECHNUNG_ANFRAGEN = Object.freeze({
         amountCents: { typ: 'integer', pflicht: false, min: 1, max: 100_000_000 },
         paidAt: datum(),
         reference: text(100),
+        onSite: { typ: 'boolean', pflicht: false },
     },
 });
 /** Genau eines dieser Felder muss gesetzt sein (je Aufruf, je Gruppe). */

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.19.0",
+  "version": "0.21.0",
   "gemessenAn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/kasse-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.19.0",
+  "version": "0.21.0",
   "meldungen": {
     "netz.keine_verbindung": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."

package/fixtures/oberflaeche.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.19.0",
+  "version": "0.21.0",
   "aufrufe": [
     "activateCashregister",
     "cancelInvoice",
@@ -404,7 +404,13 @@
       "language_not_allowed",
       "brand_not_found",
       "not_payable",
-      "payment_exceeds_invoice"
+      "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"
     ],
     "invoiceLanguages": [
       "de",
@@ -418,7 +424,9 @@
       "overdue"
     ],
     "invoiceNoticeCodes": [
-      "cash_receipt_required"
+      "cash_receipt_required",
+      "recapitulative_statement_due",
+      "place_of_supply_check"
     ],
     "invoicePaymentMethods": [
       "transfer",
@@ -487,6 +495,10 @@
       "bag",
       "pallet"
     ],
+    "itemKinds": [
+      "goods",
+      "service"
+    ],
     "priceModes": [
       "net",
       "gross"
@@ -512,7 +524,10 @@
       "smallBusiness",
       "reverseCharge",
       "igLieferung",
-      "exportThirdCountry"
+      "exportThirdCountry",
+      "domesticReverseCharge",
+      "oss",
+      "outsideScope"
     ],
     "vatRates": [
       0,

package/fixtures/rechnung-api-beispiele/zahlung-fehler-vor-ort.json

@@ -0,0 +1,15 @@
+{
+  "aufruf": "recordInvoicePayment",
+  "beschreibung": "Ueberweisung kann nicht vor Ort erfolgen",
+  "anfrage": {
+    "idempotencyKey": "bsp-vor-ort",
+    "invoiceId": "rechnung_beispiel",
+    "method": "transfer",
+    "onSite": true
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": ["onSite"]
+  }
+}