@kreiseck/kasseneck-api 1.1.1 → 1.2.1

package/dist/cjs/invoice/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.
     'tax.reverse_charge.title': 'Steuerschuldnerschaft des Leistungsempfängers. ',
-    'tax.reverse_charge.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.',
+    'tax.reverse_charge.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.
     'tax.vat_id_line': 'UID Leistungserbringer: {seller}   ·   UID Leistungsempfänger: {buyer}',
@@ -81,7 +81,7 @@ const DE = {
     'pdf.direct_debit.account': 'Konto',
     'pdf.direct_debit.mandate_reference': 'Mandatsreferenz',
     'pdf.direct_debit.mandate_date': 'Mandat vom',
-    'pdf.direct_debit.warning': 'Bitte für Deckung sorgen — die Kosten einer Rücklastschrift werden weiterverrechnet.',
+    'pdf.direct_debit.warning': 'Bitte für Deckung sorgen – die Kosten einer Rücklastschrift werden weiterverrechnet.',
     'pdf.refund.text': 'Der Betrag wird auf dem ursprünglichen Zahlungsweg erstattet. Sie müssen nichts veranlassen.',
     'pdf.refund.reference': 'Bezug',
     'pdf.refund.amount': 'Erstattungsbetrag',
@@ -92,7 +92,7 @@ const DE = {
     'pdf.footer.contact': 'Kontakt',
     'pdf.footer.register': 'Register & Steuer',
     'pdf.footer.registered_office': 'Sitz: {place}',
-    'pdf.footer.note': 'Erstellt mit Kasseneck — ein Produkt der Kreiseck',
+    'pdf.footer.note': 'Erstellt mit Kasseneck – ein Produkt der Kreiseck',
     'pdf.page': 'Seite {number} / {total}',
     'country.AT': 'Österreich',
     'country.DE': 'Deutschland',
@@ -108,9 +108,9 @@ const DE = {
     'credit_note.reason.incorrect_invoice': 'Fehlerhafte Rechnung',
     'credit_note.reason.other': 'Sonstiges',
     'einvoice.exemption.reverse_charge': 'Steuerschuldnerschaft des Leistungsempfängers (Reverse Charge)',
-    'einvoice.exemption.small_business': 'Steuerbefreit — Kleinunternehmer gemäß §6 Abs. 1 Z 27 UStG',
+    'einvoice.exemption.small_business': 'Steuerbefreit – Kleinunternehmer gemäß §6 Abs. 1 Z 27 UStG',
     'einvoice.exemption.intra_community_supply': 'Steuerfreie innergemeinschaftliche Lieferung gemäß Art. 6 Abs. 1 UStG',
-    'einvoice.exemption.outside_scope': 'Nicht steuerbarer Umsatz — Leistungsort im Ausland (§ 3a Abs. 6 UStG)',
+    'einvoice.exemption.outside_scope': 'Nicht steuerbarer Umsatz – Leistungsort im Ausland (§ 3a Abs. 6 UStG)',
     'einvoice.exemption.export_third_country': 'Steuerfreie Ausfuhrlieferung gemäß §6 Abs. 1 Z 1 UStG',
     'einvoice.payable_until': 'Zahlbar bis {date}',
     'unit_symbol.piece': 'Stk',
@@ -247,7 +247,7 @@ const EN = {
     'tax.intra_community_supply.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.',
     'tax.export_third_country': 'VAT-exempt export delivery (§ 6 (1) no. 1 UStG).',
     'tax.reverse_charge.title': 'Reverse charge – VAT liability of the recipient. ',
-    'tax.reverse_charge.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.',
+    'tax.reverse_charge.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.',
     'tax.vat_id_line': 'VAT ID supplier: {seller}   ·   VAT ID recipient: {buyer}',
     'tax.reverse_charge_reason.construction': 'Construction work pursuant to § 19 (1a) UStG.',
     'tax.reverse_charge_reason.scrap': 'Scrap and waste materials pursuant to the Austrian scrap VAT regulation (BGBl. II No. 129/2007).',
@@ -283,7 +283,7 @@ const EN = {
     'pdf.direct_debit.account': 'Account',
     'pdf.direct_debit.mandate_reference': 'Mandate reference',
     'pdf.direct_debit.mandate_date': 'Mandate date',
-    'pdf.direct_debit.warning': 'Please ensure sufficient funds — the costs of a returned direct debit will be charged to you.',
+    'pdf.direct_debit.warning': 'Please ensure sufficient funds – the costs of a returned direct debit will be charged to you.',
     'pdf.refund.text': 'The amount will be refunded via the original payment method. No action is required on your part.',
     'pdf.refund.reference': 'Reference',
     'pdf.refund.amount': 'Refund amount',
@@ -294,7 +294,7 @@ const EN = {
     'pdf.footer.contact': 'Contact',
     'pdf.footer.register': 'Registration & tax',
     'pdf.footer.registered_office': 'Registered office: {place}',
-    'pdf.footer.note': 'Created with Kasseneck — a Kreiseck product',
+    'pdf.footer.note': 'Created with Kasseneck – a Kreiseck product',
     'pdf.page': 'Page {number} / {total}',
     'country.AT': 'Austria',
     'country.DE': 'Germany',
@@ -310,9 +310,9 @@ const EN = {
     'credit_note.reason.incorrect_invoice': 'Incorrect invoice',
     'credit_note.reason.other': 'Other',
     'einvoice.exemption.reverse_charge': 'Reverse charge – VAT liability of the recipient',
-    'einvoice.exemption.small_business': 'VAT exempt — small business pursuant to § 6 (1) no. 27 UStG',
+    'einvoice.exemption.small_business': 'VAT exempt – small business pursuant to § 6 (1) no. 27 UStG',
     'einvoice.exemption.intra_community_supply': 'VAT-exempt intra-Community supply pursuant to Art. 6 (1) UStG',
-    'einvoice.exemption.outside_scope': 'Outside the scope of VAT — place of supply abroad (§ 3a (6) UStG)',
+    'einvoice.exemption.outside_scope': 'Outside the scope of VAT – place of supply abroad (§ 3a (6) UStG)',
     'einvoice.exemption.export_third_country': 'VAT-exempt export delivery pursuant to § 6 (1) no. 1 UStG',
     'einvoice.payable_until': 'Payable by {date}',
     'unit_symbol.piece': 'pcs',

package/dist/cjs/invoice/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, EInvoiceFormat, EInvoiceMissingCode, InvoiceLanguage, InvoiceNoticeCode, ItemKind, ReverseChargeReason, InvoicePaymentMethod, InvoiceUnit, InvoiceSetupRequirement, InvoiceListStatus, PriceMode, TaxScheme, VatRatePercent, WriteOffReasonCode } from './vertrag.js';
+import type { CreditNoteReason, CustomerType, DocType, EInvoiceFormat, EInvoiceMissingCode, InvoiceLanguage, InvoiceNoticeCode, ItemKind, ReverseChargeReason, InvoicePaymentMethod, InvoiceUnit, InvoiceSetupRequirement, InvoiceListStatus, PriceMode, ReturnDisposition, TaxScheme, VatRatePercent, WriteOffReasonCode } 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/invoice/vertrag.d.ts

@@ -17,6 +17,9 @@
  * Beschrieben wird die Anfrage. Was der Server daraus macht — Rechnungsdatum,
  * Nummer, Summen — ist bewusst **nicht** setzbar.
  */
+import { RETURN_DISPOSITIONS } from '../models/cancellation.js';
+export { RETURN_DISPOSITIONS };
+export type { ReturnDisposition } from '../models/cancellation.js';
 export declare const INVOICE_CONTRACT_VERSION = 2;
 export declare const INVOICE_ENDPOINTS: readonly ["createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus", "listBrands", "recordInvoicePayment"];
 export type InvoiceEndpoint = (typeof INVOICE_ENDPOINTS)[number];
@@ -34,7 +37,7 @@ export type InvoiceErrorCode = (typeof INVOICE_ERROR_CODES)[number];
  * genau der Katalog des Servers (das Backend vergleicht ihn mit dem Schema);
  * die Helfer in `./invoice` erkennen beide Listen.
  */
-export declare const INVOICE_REQUEST_ERROR_CODES: readonly ["account_not_found", "admin_required", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "route_missing"];
+export declare const INVOICE_REQUEST_ERROR_CODES: readonly ["account_not_found", "admin_required", "api_not_approved", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "route_missing"];
 export type InvoiceRequestErrorCode = (typeof INVOICE_REQUEST_ERROR_CODES)[number];
 /** Gruende einer Gutschrift. Der Server druckt den deutschen Anzeigetext. */
 export declare const CREDIT_NOTE_REASONS: readonly ["cancellation", "price_reduction", "return", "incorrect_invoice", "other"];
@@ -269,6 +272,12 @@ export declare const CUSTOMER_FIELDS: Readonly<Record<string, Field>>;
 export declare const ITEM_FIELDS: Readonly<Record<string, Field>>;
 /** Genau einer der beiden Preise je Position (§ 9.1). */
 export declare const ITEM_PRICE_EXACTLY_ONE: readonly (readonly string[])[];
+/**
+ * Eine Gutschriftsposition: die Rechnungsposition plus `returnDisposition`
+ * (wohin die zurueckgenommene Ware geht). An einer Rechnungsposition weist der
+ * Server das Feld als unbekannt ab.
+ */
+export declare const CREDIT_NOTE_ITEM_FIELDS: Readonly<Record<string, Field>>;
 /**
  * Eine Zahlung zu einer Rechnung. Ohne `amountCents` gilt der volle
  * Bruttobetrag, ohne `paidAt` der heutige Wiener Tag. `reference` ist die

package/dist/cjs/invoice/vertrag.js

@@ -19,7 +19,9 @@
  * Nummer, Summen — ist bewusst **nicht** setzbar.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.INVOICE_AT_LEAST_ONE = exports.INVOICE_EXACTLY_ONE = exports.INVOICE_REQUESTS = exports.PAYMENT_FIELDS = exports.ITEM_PRICE_EXACTLY_ONE = exports.ITEM_FIELDS = exports.CUSTOMER_FIELDS = exports.INVOICE_SETUP_REQUIREMENTS = exports.INVOICE_UNIT_CODES = exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.INVOICE_PAYMENT_METHODS = exports.INVOICE_LANGUAGES = exports.WRITE_OFF_REASON_CODES = exports.EINVOICE_MISSING_CODES = 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_REQUEST_ERROR_CODES = exports.INVOICE_ERROR_CODES = exports.INVOICE_ENDPOINTS = exports.INVOICE_CONTRACT_VERSION = void 0;
+exports.INVOICE_AT_LEAST_ONE = exports.INVOICE_EXACTLY_ONE = exports.INVOICE_REQUESTS = exports.PAYMENT_FIELDS = exports.CREDIT_NOTE_ITEM_FIELDS = exports.ITEM_PRICE_EXACTLY_ONE = exports.ITEM_FIELDS = exports.CUSTOMER_FIELDS = exports.INVOICE_SETUP_REQUIREMENTS = exports.INVOICE_UNIT_CODES = exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.INVOICE_PAYMENT_METHODS = exports.INVOICE_LANGUAGES = exports.WRITE_OFF_REASON_CODES = exports.EINVOICE_MISSING_CODES = 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_REQUEST_ERROR_CODES = exports.INVOICE_ERROR_CODES = exports.INVOICE_ENDPOINTS = exports.INVOICE_CONTRACT_VERSION = exports.RETURN_DISPOSITIONS = void 0;
+const cancellation_js_1 = require("../models/cancellation.js");
+Object.defineProperty(exports, "RETURN_DISPOSITIONS", { enumerable: true, get: function () { return cancellation_js_1.RETURN_DISPOSITIONS; } });
 exports.INVOICE_CONTRACT_VERSION = 2;
 exports.INVOICE_ENDPOINTS = [
     'createCustomer',
@@ -83,6 +85,7 @@ exports.INVOICE_ERROR_CODES = [
 exports.INVOICE_REQUEST_ERROR_CODES = [
     'account_not_found',
     'admin_required',
+    'api_not_approved',
     'cashregister_not_assigned',
     'cashregister_not_found',
     'cashregister_token_invalid',
@@ -421,6 +424,13 @@ exports.ITEM_FIELDS = Object.freeze({
     unitPriceMicros: { type: 'integer', required: false, min: 0, max: 1_000_000_000_000 },
     vatRate: { type: 'enum', required: true, values: exports.VAT_RATES },
     discountPct: { type: 'number', required: false, min: 0, max: 100, decimals: 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.ITEM_PRICE_EXACTLY_ONE = Object.freeze([
@@ -436,6 +446,23 @@ const positionen = {
         type: 'object', required: true, fields: exports.ITEM_FIELDS, exactlyOne: exports.ITEM_PRICE_EXACTLY_ONE,
     },
 };
+/** Rueckgabe-Wahl einer Gutschrift: Vorgabe des Aufrufs oder je Position. */
+const returnDisposition = { type: 'enum', required: false, values: cancellation_js_1.RETURN_DISPOSITIONS };
+/**
+ * Eine Gutschriftsposition: die Rechnungsposition plus `returnDisposition`
+ * (wohin die zurueckgenommene Ware geht). An einer Rechnungsposition weist der
+ * Server das Feld als unbekannt ab.
+ */
+exports.CREDIT_NOTE_ITEM_FIELDS = Object.freeze({ ...exports.ITEM_FIELDS, returnDisposition });
+const gutschriftPositionen = {
+    type: 'list',
+    required: true,
+    min: 1,
+    max: 500,
+    item: {
+        type: 'object', required: true, fields: exports.CREDIT_NOTE_ITEM_FIELDS, exactlyOne: exports.ITEM_PRICE_EXACTLY_ONE,
+    },
+};
 /**
  * Eine Zahlung zu einer Rechnung. Ohne `amountCents` gilt der volle
  * Bruttobetrag, ohne `paidAt` der heutige Wiener Tag. `reference` ist die
@@ -503,6 +530,12 @@ exports.INVOICE_REQUESTS = Object.freeze({
         language: { type: 'enum', required: false, values: exports.INVOICE_LANGUAGES },
         /** Marke (Kennung aus `listBrands`); sonst die Standardmarke. */
         brandId: id,
+        /**
+         * Lager-Standort, von dem bestandsgefuehrte Positionen abgebucht werden;
+         * sonst der Standard-Standort. Ein unbekannter oder aufgeloester Standort
+         * bucht am Standard-Standort und meldet ein Ereignis im Lager.
+         */
+        stockLocationId: id,
         /**
          * Schon bezahlt: die Zahlung entsteht in **derselben** Transaktion wie das
          * Festschreiben. Sonst gaebe es einen Moment, in dem die Rechnung offen ist
@@ -521,13 +554,17 @@ exports.INVOICE_REQUESTS = Object.freeze({
         invoiceId: idPflicht,
         reason: { type: 'enum', required: true, values: exports.CREDIT_NOTE_REASONS },
         note: text(2000),
+        /** Fuer alle bestandsgefuehrten Positionen; fehlt = `restock`. */
+        returnDisposition,
     },
     createCreditNote: {
         idempotencyKey: idempotencyKey(true),
         invoiceId: idPflicht,
         reason: { type: 'enum', required: true, values: exports.CREDIT_NOTE_REASONS },
         note: text(2000),
-        items: positionen,
+        items: gutschriftPositionen,
+        /** Vorgabe fuer alle Positionen; je Position abweichend ueber `items[].returnDisposition`. */
+        returnDisposition,
     },
     getInvoice: {
         invoiceId: id,

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

@@ -23,6 +23,16 @@ export declare const CANCELLATION_REASONS: Readonly<{
 }>;
 export type CancellationReason = keyof typeof CANCELLATION_REASONS;
 export declare function isCancellationReason(value: unknown): value is CancellationReason;
+/**
+ * Rueckgabe-Wahl beim Storno und bei der Gutschrift (Lager-Kern Stufe 2,
+ * Katalog `RUECKGABE` des Backends): `restock` zurueck ins Lager (Vorgabe des
+ * Servers), `defective` als defekt ins Lager, `disposed` entsorgt. Wirkt nur
+ * an Positionen mit `articleId`; alle anderen bucht der Server nie und meldet
+ * dafuer auch keinen Fehler.
+ */
+export declare const RETURN_DISPOSITIONS: readonly ["restock", "defective", "disposed"];
+export type ReturnDisposition = (typeof RETURN_DISPOSITIONS)[number];
+export declare function isReturnDisposition(value: unknown): value is ReturnDisposition;
 /**
  * Stabile Fehlercodes von `cancelReceipt` unter `/v3` (Vokabular
  * `errorCodes.cancellation`, gleiche Reihenfolge). Das Backend legt sie bei
@@ -43,7 +53,7 @@ export declare function isCancellationReason(value: unknown): value is Cancellat
  * [PAYMENT_ERROR_CODES]. Ein Code ausserhalb bleibt ueber
  * `KasseneckApiError.code` lesbar.
  */
-export declare const CANCELLATION_ERROR_CODES: readonly ["receipt_not_found", "receipt_type_not_cancellable", "training_receipt", "already_cancelled", "invalid_line", "quantity_exceeds_remaining", "unknown_reason", "note_too_long", "invalid_items", "cashregister_not_assigned", "not_permitted", "own_receipts_only", "cashregister_incomplete", "cancellation_failed", "cancellation_payments_required", "cancellation_refund_exceeds_payment", "cancellation_refund_reference_required", "cancellation_refund_reference_unknown", "cancellation_outcome_unknown", "account_not_found", "admin_required", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing", "response_unreadable"];
+export declare const CANCELLATION_ERROR_CODES: readonly ["receipt_not_found", "receipt_type_not_cancellable", "training_receipt", "already_cancelled", "invalid_line", "quantity_exceeds_remaining", "unknown_reason", "note_too_long", "invalid_items", "cashregister_not_assigned", "not_permitted", "own_receipts_only", "cashregister_incomplete", "cancellation_failed", "cancellation_payments_required", "cancellation_refund_exceeds_payment", "cancellation_refund_reference_required", "cancellation_refund_reference_unknown", "cancellation_outcome_unknown", "invalid_return_disposition", "account_not_found", "admin_required", "api_not_approved", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing", "response_unreadable"];
 export type CancellationErrorCode = (typeof CANCELLATION_ERROR_CODES)[number];
 export declare function isCancellationErrorCode(value: unknown): value is CancellationErrorCode;
 /** Der Code eines geworfenen Fehlers, wenn er in [CANCELLATION_ERROR_CODES] steht; sonst `undefined`. */
@@ -67,10 +77,12 @@ export interface CancellationOf {
      */
     timeStamp?: string;
 }
-/** Eine stornierte Position: Index im Original und Menge. */
+/** Eine stornierte Position: Index im Original und Menge, an Artikelzeilen die Rueckgabe-Wahl. */
 export interface CancellationItem {
     index: number;
     quantity: number;
+    /** Wohin die Ware dieser Position geht; fehlt = Vorgabe des Aufrufs bzw. `restock`. */
+    returnDisposition?: ReturnDisposition;
 }
 /**
  * Eintrag in `cancellations[]` am Original. `pending` = Reservierung, die

package/dist/cjs/models/cancellation.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_STATUSES = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_REASONS = void 0;
+exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_STATUSES = exports.CANCELLATION_ERROR_CODES = exports.RETURN_DISPOSITIONS = exports.CANCELLATION_REASONS = void 0;
 exports.isCancellationReason = isCancellationReason;
+exports.isReturnDisposition = isReturnDisposition;
 exports.isCancellationErrorCode = isCancellationErrorCode;
 exports.cancellationErrorCode = cancellationErrorCode;
 exports.isCancellationError = isCancellationError;
@@ -32,6 +33,17 @@ exports.CANCELLATION_REASONS = Object.freeze({
 function isCancellationReason(value) {
     return typeof value === 'string' && Object.prototype.hasOwnProperty.call(exports.CANCELLATION_REASONS, value);
 }
+/**
+ * Rueckgabe-Wahl beim Storno und bei der Gutschrift (Lager-Kern Stufe 2,
+ * Katalog `RUECKGABE` des Backends): `restock` zurueck ins Lager (Vorgabe des
+ * Servers), `defective` als defekt ins Lager, `disposed` entsorgt. Wirkt nur
+ * an Positionen mit `articleId`; alle anderen bucht der Server nie und meldet
+ * dafuer auch keinen Fehler.
+ */
+exports.RETURN_DISPOSITIONS = Object.freeze(['restock', 'defective', 'disposed']);
+function isReturnDisposition(value) {
+    return typeof value === 'string' && exports.RETURN_DISPOSITIONS.includes(value);
+}
 /**
  * Stabile Fehlercodes von `cancelReceipt` unter `/v3` (Vokabular
  * `errorCodes.cancellation`, gleiche Reihenfolge). Das Backend legt sie bei
@@ -72,9 +84,11 @@ exports.CANCELLATION_ERROR_CODES = Object.freeze([
     'cancellation_refund_reference_required', // Karten-Rueckzahlung ohne refundOf einer Kartenzahlung
     'cancellation_refund_reference_unknown', // refundOf nennt keine Zahlung des Originals
     'cancellation_outcome_unknown', // Ausgang unklar: nachlesen, nie wiederholen
+    'invalid_return_disposition', // Rueckgabe-Wahl nicht restock, defective oder disposed (Lager)
     // Anmeldung und Rand (errorCodes.auth ohne Partner-Zugang, errorCodes.edge)
     'account_not_found',
     'admin_required',
+    'api_not_approved',
     'cashregister_not_found',
     'cashregister_token_invalid',
     'cashregister_token_missing',

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

@@ -36,6 +36,8 @@ export interface Cashregister {
     token?: string;
     /** Zugeordnete Signatureinheit. */
     signatureId?: string;
+    /** Lager-Standort der Kasse (Lager-Kern Stufe 2); fehlt = Standard-Standort des Betriebs. */
+    stockLocationId?: string;
     onboarding: CashregisterOnboarding;
 }
 /**
@@ -58,6 +60,7 @@ export interface CashregisterPayload {
     description?: string | null;
     create_time?: string | null;
     signature_id?: string | null;
+    stockLocationId?: string | null;
     token?: string | null;
     onboarding?: CashregisterOnboardingPayload | null;
 }

package/dist/cjs/models/cashregister.js

@@ -16,6 +16,7 @@ function fromCashregisterPayload(payload, id) {
         ...zeitfeld('createTime', payload.create_time),
         ...(payload.token ? { token: payload.token } : {}),
         ...(payload.signature_id ? { signatureId: payload.signature_id } : {}),
+        ...(payload.stockLocationId ? { stockLocationId: payload.stockLocationId } : {}),
         onboarding: {
             cashboxRegistered: ob.cashbox_registered === true,
             startReceiptCreated: ob.start_receipt_created === true,

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

@@ -1,7 +1,7 @@
 export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, isDiscountItem, } from './receipt-item.js';
 export { type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid } from './voucher.js';
 export { type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, readRegistrationInfo, receiptSubSumCents, receiptSumCents, } from './receipt.js';
-export { type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, remainingQuantities, } from './cancellation.js';
+export { type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, type ReturnDisposition, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, remainingQuantities, } from './cancellation.js';
 export { type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, } from './receipt-payment.js';
 export { type PaymentErrorCode, PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors, type PaymentFieldError } from './payment-errors.js';
 export { type ReceiptEmailErrorCode, type ReceiptEmailVia, RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, type ReceiptEmailSendErrorCode, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, type ReceiptEmailFieldError, } from './receipt-email.js';

package/dist/cjs/models/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.remainingQuantities = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.receiptSumCents = exports.receiptSubSumCents = exports.readRegistrationInfo = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isDiscountItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = void 0;
-exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = void 0;
+exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.remainingQuantities = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptSumCents = exports.receiptSubSumCents = exports.readRegistrationInfo = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isDiscountItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = void 0;
+exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isZeroKind = exports.ZERO_KINDS = void 0;
 var receipt_item_js_1 = require("./receipt-item.js");
 Object.defineProperty(exports, "toReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.toReceiptItemPayload; } });
 Object.defineProperty(exports, "fromReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.fromReceiptItemPayload; } });
@@ -21,11 +21,13 @@ Object.defineProperty(exports, "readRegistrationInfo", { enumerable: true, get:
 Object.defineProperty(exports, "receiptSubSumCents", { enumerable: true, get: function () { return receipt_js_1.receiptSubSumCents; } });
 Object.defineProperty(exports, "receiptSumCents", { enumerable: true, get: function () { return receipt_js_1.receiptSumCents; } });
 var cancellation_js_1 = require("./cancellation.js");
+Object.defineProperty(exports, "RETURN_DISPOSITIONS", { enumerable: true, get: function () { return cancellation_js_1.RETURN_DISPOSITIONS; } });
 Object.defineProperty(exports, "CANCELLATION_REASONS", { enumerable: true, get: function () { return cancellation_js_1.CANCELLATION_REASONS; } });
 Object.defineProperty(exports, "CANCELLATION_STATUSES", { enumerable: true, get: function () { return cancellation_js_1.CANCELLATION_STATUSES; } });
 Object.defineProperty(exports, "CANCELLATION_ERROR_CODES", { enumerable: true, get: function () { return cancellation_js_1.CANCELLATION_ERROR_CODES; } });
 Object.defineProperty(exports, "CANCELLATION_RESERVATION_MS", { enumerable: true, get: function () { return cancellation_js_1.CANCELLATION_RESERVATION_MS; } });
 Object.defineProperty(exports, "isCancellationReason", { enumerable: true, get: function () { return cancellation_js_1.isCancellationReason; } });
+Object.defineProperty(exports, "isReturnDisposition", { enumerable: true, get: function () { return cancellation_js_1.isReturnDisposition; } });
 Object.defineProperty(exports, "isCancellationErrorCode", { enumerable: true, get: function () { return cancellation_js_1.isCancellationErrorCode; } });
 Object.defineProperty(exports, "cancellationErrorCode", { enumerable: true, get: function () { return cancellation_js_1.cancellationErrorCode; } });
 Object.defineProperty(exports, "isCancellationError", { enumerable: true, get: function () { return cancellation_js_1.isCancellationError; } });

package/dist/cjs/models/payment-errors.d.ts

@@ -19,7 +19,7 @@ import { KasseneckApiError } from '../client/errors.js';
  * ...) und zuletzt `route_missing` (Code des Pakets). Ein Code ausserhalb
  * bleibt ueber `KasseneckApiError.code` lesbar.
  */
-export declare const PAYMENT_ERROR_CODES: readonly ["payments_invalid", "payment_method_invalid", "payment_amount_invalid", "payment_tendered_invalid", "payment_provider_invalid", "payment_provider_not_allowed", "payments_sum_mismatch", "payments_due_negative", "payments_not_allowed", "payments_conflict", "payments_required", "payment_method_not_supported", "tip_payment_method_invalid", "tip_payment_method_required", "tip_exceeds_payment", "payment_refund_not_allowed", "payment_tip_invalid", "tip_conflict", "account_not_found", "admin_required", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
+export declare const PAYMENT_ERROR_CODES: readonly ["payments_invalid", "payment_method_invalid", "payment_amount_invalid", "payment_tendered_invalid", "payment_provider_invalid", "payment_provider_not_allowed", "payments_sum_mismatch", "payments_due_negative", "payments_not_allowed", "payments_conflict", "payments_required", "payment_method_not_supported", "tip_payment_method_invalid", "tip_payment_method_required", "tip_exceeds_payment", "payment_refund_not_allowed", "payment_tip_invalid", "tip_conflict", "account_not_found", "admin_required", "api_not_approved", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
 export type PaymentErrorCode = (typeof PAYMENT_ERROR_CODES)[number];
 /** Erkennt einen Code aus [PAYMENT_ERROR_CODES], exakt (klein, wie unter `/v3`). */
 export declare function isPaymentErrorCode(value: unknown): value is PaymentErrorCode;

package/dist/cjs/models/payment-errors.js

@@ -48,6 +48,7 @@ exports.PAYMENT_ERROR_CODES = Object.freeze([
     // Anmeldung und Rand (errorCodes.auth ohne Partner-Zugang, errorCodes.edge)
     'account_not_found',
     'admin_required',
+    'api_not_approved',
     'cashregister_not_assigned',
     'cashregister_not_found',
     'cashregister_token_invalid',

package/dist/cjs/models/receipt-email.d.ts

@@ -11,7 +11,7 @@ export type ReceiptEmailSendErrorCode = (typeof RECEIPT_EMAIL_SEND_ERROR_CODES)[
  * als [KasseneckApiError.code] durch; ein Code ausserhalb bleibt dort lesbar.
  * Zuletzt `route_missing` (Code des Pakets).
  */
-export declare const RECEIPT_EMAIL_ERROR_CODES: readonly ["invalid_address", "receipt_not_found", "too_many_requests", "send_failed", "account_not_found", "admin_required", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
+export declare const RECEIPT_EMAIL_ERROR_CODES: readonly ["invalid_address", "receipt_not_found", "too_many_requests", "send_failed", "account_not_found", "admin_required", "api_not_approved", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
 export type ReceiptEmailErrorCode = (typeof RECEIPT_EMAIL_ERROR_CODES)[number];
 export declare function isReceiptEmailErrorCode(value: unknown): value is ReceiptEmailErrorCode;
 /** Der Code eines geworfenen Fehlers, wenn er in [RECEIPT_EMAIL_ERROR_CODES] steht; sonst `undefined`. */

package/dist/cjs/models/receipt-email.js

@@ -27,6 +27,7 @@ exports.RECEIPT_EMAIL_ERROR_CODES = Object.freeze([
     // Anmeldung und Rand (errorCodes.auth ohne Partner-Zugang, errorCodes.edge)
     'account_not_found',
     'admin_required',
+    'api_not_approved',
     'cashregister_not_assigned',
     'cashregister_not_found',
     'cashregister_token_invalid',

package/dist/cjs/models/receipt-errors.d.ts

@@ -16,7 +16,7 @@ import { KasseneckApiError } from '../client/errors.js';
  * ...) stehen in [PAYMENT_ERROR_CODES]. Ein Code ausserhalb bleibt ueber
  * `KasseneckApiError.code` lesbar.
  */
-export declare const RECEIPT_ERROR_CODES: readonly ["cancellation_reference_unavailable", "cashregister_closed", "cashregister_decommissioned", "final_receipt_expired", "final_receipt_not_allowed", "module_inactive", "not_permitted", "receipt_limit_exceeded", "receipt_not_found", "receipt_outcome_unknown", "receipt_type_invalid", "signature_incomplete", "signature_missing", "signing_failed", "small_business_vat_not_allowed", "tip_invalid", "tip_not_allowed", "tip_recipient_unknown", "validation", "account_not_found", "admin_required", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "route_missing", "response_unreadable"];
+export declare const RECEIPT_ERROR_CODES: readonly ["cancellation_reference_unavailable", "cashregister_closed", "cashregister_decommissioned", "final_receipt_expired", "final_receipt_not_allowed", "module_inactive", "not_permitted", "receipt_limit_exceeded", "receipt_not_found", "receipt_outcome_unknown", "receipt_type_invalid", "signature_incomplete", "signature_missing", "signing_failed", "small_business_vat_not_allowed", "tip_invalid", "tip_not_allowed", "tip_recipient_unknown", "validation", "account_not_found", "admin_required", "api_not_approved", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "route_missing", "response_unreadable"];
 export type ReceiptErrorCode = (typeof RECEIPT_ERROR_CODES)[number];
 export declare function isReceiptErrorCode(value: unknown): value is ReceiptErrorCode;
 /** Der Code eines geworfenen Fehlers, wenn er in [RECEIPT_ERROR_CODES] steht; sonst `undefined`. */

package/dist/cjs/models/receipt-errors.js

@@ -46,6 +46,7 @@ exports.RECEIPT_ERROR_CODES = Object.freeze([
     // Anmeldung und Rand (errorCodes.auth ohne Partner-Zugang, errorCodes.edge)
     'account_not_found',
     'admin_required',
+    'api_not_approved',
     'cashregister_not_assigned',
     'cashregister_not_found',
     'cashregister_token_invalid',

package/dist/cjs/models/receipt-item.d.ts

@@ -1,4 +1,5 @@
 import { VatRate } from '../enums/index.js';
+import { type ReturnDisposition } from './cancellation.js';
 /**
  * Belegposition — Zwilling von `KasseneckItem` in
  * kasseneck_api/lib/models/kasseneck_item.dart.
@@ -50,6 +51,10 @@ export interface ReceiptItem {
      * im Bericht. Optional; Handeingaben haben keinen.
      */
     articleId?: string;
+    /** Nur an Storno-Zeilen mit `articleId`: Index der Position im Original. */
+    originalIndex?: number;
+    /** Nur an Storno-Zeilen mit `articleId`: wohin die Ware ging (Lager-Kern Stufe 2). */
+    returnDisposition?: ReturnDisposition;
 }
 /** Empfaenger einer Trinkgeld-Position (Kassen-Benutzer, Snapshot des Namens). */
 export interface TipRecipient {
@@ -117,6 +122,10 @@ export interface ReceiptItemPayloadRead {
     vat?: number | null;
     /** Artikel-Verweis, siehe [ReceiptItem.articleId]. */
     articleId?: string | null;
+    /** Storno-Zeile mit `articleId`: Index im Original, siehe [ReceiptItem.originalIndex]. */
+    originalIndex?: number | null;
+    /** Storno-Zeile mit `articleId`: Rueckgabe-Wahl, siehe [ReceiptItem.returnDisposition]. */
+    returnDisposition?: string | null;
 }
 export declare function toReceiptItemPayload(item: ReceiptItem): ReceiptItemPayload;
 /**

package/dist/cjs/models/receipt-item.js

@@ -9,6 +9,7 @@ exports.receiptItemIsValid = receiptItemIsValid;
 exports.negateReceiptItem = negateReceiptItem;
 const index_js_1 = require("../enums/index.js");
 const enum_payload_js_1 = require("./enum-payload.js");
+const cancellation_js_1 = require("./cancellation.js");
 /** Trinkgeld-Position? Die eine Erkennungsstelle — niemand prueft `kind` selbst. */
 function isTipItem(item) {
     return item != null && item.kind === 'tip';
@@ -89,6 +90,10 @@ function fromReceiptItemPayload(payload) {
                 : {}),
         // Artikel-Verweis erhalten (Storno-Spiegelung schreibt ihn wieder mit).
         ...(typeof payload.articleId === 'string' && payload.articleId !== '' ? { articleId: payload.articleId } : {}),
+        // Lager: Bezug und Rueckgabe-Wahl einer Storno-Zeile (nur gelesen; ein
+        // unbekannter Wert faellt weg wie am Rand des Servers).
+        ...(Number.isInteger(payload.originalIndex) && payload.originalIndex >= 0 ? { originalIndex: payload.originalIndex } : {}),
+        ...((0, cancellation_js_1.isReturnDisposition)(payload.returnDisposition) ? { returnDisposition: payload.returnDisposition } : {}),
     };
 }
 /** Erster brauchbarer Zahlenwert der Reihe; `null`/`undefined`/NaN zaehlen nicht. */

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

@@ -1,7 +1,7 @@
 import { ReceiptType, KeckPaymentMethod, CreditCardProvider } from '../enums/index.js';
 import { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead } from './receipt-item.js';
 import { type Voucher, type VoucherPayload } from './voucher.js';
-import type { Cancellation, CancellationOf, CancellationReason } from './cancellation.js';
+import { type Cancellation, type CancellationOf, type CancellationReason } from './cancellation.js';
 import { type ZeroKind } from './receipt-summary.js';
 import { type ReceiptPayment, type ReceiptPaymentPayload } from './receipt-payment.js';
 /**

package/dist/cjs/models/receipt.js

@@ -9,6 +9,7 @@ const index_js_1 = require("../enums/index.js");
 const enum_payload_js_1 = require("./enum-payload.js");
 const receipt_item_js_1 = require("./receipt-item.js");
 const voucher_js_1 = require("./voucher.js");
+const cancellation_js_1 = require("./cancellation.js");
 const receipt_summary_js_1 = require("./receipt-summary.js");
 const receipt_payment_js_1 = require("./receipt-payment.js");
 /**
@@ -107,7 +108,11 @@ function leseStorno(eintrag) {
         at: Number(eintrag.at ?? 0),
         by: eintrag.by ?? null,
         note: eintrag.note ?? null,
-        items: (eintrag.items ?? []).map((p) => ({ index: Number(p.index), quantity: Number(p.quantity) })),
+        items: (eintrag.items ?? []).map((p) => ({
+            index: Number(p.index),
+            quantity: Number(p.quantity),
+            ...((0, cancellation_js_1.isReturnDisposition)(p.returnDisposition) ? { returnDisposition: p.returnDisposition } : {}),
+        })),
         ...(eintrag.promoAdjustmentCents && typeof eintrag.promoAdjustmentCents === 'object'
             ? { promoAdjustmentCents: Object.fromEntries(Object.entries(eintrag.promoAdjustmentCents).map(([k, v]) => [k, Number(v)])) }
             : {}),

package/dist/cjs/pos/artikel.d.ts

@@ -64,6 +64,14 @@ export interface PosArticle {
     askQuantity: boolean | null;
     /** Hoechstmenge je Beleg (bei kg/l/m auch Kommazahl); null = keine Grenze. */
     maxQuantity: number | null;
+    /**
+     * Standorte, an denen der Artikel gefuehrt wird (Lager-Kern Stufe 2, innen
+     * `standorte`); `null`, wenn der Artikel keine Angabe traegt. Wie die Kasse
+     * daraus Kacheln filtert, entscheidet die Oberflaeche. Optional, damit
+     * bestehende Literale von Verbrauchern weiter uebersetzen; der Leser
+     * (`fromPosArticlePayload`) setzt das Feld immer (`null` oder Liste).
+     */
+    stockLocationIds?: string[] | null;
 }
 /** Deckelt eine gewuenschte Menge an der Hoechstmenge des Artikels (null = keine Grenze). */
 export declare function allowedQuantity(a: Pick<PosArticle, 'maxQuantity'>, wanted: number): number;
@@ -84,7 +92,13 @@ export interface PosArticlePayload {
     quantityRule?: string | null;
     askQuantity?: boolean | null;
     maxQuantity?: number | null;
+    stockLocationIds?: string[] | null;
 }
 export declare function fromPosArticlePayload(p: PosArticlePayload): PosArticle;
+/**
+ * Die Liste `data.<feld>` einer Antwort, jedes Element durch `lesen` (mit
+ * seinem Index fuer Fehlermeldungen). Paketintern: auch `lager.ts` liest so.
+ */
+export declare function liste<T>(daten: unknown, feld: string, name: string, lesen: (e: unknown, index: number) => T): T[];
 export declare function listMyArticleGroups(transport: InternerTransport): Promise<ArticleGroup[]>;
 export declare function listMyArticles(transport: InternerTransport): Promise<PosArticle[]>;

package/dist/cjs/pos/artikel.js

@@ -6,6 +6,7 @@ exports.quantityRuleForUnit = quantityRuleForUnit;
 exports.quantityDefaults = quantityDefaults;
 exports.allowedQuantity = allowedQuantity;
 exports.fromPosArticlePayload = fromPosArticlePayload;
+exports.liste = liste;
 exports.listMyArticleGroups = listMyArticleGroups;
 exports.listMyArticles = listMyArticles;
 const errors_js_1 = require("../client/errors.js");
@@ -70,14 +71,24 @@ function fromPosArticlePayload(p) {
         quantityRule: p.quantityRule === 'piece' || p.quantityRule === 'decimal' ? p.quantityRule : null,
         askQuantity: typeof p.askQuantity === 'boolean' ? p.askQuantity : null,
         maxQuantity: typeof p.maxQuantity === 'number' && Number.isFinite(p.maxQuantity) && p.maxQuantity > 0 ? p.maxQuantity : null,
+        stockLocationIds: Array.isArray(p.stockLocationIds)
+            ? p.stockLocationIds.filter((s) => typeof s === 'string' && s !== '')
+            : null,
     };
 }
+/**
+ * Die Liste `data.<feld>` einer Antwort, jedes Element durch `lesen` (mit
+ * seinem Index fuer Fehlermeldungen). Paketintern: auch `lager.ts` liest so.
+ */
 function liste(daten, feld, name, lesen) {
     const roh = daten?.[feld];
     if (!Array.isArray(roh)) {
-        throw new errors_js_1.KasseneckValidationError(name, `Antwort enthaelt keine Liste (data.${feld} fehlt)`, 'response');
+        const grund = roh === undefined || roh === null
+            ? `Antwort enthaelt keine Liste (data.${feld} fehlt)`
+            : `Antwort ist unbrauchbar (data.${feld} ist keine Liste)`;
+        throw new errors_js_1.KasseneckValidationError(name, grund, 'response');
     }
-    return roh.map((e) => lesen(typeof e === 'object' && e !== null ? e : {}));
+    return roh.map((e, i) => lesen(typeof e === 'object' && e !== null ? e : {}, i));
 }
 async function listMyArticleGroups(transport) {
     const daten = await transport('listMyArticleGroups');