@kreiseck/kasseneck-api 1.17.1 → 1.18.0

package/CHANGELOG.md

@@ -4,6 +4,30 @@ 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.
 
+## 1.18.0 - 2026-10-30
+
+Recording handwritten receipts (Nacherfassung). After a register outage or a sale outside the premises the business
+writes paper receipts and records them in the register later; the receipt now carries the reference. Additive.
+
+- **`manualReceipt` on `createReceipt`/`sellReceipt` and on `Receipt`, `ReceiptSummary` and the `listReceipts` summary:**
+  `number` (the paper pad's own number range, never the next register number), optional `numberTo` and `count` (daily
+  summary receipt, only after an outage), `date` (`YYYY-MM-DD`, Vienna day), optional `time` (`HH:MM`), `reason`
+  (`MANUAL_RECEIPT_REASONS`: `network_outage`, `power_outage`, `device_failure`, `system_outage`, `other` with `note`,
+  `outside_premises`). Only on `standard`; the package throws before sending otherwise. The server checks everything
+  else. The receipt's own `timeStamp` stays the time of recording (no backdating). `readManualReceipt` reads the field.
+- **Error codes `MANUAL_RECEIPT_ERROR_CODES`** (contract `errorCodes.manualReceipt`): `invalid_manual_receipt`,
+  `manual_receipt_not_allowed`, `manual_receipt_date_in_future`, `manual_receipt_range_not_allowed`,
+  `manual_receipt_duplicate` (same number or overlapping range on the same day and register; `details.receiptId`
+  names the receipt that already recorded it), with `isManualReceiptErrorCode`.
+- **Receipt block „NACHERFASSUNG“** below the business header: kind (after a register outage / sale outside the
+  premises), reason, number and day of the paper receipt or range and count of the daily summary, and
+  „USt: Duplikat …“ (BMF cash register decree, 3.3 and 2.4.11; not for small businesses). 23 new golden receipts `manual-receipt-*`.
+- **Zero receipt after a signature outage** (`zeroKind: outage_end`) prints start and end of the outage from
+  `legalMessage` before the QR code; the decree (3.6.1) requires them on the receipt. New golden `zero-outage-end-period`,
+  all existing goldens unchanged.
+- Contract re-fetched from the backend (vendored package 0.36.0): new cases `sale_manual_receipt` and
+  `error_manual_receipt_duplicate`, catalog `HANDBELEG_GRUND`; print digests of the two new server layouts recorded.
+
 ## 1.17.1 - 2026-10-29
 
 - **Contract `v3` gains `fixtures/v3/antworten/berichte.json`** (backend keck#798): `getCashregisterReport` as a binary path, generated from the real handler. A case with `file` is the PDF (HTTP 200, `Content-Type: application/pdf`, the bytes start with `file.startsWith`); every rejection also comes with HTTP 200, as an envelope with a code (`period_not_closed` for the current month and today, `period_in_future`, `invalid_period`). New test `test/v3-berichte-vertrag.test.ts` replays the file through `createBinaryTransport`: the PDF arrives byte for byte, each rejection is a `KasseneckApiError` with the code of the contract and outcome `rejected`. No behaviour change: the binary path always decided on the first bytes. Reason: the Dart twin returned such an envelope as PDF bytes up to 11.8.0 (fixed in 11.8.1); with the case in the contract both packages and the backend are pinned to the same answer, and the Dart twin replays this file too.

package/dist/cjs/client/list-receipts.d.ts

@@ -1,6 +1,7 @@
 import { KeckPaymentMethod, ReceiptType } from '../enums/index.js';
 import { type CancellationReason, type CancellationStatus, type Receipt, type ReceiptPayment, type ZeroKind } from '../models/index.js';
 import type { ReportV2Metadata } from './reports.js';
+import { type ManualReceipt } from '../models/manual-receipt.js';
 import type { InternerTransport } from './aufrufe.js';
 /**
  * Belege einer Kasse auflisten (`listReceipts`, nur unter `/v3`): ein Tag oder
@@ -143,6 +144,8 @@ export interface ListReceiptsSummary {
     customProjectId: string | null;
     /** Schluessel fuer `downloadReceipt` und den Beleg-Link, oder `null`. */
     fullReceiptId: string | null;
+    /** Nur an nacherfassten Belegen: der Handbeleg. */
+    manualReceipt?: ManualReceipt;
 }
 /** Ein Beleg der Liste je Ansicht: `full` das Belegdokument wie bei `getReportV2`, sonst die Zeile. */
 export type ListedReceipt<V extends ListReceiptsView = 'summary'> = V extends 'full' ? Receipt : ListReceiptsSummary;

package/dist/cjs/client/list-receipts.js

@@ -7,6 +7,7 @@ exports.listAllReceipts = listAllReceipts;
 const index_js_1 = require("../enums/index.js");
 const index_js_2 = require("../models/index.js");
 const enum_payload_js_1 = require("../models/enum-payload.js");
+const manual_receipt_js_1 = require("../models/manual-receipt.js");
 const errors_js_1 = require("./errors.js");
 /**
  * Belege einer Kasse auflisten (`listReceipts`, nur unter `/v3`): ein Tag oder
@@ -163,6 +164,10 @@ const istObjekt = (w) => w != null && typeof w === 'object' && !Array.isArray(w)
 const text = (w) => (typeof w === 'string' ? w : null);
 // Ganze Cent; ein einzelner unbrauchbarer Betrag laesst die Liste nicht scheitern.
 const cent = (w) => (typeof w === 'number' && Number.isInteger(w) ? w : 0);
+function handbelegFeld(roh) {
+    const manualReceipt = (0, manual_receipt_js_1.readManualReceipt)(roh);
+    return manualReceipt ? { manualReceipt } : {};
+}
 function istStornoStand(w) {
     return typeof w === 'string' && index_js_2.CANCELLATION_STATUSES.includes(w);
 }
@@ -197,6 +202,7 @@ function fromListReceiptsSummaryPayload(payload) {
         signatureOk: payload['signatureOk'] !== false,
         customProjectId: text(payload['customProjectId']),
         fullReceiptId: text(payload['fullReceiptId']),
+        ...handbelegFeld(payload['manualReceipt']),
     };
 }
 function tagessumme(roh) {

package/dist/cjs/client/receipts.d.ts

@@ -1,4 +1,5 @@
 import { ReceiptType, type ReceiptTypeKey, KeckPaymentMethod, type KeckPaymentMethodKey } from '../enums/index.js';
+import type { ManualReceipt } from '../models/manual-receipt.js';
 import { type Receipt, type ReceiptCompany, type ReceiptItem, type Voucher, type ReceiptSummary, type ReportMonth, type CancellationItem, type CancellationOf, type CancellationReason, type TipRefundSource, type ReturnDisposition, type ReceiptPaymentInput, type RegistrationInfo, type ReceiptEmailVia } from '../models/index.js';
 import { type ReceiptOutput, type ReceiptOutputEntryErrorCode, type ReceiptOutputLogKind, type ReceiptOutputResult } from '../models/receipt-output.js';
 import type { InternerTransport } from './aufrufe.js';
@@ -43,6 +44,11 @@ export interface ReceiptCommonOptions {
     legalMessage?: string[];
     /** Freier Bezeichner des Aufrufers (Projekt, Auftrag, Schicht). */
     customProjectId?: string;
+    /**
+     * Nacherfassung eines Handbelegs (siehe [ManualReceipt]); nur bei
+     * `standard`. Geprueft wird am Server, die Eingabe geht unveraendert hinaus.
+     */
+    manualReceipt?: ManualReceipt;
     /**
      * Trinkgeld in Cent — als Zahl (an den angemeldeten Kassen-Benutzer, Zahlart
      * des Belegs) oder als [TipOptions]. Das Backend bucht daraus signierte

package/dist/cjs/client/receipts.js

@@ -194,6 +194,12 @@ function createReceiptParams(options) {
     if (options.customProjectId != null) {
         params['customProjectId'] = options.customProjectId;
     }
+    if (options.manualReceipt != null) {
+        if (typ !== index_js_1.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/cjs/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/cjs/models/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 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.asksRefundTip = exports.asksTipRefundSource = exports.cancellationCashRefundCents = exports.cancellationItemsForTip = exports.openStaffTipCents = exports.isTipRefundSource = exports.TIP_REFUND_SOURCES = 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.receiptValueVoucherSign = exports.receiptSumCents = exports.receiptSubSumCents = exports.readRegistrationInfo = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherServerFields = exports.isNewFormVoucher = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isVoucherFloatItem = exports.isVoucherItem = 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 = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.receiptOutputFieldErrors = exports.isReceiptOutputError = exports.receiptOutputErrorCode = exports.isReceiptOutputErrorCode = exports.RECEIPT_OUTPUT_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRY_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRIES_MAX = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_LOG_KINDS = exports.RECEIPT_OUTPUT_KINDS = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = 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.isManualReceiptErrorCode = exports.MANUAL_RECEIPT_ERROR_CODES = exports.readManualReceipt = exports.MANUAL_RECEIPT_REASONS = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.receiptOutputFieldErrors = exports.isReceiptOutputError = exports.receiptOutputErrorCode = exports.isReceiptOutputErrorCode = exports.RECEIPT_OUTPUT_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRY_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRIES_MAX = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_LOG_KINDS = exports.RECEIPT_OUTPUT_KINDS = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = 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; } });
@@ -88,6 +88,11 @@ var receipt_summary_js_1 = require("./receipt-summary.js");
 Object.defineProperty(exports, "fromReceiptSummaryPayload", { enumerable: true, get: function () { return receipt_summary_js_1.fromReceiptSummaryPayload; } });
 Object.defineProperty(exports, "ZERO_KINDS", { enumerable: true, get: function () { return receipt_summary_js_1.ZERO_KINDS; } });
 Object.defineProperty(exports, "isZeroKind", { enumerable: true, get: function () { return receipt_summary_js_1.isZeroKind; } });
+var manual_receipt_js_1 = require("./manual-receipt.js");
+Object.defineProperty(exports, "MANUAL_RECEIPT_REASONS", { enumerable: true, get: function () { return manual_receipt_js_1.MANUAL_RECEIPT_REASONS; } });
+Object.defineProperty(exports, "readManualReceipt", { enumerable: true, get: function () { return manual_receipt_js_1.readManualReceipt; } });
+Object.defineProperty(exports, "MANUAL_RECEIPT_ERROR_CODES", { enumerable: true, get: function () { return manual_receipt_js_1.MANUAL_RECEIPT_ERROR_CODES; } });
+Object.defineProperty(exports, "isManualReceiptErrorCode", { enumerable: true, get: function () { return manual_receipt_js_1.isManualReceiptErrorCode; } });
 var report_month_js_1 = require("./report-month.js");
 Object.defineProperty(exports, "reportMonthFromDate", { enumerable: true, get: function () { return report_month_js_1.reportMonthFromDate; } });
 Object.defineProperty(exports, "previousReportMonth", { enumerable: true, get: function () { return report_month_js_1.previousReportMonth; } });

package/dist/cjs/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/cjs/models/manual-receipt.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MANUAL_RECEIPT_ERROR_CODES = exports.MANUAL_RECEIPT_REASONS = void 0;
+exports.readManualReceipt = readManualReceipt;
+exports.isManualReceiptErrorCode = isManualReceiptErrorCode;
+/** Gruende einer Nacherfassung: fuenf Ausfall-Gruende und die Leistung ausser Haus. */
+exports.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.
+ */
+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.
+ */
+exports.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',
+]);
+function isManualReceiptErrorCode(value) {
+    return typeof value === 'string' && exports.MANUAL_RECEIPT_ERROR_CODES.includes(value);
+}

package/dist/cjs/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/cjs/models/receipt-summary.js

@@ -8,6 +8,7 @@ const money_js_1 = require("../money.js");
 const enum_payload_js_1 = require("./enum-payload.js");
 const cancellation_js_1 = require("./cancellation.js");
 const receipt_payment_js_1 = require("./receipt-payment.js");
+const manual_receipt_js_1 = require("./manual-receipt.js");
 /**
  * Belegzeile einer Liste — die Form, die `listMyReceipts` liefert
  * (`projectReceiptForCustomer` in functions/index.js).
@@ -58,8 +59,13 @@ function fromReceiptSummaryPayload(payload) {
             : { cancellationStatus: isCancellationStatus(payload.cancellationStatus) ? payload.cancellationStatus : 'unknown' }),
         ...(isZeroKind(payload.zeroKind) ? { zeroKind: payload.zeroKind } : {}),
         ...(Array.isArray(payload.payments) ? { payments: payload.payments.map(receipt_payment_js_1.fromReceiptPaymentPayload) } : {}),
+        ...handbelegFeld(payload.manualReceipt),
     };
 }
+function handbelegFeld(roh) {
+    const manualReceipt = (0, manual_receipt_js_1.readManualReceipt)(roh);
+    return manualReceipt ? { manualReceipt } : {};
+}
 function isCancellationStatus(wert) {
     return typeof wert === 'string' && cancellation_js_1.CANCELLATION_STATUSES.includes(wert);
 }

package/dist/cjs/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/cjs/models/receipt.js

@@ -8,6 +8,7 @@ exports.receiptSubSumCents = receiptSubSumCents;
 exports.receiptSumCents = receiptSumCents;
 const index_js_1 = require("../enums/index.js");
 const enum_payload_js_1 = require("./enum-payload.js");
+const manual_receipt_js_1 = require("./manual-receipt.js");
 const receipt_item_js_1 = require("./receipt-item.js");
 const voucher_js_1 = require("./voucher.js");
 const cancellation_js_1 = require("./cancellation.js");
@@ -95,8 +96,13 @@ function fromReceiptPayload(payload) {
         ...(payload.registrationInfo != null && typeof payload.registrationInfo === 'object'
             ? { registrationInfo: readRegistrationInfo(payload.registrationInfo) }
             : {}),
+        ...handbelegFeld(payload.manualReceipt),
     };
 }
+function handbelegFeld(roh) {
+    const manualReceipt = (0, manual_receipt_js_1.readManualReceipt)(roh);
+    return manualReceipt ? { manualReceipt } : {};
+}
 /** Registrierdaten lesen; ein fehlender oder leerer Zeitstempel wird `null`. */
 function readRegistrationInfo(roh) {
     const zeit = (v) => (typeof v === 'string' && v !== '' ? v : null);

package/dist/cjs/receipt/layout.js

@@ -936,6 +936,49 @@ function stornoGrundText(code) {
 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.
@@ -1023,6 +1066,12 @@ 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) {
@@ -1038,6 +1087,14 @@ 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/cjs/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/cjs/stored/vokabular.js

@@ -4,7 +4,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KATALOGE = exports.ARTIKEL_FELDER = exports.SCHEMAS = exports.VOKABULAR_QUELLE = void 0;
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-exports.VOKABULAR_QUELLE = "3088cb472f3fef3ed4ff969bf0d37d051363714096616a9263270c58266bde14";
+exports.VOKABULAR_QUELLE = "c14617ec83a2eac2bdffc6794cc2c7f72ae04504259a55313f01fe83747fa565";
 /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
 exports.SCHEMAS = {
     "getReceipt": {
@@ -24,7 +24,17 @@ exports.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",
@@ -80,6 +90,9 @@ exports.SCHEMAS = {
             "receipt.cancellationReason": {
                 "$catalog": "STORNO_GRUND"
             },
+            "receipt.manualReceipt.reason": {
+                "$catalog": "HANDBELEG_GRUND"
+            },
             "layout.lines[].tone": {
                 "$catalog": "LAYOUT_TON"
             },
@@ -570,6 +583,14 @@ exports.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/cjs/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.1";
+export declare const PACKAGE_VERSION = "1.18.0";

package/dist/cjs/version.js

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

package/dist/esm/client/list-receipts.d.ts

@@ -1,6 +1,7 @@
 import { KeckPaymentMethod, ReceiptType } from '../enums/index.js';
 import { type CancellationReason, type CancellationStatus, type Receipt, type ReceiptPayment, type ZeroKind } from '../models/index.js';
 import type { ReportV2Metadata } from './reports.js';
+import { type ManualReceipt } from '../models/manual-receipt.js';
 import type { InternerTransport } from './aufrufe.js';
 /**
  * Belege einer Kasse auflisten (`listReceipts`, nur unter `/v3`): ein Tag oder
@@ -143,6 +144,8 @@ export interface ListReceiptsSummary {
     customProjectId: string | null;
     /** Schluessel fuer `downloadReceipt` und den Beleg-Link, oder `null`. */
     fullReceiptId: string | null;
+    /** Nur an nacherfassten Belegen: der Handbeleg. */
+    manualReceipt?: ManualReceipt;
 }
 /** Ein Beleg der Liste je Ansicht: `full` das Belegdokument wie bei `getReportV2`, sonst die Zeile. */
 export type ListedReceipt<V extends ListReceiptsView = 'summary'> = V extends 'full' ? Receipt : ListReceiptsSummary;

package/dist/esm/client/list-receipts.js

@@ -1,6 +1,7 @@
 import { KeckPaymentMethod, ReceiptType } from '../enums/index.js';
 import { CANCELLATION_STATUSES, fromReceiptCompanyPayload, fromReceiptPayload, fromReceiptPaymentPayload, } from '../models/index.js';
 import { readEnumKey } from '../models/enum-payload.js';
+import { readManualReceipt } from '../models/manual-receipt.js';
 import { KasseneckValidationError } from './errors.js';
 /**
  * Belege einer Kasse auflisten (`listReceipts`, nur unter `/v3`): ein Tag oder
@@ -157,6 +158,10 @@ const istObjekt = (w) => w != null && typeof w === 'object' && !Array.isArray(w)
 const text = (w) => (typeof w === 'string' ? w : null);
 // Ganze Cent; ein einzelner unbrauchbarer Betrag laesst die Liste nicht scheitern.
 const cent = (w) => (typeof w === 'number' && Number.isInteger(w) ? w : 0);
+function handbelegFeld(roh) {
+    const manualReceipt = readManualReceipt(roh);
+    return manualReceipt ? { manualReceipt } : {};
+}
 function istStornoStand(w) {
     return typeof w === 'string' && CANCELLATION_STATUSES.includes(w);
 }
@@ -191,6 +196,7 @@ export function fromListReceiptsSummaryPayload(payload) {
         signatureOk: payload['signatureOk'] !== false,
         customProjectId: text(payload['customProjectId']),
         fullReceiptId: text(payload['fullReceiptId']),
+        ...handbelegFeld(payload['manualReceipt']),
     };
 }
 function tagessumme(roh) {

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

@@ -1,4 +1,5 @@
 import { ReceiptType, type ReceiptTypeKey, KeckPaymentMethod, type KeckPaymentMethodKey } from '../enums/index.js';
+import type { ManualReceipt } from '../models/manual-receipt.js';
 import { type Receipt, type ReceiptCompany, type ReceiptItem, type Voucher, type ReceiptSummary, type ReportMonth, type CancellationItem, type CancellationOf, type CancellationReason, type TipRefundSource, type ReturnDisposition, type ReceiptPaymentInput, type RegistrationInfo, type ReceiptEmailVia } from '../models/index.js';
 import { type ReceiptOutput, type ReceiptOutputEntryErrorCode, type ReceiptOutputLogKind, type ReceiptOutputResult } from '../models/receipt-output.js';
 import type { InternerTransport } from './aufrufe.js';
@@ -43,6 +44,11 @@ export interface ReceiptCommonOptions {
     legalMessage?: string[];
     /** Freier Bezeichner des Aufrufers (Projekt, Auftrag, Schicht). */
     customProjectId?: string;
+    /**
+     * Nacherfassung eines Handbelegs (siehe [ManualReceipt]); nur bei
+     * `standard`. Geprueft wird am Server, die Eingabe geht unveraendert hinaus.
+     */
+    manualReceipt?: ManualReceipt;
     /**
      * Trinkgeld in Cent — als Zahl (an den angemeldeten Kassen-Benutzer, Zahlart
      * des Belegs) oder als [TipOptions]. Das Backend bucht daraus signierte

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/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';