@kreiseck/kasseneck-api 0.19.0 → 0.21.0

package/CHANGELOG.md

@@ -4,6 +4,31 @@ Was vor 0.7.0 geschah, steht in der Commit-Historie (`git log`); ab hier wird
 es hier geführt. Ein Eintrag nennt die Änderung **und ihren Grund** —
 nur der Grund überlebt den nächsten Umbau.
 
+## 0.20.0
+
+### Rechnung: richtige Steuerhinweise, Barumsatz auch mit Karte
+
+**Anlass:** drei Befunde aus einer Durchsicht an den Primärquellen.
+
+- **Reverse Charge ist keine Steuerbefreiung.** Der Aufdruck hiess
+  „Steuerfreie Leistung – Reverse Charge" und behauptete damit eine Befreiung,
+  die es nicht gibt: der Umsatz bleibt steuerpflichtig, nur die Steuer schuldet
+  der Empfänger. Das Gesetz trennt beides (§ 11 Abs. 1 Z 3 lit. e = Hinweis auf
+  eine Befreiung, § 11 Abs. 1a = Hinweis auf die Steuerschuldnerschaft); Art. 226
+  Nr. 11a MwSt-RL nennt den Begriff wörtlich. Jetzt:
+  „Steuerschuldnerschaft des Leistungsempfängers."
+- **Ig. Lieferung** bekommt denselben Kasten wie Reverse Charge, mit **beiden**
+  UID-Nummern — Art. 11 Abs. 2 UStG verlangt sie auf der Rechnung. Der
+  Textschlüssel `steuer.reverseCharge.uid` heisst darum jetzt `steuer.uidZeile`,
+  neu sind `steuer.igLieferung.titel` und `steuer.igLieferung.text`
+  (`steuer.igLieferung` entfällt).
+- **`onSite` an der Zahlung.** Ein Barumsatz ist nicht nur Bargeld: als
+  Barzahlung gilt auch die Karte **vor Ort** (§ 131b Abs. 1 Z 3 UStG), nicht
+  aber dieselbe Karte im Internet. Weil `card`/`online` beides sein können,
+  sagt es das Fremdsystem jetzt selbst — der Hinweis `cash_receipt_required`
+  kommt bei `cash` immer und sonst nur mit `onSite: true`. `transfer` mit
+  `onSite` wird abgewiesen.
+
 ## 0.19.0
 
 ### hobex HPS: TECS-Antwortcodes eingeordnet, Storno nach ausbleibender Host-Antwort

package/README.md

@@ -545,10 +545,23 @@ await rechnungen.recordInvoicePayment({
 ```
 
 `reference` wird gespeichert, aber **nicht gedruckt**; Kartendaten gehören
-ohnehin nicht auf eine Rechnung. Bei `method: 'cash'` wird die Zahlung gebucht
-und die Antwort trägt zusätzlich `notice.code = 'cash_receipt_required'`: eine
-Barzahlung ist ein Barumsatz und braucht einen Beleg (§ 132a BAO), bei
-Registrierkassenpflicht über die Kasse — der Vermerk hier ersetzt ihn nicht.
+ohnehin nicht auf eine Rechnung.
+
+**Barumsatz ist nicht nur Bargeld.** Als Barzahlung gilt auch die Karte **vor
+Ort** an der Kasse (§ 131b Abs. 1 Z 3 UStG) — dieselbe Karte im Internet
+dagegen nicht. Weil `card` und `online` beides sein können, sagt es das
+Fremdsystem selbst:
+
+```ts
+payment: { method: 'card', onSite: true }   // Terminal an der Kasse
+payment: { method: 'card' }                 // Kartenzahlung im Shop
+```
+
+Bei `cash` (immer) und bei `onSite: true` trägt die Antwort
+`notice.code = 'cash_receipt_required'`: ein Barumsatz braucht einen Beleg
+(§ 132a BAO), bei Registrierkassenpflicht über die Registrierkasse — der
+Vermerk an der Rechnung ersetzt ihn nicht. `transfer` mit `onSite` ist ein
+Feldfehler, eine Überweisung erfolgt nicht vor Ort.
 
 **Nach einem Zeitlimit mit demselben `idempotencyKey` wiederholen**, nie mit
 einem neuen: dann kommt die schon ausgestellte Rechnung zurück

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

@@ -16,4 +16,4 @@ export { istRechnungFehler, rechnungFehlerCode, rechnungFeldFehler, type Rechnun
 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 { 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 { 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/cjs/rechnung/index.js

@@ -12,7 +12,7 @@
  * Benutzung des Clients.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = exports.INVOICE_UNITS = exports.INVOICE_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 = exports.rechnungText = exports.RECHNUNG_TEXTE = exports.updateCustomer = exports.searchCustomers = exports.recordInvoicePayment = exports.listInvoices = exports.listBrands = exports.issueInvoice = exports.getInvoiceXml = exports.getInvoiceSetupStatus = exports.getInvoicePdf = exports.getInvoice = exports.getCustomer = exports.createCustomer = exports.createCreditNote = exports.cancelInvoice = exports.rechnungFeldFehler = exports.rechnungFehlerCode = exports.istRechnungFehler = exports.rechnungKeyAuth = exports.createRechnungApi = void 0;
+exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.REVERSE_CHARGE_REASONS = exports.ITEM_KINDS = 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 = exports.rechnungText = exports.RECHNUNG_TEXTE = exports.updateCustomer = exports.searchCustomers = exports.recordInvoicePayment = exports.listInvoices = exports.listBrands = exports.issueInvoice = exports.getInvoiceXml = exports.getInvoiceSetupStatus = exports.getInvoicePdf = exports.getInvoice = exports.getCustomer = exports.createCustomer = exports.createCreditNote = exports.cancelInvoice = exports.rechnungFeldFehler = exports.rechnungFehlerCode = exports.istRechnungFehler = exports.rechnungKeyAuth = exports.createRechnungApi = void 0;
 var api_js_1 = require("./api.js");
 Object.defineProperty(exports, "createRechnungApi", { enumerable: true, get: function () { return api_js_1.createRechnungApi; } });
 var auth_js_1 = require("./auth.js");
@@ -53,6 +53,8 @@ Object.defineProperty(exports, "DOC_TYPES", { enumerable: true, get: function ()
 Object.defineProperty(exports, "EINVOICE_FORMATS", { enumerable: true, get: function () { return vertrag_js_1.EINVOICE_FORMATS; } });
 Object.defineProperty(exports, "INVOICE_LANGUAGES", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_LANGUAGES; } });
 Object.defineProperty(exports, "INVOICE_PAYMENT_METHODS", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_PAYMENT_METHODS; } });
+Object.defineProperty(exports, "ITEM_KINDS", { enumerable: true, get: function () { return vertrag_js_1.ITEM_KINDS; } });
+Object.defineProperty(exports, "REVERSE_CHARGE_REASONS", { enumerable: true, get: function () { return vertrag_js_1.REVERSE_CHARGE_REASONS; } });
 Object.defineProperty(exports, "INVOICE_NOTICE_CODES", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_NOTICE_CODES; } });
 Object.defineProperty(exports, "INVOICE_UNITS", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_UNITS; } });
 Object.defineProperty(exports, "RECHNUNG_EINHEITEN_CODES", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_EINHEITEN_CODES; } });

package/dist/cjs/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/cjs/rechnung/texte.js

@@ -29,11 +29,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',
@@ -83,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',
@@ -211,11 +235,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',
@@ -265,6 +304,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;
@@ -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/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];
@@ -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/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'];
@@ -87,17 +142,28 @@ exports.EINVOICE_FORMATS = ['ubl', 'cii'];
  */
 exports.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).
  */
 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`,
@@ -274,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 },
@@ -291,6 +359,12 @@ exports.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 },
 });
 exports.RECHNUNG_ANFRAGEN = Object.freeze({
     createCustomer: {
@@ -316,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(),
@@ -384,6 +465,7 @@ exports.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/dist/esm/rechnung/index.d.ts

@@ -16,4 +16,4 @@ export { istRechnungFehler, rechnungFehlerCode, rechnungFeldFehler, type Rechnun
 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 { 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 { 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

@@ -15,4 +15,4 @@ 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 { 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 { 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';