@kreiseck/kasseneck-api 1.7.1 → 1.8.0

package/CHANGELOG.md

@@ -4,6 +4,112 @@ 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.8.0
+
+Stocktake (Lager-Kern stage 3): `./inventory` gains the twelve stocktake
+endpoints of the inventory API, `./pos` the five calls for counting at the
+register. Reason: a business that counts its stock had only the old
+"set the stock to this number" adjustment, which knows no expected quantity
+at the time of the count, no several counts per article, no blind count and
+no record. The backend now runs a stocktake as its own process (count, review,
+recount, close in parts, PDF record with the state of the ledger seal), and
+shops, the web register and the app need it through the package.
+
+Additive at runtime; existing calls send the same bytes as in 1.7.1. As in
+1.6.0, the unions `InventoryEndpoint`, `InventoryErrorCode`,
+`InventoryWarningCode`, `PosErrorCode`, `ApiCall`, `PublicCall`, `PosCall`,
+`MessageKey`, `LabelKey` and the error code unions derived from the
+authentication codes (see Contract below) gain members, so an exhaustive `switch` with a
+`never` check needs the new cases.
+
+- **Inventory API**: `createStocktake`, `listStocktakes`/`iterateStocktakes`
+  (without `updatedSince` the most recently changed first; with `updatedSince`
+  sorted by `updatedAt` ascending and inclusive, like `listArticles`),
+  `getStocktake` (with `progress.counted`), `listStocktakeItems`/
+  `iterateStocktakeItems` (`openOnly`), `recordStocktakeCount`,
+  `voidStocktakeCount`, `listStocktakeCounts`/`iterateStocktakeCounts`,
+  `reviewStocktake`, `recountStocktake`, `closeStocktake` (answers
+  `{ stocktake, warnings }`), `cancelStocktake` and `getStocktakePdf`. Models
+  `Stocktake`, `StocktakeItem`, `StocktakeCount` and their parts; the result
+  fields of a closed stocktake (`totals`, `warnings`, `seal`, `checksum`,
+  `inventoryAsOf`, `pdf`) and the expected quantity of an item
+  (`expectedQuantity`, `differenceQuantity`, `needsCheck` …) are present only
+  when the server sends them: never before `review` (blind), values only with
+  `costs`. A missing count, quantity, round or list of counters, and an actor
+  that is not an object, are response errors, never `0` or "nobody".
+  `StocktakeItem.serialNumbers` is present only when the server sends it (the
+  answer of counting and voiding omits it), never invented as `[]`.
+- **The record**: `getStocktakePdf` returns `{ kind: 'pdf', pdf }` (the bytes,
+  up to 9 MiB) or `{ kind: 'download', download: { url, expiresAt, sizeBytes,
+  sha256, fileName, contentType } }` (a signed link for 15 minutes above
+  that). It reads the answer as bytes like the report downloads and accepts
+  either a PDF or a success envelope. The transport for it is public:
+  `createPdfOrDataTransport(options)` at the package root (types
+  `KasseneckPdfOrDataTransport`, `PdfOrData`), so the free function
+  `getStocktakePdf(transport, stocktakeId)` works outside the client too, as
+  `getInvoicePdf` does with `createBinaryTransport`.
+- **Counting at the register** (`./pos`, register path only):
+  `listMyStocktakes`, `listMyStocktakeItems`, `listMyStocktakeCounts`,
+  `recordMyStocktakeCount`, `voidMyStocktakeCount`, with the same models.
+  `parseQuantityMilli(text, unit, rule?)` turns the typed quantity into
+  thousandths without floating point (comma or point, at most three decimals;
+  a point with exactly three digits after a non-zero whole part, `'1.000'`,
+  is ambiguous and `null` for every unit; pieces, by the stored `rule` of the
+  article or else by the unit, whole numbers without separator only); its
+  cases are shared with the Dart twin in the new
+  `fixtures/stocktake-quantity-cases.json`.
+  Messages and labels `stocktake.*` for the counting screen in the catalogue
+  (`fixtures/pos-texts.json`).
+- **Idempotency and outcome**: every write takes `idempotencyKey` (refused
+  before sending without a valid one). `createStocktake`, `recordStocktakeCount`,
+  `voidStocktakeCount`, `reviewStocktake`, `recountStocktake`, `closeStocktake`,
+  `cancelStocktake`, `recordMyStocktakeCount` and `voidMyStocktakeCount` are in
+  `UNKNOWN_OUTCOME_CALLS`: after `outcome: 'unknown'` resend with the **same**
+  key, a count is then counted once. The eight reads are in the list without
+  effect.
+- **Checked before sending**, nothing else: the key, `stocktakeId`,
+  `articleId`, `countId`, `locationId`, `scope` as an object, an integer
+  `quantity`, a non-empty `reason`, a non-empty `items` list with `articleId`
+  for a recount, `serialNumbers` as a list, `uncountedAsZero` as a boolean.
+  The limits (5000 items, 200 per recount, 200 counts per item and round) are
+  left to the server and exported as `STOCKTAKE_ITEMS_MAX`,
+  `STOCKTAKE_RECOUNT_ITEMS_MAX`, `STOCKTAKE_COUNTS_PER_ITEM_MAX`.
+- **Catalogues**: `STOCKTAKE_STATUSES`, `STOCKTAKE_TYPES`,
+  `STOCKTAKE_SCOPE_TYPES`, `STOCKTAKE_CHECK_REASONS`,
+  `STOCKTAKE_NOT_BOOKED_REASONS`, `STOCKTAKE_SOURCES`, `STOCKTAKE_ACTOR_TYPES`,
+  `STOCKTAKE_INVENTORY_AS_OF`, each the contract catalogue in its order.
+- **Errors**: `INVENTORY_ERROR_CODES` appends `stocktake_not_found`,
+  `stocktake_not_open`, `stocktake_closed`, `stocktake_not_in_review`,
+  `stocktake_closing`, `stocktake_location_busy` (with `data.stocktakeId`, read
+  by the new `inventoryBusyStocktakeId(error)`), `stocktake_review_running`,
+  `stocktake_recount_open`, `article_not_in_scope`, `article_not_tracked`,
+  `count_not_found`, `count_already_voided`, `serial_already_counted`,
+  `too_many_counts` and `stocktake_not_closed`; `INVENTORY_WARNING_CODES`
+  appends `defect_capped`, `uncounted_items`, `not_booked` and
+  `recount_uncounted`. `POS_ERROR_CODES` gains the codes of the five register
+  calls.
+- **Contract**: `fixtures/v3/` pulled from the backend at the state of the
+  stocktake (keck #633, #634); the vocabulary of `./stored` regenerated
+  (fingerprint only). The contract also lists `app_check_missing` and
+  `app_check_invalid` among the authentication codes (App Check of the admin
+  app, refused before any handler); every list derived from them gains both:
+  `RECEIPT_ERROR_CODES`, `CANCELLATION_ERROR_CODES`,
+  `RECEIPT_EMAIL_ERROR_CODES`, `PAYMENT_ERROR_CODES`, `REGISTER_ERROR_CODES`,
+  `POS_ERROR_CODES`, `INVOICE_REQUEST_ERROR_CODES`,
+  `INVENTORY_REQUEST_ERROR_CODES` (and their unions) and
+  `PAYMENT_CALL_REJECTED_CODES`, so they stay `rejected` on the money calls
+  (the Dart twin's `paymentCallRejectedCodes` follows). No call of this
+  package can receive them: the backend sends them only on three endpoints
+  of the admin app (App Check), none of which is public `/v3`, on the register
+  path or wrapped here; the lists follow the contract so that their guards
+  stay derived from it.
+- **Counts**: `PUBLIC_CALLS` 92 → 104, `POS_CALLS` 28 → 33 (27 register-only
+  names).
+- **Twin check**: the source fingerprint of `functions-kasse/kasse-settings-core.js`
+  in `test/fixtures/stored-zwillinge.json` follows the backend, which only added
+  functions after `mische` (card provider and auto-logout per device); the
+  behaviour comparison of `./stored` against the backend is unchanged and green.
+
 ## 1.7.1
 
 `ReceiptSheetLines` pins `letter-spacing` and `word-spacing` to 0. Reason:

package/README.md

@@ -893,6 +893,48 @@ errors such as `location_not_found` and `location_inactive` are in
 `RETURN_DISPOSITION_LABELS` gives the label of each return choice
 (`labelText(RETURN_DISPOSITION_LABELS.restock)` is "Zurück ins Lager").
 
+**Counting a stocktake at the register.** Five calls on the register path,
+permissions `stocktakeCount` (count, void own counts) and `stocktakeClose`
+(also void other people's counts; the expected quantity from `review` on).
+Creating, reviewing and closing happen in the panel or through the inventory
+API, not at the register.
+
+```ts
+import { listMyStocktakes, listMyStocktakeItems, recordMyStocktakeCount, voidMyStocktakeCount, parseQuantityMilli, messageText, labelText } from '@kreiseck/kasseneck-api/pos';
+
+const [open] = await listMyStocktakes(transport, { locationId: 'haupt' });
+if (!open) showHint(messageText('stocktake.none_open'));
+const { items } = await listMyStocktakeItems(transport, { stocktakeId: open!.id, openOnly: true });
+const quantity = parseQuantityMilli('0,25', 'kg', article.quantityRule); // 250; null for invalid input
+if (quantity === null) showHint(messageText('stocktake.quantity_invalid'));
+const key = crypto.randomUUID();                            // keep it for "Erneut senden"
+const { count, item } = await recordMyStocktakeCount(transport, {
+  idempotencyKey: key, stocktakeId: open!.id, articleId: items[0]!.articleId, quantity: quantity!,
+});
+await voidMyStocktakeCount(transport, { idempotencyKey: `${key}-void`, stocktakeId: open!.id, countId: count.id, reason: 'Doppelt gezählt' });
+```
+
+`parseQuantityMilli(text, unit, rule?)` turns the typed text into thousandths
+without floating point: comma or point as decimal separator, at most three
+decimals (trailing zeros do not count). A point followed by exactly three
+digits after a non-zero whole part (`'1.000'`, `'12.500'`) is `null` for every
+unit: in Austrian notation it is a thousands separator, on a keypad a decimal
+point, and a factor of 1000 would be booked as a difference; with a comma it
+is unambiguous (`'1,000'` is 1000, i.e. one unit). Pieces take whole numbers
+without any separator only. Whether an article is counted in pieces comes
+from `rule`, the stored quantity rule of the article (`PosArticle.quantityRule`,
+`'piece'` or `'decimal'`), without it from the default of the unit
+(`quantityRuleForUnit`: `Stk`, `g`, `ml` …, also when the unit is missing);
+pass `'piece'` for a serial-number article. Anything else is `null`. Its cases are shared with the Dart twin in
+`fixtures/stocktake-quantity-cases.json`. Counting works online only; after
+`outcome: 'unknown'` resend the **same** count with the **same** key
+(`labelText('stocktake.resend')`), it is counted exactly once. The texts of the
+counting screen are in the catalogue as `stocktake.*`
+(`messageText('stocktake.counted', { name, quantity })`,
+`labelText('stocktake.progress', { counted, total })`); the error codes
+(`stocktake_not_open`, `article_not_in_scope`, `count_already_voided` …) are in
+`POS_ERROR_CODES`.
+
 `stockViewOf(perms)` (also exported from the package root) tells whether a
 register user may see locations and quantities: a missing `stockView` counts
 as granted, only an explicit `false` blocks it, and the other stock
@@ -1483,7 +1525,8 @@ ones made at the register in the shop. Since 1.5.0 also the write side:
 create and update articles, book goods receipts, transfers, losses and
 condition changes, and reserve stock at checkout (see
 [Shop: reserve and invoice](#shop-reserve-and-invoice)); since 1.6.0 variant
-groups (sizes, colours, see [Variants](#variants)). Uses the `api_key` of
+groups (sizes, colours, see [Variants](#variants)); since 1.8.0 stocktakes
+(see [Stocktake](#stocktake)). Uses the `api_key` of
 the account and belongs on a **server**. Reading needs the module `lager`,
 writing additionally the account switch *Lager-API schreiben*, which Kasseneck
 turns on (always on in the test environment, `kr_test_…`; otherwise
@@ -1863,6 +1906,131 @@ function onDelivery(rawBody: Buffer) {
   `listArticles({ variantGroupId, updatedSince })` are sorted by `updatedAt`
   ascending and include the boundary.
 
+### Stocktake
+
+A stocktake counts the stock of one location: create it (scope, key date or
+perpetual, blind by default), count (several counts of the same article are
+added up, a wrong one is voided with a reason), review (only now the expected
+quantity and the difference appear), recount single items, close (books one
+movement `stocktake` per item and stores the stocktake record as PDF) or
+cancel. The same flow runs in the panel and, for counting, at the register
+(`./pos`, below). All writes, counting included, take an `idempotencyKey`
+and the account switch *Lager-API schreiben*; values (`…Cents`, `…Micros`)
+and the PDF with values need `costs`.
+
+Example: Bäckerei Kornblum has 40 Kornspitz at the location `haupt`. At
+10:00:00 the register sells 3, the stock movement is booked a few seconds
+late at 10:00:03. At 10:00:02 Livia Lindmayr counts 37 on the shelf.
+
+```ts
+import { createInventoryClient, inventoryBusyStocktakeId, isInventoryError } from '@kreiseck/kasseneck-api/inventory';
+import { parseQuantityMilli } from '@kreiseck/kasseneck-api/pos';
+
+const inventory = createInventoryClient({ apiKey: process.env.KASSENECK_API_KEY! });
+
+// 1. One open stocktake per location; reuse it if there is one.
+let stocktakeId: string;
+try {
+  const created = await inventory.createStocktake({
+    idempotencyKey: 'shop-stocktake-haupt-2026-12',
+    locationId: 'haupt',
+    scope: { type: 'groups', groupIds: ['gebaeck'] },
+    type: 'key_date',
+    keyDate: '2026-12-31',            // blind: true is the default
+  });
+  stocktakeId = created.id;           // status: 'counting'
+} catch (error) {
+  const busy = inventoryBusyStocktakeId(error);
+  if (!busy) throw error;
+  stocktakeId = busy;
+}
+
+// 2. Count. Quantities in thousandths: "37" pieces -> 37000, "0,25" kg -> 250.
+const kornspitz = await inventory.lookupArticleByCode('9001234567896');
+const { item } = await inventory.recordStocktakeCount({
+  idempotencyKey: 'shelf-a-kornspitz-1',   // after outcome 'unknown': resend with the SAME key
+  stocktakeId,
+  articleId: kornspitz.id,
+  quantity: parseQuantityMilli('37', kornspitz.unit)!,
+});
+// item.quantity: 37000 (sum of the round), no expectedQuantity while counting
+
+// 3. Review: computed in the background, poll until complete.
+await inventory.reviewStocktake({ idempotencyKey: 'review-1', stocktakeId });
+let stocktake = await inventory.getStocktake(stocktakeId);
+while (!stocktake.review?.complete) {
+  await new Promise((r) => setTimeout(r, 2000));
+  stocktake = await inventory.getStocktake(stocktakeId);
+}
+for await (const it of inventory.iterateStocktakeItems({ stocktakeId })) {
+  // Kornspitz: expectedQuantity 37000, differenceQuantity 0 (the sale at
+  // 10:00:00 was booked after the count, but it happened before it)
+  if (it.needsCheck) console.log(it.articleId, it.checkReasons);
+}
+
+// 4. Close (books in parts in the background), then fetch the record.
+const { warnings } = await inventory.closeStocktake({ idempotencyKey: 'close-1', stocktakeId });
+// … poll getStocktake until status === 'closed' …
+const pdf = await inventory.getStocktakePdf(stocktakeId);
+if (pdf.kind === 'pdf') await save('stocktake.pdf', pdf.pdf);
+else await download(pdf.download.url, pdf.download.sha256);   // over 9 MiB: signed link, 15 minutes
+```
+
+- **Reference time.** The expected quantity of an item is the stock at the
+  time of its last count (server time; the device clock never counts), taken
+  from the stock ledger, including sales that happened before the count but
+  were booked after it (within 3 days). In the example the expected quantity
+  is 37, the difference 0, and closing changes nothing. Had the 3 Kornspitz
+  been sold at 10:00:05, after the count, the expected quantity would be 40
+  and the difference −3: closing books −3 on today's stock (37 after the
+  sale), which leaves 34. Each piece is deducted exactly once.
+- **Blind.** Before `review` no response carries an expected quantity, a
+  difference or `needsCheck`; the fields are absent, not `null`. With
+  `blind: false` the items carry `bookStockNow` while counting: today's book
+  stock, never the expected quantity at the reference time.
+- **Counting.** `quantity` in thousandths, `0` means counted empty. Pieces
+  and serial-number articles take whole pieces only, serial-number articles
+  exactly one serial number per piece (`serial_required`,
+  `serial_already_counted`). Scope `all` adds a tracked article that was not
+  listed (`addedLater`); scopes `groups` and `articles` answer
+  `article_not_in_scope`. While counting or recounting, `voidStocktakeCount`
+  with a reason takes a count back; the item is summed up again.
+- **Recount.** In `review`, `recountStocktake({ items, reason })` starts a new
+  round for the named items (old counts stay, but no longer count); count
+  them, then call `reviewStocktake` again. `closeStocktake` refuses with
+  `stocktake_recount_open` while recounts are open.
+- **Closing.** Only from `review` (`stocktake_not_in_review`) and only once the
+  review has finished computing: while `review.complete` is `false`,
+  `closeStocktake` and `recountStocktake` answer `stocktake_review_running`
+  (poll `getStocktake` and try again). Uncounted items
+  are not booked and appear as "not counted" in the record; with
+  `uncountedAsZero: true` they are booked as 0. The answer usually has
+  `status: 'closing'` with `closing.parts` and `closing.bookedParts`; calling
+  `closeStocktake` again while it is closing resumes it. After `closed`, the
+  head carries `totals`, `warnings` (`uncounted_items`, `not_booked`,
+  `defect_capped`), `seal` (the state of the stock ledger seal), `checksum`
+  and `pdf`; `closeStocktake` itself may warn `recount_uncounted`. Each
+  booking reaches webhooks as `stock.changed` with `cause: 'stocktake'`;
+  there is no `stocktake.*` event.
+- **Lists.** `listStocktakes()` without `updatedSince` returns the most
+  recently changed first (an open stocktake is not necessarily on top; filter
+  with `status`). With `updatedSince` it is sorted by `updatedAt` ascending
+  and includes the boundary, like `listArticles`: remember the largest
+  `updatedAt` and ask again. `listStocktakeItems({ stocktakeId, openOnly })`
+  and `listStocktakeCounts({ stocktakeId, articleId })` page with `cursor`;
+  the `iterate…` variants follow `nextCursor` in the same order.
+- **The record.** `getStocktakePdf` exists only after closing
+  (`stocktake_not_closed`, also for a cancelled stocktake). With `costs` it is
+  the version with values, otherwise the one with quantities only. Up to
+  9 MiB the file comes in the answer (`kind: 'pdf'`), above that as a signed
+  link for 15 minutes (`kind: 'download'`, with `sizeBytes` and `sha256`; check
+  the downloaded file against `sha256`).
+- **Limits.** At most `STOCKTAKE_ITEMS_MAX` (5000) items per stocktake
+  (`too_many_positions`; count larger stocks in several stocktakes one after
+  another), `STOCKTAKE_RECOUNT_ITEMS_MAX` (200) items per recount and
+  `STOCKTAKE_COUNTS_PER_ITEM_MAX` (200) counts per item and round
+  (`too_many_counts`). The server checks them, not the client.
+
 ## Migrating from 0.x
 
 1.0 is one breaking step: the wire, the exported names and the contract files
@@ -1946,6 +2114,7 @@ in machine form what both sides agreed on, among them:
 | `pos-message-cases.json` | error cases and the message each one must show in both registers | by hand |
 | `receipt-due-generated.json` | 1206 amounts due computed by the backend's own code, the reference for `receiptDueCents` | `node scripts/v3-zahlbetrag-generieren.mjs` |
 | `receipt-due-errors.json` | input the amount due cannot be computed from, with the `reason` of the `ReceiptDueError` each one throws | by hand |
+| `stocktake-quantity-cases.json` | typed quantities and the thousandths `parseQuantityMilli` makes of them (or `null`), per unit | by hand |
 | `v3/` | the backend's `/v3` contract (vocabulary, response cases, stored cases, amounts due), copied byte for byte | `node scripts/v3-vertrag-holen.mjs` |
 | `renames-1.0.json` | everything in these files that changed from 0.x to 1.0: paths (`files`), text catalogue keys (`texts`), placeholders, structural keys (`structure`), machine values (`values`), shape changes (`shapes`); rendered texts are unchanged | `npm run fixtures:umbenennung` |
 

package/dist/cjs/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 { 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", "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"];
+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", "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", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount"];
 export type ApiCall = typeof ALL_CALLS[number];
 /**
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -21,14 +21,14 @@ 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", "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"];
+export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "cancelReceipt", "sendReceiptEmail", "generateFullReceiptId", "downloadReceipt", "getFirstReceiptDate", "getReportV2", "downloadReport", "downloadDailyReport", "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"];
 /**
  * Die Endpunkte des Kassenwegs (`https://kasse.kasseneck.at/api/v3/<name>`,
  * Web-Kasse: gleicher Ursprung `/api/v3`), in der Reihenfolge von
  * `endpoints.register`. Sechs davon sind zugleich oeffentlich; die Kasse ruft
  * sie trotzdem ueber diesen Weg (ein Dialekt je Client, Nachtrag §5.2).
  */
-export declare const POS_CALLS: readonly ["pairRegisterDevice", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "registerUserLogin", "registerPinLogin", "renewRegisterSession", "endRegisterSession", "unpairRegisterDevice", "listMyCashregisters", "listMyReceipts", "getReceipt", "createReceipt", "generateFullReceiptId", "cancelReceipt", "sendReceiptEmail", "listMyArticleGroups", "listMyArticles", "getKasseSettings", "setMyKasseSettings", "setMyKasseLogo", "setMyRegisterDeviceSettings", "listMyPrinters", "createPrintJob", "getPrintJob", "listMyTipRecipients", "listMyStockLocations", "listMyStock", "setMyCashregisterStockLocation"];
+export declare const POS_CALLS: readonly ["pairRegisterDevice", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "registerUserLogin", "registerPinLogin", "renewRegisterSession", "endRegisterSession", "unpairRegisterDevice", "listMyCashregisters", "listMyReceipts", "getReceipt", "createReceipt", "generateFullReceiptId", "cancelReceipt", "sendReceiptEmail", "listMyArticleGroups", "listMyArticles", "getKasseSettings", "setMyKasseSettings", "setMyKasseLogo", "setMyRegisterDeviceSettings", "listMyPrinters", "createPrintJob", "getPrintJob", "listMyTipRecipients", "listMyStockLocations", "listMyStock", "setMyCashregisterStockLocation", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount"];
 export type PublicCall = typeof PUBLIC_CALLS[number];
 export type PosCall = typeof POS_CALLS[number];
 /**
@@ -49,7 +49,7 @@ export type PosCall = typeof POS_CALLS[number];
  * [ALL_CALLS], [PUBLIC_CALLS] und [POS_CALLS] steht entweder hier oder in
  * [CALLS_WITHOUT_EFFECT] (Waechter `test/ausgang-einordnung.test.ts`).
  */
-export declare const UNKNOWN_OUTCOME_CALLS: readonly ["activateCashregister", "addVariant", "cancelInvoice", "cancelReceipt", "changeStockCondition", "createArticle", "createCreditNote", "createCustomer", "createCustomerCashregister", "createInvoiceItem", "createPartnerCustomer", "createPartnerWebhook", "createPrintJob", "createReceipt", "createReservation", "createVariantGroup", "createWebhook", "deactivateArticle", "deletePartnerWebhook", "deleteWebhook", "extendReservation", "financeWebService", "hobexPayApi", "hobexRefundApi", "issueInvoice", "pairRegisterDevice", "receiveGoods", "recordInvoicePayment", "recordStockLoss", "releaseReservation", "reportCustomerContract", "requestCustomerSignature", "reverseStockMovement", "revokeCustomerMandate", "rotatePartnerWebhookSecret", "rotateWebhookSecret", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "sendWebhookTest", "setCustomerMandate", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "transferStock", "unpairRegisterDevice", "updateArticle", "updateCustomer", "updateInvoiceItem", "updatePartnerWebhook", "updateVariantGroup", "updateWebhook", "withdrawInvoiceItem"];
+export declare const UNKNOWN_OUTCOME_CALLS: readonly ["activateCashregister", "addVariant", "cancelInvoice", "cancelReceipt", "cancelStocktake", "changeStockCondition", "closeStocktake", "createArticle", "createCreditNote", "createCustomer", "createCustomerCashregister", "createInvoiceItem", "createPartnerCustomer", "createPartnerWebhook", "createPrintJob", "createReceipt", "createReservation", "createStocktake", "createVariantGroup", "createWebhook", "deactivateArticle", "deletePartnerWebhook", "deleteWebhook", "extendReservation", "financeWebService", "hobexPayApi", "hobexRefundApi", "issueInvoice", "pairRegisterDevice", "receiveGoods", "recordInvoicePayment", "recordMyStocktakeCount", "recordStockLoss", "recordStocktakeCount", "recountStocktake", "releaseReservation", "reportCustomerContract", "requestCustomerSignature", "reverseStockMovement", "reviewStocktake", "revokeCustomerMandate", "rotatePartnerWebhookSecret", "rotateWebhookSecret", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "sendWebhookTest", "setCustomerMandate", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "transferStock", "unpairRegisterDevice", "updateArticle", "updateCustomer", "updateInvoiceItem", "updatePartnerWebhook", "updateVariantGroup", "updateWebhook", "voidMyStocktakeCount", "voidStocktakeCount", "withdrawInvoiceItem"];
 /** Warum ein Aufruf keine Wirkung hat, die ein Zeitlimit offen lassen koennte. */
 export type CallWithoutEffectReason = 'read' | 'repeatable';
 /**
@@ -85,10 +85,10 @@ export declare const CALLS_WITHOUT_EFFECT: Readonly<Record<string, CallWithoutEf
  * absetzt, sagt es mit `hasEffect: true`.
  */
 export declare function isUnknownOutcomeCall(name: string): boolean;
-/** Einer der 28 Aufrufe des Kassenwegs. */
+/** Einer der 33 Aufrufe des Kassenwegs. */
 export declare function isPosCall(name: string): boolean;
 /**
- * Nur ueber den Kassenweg erreichbar (22 Namen): unter `api.kasseneck.at/v3`
+ * Nur ueber den Kassenweg erreichbar (27 Namen): unter `api.kasseneck.at/v3`
  * gibt es sie nicht. Der Transport schickt sie darum ohne eigene Basis an
  * [POS_BASE_URL] statt an die oeffentliche Basis.
  */
@@ -97,3 +97,5 @@ export declare function isPosOnlyCall(name: string): boolean;
 export type InternerTransport = <T = unknown>(functionName: ApiCall, params?: Record<string, unknown>, extraBodyFields?: TransportBodyFields, secretParams?: readonly string[], options?: TransportCallOptions) => Promise<T>;
 /** Wie [KasseneckBinaryTransport], nur mit bekanntem Aufrufnamen. */
 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>;

package/dist/cjs/client/aufrufe.js

@@ -111,6 +111,25 @@ exports.ALL_CALLS = [
     'getVariantGroup',
     'listVariantGroups',
     'addVariant',
+    // Lager-API Inventur (Lager-Kern Stufe 3, ./inventory)
+    'createStocktake',
+    'listStocktakes',
+    'getStocktake',
+    'listStocktakeItems',
+    'recordStocktakeCount',
+    'voidStocktakeCount',
+    'listStocktakeCounts',
+    'reviewStocktake',
+    'recountStocktake',
+    'closeStocktake',
+    'cancelStocktake',
+    'getStocktakePdf',
+    // Inventur zaehlen an der Kasse (Lager-Kern Stufe 3, ./pos)
+    'listMyStocktakes',
+    'listMyStocktakeItems',
+    'listMyStocktakeCounts',
+    'recordMyStocktakeCount',
+    'voidMyStocktakeCount',
 ];
 /**
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -217,6 +236,19 @@ exports.PUBLIC_CALLS = [
     'getVariantGroup',
     'listVariantGroups',
     'addVariant',
+    // Lager-API Inventur (Lager-Kern Stufe 3), umhuellt in `./inventory`.
+    'createStocktake',
+    'listStocktakes',
+    'getStocktake',
+    'listStocktakeItems',
+    'recordStocktakeCount',
+    'voidStocktakeCount',
+    'listStocktakeCounts',
+    'reviewStocktake',
+    'recountStocktake',
+    'closeStocktake',
+    'cancelStocktake',
+    'getStocktakePdf',
 ];
 /**
  * Die Endpunkte des Kassenwegs (`https://kasse.kasseneck.at/api/v3/<name>`,
@@ -254,6 +286,12 @@ exports.POS_CALLS = [
     'listMyStockLocations',
     'listMyStock',
     'setMyCashregisterStockLocation',
+    // Inventur zaehlen (Lager-Kern Stufe 3): nur ueber den Kassenweg.
+    'listMyStocktakes',
+    'listMyStocktakeItems',
+    'listMyStocktakeCounts',
+    'recordMyStocktakeCount',
+    'voidMyStocktakeCount',
 ];
 /**
  * Die Aufrufe **mit Wirkung**, alphabetisch: sie legen etwas an, aendern oder
@@ -278,7 +316,9 @@ exports.UNKNOWN_OUTCOME_CALLS = [
     'addVariant',
     'cancelInvoice',
     'cancelReceipt',
+    'cancelStocktake',
     'changeStockCondition',
+    'closeStocktake',
     'createArticle',
     'createCreditNote',
     'createCustomer',
@@ -289,6 +329,7 @@ exports.UNKNOWN_OUTCOME_CALLS = [
     'createPrintJob',
     'createReceipt',
     'createReservation',
+    'createStocktake',
     'createVariantGroup',
     'createWebhook',
     'deactivateArticle',
@@ -302,11 +343,15 @@ exports.UNKNOWN_OUTCOME_CALLS = [
     'pairRegisterDevice',
     'receiveGoods',
     'recordInvoicePayment',
+    'recordMyStocktakeCount',
     'recordStockLoss',
+    'recordStocktakeCount',
+    'recountStocktake',
     'releaseReservation',
     'reportCustomerContract',
     'requestCustomerSignature',
     'reverseStockMovement',
+    'reviewStocktake',
     'revokeCustomerMandate',
     'rotatePartnerWebhookSecret',
     'rotateWebhookSecret',
@@ -328,6 +373,8 @@ exports.UNKNOWN_OUTCOME_CALLS = [
     'updatePartnerWebhook',
     'updateVariantGroup',
     'updateWebhook',
+    'voidMyStocktakeCount',
+    'voidStocktakeCount',
     'withdrawInvoiceItem',
 ];
 /**
@@ -382,6 +429,8 @@ exports.CALLS_WITHOUT_EFFECT = Object.freeze({
     getReportV2: 'read',
     getReservation: 'read',
     getStock: 'read',
+    getStocktake: 'read',
+    getStocktakePdf: 'read',
     getVariantGroup: 'read',
     hobexGetStatus: 'read',
     listArticles: 'read',
@@ -397,6 +446,9 @@ exports.CALLS_WITHOUT_EFFECT = Object.freeze({
     listMyReceipts: 'read',
     listMyStock: 'read',
     listMyStockLocations: 'read',
+    listMyStocktakeCounts: 'read',
+    listMyStocktakeItems: 'read',
+    listMyStocktakes: 'read',
     listMyTipRecipients: 'read',
     listPartnerCustomers: 'read',
     listPartnerWebhookDeliveries: 'read',
@@ -406,6 +458,9 @@ exports.CALLS_WITHOUT_EFFECT = Object.freeze({
     listReservations: 'read',
     listStock: 'read',
     listStockMovements: 'read',
+    listStocktakeCounts: 'read',
+    listStocktakeItems: 'read',
+    listStocktakes: 'read',
     listVariantGroups: 'read',
     listWebhookDeliveries: 'read',
     listWebhooks: 'read',
@@ -429,12 +484,12 @@ function isUnknownOutcomeCall(name) {
 const OEFFENTLICH = new Set(exports.PUBLIC_CALLS);
 const KASSENWEG = new Set(exports.POS_CALLS);
 const NUR_KASSE = new Set(exports.POS_CALLS.filter((name) => !OEFFENTLICH.has(name)));
-/** Einer der 28 Aufrufe des Kassenwegs. */
+/** Einer der 33 Aufrufe des Kassenwegs. */
 function isPosCall(name) {
     return KASSENWEG.has(name);
 }
 /**
- * Nur ueber den Kassenweg erreichbar (22 Namen): unter `api.kasseneck.at/v3`
+ * Nur ueber den Kassenweg erreichbar (27 Namen): unter `api.kasseneck.at/v3`
  * gibt es sie nicht. Der Transport schickt sie darum ohne eigene Basis an
  * [POS_BASE_URL] statt an die oeffentliche Basis.
  */

package/dist/cjs/client/errors.js

@@ -280,6 +280,8 @@ exports.PAYMENT_CALL_REJECTED_CODES = Object.freeze([
     'account_not_found',
     'live_not_enabled',
     'api_not_approved', // Live-API ohne Freigabe (Entwicklerbereich): vor dem Handler abgewiesen
+    'app_check_missing', // Admin-App ohne bzw. mit ungueltigem App Check: vor dem Handler abgewiesen
+    'app_check_invalid',
     'unauthorized',
     'mfa_required',
     'user_verification_failed',

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

@@ -1,5 +1,5 @@
 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, createTransport, createBinaryTransport, } 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, } 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, } from './receipts.js';

package/dist/cjs/client/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.getReportV2 = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.listMyCashregisters = 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.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.downloadMonthlyReport = exports.downloadDailyReport = exports.listMyCashregisters = 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;
 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; } });
@@ -10,6 +10,7 @@ Object.defineProperty(exports, "POS_BASE_URL", { enumerable: true, get: function
 Object.defineProperty(exports, "DEFAULT_TIMEOUT_MS", { enumerable: true, get: function () { return transport_js_1.DEFAULT_TIMEOUT_MS; } });
 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; } });
 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; } });

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

@@ -91,16 +91,16 @@ export interface TransportOptions {
     auth: KasseneckAuth;
     /**
      * Abweichende Basis der **oeffentlichen** Aufrufe (Vorgabe
-     * [DEFAULT_BASE_URL]): alles ausser den 28 Aufrufen des Kassenwegs, und die
+     * [DEFAULT_BASE_URL]): alles ausser den 33 Aufrufen des Kassenwegs, und die
      * sechs oeffentlichen davon nur, wenn nicht mit `registerUserAuth`
      * angemeldet. Muss auf `/v3` enden (eigene Proxys erlaubt), sonst wirft das
      * Anlegen; `/v1` oder `/api` gibt es in der 1.x-Linie nicht.
      */
     baseUrl?: string;
     /**
-     * Abweichende Basis des **Kassenwegs** (Vorgabe [POS_BASE_URL]): die 22
+     * Abweichende Basis des **Kassenwegs** (Vorgabe [POS_BASE_URL]): die 27
      * reinen Kassenaufrufe (Kopplung, Anmeldung, Einstellungen, Artikel,
-     * Drucker, ...) und mit `registerUserAuth` alle 28 Aufrufe des Kassenwegs.
+     * Drucker, ...) und mit `registerUserAuth` alle 33 Aufrufe des Kassenwegs.
      * Die Web-Kasse gibt `'/api/v3'` (gleicher Ursprung). Muss auf `/v3` enden
      * (in der Regel `/api/v3`), sonst wirft das Anlegen.
      */
@@ -193,3 +193,27 @@ export declare function createTransport(options: TransportOptions): KasseneckTra
  * reports.ts.)
  */
 export declare function createBinaryTransport(options: TransportOptions): KasseneckBinaryTransport;
+/**
+ * Ergebnis eines Aufrufs, der eine Datei **oder** eine Nutzlast liefert: das
+ * PDF als Bytes oder die `data` einer Erfolgshuelle (etwa ein Lese-Link, wenn
+ * die Datei zu gross fuer die Antwort ist).
+ */
+export type PdfOrData = {
+    pdf: Uint8Array;
+} | {
+    data: unknown;
+};
+/**
+ * Ruft eine Backend-Funktion auf, die ein PDF **oder** eine JSON-Nutzlast
+ * liefert (Inventurprotokoll: die Datei bis 9 MiB, darueber ein Lese-Link).
+ */
+export type KasseneckPdfOrDataTransport = (functionName: string, params?: Record<string, unknown>) => Promise<PdfOrData>;
+/**
+ * Dritter Einstiegspunkt, fuer Aufrufe, die eine Datei oder eine Nutzlast
+ * liefern (`getStocktakePdf` aus `./inventory`). Wie [createBinaryTransport]
+ * wird die Antwort nur als Bytes gelesen; die ersten Bytes entscheiden: `%PDF`
+ * ergibt `{ pdf }`, eine Erfolgshuelle `{ data }`, eine Fehlerhuelle denselben
+ * fachlichen Fehler wie auf dem JSON-Weg. Leer, kein JSON oder ohne Statusfeld
+ * ist unlesbar mit denselben Gruenden wie dort.
+ */
+export declare function createPdfOrDataTransport(options: TransportOptions): KasseneckPdfOrDataTransport;