@kreiseck/kasseneck-api 1.12.0 → 1.14.0

package/CHANGELOG.md

@@ -4,6 +4,35 @@ 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.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).
+
+- **Tip rule: a voucher never covers the tip.** The pre-filled voucher amount and the due amount leave the tip out (also after a promotion discount; never negative); a single-purpose voucher that covers only goods keeps its pre-fill above 0. Reason: the tip is paid in cash or by card, never by voucher; the server rejects the other case. Eight contract cases from the server (staff and owner tip, `payments[].tipCents`, promotion plus voucher, single-purpose, the boundary 20.00 accepted and 20.01 rejected) now check `receiptDueCents` and `voucherRedeemMaxCents` against the server's answer, and the tests fail on any contract case they do not know.
+- **Receipt rules of the voucher form (rule set of the vendored server package 0.35.0):** a single mask `····-{suffix}` in the item name and in the entry, the printed word changes from Promotionsgutschein to Aktionsgutschein, the rest at the voucher with the euro sign, the promotional voucher as its own line, no payment-type line when vouchers cover the whole receipt (it stays when cash is above 0), the cancellation of a covered receipt mirrors this, and old receipts (item name with `×`, long mask in `vouchers[].code`) still print without error. The server hands the receipt to the package unchanged; the preparation step of the older server is gone. Reason: both sides must set the same receipt line by line.
+- **`./stored` twin sets the stored receipt like the server** (rest at the voucher, line without quantity column, payout with reason, payout and zero-rate bucket not in the voucher list). Reason: a receipt must read the same in the list as in the detail.
+- **`cancelReceipt` accepts the cancellation of a voucher payout:** exactly one cash payment with a positive amount and no `refundOf` (the customer gives the money back); every other positive refund is still rejected before sending (with `receipt` passed and no payout entry on it, a positive single cash payment is rejected too). Reason: the server takes this form (contract case `cancel_payout_voucher`), the check for negative refunds refused it.
+- **24 labels in `LABELS`:** `quantity.at_most`/`at_least`, `receipts.number_hint`/`clear_number`/`open`, `receipt.creating`, `receipt_done.*` (sale, paid by voucher, payout, paid out), `voucher.code_mask` (`····-{suffix}`, next to the unchanged `voucher.payment_line`), `cart.close`, `nav.*` (register, receipts, vouchers, open drawer, stocktake, settings, settings locked, logout, logging out, fullscreen, fullscreen exit) and `drawer.reason_voucher_payout`. Reason: both registers kept these words in their own constants; one catalogue keeps them equal.
+- **Drawer reason `voucher_payout`** in `OPENING_REASONS` (the register reports it itself when a voucher is paid out; not in `MANUAL_OPENING_REASONS`). Reason: the server records the opening of the drawer with this reason, and the list equals the `/v3` vocabulary.
+- **Shortcut actions `shiftStatus`, `openDrawer`, `voucherPayout`** in `POS_SHORTCUT_ACTIONS`, without a default key (like `splitPayment`). The server does not hold them in its default map, so an answer without these keys reads as "no key" (empty list), never as an error and never as a guessed key. Reason: an unproven key is caught by some browser; the owner assigns one when needed.
+- **`createReceipt` keeps voucher codes out of every error:** each `vouchers[].code` goes out as a secret parameter (as typed, normalised and formatted), so the thrown message, `serverMessage` and `details` show `****` where the server quotes one of those spellings. Other spellings the server may invent are not covered. Reason: the server text may quote the code, like `checkVoucher` already guarded.
+- **Type narrowing: `RegisterDeviceUsers.settings` is `Omit<PosSettings, 'vouchers'>`.** The `listRegisterUsersForDevice` answer carries only `{business, device}`; the package no longer invents a defaulted `vouchers` block there (read `getPosSettings` after the login for it). Code that read `settings.vouchers` from this answer fails to compile and must switch to `getPosSettings`.
+- **Type `IssuedVoucher`** for `data.issuedVouchers[]` of `createReceipt` with `articleName?` (only service vouchers, `/v3`). Declared type only: no reader parses `issuedVouchers` yet.
+- **Mark a reprint as a duplicate (Nachdruck als Duplikat kennzeichnen): `markAsDuplicate(layout, printedAt)`** in `./receipt`. A pure function on `ReceiptLayout`: it returns a copy with one plain (not bold) two-column line `Duplikat am:` and the time of the reprint, placed right after the line `Beleg-ID:` (column widths 5/7, the time at the right edge like `Datum:`): on 32 characters `Duplikat am: 24.10.2026 14:10:05`, on 48 characters `Duplikat am:` and the time 17 spaces apart. `printedAt` is an instant (`Date`); the line shows it in Europe/Vienna time (EU summer time rule, `DD.MM.YYYY HH:MM:SS`, fractions cut), never in the time zone of the machine. A layout without a `Beleg-ID:` columns line (shift receipts) gets the line on top. Applying it again replaces the time (one line, the latest reprint counts); the input is never changed; an invalid `printedAt` throws `KasseneckValidationError` (`scope: 'request'`). Registers must call it on **every reprint and on "print copy"** with the print time, never on the first print and never for mail, link or PDF (the customer gets the receipt itself there), and hand the result to the same print path (`escPosLayoutBytes`, `eposPrintXml`, `receiptSheet`, React views). Reason: Erlass BMF-AV Nr. 2/2026, section 4.5.6, requires a receipt duplicate to be labelled as such (not signed again, not written to the DEP, no change to the turnover counter; a reprint of the stored receipt already meets those three). On the printer the reprint is the first print plus exactly this line, byte for byte (same code page prefix as every line, no style command). Contract file `fixtures/duplicate-cases.json` (version 2: cases with the reprint instants, around the summer time changes in March and October, 58 and 80 mm, zero receipt, cancellation, voucher redemption, with logo, without `Beleg-ID:`, applied twice; `expected/duplicate.*.hex` with the bytes) for the Dart twin, written by `npm run fixtures:duplikat`.
+- **Receipt outputs (Ausgaben eines Belegs): `logReceiptOutputs`** (root and `createKasseneckApi`, register path `/api/v3` only, with `registerUserAuth` or `apiKeyAuth`). The register reports its prints and shares of a receipt: `entries` (1-50, `RECEIPT_OUTPUT_ENTRIES_MAX`) of `{ key, receiptId, kind, at, result? }`, `kind` from `RECEIPT_OUTPUT_LOG_KINDS` (`print` first print, `reprint` duplicate, `link_shared`, `pdf_shared`), `at` as milliseconds or ISO 8601 with zone, `result` from `RECEIPT_OUTPUT_RESULTS` (`ok`, `failed`, `unclear`; required for prints). The answer `{ accepted, rejected: [{ key, code }] }` names each rejected entry with a code from `RECEIPT_OUTPUT_ENTRY_ERROR_CODES` (`receipt_not_found` also for a receipt of another register, `invalid_output_kind`, `output_time_out_of_range` only for an unreadable time, `idempotency_key_required`, `validation`; a device clock that runs wrong is never rejected, the server clamps the time to receipt time until arrival); one entry never fails the others. A call with effect (`UNKNOWN_OUTCOME_CALLS`): after an unclear outcome send the same entries with the same keys again, the server keeps each key once. Rejected before sending: no or more than 50 entries, an unknown field (top level or entry; `cashregisterId` stays with the sign-in), a missing receipt, a key outside the server's rule (8-64 characters `[A-Za-z0-9_-]`, so `rejected[].key` always equals the buffered key), a kind or result outside the catalogue, a time that is neither whole milliseconds nor ISO 8601 text with a zone (RFC 3339, up to six fraction digits; text without a zone is a register bug and fails early); `email` and `opened` go out and come back as `invalid_output_kind`, so the register's buffer drops exactly that entry. Errors of the whole request: `RECEIPT_OUTPUT_ERROR_CODES` with `isReceiptOutputError`, `receiptOutputErrorCode`, `isReceiptOutputErrorCode`, `receiptOutputFieldErrors`. Reason: Erlass BMF-AV Nr. 2/2026, section 4.2, requires the way a receipt was handed over to be documented; the server keeps the log next to the receipt (never on it, never in the DEP) and writes mail and customer opens itself.
+- **`ReceiptWithCompany.outputs?: ReceiptOutput[]`** from `getReceipt` under `/v3` (`getReceiptWithCompany`): the latest 20 outputs, newest first, each `{ kind, at, result, by: { id, name } | null, count? }` (`RECEIPT_OUTPUT_KINDS`: `print`, `reprint`, `email`, `link_shared`, `pdf_shared`, `opened`; `count` only on `opened`, the opens in that hour). Absent when the answer has no list (sale, `/api`). Read leniently: an entry without kind, time or result is dropped, an actor without id reads as `null`, an unknown kind or result stays readable; a broken log never fails reading or reprinting the receipt. `./pos` exports `RECEIPT_OUTPUT_KINDS` and `RECEIPT_OUTPUT_RESULTS` too (contract `surface.json`, `pos.receiptOutputKinds`/`receiptOutputResults`).
+- **9 labels in `LABELS` for the receipt detail:** `receipt.outputs_title` (Ausgaben), `receipt.outputs_count` ({count} Ausgaben), `receipt.output_print` (Erstdruck), `receipt.output_reprint` (Duplikat), `receipt.output_email` (E-Mail), `receipt.output_link_shared` (Link geteilt), `receipt.output_pdf_shared` (PDF geteilt), `receipt.output_opened` (Link geöffnet ({count}×)), `receipt.output_failed` (fehlgeschlagen); every kind has its label under `receipt.output_<kind>`. `receiptOutputLabel(output)` in `./pos` returns the label of the kind and never throws: `null` for a kind the package does not know (newer server), `opened` without a valid count (whole number from 1) counts as one open; it returns the kind only, the register adds `receipt.output_failed` itself when `result` is `failed`. Reason: the web register, the app register and the panel show the same row in the same words.
+- **Contract file `fixtures/receipt-outputs-cases.json`** (version 1, `npm run fixtures:ausgaben`) for the Dart twin: `outputs` read cases (raw `data.outputs` -> the list read leniently and `receiptOutputLabel` of each entry) and `logReceiptOutputs` request cases (entries -> the request body sent, or the rejection before sending with its reason: key rule, time without zone, unknown field, 0 and 51 entries, the contract case `mixed`). The tests of this package run every case, so both packages read and check the same way.
+- Contract re-fetched from the backend with `logReceiptOutputs` (register path, 42 calls, 36 only there) and the contract case `get_receipt_with_outputs`; its print layout equals `sale_cash_tendered`, so the print goldens of both channels repeat those digests.
+- Contract guards: the keys of the `registerUserLogin`/`registerPinLogin` answer and the voucher permissions are checked against the contract; the contract case `cancel_payout_voucher` (cancellation of a multi-purpose payout, both channels) is covered.
+- **Replacement data in fixtures, tests and docs** (`ATU12345675`, `91-123/4565`, invented names). Reason: no real identifiers in the repository; the goldens were redrawn.
+
+## 1.13.0
+
+Vouchers at the register, stage 3: the sentences and words of the voucher screens move into the shared text catalogue, so the web register and the app register say the same. Additive; no existing key changes.
+
+- **14 sentences in `MESSAGES`** (`voucher.reentry_needed`, `voucher.reentry_mismatch`, `voucher.not_this_voucher`, `voucher.reentry_no_permission`, `voucher.already_covered`, `voucher.payout_reason_too_long`, `voucher.payout_reason_missing`, `voucher.payout_check_first`, `voucher.sale_max_amount`, `voucher.sale_not_at_terminal`, `voucher.no_redeem_with_sale`, `voucher.code_not_on_receipt`, `cancellation.voucher_sale_cancelled`, `cancellation.promo_valid_again`) and 8 labels in `LABELS` (`voucher.apply`, `voucher.redeemable_until`, `voucher.remove_line`, `voucher.reenter_code`, `voucher.refundable_until`, `voucher.code_done`, `voucher.article`, `voucher.add`). Reason: the web register kept these words in its own constant until the catalogue had keys for them; both registers now take them from here, and the contract file `fixtures/pos-texts.json` carries them to the app.
+
 ## 1.12.0
 
 Vouchers in the new form at the register (multi-purpose, single-purpose, service, promotional; code shown once). Additive for existing calls, with three notes for callers:

package/README.md

@@ -407,6 +407,7 @@ the received body.
 | `CANCELLATION_ERROR_CODES` | `isCancellationError` | `cancelReceipt` |
 | `PAYMENT_ERROR_CODES` | `isPaymentError` | `payments[]` of a sale or cancellation |
 | `RECEIPT_EMAIL_ERROR_CODES` | `isReceiptEmailError` | `sendReceiptEmail` |
+| `RECEIPT_OUTPUT_ERROR_CODES` | `isReceiptOutputError` | `logReceiptOutputs` (each rejected entry: `RECEIPT_OUTPUT_ENTRY_ERROR_CODES`) |
 | `REGISTER_ERROR_CODES` | `isRegisterError` (`…/register`) | pairing and sign-in |
 | `POS_ERROR_CODES` | `isPosError` (`…/pos`) | settings, articles, printers, tip recipients |
 | `PARTNER_ERROR_CODES` + `PARTNER_REQUEST_ERROR_CODES` | `isPartnerError` (`…/partner`) | partner API |

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

@@ -4,7 +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 SendReceiptEmailOptions, type SendReceiptEmailResult, type ListMyReceiptsOptions, type ReceiptList, type ReceiptWithCompany, type SellReceiptOptions, type CancelReceiptOptions, type CancelReceiptResult } from './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
  * einmal und liefert die Aufrufe ohne den wiederkehrenden ersten Parameter.
@@ -48,6 +48,8 @@ export interface KasseneckApi {
     getFirstReceiptDate(): Promise<ReportMonth>;
     /** Beleg als Link auf die oeffentliche Belegseite per E-Mail schicken. */
     sendReceiptEmail(options: SendReceiptEmailOptions): Promise<SendReceiptEmailResult>;
+    /** Drucke und Teilen eines Belegs an das Protokoll „Ausgaben“ melden (nur Kassenweg). */
+    logReceiptOutputs(options: LogReceiptOutputsOptions): Promise<LogReceiptOutputsResult>;
     /** Belegliste einer Kasse samt Kennzahlen (nur mit ID-Token, siehe receipts.ts). */
     listMyReceipts(options: ListMyReceiptsOptions): Promise<ReceiptList>;
     /** Kassen des angemeldeten Benutzers (nur mit ID-Token, siehe cashregisters.ts). */

package/dist/cjs/client/api.js

@@ -25,6 +25,7 @@ function createKasseneckApi(options) {
         getFirstReceiptDate: () => (0, receipts_js_1.getFirstReceiptDate)(rufen),
         listMyReceipts: (o) => (0, receipts_js_1.listMyReceipts)(rufen, o),
         sendReceiptEmail: (o) => (0, receipts_js_1.sendReceiptEmail)(rufen, o),
+        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),
         getCashregisterReport: (options) => (0, reports_js_1.getCashregisterReport)(rufenBinaer, options),

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"];
+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 type ApiCall = typeof ALL_CALLS[number];
 /**
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -28,7 +28,7 @@ export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "can
  * `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", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift"];
+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", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "logReceiptOutputs"];
 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", "cancelStocktake", "changeStockCondition", "closeMyShift", "closeStocktake", "createArticle", "createCreditNote", "createCustomer", "createCustomerCashregister", "createInvoiceItem", "createPartnerCustomer", "createPartnerWebhook", "createPrintJob", "createReceipt", "createReservation", "createStocktake", "createVariantGroup", "createWebhook", "deactivateArticle", "deletePartnerWebhook", "deleteWebhook", "extendReservation", "financeWebService", "hobexPayApi", "hobexRefundApi", "issueInvoice", "logMyDrawerOpenings", "openMyShift", "orderSignatureCard", "pairRegisterDevice", "receiveGoods", "recordInvoicePayment", "recordMyCashMovement", "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"];
+export declare const UNKNOWN_OUTCOME_CALLS: readonly ["activateCashregister", "addVariant", "cancelInvoice", "cancelReceipt", "cancelStocktake", "changeStockCondition", "closeMyShift", "closeStocktake", "createArticle", "createCreditNote", "createCustomer", "createCustomerCashregister", "createInvoiceItem", "createPartnerCustomer", "createPartnerWebhook", "createPrintJob", "createReceipt", "createReservation", "createStocktake", "createVariantGroup", "createWebhook", "deactivateArticle", "deletePartnerWebhook", "deleteWebhook", "extendReservation", "financeWebService", "hobexPayApi", "hobexRefundApi", "issueInvoice", "logMyDrawerOpenings", "logReceiptOutputs", "openMyShift", "orderSignatureCard", "pairRegisterDevice", "receiveGoods", "recordInvoicePayment", "recordMyCashMovement", "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 39 Aufrufe des Kassenwegs. */
+/** Einer der 42 Aufrufe des Kassenwegs. */
 export declare function isPosCall(name: string): boolean;
 /**
- * Nur ueber den Kassenweg erreichbar (33 Namen): unter `api.kasseneck.at/v3`
+ * Nur ueber den Kassenweg erreichbar (36 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/aufrufe.js

@@ -144,6 +144,8 @@ exports.ALL_CALLS = [
     'logMyDrawerOpenings',
     'getMyShiftReport',
     'closeMyShift',
+    // Ausgaben eines Belegs (Drucke, Teilen) melden: nur ueber den Kassenweg.
+    'logReceiptOutputs',
 ];
 /**
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -319,6 +321,8 @@ exports.POS_CALLS = [
     'logMyDrawerOpenings',
     'getMyShiftReport',
     'closeMyShift',
+    // Ausgaben eines Belegs melden: nur ueber den Kassenweg.
+    'logReceiptOutputs',
 ];
 /**
  * Die Aufrufe **mit Wirkung**, alphabetisch: sie legen etwas an, aendern oder
@@ -369,6 +373,7 @@ exports.UNKNOWN_OUTCOME_CALLS = [
     'hobexRefundApi',
     'issueInvoice',
     'logMyDrawerOpenings',
+    'logReceiptOutputs',
     'openMyShift',
     'orderSignatureCard',
     'pairRegisterDevice',
@@ -522,12 +527,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 39 Aufrufe des Kassenwegs. */
+/** Einer der 42 Aufrufe des Kassenwegs. */
 function isPosCall(name) {
     return KASSENWEG.has(name);
 }
 /**
- * Nur ueber den Kassenweg erreichbar (33 Namen): unter `api.kasseneck.at/v3`
+ * Nur ueber den Kassenweg erreichbar (36 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/index.d.ts

@@ -2,7 +2,7 @@ export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type
 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';
+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 { 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';

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.getCashregisterReport = 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;
+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;
 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; } });
@@ -44,6 +44,7 @@ Object.defineProperty(exports, "getFirstReceiptDate", { enumerable: true, get: f
 Object.defineProperty(exports, "listMyReceipts", { enumerable: true, get: function () { return receipts_js_1.listMyReceipts; } });
 Object.defineProperty(exports, "checkVoucherCombinationError", { enumerable: true, get: function () { return receipts_js_1.checkVoucherCombinationError; } });
 Object.defineProperty(exports, "sendReceiptEmail", { enumerable: true, get: function () { return receipts_js_1.sendReceiptEmail; } });
+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 reports_js_1 = require("./reports.js");

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

@@ -1,5 +1,6 @@
 import { ReceiptType, type ReceiptTypeKey, KeckPaymentMethod, type KeckPaymentMethodKey } from '../enums/index.js';
 import { type Receipt, type ReceiptCompany, type ReceiptItem, type Voucher, type ReceiptSummary, type ReportMonth, type CancellationItem, type CancellationOf, type CancellationReason, type TipRefundSource, type ReturnDisposition, type ReceiptPaymentInput, type RegistrationInfo, type ReceiptEmailVia } from '../models/index.js';
+import { type ReceiptOutput, type ReceiptOutputEntryErrorCode, type ReceiptOutputLogKind, type ReceiptOutputResult } from '../models/receipt-output.js';
 import type { InternerTransport } from './aufrufe.js';
 import { type ReceiptLayout } from '../receipt/layout.js';
 import type { PosPaperSize } from '../printing/escpos.js';
@@ -140,8 +141,9 @@ export type CancelReceiptOptions = {
     /**
      * Rueckzahlung je Zahlung (Betraege negativ, `refundOf` = `id` der
      * Originalzahlung). Ohne Angabe spiegelt der Server die Restbetraege jeder
-     * Originalzahlung; ein Teilstorno eines Belegs mit mehreren Zahlungen
-     * braucht sie (`cancellation_payments_required`).
+     * Originalzahlung (Ausnahme Storno einer Gutschein-Auszahlung: genau eine
+     * positive Barzahlung ohne `refundOf`); ein Teilstorno eines Belegs mit
+     * mehreren Zahlungen braucht sie (`cancellation_payments_required`).
      *
      * **Karten-Storno:** `provider`, `providerPaymentId` und `providerData`
      * beschreiben die ERSTATTUNG am Terminal, nie die Originalzahlung. Die
@@ -216,6 +218,13 @@ export interface ReceiptWithCompany {
      * setzen das Logo in genau dieser Stufe; fehlt der Wert, gilt `M`.
      */
     logoScale: SheetLogoSize;
+    /**
+     * Ausgaben des Belegs (`data.outputs`, nur `getReceipt` unter `/v3`): die
+     * neuesten 20, neueste zuerst. Fehlt, wenn die Antwort keine Liste traegt
+     * (Verkauf, `/api`). Gelesen nach [ReceiptOutput]; ein kaputter Eintrag
+     * faellt weg, der Beleg bleibt lesbar.
+     */
+    outputs?: ReceiptOutput[];
 }
 /**
  * Das Zeilenmodell zum Drucken und Anzeigen eines Belegs aus einer Antwort.
@@ -402,6 +411,80 @@ export interface SendReceiptEmailResult {
  * eine zweite Mail und zaehlt auf die Schleuse.
  */
 export declare function sendReceiptEmail(transport: InternerTransport, options: SendReceiptEmailOptions): Promise<SendReceiptEmailResult>;
+/**
+ * Eine Ausgabe, wie die Kasse sie puffert und meldet: ein Druck oder ein
+ * Teilen des Belegs. Siehe [logReceiptOutputs].
+ */
+export interface ReceiptOutputEntry {
+    /**
+     * Idempotenzschluessel des Eintrags, am Geraet beim Puffern vergeben und
+     * beim Nachsenden unveraendert: ein zweites Melden legt keinen zweiten
+     * Eintrag an. 8–64 Zeichen `[A-Za-z0-9_-]` (Regel des Servers); ein anderer
+     * Schluessel wirft vor dem Senden.
+     */
+    key: string;
+    /** Beleg in der Kasse der Anmeldung; ein Beleg einer anderen Kasse ist `receipt_not_found`. */
+    receiptId: string;
+    /** `print` (Erstdruck), `reprint` (Duplikat, gedruckt mit `markAsDuplicate`), `link_shared`, `pdf_shared`. */
+    kind: ReceiptOutputLogKind;
+    /**
+     * Zeitpunkt am Geraet: Millisekunden seit 1970 oder ISO 8601 **mit Zone**
+     * (`new Date().toISOString()`); Text ohne Zone wirft vor dem Senden. Eine
+     * falsch gehende Geraeteuhr lehnt der Server nicht ab: er klemmt die Zeit auf
+     * Belegzeit bis Eingang.
+     */
+    at: number | string;
+    /**
+     * Ergebnis eines Drucks: `ok`, `failed` (sicher nicht gedruckt) oder
+     * `unclear` (Ausgang offen). Pflicht bei `print` und `reprint` (sonst lehnt
+     * der Server den Eintrag mit `validation` ab); beim Teilen ohne Angabe `ok`.
+     */
+    result?: ReceiptOutputResult;
+}
+/** Eingabe von [logReceiptOutputs]. Die Kasse bindet die Anmeldung (wie bei [sendReceiptEmail]). */
+export interface LogReceiptOutputsOptions {
+    /** 1–50 Eintraege ([RECEIPT_OUTPUT_ENTRIES_MAX]); ein groesserer Puffer geht in mehreren Aufrufen hinaus. */
+    entries: ReceiptOutputEntry[];
+}
+/** Ein abgelehnter Eintrag: dauerhaft, aus dem Puffer nehmen und nicht noch einmal senden. */
+export interface RejectedReceiptOutput {
+    key: string;
+    /** Aus [RECEIPT_OUTPUT_ENTRY_ERROR_CODES]; ein Code, den das Paket nicht kennt, bleibt lesbar. */
+    code: ReceiptOutputEntryErrorCode | (string & {});
+}
+/** Antwort von [logReceiptOutputs]. */
+export interface LogReceiptOutputsResult {
+    /** Angenommene Eintraege, auch die schon frueher gemeldeten (gleicher Schluessel). */
+    accepted: number;
+    rejected: RejectedReceiptOutput[];
+}
+/**
+ * Meldet Drucke und das Teilen eines Belegs an das Protokoll „Ausgaben“
+ * (Endpunkt `logReceiptOutputs`, nur ueber den Kassenweg `/api/v3`; mit
+ * `registerUserAuth` und mit `apiKeyAuth`). Registrierkassen-Erlass
+ * BMF-AV Nr. 2/2026, Abschnitt 4.2: die Belegerteilung ist zu dokumentieren.
+ * Der Beleg selbst bleibt unberuehrt; das Protokoll steht nie im DEP.
+ *
+ * **Ein Eintrag scheitert nie die anderen.** Der Server nimmt jeden Eintrag
+ * einzeln an oder lehnt ihn mit Code ab (`rejected`, Codes
+ * [RECEIPT_OUTPUT_ENTRY_ERROR_CODES]); nach einer Erfolgsantwort ist jeder
+ * gesendete Eintrag erledigt. Die Kasse puffert die Eintraege (offline,
+ * Neustart) und sendet sie spaeter; der Puffer blockiert nie Druck oder Teilen.
+ *
+ * **Wiederholen ist gefahrlos:** jeder Eintrag traegt seinen Schluessel. Bei
+ * unklarem Ausgang (`outcome: 'unknown'`) dieselben Eintraege mit denselben
+ * Schluesseln noch einmal senden.
+ *
+ * **Vor dem Senden abgewiesen** wird nur, was die ganze Anfrage scheitern
+ * liesse oder ohne Netz sicher falsch ist: keine oder mehr als 50 Eintraege,
+ * ein unbekanntes Feld (oben oder im Eintrag), ein fehlender Beleg, ein
+ * Schluessel ausserhalb der Regel des Servers, eine Art oder ein Ergebnis
+ * ausserhalb des Katalogs, eine Zeit, die weder ganze Millisekunden noch
+ * ISO 8601 mit Zone ist. `email` und `opened` gehen hinaus und kommen als
+ * `invalid_output_kind` zurueck: so verwirft der Puffer genau diesen Eintrag.
+ * Fehler der ganzen Anfrage: [RECEIPT_OUTPUT_ERROR_CODES].
+ */
+export declare function logReceiptOutputs(transport: InternerTransport, options: LogReceiptOutputsOptions): Promise<LogReceiptOutputsResult>;
 /**
  * Prueft die Gutschein-Kombination eines Belegs und liefert den ersten
  * Regelverstoss als Text (oder `null`) — Zwilling von

package/dist/cjs/client/receipts.js

@@ -13,6 +13,7 @@ exports.getReceiptWithCompany = getReceiptWithCompany;
 exports.generateFullReceiptId = generateFullReceiptId;
 exports.getFirstReceiptDate = getFirstReceiptDate;
 exports.sendReceiptEmail = sendReceiptEmail;
+exports.logReceiptOutputs = logReceiptOutputs;
 exports.checkVoucherCombinationError = checkVoucherCombinationError;
 exports.cardRefundReference = cardRefundReference;
 exports.belegAusHuelle = belegAusHuelle;
@@ -20,6 +21,8 @@ exports.belegMitFirmaAusHuelle = belegMitFirmaAusHuelle;
 exports.paymentsExpectedCents = paymentsExpectedCents;
 const index_js_1 = require("../enums/index.js");
 const index_js_2 = require("../models/index.js");
+const receipt_output_js_1 = require("../models/receipt-output.js");
+const validator_1 = require("@kreiseck/validator");
 const vienna_time_js_1 = require("../vienna-time.js");
 const money_js_1 = require("../money.js");
 const errors_js_1 = require("./errors.js");
@@ -58,14 +61,44 @@ function receiptLayoutFromResult(result, options = {}) {
  * die Hand des Aufrufers, sondern zu einem der benannten Aufrufe darunter.
  */
 async function createReceipt(rufen, options) {
-    const daten = await rufen('createReceipt', createReceiptParams(options));
+    const daten = await createReceiptRufen(rufen, options);
     return (0, errors_js_1.signiertGelesen)('createReceipt', () => belegAusHuelle(daten, 'createReceipt'));
 }
 /** Wie [createReceipt], liest aus derselben Antwort zusaetzlich die Firmendaten. */
 async function createReceiptWithCompany(rufen, options) {
-    const daten = await rufen('createReceipt', createReceiptParams(options));
+    const daten = await createReceiptRufen(rufen, options);
     return (0, errors_js_1.signiertGelesen)('createReceipt', () => belegMitFirmaAusHuelle(daten, 'createReceipt'));
 }
+/**
+ * Sendet `createReceipt`; die Gutschein-Codes der Nutzlast gelten als Geheimnis
+ * (normiert und formatiert): der Transport siebt Ursachen und Details, ein
+ * Servertext, der den Code wiederholt, wird hier geschwaerzt.
+ */
+async function createReceiptRufen(rufen, options) {
+    // Der Code geht so hinaus, wie er getippt wurde: die getippte Schreibweise (auch ungueltig,
+    // etwa mit falscher Pruefziffer) zaehlt ebenso als Geheimnis wie normiert und formatiert.
+    // Kurze Reste (Endung mit vier Zeichen) werden nie eingetragen.
+    const geheim = [...new Set((options.vouchers ?? []).flatMap((v) => {
+            if (typeof v.code !== 'string')
+                return [];
+            const roh = v.code.trim();
+            const geprueft = validator_1.VoucherCode.validate(v.code);
+            const liste = geprueft.ok ? [geprueft.normalized, validator_1.VoucherCode.format(geprueft.normalized)] : [];
+            if (roh.length >= 8)
+                liste.push(roh);
+            return liste;
+        }))].sort((a, b) => b.length - a.length);
+    try {
+        return await rufen('createReceipt', createReceiptParams(options), undefined, geheim);
+    }
+    catch (fehler) {
+        if (fehler instanceof errors_js_1.KasseneckApiError && geheim.some((g) => fehler.serverMessage.includes(g))) {
+            const text = geheim.reduce((t, g) => t.split(g).join('****'), fehler.serverMessage);
+            throw new errors_js_1.KasseneckApiError('createReceipt', text, fehler.details, fehler.code);
+        }
+        throw fehler;
+    }
+}
 /**
  * Baut die Nutzlast von `createReceipt` und prueft die Eingabe. Wirft, bevor
  * irgendetwas rausgeht — ein Beleg ist nicht folgenlos wiederholbar.
@@ -191,6 +224,24 @@ function pruefeRueckgabeWahl(wert, pfad) {
         throw new errors_js_1.KasseneckValidationError('cancelReceipt', `${pfad}: erlaubt sind ${index_js_2.RETURN_DISPOSITIONS.join(', ')}`, 'request');
     }
 }
+/**
+ * Storno einer Gutschein-Auszahlung: genau eine positive Barzahlung ohne `refundOf`
+ * (das Geld kommt in die Lade zurueck). Alles andere bleibt Rueckzahlung mit negativem Betrag;
+ * ob der Beleg eine Auszahlung war, entscheidet der Server.
+ */
+function istStornoAuszahlung(payments, original) {
+    if (!Array.isArray(payments) || payments.length !== 1)
+        return false;
+    // Kennt der Aufrufer das Original und es hat keine Auszahlung, bleibt es bei negativen Rueckzahlungen.
+    if (original != null && !(original.vouchers ?? []).some((v) => v.action === index_js_1.VoucherAction.payout))
+        return false;
+    const z = payments[0];
+    if (z == null || typeof z !== 'object')
+        return false;
+    const m = z['method'];
+    const art = typeof m === 'object' && m !== null ? m.value : m;
+    return art === 'cash' && typeof z['amountCents'] === 'number' && z['amountCents'] > 0 && z['refundOf'] === undefined;
+}
 /**
  * Storno-Beleg zu einem bestehenden Beleg — voll oder in Teilen. Prueft die
  * Eingabe, bevor etwas hinausgeht; der Server haelt die Restmengen und die
@@ -238,7 +289,7 @@ async function cancelReceipt(transport, options) {
         throw new errors_js_1.KasseneckValidationError('cancelReceipt', `${altfeld} gibt es unter /v3 nicht mehr: Rueckzahlungen gehen als payments hinaus.`, 'request');
     }
     // `payments: null` gilt wie im Backend als nicht angegeben.
-    const zahlungen = options.payments != null ? gepruefteZahlungen(options.payments, true, 'cancelReceipt') : undefined;
+    const zahlungen = options.payments != null ? gepruefteZahlungen(options.payments, true, 'cancelReceipt', false, istStornoAuszahlung(options.payments, options.receipt)) : undefined;
     if (zahlungen !== undefined)
         pruefeKartenRueckbuchung(zahlungen, options.receipt);
     const params = { cashregisterId, originalReceiptId, reason: options.reason };
@@ -470,6 +521,111 @@ async function sendReceiptEmail(transport, options) {
         via,
     };
 }
+const AUSGABEN_FELDER = ['entries'];
+const AUSGABE_FELDER = ['key', 'receiptId', 'kind', 'at', 'result'];
+/** Idempotenzschluessel eines Eintrags, wie der Server ihn annimmt. */
+const AUSGABE_SCHLUESSEL = /^[A-Za-z0-9_-]{8,64}$/;
+/** Zeitpunkt als Text: RFC 3339 mit Zone, bis zu sechs Nachkommastellen (wie der Server). */
+const AUSGABE_ZEIT = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,6})?(Z|[+-]\d{2}:\d{2})$/;
+/**
+ * Meldet Drucke und das Teilen eines Belegs an das Protokoll „Ausgaben“
+ * (Endpunkt `logReceiptOutputs`, nur ueber den Kassenweg `/api/v3`; mit
+ * `registerUserAuth` und mit `apiKeyAuth`). Registrierkassen-Erlass
+ * BMF-AV Nr. 2/2026, Abschnitt 4.2: die Belegerteilung ist zu dokumentieren.
+ * Der Beleg selbst bleibt unberuehrt; das Protokoll steht nie im DEP.
+ *
+ * **Ein Eintrag scheitert nie die anderen.** Der Server nimmt jeden Eintrag
+ * einzeln an oder lehnt ihn mit Code ab (`rejected`, Codes
+ * [RECEIPT_OUTPUT_ENTRY_ERROR_CODES]); nach einer Erfolgsantwort ist jeder
+ * gesendete Eintrag erledigt. Die Kasse puffert die Eintraege (offline,
+ * Neustart) und sendet sie spaeter; der Puffer blockiert nie Druck oder Teilen.
+ *
+ * **Wiederholen ist gefahrlos:** jeder Eintrag traegt seinen Schluessel. Bei
+ * unklarem Ausgang (`outcome: 'unknown'`) dieselben Eintraege mit denselben
+ * Schluesseln noch einmal senden.
+ *
+ * **Vor dem Senden abgewiesen** wird nur, was die ganze Anfrage scheitern
+ * liesse oder ohne Netz sicher falsch ist: keine oder mehr als 50 Eintraege,
+ * ein unbekanntes Feld (oben oder im Eintrag), ein fehlender Beleg, ein
+ * Schluessel ausserhalb der Regel des Servers, eine Art oder ein Ergebnis
+ * ausserhalb des Katalogs, eine Zeit, die weder ganze Millisekunden noch
+ * ISO 8601 mit Zone ist. `email` und `opened` gehen hinaus und kommen als
+ * `invalid_output_kind` zurueck: so verwirft der Puffer genau diesen Eintrag.
+ * Fehler der ganzen Anfrage: [RECEIPT_OUTPUT_ERROR_CODES].
+ */
+async function logReceiptOutputs(transport, options) {
+    const name = 'logReceiptOutputs';
+    const anfrage = (grund) => new errors_js_1.KasseneckValidationError(name, grund, 'request');
+    if (options === null || typeof options !== 'object' || Array.isArray(options))
+        throw anfrage('Anfrage muss ein Objekt sein');
+    // Ein unbekanntes Feld (etwa eine zweite cashregisterId) ginge sonst still verloren.
+    const fremd = Object.keys(options).find((k) => !AUSGABEN_FELDER.includes(k));
+    if (fremd != null)
+        throw anfrage(`unbekanntes Feld "${fremd}"`);
+    const roh = options.entries;
+    if (!Array.isArray(roh) || roh.length === 0 || roh.length > receipt_output_js_1.RECEIPT_OUTPUT_ENTRIES_MAX) {
+        throw anfrage(`entries muss 1–${receipt_output_js_1.RECEIPT_OUTPUT_ENTRIES_MAX} Eintraege haben`);
+    }
+    const entries = roh.map((e, i) => {
+        const wo = `entries[${i}]`;
+        if (e === null || typeof e !== 'object' || Array.isArray(e))
+            throw anfrage(`${wo} muss ein Objekt sein`);
+        const eintrag = {};
+        for (const [feld, w] of Object.entries(e)) {
+            if (!AUSGABE_FELDER.includes(feld))
+                throw anfrage(`${wo}: unbekanntes Feld "${feld}"`);
+            if (w !== undefined)
+                eintrag[feld] = w;
+        }
+        // Schluessel und Beleg nie getrimmt: ein veraenderter Schluessel waere ein anderer.
+        for (const feld of ['key', 'receiptId']) {
+            const w = eintrag[feld];
+            if (typeof w !== 'string' || w.trim() === '')
+                throw anfrage(`${wo}.${feld} fehlt`);
+        }
+        // Dieselbe Regel wie der Server: so traegt jede Antwort (`rejected[].key`)
+        // genau den Schluessel, unter dem die Kasse den Eintrag puffert.
+        if (!AUSGABE_SCHLUESSEL.test(eintrag.key))
+            throw anfrage(`${wo}.key muss 8–64 Zeichen [A-Za-z0-9_-] haben`);
+        // Ein Wert ausserhalb des Katalogs liesse den Rand die ganze Anfrage abweisen.
+        if (!receipt_output_js_1.RECEIPT_OUTPUT_KINDS.includes(eintrag.kind)) {
+            throw anfrage(`${wo}.kind muss ${receipt_output_js_1.RECEIPT_OUTPUT_KINDS.join(', ')} sein`);
+        }
+        if (eintrag.result !== undefined && !receipt_output_js_1.RECEIPT_OUTPUT_RESULTS.includes(eintrag.result)) {
+            throw anfrage(`${wo}.result muss ${receipt_output_js_1.RECEIPT_OUTPUT_RESULTS.join(', ')} sein`);
+        }
+        const at = eintrag.at;
+        // Text nur als ISO 8601 mit Zone (Regel des Servers): ohne Zone waere die
+        // Zeit je nach Geraet eine andere; das ist ein Fehler der Kasse, kein Fall
+        // fuer den Puffer.
+        const zeitOk = (typeof at === 'number' && Number.isSafeInteger(at) && at >= 0) || (typeof at === 'string' && AUSGABE_ZEIT.test(at));
+        if (!zeitOk)
+            throw anfrage(`${wo}.at muss Millisekunden seit 1970 oder ISO 8601 mit Zone sein`);
+        return eintrag;
+    });
+    return ausgabenGemeldet(name, await transport(name, { entries }));
+}
+/** Antwort von `logReceiptOutputs`, streng: `accepted` ganze Zahl ab 0, `rejected` Liste aus Schluessel und Code. */
+function ausgabenGemeldet(name, daten) {
+    if (daten === null || typeof daten !== 'object' || Array.isArray(daten))
+        throw antwortfehler(name, 'Antwort ist kein Objekt');
+    const { accepted, rejected } = daten;
+    if (typeof accepted !== 'number' || !Number.isSafeInteger(accepted) || accepted < 0) {
+        throw antwortfehler(name, 'Antwort enthaelt keine Zahl accepted');
+    }
+    if (!Array.isArray(rejected))
+        throw antwortfehler(name, 'Antwort enthaelt keine Liste rejected');
+    return {
+        accepted,
+        rejected: rejected.map((r, i) => {
+            const { key, code } = (r ?? {});
+            if (typeof key !== 'string' || typeof code !== 'string' || code === '') {
+                throw antwortfehler(name, `rejected[${i}] ohne Schluessel oder Code`);
+            }
+            return { key, code };
+        }),
+    };
+}
 /**
  * Prueft die Gutschein-Kombination eines Belegs und liefert den ersten
  * Regelverstoss als Text (oder `null`) — Zwilling von
@@ -663,14 +819,15 @@ const MAX_ZAHLUNGEN = 20;
  * (Summe, Anbieter-Pflicht und Trinkgeld prueft der Server). Wirft, bevor
  * etwas hinausgeht.
  */
-function gepruefteZahlungen(roh, storno, functionName, auszahlung = false) {
+function gepruefteZahlungen(roh, storno, functionName, auszahlung = false, stornoAuszahlung = false) {
     const fehler = (grund) => new errors_js_1.KasseneckValidationError(functionName, grund, 'request');
     if (!Array.isArray(roh))
         throw fehler('payments muss eine Liste sein.');
     if (roh.length > MAX_ZAHLUNGEN)
         throw fehler(`payments: es sind hoechstens ${MAX_ZAHLUNGEN} Eintraege erlaubt.`);
     // Auszahlung eines Gutscheins: der Betrag geht bar hinaus, ohne gegeben und ohne Trinkgeld (Server pruefeZahlungen).
-    const negativ = storno || auszahlung;
+    // Storno einer Auszahlung: der Kunde gibt das Geld zurueck, die eine Barzahlung ist positiv (zahlungen-core stornoAuszahlung).
+    const negativ = (storno && !stornoAuszahlung) || auszahlung;
     if (auszahlung) {
         const e = roh[0];
         if (roh.length !== 1)
@@ -843,6 +1000,7 @@ function belegAusHuelle(daten, functionName) {
 function belegMitFirmaAusHuelle(daten, functionName) {
     const receipt = belegAusHuelle(daten, functionName);
     const d = (daten ?? {});
+    const outputs = (0, receipt_output_js_1.receiptOutputsFromWire)(d.outputs);
     const layout = d.layout && typeof d.layout === 'object' && Array.isArray(d.layout.lines) ? d.layout : null;
     const angaben = d.registrationInfo && typeof d.registrationInfo === 'object' ? (0, index_js_2.readRegistrationInfo)(d.registrationInfo) : null;
     return {
@@ -854,6 +1012,7 @@ function belegMitFirmaAusHuelle(daten, functionName) {
         layout,
         registrationInfo: angaben,
         logoScale: d.logo_scale === 'S' || d.logo_scale === 'M' || d.logo_scale === 'L' || d.logo_scale === 'XL' ? d.logo_scale : 'M',
+        ...(outputs !== undefined ? { outputs } : {}),
     };
 }
 /**

package/dist/cjs/enums/voucher-type.d.ts

@@ -4,7 +4,7 @@
 export declare const VoucherType: {
     /** Altform: Wertgutschein (Wert im Cent, Code frei). */
     readonly value: "value";
-    /** Altform: Rabatt-/Promotionsgutschein. */
+    /** Altform: Rabatt-/Aktionsgutschein. */
     readonly promo: "promo";
     /** Neue Form: Mehrzweckgutschein (Zahlungsmittel, Steuer erst bei der Einloesung). */
     readonly multi_purpose: "multi_purpose";

package/dist/cjs/enums/voucher-type.js

@@ -7,7 +7,7 @@ exports.VoucherType = void 0;
 exports.VoucherType = {
     /** Altform: Wertgutschein (Wert im Cent, Code frei). */
     value: 'value',
-    /** Altform: Rabatt-/Promotionsgutschein. */
+    /** Altform: Rabatt-/Aktionsgutschein. */
     promo: 'promo',
     /** Neue Form: Mehrzweckgutschein (Zahlungsmittel, Steuer erst bei der Einloesung). */
     multi_purpose: 'multi_purpose',