@kreiseck/kasseneck-api 1.14.0 → 1.16.0

package/CHANGELOG.md

@@ -4,6 +4,27 @@ 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.16.0 - 2026-10-28
+
+Header data for the full view of `listReceipts`, and the new upper limit of `getReportV2`. Additive.
+
+- **`ListReceiptsPage.metadata`** (only with `view: 'full'`): the business data for the receipt header, the same `ReportV2Metadata` as `getReportV2().metadata` (`companyName`, address, `taxNumber`, `vatId`, footers, logo, `label` of the cash register); missing on the summary view. A `metadata` that is not an object is a response error. Reason: an app that prints a receipt again needs the header, and moving from `getReportV2` to `listReceipts` must not lose it.
+- **`getReportV2`: the server now refuses more than 62 calendar days between `start` and `end`** with `range_too_long` (`KasseneckApiError`), without reading any receipt. The package does not check this before sending. Reason: one call could load an unbounded number of receipts; lists belong to `listReceipts`.
+- Contract `v3` from the backend after keck#790.
+
+## 1.15.0 - 2026-10-28
+
+Receipt lists page by page: `listReceipts` and `listAllReceipts` for the new public endpoint `listReceipts` (`/v3` only). Additive.
+
+- **`listReceipts(options)`** (root and `createKasseneckApi`, `apiKeyAuth` with `cashregister-token` like `getReportV2`) returns one page `{ receipts, hasMore, nextCursor, daySummary? }` (`ListReceiptsPage`). Window: exactly one of `date` (`YYYY-MM-DD`, one Vienna day) or `from` (inclusive) + `to` (exclusive), each `YYYY-MM-DD` or `YYYY-MM-DDTHH:mm:ss` Vienna wall clock, at most 31 calendar days (`LIST_RECEIPTS_DAYS_MAX`); `limit` 1-500 (`LIST_RECEIPTS_LIMIT_MAX`, default 100), `order` `desc`|`asc` (`LIST_RECEIPTS_ORDERS`), `view` `summary`|`full` (`LIST_RECEIPTS_VIEWS`), `cursor` = `nextCursor` of the previous page (same window, order and view; limit may change). Reason: `getReportV2` returns every receipt of any period in one answer, without a limit; a list needs pages with bounded cost per call.
+- **Checked before sending, by the server's rules:** one window form, the date formats (impossible dates such as `2026-02-30`, no zone, no fractions), `to` after `from`, 31 calendar days counted without time zone (also across the change of summer time), `limit` an integer 1-500 (never capped silently), `order`/`view` values, a non-empty `cursor`. A violation throws `KasseneckValidationError` (`scope: 'request'`) and nothing goes out. Reason: a partner should notice a wrong request at once, not after a round trip, and the package rejects what the server rejects.
+- **Separate types per view:** `view: 'summary'` (default) gives `ListReceiptsSummary` rows (`receiptId`, `counter`, `receiptType`, `zeroKind`, `timeStamp`, `totalCents`, `grossByRateCents { standard, reduced1, reduced2, zero, special }`, `paymentMethod`, `payments?`, `tipCents?`, `operator { name } | null`, `cancellationOf { receiptId, timeStamp } | null`, `cancellationReason`, `cancellationStatus`, `signatureOk`, `customProjectId`, `fullReceiptId`), amounts in whole cents; `view: 'full'` gives `Receipt`, the same shape and reader as `getReportV2`. The page type follows `view` (`ListReceiptsPage<'full'>`, `ListedReceipt<V>`). Read leniently like the other lists: an unknown receipt type or payment method stays readable as sent, an unknown `cancellationStatus` reads as `'unknown'` (offer no cancellation then). The name is `ListReceiptsSummary` because `ReceiptSummary` already is the row of `listMyReceipts` (register path, other fields).
+- **`daySummary`** (`ListReceiptsDaySummary`: `date`, `receiptCount`, `revenueCents`, `revenueByRate [{ rateBp, grossCents }]`) only with `date` and only on the first page, `null` when the day has no statistics, absent on later pages. It is not the sum of the list (the count covers every receipt of the day, the revenue only standard and cancellation receipts, without employee tips, after promotion discounts).
+- **`listAllReceipts(options)`**: an `AsyncGenerator` that fetches page after page with the same window, order and view and yields each receipt once, in the server's order; without `limit` it asks for pages of 500, with `cursor` it resumes there. An error on a page ends the loop (receipts already yielded stay valid). After `LIST_ALL_RECEIPTS_MAX_PAGES` (100) pages, or when the server names the same cursor twice, it throws `KasseneckValidationError` (`scope: 'response'`). Reason: a cursor that never ends must not turn into an endless loop of paid reads.
+- **Answer checks:** a page without `receipts`, without boolean `hasMore`, with `hasMore` but no cursor (or a cursor without `hasMore`), or with a `daySummary` that is neither object nor `null` throws `KasseneckValidationError` (`scope: 'response'`).
+- **`LIST_RECEIPTS_ERROR_CODES`**: `invalid_date`, `invalid_range`, `range_too_long`, `invalid_limit`, `invalid_order`, `invalid_view`, `invalid_cursor`, `server_error` (plus the codes of sign-in and edge). `listReceipts` is a read (`outcome: 'rejected'` after a timeout), in `PUBLIC_CALLS` (now 108) and in the contract `surface.json`.
+- Contract re-fetched from the backend (`listReceipts` in `endpoints.public`, schema with `cancellationStatus`/`cancellationReason` catalogues). Also from it: `idempotency_conflict` in `RECEIPT_ERROR_CODES` (readable only; this package sends no `idempotencyKey` on receipts yet), `invoice_number_taken` at the end of `INVOICE_ERROR_CODES` (`fixtures/invoice-api.schema.json` rewritten), and the old settings field `vouchers.label`, which the package does not read (registers before voucher stage 4b).
+
 ## 1.14.0 - 2026-10-23
 
 Vouchers at the register, catch-up: the receipt rules of the voucher form, words for the register navigation, the drawer reason of a voucher payout and three shortcut actions; in addition the line `Duplikat am:` on every reprint (`markAsDuplicate`) and the receipt outputs (`logReceiptOutputs`, `outputs` from `getReceipt`, words for the receipt detail). Additive, with one type narrowing (see below).

package/README.md

@@ -552,8 +552,9 @@ The facade from `createKasseneckApi` offers `sellReceipt` and
 `getReceipt` and `getReceiptWithCompany`, `listMyReceipts`, `cancelReceipt`,
 `sendReceiptEmail`, the report downloads, the FinanzOnline status queries
 (`getCashboxStatus`, `getSignatureStatus`), `getReportV2({ start, end })` for
-the raw receipts and company data of a period, and the Stripe and Hobex cloud
-payments.
+the raw receipts and company data of a period, `listReceipts` and
+`listAllReceipts` for receipt lists page by page (see below), and the Stripe
+and Hobex cloud payments.
 
 The models are English throughout: the company has `taxNumber` and `vatId`, a
 receipt `headerVersionId`, `layoutRuleset` and `registrationInfo`, a receipt
@@ -596,6 +597,73 @@ text stays German, and the CSS classes of the React banner stay
 Times on receipts are read as **Vienna wall-clock time**
 (`parseServerTimeStamp`), never through `new Date(text)`.
 
+### Listing receipts: `listReceipts` and `listAllReceipts`
+
+`listReceipts` lists the receipts of the signed-in cash register for one day
+(`date`) or a period (`from` inclusive, `to` exclusive, at most 31 calendar
+days), page by page. Same sign-in as `getReportV2`: `apiKeyAuth` with the API
+key and the `cashregister-token`; the cash register comes from the token.
+Only on `/v3`. Times are Vienna wall-clock text (`YYYY-MM-DD` or
+`YYYY-MM-DDTHH:mm:ss`, no zone), like `timeStamp` on the receipt; a day is a
+calendar day, also when the clocks change. For lists use this instead of
+`getReportV2`, which returns a whole period in one answer and stays for
+reports.
+
+```ts
+import { createKasseneckApi, apiKeyAuth } from '@kreiseck/kasseneck-api';
+
+const api = createKasseneckApi({ auth: apiKeyAuth({ apiKey, cashregisterToken }) });
+
+// One page (default 100, at most 500), newest first, short lines in cents.
+const page = await api.listReceipts({ date: '2026-10-27', limit: 50 });
+for (const r of page.receipts) console.log(r.counter, r.timeStamp, r.totalCents, r.cancellationStatus);
+console.log(page.daySummary?.revenueCents);
+if (page.hasMore) {
+  // Same window, order and view; limit may change.
+  const next = await api.listReceipts({ date: '2026-10-27', limit: 50, cursor: page.nextCursor! });
+}
+
+// Every receipt of a month, oldest first, as the stored receipt document.
+for await (const receipt of api.listAllReceipts({ from: '2026-10-01', to: '2026-11-01', order: 'asc', view: 'full' })) {
+  console.log(receipt.receiptId, receipt.items.length);
+}
+```
+
+- **Options:** exactly one window, `date` or `from` + `to`; `limit` 1-500
+  (an integer; the server never caps silently), `order` `desc` (default) or
+  `asc`, `view` `summary` (default) or `full`, `cursor` from `nextCursor`.
+  The package checks all of this before sending, by the server's rules
+  (impossible dates like `2026-02-30`, more than 31 calendar days, `to` not
+  after `from`, ...), and throws `KasseneckValidationError` with
+  `scope: 'request'`; nothing goes out.
+- **Views:** `summary` returns `ListReceiptsSummary` rows (`receiptId`,
+  `counter`, `receiptType`, `zeroKind`, `timeStamp`, `totalCents`,
+  `grossByRateCents`, `paymentMethod`, `payments`, `tipCents`, `operator`,
+  `cancellationOf`, `cancellationReason`, `cancellationStatus`, `signatureOk`,
+  `customProjectId`, `fullReceiptId`); amounts in cents, no items, no layout.
+  `full` returns `Receipt`, the same shape as `getReportV2`. For one receipt
+  with its print layout use `getReceiptWithCompany`, for the PDF
+  `downloadReceipt` with `fullReceiptId`. `ListReceiptsSummary` is not the
+  `ReceiptSummary` of `listMyReceipts` (register path, other fields).
+- **`daySummary`** is only there with `date` and only on the first page
+  (`null` when the day has no statistics): `receiptCount` counts every
+  receipt of the day, `revenueCents` only standard and cancellation receipts,
+  without employee tips and after promotion discounts, and `revenueByRate`
+  per rate in basis points. It is not the sum of the list; to sum the list,
+  sum the list.
+- **`listAllReceipts`** fetches page after page with the same window, `order`
+  and `view` and yields each receipt once, in the server's order. Without
+  `limit` it asks for pages of 500. An error on any page ends the loop
+  (`for await` throws it; receipts already yielded stay valid). After
+  `LIST_ALL_RECEIPTS_MAX_PAGES` (100) pages, or when the server repeats a
+  cursor, it throws `KasseneckValidationError` (`scope: 'response'`) instead
+  of running forever. It does not return `daySummary`.
+- **Errors** (`KasseneckApiError.code`, `LIST_RECEIPTS_ERROR_CODES`):
+  `invalid_date`, `invalid_range`, `range_too_long`, `invalid_limit`,
+  `invalid_order`, `invalid_view`, `invalid_cursor` (a cursor of another
+  cash register or query, or changed window, `order` or `view`),
+  `server_error`, plus the codes of sign-in and edge.
+
 ## Cancellation (Storno)
 
 A cancellation (*Storno*) refers to the original receipt, in full or in part:
@@ -724,6 +792,8 @@ receipt in 24 hours, 30 per register per hour) and `send_failed`.
 
 ## Receipt printing: QR code, logo, printers
 
+`view: 'full'` returns the stored receipts plus `page.metadata` (business data for the receipt header, the same as `getReportV2().metadata`). `getReportV2` itself accepts at most 62 days between `start` and `end` (`range_too_long`).
+
 ### The QR code fits the paper
 
 The native QR command is given a module size in dots and does not check

package/dist/cjs/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 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';
 /**
  * Schlichte Factory ueber den Endpunkt-Funktionen: bindet einen Transport
@@ -56,6 +57,10 @@ export interface KasseneckApi {
     listMyCashregisters(): Promise<Cashregister[]>;
     /** Rohdaten eines Zeitraums: Belege und Firmendaten (`getReportV2`). */
     getReportV2(options: ReportV2Options): Promise<ReportV2>;
+    /** Eine Seite Belege eines Tages oder Zeitraums (`listReceipts`, hoechstens 31 Tage, blaetterbar). */
+    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>;
     /** 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/cjs/client/api.js

@@ -6,6 +6,7 @@ const hobex_js_1 = require("../payments/hobex.js");
 const transport_js_1 = require("./transport.js");
 const reports_js_1 = require("./reports.js");
 const status_js_1 = require("./status.js");
+const list_receipts_js_1 = require("./list-receipts.js");
 const receipts_js_1 = require("./receipts.js");
 const cashregisters_js_1 = require("./cashregisters.js");
 const session_js_1 = require("../register/session.js");
@@ -28,6 +29,8 @@ function createKasseneckApi(options) {
         logReceiptOutputs: (o) => (0, receipts_js_1.logReceiptOutputs)(rufen, o),
         listMyCashregisters: () => (0, cashregisters_js_1.listMyCashregisters)(rufen),
         getReportV2: (o) => (0, reports_js_1.getReportV2)(rufen, o),
+        listReceipts: (o) => (0, list_receipts_js_1.listReceipts)(rufen, o),
+        listAllReceipts: (o) => (0, list_receipts_js_1.listAllReceipts)(rufen, o),
         getCashregisterReport: (options) => (0, reports_js_1.getCashregisterReport)(rufenBinaer, options),
         downloadDailyReport: (date) => (0, reports_js_1.downloadDailyReport)(rufenBinaer, date),
         downloadMonthlyReport: (reportMonth) => (0, reports_js_1.downloadMonthlyReport)(rufenBinaer, reportMonth),

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

@@ -13,7 +13,7 @@
  * 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", "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"];
+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"];
 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"];
+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"];
 /**
  * Die Endpunkte des Kassenwegs (`https://kasse.kasseneck.at/api/v3/<name>`,
  * Web-Kasse: gleicher Ursprung `/api/v3`), in der Reihenfolge von

package/dist/cjs/client/aufrufe.js

@@ -55,6 +55,7 @@ exports.ALL_CALLS = [
     'listPartnerCustomers',
     'listPartnerWebhookDeliveries',
     'listPartnerWebhooks',
+    'listReceipts',
     'listRegisterUsersForDevice',
     'listRegisterSessionsForDevice',
     'pairRegisterDevice',
@@ -268,6 +269,8 @@ exports.PUBLIC_CALLS = [
     'getStocktakePdf',
     'orderSignatureCard',
     'getSignatureCardOrder',
+    // Belege einer Kasse auflisten, nur unter /v3 (Nachfolger von getReportV2 fuer Listen).
+    'listReceipts',
 ];
 /**
  * Die Endpunkte des Kassenwegs (`https://kasse.kasseneck.at/api/v3/<name>`,
@@ -495,6 +498,7 @@ exports.CALLS_WITHOUT_EFFECT = Object.freeze({
     listPartnerCustomers: 'read',
     listPartnerWebhookDeliveries: 'read',
     listPartnerWebhooks: 'read',
+    listReceipts: 'read',
     listRegisterSessionsForDevice: 'read',
     listRegisterUsersForDevice: 'read',
     listReservations: 'read',

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

@@ -4,6 +4,7 @@ export { ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS
 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 { 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,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.getReportV2 = exports.getCashregisterReport = exports.downloadMonthlyReport = exports.downloadDailyReport = 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.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;
 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; } });
@@ -47,6 +48,16 @@ Object.defineProperty(exports, "sendReceiptEmail", { enumerable: true, get: func
 Object.defineProperty(exports, "logReceiptOutputs", { enumerable: true, get: function () { return receipts_js_1.logReceiptOutputs; } });
 var cashregisters_js_1 = require("./cashregisters.js");
 Object.defineProperty(exports, "listMyCashregisters", { enumerable: true, get: function () { return cashregisters_js_1.listMyCashregisters; } });
+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, "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 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

@@ -0,0 +1,217 @@
+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 { InternerTransport } from './aufrufe.js';
+/**
+ * Belege einer Kasse auflisten (`listReceipts`, nur unter `/v3`): ein Tag oder
+ * ein Zeitraum von hoechstens 31 Kalendertagen, Seite fuer Seite ueber einen
+ * undurchsichtigen Cursor. Nachfolger von `getReportV2` fuer Listen;
+ * `getReportV2` bleibt fuer Berichte.
+ *
+ * **Anmeldung wie `getReportV2`:** API-Schluessel plus `cashregister-token`
+ * (`apiKeyAuth`); die Kasse kommt aus dem Token, nie aus einem Parameter.
+ * Kassen-Bediener (Geraet + PIN) weist der Server ab; die Kasse hat dafuer
+ * `listMyReceipts` am Kassenweg. Dieses Paket bildet das nicht nach, wer darf,
+ * entscheidet allein das Backend.
+ *
+ * Zeiten sind die **Wiener Wanduhr** als Text, wie `timeStamp` am Beleg; der
+ * Server vergleicht sie als Text. Ein Tag ist ein Kalendertag, auch an den
+ * Tagen der Zeitumstellung, und die Grenze von 31 Tagen zaehlt Kalendertage,
+ * nicht 31 x 24 Stunden. Die Pruefung hier rechnet darum ohne Zeitzone, genau
+ * wie der Server (`beleg-liste-core.js`).
+ */
+/** Ansicht einer Seite: `summary` eine schlanke Zeile je Beleg, `full` das gespeicherte Belegdokument. */
+export declare const LIST_RECEIPTS_VIEWS: readonly ["summary", "full"];
+export type ListReceiptsView = (typeof LIST_RECEIPTS_VIEWS)[number];
+/** Reihenfolge: `desc` neueste zuerst (Vorgabe des Servers), `asc` aelteste zuerst. */
+export declare const LIST_RECEIPTS_ORDERS: readonly ["desc", "asc"];
+export type ListReceiptsOrder = (typeof LIST_RECEIPTS_ORDERS)[number];
+/** Groesste Seite, die der Server liefert (`limit`); ohne Angabe nimmt er 100. */
+export declare const LIST_RECEIPTS_LIMIT_MAX = 500;
+/** Laengster Zeitraum in Kalendertagen (`to` hoechstens `from` + 31 Tage). */
+export declare const LIST_RECEIPTS_DAYS_MAX = 31;
+/**
+ * So viele Seiten holt [listAllReceipts] hoechstens, dann bricht er mit
+ * Fehler ab. Schutz gegen einen Cursor, der nie endet; mit der Seitengroesse
+ * des Helfers (500) sind das 50.000 Belege, mehr als jede Kasse in 31 Tagen
+ * ausstellt.
+ */
+export declare const LIST_ALL_RECEIPTS_MAX_PAGES = 100;
+/**
+ * Fehlercodes von `listReceipts` (`code` des [KasseneckApiError]), dazu die
+ * gemeinsamen Codes von Anmeldung und Rand (Kassen-Token, Live-Gate,
+ * API-Freigabe). Ein Code ausserhalb bleibt ueber `KasseneckApiError.code`
+ * lesbar. Die Regeln der ersten sieben prueft dieses Paket schon vor dem
+ * Senden (ausser `invalid_cursor`: ob ein Cursor zur Abfrage passt, weiss nur
+ * der Server).
+ */
+export declare const LIST_RECEIPTS_ERROR_CODES: readonly ["invalid_date", "invalid_range", "range_too_long", "invalid_limit", "invalid_order", "invalid_view", "invalid_cursor", "server_error"];
+export type ListReceiptsErrorCode = (typeof LIST_RECEIPTS_ERROR_CODES)[number];
+/**
+ * Eingabe von [listReceipts]. Genau eine Form des Zeitfensters: `date` ODER
+ * `from` + `to`.
+ *
+ * - `date`: ein Wiener Tag, `YYYY-MM-DD` (00:00:00 bis zum Beginn des
+ *   Folgetags). Nur mit `date` traegt die erste Seite `daySummary`.
+ * - `from` (einschliesslich) und `to` (ausschliesslich): `YYYY-MM-DD` oder
+ *   `YYYY-MM-DDTHH:mm:ss`, Wiener Wanduhr ohne Zone. Ein reines Datum heisst
+ *   Beginn dieses Tages; `to` liegt hoechstens 31 Kalendertage nach `from`.
+ *
+ * Mit `cursor` (dem `nextCursor` der Vorseite) muessen Zeitfenster, `order`
+ * und `view` gleich bleiben wie auf Seite 1, sonst antwortet der Server
+ * `invalid_cursor`; `limit` darf sich aendern.
+ */
+export type ListReceiptsOptions<V extends ListReceiptsView = ListReceiptsView> = ListReceiptsWindow & {
+    /** Seitengroesse, ganze Zahl 1-500; ohne Angabe 100. */
+    limit?: number;
+    /** Ohne Angabe `desc` (neueste zuerst). */
+    order?: ListReceiptsOrder;
+    /** Ohne Angabe `summary`. */
+    view?: V;
+    /** `nextCursor` der vorigen Seite. */
+    cursor?: string;
+};
+/** Zeitfenster von [ListReceiptsOptions]: ein Tag oder ein Zeitraum. */
+export type ListReceiptsWindow = {
+    date: string;
+    from?: undefined;
+    to?: undefined;
+} | {
+    from: string;
+    to: string;
+    date?: undefined;
+};
+/** Brutto je RKSV-Satzgruppe in Cent (`amountRateStandard` bis `amountRateSpecial` am Beleg). */
+export interface ListReceiptsGrossByRate {
+    standard: number;
+    reduced1: number;
+    reduced2: number;
+    zero: number;
+    special: number;
+}
+/**
+ * Zeile eines Belegs in [listReceipts] mit `view: 'summary'`. Betraege in
+ * ganzen Cent. Kein Layout, kein Kopf, keine Positionen und keine
+ * Pruefangaben: fuer die Detailansicht `getReceipt`, fuer die PDF
+ * `downloadReceipt` mit `fullReceiptId`.
+ *
+ * Nicht zu verwechseln mit [ReceiptSummary] von `listMyReceipts` (Kassenweg,
+ * andere Felder, Betrag dort aus Euro gerechnet).
+ *
+ * `receiptType` und `paymentMethod` sind wie ueberall beim Lesen der bekannte
+ * Enum-Eintrag oder der rohe Schluessel; ein Wert, den dieses Paket nicht
+ * kennt, laesst die Liste nicht scheitern.
+ */
+export interface ListReceiptsSummary {
+    receiptId: string | null;
+    /** Fortlaufender Belegzaehler der Kasse; `null` bei Alt-Belegen. */
+    counter: number | null;
+    receiptType: ReceiptType | string | null;
+    /** Nur am Nullbeleg: Anlass (`manual`, wenn der Beleg keinen nennt); sonst `null`. */
+    zeroKind: ZeroKind | string | null;
+    /** Roher Belegzeitstempel (Wiener Wanduhr); Deutung ueber `parseServerTimeStamp`. */
+    timeStamp: string | null;
+    /** Summe von `grossByRateCents`; negativ am Storno-Beleg. */
+    totalCents: number;
+    grossByRateCents: ListReceiptsGrossByRate;
+    /** `mixed` bei mehreren Zahlungen (die stehen dann in `payments`). */
+    paymentMethod: KeckPaymentMethod | string | null;
+    /** Nur wenn der Beleg eine Zahlungsliste traegt; ohne Anbieterdaten. */
+    payments?: ReceiptPayment[];
+    /** Nur wenn der Beleg Trinkgeld traegt. */
+    tipCents?: number;
+    /** Bediener (nur der Name), oder `null`. */
+    operator: {
+        name: string;
+    } | null;
+    /** Nur am Storno-Beleg: das Original. */
+    cancellationOf: {
+        receiptId: string | null;
+        timeStamp: string | null;
+    } | null;
+    cancellationReason: CancellationReason | string | null;
+    /**
+     * Storno-Stand: `none`, `partial` oder `full` (nur an Normalbelegen anders
+     * als `none`). Ein Wert, den dieses Paket nicht kennt, kommt als
+     * `'unknown'` an, nie still als `none`: dann keinen Storno anbieten, bis
+     * der Beleg einzeln gelesen ist.
+     */
+    cancellationStatus: CancellationStatus | 'unknown';
+    /** Mit funktionierender Signatureinheit ausgestellt (`signatureSuccess !== false`). */
+    signatureOk: boolean;
+    /** Eigene Referenz des Aufrufers am Beleg, oder `null`. */
+    customProjectId: string | null;
+    /** Schluessel fuer `downloadReceipt` und den Beleg-Link, oder `null`. */
+    fullReceiptId: string | null;
+}
+/** 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;
+/**
+ * Tagessumme aus der Tagesstatistik der Kasse, nur bei `date` und nur auf
+ * der ersten Seite. **Nicht die Summe der Liste:** `receiptCount` zaehlt jeden
+ * Beleg des Tages (auch Null-, Start- und Trainingsbelege), `revenueCents`
+ * nur Normal- und Storno-Belege, ohne Mitarbeiter-Trinkgeld und nach
+ * Aktionsrabatt. Wer die Liste summieren will, summiert die Liste.
+ */
+export interface ListReceiptsDaySummary {
+    date: string;
+    receiptCount: number;
+    revenueCents: number;
+    /** Je Steuersatz (Basispunkte, 2000 = 20 %), hoechster zuerst; Saetze ohne Umsatz fehlen. */
+    revenueByRate: Array<{
+        rateBp: number;
+        grossCents: number;
+    }>;
+}
+/** Eine Seite von [listReceipts]. */
+export interface ListReceiptsPage<V extends ListReceiptsView = 'summary'> {
+    receipts: Array<ListedReceipt<V>>;
+    /** Es gibt weitere Belege: mit `cursor: nextCursor` weiterlesen. */
+    hasMore: boolean;
+    /** `null`, wenn `hasMore` false ist. */
+    nextCursor: string | null;
+    /**
+     * Nur bei `date` auf der ersten Seite (ohne `cursor`); `null`, wenn es fuer
+     * den Tag keine Statistik gibt. Auf allen anderen Seiten fehlt das Feld.
+     */
+    daySummary?: ListReceiptsDaySummary | null;
+    /**
+     * Nur bei `view: 'full'`: Firmendaten fuer den Belegkopf (Nachdruck), dieselben Felder wie
+     * `getReportV2().metadata`. Bei der Kurzansicht fehlt das Feld.
+     */
+    metadata?: V extends 'full' ? ReportV2Metadata : never;
+}
+/** Zeile `view: summary` vom Draht. */
+export declare function fromListReceiptsSummaryPayload(payload: Record<string, unknown>): ListReceiptsSummary;
+/**
+ * Eine Seite Belege der angemeldeten Kasse (`listReceipts`). Die Eingabe wird
+ * vor dem Senden nach den Regeln des Servers geprueft (genau eine Form des
+ * Zeitfensters, Datumsformat, hoechstens 31 Kalendertage, `limit` 1-500,
+ * `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].
+ * Alle Seiten auf einmal: [listAllReceipts].
+ */
+export declare function listReceipts<V extends ListReceiptsView = 'summary'>(transport: InternerTransport, options: ListReceiptsOptions<V>): Promise<ListReceiptsPage<V>>;
+/**
+ * Alle Belege eines Tages oder Zeitraums, Seite fuer Seite: holt mit
+ * [listReceipts] die erste Seite, dann mit `cursor: nextCursor` und
+ * demselben Zeitfenster, `order` und `view` jede weitere, und liefert jeden
+ * Beleg einzeln, in der Reihenfolge des Servers. Jeder Beleg des Fensters
+ * kommt genau einmal.
+ *
+ * Ohne `limit` holt der Helfer Seiten zu 500 (weniger Aufrufe als die
+ * Vorgabe 100 des Servers). Mit `cursor` setzt er an dieser Stelle fort.
+ *
+ * Ein Fehler auf irgendeiner Seite bricht ab (der Fehler kommt im
+ * `for await` an); die bis dahin gelieferten Belege bleiben gueltig. Nach
+ * [LIST_ALL_RECEIPTS_MAX_PAGES] Seiten, oder wenn der Server denselben
+ * Cursor zweimal nennt, bricht er mit [KasseneckValidationError]
+ * (`scope: 'response'`) ab, statt endlos zu laufen.
+ *
+ * `daySummary` liefert der Helfer nicht; wer sie braucht, ruft die erste
+ * Seite mit [listReceipts].
+ */
+export declare function listAllReceipts<V extends ListReceiptsView = 'summary'>(transport: InternerTransport, options: ListReceiptsOptions<V>): AsyncGenerator<ListedReceipt<V>, void, undefined>;