@kreiseck/kasseneck-api 1.19.0 → 1.20.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.19.0';
+exports.PACKAGE_VERSION = '1.20.0';

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

@@ -4,6 +4,7 @@ import { type HobexPayOptions, type HobexRefundOptions } from '../payments/hobex
 import { type TransportOptions } from './transport.js';
 import { type CashregisterReportPeriod, type ReportV2, type ReportV2Options } from './reports.js';
 import { type CashboxStatus, type SignatureStatus } from './status.js';
+import { type CreateDepExportOptions, type CreateDepExportResult, type DepExport, type DepExportFile, type DepHandoverLink, type GetDepExportFileOptions, type RevokedDepHandoverLink, type WaitForDepExportOptions } from './dep-export.js';
 import { type ListedReceipt, type ListReceiptsOptions, type ListReceiptsPage, type ListReceiptsView } from './list-receipts.js';
 import { type SendReceiptEmailOptions, type SendReceiptEmailResult, type LogReceiptOutputsOptions, type LogReceiptOutputsResult, type ListMyReceiptsOptions, type ReceiptList, type ReceiptWithCompany, type SellReceiptOptions, type CancelReceiptOptions, type CancelReceiptResult } from './receipts.js';
 /**
@@ -61,6 +62,24 @@ export interface KasseneckApi {
     listReceipts<V extends ListReceiptsView = 'summary'>(options: ListReceiptsOptions<V>): Promise<ListReceiptsPage<V>>;
     /** Alle Belege eines Tages oder Zeitraums, Seite fuer Seite geholt (hoechstens 100 Seiten). */
     listAllReceipts<V extends ListReceiptsView = 'summary'>(options: ListReceiptsOptions<V>): AsyncGenerator<ListedReceipt<V>, void, undefined>;
+    /** DEP-Export fuer die Kassennachschau einstellen (`createDepExport`, nur /v3); antwortet sofort, der Export laeuft im Hintergrund. */
+    createDepExport(options?: CreateDepExportOptions): Promise<CreateDepExportResult>;
+    /** Zustand, Kennzahlen, Befund und Pruefer-Links eines Exports (`getDepExport`). */
+    getDepExport(options: {
+        exportId: string;
+    }): Promise<DepExport>;
+    /** Wartet, bis der Export fertig ist (Abfrage 2 s, x1,5, hoechstens 15 s; Vorgabe 10 Minuten). */
+    waitForDepExport(options: WaitForDepExportOptions): Promise<DepExport>;
+    /** Eine Datei des Exports (dep, protocol, items, zip) laden und gegen die SHA-256-Summe pruefen. */
+    getDepExportFile(options: GetDepExportFileOptions): Promise<DepExportFile>;
+    /** Pruefer-Link (Adresse und 6-stelliger Code, 14 Tage) zu einem fertigen Export. */
+    createDepHandoverLink(options: {
+        exportId: string;
+    }): Promise<DepHandoverLink>;
+    /** Pruefer-Link der eigenen Kasse widerrufen. */
+    revokeDepHandoverLink(options: {
+        linkId: string;
+    }): Promise<RevokedDepHandoverLink>;
     /** Kassenbericht als PDF (v2): abgeschlossener Monat, Tag oder Zeitraum (Endpunkt `getCashregisterReport`). */
     getCashregisterReport(options: CashregisterReportPeriod): Promise<Uint8Array>;
     /** @deprecated Since 1.10.0: use getCashregisterReport. Tagesbericht als PDF (Kalendertag nach Wiener Zeit). */

package/dist/esm/client/api.js

@@ -1,8 +1,9 @@
 import { createStripeLink, stripeCaptureIntent, } from '../payments/stripe.js';
 import { hobexPay, hobexRefund } from '../payments/hobex.js';
-import { createTransport, createBinaryTransport } from './transport.js';
+import { createTransport, createBinaryTransport, createFileOrDataTransport } from './transport.js';
 import { downloadDailyReport, downloadMonthlyReport, getCashregisterReport, getReportV2 } from './reports.js';
 import { getCashboxStatus, getSignatureStatus } from './status.js';
+import { createDepExport, createDepHandoverLink, getDepExport, getDepExportFile, revokeDepHandoverLink, waitForDepExport, } from './dep-export.js';
 import { listAllReceipts, listReceipts } from './list-receipts.js';
 import { sellReceipt, sellReceiptWithCompany, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, sendReceiptEmail, logReceiptOutputs, } from './receipts.js';
 import { listMyCashregisters } from './cashregisters.js';
@@ -12,6 +13,17 @@ export function createKasseneckApi(options) {
     // Zweiter Einstiegspunkt fuer die PDF-Downloads; dieselben Optionen,
     // dieselbe Anmeldung — nur die Antwort wird als Bytes gelesen.
     const rufenBinaer = createBinaryTransport(options);
+    // Fuer Dateien beliebiger Art (DEP-Export): Datei oder Lese-Link.
+    const rufenDatei = createFileOrDataTransport(options);
+    // Das globale fetch erst beim Folgen eines Lese-Links holen: ohne Link braucht es niemand.
+    const holen = (url, init) => {
+        if (options.fetch)
+            return options.fetch(url, init);
+        const umgebung = globalThis;
+        if (typeof umgebung.fetch !== 'function')
+            throw new Error('getDepExportFile: kein globales fetch vorhanden');
+        return umgebung.fetch(url, init);
+    };
     return {
         sellReceipt: (o) => sellReceipt(rufen, o),
         sellReceiptWithCompany: (o) => sellReceiptWithCompany(rufen, o),
@@ -28,6 +40,12 @@ export function createKasseneckApi(options) {
         getReportV2: (o) => getReportV2(rufen, o),
         listReceipts: (o) => listReceipts(rufen, o),
         listAllReceipts: (o) => listAllReceipts(rufen, o),
+        createDepExport: (o) => createDepExport(rufen, o),
+        getDepExport: (o) => getDepExport(rufen, o),
+        waitForDepExport: (o) => waitForDepExport(rufen, o),
+        getDepExportFile: (o) => getDepExportFile(rufenDatei, holen, o),
+        createDepHandoverLink: (o) => createDepHandoverLink(rufen, o),
+        revokeDepHandoverLink: (o) => revokeDepHandoverLink(rufen, o),
         getCashregisterReport: (options) => getCashregisterReport(rufenBinaer, options),
         downloadDailyReport: (date) => downloadDailyReport(rufenBinaer, date),
         downloadMonthlyReport: (reportMonth) => downloadMonthlyReport(rufenBinaer, reportMonth),

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

@@ -12,8 +12,8 @@
  * weiterhin jeden `string`: wer einen Aufruf braucht, den dieses Paket nicht
  * umhuellt, muss ihn weiterhin absetzen koennen.
  */
-import type { PdfOrData, TransportBodyFields, TransportCallOptions } from './transport.js';
-export declare const ALL_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCashregisterReport", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "getReportV2", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyStock", "listMyStockLocations", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listReceipts", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "reportCustomerContract", "requestCustomerSignature", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "logReceiptOutputs"];
+import type { FileOrData, FileOrDataCallOptions, PdfOrData, TransportBodyFields, TransportCallOptions } from './transport.js';
+export declare const ALL_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createDepExport", "createDepHandoverLink", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCashregisterReport", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getDepExport", "getDepExportFile", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "getReportV2", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyStock", "listMyStockLocations", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listReceipts", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "reportCustomerContract", "requestCustomerSignature", "revokeDepHandoverLink", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "logReceiptOutputs"];
 export type ApiCall = typeof ALL_CALLS[number];
 /**
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -21,7 +21,7 @@ export type ApiCall = typeof ALL_CALLS[number];
  * (`fixtures/v3/v3-vokabular.json`, `endpoints.public`, umbenannt nach
  * `names`). Ein Test haelt beide Listen deckungsgleich.
  */
-export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "cancelReceipt", "sendReceiptEmail", "generateFullReceiptId", "downloadReceipt", "getFirstReceiptDate", "getReportV2", "downloadReport", "downloadDailyReport", "getCashregisterReport", "createPaymentLinkStripe", "stripeCaptureIntent", "hobexPayApi", "hobexRefundApi", "hobexGetStatus", "financeWebService", "listMyTipRecipients", "getPartnerInfo", "createPartnerCustomer", "checkPartnerCustomerEmail", "listPartnerCustomers", "getPartnerCustomer", "sendPartnerCustomerFonLink", "createPartnerWebhook", "updatePartnerWebhook", "deletePartnerWebhook", "listPartnerWebhooks", "sendPartnerWebhookTest", "rotatePartnerWebhookSecret", "listPartnerWebhookDeliveries", "requestCustomerSignature", "getCustomerSignatureStatus", "createCustomerCashregister", "activateCashregister", "listCustomerCashregisters", "getCustomerCredentials", "reportCustomerContract", "getPartnerBilling", "getPartnerBillingMonth", "createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus", "listBrands", "recordInvoicePayment", "createInvoiceItem", "updateInvoiceItem", "withdrawInvoiceItem", "getInvoiceItem", "listInvoiceItems", "setCustomerMandate", "revokeCustomerMandate", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder", "listReceipts"];
+export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "cancelReceipt", "sendReceiptEmail", "generateFullReceiptId", "downloadReceipt", "getFirstReceiptDate", "getReportV2", "downloadReport", "downloadDailyReport", "getCashregisterReport", "createPaymentLinkStripe", "stripeCaptureIntent", "hobexPayApi", "hobexRefundApi", "hobexGetStatus", "financeWebService", "listMyTipRecipients", "getPartnerInfo", "createPartnerCustomer", "checkPartnerCustomerEmail", "listPartnerCustomers", "getPartnerCustomer", "sendPartnerCustomerFonLink", "createPartnerWebhook", "updatePartnerWebhook", "deletePartnerWebhook", "listPartnerWebhooks", "sendPartnerWebhookTest", "rotatePartnerWebhookSecret", "listPartnerWebhookDeliveries", "requestCustomerSignature", "getCustomerSignatureStatus", "createCustomerCashregister", "activateCashregister", "listCustomerCashregisters", "getCustomerCredentials", "reportCustomerContract", "getPartnerBilling", "getPartnerBillingMonth", "createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus", "listBrands", "recordInvoicePayment", "createInvoiceItem", "updateInvoiceItem", "withdrawInvoiceItem", "getInvoiceItem", "listInvoiceItems", "setCustomerMandate", "revokeCustomerMandate", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder", "listReceipts", "createDepExport", "getDepExport", "getDepExportFile", "createDepHandoverLink", "revokeDepHandoverLink"];
 /**
  * Die Endpunkte des Kassenwegs (`https://kasse.kasseneck.at/api/v3/<name>`,
  * Web-Kasse: gleicher Ursprung `/api/v3`), in der Reihenfolge von
@@ -99,3 +99,5 @@ export type InternerTransport = <T = unknown>(functionName: ApiCall, params?: Re
 export type InternerBinaerTransport = (functionName: ApiCall, params?: Record<string, unknown>) => Promise<Uint8Array>;
 /** Wie `createPdfOrDataTransport` (transport.ts), nur mit bekanntem Aufrufnamen. */
 export type InternerPdfOderDatenTransport = (functionName: ApiCall, params?: Record<string, unknown>) => Promise<PdfOrData>;
+/** Wie `createFileOrDataTransport` (transport.ts), nur mit bekanntem Aufrufnamen. */
+export type InternerDateiOderDatenTransport = (functionName: ApiCall, params?: Record<string, unknown>, options?: FileOrDataCallOptions) => Promise<FileOrData>;

package/dist/esm/client/aufrufe.js

@@ -5,6 +5,8 @@ export const ALL_CALLS = [
     'createCreditNote',
     'createCustomer',
     'createCustomerCashregister',
+    'createDepExport',
+    'createDepHandoverLink',
     'createPartnerCustomer',
     'checkPartnerCustomerEmail',
     'createPartnerWebhook',
@@ -21,6 +23,8 @@ export const ALL_CALLS = [
     'getCustomer',
     'getCustomerCredentials',
     'getCustomerSignatureStatus',
+    'getDepExport',
+    'getDepExportFile',
     'getFirstReceiptDate',
     'getInvoice',
     'getInvoicePdf',
@@ -59,6 +63,7 @@ export const ALL_CALLS = [
     'renewRegisterSession',
     'reportCustomerContract',
     'requestCustomerSignature',
+    'revokeDepHandoverLink',
     'searchCustomers',
     'sendPartnerCustomerFonLink',
     'sendPartnerWebhookTest',
@@ -265,6 +270,12 @@ export const PUBLIC_CALLS = [
     'getSignatureCardOrder',
     // Belege einer Kasse auflisten, nur unter /v3 (Nachfolger von getReportV2 fuer Listen).
     'listReceipts',
+    // DEP-Export fuer die Kassennachschau (Kassen-Token), nur unter /v3.
+    'createDepExport',
+    'getDepExport',
+    'getDepExportFile',
+    'createDepHandoverLink',
+    'revokeDepHandoverLink',
 ];
 /**
  * Die Endpunkte des Kassenwegs (`https://kasse.kasseneck.at/api/v3/<name>`,
@@ -449,6 +460,15 @@ export const CALLS_WITHOUT_EFFECT = Object.freeze({
     getCustomer: 'read',
     getCustomerCredentials: 'read',
     getCustomerSignatureStatus: 'read',
+    // DEP-Export: ein verlorener Ausgang ist harmlos wiederholbar. createDepExport ist mit requestId idempotent, ohne nur
+    // doppelt (Grenze 20 je Tag, keine Buchung). createDepHandoverLink erzeugt bei Wiederholung einen zweiten Link (der
+    // alte steht in getDepExport().handoverLinks und ist widerrufbar; Preis hoechstens too_many_links). revokeDepHandoverLink
+    // ist idempotent.
+    createDepExport: 'repeatable',
+    createDepHandoverLink: 'repeatable',
+    revokeDepHandoverLink: 'repeatable',
+    getDepExport: 'read',
+    getDepExportFile: 'read',
     getFirstReceiptDate: 'read',
     getInvoice: 'read',
     getInvoiceItem: 'read',

package/dist/esm/client/dep-export.d.ts

@@ -0,0 +1,242 @@
+import { KasseneckValidationError } from './errors.js';
+import type { InternerDateiOderDatenTransport, InternerTransport } from './aufrufe.js';
+import type { FetchLike } from './transport.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. */
+export declare const DEP_EXPORT_STATUSES: readonly ["running", "done", "failed"];
+export type DepExportStatus = (typeof DEP_EXPORT_STATUSES)[number];
+/** Die Dateien eines Exports: DEP-JSON, Protokoll (PDF), Positionen (CSV) und alles zusammen als ZIP. */
+export declare const DEP_EXPORT_FILES: readonly ["dep", "protocol", "items", "zip"];
+export type DepExportFileKind = (typeof DEP_EXPORT_FILES)[number];
+/**
+ * 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.
+ */
+export declare const DEP_EXPORT_ERROR_CODES: readonly ["validation", "invalid_period", "idempotency_conflict", "export_running", "too_many_exports", "export_not_found", "export_not_ready", "export_failed", "invalid_file", "file_not_available", "too_many_links", "link_not_found", "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.
+ */
+export declare const DEP_EXPORT_FAILURES: readonly ["export_failed", "export_stalled"];
+export type DepExportFailure = (typeof DEP_EXPORT_FAILURES)[number];
+/**
+ * Codes, die die DEP-Aufrufe als `KasseneckApiError.code` werfen:
+ * [DEP_EXPORT_ERROR_CODES] und, aus [waitForDepExport], die Gruende eines
+ * fehlgeschlagenen Exports ([DEP_EXPORT_FAILURES], also auch `export_stalled`).
+ */
+export type DepExportErrorCode = (typeof DEP_EXPORT_ERROR_CODES)[number] | DepExportFailure;
+/** Eingabe von [createDepExport]. Ohne `from`/`to` der ganze Bestand. */
+export interface CreateDepExportOptions {
+    /** Erster Tag (inklusive), `YYYY-MM-DD`, nicht in der Zukunft. */
+    from?: string;
+    /** Letzter Tag (inklusive), `YYYY-MM-DD`, nicht vor `from`. */
+    to?: string;
+    /**
+     * Wiederholungsschutz je Kasse: derselbe Wert mit demselben Zeitraum
+     * liefert denselben Export (mit seinem aktuellen Stand) statt eines zweiten;
+     * mit anderem Zeitraum `idempotency_conflict`. Hoechstens 64 Zeichen aus
+     * `A-Z a-z 0-9 _ -`. Bei unklarem Ausgang (Zeitlimit) mit **demselben** Wert
+     * und demselben Zeitraum wiederholen.
+     */
+    requestId?: string;
+}
+/** Antwort von [createDepExport]: Kennung und Zustand (bei einer wiederholten `requestId` auch `done`). */
+export interface CreateDepExportResult {
+    exportId: string;
+    status: DepExportStatus;
+    from: string | null;
+    to: string | null;
+}
+/** Eine Luecke in der Belegnummerierung: Zaehler von bis (einschliesslich). */
+export interface DepExportGap {
+    from: number;
+    to: number;
+}
+/** Erster Bruch der Signaturkette: am Zaehler `counter` erwartet, aber gefunden. */
+export interface DepExportChainBreak {
+    counter: number | null;
+    expected: unknown;
+    found: unknown;
+}
+/** Befund der Pruefung des Exports (`DepExport.findings`). */
+export interface DepExportFindings {
+    receiptCount: number | null;
+    counterFrom: number | null;
+    counterTo: number | null;
+    /** Fehlende Belegnummern als zusammenhaengende Bereiche. */
+    gaps: DepExportGap[];
+    /** Hoechstens ein Eintrag: der erste Bruch der Kette. */
+    chainBreaks: DepExportChainBreak[];
+    /** `receiptId` der Belege ohne Zaehler. */
+    withoutCounter: string[];
+    /** `receiptId` der Belege ohne Signatur. */
+    withoutSignature: string[];
+}
+/** Die Positionsdatei (CSV) eines Exports; `null` bei Exporten aus der Zeit davor. */
+export interface DepExportItems {
+    rowCount: number;
+    sha256: string;
+    size: number;
+}
+/** Ein Pruefer-Link, wie ihn der Export auffuehrt (ohne Adresse und Code). */
+export interface DepHandoverLinkInfo {
+    linkId: string;
+    createdAt: string | null;
+    expiresAt: string | null;
+    revokedAt: string | null;
+    firstAccessAt: string | null;
+    accessCount: number;
+}
+/** Ein Export mit Zustand, Kennzahlen, Befund und Links (`getDepExport`). Zeiten ISO 8601 (UTC). */
+export interface DepExport {
+    exportId: string;
+    status: DepExportStatus;
+    from: string | null;
+    to: string | null;
+    createdAt: string | null;
+    finishedAt: string | null;
+    receiptCount: number | null;
+    counterFrom: number | null;
+    counterTo: number | null;
+    /** SHA-256 (hex) der DEP-JSON-Datei. */
+    sha256: string | null;
+    /** Groesse der DEP-JSON-Datei in Byte. */
+    size: number | null;
+    findings: DepExportFindings | null;
+    items: DepExportItems | null;
+    handoverLinks: DepHandoverLinkInfo[];
+    /** Nur bei `status: 'failed'`: `export_stalled` (haengend) oder `export_failed`. */
+    error?: DepExportFailure;
+}
+/** Eingabe von [waitForDepExport]. */
+export interface WaitForDepExportOptions {
+    exportId: string;
+    /** Hoechstdauer in Millisekunden (Vorgabe 600.000 = 10 Minuten). */
+    timeoutMs?: number;
+}
+/** Eingabe von [getDepExportFile]. */
+export interface GetDepExportFileOptions {
+    exportId: string;
+    file: DepExportFileKind;
+    /**
+     * Bekannte SHA-256-Pruefsumme (hex) der Datei, etwa `DepExport.sha256` fuer
+     * `dep` oder `DepExport.items.sha256` fuer `items`. Weicht die geladene Datei
+     * ab, wirft der Aufruf. Bei einem Lese-Link prueft der Aufruf ausserdem immer
+     * gegen die Pruefsumme, die der Server mit dem Link nennt.
+     */
+    sha256?: string;
+    /**
+     * Zeitlimit in Millisekunden (Vorgabe 600.000), je fuer den Aufruf selbst und
+     * fuer das Laden ueber einen Lese-Link. Der Aufruf liefert eine Datei bis
+     * 9 MiB direkt und braucht dafuer mehr als das allgemeine Zeitlimit des
+     * Transports (`timeoutMs`, Vorgabe 30 s); es gilt hier nicht.
+     */
+    downloadTimeoutMs?: number;
+}
+/** Eine geladene, gepruefte Datei. */
+export interface DepExportFile {
+    bytes: Uint8Array;
+    fileName: string;
+    contentType: string;
+    /** SHA-256 (hex) der Bytes, vom Paket berechnet. */
+    sha256: string;
+}
+/** Ein erzeugter Pruefer-Link (`createDepHandoverLink`). Adresse und Code nur jetzt, danach nie wieder. */
+export interface DepHandoverLink {
+    linkId: string;
+    /** Adresse fuer das Pruefungsorgan (Token im Fragment). */
+    url: string;
+    /** 6-stelliger Code, getrennt von der Adresse zu uebergeben. */
+    code: string;
+    expiresAt: string;
+}
+/** Antwort von [revokeDepHandoverLink]. */
+export interface RevokedDepHandoverLink {
+    linkId: string;
+    revokedAt: string | null;
+}
+/** Wartezeiten von [waitForDepExport]: 2 s, dann je x1,5, hoechstens 15 s. */
+export declare const DEP_EXPORT_POLL_START_MS = 2000;
+export declare const DEP_EXPORT_POLL_FACTOR = 1.5;
+export declare const DEP_EXPORT_POLL_MAX_MS = 15000;
+/** Vorgabe fuer `waitForDepExport.timeoutMs`. */
+export declare const DEP_EXPORT_WAIT_TIMEOUT_MS = 600000;
+/** Vorgabe fuer `getDepExportFile.downloadTimeoutMs`: der Aufruf selbst und das Laden ueber einen Lese-Link. */
+export declare const DEP_EXPORT_DOWNLOAD_TIMEOUT_MS = 600000;
+/**
+ * [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.
+ */
+export declare class DepExportTimeoutError extends Error {
+    readonly name = "DepExportTimeoutError";
+    readonly exportId: string;
+    readonly timeoutMs: number;
+    /** Zustand bei der letzten Abfrage. */
+    readonly lastStatus: DepExportStatus;
+    constructor(exportId: string, timeoutMs: number, lastStatus: DepExportStatus);
+}
+/** Das Ergebnis stimmt nicht mit der Pruefsumme ueberein: die Datei ist nicht zu verwenden. */
+export declare class DepExportChecksumError extends KasseneckValidationError {
+    readonly expected: string;
+    readonly actual: string;
+    constructor(exportId: string, file: DepExportFileKind, expected: string, actual: string);
+}
+/**
+ * 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`.
+ */
+export declare function createDepExport(transport: InternerTransport, options?: CreateDepExportOptions): Promise<CreateDepExportResult>;
+/** Zustand, Kennzahlen, Befund und Links eines Exports (`getDepExport`). */
+export declare function getDepExport(transport: InternerTransport, options: {
+    exportId: string;
+}): Promise<DepExport>;
+/**
+ * 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.
+ */
+export declare function waitForDepExport(transport: InternerTransport, options: WaitForDepExportOptions): Promise<DepExport>;
+/**
+ * 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].
+ */
+export declare function getDepExportFile(transport: InternerDateiOderDatenTransport, fetchFn: FetchLike, options: GetDepExportFileOptions): Promise<DepExportFile>;
+/** Erzeugt einen Pruefer-Link zu einem fertigen Export (`createDepHandoverLink`). Gueltig 14 Tage. */
+export declare function createDepHandoverLink(transport: InternerTransport, options: {
+    exportId: string;
+}): Promise<DepHandoverLink>;
+/** Widerruft einen Pruefer-Link der eigenen Kasse (`revokeDepHandoverLink`). */
+export declare function revokeDepHandoverLink(transport: InternerTransport, options: {
+    linkId: string;
+}): Promise<RevokedDepHandoverLink>;