@kreiseck/kasseneck-api 0.31.0 → 0.32.1

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.32.1
+
+Halbgeviertstrich statt Geviertstrich in den sichtbaren Texten des Rechnungskatalogs
+(`src/rechnung/texte.ts`, beide Sprachen): `pdf.lastschrift.warnung` („Bitte für Deckung sorgen – die
+Kosten einer Rücklastschrift werden weiterverrechnet."), `pdf.fuss.hinweis`, der Reverse-Charge-Hinweis
+und die Befreiungsgründe `einvoice.befreiung.kleinunternehmer`/`outsideScope`. Grund: deutsche Typografie
+setzt als Gedankenstrich den Halbgeviertstrich mit Leerzeichen; der Geviertstrich stand nur hier.
+Schlüssel, Platzhalter und alle übrigen Zeichen bleiben gleich; wer die Texte byteweise vergleicht
+(PDF-/E-Rechnung-Goldens), zieht die fünf Sätze nach.
+
+## 0.32.0
+
+Vertragsgleichstand mit dem Backend für Lager-Kern Stufe 2. Das Backend vendort nur die 0.x-Linie und
+prüft daran seine Zwillingstests; darum kommen hier genau die Teile hinzu, die es dafür braucht – kein
+neuer Aufruf, kein neues Verhalten der Kasse. Die Kassen-Aufrufe des Lagers gibt es nur in 1.x (ab 1.2.0).
+
+- **Storno-Code `rueckgabe_ungueltig`** am Ende von `CANCELLATION_ERROR_CODES` (Zwilling von
+  `STORNO_FEHLERCODES`; unter `/v3` `invalid_return_disposition`). Grund: das Backend weist eine
+  Rückgabe-Wahl außerhalb von `lager|defekt|entsorgt` mit diesem Code ab, und die Kasse entscheidet am Code.
+- **Rechnungs-API:** `items[].articleId`, `stockLocationId` an `issueInvoice`, `returnDisposition`
+  (`restock|defective|disposed`) an `cancelInvoice` und `createCreditNote`, dort auch je Position
+  (`CreditNoteItemInput`, `GUTSCHRIFT_POSITION_FELDER`); Schema `fixtures/rechnung-api.schema.json` und
+  sechs Beispiele. Grund: das Backend nimmt die Felder seit Stufe 2 an und vergleicht sein Schema in beide
+  Richtungen mit dem vendorierten.
+
 ## 0.31.0
 
 Texte und Einstellung für „Getrennt zahlen" an der Kasse (ein Tisch zahlt in Teilen, ein Beleg mit

package/dist/cjs/models/cancellation.d.ts

@@ -41,7 +41,7 @@ export declare function isCancellationReason(value: unknown): value is Cancellat
  * diese Namen kommen mit der Umstellung des Pakets auf `/v3`.
  * [isCancellationErrorCode] prueft darum exakt.
  */
-export declare const CANCELLATION_ERROR_CODES: readonly ["beleg_nicht_gefunden", "belegart_nicht_stornierbar", "trainingsbeleg", "bereits_storniert", "position_ungueltig", "menge_ueber_rest", "grund_unbekannt", "anmerkung_zu_lang", "items_ungueltig", "kasse_nicht_zugewiesen", "keine_berechtigung", "nur_eigene_belege", "kasse_unvollstaendig", "storno_fehlgeschlagen", "STORNO_PAYMENTS_REQUIRED", "STORNO_REFUND_EXCEEDS_PAYMENT", "STORNO_REFUND_REFERENCE_REQUIRED", "STORNO_REFUND_REFERENCE_UNKNOWN", "STORNO_OUTCOME_UNKNOWN"];
+export declare const CANCELLATION_ERROR_CODES: readonly ["beleg_nicht_gefunden", "belegart_nicht_stornierbar", "trainingsbeleg", "bereits_storniert", "position_ungueltig", "menge_ueber_rest", "grund_unbekannt", "anmerkung_zu_lang", "items_ungueltig", "kasse_nicht_zugewiesen", "keine_berechtigung", "nur_eigene_belege", "kasse_unvollstaendig", "storno_fehlgeschlagen", "STORNO_PAYMENTS_REQUIRED", "STORNO_REFUND_EXCEEDS_PAYMENT", "STORNO_REFUND_REFERENCE_REQUIRED", "STORNO_REFUND_REFERENCE_UNKNOWN", "STORNO_OUTCOME_UNKNOWN", "rueckgabe_ungueltig"];
 export type CancellationErrorCode = (typeof CANCELLATION_ERROR_CODES)[number];
 export declare function isCancellationErrorCode(value: unknown): value is CancellationErrorCode;
 /** Bezug eines Storno-Belegs auf sein Original. */

package/dist/cjs/models/cancellation.js

@@ -68,6 +68,7 @@ exports.CANCELLATION_ERROR_CODES = [
     'STORNO_REFUND_REFERENCE_REQUIRED', // Karten-Rueckzahlung ohne refundOf einer Kartenzahlung
     'STORNO_REFUND_REFERENCE_UNKNOWN', // refundOf nennt keine Zahlung des Originals
     'STORNO_OUTCOME_UNKNOWN', // Ausgang offen: Storno-Beleg evtl. schon signiert, nicht wiederholen
+    'rueckgabe_ungueltig', // Lager-Kern Stufe 2: Rueckgabe-Wahl nicht lager, defekt oder entsorgt
 ];
 function isCancellationErrorCode(value) {
     return typeof value === 'string' && exports.CANCELLATION_ERROR_CODES.includes(value);

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

@@ -14,8 +14,8 @@ export { createRechnungApi, type RechnungApi, type RechnungApiOptions } from './
 export { rechnungKeyAuth, type RechnungKeyAuthOptions } from './auth.js';
 export { istRechnungFehler, rechnungFehlerCode, rechnungFeldFehler, type RechnungFeldFehler, } from './fehler.js';
 export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, previewInvoice, recordInvoicePayment, searchCustomers, updateCustomer, } from './endpunkte.js';
-export type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceSetupGap, InvoiceSetupStatus, InvoiceTotals, InvoiceNotice, InvoicePayment, InvoicePreview, InvoiceRateTotals, IssueInvoiceRequest, IssueResult, PaymentInput, PreviewResult, RecordPaymentRequest, RecordPaymentResult, } from './typen.js';
+export type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteItemInput, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceSetupGap, InvoiceSetupStatus, InvoiceTotals, InvoiceNotice, InvoicePayment, InvoicePreview, InvoiceRateTotals, IssueInvoiceRequest, IssueResult, PaymentInput, PreviewResult, RecordPaymentRequest, RecordPaymentResult, } from './typen.js';
 export { RECHNUNG_TEXTE, rechnungText, type RechnungTextSchluessel } from './texte.js';
 export { rechnungSummen, STEUERFREIE_FAELLE, type SummenPosition } from './summen.js';
 export { anteiligerPreis, BETRAG_GRENZE_CENTS, positionAusEuro, preisText, RechenFehler, rechnungRechnen, rund, satzSchluessel, satzText, type RechenErgebnis, type RechenFehlerCode, type RechenOptionen, type RechenPosition, type SatzSumme, type Umwandlung, type UmwandlungsGrund, type ZeilenBetrag, } from './rechnen.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, POSITION_PREIS_GENAU_EINS, 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';
+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, GUTSCHRIFT_POSITION_FELDER, RETURN_DISPOSITIONS, POSITION_PREIS_GENAU_EINS, 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 ReturnDisposition, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.js';

package/dist/cjs/rechnung/index.js

@@ -13,7 +13,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 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.satzText = exports.satzSchluessel = exports.rund = exports.rechnungRechnen = exports.RechenFehler = exports.preisText = exports.positionAusEuro = exports.BETRAG_GRENZE_CENTS = exports.anteiligerPreis = exports.STEUERFREIE_FAELLE = exports.rechnungSummen = exports.rechnungText = exports.RECHNUNG_TEXTE = exports.updateCustomer = exports.searchCustomers = exports.recordInvoicePayment = exports.previewInvoice = 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_PREIS_GENAU_EINS = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = void 0;
+exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.POSITION_PREIS_GENAU_EINS = exports.RETURN_DISPOSITIONS = exports.GUTSCHRIFT_POSITION_FELDER = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = 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");
@@ -76,6 +76,8 @@ Object.defineProperty(exports, "RECHNUNG_EINHEITEN_CODES", { enumerable: true, g
 Object.defineProperty(exports, "INVOICE_SETUP_REQUIREMENTS", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_SETUP_REQUIREMENTS; } });
 Object.defineProperty(exports, "KUNDE_FELDER", { enumerable: true, get: function () { return vertrag_js_1.KUNDE_FELDER; } });
 Object.defineProperty(exports, "POSITION_FELDER", { enumerable: true, get: function () { return vertrag_js_1.POSITION_FELDER; } });
+Object.defineProperty(exports, "GUTSCHRIFT_POSITION_FELDER", { enumerable: true, get: function () { return vertrag_js_1.GUTSCHRIFT_POSITION_FELDER; } });
+Object.defineProperty(exports, "RETURN_DISPOSITIONS", { enumerable: true, get: function () { return vertrag_js_1.RETURN_DISPOSITIONS; } });
 Object.defineProperty(exports, "POSITION_PREIS_GENAU_EINS", { enumerable: true, get: function () { return vertrag_js_1.POSITION_PREIS_GENAU_EINS; } });
 Object.defineProperty(exports, "RECHNUNG_ANFRAGEN", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_ANFRAGEN; } });
 Object.defineProperty(exports, "RECHNUNG_GENAU_EINS", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_GENAU_EINS; } });

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

@@ -48,7 +48,7 @@ declare const DE: {
     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': "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.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).";
@@ -84,7 +84,7 @@ declare const DE: {
     readonly 'pdf.lastschrift.konto': "Konto";
     readonly 'pdf.lastschrift.mandatsreferenz': "Mandatsreferenz";
     readonly 'pdf.lastschrift.mandatVom': "Mandat vom";
-    readonly 'pdf.lastschrift.warnung': "Bitte für Deckung sorgen — die Kosten einer Rücklastschrift werden weiterverrechnet.";
+    readonly 'pdf.lastschrift.warnung': "Bitte für Deckung sorgen – die Kosten einer Rücklastschrift werden weiterverrechnet.";
     readonly 'pdf.erstattung.text': "Der Betrag wird auf dem ursprünglichen Zahlungsweg erstattet. Sie müssen nichts veranlassen.";
     readonly 'pdf.erstattung.bezug': "Bezug";
     readonly 'pdf.erstattung.betrag': "Erstattungsbetrag";
@@ -95,7 +95,7 @@ declare const DE: {
     readonly 'pdf.fuss.kontakt': "Kontakt";
     readonly 'pdf.fuss.register': "Register & Steuer";
     readonly 'pdf.fuss.sitz': "Sitz: {ort}";
-    readonly 'pdf.fuss.hinweis': "Erstellt mit Kasseneck — ein Produkt der Kreiseck";
+    readonly 'pdf.fuss.hinweis': "Erstellt mit Kasseneck – ein Produkt der Kreiseck";
     readonly 'pdf.seite': "Seite {nummer} / {gesamt}";
     readonly 'land.AT': "Österreich";
     readonly 'land.DE': "Deutschland";
@@ -111,9 +111,9 @@ declare const DE: {
     readonly 'gutschrift.grund.incorrect_invoice': "Fehlerhafte Rechnung";
     readonly 'gutschrift.grund.other': "Sonstiges";
     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.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.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

@@ -41,7 +41,7 @@ const DE = {
     // 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.',
+    '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}',
@@ -81,7 +81,7 @@ const DE = {
     'pdf.lastschrift.konto': 'Konto',
     'pdf.lastschrift.mandatsreferenz': 'Mandatsreferenz',
     'pdf.lastschrift.mandatVom': 'Mandat vom',
-    'pdf.lastschrift.warnung': 'Bitte für Deckung sorgen — die Kosten einer Rücklastschrift werden weiterverrechnet.',
+    'pdf.lastschrift.warnung': 'Bitte für Deckung sorgen – die Kosten einer Rücklastschrift werden weiterverrechnet.',
     'pdf.erstattung.text': 'Der Betrag wird auf dem ursprünglichen Zahlungsweg erstattet. Sie müssen nichts veranlassen.',
     'pdf.erstattung.bezug': 'Bezug',
     'pdf.erstattung.betrag': 'Erstattungsbetrag',
@@ -92,7 +92,7 @@ const DE = {
     'pdf.fuss.kontakt': 'Kontakt',
     'pdf.fuss.register': 'Register & Steuer',
     'pdf.fuss.sitz': 'Sitz: {ort}',
-    'pdf.fuss.hinweis': 'Erstellt mit Kasseneck — ein Produkt der Kreiseck',
+    'pdf.fuss.hinweis': 'Erstellt mit Kasseneck – ein Produkt der Kreiseck',
     'pdf.seite': 'Seite {nummer} / {gesamt}',
     'land.AT': 'Österreich',
     'land.DE': 'Deutschland',
@@ -108,9 +108,9 @@ const DE = {
     'gutschrift.grund.incorrect_invoice': 'Fehlerhafte Rechnung',
     'gutschrift.grund.other': 'Sonstiges',
     'einvoice.befreiung.reverseCharge': 'Steuerschuldnerschaft des Leistungsempfängers (Reverse Charge)',
-    'einvoice.befreiung.kleinunternehmer': 'Steuerbefreit — Kleinunternehmer gemäß §6 Abs. 1 Z 27 UStG',
+    '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.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',
@@ -247,7 +247,7 @@ const EN = {
     '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': '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.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).',
@@ -283,7 +283,7 @@ const EN = {
     'pdf.lastschrift.konto': 'Account',
     'pdf.lastschrift.mandatsreferenz': 'Mandate reference',
     'pdf.lastschrift.mandatVom': 'Mandate date',
-    'pdf.lastschrift.warnung': 'Please ensure sufficient funds — the costs of a returned direct debit will be charged to you.',
+    'pdf.lastschrift.warnung': 'Please ensure sufficient funds – the costs of a returned direct debit will be charged to you.',
     'pdf.erstattung.text': 'The amount will be refunded via the original payment method. No action is required on your part.',
     'pdf.erstattung.bezug': 'Reference',
     'pdf.erstattung.betrag': 'Refund amount',
@@ -294,7 +294,7 @@ const EN = {
     'pdf.fuss.kontakt': 'Contact',
     'pdf.fuss.register': 'Registration & tax',
     'pdf.fuss.sitz': 'Registered office: {ort}',
-    'pdf.fuss.hinweis': 'Created with Kasseneck — a Kreiseck product',
+    'pdf.fuss.hinweis': 'Created with Kasseneck – a Kreiseck product',
     'pdf.seite': 'Page {nummer} / {gesamt}',
     'land.AT': 'Austria',
     'land.DE': 'Germany',
@@ -310,9 +310,9 @@ const EN = {
     'gutschrift.grund.incorrect_invoice': 'Incorrect invoice',
     'gutschrift.grund.other': 'Other',
     '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.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.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, ItemKind, ReverseChargeReason, InvoicePaymentMethod, InvoiceUnit, InvoiceSetupRequirement, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent } from './vertrag.js';
+import type { CreditNoteReason, CustomerType, DocType, InvoiceLanguage, InvoiceNoticeCode, ItemKind, ReverseChargeReason, InvoicePaymentMethod, InvoiceUnit, ReturnDisposition, InvoiceSetupRequirement, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent } from './vertrag.js';
 export interface CustomerInput {
     type: CustomerType;
     name: string;
@@ -86,6 +86,13 @@ export interface InvoiceItemInput {
     vatRate: VatRatePercent;
     /** Zeilenrabatt in Prozent, hoechstens zwei Nachkommastellen. */
     discountPct?: number;
+    /** Artikel aus dem Artikelstamm; bestandsgefuehrt bucht das Ausstellen ihn vom Lager ab. */
+    articleId?: string;
+}
+/** Eine Gutschriftsposition: wie eine Rechnungsposition, dazu die Rueckgabe-Wahl. */
+export interface CreditNoteItemInput extends InvoiceItemInput {
+    /** Wohin die Ware dieser Position geht; fehlt = Vorgabe des Aufrufs bzw. `restock`. */
+    returnDisposition?: ReturnDisposition;
 }
 export interface IssueInvoiceRequest {
     /** Pflicht: dieselbe Anfrage mit demselben Schluessel erzeugt nie eine zweite Rechnung. */
@@ -115,6 +122,8 @@ export interface IssueInvoiceRequest {
     language?: InvoiceLanguage;
     /** Marke (Kennung aus `listBrands`); sonst die Standardmarke. Unbekannt = `brand_not_found`. */
     brandId?: string;
+    /** Lager-Standort fuer bestandsgefuehrte Positionen; sonst der Standard-Standort. */
+    stockLocationId?: string;
     /**
      * Schon bezahlt (Shop kassiert online, Rechnung folgt). Die Zahlung entsteht
      * in derselben Transaktion wie das Festschreiben: das PDF traegt dann keine
@@ -175,9 +184,11 @@ export interface CancelInvoiceRequest {
     invoiceId: string;
     reason: CreditNoteReason;
     note?: string;
+    /** Wohin die Ware bestandsgefuehrter Positionen geht; fehlt = `restock`. */
+    returnDisposition?: ReturnDisposition;
 }
 export interface CreditNoteRequest extends CancelInvoiceRequest {
-    items: InvoiceItemInput[];
+    items: CreditNoteItemInput[];
 }
 /**
  * Summen einer Rechnung in Cent, **immer positiv** — auch bei einer Gutschrift

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

@@ -228,6 +228,9 @@ export type Feld = {
     schluesselMuster: string;
     wertMax: number;
 };
+/** Rueckgabe-Wahl einer Gutschrift (Lager-Kern Stufe 2), wie im Backend RUECKGABE_API. */
+export declare const RETURN_DISPOSITIONS: readonly ["restock", "defective", "disposed"];
+export type ReturnDisposition = (typeof RETURN_DISPOSITIONS)[number];
 /** Kunde, wie das Fremdsystem ihn schickt. `vatId` ist die UID-Nummer. */
 export declare const KUNDE_FELDER: Readonly<Record<string, Feld>>;
 /**
@@ -243,6 +246,8 @@ export declare const KUNDE_FELDER: Readonly<Record<string, Feld>>;
 export declare const POSITION_FELDER: Readonly<Record<string, Feld>>;
 /** Genau einer der beiden Preise je Position (§ 9.1). */
 export declare const POSITION_PREIS_GENAU_EINS: readonly (readonly string[])[];
+/** Gutschriftsposition: Rechnungsposition plus Rueckgabe-Wahl (an der Rechnung weist der Server sie ab). */
+export declare const GUTSCHRIFT_POSITION_FELDER: Readonly<Record<string, Feld>>;
 /**
  * Eine Zahlung zu einer Rechnung. Ohne `amountCents` gilt der volle
  * Bruttobetrag, ohne `paidAt` der heutige Wiener Tag. `reference` ist die

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_PREIS_GENAU_EINS = 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_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.PAYMENT_FELDER = exports.GUTSCHRIFT_POSITION_FELDER = exports.POSITION_PREIS_GENAU_EINS = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.RETURN_DISPOSITIONS = 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',
@@ -309,6 +309,9 @@ exports.INVOICE_SETUP_REQUIREMENTS = [
 const text = (max, pflicht = false, extra = {}) => ({ typ: 'string', pflicht, max, ...(pflicht && extra.min === undefined ? { min: 1 } : {}), ...extra });
 const idempotencyKey = (pflicht) => ({ typ: 'string', pflicht, min: 1, max: 120 });
 const id = { typ: 'string', pflicht: false, min: 1, max: 128 };
+/** Rueckgabe-Wahl einer Gutschrift (Lager-Kern Stufe 2), wie im Backend RUECKGABE_API. */
+exports.RETURN_DISPOSITIONS = ['restock', 'defective', 'disposed'];
+const rueckgabe = { typ: 'enum', pflicht: false, werte: exports.RETURN_DISPOSITIONS };
 const idPflicht = { typ: 'string', pflicht: true, min: 1, max: 128 };
 const datum = (pflicht = false) => ({ typ: 'string', pflicht, min: 10, max: 10, format: 'date' });
 const limit = { typ: 'integer', pflicht: false, min: 1, max: 100 };
@@ -359,6 +362,13 @@ exports.POSITION_FELDER = Object.freeze({
     unitPriceMicros: { typ: 'integer', pflicht: false, min: 0, max: 1_000_000_000_000 },
     vatRate: { typ: 'enum', pflicht: true, werte: exports.VAT_RATES },
     discountPct: { typ: 'number', pflicht: false, min: 0, max: 100, nachkomma: 2 },
+    /**
+     * Artikel aus dem Artikelstamm (Lager-Kern Stufe 2): ist er bestandsgefuehrt
+     * und das Modul Lager aktiv, bucht das Ausstellen ihn ab -- danach, die
+     * Rechnung scheitert nie am Lager. Kein „/“, nicht „.“, „..“ oder „__…__“
+     * (prueft der Server, `validation`).
+     */
+    articleId: id,
 });
 /** Genau einer der beiden Preise je Position (§ 9.1). */
 exports.POSITION_PREIS_GENAU_EINS = Object.freeze([
@@ -374,6 +384,17 @@ const positionen = {
         typ: 'object', pflicht: true, felder: exports.POSITION_FELDER, genauEins: exports.POSITION_PREIS_GENAU_EINS,
     },
 };
+/** Gutschriftsposition: Rechnungsposition plus Rueckgabe-Wahl (an der Rechnung weist der Server sie ab). */
+exports.GUTSCHRIFT_POSITION_FELDER = Object.freeze({ ...exports.POSITION_FELDER, returnDisposition: rueckgabe });
+const gutschriftPositionen = {
+    typ: 'list',
+    pflicht: true,
+    min: 1,
+    max: 500,
+    eintrag: {
+        typ: 'object', pflicht: true, felder: exports.GUTSCHRIFT_POSITION_FELDER, genauEins: exports.POSITION_PREIS_GENAU_EINS,
+    },
+};
 /**
  * Eine Zahlung zu einer Rechnung. Ohne `amountCents` gilt der volle
  * Bruttobetrag, ohne `paidAt` der heutige Wiener Tag. `reference` ist die
@@ -441,6 +462,8 @@ exports.RECHNUNG_ANFRAGEN = Object.freeze({
         language: { typ: 'enum', pflicht: false, werte: exports.INVOICE_LANGUAGES },
         /** Marke (Kennung aus `listBrands`); sonst die Standardmarke. */
         brandId: id,
+        /** Lagerstandort (Kennung), von dem bestandsgefuehrte Positionen abbuchen. */
+        stockLocationId: id,
         /**
          * Schon bezahlt: die Zahlung entsteht in **derselben** Transaktion wie das
          * Festschreiben. Sonst gaebe es einen Moment, in dem die Rechnung offen ist
@@ -459,13 +482,15 @@ exports.RECHNUNG_ANFRAGEN = Object.freeze({
         invoiceId: idPflicht,
         reason: { typ: 'enum', pflicht: true, werte: exports.CREDIT_NOTE_REASONS },
         note: text(2000),
+        returnDisposition: rueckgabe,
     },
     createCreditNote: {
         idempotencyKey: idempotencyKey(true),
         invoiceId: idPflicht,
         reason: { typ: 'enum', pflicht: true, werte: exports.CREDIT_NOTE_REASONS },
         note: text(2000),
-        items: positionen,
+        returnDisposition: rueckgabe,
+        items: gutschriftPositionen,
     },
     getInvoice: {
         invoiceId: id,

package/dist/esm/models/cancellation.d.ts

@@ -41,7 +41,7 @@ export declare function isCancellationReason(value: unknown): value is Cancellat
  * diese Namen kommen mit der Umstellung des Pakets auf `/v3`.
  * [isCancellationErrorCode] prueft darum exakt.
  */
-export declare const CANCELLATION_ERROR_CODES: readonly ["beleg_nicht_gefunden", "belegart_nicht_stornierbar", "trainingsbeleg", "bereits_storniert", "position_ungueltig", "menge_ueber_rest", "grund_unbekannt", "anmerkung_zu_lang", "items_ungueltig", "kasse_nicht_zugewiesen", "keine_berechtigung", "nur_eigene_belege", "kasse_unvollstaendig", "storno_fehlgeschlagen", "STORNO_PAYMENTS_REQUIRED", "STORNO_REFUND_EXCEEDS_PAYMENT", "STORNO_REFUND_REFERENCE_REQUIRED", "STORNO_REFUND_REFERENCE_UNKNOWN", "STORNO_OUTCOME_UNKNOWN"];
+export declare const CANCELLATION_ERROR_CODES: readonly ["beleg_nicht_gefunden", "belegart_nicht_stornierbar", "trainingsbeleg", "bereits_storniert", "position_ungueltig", "menge_ueber_rest", "grund_unbekannt", "anmerkung_zu_lang", "items_ungueltig", "kasse_nicht_zugewiesen", "keine_berechtigung", "nur_eigene_belege", "kasse_unvollstaendig", "storno_fehlgeschlagen", "STORNO_PAYMENTS_REQUIRED", "STORNO_REFUND_EXCEEDS_PAYMENT", "STORNO_REFUND_REFERENCE_REQUIRED", "STORNO_REFUND_REFERENCE_UNKNOWN", "STORNO_OUTCOME_UNKNOWN", "rueckgabe_ungueltig"];
 export type CancellationErrorCode = (typeof CANCELLATION_ERROR_CODES)[number];
 export declare function isCancellationErrorCode(value: unknown): value is CancellationErrorCode;
 /** Bezug eines Storno-Belegs auf sein Original. */

package/dist/esm/models/cancellation.js

@@ -62,6 +62,7 @@ export const CANCELLATION_ERROR_CODES = [
     'STORNO_REFUND_REFERENCE_REQUIRED', // Karten-Rueckzahlung ohne refundOf einer Kartenzahlung
     'STORNO_REFUND_REFERENCE_UNKNOWN', // refundOf nennt keine Zahlung des Originals
     'STORNO_OUTCOME_UNKNOWN', // Ausgang offen: Storno-Beleg evtl. schon signiert, nicht wiederholen
+    'rueckgabe_ungueltig', // Lager-Kern Stufe 2: Rueckgabe-Wahl nicht lager, defekt oder entsorgt
 ];
 export function isCancellationErrorCode(value) {
     return typeof value === 'string' && CANCELLATION_ERROR_CODES.includes(value);

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

@@ -14,8 +14,8 @@ export { createRechnungApi, type RechnungApi, type RechnungApiOptions } from './
 export { rechnungKeyAuth, type RechnungKeyAuthOptions } from './auth.js';
 export { istRechnungFehler, rechnungFehlerCode, rechnungFeldFehler, type RechnungFeldFehler, } from './fehler.js';
 export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, previewInvoice, recordInvoicePayment, searchCustomers, updateCustomer, } from './endpunkte.js';
-export type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceSetupGap, InvoiceSetupStatus, InvoiceTotals, InvoiceNotice, InvoicePayment, InvoicePreview, InvoiceRateTotals, IssueInvoiceRequest, IssueResult, PaymentInput, PreviewResult, RecordPaymentRequest, RecordPaymentResult, } from './typen.js';
+export type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteItemInput, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceSetupGap, InvoiceSetupStatus, InvoiceTotals, InvoiceNotice, InvoicePayment, InvoicePreview, InvoiceRateTotals, IssueInvoiceRequest, IssueResult, PaymentInput, PreviewResult, RecordPaymentRequest, RecordPaymentResult, } from './typen.js';
 export { RECHNUNG_TEXTE, rechnungText, type RechnungTextSchluessel } from './texte.js';
 export { rechnungSummen, STEUERFREIE_FAELLE, type SummenPosition } from './summen.js';
 export { anteiligerPreis, BETRAG_GRENZE_CENTS, positionAusEuro, preisText, RechenFehler, rechnungRechnen, rund, satzSchluessel, satzText, type RechenErgebnis, type RechenFehlerCode, type RechenOptionen, type RechenPosition, type SatzSumme, type Umwandlung, type UmwandlungsGrund, type ZeilenBetrag, } from './rechnen.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, POSITION_PREIS_GENAU_EINS, 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';
+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, GUTSCHRIFT_POSITION_FELDER, RETURN_DISPOSITIONS, POSITION_PREIS_GENAU_EINS, 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 ReturnDisposition, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.js';

package/dist/esm/rechnung/index.js

@@ -17,4 +17,4 @@ export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoic
 export { RECHNUNG_TEXTE, rechnungText } from './texte.js';
 export { rechnungSummen, STEUERFREIE_FAELLE } from './summen.js';
 export { anteiligerPreis, BETRAG_GRENZE_CENTS, positionAusEuro, preisText, RechenFehler, rechnungRechnen, rund, satzSchluessel, satzText, } from './rechnen.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, POSITION_PREIS_GENAU_EINS, 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, GUTSCHRIFT_POSITION_FELDER, RETURN_DISPOSITIONS, POSITION_PREIS_GENAU_EINS, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, } from './vertrag.js';

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

@@ -48,7 +48,7 @@ declare const DE: {
     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': "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.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).";
@@ -84,7 +84,7 @@ declare const DE: {
     readonly 'pdf.lastschrift.konto': "Konto";
     readonly 'pdf.lastschrift.mandatsreferenz': "Mandatsreferenz";
     readonly 'pdf.lastschrift.mandatVom': "Mandat vom";
-    readonly 'pdf.lastschrift.warnung': "Bitte für Deckung sorgen — die Kosten einer Rücklastschrift werden weiterverrechnet.";
+    readonly 'pdf.lastschrift.warnung': "Bitte für Deckung sorgen – die Kosten einer Rücklastschrift werden weiterverrechnet.";
     readonly 'pdf.erstattung.text': "Der Betrag wird auf dem ursprünglichen Zahlungsweg erstattet. Sie müssen nichts veranlassen.";
     readonly 'pdf.erstattung.bezug': "Bezug";
     readonly 'pdf.erstattung.betrag': "Erstattungsbetrag";
@@ -95,7 +95,7 @@ declare const DE: {
     readonly 'pdf.fuss.kontakt': "Kontakt";
     readonly 'pdf.fuss.register': "Register & Steuer";
     readonly 'pdf.fuss.sitz': "Sitz: {ort}";
-    readonly 'pdf.fuss.hinweis': "Erstellt mit Kasseneck — ein Produkt der Kreiseck";
+    readonly 'pdf.fuss.hinweis': "Erstellt mit Kasseneck – ein Produkt der Kreiseck";
     readonly 'pdf.seite': "Seite {nummer} / {gesamt}";
     readonly 'land.AT': "Österreich";
     readonly 'land.DE': "Deutschland";
@@ -111,9 +111,9 @@ declare const DE: {
     readonly 'gutschrift.grund.incorrect_invoice': "Fehlerhafte Rechnung";
     readonly 'gutschrift.grund.other': "Sonstiges";
     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.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.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

@@ -37,7 +37,7 @@ const DE = {
     // 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.',
+    '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}',
@@ -77,7 +77,7 @@ const DE = {
     'pdf.lastschrift.konto': 'Konto',
     'pdf.lastschrift.mandatsreferenz': 'Mandatsreferenz',
     'pdf.lastschrift.mandatVom': 'Mandat vom',
-    'pdf.lastschrift.warnung': 'Bitte für Deckung sorgen — die Kosten einer Rücklastschrift werden weiterverrechnet.',
+    'pdf.lastschrift.warnung': 'Bitte für Deckung sorgen – die Kosten einer Rücklastschrift werden weiterverrechnet.',
     'pdf.erstattung.text': 'Der Betrag wird auf dem ursprünglichen Zahlungsweg erstattet. Sie müssen nichts veranlassen.',
     'pdf.erstattung.bezug': 'Bezug',
     'pdf.erstattung.betrag': 'Erstattungsbetrag',
@@ -88,7 +88,7 @@ const DE = {
     'pdf.fuss.kontakt': 'Kontakt',
     'pdf.fuss.register': 'Register & Steuer',
     'pdf.fuss.sitz': 'Sitz: {ort}',
-    'pdf.fuss.hinweis': 'Erstellt mit Kasseneck — ein Produkt der Kreiseck',
+    'pdf.fuss.hinweis': 'Erstellt mit Kasseneck – ein Produkt der Kreiseck',
     'pdf.seite': 'Seite {nummer} / {gesamt}',
     'land.AT': 'Österreich',
     'land.DE': 'Deutschland',
@@ -104,9 +104,9 @@ const DE = {
     'gutschrift.grund.incorrect_invoice': 'Fehlerhafte Rechnung',
     'gutschrift.grund.other': 'Sonstiges',
     'einvoice.befreiung.reverseCharge': 'Steuerschuldnerschaft des Leistungsempfängers (Reverse Charge)',
-    'einvoice.befreiung.kleinunternehmer': 'Steuerbefreit — Kleinunternehmer gemäß §6 Abs. 1 Z 27 UStG',
+    '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.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',
@@ -243,7 +243,7 @@ const EN = {
     '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': '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.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).',
@@ -279,7 +279,7 @@ const EN = {
     'pdf.lastschrift.konto': 'Account',
     'pdf.lastschrift.mandatsreferenz': 'Mandate reference',
     'pdf.lastschrift.mandatVom': 'Mandate date',
-    'pdf.lastschrift.warnung': 'Please ensure sufficient funds — the costs of a returned direct debit will be charged to you.',
+    'pdf.lastschrift.warnung': 'Please ensure sufficient funds – the costs of a returned direct debit will be charged to you.',
     'pdf.erstattung.text': 'The amount will be refunded via the original payment method. No action is required on your part.',
     'pdf.erstattung.bezug': 'Reference',
     'pdf.erstattung.betrag': 'Refund amount',
@@ -290,7 +290,7 @@ const EN = {
     'pdf.fuss.kontakt': 'Contact',
     'pdf.fuss.register': 'Registration & tax',
     'pdf.fuss.sitz': 'Registered office: {ort}',
-    'pdf.fuss.hinweis': 'Created with Kasseneck — a Kreiseck product',
+    'pdf.fuss.hinweis': 'Created with Kasseneck – a Kreiseck product',
     'pdf.seite': 'Page {nummer} / {gesamt}',
     'land.AT': 'Austria',
     'land.DE': 'Germany',
@@ -306,9 +306,9 @@ const EN = {
     'gutschrift.grund.incorrect_invoice': 'Incorrect invoice',
     'gutschrift.grund.other': 'Other',
     '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.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.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, ItemKind, ReverseChargeReason, InvoicePaymentMethod, InvoiceUnit, InvoiceSetupRequirement, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent } from './vertrag.js';
+import type { CreditNoteReason, CustomerType, DocType, InvoiceLanguage, InvoiceNoticeCode, ItemKind, ReverseChargeReason, InvoicePaymentMethod, InvoiceUnit, ReturnDisposition, InvoiceSetupRequirement, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent } from './vertrag.js';
 export interface CustomerInput {
     type: CustomerType;
     name: string;
@@ -86,6 +86,13 @@ export interface InvoiceItemInput {
     vatRate: VatRatePercent;
     /** Zeilenrabatt in Prozent, hoechstens zwei Nachkommastellen. */
     discountPct?: number;
+    /** Artikel aus dem Artikelstamm; bestandsgefuehrt bucht das Ausstellen ihn vom Lager ab. */
+    articleId?: string;
+}
+/** Eine Gutschriftsposition: wie eine Rechnungsposition, dazu die Rueckgabe-Wahl. */
+export interface CreditNoteItemInput extends InvoiceItemInput {
+    /** Wohin die Ware dieser Position geht; fehlt = Vorgabe des Aufrufs bzw. `restock`. */
+    returnDisposition?: ReturnDisposition;
 }
 export interface IssueInvoiceRequest {
     /** Pflicht: dieselbe Anfrage mit demselben Schluessel erzeugt nie eine zweite Rechnung. */
@@ -115,6 +122,8 @@ export interface IssueInvoiceRequest {
     language?: InvoiceLanguage;
     /** Marke (Kennung aus `listBrands`); sonst die Standardmarke. Unbekannt = `brand_not_found`. */
     brandId?: string;
+    /** Lager-Standort fuer bestandsgefuehrte Positionen; sonst der Standard-Standort. */
+    stockLocationId?: string;
     /**
      * Schon bezahlt (Shop kassiert online, Rechnung folgt). Die Zahlung entsteht
      * in derselben Transaktion wie das Festschreiben: das PDF traegt dann keine
@@ -175,9 +184,11 @@ export interface CancelInvoiceRequest {
     invoiceId: string;
     reason: CreditNoteReason;
     note?: string;
+    /** Wohin die Ware bestandsgefuehrter Positionen geht; fehlt = `restock`. */
+    returnDisposition?: ReturnDisposition;
 }
 export interface CreditNoteRequest extends CancelInvoiceRequest {
-    items: InvoiceItemInput[];
+    items: CreditNoteItemInput[];
 }
 /**
  * Summen einer Rechnung in Cent, **immer positiv** — auch bei einer Gutschrift

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

@@ -228,6 +228,9 @@ export type Feld = {
     schluesselMuster: string;
     wertMax: number;
 };
+/** Rueckgabe-Wahl einer Gutschrift (Lager-Kern Stufe 2), wie im Backend RUECKGABE_API. */
+export declare const RETURN_DISPOSITIONS: readonly ["restock", "defective", "disposed"];
+export type ReturnDisposition = (typeof RETURN_DISPOSITIONS)[number];
 /** Kunde, wie das Fremdsystem ihn schickt. `vatId` ist die UID-Nummer. */
 export declare const KUNDE_FELDER: Readonly<Record<string, Feld>>;
 /**
@@ -243,6 +246,8 @@ export declare const KUNDE_FELDER: Readonly<Record<string, Feld>>;
 export declare const POSITION_FELDER: Readonly<Record<string, Feld>>;
 /** Genau einer der beiden Preise je Position (§ 9.1). */
 export declare const POSITION_PREIS_GENAU_EINS: readonly (readonly string[])[];
+/** Gutschriftsposition: Rechnungsposition plus Rueckgabe-Wahl (an der Rechnung weist der Server sie ab). */
+export declare const GUTSCHRIFT_POSITION_FELDER: Readonly<Record<string, Feld>>;
 /**
  * Eine Zahlung zu einer Rechnung. Ohne `amountCents` gilt der volle
  * Bruttobetrag, ohne `paidAt` der heutige Wiener Tag. `reference` ist die

package/dist/esm/rechnung/vertrag.js

@@ -306,6 +306,9 @@ export const INVOICE_SETUP_REQUIREMENTS = [
 const text = (max, pflicht = false, extra = {}) => ({ typ: 'string', pflicht, max, ...(pflicht && extra.min === undefined ? { min: 1 } : {}), ...extra });
 const idempotencyKey = (pflicht) => ({ typ: 'string', pflicht, min: 1, max: 120 });
 const id = { typ: 'string', pflicht: false, min: 1, max: 128 };
+/** Rueckgabe-Wahl einer Gutschrift (Lager-Kern Stufe 2), wie im Backend RUECKGABE_API. */
+export const RETURN_DISPOSITIONS = ['restock', 'defective', 'disposed'];
+const rueckgabe = { typ: 'enum', pflicht: false, werte: RETURN_DISPOSITIONS };
 const idPflicht = { typ: 'string', pflicht: true, min: 1, max: 128 };
 const datum = (pflicht = false) => ({ typ: 'string', pflicht, min: 10, max: 10, format: 'date' });
 const limit = { typ: 'integer', pflicht: false, min: 1, max: 100 };
@@ -356,6 +359,13 @@ export const POSITION_FELDER = Object.freeze({
     unitPriceMicros: { typ: 'integer', pflicht: false, min: 0, max: 1_000_000_000_000 },
     vatRate: { typ: 'enum', pflicht: true, werte: VAT_RATES },
     discountPct: { typ: 'number', pflicht: false, min: 0, max: 100, nachkomma: 2 },
+    /**
+     * Artikel aus dem Artikelstamm (Lager-Kern Stufe 2): ist er bestandsgefuehrt
+     * und das Modul Lager aktiv, bucht das Ausstellen ihn ab -- danach, die
+     * Rechnung scheitert nie am Lager. Kein „/“, nicht „.“, „..“ oder „__…__“
+     * (prueft der Server, `validation`).
+     */
+    articleId: id,
 });
 /** Genau einer der beiden Preise je Position (§ 9.1). */
 export const POSITION_PREIS_GENAU_EINS = Object.freeze([
@@ -371,6 +381,17 @@ const positionen = {
         typ: 'object', pflicht: true, felder: POSITION_FELDER, genauEins: POSITION_PREIS_GENAU_EINS,
     },
 };
+/** Gutschriftsposition: Rechnungsposition plus Rueckgabe-Wahl (an der Rechnung weist der Server sie ab). */
+export const GUTSCHRIFT_POSITION_FELDER = Object.freeze({ ...POSITION_FELDER, returnDisposition: rueckgabe });
+const gutschriftPositionen = {
+    typ: 'list',
+    pflicht: true,
+    min: 1,
+    max: 500,
+    eintrag: {
+        typ: 'object', pflicht: true, felder: GUTSCHRIFT_POSITION_FELDER, genauEins: POSITION_PREIS_GENAU_EINS,
+    },
+};
 /**
  * Eine Zahlung zu einer Rechnung. Ohne `amountCents` gilt der volle
  * Bruttobetrag, ohne `paidAt` der heutige Wiener Tag. `reference` ist die
@@ -438,6 +459,8 @@ export const RECHNUNG_ANFRAGEN = Object.freeze({
         language: { typ: 'enum', pflicht: false, werte: INVOICE_LANGUAGES },
         /** Marke (Kennung aus `listBrands`); sonst die Standardmarke. */
         brandId: id,
+        /** Lagerstandort (Kennung), von dem bestandsgefuehrte Positionen abbuchen. */
+        stockLocationId: id,
         /**
          * Schon bezahlt: die Zahlung entsteht in **derselben** Transaktion wie das
          * Festschreiben. Sonst gaebe es einen Moment, in dem die Rechnung offen ist
@@ -456,13 +479,15 @@ export const RECHNUNG_ANFRAGEN = Object.freeze({
         invoiceId: idPflicht,
         reason: { typ: 'enum', pflicht: true, werte: CREDIT_NOTE_REASONS },
         note: text(2000),
+        returnDisposition: rueckgabe,
     },
     createCreditNote: {
         idempotencyKey: idempotencyKey(true),
         invoiceId: idPflicht,
         reason: { typ: 'enum', pflicht: true, werte: CREDIT_NOTE_REASONS },
         note: text(2000),
-        items: positionen,
+        returnDisposition: rueckgabe,
+        items: gutschriftPositionen,
     },
     getInvoice: {
         invoiceId: id,

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.31.0",
+  "version": "0.32.1",
   "gemessenAn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/kasse-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.31.0",
+  "version": "0.32.1",
   "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.31.0",
+  "version": "0.32.1",
   "aufrufe": [
     "activateCashregister",
     "cancelInvoice",
@@ -530,6 +530,11 @@
       "listBrands",
       "recordInvoicePayment"
     ],
+    "returnDispositions": [
+      "restock",
+      "defective",
+      "disposed"
+    ],
     "steuerfreieFaelle": [
       "smallBusiness",
       "reverseCharge",

package/fixtures/rechnung-api-beispiele/credit-fehler-rueckgabe.json

@@ -0,0 +1,26 @@
+{
+  "aufruf": "createCreditNote",
+  "beschreibung": "Unbekannte Rueckgabe-Wahl an der Position",
+  "anfrage": {
+    "idempotencyKey": "bsp-15",
+    "invoiceId": "rechnung_beispiel",
+    "reason": "return",
+    "items": [
+      {
+        "description": "Roggenbrot",
+        "quantity": 1,
+        "unitPriceCents": 450,
+        "vatRate": 10,
+        "articleId": "rye-bread",
+        "returnDisposition": "lost"
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "items[0].returnDisposition"
+    ]
+  }
+}

package/fixtures/rechnung-api-beispiele/credit-rueckgabe.json

@@ -0,0 +1,23 @@
+{
+  "aufruf": "createCreditNote",
+  "beschreibung": "Rueckgabe: Vorgabe zurueck ins Lager, eine Position defekt",
+  "anfrage": {
+    "idempotencyKey": "bsp-14",
+    "invoiceId": "rechnung_beispiel",
+    "reason": "return",
+    "returnDisposition": "restock",
+    "items": [
+      {
+        "description": "Roggenbrot",
+        "quantity": 1,
+        "unitPriceCents": 450,
+        "vatRate": 10,
+        "articleId": "rye-bread",
+        "returnDisposition": "defective"
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": true
+  }
+}

package/fixtures/rechnung-api-beispiele/issue-fehler-lagerkennung.json

@@ -0,0 +1,27 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Lager-Kennungen ohne Schraegstrich und nicht nur Punkte",
+  "anfrage": {
+    "idempotencyKey": "bsp-18",
+    "priceMode": "gross",
+    "serviceStart": "2026-10-01",
+    "stockLocationId": "..",
+    "items": [
+      {
+        "description": "Roggenbrot",
+        "quantity": 1,
+        "unitPriceCents": 450,
+        "vatRate": 10,
+        "articleId": "a/b"
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "stockLocationId",
+      "items[0].articleId"
+    ]
+  }
+}

package/fixtures/rechnung-api-beispiele/issue-fehler-rueckgabe.json

@@ -0,0 +1,25 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Die Rueckgabe-Wahl gehoert an die Gutschrift, nicht an die Rechnung",
+  "anfrage": {
+    "idempotencyKey": "bsp-17",
+    "priceMode": "gross",
+    "serviceStart": "2026-10-01",
+    "items": [
+      {
+        "description": "Roggenbrot",
+        "quantity": 1,
+        "unitPriceCents": 450,
+        "vatRate": 10,
+        "returnDisposition": "restock"
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "items[0].returnDisposition"
+    ]
+  }
+}

package/fixtures/rechnung-api-beispiele/issue-lager.json

@@ -0,0 +1,22 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Bestandsgefuehrter Artikel, abgebucht vom Lieferwagen",
+  "anfrage": {
+    "idempotencyKey": "bsp-13",
+    "priceMode": "gross",
+    "serviceStart": "2026-10-01",
+    "stockLocationId": "van-1",
+    "items": [
+      {
+        "description": "Roggenbrot",
+        "quantity": 2,
+        "unitPriceCents": 450,
+        "vatRate": 10,
+        "articleId": "rye-bread"
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": true
+  }
+}

package/fixtures/rechnung-api-beispiele/storno-fehler-rueckgabe.json

@@ -0,0 +1,17 @@
+{
+  "aufruf": "cancelInvoice",
+  "beschreibung": "Unbekannte Rueckgabe-Wahl beim Vollstorno",
+  "anfrage": {
+    "idempotencyKey": "bsp-16",
+    "invoiceId": "rechnung_beispiel",
+    "reason": "return",
+    "returnDisposition": "lost"
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "returnDisposition"
+    ]
+  }
+}

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.31.0",
+  "paket": "0.32.1",
   "aufrufe": {
     "createCustomer": {
       "anfrage": {
@@ -461,6 +461,11 @@
                   "minimum": 0,
                   "maximum": 100,
                   "x-decimals": 2
+                },
+                "articleId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 128
                 }
               },
               "required": [
@@ -505,6 +510,11 @@
             "minLength": 1,
             "maxLength": 128
           },
+          "stockLocationId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
           "payment": {
             "type": "object",
             "properties": {
@@ -579,6 +589,13 @@
           "note": {
             "type": "string",
             "maxLength": 2000
+          },
+          "returnDisposition": {
+            "enum": [
+              "restock",
+              "defective",
+              "disposed"
+            ]
           }
         },
         "required": [
@@ -616,6 +633,13 @@
             "type": "string",
             "maxLength": 2000
           },
+          "returnDisposition": {
+            "enum": [
+              "restock",
+              "defective",
+              "disposed"
+            ]
+          },
           "items": {
             "type": "array",
             "minItems": 1,
@@ -720,6 +744,18 @@
                   "minimum": 0,
                   "maximum": 100,
                   "x-decimals": 2
+                },
+                "articleId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 128
+                },
+                "returnDisposition": {
+                  "enum": [
+                    "restock",
+                    "defective",
+                    "disposed"
+                  ]
                 }
               },
               "required": [

package/fixtures/rechnung-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.31.0",
+  "version": "0.32.1",
   "sprachen": [
     "de",
     "en"
@@ -40,7 +40,7 @@
       "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": "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.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}",
       "steuer.rcGrund.construction": "Bauleistung gemäß § 19 Abs. 1a UStG.",
       "steuer.rcGrund.scrap": "Schrott und Abfallstoffe gemäß Schrott-Umsatzsteuerverordnung (BGBl. II Nr. 129/2007).",
@@ -76,7 +76,7 @@
       "pdf.lastschrift.konto": "Konto",
       "pdf.lastschrift.mandatsreferenz": "Mandatsreferenz",
       "pdf.lastschrift.mandatVom": "Mandat vom",
-      "pdf.lastschrift.warnung": "Bitte für Deckung sorgen — die Kosten einer Rücklastschrift werden weiterverrechnet.",
+      "pdf.lastschrift.warnung": "Bitte für Deckung sorgen – die Kosten einer Rücklastschrift werden weiterverrechnet.",
       "pdf.erstattung.text": "Der Betrag wird auf dem ursprünglichen Zahlungsweg erstattet. Sie müssen nichts veranlassen.",
       "pdf.erstattung.bezug": "Bezug",
       "pdf.erstattung.betrag": "Erstattungsbetrag",
@@ -87,7 +87,7 @@
       "pdf.fuss.kontakt": "Kontakt",
       "pdf.fuss.register": "Register & Steuer",
       "pdf.fuss.sitz": "Sitz: {ort}",
-      "pdf.fuss.hinweis": "Erstellt mit Kasseneck — ein Produkt der Kreiseck",
+      "pdf.fuss.hinweis": "Erstellt mit Kasseneck – ein Produkt der Kreiseck",
       "pdf.seite": "Seite {nummer} / {gesamt}",
       "land.AT": "Österreich",
       "land.DE": "Deutschland",
@@ -103,9 +103,9 @@
       "gutschrift.grund.incorrect_invoice": "Fehlerhafte Rechnung",
       "gutschrift.grund.other": "Sonstiges",
       "einvoice.befreiung.reverseCharge": "Steuerschuldnerschaft des Leistungsempfängers (Reverse Charge)",
-      "einvoice.befreiung.kleinunternehmer": "Steuerbefreit — Kleinunternehmer gemäß §6 Abs. 1 Z 27 UStG",
+      "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.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",
@@ -242,7 +242,7 @@
       "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": "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.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).",
@@ -278,7 +278,7 @@
       "pdf.lastschrift.konto": "Account",
       "pdf.lastschrift.mandatsreferenz": "Mandate reference",
       "pdf.lastschrift.mandatVom": "Mandate date",
-      "pdf.lastschrift.warnung": "Please ensure sufficient funds — the costs of a returned direct debit will be charged to you.",
+      "pdf.lastschrift.warnung": "Please ensure sufficient funds – the costs of a returned direct debit will be charged to you.",
       "pdf.erstattung.text": "The amount will be refunded via the original payment method. No action is required on your part.",
       "pdf.erstattung.bezug": "Reference",
       "pdf.erstattung.betrag": "Refund amount",
@@ -289,7 +289,7 @@
       "pdf.fuss.kontakt": "Contact",
       "pdf.fuss.register": "Registration & tax",
       "pdf.fuss.sitz": "Registered office: {ort}",
-      "pdf.fuss.hinweis": "Created with Kasseneck — a Kreiseck product",
+      "pdf.fuss.hinweis": "Created with Kasseneck – a Kreiseck product",
       "pdf.seite": "Page {nummer} / {gesamt}",
       "land.AT": "Austria",
       "land.DE": "Germany",
@@ -305,9 +305,9 @@
       "gutschrift.grund.incorrect_invoice": "Incorrect invoice",
       "gutschrift.grund.other": "Other",
       "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.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.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "0.31.0",
+  "version": "0.32.1",
   "description": "Austrian fiscal cash register (RKSV) client for JavaScript and TypeScript: signed receipts, cancellations, card payments, receipt printing (ESC/POS), invoices. RKSV-Registrierkasse für JavaScript und TypeScript.",
   "license": "Apache-2.0",
   "author": "Kreiseck",