@kreiseck/kasseneck-api 1.17.0 → 1.18.0

package/dist/esm/client/receipts.js

@@ -173,6 +173,12 @@ export function createReceiptParams(options) {
     if (options.customProjectId != null) {
         params['customProjectId'] = options.customProjectId;
     }
+    if (options.manualReceipt != null) {
+        if (typ !== ReceiptType.standard) {
+            throw eingabefehler(`manualReceipt ist nur bei receiptType standard moeglich, nicht bei "${typ.value}".`);
+        }
+        params['manualReceipt'] = options.manualReceipt;
+    }
     if (options.customerDetails != null) {
         params['customerDetails'] = options.customerDetails.join('\n');
     }

package/dist/esm/client/reports.d.ts

@@ -1,16 +1,17 @@
 import { type Receipt, type ReceiptCompany, type ReportMonth } from '../models/index.js';
 import type { InternerBinaerTransport, InternerTransport } from './aufrufe.js';
 /**
- * Bericht-Downloads — Zwilling von `downloadDailyReport`/`downloadMonthlyReport`
- * in kasseneck_api/lib/kasseneck_api.dart (Zeilen 113-128).
+ * Bericht-Downloads — Zwilling von `getCashregisterReport`,
+ * `downloadDailyReport` und `downloadMonthlyReport` in
+ * kasseneck_api/lib/kasseneck_api.dart.
  *
- * **Beide liefern ein PDF, also Binaerdaten.** Das Flutter-Vorbild liest die
- * Antwort als Zeichenkette und nimmt davon `codeUnits`; in JavaScript waere das
- * schlicht falsch — `response.text()` deutet die Bytes als UTF-8 und ersetzt
- * jedes Byte ueber 0x7F durch U+FFFD. Ein so "heruntergeladener" Tagesbericht
- * liesse sich in keinem Betrachter oeffnen. Dieses Paket weicht daher bewusst
- * ab: es liest `arrayBuffer()` und liefert `Uint8Array` (siehe
- * [createBinaryTransport] in transport.ts).
+ * **Alle drei liefern ein PDF, also Binaerdaten.** `response.text()` waere hier
+ * falsch: es deutet die Bytes als UTF-8 und ersetzt jedes Byte ueber 0x7F
+ * durch U+FFFD, ein so "heruntergeladener" Bericht liesse sich in keinem
+ * Betrachter oeffnen. Gelesen wird `arrayBuffer()`, geliefert `Uint8Array`;
+ * eine Ablehnung mit HTTP 200 und Huelle (`period_not_closed`) wird zum Fehler
+ * (siehe [createBinaryTransport] in transport.ts). Der Dart-Zwilling reichte
+ * sie bis 11.8.0 als PDF durch und prueft seit 11.8.1 ebenso die ersten Bytes.
  *
  * **Kassen-Benutzer-Weg (`registerUserAuth`, Browser-Kasse):** Keiner der
  * beiden Download-Endpunkte setzt `allowRegisterUser`; sie funktionieren nur

package/dist/esm/client/reports.js

@@ -2,16 +2,17 @@ import { fromReceiptCompanyPayload, fromReceiptPayload, } from '../models/index.
 import { toViennaWallClock } from '../vienna-time.js';
 import { KasseneckValidationError } from './errors.js';
 /**
- * Bericht-Downloads — Zwilling von `downloadDailyReport`/`downloadMonthlyReport`
- * in kasseneck_api/lib/kasseneck_api.dart (Zeilen 113-128).
+ * Bericht-Downloads — Zwilling von `getCashregisterReport`,
+ * `downloadDailyReport` und `downloadMonthlyReport` in
+ * kasseneck_api/lib/kasseneck_api.dart.
  *
- * **Beide liefern ein PDF, also Binaerdaten.** Das Flutter-Vorbild liest die
- * Antwort als Zeichenkette und nimmt davon `codeUnits`; in JavaScript waere das
- * schlicht falsch — `response.text()` deutet die Bytes als UTF-8 und ersetzt
- * jedes Byte ueber 0x7F durch U+FFFD. Ein so "heruntergeladener" Tagesbericht
- * liesse sich in keinem Betrachter oeffnen. Dieses Paket weicht daher bewusst
- * ab: es liest `arrayBuffer()` und liefert `Uint8Array` (siehe
- * [createBinaryTransport] in transport.ts).
+ * **Alle drei liefern ein PDF, also Binaerdaten.** `response.text()` waere hier
+ * falsch: es deutet die Bytes als UTF-8 und ersetzt jedes Byte ueber 0x7F
+ * durch U+FFFD, ein so "heruntergeladener" Bericht liesse sich in keinem
+ * Betrachter oeffnen. Gelesen wird `arrayBuffer()`, geliefert `Uint8Array`;
+ * eine Ablehnung mit HTTP 200 und Huelle (`period_not_closed`) wird zum Fehler
+ * (siehe [createBinaryTransport] in transport.ts). Der Dart-Zwilling reichte
+ * sie bis 11.8.0 als PDF durch und prueft seit 11.8.1 ebenso die ersten Bytes.
  *
  * **Kassen-Benutzer-Weg (`registerUserAuth`, Browser-Kasse):** Keiner der
  * beiden Download-Endpunkte setzt `allowRegisterUser`; sie funktionieren nur

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

@@ -10,6 +10,7 @@ export { RECEIPT_OUTPUT_KINDS, type ReceiptOutputKind, RECEIPT_OUTPUT_LOG_KINDS,
 export { type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, } from './receipt-company.js';
 export { type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, type CashregisterAutoLogout, type CashregisterAutoLogoutPayload, fromCashregisterPayload, } from './cashregister.js';
 export { type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, isZeroKind } from './receipt-summary.js';
+export { type ManualReceipt, type ManualReceiptReason, MANUAL_RECEIPT_REASONS, readManualReceipt, type ManualReceiptErrorCode, MANUAL_RECEIPT_ERROR_CODES, isManualReceiptErrorCode, } from './manual-receipt.js';
 export { type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, } from './report-month.js';
 export { type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, } from './stripe-url-session.js';
 export { type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './hobex-receipt.js';

package/dist/esm/models/index.js

@@ -10,6 +10,7 @@ export { RECEIPT_OUTPUT_KINDS, RECEIPT_OUTPUT_LOG_KINDS, RECEIPT_OUTPUT_RESULTS,
 export { fromReceiptCompanyPayload, receiptCompanyTaxInfo, } from './receipt-company.js';
 export { fromCashregisterPayload, } from './cashregister.js';
 export { fromReceiptSummaryPayload, ZERO_KINDS, isZeroKind } from './receipt-summary.js';
+export { MANUAL_RECEIPT_REASONS, readManualReceipt, MANUAL_RECEIPT_ERROR_CODES, isManualReceiptErrorCode, } from './manual-receipt.js';
 export { reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, } from './report-month.js';
 export { toStripeUrlSessionPayload, fromStripeUrlSessionPayload, } from './stripe-url-session.js';
 export { toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './hobex-receipt.js';

package/dist/esm/models/manual-receipt.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Nacherfassung eines Handbelegs (`manualReceipt` am Beleg, Backend
+ * `handbeleg`): Nach einem Ausfall der Kasse oder einer Leistung ausser Haus
+ * wird der handschriftliche Beleg (Paragon) in der Kasse nacherfasst. Der
+ * Beleg traegt dann Nummer, Datum und Grund des Handbelegs; sein eigener
+ * Zeitstempel bleibt der Zeitpunkt der Nacherfassung (kein Rueckdatieren).
+ *
+ * Rechtsgrundlage: § 17 Abs 5 RKSV, Registrierkassenerlass Abschnitt 3.6.1
+ * (Ausfall, Tagessammelbeleg erlaubt) und 6.7 (ausser Haus, jeder Beleg
+ * einzeln; nicht fuer Taxi und Mietwagen, § 7 Abs 2 BarUV).
+ * Geprueft wird am Server; dieses Paket liest nur und reicht die Eingabe weiter.
+ */
+/** Gruende einer Nacherfassung: fuenf Ausfall-Gruende und die Leistung ausser Haus. */
+export declare const MANUAL_RECEIPT_REASONS: readonly ["network_outage", "power_outage", "device_failure", "system_outage", "other", "outside_premises"];
+export type ManualReceiptReason = (typeof MANUAL_RECEIPT_REASONS)[number];
+export interface ManualReceipt {
+    /** Nummer des Handbelegs (eigene Nummernreihe des Paragons, nie die Kassennummer). */
+    number: string;
+    /** Letzte Nummer: macht den Beleg zum Tagessammelbeleg (nur nach einem Ausfall). */
+    numberTo?: string;
+    /** Zahl der Handbelege im Tagessammelbeleg. */
+    count?: number;
+    /** Tag des Handbelegs, `YYYY-MM-DD` (Wiener Tag). */
+    date: string;
+    /** Uhrzeit des Handbelegs, `HH:MM`. */
+    time?: string;
+    /** Grund; ein Wert, den dieses Paket nicht kennt, bleibt als roher Text lesbar. */
+    reason: ManualReceiptReason | string;
+    /** Eigener Text, nur beim Grund `other`. */
+    note?: string;
+}
+/**
+ * Liest `manualReceipt` vom Draht. Ohne Nummer, Datum oder Grund gibt es
+ * keinen Handbeleg (`undefined`); ein einzelnes Zusatzfeld in falscher Form
+ * faellt weg, statt den Beleg scheitern zu lassen.
+ */
+export declare function readManualReceipt(roh: unknown): ManualReceipt | undefined;
+/**
+ * Fehlercodes von `createReceipt` zur Nacherfassung (Vertrag `errorCodes.manualReceipt`).
+ * `manual_receipt_duplicate` traegt in `details.receiptId` den Beleg, der den Handbeleg
+ * schon nacherfasst hat: nicht erneut senden, sondern diesen Beleg nehmen.
+ */
+export declare const MANUAL_RECEIPT_ERROR_CODES: readonly ["invalid_manual_receipt", "manual_receipt_not_allowed", "manual_receipt_date_in_future", "manual_receipt_range_not_allowed", "manual_receipt_duplicate"];
+export type ManualReceiptErrorCode = (typeof MANUAL_RECEIPT_ERROR_CODES)[number];
+export declare function isManualReceiptErrorCode(value: unknown): value is ManualReceiptErrorCode;

package/dist/esm/models/manual-receipt.js

@@ -0,0 +1,53 @@
+/**
+ * Nacherfassung eines Handbelegs (`manualReceipt` am Beleg, Backend
+ * `handbeleg`): Nach einem Ausfall der Kasse oder einer Leistung ausser Haus
+ * wird der handschriftliche Beleg (Paragon) in der Kasse nacherfasst. Der
+ * Beleg traegt dann Nummer, Datum und Grund des Handbelegs; sein eigener
+ * Zeitstempel bleibt der Zeitpunkt der Nacherfassung (kein Rueckdatieren).
+ *
+ * Rechtsgrundlage: § 17 Abs 5 RKSV, Registrierkassenerlass Abschnitt 3.6.1
+ * (Ausfall, Tagessammelbeleg erlaubt) und 6.7 (ausser Haus, jeder Beleg
+ * einzeln; nicht fuer Taxi und Mietwagen, § 7 Abs 2 BarUV).
+ * Geprueft wird am Server; dieses Paket liest nur und reicht die Eingabe weiter.
+ */
+/** Gruende einer Nacherfassung: fuenf Ausfall-Gruende und die Leistung ausser Haus. */
+export const MANUAL_RECEIPT_REASONS = [
+    'network_outage', 'power_outage', 'device_failure', 'system_outage', 'other', 'outside_premises',
+];
+const istText = (w) => typeof w === 'string' && w !== '';
+/**
+ * Liest `manualReceipt` vom Draht. Ohne Nummer, Datum oder Grund gibt es
+ * keinen Handbeleg (`undefined`); ein einzelnes Zusatzfeld in falscher Form
+ * faellt weg, statt den Beleg scheitern zu lassen.
+ */
+export function readManualReceipt(roh) {
+    if (roh === null || typeof roh !== 'object' || Array.isArray(roh))
+        return undefined;
+    const o = roh;
+    if (!istText(o['number']) || !istText(o['date']) || !istText(o['reason']))
+        return undefined;
+    return {
+        number: o['number'],
+        ...(istText(o['numberTo']) ? { numberTo: o['numberTo'] } : {}),
+        ...(typeof o['count'] === 'number' && Number.isInteger(o['count']) ? { count: o['count'] } : {}),
+        date: o['date'],
+        ...(istText(o['time']) ? { time: o['time'] } : {}),
+        reason: o['reason'],
+        ...(istText(o['note']) ? { note: o['note'] } : {}),
+    };
+}
+/**
+ * Fehlercodes von `createReceipt` zur Nacherfassung (Vertrag `errorCodes.manualReceipt`).
+ * `manual_receipt_duplicate` traegt in `details.receiptId` den Beleg, der den Handbeleg
+ * schon nacherfasst hat: nicht erneut senden, sondern diesen Beleg nehmen.
+ */
+export const MANUAL_RECEIPT_ERROR_CODES = Object.freeze([
+    'invalid_manual_receipt',
+    'manual_receipt_not_allowed',
+    'manual_receipt_date_in_future',
+    'manual_receipt_range_not_allowed',
+    'manual_receipt_duplicate',
+]);
+export function isManualReceiptErrorCode(value) {
+    return typeof value === 'string' && MANUAL_RECEIPT_ERROR_CODES.includes(value);
+}

package/dist/esm/models/receipt-summary.d.ts

@@ -1,6 +1,7 @@
 import { KeckPaymentMethod, ReceiptType } from '../enums/index.js';
 import { type CancellationStatus } from './cancellation.js';
 import { type ReceiptPayment, type ReceiptPaymentPayload } from './receipt-payment.js';
+import { type ManualReceipt } from './manual-receipt.js';
 /**
  * Belegzeile einer Liste — die Form, die `listMyReceipts` liefert
  * (`projectReceiptForCustomer` in functions/index.js).
@@ -77,6 +78,8 @@ export interface ReceiptSummary {
      * (`providerPaymentId`, `providerData`) bleiben im Backend.
      */
     payments?: ReceiptPayment[];
+    /** Nur an nacherfassten Belegen: der Handbeleg. */
+    manualReceipt?: ManualReceipt;
 }
 export interface ReceiptSummaryPayload {
     receiptId?: string | null;
@@ -105,5 +108,6 @@ export interface ReceiptSummaryPayload {
     cancellationStatus?: string | null;
     zeroKind?: string | null;
     payments?: ReceiptPaymentPayload[] | null;
+    manualReceipt?: unknown;
 }
 export declare function fromReceiptSummaryPayload(payload: ReceiptSummaryPayload): ReceiptSummary;

package/dist/esm/models/receipt-summary.js

@@ -3,6 +3,7 @@ import { euroToCents } from '../money.js';
 import { readEnumKey } from './enum-payload.js';
 import { CANCELLATION_STATUSES } from './cancellation.js';
 import { fromReceiptPaymentPayload } from './receipt-payment.js';
+import { readManualReceipt } from './manual-receipt.js';
 /**
  * Belegzeile einer Liste — die Form, die `listMyReceipts` liefert
  * (`projectReceiptForCustomer` in functions/index.js).
@@ -53,8 +54,13 @@ export function fromReceiptSummaryPayload(payload) {
             : { cancellationStatus: isCancellationStatus(payload.cancellationStatus) ? payload.cancellationStatus : 'unknown' }),
         ...(isZeroKind(payload.zeroKind) ? { zeroKind: payload.zeroKind } : {}),
         ...(Array.isArray(payload.payments) ? { payments: payload.payments.map(fromReceiptPaymentPayload) } : {}),
+        ...handbelegFeld(payload.manualReceipt),
     };
 }
+function handbelegFeld(roh) {
+    const manualReceipt = readManualReceipt(roh);
+    return manualReceipt ? { manualReceipt } : {};
+}
 function isCancellationStatus(wert) {
     return typeof wert === 'string' && CANCELLATION_STATUSES.includes(wert);
 }

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

@@ -1,4 +1,5 @@
 import { ReceiptType, KeckPaymentMethod, CreditCardProvider } from '../enums/index.js';
+import { type ManualReceipt } from './manual-receipt.js';
 import { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead } from './receipt-item.js';
 import { type Voucher, type VoucherPayload } from './voucher.js';
 import { type Cancellation, type CancellationOf, type CancellationReason } from './cancellation.js';
@@ -74,6 +75,8 @@ export interface Receipt {
     layoutRuleset?: number;
     /** Nur an Nullbelegen: Registrierdaten fuer den Block „Prüfangaben“. */
     registrationInfo?: RegistrationInfo;
+    /** Nur an nacherfassten Belegen: der Handbeleg (siehe [ManualReceipt]). */
+    manualReceipt?: ManualReceipt;
 }
 /** Registrierdaten von Signaturkarte und Kasse (Zeitstempel oder `null`, wenn unbekannt). */
 export interface RegistrationInfo {
@@ -125,6 +128,7 @@ export interface ReceiptPayloadRead extends Omit<ReceiptPayload, 'items' | 'vouc
         cardRegisteredAt?: string | null;
         cashregisterRegisteredAt?: string | null;
     } | null;
+    manualReceipt?: unknown;
 }
 /**
  * Schreibt die Nutzlast in der **neuen** Form — sie **normalisiert, statt zu

package/dist/esm/models/receipt.js

@@ -1,5 +1,6 @@
 import { ReceiptType, KeckPaymentMethod, CreditCardProvider, VoucherAction, VoucherType } from '../enums/index.js';
 import { readEnumKey, requireEnumKey } from './enum-payload.js';
+import { readManualReceipt } from './manual-receipt.js';
 import { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, } from './receipt-item.js';
 import { toVoucherPayload, fromVoucherPayload } from './voucher.js';
 import { isReturnDisposition } from './cancellation.js';
@@ -87,8 +88,13 @@ export function fromReceiptPayload(payload) {
         ...(payload.registrationInfo != null && typeof payload.registrationInfo === 'object'
             ? { registrationInfo: readRegistrationInfo(payload.registrationInfo) }
             : {}),
+        ...handbelegFeld(payload.manualReceipt),
     };
 }
+function handbelegFeld(roh) {
+    const manualReceipt = readManualReceipt(roh);
+    return manualReceipt ? { manualReceipt } : {};
+}
 /** Registrierdaten lesen; ein fehlender oder leerer Zeitstempel wird `null`. */
 export function readRegistrationInfo(roh) {
     const zeit = (v) => (typeof v === 'string' && v !== '' ? v : null);

package/dist/esm/receipt/layout.js

@@ -924,6 +924,49 @@ function stornoGrundText(code) {
 export function receiptIsSmallBusinessConsistent(receipt) {
     return receipt.items.every((it) => Number(steuersatz(it.vat).rate) === 0);
 }
+/** Grund-Zeile nach einem Ausfall der Kasse; `other` druckt den eigenen Text. */
+const NACHERFASSUNG_GRUND = {
+    network_outage: 'Internet', power_outage: 'Strom', device_failure: 'Gerät defekt', system_outage: 'Störung',
+};
+/** `YYYY-MM-DD` als `TT.MM.JJJJ`; anderes bleibt, wie es kam. */
+function handbelegDatum(tag) {
+    const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(tag);
+    return m ? `${m[3]}.${m[2]}.${m[1]}` : tag;
+}
+/**
+ * Block „NACHERFASSUNG“ (manualReceipt) unter dem Kopf: Art, Grund, Nummer
+ * und Tag des Handbelegs bzw. der Handbelege eines Tagessammelbelegs, dazu
+ * der Hinweis, dass der Beleg fuer die USt ein Duplikat ist
+ * (Registrierkassenerlass 3.3 Faelle 5 und 6, 2.4.11). Der Zeitstempel des Belegs bleibt der der
+ * Nacherfassung und steht wie immer unter „Datum:“. Kleinunternehmer
+ * (keine USt am Beleg) bekommen den USt-Hinweis nicht.
+ */
+function nacherfassungBlock(receipt, company) {
+    const m = receipt.manualReceipt;
+    if (!m)
+        return [];
+    const aus = [bannerZeile('NACHERFASSUNG')];
+    aus.push(textZeile(m.reason === 'outside_premises' ? 'Leistung außer Haus' : 'nach Ausfall der Kasse', 'center'));
+    const grund = m.reason === 'other' ? m.note : NACHERFASSUNG_GRUND[m.reason];
+    if (grund)
+        aus.push(textZeile(`Grund: ${grund}`, 'center'));
+    aus.push({ kind: 'space', lines: 1 });
+    const tag = handbelegDatum(m.date);
+    if (m.numberTo) {
+        aus.push(textZeile('Tagessammelbeleg', 'center'));
+        aus.push(textZeile(`Handbelege Nr. ${m.number} bis ${m.numberTo}`, 'center'));
+        aus.push(textZeile(`${m.count ? `${m.count} Belege ` : ''}vom ${tag}`, 'center'));
+        if (!company.isSmallBusiness)
+            aus.push(textZeile('USt: Duplikat der Handbelege', 'center'));
+    }
+    else {
+        aus.push(textZeile(`Handbeleg Nr. ${m.number}`, 'center'));
+        aus.push(textZeile(`vom ${tag}${m.time ? `, ${m.time} Uhr` : ''}`, 'center'));
+        if (!company.isSmallBusiness)
+            aus.push(textZeile('USt: Duplikat des Handbelegs', 'center'));
+    }
+    return aus;
+}
 /**
  * Belegart-Block unter dem Betriebskopf: Titel als Banner, Untertitel als
  * zentrierte Textzeilen. Verkaufsbelege bekommen keinen Block.
@@ -1011,6 +1054,12 @@ export function buildReceiptLayout(receipt, company, options = {}) {
         lines.push({ kind: 'space', lines: 1 });
         lines.push(...belegart);
     }
+    // --- Nacherfassung eines Handbelegs unter dem Kopf, vor den Pflichtangaben
+    const nacherfassung = nullbeleg ? [] : nacherfassungBlock(receipt, company);
+    if (nacherfassung.length > 0) {
+        lines.push({ kind: 'space', lines: 1 });
+        lines.push(...nacherfassung);
+    }
     // --- Nullbeleg: reduziert (§ 132a Abs. 3 BAO / RKSV § 11 Abs. 1 -- Pflichtangaben
     //     ja, Positionen/MwSt-Tabelle/Zahlungsart/Fusszeilen nein).
     if (nullbeleg) {
@@ -1026,6 +1075,14 @@ export function buildReceiptLayout(receipt, company, options = {}) {
             lines.push(...pruefangabenBlock(receipt, options.registrationInfo ?? null));
         }
         lines.push({ kind: 'space', lines: 1 });
+        // Sammelbeleg nach Signaturausfall: Beginn und Ende des Ausfalls muessen aus
+        // dem Beleg hervorgehen (Registrierkassenerlass 3.6.1); der Server legt sie als
+        // legalMessage ab. Andere Nullbelege nennen ihren Anlass schon im Titel.
+        if (receipt.zeroKind === 'outage_end' && receipt.legalMessage.length > 0) {
+            for (const zeile of receipt.legalMessage)
+                lines.push(textZeile(zeile, 'center'));
+            lines.push({ kind: 'space', lines: 1 });
+        }
         if (receiptSignatureFailed(receipt)) {
             lines.push(textZeile(SIGNATUR_AUSGEFALLEN, 'center'));
             lines.push({ kind: 'space', lines: 1 });

package/dist/esm/stored/vokabular.d.ts

@@ -1,5 +1,5 @@
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-export declare const VOKABULAR_QUELLE = "3088cb472f3fef3ed4ff969bf0d37d051363714096616a9263270c58266bde14";
+export declare const VOKABULAR_QUELLE = "c14617ec83a2eac2bdffc6794cc2c7f72ae04504259a55313f01fe83747fa565";
 /** Schema-Notation des Vertrags: Blatt 'aussen': 'innen', Objekt { __: 'innen', ... }, Liste [ { __: 'innen', ... } ]. */
 export type SchemaEintrag = string | SchemaObjekt | readonly [SchemaObjekt];
 export interface SchemaObjekt {

package/dist/esm/stored/vokabular.js

@@ -1,7 +1,7 @@
 // Erzeugt von scripts/stored-vokabular.mjs aus fixtures/v3/v3-vokabular.json.
 // Nicht von Hand aendern: test/stored.test.ts vergleicht mit dem Vertrag.
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-export const VOKABULAR_QUELLE = "3088cb472f3fef3ed4ff969bf0d37d051363714096616a9263270c58266bde14";
+export const VOKABULAR_QUELLE = "c14617ec83a2eac2bdffc6794cc2c7f72ae04504259a55313f01fe83747fa565";
 /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
 export const SCHEMAS = {
     "getReceipt": {
@@ -21,7 +21,17 @@ export const SCHEMAS = {
                         "receivedImmediately": "sofortErhalten",
                         "keptByEmployee": "direkt"
                     }
-                ]
+                ],
+                "manualReceipt": {
+                    "__": "handbeleg",
+                    "number": "nummer",
+                    "numberTo": "nummerBis",
+                    "count": "anzahl",
+                    "date": "datum",
+                    "time": "uhrzeit",
+                    "reason": "grund",
+                    "note": "grundText"
+                }
             },
             "taxNumber": "taxnr",
             "vatId": "uid",
@@ -77,6 +87,9 @@ export const SCHEMAS = {
             "receipt.cancellationReason": {
                 "$catalog": "STORNO_GRUND"
             },
+            "receipt.manualReceipt.reason": {
+                "$catalog": "HANDBELEG_GRUND"
+            },
             "layout.lines[].tone": {
                 "$catalog": "LAYOUT_TON"
             },
@@ -567,6 +580,14 @@ export const KATALOGE = {
         "unbefristet": "unlimited",
         "jahre": "years"
     },
+    "HANDBELEG_GRUND": {
+        "internet": "network_outage",
+        "strom": "power_outage",
+        "geraet": "device_failure",
+        "stoerung": "system_outage",
+        "sonstiges": "other",
+        "ausser_haus": "outside_premises"
+    },
     "KASSE_BETRIEB_WERTE.cardProvider": {
         "keiner": "none",
         "extern": "external",

package/dist/esm/version.d.ts

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export declare const PACKAGE_VERSION = "1.17.0";
+export declare const PACKAGE_VERSION = "1.18.0";

package/dist/esm/version.js

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export const PACKAGE_VERSION = '1.17.0';
+export const PACKAGE_VERSION = '1.18.0';

package/fixtures/expected/manual-receipt-range-device-failure-count.grid32.txt

@@ -0,0 +1,36 @@
+      Blumen G'schenk e.U.      
+          Hauptplatz 1          
+         4830 Hallstatt         
+          ATU12345675           
+         +43 6134 12345         
+                                
+================================
+         NACHERFASSUNG          
+================================
+     nach Ausfall der Kasse     
+      Grund: Gerät defekt       
+                                
+        Tagessammelbeleg        
+ Handbelege Nr. B-380 bis B-411 
+    32 Belege vom 21.11.2026    
+  USt: Duplikat der Handbelege  
+                                
+Datum:       22.11.2026 08:30:55
+Kassen-ID:                KASSE1
+Beleg-ID:         AT0-KASSE1-117
+                                
+1  x Umsatz 13 %        318,70 C
+lt. Handbelegen                 
+1  x Umsatz 20 %         46,00 A
+lt. Handbelegen                 
+                                
+MwSt%   MwSt      Netto   Brutto
+C 13%   36,66     282,04  318,70
+A 20%   7,67      38,33    46,00
+--------------------------------
+Gesamt:                 364,70 €
+Zahlungsart:          Barzahlung
+                                
+           [QR-Code]            
+                                
+     Danke und schöne Tage      

package/fixtures/expected/manual-receipt-range-device-failure-count.grid48.txt

@@ -0,0 +1,36 @@
+              Blumen G'schenk e.U.              
+                  Hauptplatz 1                  
+                 4830 Hallstatt                 
+                  ATU12345675                   
+                 +43 6134 12345                 
+                                                
+================================================
+                 NACHERFASSUNG                  
+================================================
+             nach Ausfall der Kasse             
+              Grund: Gerät defekt               
+                                                
+                Tagessammelbeleg                
+         Handbelege Nr. B-380 bis B-411         
+            32 Belege vom 21.11.2026            
+          USt: Duplikat der Handbelege          
+                                                
+Datum:                       22.11.2026 08:30:55
+Kassen-ID:                                KASSE1
+Beleg-ID:                         AT0-KASSE1-117
+                                                
+1  x Umsatz 13 % lt.                    318,70 C
+Handbelegen                                     
+1  x Umsatz 20 % lt.                     46,00 A
+Handbelegen                                     
+                                                
+MwSt%       MwSt            Netto         Brutto
+C 13%       36,66           282,04        318,70
+A 20%       7,67            38,33          46,00
+------------------------------------------------
+Gesamt:                                 364,70 €
+Zahlungsart:                          Barzahlung
+                                                
+                   [QR-Code]                    
+                                                
+             Danke und schöne Tage