@kreiseck/kasseneck-api 1.18.0 → 1.20.0

package/dist/cjs/client/dep-export.js

@@ -0,0 +1,336 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DepExportChecksumError = exports.DepExportTimeoutError = exports.DEP_EXPORT_DOWNLOAD_TIMEOUT_MS = exports.DEP_EXPORT_WAIT_TIMEOUT_MS = exports.DEP_EXPORT_POLL_MAX_MS = exports.DEP_EXPORT_POLL_FACTOR = exports.DEP_EXPORT_POLL_START_MS = exports.DEP_EXPORT_FAILURES = exports.DEP_EXPORT_ERROR_CODES = exports.DEP_EXPORT_FILES = exports.DEP_EXPORT_STATUSES = void 0;
+exports.createDepExport = createDepExport;
+exports.getDepExport = getDepExport;
+exports.waitForDepExport = waitForDepExport;
+exports.getDepExportFile = getDepExportFile;
+exports.createDepHandoverLink = createDepHandoverLink;
+exports.revokeDepHandoverLink = revokeDepHandoverLink;
+const errors_js_1 = require("./errors.js");
+/**
+ * DEP-Export fuer die Kassennachschau (nur unter `/v3`): ein Export des
+ * Datenerfassungsprotokolls fuer einen vom Pruefungsorgan vorgegebenen
+ * Zeitraum (§ 19 Abs. 2 RKSV), Dateien zum Abholen und ein Pruefer-Link mit
+ * Code, ueber den das Pruefungsorgan die Dateien ohne Anmeldung laedt.
+ *
+ * **Anmeldung wie `listReceipts`:** API-Schluessel plus `cashregister-token`;
+ * die Kasse kommt aus dem Token, nie aus einem Parameter. Ein Export einer
+ * anderen Kasse ist `export_not_found`.
+ *
+ * **Ablauf:** `createDepExport` stellt den Export ein und antwortet sofort
+ * (`status: 'running'`; eine Wiederholung mit derselben `requestId` nennt den
+ * aktuellen Stand); er laeuft im Hintergrund. `waitForDepExport` fragt bis zum
+ * Ende, `getDepExportFile` holt eine Datei, `createDepHandoverLink` erzeugt den
+ * Link fuer das Pruefungsorgan.
+ */
+/** Zustand eines Exports: in Arbeit, fertig oder fehlgeschlagen. */
+exports.DEP_EXPORT_STATUSES = Object.freeze(['running', 'done', 'failed']);
+/** Die Dateien eines Exports: DEP-JSON, Protokoll (PDF), Positionen (CSV) und alles zusammen als ZIP. */
+exports.DEP_EXPORT_FILES = Object.freeze(['dep', 'protocol', 'items', 'zip']);
+/**
+ * Fehlercodes der fuenf Aufrufe (`code` des [KasseneckApiError]) wie im
+ * Vertrag des Backends (`errorCodes.depExport` in `fixtures/v3/v3-vokabular.json`,
+ * Katalog `dep_nachschau`), in dessen Reihenfolge; dazu kommen die gemeinsamen
+ * Codes von Anmeldung und Rand. Ein Code ausserhalb bleibt ueber
+ * `KasseneckApiError.code` lesbar.
+ */
+exports.DEP_EXPORT_ERROR_CODES = Object.freeze([
+    'validation', // ungueltige requestId (Details in den Feldfehlern)
+    'invalid_period', // from/to kein Datum JJJJ-MM-TT, from in der Zukunft oder to vor from
+    'idempotency_conflict', // dieselbe requestId gehoert zu einem Export mit anderem Zeitraum
+    'export_running', // fuer diese Kasse laeuft schon ein Export (`details.exportId` nennt ihn)
+    'too_many_exports', // Tagesgrenze der Exporte erreicht
+    'export_not_found', // unbekannt oder einer anderen Kasse
+    'export_not_ready', // Datei oder Link nur zu einem fertigen Export
+    'export_failed', // der Export ist fehlgeschlagen
+    'invalid_file', // keine der Dateien dep, protocol, items, zip
+    'file_not_available', // diese Datei gibt es zu diesem Export nicht (etwa Positionen bei einem alten Export)
+    'too_many_links', // Grenze der aktiven Links je Export oder der neuen Links je Tag erreicht
+    'link_not_found', // unbekannt oder einer anderen Kasse (ein schon widerrufener Link ist kein Fehler: der Widerruf ist wiederholbar)
+    'server_error',
+]);
+/**
+ * Warum ein Export fehlgeschlagen ist (`DepExport.error`): die Werte des
+ * Katalogs `DEP_EXPORT_FEHLER` im Vertrag. `export_stalled` = nach 35 Minuten
+ * nicht fertig.
+ */
+exports.DEP_EXPORT_FAILURES = Object.freeze(['export_failed', 'export_stalled']);
+/** Wartezeiten von [waitForDepExport]: 2 s, dann je x1,5, hoechstens 15 s. */
+exports.DEP_EXPORT_POLL_START_MS = 2_000;
+exports.DEP_EXPORT_POLL_FACTOR = 1.5;
+exports.DEP_EXPORT_POLL_MAX_MS = 15_000;
+/** Vorgabe fuer `waitForDepExport.timeoutMs`. */
+exports.DEP_EXPORT_WAIT_TIMEOUT_MS = 600_000;
+/** Vorgabe fuer `getDepExportFile.downloadTimeoutMs`: der Aufruf selbst und das Laden ueber einen Lese-Link. */
+exports.DEP_EXPORT_DOWNLOAD_TIMEOUT_MS = 600_000;
+/**
+ * [waitForDepExport] gab auf, weil der Export nach `timeoutMs` weder fertig
+ * noch fehlgeschlagen war. Der Export laeuft serverseitig weiter: mit
+ * `getDepExport` (oder erneutem Warten) nachsehen, nicht neu anstossen.
+ */
+class DepExportTimeoutError extends Error {
+    name = 'DepExportTimeoutError';
+    exportId;
+    timeoutMs;
+    /** Zustand bei der letzten Abfrage. */
+    lastStatus;
+    constructor(exportId, timeoutMs, lastStatus) {
+        super(`waitForDepExport: Export ${exportId} nach ${timeoutMs} ms nicht fertig (Zustand ${lastStatus})`);
+        this.exportId = exportId;
+        this.timeoutMs = timeoutMs;
+        this.lastStatus = lastStatus;
+    }
+}
+exports.DepExportTimeoutError = DepExportTimeoutError;
+/** Das Ergebnis stimmt nicht mit der Pruefsumme ueberein: die Datei ist nicht zu verwenden. */
+class DepExportChecksumError extends errors_js_1.KasseneckValidationError {
+    expected;
+    actual;
+    constructor(exportId, file, expected, actual) {
+        super('getDepExportFile', `Pruefsumme der Datei ${file} von ${exportId} stimmt nicht (erwartet ${expected}, berechnet ${actual})`, 'response');
+        this.expected = expected;
+        this.actual = actual;
+    }
+}
+exports.DepExportChecksumError = DepExportChecksumError;
+// ---- Hilfen -------------------------------------------------------------------------------------
+const TAG = /^\d{4}-\d{2}-\d{2}$/;
+const ANFRAGE_ID = /^[A-Za-z0-9_-]{1,64}$/;
+const SHA256 = /^[0-9a-f]{64}$/i;
+const VORGABEN = {
+    dep: { fileName: (id) => `${id}.json`, contentType: 'application/json' },
+    protocol: { fileName: (id) => `${id}.pdf`, contentType: 'application/pdf' },
+    items: { fileName: (id) => `${id}_positionen.csv`, contentType: 'text/csv; charset=utf-8' },
+    zip: { fileName: (id) => `${id}.zip`, contentType: 'application/zip' },
+};
+function eingabefehler(name, grund) {
+    return new errors_js_1.KasseneckValidationError(name, grund, 'request');
+}
+function antwortfehler(name, grund) {
+    return new errors_js_1.KasseneckValidationError(name, grund, 'response');
+}
+const istObjekt = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+function pruefeKennung(name, feld, wert) {
+    if (typeof wert !== 'string' || wert.trim() === '')
+        throw eingabefehler(name, `${feld} fehlt oder ist leer`);
+    return wert;
+}
+/** Ist das ein echter Kalendertag `JJJJ-MM-TT`? (Rechnung ohne Zeitzone.) */
+function istKalendertag(text) {
+    if (!TAG.test(text))
+        return false;
+    const [j, m, t] = text.split('-').map(Number);
+    const d = new Date(Date.UTC(j, m - 1, t));
+    return d.getUTCFullYear() === j && d.getUTCMonth() === m - 1 && d.getUTCDate() === t;
+}
+async function sha256Hex(bytes) {
+    const umgebung = globalThis;
+    const subtle = umgebung.crypto?.subtle;
+    if (!subtle)
+        throw new Error('getDepExportFile: kein globales crypto.subtle vorhanden — Node >= 20.18 verwenden');
+    const digest = new Uint8Array(await subtle.digest('SHA-256', bytes));
+    return Array.from(digest, (b) => b.toString(16).padStart(2, '0')).join('');
+}
+function exportAus(daten, name) {
+    if (!istObjekt(daten))
+        throw antwortfehler(name, 'Antwort enthaelt keine Daten (data fehlt)');
+    const status = daten['status'];
+    if (typeof daten['exportId'] !== 'string' || !exports.DEP_EXPORT_STATUSES.includes(status)) {
+        throw antwortfehler(name, 'Antwort ohne exportId oder mit unbekanntem Zustand');
+    }
+    if (!Array.isArray(daten['handoverLinks']))
+        throw antwortfehler(name, 'Antwort ohne handoverLinks');
+    return daten;
+}
+// ---- Aufrufe ------------------------------------------------------------------------------------
+/**
+ * Stellt einen DEP-Export ein (`createDepExport`) und antwortet sofort mit
+ * `status: 'running'`. Hoechstens ein laufender Export je Kasse
+ * (`export_running`, `details.exportId` nennt ihn). Mit `requestId` ist der
+ * Aufruf wiederholbar: dieselbe Kennung mit demselben Zeitraum liefert den
+ * bestehenden Export mit seinem aktuellen Stand (auch `done` oder `failed`),
+ * mit anderem Zeitraum `idempotency_conflict`.
+ */
+async function createDepExport(transport, options = {}) {
+    const name = 'createDepExport';
+    const params = {};
+    for (const feld of ['from', 'to']) {
+        const wert = options[feld];
+        if (wert === undefined)
+            continue;
+        if (typeof wert !== 'string' || !istKalendertag(wert))
+            throw eingabefehler(name, `${feld} muss ein Datum JJJJ-MM-TT sein`);
+        params[feld] = wert;
+    }
+    if (options.from !== undefined && options.to !== undefined && options.to < options.from) {
+        throw eingabefehler(name, 'to liegt vor from');
+    }
+    if (options.requestId !== undefined) {
+        if (typeof options.requestId !== 'string' || !ANFRAGE_ID.test(options.requestId)) {
+            throw eingabefehler(name, 'requestId: hoechstens 64 Zeichen aus A-Z, a-z, 0-9, _ und -');
+        }
+        params['requestId'] = options.requestId;
+    }
+    const daten = await transport(name, params);
+    if (!istObjekt(daten) || typeof daten['exportId'] !== 'string' || !exports.DEP_EXPORT_STATUSES.includes(daten['status'])) {
+        throw antwortfehler(name, 'Antwort ohne exportId oder mit unbekanntem Zustand');
+    }
+    return daten;
+}
+/** Zustand, Kennzahlen, Befund und Links eines Exports (`getDepExport`). */
+async function getDepExport(transport, options) {
+    const name = 'getDepExport';
+    const exportId = pruefeKennung(name, 'exportId', options?.exportId);
+    return exportAus(await transport(name, { exportId }), name);
+}
+/**
+ * Wartet, bis der Export fertig ist, und gibt ihn zurueck. Fragt mit
+ * [DEP_EXPORT_POLL_START_MS] Abstand, dann je x[DEP_EXPORT_POLL_FACTOR],
+ * hoechstens [DEP_EXPORT_POLL_MAX_MS]. Bei `failed` wirft er einen
+ * [KasseneckApiError] mit `code` `export_failed` oder `export_stalled`
+ * (haengender Export); nach `timeoutMs` einen [DepExportTimeoutError]. Ein
+ * Fehler beim Abfragen selbst bricht ab.
+ */
+async function waitForDepExport(transport, options) {
+    const name = 'waitForDepExport';
+    const exportId = pruefeKennung(name, 'exportId', options?.exportId);
+    const timeoutMs = options.timeoutMs ?? exports.DEP_EXPORT_WAIT_TIMEOUT_MS;
+    if (!(typeof timeoutMs === 'number' && Number.isFinite(timeoutMs) && timeoutMs > 0)) {
+        throw eingabefehler(name, 'timeoutMs muss eine positive Zahl sein');
+    }
+    const ende = Date.now() + timeoutMs;
+    let abstand = exports.DEP_EXPORT_POLL_START_MS;
+    for (;;) {
+        const stand = await getDepExport(transport, { exportId });
+        if (stand.status === 'done')
+            return stand;
+        if (stand.status === 'failed') {
+            throw new errors_js_1.KasseneckApiError('getDepExport', stand.error === 'export_stalled' ? 'Der Export haengt (Stillstand).' : 'Der Export ist fehlgeschlagen.', { exportId, error: stand.error ?? 'export_failed' }, stand.error ?? 'export_failed');
+        }
+        const rest = ende - Date.now();
+        if (rest <= 0)
+            throw new DepExportTimeoutError(exportId, timeoutMs, stand.status);
+        await new Promise((weiter) => setTimeout(weiter, Math.min(abstand, rest)));
+        abstand = Math.min(abstand * exports.DEP_EXPORT_POLL_FACTOR, exports.DEP_EXPORT_POLL_MAX_MS);
+    }
+}
+function linkAus(name, wert) {
+    if (!istObjekt(wert))
+        throw antwortfehler(name, 'Antwort ist weder eine Datei noch ein Lese-Link (data.download fehlt)');
+    const { url, expiresAt, size, sha256, fileName, contentType } = wert;
+    if (typeof url !== 'string' || typeof expiresAt !== 'string' || typeof fileName !== 'string' || typeof contentType !== 'string' ||
+        typeof sha256 !== 'string' || !SHA256.test(sha256) || typeof size !== 'number' || !Number.isSafeInteger(size) || size < 0) {
+        throw antwortfehler(name, 'Lese-Link unvollstaendig (url, expiresAt, size, sha256, fileName, contentType)');
+    }
+    let adresse;
+    try {
+        adresse = new URL(url);
+    }
+    catch {
+        throw antwortfehler(name, 'Lese-Link ist keine Adresse');
+    }
+    const lokal = adresse.hostname === 'localhost' || adresse.hostname === '127.0.0.1' || adresse.hostname === '[::1]';
+    if (adresse.protocol !== 'https:' && !(adresse.protocol === 'http:' && lokal)) {
+        throw antwortfehler(name, 'Lese-Link ist keine https-Adresse');
+    }
+    return { url, expiresAt, size, sha256: sha256.toLowerCase(), fileName, contentType };
+}
+/** Laedt die Bytes hinter einem Lese-Link. Fehlertexte und Fehlerobjekte nennen die Adresse nie (sie traegt die Berechtigung). */
+async function ladeLink(fetchFn, url, timeoutMs) {
+    const name = 'getDepExportFile';
+    const abbruch = new AbortController();
+    let abgelaufen = false;
+    const wecker = setTimeout(() => {
+        abgelaufen = true;
+        abbruch.abort();
+    }, timeoutMs);
+    try {
+        // Ein GET ohne Rumpf und ohne eigene Kopfzeilen; FetchLike verlangt formal einen Rumpf, den ein GET nicht tragen darf.
+        const antwort = await fetchFn(url, { method: 'GET', headers: {}, signal: abbruch.signal });
+        if (antwort.status !== 200) {
+            throw new errors_js_1.KasseneckHttpError(name, antwort.status, antwort.headers.get('content-type') ?? undefined, 'server-error', 'rejected');
+        }
+        return new Uint8Array(await antwort.arrayBuffer());
+    }
+    catch (ursache) {
+        if (ursache instanceof errors_js_1.KasseneckHttpError)
+            throw ursache;
+        throw new errors_js_1.KasseneckNetworkError(name, abgelaufen, timeoutMs, {}, 'rejected');
+    }
+    finally {
+        clearTimeout(wecker);
+    }
+}
+/**
+ * Holt eine Datei eines fertigen Exports (`getDepExportFile`). Der Server
+ * liefert sie bis 9 MiB selbst, darueber als signierten Lese-Link (15 Minuten);
+ * dem Link folgt dieser Aufruf und laedt die Bytes. In beiden Faellen ist das
+ * Ergebnis dasselbe. Geprueft wird die SHA-256-Summe: beim Lese-Link immer
+ * gegen die Summe des Servers, sonst und zusaetzlich gegen `options.sha256`,
+ * wenn sie bekannt ist. Eine Abweichung wirft [DepExportChecksumError].
+ */
+async function getDepExportFile(transport, fetchFn, options) {
+    const name = 'getDepExportFile';
+    const exportId = pruefeKennung(name, 'exportId', options?.exportId);
+    if (!exports.DEP_EXPORT_FILES.includes(options.file)) {
+        throw eingabefehler(name, 'file muss dep, protocol, items oder zip sein');
+    }
+    if (options.sha256 !== undefined && !(typeof options.sha256 === 'string' && SHA256.test(options.sha256))) {
+        throw eingabefehler(name, 'sha256 muss 64 Hexzeichen haben');
+    }
+    const frist = options.downloadTimeoutMs ?? exports.DEP_EXPORT_DOWNLOAD_TIMEOUT_MS;
+    if (!(typeof frist === 'number' && Number.isFinite(frist) && frist > 0)) {
+        throw eingabefehler(name, 'downloadTimeoutMs muss eine positive Zahl sein');
+    }
+    const bekannt = options.sha256?.toLowerCase();
+    const vorgabe = VORGABEN[options.file];
+    // Eine direkte Datei (bis 9 MiB) kommt im Aufruf selbst: dieselbe Frist wie das Laden ueber den Link, nicht die 30 s
+    // des Transports.
+    const ergebnis = await transport(name, { exportId, file: options.file }, { timeoutMs: frist });
+    let bytes;
+    let fileName;
+    let contentType;
+    let vomServer;
+    if ('file' in ergebnis) {
+        bytes = ergebnis.file.bytes;
+        fileName = ergebnis.file.fileName ?? vorgabe.fileName(exportId);
+        contentType = ergebnis.file.contentType ?? vorgabe.contentType;
+    }
+    else {
+        const link = linkAus(name, istObjekt(ergebnis.data) ? ergebnis.data['download'] : undefined);
+        bytes = await ladeLink(fetchFn, link.url, frist);
+        if (bytes.length !== link.size) {
+            throw antwortfehler(name, `Die geladene Datei hat ${bytes.length} Byte, der Server nannte ${link.size}`);
+        }
+        fileName = link.fileName;
+        contentType = link.contentType;
+        vomServer = link.sha256;
+    }
+    const summe = await sha256Hex(bytes);
+    for (const erwartet of [vomServer, bekannt]) {
+        if (erwartet !== undefined && erwartet !== summe)
+            throw new DepExportChecksumError(exportId, options.file, erwartet, summe);
+    }
+    return { bytes, fileName, contentType, sha256: summe };
+}
+/** Erzeugt einen Pruefer-Link zu einem fertigen Export (`createDepHandoverLink`). Gueltig 14 Tage. */
+async function createDepHandoverLink(transport, options) {
+    const name = 'createDepHandoverLink';
+    const exportId = pruefeKennung(name, 'exportId', options?.exportId);
+    const daten = await transport(name, { exportId });
+    if (!istObjekt(daten) || typeof daten['linkId'] !== 'string' || typeof daten['url'] !== 'string' ||
+        typeof daten['code'] !== 'string' || typeof daten['expiresAt'] !== 'string') {
+        throw antwortfehler(name, 'Antwort ohne linkId, url, code oder expiresAt');
+    }
+    return { linkId: daten['linkId'], url: daten['url'], code: daten['code'], expiresAt: daten['expiresAt'] };
+}
+/** Widerruft einen Pruefer-Link der eigenen Kasse (`revokeDepHandoverLink`). */
+async function revokeDepHandoverLink(transport, options) {
+    const name = 'revokeDepHandoverLink';
+    const linkId = pruefeKennung(name, 'linkId', options?.linkId);
+    const daten = await transport(name, { linkId });
+    if (!istObjekt(daten) || typeof daten['linkId'] !== 'string')
+        throw antwortfehler(name, 'Antwort ohne linkId');
+    return { linkId: daten['linkId'], revokedAt: typeof daten['revokedAt'] === 'string' ? daten['revokedAt'] : null };
+}

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

@@ -1,10 +1,11 @@
 export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, } from './auth.js';
-export { DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type TransportCallOptions, type KasseneckTransport, type KasseneckBinaryTransport, type KasseneckPdfOrDataTransport, type PdfOrData, createTransport, createBinaryTransport, createPdfOrDataTransport, } from './transport.js';
+export { DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type TransportCallOptions, type KasseneckTransport, type KasseneckBinaryTransport, type KasseneckPdfOrDataTransport, type PdfOrData, createTransport, createBinaryTransport, createPdfOrDataTransport, createFileOrDataTransport, type FileOrData, type FileOrDataCallOptions, type KasseneckFileOrDataTransport, } from './transport.js';
 export { ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS, type PublicCall, type PosCall, } from './aufrufe.js';
 export { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, type ErrorOutcome, CLIENT_ERROR_CODES, type ClientErrorCode, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, } from './errors.js';
 export { type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, type CancelReceiptResult, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, type ReceiptOutputEntry, type LogReceiptOutputsOptions, type LogReceiptOutputsResult, type RejectedReceiptOutput, logReceiptOutputs, } from './receipts.js';
 export { listMyCashregisters } from './cashregisters.js';
-export { listReceipts, listAllReceipts, fromListReceiptsSummaryPayload, LIST_RECEIPTS_VIEWS, LIST_RECEIPTS_ORDERS, LIST_RECEIPTS_LIMIT_MAX, LIST_RECEIPTS_DAYS_MAX, LIST_ALL_RECEIPTS_MAX_PAGES, LIST_RECEIPTS_ERROR_CODES, type ListReceiptsErrorCode, type ListReceiptsView, type ListReceiptsOrder, type ListReceiptsOptions, type ListReceiptsWindow, type ListReceiptsGrossByRate, type ListReceiptsSummary, type ListReceiptsDaySummary, type ListReceiptsPage, type ListedReceipt, } from './list-receipts.js';
+export { listReceipts, listAllReceipts, fromListReceiptsSummaryPayload, listedReceiptWithCompany, LIST_RECEIPTS_VIEWS, LIST_RECEIPTS_ORDERS, LIST_RECEIPTS_LIMIT_MAX, LIST_RECEIPTS_DAYS_MAX, LIST_ALL_RECEIPTS_MAX_PAGES, LIST_RECEIPTS_ERROR_CODES, type ListReceiptsErrorCode, type ListReceiptsView, type ListReceiptsOrder, type ListReceiptsOptions, type ListReceiptsWindow, type ListReceiptsGrossByRate, type ListReceiptsSummary, type ListReceiptsDaySummary, type ListReceiptsPage, type ListedReceipt, type ListedFullReceipt, type ListReceiptsHeader, } from './list-receipts.js';
+export { createDepExport, getDepExport, waitForDepExport, getDepExportFile, createDepHandoverLink, revokeDepHandoverLink, DepExportTimeoutError, DepExportChecksumError, DEP_EXPORT_STATUSES, DEP_EXPORT_FILES, DEP_EXPORT_ERROR_CODES, DEP_EXPORT_FAILURES, DEP_EXPORT_POLL_START_MS, DEP_EXPORT_POLL_FACTOR, DEP_EXPORT_POLL_MAX_MS, DEP_EXPORT_WAIT_TIMEOUT_MS, DEP_EXPORT_DOWNLOAD_TIMEOUT_MS, type DepExportStatus, type DepExportFileKind, type DepExportErrorCode, type DepExportFailure, type CreateDepExportOptions, type CreateDepExportResult, type DepExportGap, type DepExportChainBreak, type DepExportFindings, type DepExportItems, type DepHandoverLinkInfo, type DepExport, type WaitForDepExportOptions, type GetDepExportFileOptions, type DepExportFile, type DepHandoverLink, type RevokedDepHandoverLink, } from './dep-export.js';
 export { downloadDailyReport, downloadMonthlyReport, getCashregisterReport, getReportV2, type CashregisterReportPeriod, type ReportV2, type ReportV2Metadata, type ReportV2Options } from './reports.js';
 export { type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, } from './status.js';
 export { type KasseneckApi, createKasseneckApi } from './api.js';

package/dist/cjs/client/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.downloadDailyReport = exports.LIST_RECEIPTS_ERROR_CODES = exports.LIST_ALL_RECEIPTS_MAX_PAGES = exports.LIST_RECEIPTS_DAYS_MAX = exports.LIST_RECEIPTS_LIMIT_MAX = exports.LIST_RECEIPTS_ORDERS = exports.LIST_RECEIPTS_VIEWS = exports.fromListReceiptsSummaryPayload = exports.listAllReceipts = exports.listReceipts = exports.listMyCashregisters = exports.logReceiptOutputs = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.cancelReceipt = exports.receiptLayoutFromResult = exports.cardRefundReference = exports.paymentsExpectedCents = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isOutcomeUnknown = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.CLIENT_ERROR_CODES = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.UNKNOWN_OUTCOME_CALLS = exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = exports.createPdfOrDataTransport = exports.createBinaryTransport = exports.createTransport = exports.DEFAULT_TIMEOUT_MS = exports.POS_BASE_URL = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = void 0;
-exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.getReportV2 = exports.getCashregisterReport = exports.downloadMonthlyReport = void 0;
+exports.LIST_ALL_RECEIPTS_MAX_PAGES = exports.LIST_RECEIPTS_DAYS_MAX = exports.LIST_RECEIPTS_LIMIT_MAX = exports.LIST_RECEIPTS_ORDERS = exports.LIST_RECEIPTS_VIEWS = exports.listedReceiptWithCompany = exports.fromListReceiptsSummaryPayload = exports.listAllReceipts = exports.listReceipts = exports.listMyCashregisters = exports.logReceiptOutputs = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.cancelReceipt = exports.receiptLayoutFromResult = exports.cardRefundReference = exports.paymentsExpectedCents = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isOutcomeUnknown = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.CLIENT_ERROR_CODES = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.UNKNOWN_OUTCOME_CALLS = exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = exports.createFileOrDataTransport = exports.createPdfOrDataTransport = exports.createBinaryTransport = exports.createTransport = exports.DEFAULT_TIMEOUT_MS = exports.POS_BASE_URL = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = void 0;
+exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.getReportV2 = exports.getCashregisterReport = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.DEP_EXPORT_DOWNLOAD_TIMEOUT_MS = exports.DEP_EXPORT_WAIT_TIMEOUT_MS = exports.DEP_EXPORT_POLL_MAX_MS = exports.DEP_EXPORT_POLL_FACTOR = exports.DEP_EXPORT_POLL_START_MS = exports.DEP_EXPORT_FAILURES = exports.DEP_EXPORT_ERROR_CODES = exports.DEP_EXPORT_FILES = exports.DEP_EXPORT_STATUSES = exports.DepExportChecksumError = exports.DepExportTimeoutError = exports.revokeDepHandoverLink = exports.createDepHandoverLink = exports.getDepExportFile = exports.waitForDepExport = exports.getDepExport = exports.createDepExport = exports.LIST_RECEIPTS_ERROR_CODES = void 0;
 var auth_js_1 = require("./auth.js");
 Object.defineProperty(exports, "apiKeyAuth", { enumerable: true, get: function () { return auth_js_1.apiKeyAuth; } });
 Object.defineProperty(exports, "registerUserAuth", { enumerable: true, get: function () { return auth_js_1.registerUserAuth; } });
@@ -12,6 +12,7 @@ Object.defineProperty(exports, "DEFAULT_TIMEOUT_MS", { enumerable: true, get: fu
 Object.defineProperty(exports, "createTransport", { enumerable: true, get: function () { return transport_js_1.createTransport; } });
 Object.defineProperty(exports, "createBinaryTransport", { enumerable: true, get: function () { return transport_js_1.createBinaryTransport; } });
 Object.defineProperty(exports, "createPdfOrDataTransport", { enumerable: true, get: function () { return transport_js_1.createPdfOrDataTransport; } });
+Object.defineProperty(exports, "createFileOrDataTransport", { enumerable: true, get: function () { return transport_js_1.createFileOrDataTransport; } });
 var aufrufe_js_1 = require("./aufrufe.js");
 Object.defineProperty(exports, "ALL_CALLS", { enumerable: true, get: function () { return aufrufe_js_1.ALL_CALLS; } });
 Object.defineProperty(exports, "PUBLIC_CALLS", { enumerable: true, get: function () { return aufrufe_js_1.PUBLIC_CALLS; } });
@@ -52,12 +53,31 @@ var list_receipts_js_1 = require("./list-receipts.js");
 Object.defineProperty(exports, "listReceipts", { enumerable: true, get: function () { return list_receipts_js_1.listReceipts; } });
 Object.defineProperty(exports, "listAllReceipts", { enumerable: true, get: function () { return list_receipts_js_1.listAllReceipts; } });
 Object.defineProperty(exports, "fromListReceiptsSummaryPayload", { enumerable: true, get: function () { return list_receipts_js_1.fromListReceiptsSummaryPayload; } });
+Object.defineProperty(exports, "listedReceiptWithCompany", { enumerable: true, get: function () { return list_receipts_js_1.listedReceiptWithCompany; } });
 Object.defineProperty(exports, "LIST_RECEIPTS_VIEWS", { enumerable: true, get: function () { return list_receipts_js_1.LIST_RECEIPTS_VIEWS; } });
 Object.defineProperty(exports, "LIST_RECEIPTS_ORDERS", { enumerable: true, get: function () { return list_receipts_js_1.LIST_RECEIPTS_ORDERS; } });
 Object.defineProperty(exports, "LIST_RECEIPTS_LIMIT_MAX", { enumerable: true, get: function () { return list_receipts_js_1.LIST_RECEIPTS_LIMIT_MAX; } });
 Object.defineProperty(exports, "LIST_RECEIPTS_DAYS_MAX", { enumerable: true, get: function () { return list_receipts_js_1.LIST_RECEIPTS_DAYS_MAX; } });
 Object.defineProperty(exports, "LIST_ALL_RECEIPTS_MAX_PAGES", { enumerable: true, get: function () { return list_receipts_js_1.LIST_ALL_RECEIPTS_MAX_PAGES; } });
 Object.defineProperty(exports, "LIST_RECEIPTS_ERROR_CODES", { enumerable: true, get: function () { return list_receipts_js_1.LIST_RECEIPTS_ERROR_CODES; } });
+var dep_export_js_1 = require("./dep-export.js");
+Object.defineProperty(exports, "createDepExport", { enumerable: true, get: function () { return dep_export_js_1.createDepExport; } });
+Object.defineProperty(exports, "getDepExport", { enumerable: true, get: function () { return dep_export_js_1.getDepExport; } });
+Object.defineProperty(exports, "waitForDepExport", { enumerable: true, get: function () { return dep_export_js_1.waitForDepExport; } });
+Object.defineProperty(exports, "getDepExportFile", { enumerable: true, get: function () { return dep_export_js_1.getDepExportFile; } });
+Object.defineProperty(exports, "createDepHandoverLink", { enumerable: true, get: function () { return dep_export_js_1.createDepHandoverLink; } });
+Object.defineProperty(exports, "revokeDepHandoverLink", { enumerable: true, get: function () { return dep_export_js_1.revokeDepHandoverLink; } });
+Object.defineProperty(exports, "DepExportTimeoutError", { enumerable: true, get: function () { return dep_export_js_1.DepExportTimeoutError; } });
+Object.defineProperty(exports, "DepExportChecksumError", { enumerable: true, get: function () { return dep_export_js_1.DepExportChecksumError; } });
+Object.defineProperty(exports, "DEP_EXPORT_STATUSES", { enumerable: true, get: function () { return dep_export_js_1.DEP_EXPORT_STATUSES; } });
+Object.defineProperty(exports, "DEP_EXPORT_FILES", { enumerable: true, get: function () { return dep_export_js_1.DEP_EXPORT_FILES; } });
+Object.defineProperty(exports, "DEP_EXPORT_ERROR_CODES", { enumerable: true, get: function () { return dep_export_js_1.DEP_EXPORT_ERROR_CODES; } });
+Object.defineProperty(exports, "DEP_EXPORT_FAILURES", { enumerable: true, get: function () { return dep_export_js_1.DEP_EXPORT_FAILURES; } });
+Object.defineProperty(exports, "DEP_EXPORT_POLL_START_MS", { enumerable: true, get: function () { return dep_export_js_1.DEP_EXPORT_POLL_START_MS; } });
+Object.defineProperty(exports, "DEP_EXPORT_POLL_FACTOR", { enumerable: true, get: function () { return dep_export_js_1.DEP_EXPORT_POLL_FACTOR; } });
+Object.defineProperty(exports, "DEP_EXPORT_POLL_MAX_MS", { enumerable: true, get: function () { return dep_export_js_1.DEP_EXPORT_POLL_MAX_MS; } });
+Object.defineProperty(exports, "DEP_EXPORT_WAIT_TIMEOUT_MS", { enumerable: true, get: function () { return dep_export_js_1.DEP_EXPORT_WAIT_TIMEOUT_MS; } });
+Object.defineProperty(exports, "DEP_EXPORT_DOWNLOAD_TIMEOUT_MS", { enumerable: true, get: function () { return dep_export_js_1.DEP_EXPORT_DOWNLOAD_TIMEOUT_MS; } });
 var reports_js_1 = require("./reports.js");
 Object.defineProperty(exports, "downloadDailyReport", { enumerable: true, get: function () { return reports_js_1.downloadDailyReport; } });
 Object.defineProperty(exports, "downloadMonthlyReport", { enumerable: true, get: function () { return reports_js_1.downloadMonthlyReport; } });

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

@@ -1,6 +1,8 @@
 import { KeckPaymentMethod, ReceiptType } from '../enums/index.js';
-import { type CancellationReason, type CancellationStatus, type Receipt, type ReceiptPayment, type ZeroKind } from '../models/index.js';
+import { type CancellationReason, type CancellationStatus, type Receipt, type ReceiptCompany, type ReceiptPayment, type ZeroKind } from '../models/index.js';
 import type { ReportV2Metadata } from './reports.js';
+import type { ReceiptWithCompany } from './receipts.js';
+import type { SheetLogoSize } from '../receipt/blatt.js';
 import { type ManualReceipt } from '../models/manual-receipt.js';
 import type { InternerTransport } from './aufrufe.js';
 /**
@@ -147,8 +149,26 @@ export interface ListReceiptsSummary {
     /** 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;
+/**
+ * Ein Beleg der vollen Ansicht: das Belegdokument wie bei `getReceipt`, dazu was `getReceipt` in der Huelle
+ * traegt, ausser `outputs` und dem Zeilenmodell `layout` (die gibt es nur einzeln ueber `getReceipt`).
+ * `headerVersionId` ist die Kopf-Version, die fuer diesen Beleg gilt (auch bei Altbelegen ohne gespeicherte
+ * Kennung); ihr Kopf steht in [ListReceiptsPage.headers]. Anbieterdaten der Zahlungen bekommt nur der Betrieb
+ * selbst (API-Schluessel oder Kassen-Anmeldung), nie ein Partner-Zugang.
+ * Druck- und Anzeigedaten wie bei `getReceiptWithCompany`: [listedReceiptWithCompany].
+ */
+export interface ListedFullReceipt extends Receipt {
+    /** Produktionskonto mit Test-Signatureinheit (Aufdruck TESTSIGNATUR); fehlt bei einem Backend vor dem 30.10.2026. */
+    testSignature?: boolean;
+}
+/** Ein Eintrag in [ListReceiptsPage.headers]: Kopf und Fuss einer Kopf-Version (Felder wie die Huelle von `getReceipt`). */
+export interface ListReceiptsHeader {
+    /** `null` nur, wenn das Konto noch keine Kopf-Version hat (dann der heutige Stand). */
+    headerVersionId: string | null;
+    company: ReceiptCompany;
+}
+/** Ein Beleg der Liste je Ansicht: `full` das Belegdokument wie bei `getReceipt`, sonst die Zeile. */
+export type ListedReceipt<V extends ListReceiptsView = 'summary'> = V extends 'full' ? ListedFullReceipt : ListReceiptsSummary;
 /**
  * Tagessumme aus der Tagesstatistik der Kasse, nur bei `date` und nur auf
  * der ersten Seite. **Nicht die Summe der Liste:** `receiptCount` zaehlt jeden
@@ -183,9 +203,28 @@ export interface ListReceiptsPage<V extends ListReceiptsView = 'summary'> {
      * `getReportV2().metadata`. Bei der Kurzansicht fehlt das Feld.
      */
     metadata?: V extends 'full' ? ReportV2Metadata : never;
+    /**
+     * Nur bei `view: 'full'`: die Kopf-Versionen der Belege dieser Seite, je Version einmal, aelteste zuerst.
+     * Fuer den Druck gilt der Eintrag mit der `headerVersionId` des Belegs, nicht `metadata` (heutiger Stand).
+     * Fehlt bei einem Backend vor dem 30.10.2026.
+     */
+    headers?: V extends 'full' ? ListReceiptsHeader[] : never;
+    /** Nur bei `view: 'full'`: Belege einer Testumgebung (Aufdruck TESTKASSE), wie `getReceipt`. */
+    testCashregister?: V extends 'full' ? boolean : never;
+    /** Nur bei `view: 'full'`: Groesse des Firmenlogos (`logo_scale`), wie `getReceipt`. */
+    logoScale?: V extends 'full' ? SheetLogoSize : never;
 }
 /** Zeile `view: summary` vom Draht. */
 export declare function fromListReceiptsSummaryPayload(payload: Record<string, unknown>): ListReceiptsSummary;
+/**
+ * Ein Beleg der vollen Ansicht mit den Druck- und Anzeigedaten seiner Seite, in derselben Form wie
+ * `getReceiptWithCompany` (ohne `outputs`): der Kopf der Version des Belegs aus `headers` (Nullbelege ohne
+ * Logo, wie beim Server), Testkennzeichen, Logo-Stufe. `layout` ist immer `null` -- die Liste traegt kein
+ * Zeilenmodell; [receiptLayoutFromResult] baut es dann mit denselben Angaben, oder `getReceiptWithCompany`
+ * holt das des Servers. Von einem Backend vor dem 30.10.2026 (ohne `headers`) kommt der Kopf aus
+ * `metadata`, dem heutigen Stand.
+ */
+export declare function listedReceiptWithCompany(page: ListReceiptsPage<'full'>, receipt: ListedFullReceipt): ReceiptWithCompany;
 /**
  * Eine Seite Belege der angemeldeten Kasse (`listReceipts`). Die Eingabe wird
  * vor dem Senden nach den Regeln des Servers geprueft (genau eine Form des
@@ -193,8 +232,9 @@ export declare function fromListReceiptsSummaryPayload(payload: Record<string, u
  * `order`, `view`); ein Verstoss wirft [KasseneckValidationError] mit
  * `scope: 'request'`, ohne dass etwas hinausgeht.
  *
- * Mit `view: 'full'` sind die Belege das gespeicherte Belegdokument
- * ([Receipt], dieselbe Form wie `getReportV2`), sonst [ListReceiptsSummary].
+ * Mit `view: 'full'` sind die Belege das gespeicherte Belegdokument mit den
+ * Angaben, die `getReceipt` liefert ([ListedFullReceipt]; Kopf je Version in
+ * `headers`, ohne Zeilenmodell), sonst [ListReceiptsSummary].
  * Alle Seiten auf einmal: [listAllReceipts].
  */
 export declare function listReceipts<V extends ListReceiptsView = 'summary'>(transport: InternerTransport, options: ListReceiptsOptions<V>): Promise<ListReceiptsPage<V>>;

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LIST_RECEIPTS_ERROR_CODES = exports.LIST_ALL_RECEIPTS_MAX_PAGES = exports.LIST_RECEIPTS_DAYS_MAX = exports.LIST_RECEIPTS_LIMIT_MAX = exports.LIST_RECEIPTS_ORDERS = exports.LIST_RECEIPTS_VIEWS = void 0;
 exports.fromListReceiptsSummaryPayload = fromListReceiptsSummaryPayload;
+exports.listedReceiptWithCompany = listedReceiptWithCompany;
 exports.listReceipts = listReceipts;
 exports.listAllReceipts = listAllReceipts;
 const index_js_1 = require("../enums/index.js");
@@ -225,6 +226,57 @@ function kopfdaten(roh) {
     const label = roh.label;
     return { ...(0, index_js_2.fromReceiptCompanyPayload)(roh), label: typeof label === 'string' ? label : '' };
 }
+const LOGO_STUFEN = ['S', 'M', 'L', 'XL'];
+/** Ein Beleg der vollen Ansicht vom Draht: das Belegdokument und die Zusaetze, die `getReceipt` in der Huelle traegt. */
+function vollerBeleg(roh) {
+    const beleg = (0, index_js_2.fromReceiptPayload)(roh);
+    if (typeof roh['testSignature'] === 'boolean')
+        beleg.testSignature = roh['testSignature'];
+    return beleg;
+}
+/** `headers` der vollen Ansicht: je Kopf-Version Kennung und Kopf. */
+function koepfe(roh) {
+    if (!Array.isArray(roh) || roh.some((h) => !istObjekt(h)))
+        throw antwortfehler('headers ist keine Liste von Kopf-Versionen');
+    return roh.map((h) => ({
+        headerVersionId: typeof h['headerVersionId'] === 'string' && h['headerVersionId'] !== '' ? h['headerVersionId'] : null,
+        company: (0, index_js_2.fromReceiptCompanyPayload)(h),
+    }));
+}
+/**
+ * Ein Beleg der vollen Ansicht mit den Druck- und Anzeigedaten seiner Seite, in derselben Form wie
+ * `getReceiptWithCompany` (ohne `outputs`): der Kopf der Version des Belegs aus `headers` (Nullbelege ohne
+ * Logo, wie beim Server), Testkennzeichen, Logo-Stufe. `layout` ist immer `null` -- die Liste traegt kein
+ * Zeilenmodell; [receiptLayoutFromResult] baut es dann mit denselben Angaben, oder `getReceiptWithCompany`
+ * holt das des Servers. Von einem Backend vor dem 30.10.2026 (ohne `headers`) kommt der Kopf aus
+ * `metadata`, dem heutigen Stand.
+ */
+function listedReceiptWithCompany(page, receipt) {
+    const kennung = receipt.headerVersionId ?? null;
+    const eintrag = page.headers?.find((h) => h.headerVersionId === kennung);
+    let company;
+    if (eintrag)
+        company = { ...eintrag.company };
+    else if (page.metadata) {
+        const { label: _label, ...kopf } = page.metadata;
+        company = kopf;
+    }
+    else
+        company = (0, index_js_2.fromReceiptCompanyPayload)({});
+    const art = typeof receipt.receiptType === 'object' ? receipt.receiptType.value : receipt.receiptType;
+    if (art === index_js_1.ReceiptType.zero.value)
+        delete company.logoUrl;
+    return {
+        receipt,
+        company,
+        testCashregister: page.testCashregister === true,
+        testSignature: receipt.testSignature === true,
+        headerVersionId: kennung,
+        layout: null,
+        registrationInfo: receipt.registrationInfo ?? null,
+        logoScale: page.logoScale ?? 'M',
+    };
+}
 /**
  * Eine Seite Belege der angemeldeten Kasse (`listReceipts`). Die Eingabe wird
  * vor dem Senden nach den Regeln des Servers geprueft (genau eine Form des
@@ -232,8 +284,9 @@ function kopfdaten(roh) {
  * `order`, `view`); ein Verstoss wirft [KasseneckValidationError] mit
  * `scope: 'request'`, ohne dass etwas hinausgeht.
  *
- * Mit `view: 'full'` sind die Belege das gespeicherte Belegdokument
- * ([Receipt], dieselbe Form wie `getReportV2`), sonst [ListReceiptsSummary].
+ * Mit `view: 'full'` sind die Belege das gespeicherte Belegdokument mit den
+ * Angaben, die `getReceipt` liefert ([ListedFullReceipt]; Kopf je Version in
+ * `headers`, ohne Zeilenmodell), sonst [ListReceiptsSummary].
  * Alle Seiten auf einmal: [listAllReceipts].
  */
 async function listReceipts(transport, options) {
@@ -254,14 +307,20 @@ async function listReceipts(transport, options) {
         throw antwortfehler('nextCursor passt nicht zu hasMore (Text bei hasMore, sonst null)');
     }
     const receipts = (voll
-        ? liste.map((b) => (0, index_js_2.fromReceiptPayload)(b))
+        ? liste.map((b) => vollerBeleg(b))
         : liste.map((b) => fromListReceiptsSummaryPayload(b)));
+    const stufe = daten['logo_scale'];
     return {
         receipts,
         hasMore: daten['hasMore'],
         nextCursor: daten['hasMore'] ? weiter : null,
         ...('daySummary' in daten ? { daySummary: tagessumme(daten['daySummary']) } : {}),
         ...(voll && 'metadata' in daten ? { metadata: kopfdaten(daten['metadata']) } : {}),
+        ...(voll && 'headers' in daten ? { headers: koepfe(daten['headers']) } : {}),
+        ...(voll && 'testCashregister' in daten ? { testCashregister: (daten['testCashregister'] === true) } : {}),
+        ...(voll && 'logo_scale' in daten
+            ? { logoScale: (typeof stufe === 'string' && LOGO_STUFEN.includes(stufe) ? stufe : 'M') }
+            : {}),
     };
 }
 /**

package/dist/cjs/client/receipts.js

@@ -926,7 +926,7 @@ function cardRefundReference(receipt, paymentId) {
         throw new errors_js_1.KasseneckValidationError('cancelReceipt', `Zahlung "${paymentId}" ist keine Kartenzahlung`, 'request');
     }
     if (typeof zahlung.providerPaymentId !== 'string' || zahlung.providerPaymentId === '') {
-        throw new errors_js_1.KasseneckValidationError('cancelReceipt', `Kennung der Kartenzahlung "${paymentId}" fehlt: sie kommt nur ueber den Kassenweg (registerUserAuth, kasse.kasseneck.at/api/v3), nicht ueber den oeffentlichen Weg`, 'request');
+        throw new errors_js_1.KasseneckValidationError('cancelReceipt', `Kennung der Kartenzahlung "${paymentId}" fehlt: der Beleg kam ohne Anbieterdaten (sie bekommt nur der Betrieb selbst, mit API-Schluessel oder Kassen-Anmeldung, nie ein Partner-Zugang)`, 'request');
     }
     return zahlung.providerPaymentId;
 }
@@ -952,7 +952,7 @@ function pruefeKartenRueckbuchung(zahlungen, original) {
         const orig = original != null && typeof z['refundOf'] === 'string' ? original.payments?.find((o) => o.id === z['refundOf']) : undefined;
         if (typeof orig?.providerPaymentId === 'string' && orig.providerPaymentId !== '')
             return;
-        throw new errors_js_1.KasseneckValidationError('cancelReceipt', `Zahlung ${i + 1}: Karten-Rueckbuchung ohne Bezug: providerPaymentId der Erstattung am Terminal angeben (oder das Original ueber den Kassenweg lesen, dort traegt es die Kennung der Kartenzahlung)`, 'request');
+        throw new errors_js_1.KasseneckValidationError('cancelReceipt', `Zahlung ${i + 1}: Karten-Rueckbuchung ohne Bezug: providerPaymentId der Erstattung am Terminal angeben (oder das Original mit Anbieterdaten lesen: API-Schluessel des Betriebs oder Kassen-Anmeldung, dort traegt es die Kennung der Kartenzahlung)`, 'request');
     });
 }
 /** Kartenanbieter pruefen — er stammt vom Aufrufer, nicht aus Serverdaten. */