@kreiseck/kasseneck-api 0.19.0 → 0.20.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/texte.d.ts

@@ -40,11 +40,12 @@ 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 'pdf.zahlung.titel': "ZAHLUNGSINFORMATIONEN";
     readonly 'pdf.zahlung.empfaenger': "Empfänger";
     readonly 'pdf.zahlung.iban': "IBAN";

package/dist/cjs/rechnung/texte.js

@@ -29,11 +29,18 @@ 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}',
     'pdf.zahlung.titel': 'ZAHLUNGSINFORMATIONEN',
     'pdf.zahlung.empfaenger': 'Empfänger',
     'pdf.zahlung.iban': 'IBAN',
@@ -211,11 +218,12 @@ 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}',
     'pdf.zahlung.titel': 'PAYMENT DETAILS',
     'pdf.zahlung.empfaenger': 'Payee',
     'pdf.zahlung.iban': 'IBAN',

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

@@ -118,6 +118,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. */

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

@@ -52,10 +52,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];

package/dist/cjs/rechnung/vertrag.js

@@ -87,10 +87,13 @@ 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'];
 /**
@@ -291,6 +294,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: {
@@ -384,6 +393,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/texte.d.ts

@@ -40,11 +40,12 @@ 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 'pdf.zahlung.titel': "ZAHLUNGSINFORMATIONEN";
     readonly 'pdf.zahlung.empfaenger': "Empfänger";
     readonly 'pdf.zahlung.iban': "IBAN";

package/dist/esm/rechnung/texte.js

@@ -25,11 +25,18 @@ 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}',
     'pdf.zahlung.titel': 'ZAHLUNGSINFORMATIONEN',
     'pdf.zahlung.empfaenger': 'Empfänger',
     'pdf.zahlung.iban': 'IBAN',
@@ -207,11 +214,12 @@ 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}',
     'pdf.zahlung.titel': 'PAYMENT DETAILS',
     'pdf.zahlung.empfaenger': 'Payee',
     'pdf.zahlung.iban': 'IBAN',

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

@@ -118,6 +118,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. */

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

@@ -52,10 +52,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];

package/dist/esm/rechnung/vertrag.js

@@ -84,10 +84,13 @@ 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'];
 /**
@@ -288,6 +291,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: {
@@ -381,6 +390,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.20.0",
   "gemessenAn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/kasse-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.19.0",
+  "version": "0.20.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.20.0",
   "aufrufe": [
     "activateCashregister",
     "cancelInvoice",

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"]
+  }
+}

package/fixtures/rechnung-api.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "Kasseneck Rechnungs-API",
   "version": 1,
-  "paket": "0.19.0",
+  "paket": "0.20.0",
   "aufrufe": {
     "createCustomer": {
       "anfrage": {
@@ -490,6 +490,9 @@
               "reference": {
                 "type": "string",
                 "maxLength": 100
+              },
+              "onSite": {
+                "type": "boolean"
               }
             },
             "required": [
@@ -853,6 +856,9 @@
           "reference": {
             "type": "string",
             "maxLength": 100
+          },
+          "onSite": {
+            "type": "boolean"
           }
         },
         "required": [

package/fixtures/rechnung-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.19.0",
+  "version": "0.20.0",
   "sprachen": [
     "de",
     "en"
@@ -32,11 +32,12 @@
       "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}",
+      "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.",
+      "steuer.uidZeile": "UID Leistungserbringer: {verkaeufer}   ·   UID Leistungsempfänger: {kaeufer}",
       "pdf.zahlung.titel": "ZAHLUNGSINFORMATIONEN",
       "pdf.zahlung.empfaenger": "Empfänger",
       "pdf.zahlung.iban": "IBAN",
@@ -214,11 +215,12 @@
       "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}",
       "pdf.zahlung.titel": "PAYMENT DETAILS",
       "pdf.zahlung.empfaenger": "Payee",
       "pdf.zahlung.iban": "IBAN",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "RKSV-Registrierkasse fuer JavaScript und TypeScript: signierte Belege, Storno, Kartenzahlung, Bondruck. Austrian fiscal cash register (RKSV) API client.",
   "license": "Apache-2.0",
   "author": "Kreiseck",