@kreiseck/kasseneck-api 1.10.1 → 1.11.1

package/CHANGELOG.md

@@ -4,6 +4,253 @@ 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.11.1
+
+- `receiptSumCents`, `receiptSubSumCents` and the receipt layout count value vouchers with the opposite sign on a cancellation receipt; new helper `receiptValueVoucherSign`. Reason: the backend mirrors value vouchers onto a full cancellation with the same `action` and a positive value, and reverses the flow there (`receiptDueCents` already did). The cancellation of a sale paid partly with a value voucher (22.40, 17.50 by voucher, 4.90 cash) showed "Total -39.90" instead of the -4.90 actually refunded; the cancelled sale of a value voucher showed +30.00 instead of -30.00.
+- On a cancellation receipt a mirrored promotional voucher no longer reduces `receiptSubSumCents`/`receiptSumCents`; the layout shows it as a reference without an amount. Reason: the backend takes the discount back through compensation items (`kind: 'discount'`, "Gutschein-Ausgleich") and applies a promo entry only to a positive bucket total, which a cancellation never has. The cancellation of a 34.30 sale with a 10.00 promotional voucher showed "Total -34.30" instead of the -24.30 refunded.
+- Receipts other than cancellations print the same bytes as in 1.11.0.
+
+## 1.11.0
+
+Shifts, cash position and drawer log at the register: `./pos` gains the six
+calls of the register path, the catalogues, three helpers, the texts and the
+receipt layouts for the Z report, the X report and a cash movement. Reason:
+the register knew sales, but not the cash in the drawer. A business with
+several people at one drawer could not hand over, count against an expected
+amount, book a cash drop or a change float, pay out tips or prove why the
+drawer was opened without a sale. The backend now keeps drawers, shifts and
+cash movements (never signed, not a turnover), and the web register and the
+app need it through the package with the same words and the same receipts.
+
+Additive at runtime; existing calls send the same bytes as in 1.10.1 (a
+receipt or cancellation without `drawerId` is unchanged). The unions
+`ApiCall`, `PosCall`, `PosErrorCode`, `MessageKey` and `LabelKey` gain
+members, so an exhaustive `switch` with a `never` check needs the new cases.
+
+- **Calls** (`./pos`, register path only, `registerUserAuth`):
+  `getMyDrawerState(transport, { drawerId?, cashregisterId? })` (no right
+  needed; `rights { shift, cashMove, cashView, drawer }`, the open shift,
+  `tipClaims`, and with `cashView` `expectedCents`, `suggestedFloatCents`,
+  `recentOpenings`), `openMyShift` (`openingFloatCents` with optional
+  `denominations`, or `takeOver: true`, exactly one), `recordMyCashMovement`
+  (`type`, `amountCents`, optional `location` `bank` | `safe`, `note`, `recipientId`,
+  `targetDrawerId`; answers the movement and the receipt data),
+  `logMyDrawerOpenings` (1–50 entries, each with its own `idempotencyKey`,
+  optionally `drawerId` and the `operator` who opened the drawer while the
+  entry was buffered; answers `accepted`, `duplicates` and the effective
+  `drawerId`, the main drawer for a decommissioned one), `getMyShiftReport` (shift, movements,
+  X report or Z report for a reprint) and `closeMyShift` (answers
+  `status: 'recount'`, which is not an error, or `status: 'closed'` with the
+  shift, the Z report and `lastShiftOfRegister`; the server counts the
+  attempts, at most two, `attempt` is accepted but has no effect).
+- **Blind count**: without the right `cashView` the server sends no expected
+  amount, no counted amount, no running totals and no suggestion. The models
+  are the wire form field by field: such a field is then absent, never `0`.
+  On the receipt data (`ShiftSummaryReceipt`) the same values are `null`.
+- **Without the right `shift`** `getMyDrawerState` still sends the open shift,
+  but only its basic data (`id`, `drawerId`, `cashregisterId`, `number`,
+  `status`, `openedAt`, `openedBy`); the register sells into it. Every other
+  field of `Shift` is therefore optional. Reason: a user without the right
+  saw no shift and the register blocked the sale although one was open.
+- **Models**: `DrawerState`, `Shift`, `ShiftRunningTotals` (maps go out as
+  lists: `nonCashByMethod: [{ method, cents }]`, `tips: [{ registerUserId,
+  name, … }]`), `ShiftReconciliation`, `CashMovement`, `TipClaim`,
+  `DrawerOpening`, `ShiftSummaryReceipt` (`kind` `shift_close` |
+  `shift_interim`), `CashMovementReceipt` (`kind` `cash_movement`) and the
+  results `OpenShiftResult`, `CashMovementResult`, `DrawerOpeningsResult`,
+  `ShiftReport`, `CloseShiftResult`. An amount, count or number that is not
+  an integer and an unknown `status` or `kind` are response errors.
+- **Idempotency and outcome**: `openMyShift`, `recordMyCashMovement`,
+  `logMyDrawerOpenings` and `closeMyShift` are in `UNKNOWN_OUTCOME_CALLS`:
+  after `outcome: 'unknown'` resend with the **same** key, the server books
+  once. `getMyDrawerState` and `getMyShiftReport` are reads.
+  `newIdempotencyKey()` draws a fresh key for a new action (`kasse-` and 32
+  hex characters from `crypto.getRandomValues`, the form of the register app).
+- **Error codes**: `shift_mode_off` (`openMyShift` on a drawer without shift
+  mode) with the text `shift.mode_off`; the text of `recount_exhausted` asks
+  for the amount of the second count (a comment is only needed above the
+  threshold, `comment_required`). The lists of request error codes and
+  `PAYMENT_CALL_REJECTED_CODES` gain `second_factor_required` and
+  `action_confirmation_required`. Reason: the backend /v3 contract contains
+  them since keck#657 (confirmation in the Kasseneck app, rejected before the
+  handler).
+- **Checked before sending**, nothing else: `drawerId`, `shiftId`, the key
+  (also per drawer opening), a non-empty `entries` list and amounts,
+  denomination counts and tip payouts as integers. Catalogue, mandatory
+  fields per type, balance and claims are left to the server.
+- **Catalogues**: `EUR_DENOMINATIONS` (cents, largest note first),
+  `MOVEMENT_TYPES`, `MANUAL_MOVEMENT_TYPES` (the eight the register may send),
+  `CASH_LOCATIONS`, `OPENING_REASONS`, `MANUAL_OPENING_REASONS`,
+  `SHIFT_RECEIPT_KINDS`, each the contract catalogue in its order.
+- **Helpers**: `sumDenominations(denominations)` (sum in cents, `null` for an
+  unknown value or a count that is not an integer from 0 to 100 000, the rule
+  of the server) and `parseCentsAllowZero(text)` (typed amount to cents
+  without floating point; `0` is valid, comma or point with one or two
+  decimals, no thousands separator). Their cases are shared with the Dart twin
+  in the new `fixtures/shift-cases.json`.
+- **Receipts**: `shiftReceiptLayout(receipt, { paperSize })` (title
+  „Schichtabschluss“ or „Zwischenbericht“ by `kind`) and
+  `cashMovementLayout(receipt, { paperSize })` build the usual line model
+  (`ReceiptLayout`, grid, sheet, ESC/POS, ePOS). A line whose value is `null` (blind: expected,
+  counted, difference, cash sales, counted denominations) is left out, never
+  printed as „0,00“. Goldens from the contract answers, so layout and contract
+  cannot drift: `fixtures/expected/shift-close.*`, `shift-close-blind.*`,
+  `shift-interim.*`, `cash-movement.*` (lines, 32 and 48 character grid),
+  sources and checksums in the new `fixtures/shift-receipts.json`. The
+  receipt goldens of 1.10.1 are byte for byte unchanged.
+- **Cash position and tip list at the register**: `ShiftRunningTotals.voucherRedeemedCents`
+  (redeemed vouchers, not cash; 0 when an older server omits it), the helper
+  `durationText(minutes)` („8 Std. 32 Min.“, „1 Tag 3 Std.“; cases in
+  `fixtures/shift-cases.json`) and the texts for the new cash position card and
+  the tip payout list (`shift.*`, `duration.*`, `tip_payout.*`,
+  `cash_movement.pay_in_short|pay_out_short`, `drawer.recent_openings_full`).
+- **Printer warning**: four short labels for the quiet warning line at the print buttons
+  (`printer.warn_unreachable`, `printer.warn_none`, `printer.check`, `printer.set_up`).
+- **Change float and take out / put in at shift close**: a drawer can keep a fixed
+  change float; after counting, the register takes out the rest or puts money in.
+  `DrawerInfo.changeFloatCents` and `DrawerState.suggestedFromShiftNumber` (only
+  when sent), `CloseMyShiftOptions.afterCount` (`{ type: 'cash_drop' | 'change_in',
+  amountCents }`, catalogue `AFTER_COUNT_TYPES`, only the shape is checked before
+  sending), `Shift.afterCount`/`leftInDrawerCents`, `ShiftSummaryReceipt.afterCount`/
+  `leftInDrawerCents` (blind `null`) and `afterCountReceipt` on the close result
+  (the envelope receipt). New code `after_count_not_permitted` in
+  `POS_ERROR_CODES`. `shiftReceiptLayout` prints, after a rule below the count,
+  „Entnommen“ (negative) or „Eingelegt“ and „Bleibt in der Kassenlade“ (bold); without
+  `afterCount` the Z report is byte-identical. For the bold line,
+  `LayoutColumnsLine` gains an optional `bold` (only written when `true`; grid,
+  ESC/POS, ePOS, sheet and React follow it, every existing output is unchanged).
+  New goldens `shift-close-take-out`, `shift-close-put-in`; texts `drawer.change_float*`,
+  `shift.*` for the step „Geld entnehmen“, `shift_receipt.taken_out|put_in|left_in_drawer`,
+  `shift.counted|back|done|edit_amount` (row „Gezählt“, „Zurück“, step „Fertig“,
+  accessibility label „{title} ändern“), message `shift.change_float_missing`; the
+  bold column line is pinned in the byte twin test. Reason: the drawer kept everything after a
+  shift, so the next shift started with the whole day's cash.
+- **Texts** (`fixtures/pos-texts.json`): messages `shift.*`,
+  `shift.required_other` (shift mode on, no shift open, the signed-in user
+  lacks the `shift` right), `cash_movement.*`, `tip_payout.exceeds_claim`, `denominations.invalid`,
+  `amount.invalid`, `drawer.not_found`, `drawer.inactive`; labels for the
+  screens (`shift.*`, `drawer.reason_*`), one per movement type
+  (`cash_movement.type_*`) and the receipt lines (`shift_receipt.*`).
+  `ERROR_CODE_RULES` gains a rule for every new code (`shift_not_open`,
+  `shift_already_open`, `shift_closed`, `comment_required`,
+  `recount_exhausted`, `cash_movement_exceeds_balance`, `note_required`,
+  `invalid_movement_type`, `transfer_same_drawer`, `tip_payout_exceeds_claim`,
+  `invalid_denominations`, `invalid_amount`, `drawer_not_found`,
+  `drawer_inactive`): the register says what to do instead of the backend
+  sentence. `validation`, `module_inactive` and `not_permitted` keep the
+  readable sentence of the server, as before.
+- **Bank or safe is optional**: `location` on `change_in` and `cash_drop` is
+  checked only when given (`bank` | `safe`, otherwise refused before sending);
+  the movement receipt prints „Ort“ only when it is set, the label of
+  `change_in` is „Wechselgeld“, and no shift receipt prints „Kein
+  Registrierkassenbeleg“ (the text `shift.not_a_receipt` is gone). Reason:
+  the register no longer asks where the change came from or the drop went,
+  the answer had no use for the cash position, and the note at the foot was
+  not wanted on the slips.
+- **Tips during the shift**: `DrawerState.tips` lists per employee what
+  the running shift earned (`receivedImmediatelyCents`, `retainedCents`),
+  what was already paid out from the drawer in this shift (`paidOutCents`)
+  and the open claim against the drawer (`openCents`), for every session,
+  also without `cashView`. `ShiftTipTotals` gains `paidOutCents`, the new
+  `ShiftTip` adds `openCents` (`ShiftReceiptTip` is now this type, the Z and
+  X report carry the open claim at closing or now). `recordMyCashMovement`
+  with `type: 'tip_payout'` and `recipientId` is unchanged; the server now
+  also lets a user with only the right `shift` pay out the own claim (another
+  employee's claim still needs `cashMove`). New helper
+  `shiftTipLines(tip)`: the lines of one employee as the register shows and
+  prints them, „verdient“ (immediate + retained) always, „über Lohn“,
+  „schon genommen“ and „offen“ only when not 0, no line at all when
+  everything is 0; its cases are in `fixtures/shift-cases.json`. The shift
+  receipts use it. Labels `shift_receipt.tip_earned` „verdient“ and
+  `shift_receipt.tip_open` „offen“ are new, `shift_receipt.tip_paid_out`
+  now reads „schon genommen“, `shift_receipt.tip_immediately` („sofort“) is
+  gone. Reason: staff take their tips at any time, not only at the end of
+  the shift, and the slip showed lines with 0,00 nobody needed.
+- **Cash tip kept right away**: `TipOptions.keptByEmployee` (sent only when
+  `true`; anything but a boolean is refused before sending) marks a staff
+  cash tip the employee pockets at the sale. The receipt stays as it was
+  (signed, in the DEP); the tip position carries `keptByEmployee: true`
+  (`ReceiptItem.keptByEmployee`, read and mirrored on a cancellation). In
+  the cash position the amount is not part of the expected cash and counts
+  as „schon genommen“ at once (`paidOutCents`, no line of its own); the open
+  claim does not grow. The server takes it only for staff tips paid in cash
+  and received immediately, otherwise it drops it silently. New optional
+  business setting `tipKeptByDefault` (`POS_BUSINESS_OPTIONAL_FIELDS`, sent
+  by the server only when stored, missing = off; `posTipKeptByDefault(business)`)
+  presets the switch. Labels `checkout.tip_kept` „gleich behalten“ and
+  `tip.kept_setting`, message `tip.kept_setting_hint`. Reason: a waitress
+  who keeps 2 € of a 22 € cash payment left 20 € in the drawer while the
+  expected cash said 22 € — a difference that was none. The hint now says
+  „zählt nicht ins Soll der Lade“ (it never left the cash position).
+- **Cancelling with or without the tip**: `cancelReceipt` takes `refundTip`
+  (answer to „Trinkgeld auch zurückgeben?“; `false` leaves the staff tip on
+  the receipt, without `items` = every remaining quantity except the tip;
+  `true` with `items` adds the open tip) and `tipRefundSource` (`drawer` |
+  `employee`, `TIP_REFUND_SOURCES`, only for a cash refund: from the drawer,
+  or the employee hands it back herself). Without both the payload is the
+  same as before (a full cancellation takes the tip along). A wrong value
+  or a source with `refundTip: false` is refused before sending. The rules
+  both registers ask by: `openStaffTipCents(receipt)` (> 0 = ask the first
+  question, also for a partial cancellation), `cancellationItemsForTip`,
+  `cancellationCashRefundCents` and `asksTipRefundSource` (second question
+  only when the cash of the refund covers the tip and the employee already
+  had it); shared cases in `fixtures/cancellation-tip-cases.json`.
+  `CANCELLATION_ERROR_CODES` gains `tip_refund_conflict`,
+  `invalid_tip_refund_source` and `tip_refund_source_requires_cash`. Labels
+  `cancellation.tip_refund_question/yes/no`,
+  `cancellation.tip_source_question/drawer/employee`, messages
+  `cancellation.tip_refund_missing` and `cancellation.tip_source_missing`.
+  Reason: a tip is a voluntary gift to the employee; whether it goes back
+  with a cancelled sale, and from whose pocket, is a decision at the
+  register, and the drawer, „verdient“, „schon genommen“ and „offen“ must
+  follow it. A negative „offen“ (the employee owes the drawer) prints with
+  a minus; `shiftTipLines` keeps it like any value other than 0.
+  With a value voucher on the receipt there is no „Nein“: `asksRefundTip`
+  is false there, the registers show `cancellation.tip_refunded_with_voucher`
+  and send `refundTip: true` (the server refuses `false` with
+  `tip_keep_not_possible_with_voucher`, added to `CANCELLATION_ERROR_CODES`),
+  because only a full cancellation reverses the voucher. `refundTip: true`
+  without `tipRefundSource` on a cash refund means: from the drawer. After
+  „Nein“ the tip line of the cancellation sheet reads `cancellation.tip_stays`
+  „bleibt“.
+- **Tip handed back by the employee**: `ShiftTipTotals.refundedByEmployeeCents`
+  („selbst zurückgegeben“, read as 0 when an older backend leaves it out) and
+  a line `shift_receipt.tip_refunded_by_employee` in `shiftTipLines` (only
+  when not 0). Reason: a cancellation where the employee hands the tip back
+  herself showed „schon genommen -2,00“ — correct, but read wrong; now
+  „schon genommen“ never goes negative this way, and
+  open = earned − taken + handed back.
+- **Tip carried over from earlier shifts**: `ShiftTip.carriedOverCents`
+  („aus früheren Schichten“, the drawer's open claim when the shift was
+  opened; without an open shift the whole claim; read as 0 when missing) and
+  the line `shift_receipt.tip_carried_over` first in `shiftTipLines` (only
+  when not 0). Reason: „verdient 9,00 · offen 15,00“ left 6,00 unexplained;
+  now open = carried over + earned − retained − taken + handed back, with
+  exactly the lines shown.
+- **Device setting** `drawerId` (inner `ladeId`): the drawer of this device.
+  Optional like on the wire, without a default (`POS_DEVICE_OPTIONAL_FIELDS`):
+  present only when a drawer is assigned, written as an id or `null` (removes
+  the assignment). `./stored` reads it the same way.
+- **Receipts and cancellations** take `drawerId` (`sellReceipt`,
+  `createReceipt` options, `cancelReceipt`): the drawer whose cash position
+  the receipt counts in; an empty id is refused before sending.
+- **Errors**: `POS_ERROR_CODES` gains the codes of the six calls
+  (`drawer_not_found`, `drawer_inactive`, `shift_already_open`, `shift_mode_off`,
+  `shift_not_open`, `shift_closed`, `comment_required`, `recount_exhausted`,
+  `cash_movement_exceeds_balance`, `tip_payout_exceeds_claim`,
+  `invalid_amount`, `invalid_denominations`, `invalid_movement_type`,
+  `transfer_same_drawer`, `note_required`).
+- **Contract**: `fixtures/v3/` pulled from the backend at the state of shifts
+  and cash position; the vocabulary of `./stored` regenerated (`drawerId` in
+  the device settings), and `./stored` drops `ladeId`, `schichtId` and
+  `ausserhalbSchicht` from a stored receipt like the server does.
+- **Counts**: `POS_CALLS` 33 → 39 (33 register-only names).
+- **Twin check**: the source fingerprints of `kasse-settings-core.js` (optional
+  device settings) and of `INTERNE_BELEG_FELDER` in `storno-core.js` in
+  `test/fixtures/stored-zwillinge.json` follow the backend; the behaviour
+  comparison of `./stored` against the backend is green.
+- **Texts**: 15 labels (`cash_movement.pay_in/pay_out/print`, `drawer.recent_openings`, `drawer.reason_sale/cash_movement/shift_open/shift_close`, `shift.resend/next/print_close/print_again/back_to_register/later`, `time.yesterday`) and 2 messages (`tip_payout.recipient_required`, `shift.pending_hint`) for the cash position and the drawer log, so the registers take every text from the package.
+
 ## 1.10.1
 
 - Documentation of `getCashregisterReport`: the daily report is only available for a closed day (yesterday or earlier); today returns `period_not_closed` like the current month. Reason: the backend accepts only closed days since keck#659. No code change in the package.

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", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount"];
+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", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift"];
 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"];
+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", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift"];
 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", "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"];
+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", "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 33 Aufrufe des Kassenwegs. */
+/** Einer der 39 Aufrufe des Kassenwegs. */
 export declare function isPosCall(name: string): boolean;
 /**
- * Nur ueber den Kassenweg erreichbar (27 Namen): unter `api.kasseneck.at/v3`
+ * Nur ueber den Kassenweg erreichbar (33 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

@@ -131,6 +131,13 @@ exports.ALL_CALLS = [
     'listMyStocktakeCounts',
     'recordMyStocktakeCount',
     'voidMyStocktakeCount',
+    // Schicht, Kassenstand und Lade-Protokoll an der Kasse (./pos)
+    'getMyDrawerState',
+    'openMyShift',
+    'recordMyCashMovement',
+    'logMyDrawerOpenings',
+    'getMyShiftReport',
+    'closeMyShift',
 ];
 /**
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -294,6 +301,13 @@ exports.POS_CALLS = [
     'listMyStocktakeCounts',
     'recordMyStocktakeCount',
     'voidMyStocktakeCount',
+    // Schicht, Kassenstand und Lade-Protokoll: nur ueber den Kassenweg.
+    'getMyDrawerState',
+    'openMyShift',
+    'recordMyCashMovement',
+    'logMyDrawerOpenings',
+    'getMyShiftReport',
+    'closeMyShift',
 ];
 /**
  * Die Aufrufe **mit Wirkung**, alphabetisch: sie legen etwas an, aendern oder
@@ -320,6 +334,7 @@ exports.UNKNOWN_OUTCOME_CALLS = [
     'cancelReceipt',
     'cancelStocktake',
     'changeStockCondition',
+    'closeMyShift',
     'closeStocktake',
     'createArticle',
     'createCreditNote',
@@ -342,9 +357,12 @@ exports.UNKNOWN_OUTCOME_CALLS = [
     'hobexPayApi',
     'hobexRefundApi',
     'issueInvoice',
+    'logMyDrawerOpenings',
+    'openMyShift',
     'pairRegisterDevice',
     'receiveGoods',
     'recordInvoicePayment',
+    'recordMyCashMovement',
     'recordMyStocktakeCount',
     'recordStockLoss',
     'recordStocktakeCount',
@@ -423,6 +441,8 @@ exports.CALLS_WITHOUT_EFFECT = Object.freeze({
     getInvoiceSetupStatus: 'read',
     getInvoiceXml: 'read',
     getKasseSettings: 'read',
+    getMyDrawerState: 'read',
+    getMyShiftReport: 'read',
     getPartnerBilling: 'read',
     getPartnerBillingMonth: 'read',
     getPartnerCustomer: 'read',
@@ -487,12 +507,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 33 Aufrufe des Kassenwegs. */
+/** Einer der 39 Aufrufe des Kassenwegs. */
 function isPosCall(name) {
     return KASSENWEG.has(name);
 }
 /**
- * Nur ueber den Kassenweg erreichbar (27 Namen): unter `api.kasseneck.at/v3`
+ * Nur ueber den Kassenweg erreichbar (33 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

@@ -284,6 +284,8 @@ exports.PAYMENT_CALL_REJECTED_CODES = Object.freeze([
     'app_check_invalid',
     'unauthorized',
     'password_change_required', // Pflichtwechsel des Passworts offen: vor dem Handler abgewiesen
+    'second_factor_required', // Anmeldung wartet auf die Bestaetigung in der Kasseneck-App: vor dem Handler abgewiesen
+    'action_confirmation_required', // Aenderung wartet auf die Bestaetigung in der Kasseneck-App: vor dem Handler abgewiesen
     'mfa_required',
     'user_verification_failed',
     'admin_required',

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

@@ -1,5 +1,5 @@
 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 ReturnDisposition, type ReceiptPaymentInput, type RegistrationInfo, type ReceiptEmailVia } from '../models/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 { InternerTransport } from './aufrufe.js';
 import { type ReceiptLayout } from '../receipt/layout.js';
 import type { PosPaperSize } from '../printing/escpos.js';
@@ -49,6 +49,12 @@ export interface ReceiptCommonOptions {
      * anteilig je Steuersatz). Nur auf `standard` und `training`.
      */
     tip?: number | TipOptions;
+    /**
+     * Lade, in deren Kassenstand der Beleg zaehlt (Schichtbetrieb, Geraete-
+     * Einstellung `drawerId`). Ohne Angabe gilt die Lade des Geraets bzw. die
+     * Hauptlade der Kasse. Leer oder kein Text: wirft vor dem Senden.
+     */
+    drawerId?: string;
 }
 /** Trinkgeld mit eigener Zahlart und/oder Empfaengern (Kassen-Benutzer-IDs, Summe = cents). */
 export interface TipOptions {
@@ -73,6 +79,15 @@ export interface TipOptions {
      * (ohne angemeldeten Kassen-Benutzer) gilt die Einschraenkung nicht.
      */
     receivedImmediately?: boolean;
+    /**
+     * Bar-Trinkgeld „gleich behalten“: die Mitarbeiterin steckt das Trinkgeld
+     * beim Verkauf gleich ein. Der Beleg bleibt, wie er ist (signiert, im DEP);
+     * nur im Kassenstand zaehlt der Betrag nicht ins Bar-Soll und gilt sofort als
+     * „schon genommen“. Nur `true` geht hinaus. Der Server nimmt es nur bei
+     * Mitarbeiter-Trinkgeld, bar und sofort erhalten; sonst faellt es still weg.
+     * Vorbelegung des Schalters: [posTipKeptByDefault] der Kassen-Einstellungen.
+     */
+    keptByEmployee?: boolean;
 }
 export interface TipRecipientShare {
     registerUserId: string;
@@ -135,6 +150,24 @@ export type CancelReceiptOptions = {
      * Kassenweg (Kanal `app`, `registerUserAuth`).
      */
     payments?: ReceiptPaymentInput[];
+    /** Lade, in deren Kassenstand der Storno zaehlt; wie bei [ReceiptCommonOptions.drawerId]. */
+    drawerId?: string;
+    /**
+     * Antwort auf „Trinkgeld auch zurueckgeben?“ (Schichten-Spec, Nachtrag 5). `false`: ohne das
+     * Mitarbeiter-Trinkgeld (ohne `items` = alle Restmengen ausser dem Trinkgeld); `true` mit `items`:
+     * das noch offene Trinkgeld kommt dazu. Fehlt = wie bisher (ein Vollstorno nimmt es mit). Die
+     * Positionen dazu rechnet [cancellationItemsForTip]. An einem Beleg mit Wertgutschein gibt es
+     * `false` nicht (`tip_keep_not_possible_with_voucher`, siehe [asksRefundTip]).
+     */
+    refundTip?: boolean;
+    /**
+     * Antwort auf „Woher kommt das Trinkgeld zurueck?“, nur bei Barrueckgabe ([asksTipRefundSource]):
+     * `drawer` aus der Lade, `employee` gibt die Mitarbeiterin direkt. Nicht zusammen mit
+     * `refundTip: false`. Der Server weist eine Quelle ohne Bargeld-Deckung ab
+     * (`tip_refund_source_requires_cash`). `refundTip: true` ohne Quelle heisst bei Barrueckgabe:
+     * aus der Lade (kein „gibt die Mitarbeiterin direkt“).
+     */
+    tipRefundSource?: TipRefundSource;
 } & ({
     receipt: Receipt;
     cashregisterId?: string;

package/dist/cjs/client/receipts.js

@@ -136,8 +136,18 @@ function createReceiptParams(options) {
     if (options.legalMessage != null) {
         params['legalMessage'] = options.legalMessage.join('\n');
     }
+    if (options.drawerId !== undefined) {
+        params['drawerId'] = ladeKennung('createReceipt', options.drawerId);
+    }
     return params;
 }
+/** Die Lade eines Belegs: ein nicht leerer Text, sonst wirft der Aufruf vor dem Senden. */
+function ladeKennung(name, wert) {
+    if (typeof wert !== 'string' || wert.trim() === '') {
+        throw new errors_js_1.KasseneckValidationError(name, 'drawerId muss eine Kennung sein (oder weglassen)', 'request');
+    }
+    return wert;
+}
 /** Felder des alten Einzel-Zahlungswegs; unter /v3 abgewiesen. */
 const ALTE_ZAHLFELDER = ['paymentMethod', 'paymentMethodFromServer', 'creditCardProvider', 'cardPaymentId', 'cardPaymentData'];
 /** Normalbeleg (Verkauf) nach RKSV. */
@@ -191,6 +201,15 @@ async function cancelReceipt(transport, options) {
     if (options.note !== undefined && options.note.length > NOTE_MAX) {
         throw new errors_js_1.KasseneckValidationError('cancelReceipt', `Anmerkung ist zu lang (hoechstens ${NOTE_MAX} Zeichen)`, 'request');
     }
+    if (options.refundTip !== undefined && typeof options.refundTip !== 'boolean') {
+        throw new errors_js_1.KasseneckValidationError('cancelReceipt', 'refundTip muss true oder false sein (oder weglassen)', 'request');
+    }
+    if (options.tipRefundSource !== undefined && !(0, index_js_2.isTipRefundSource)(options.tipRefundSource)) {
+        throw new errors_js_1.KasseneckValidationError('cancelReceipt', `tipRefundSource: erlaubt sind ${index_js_2.TIP_REFUND_SOURCES.join(', ')}`, 'request');
+    }
+    if (options.tipRefundSource !== undefined && options.refundTip === false) {
+        throw new errors_js_1.KasseneckValidationError('cancelReceipt', 'tipRefundSource nur, wenn das Trinkgeld zurueckgeht (refundTip nicht false)', 'request');
+    }
     const altfeld = ALTE_ZAHLFELDER.find((feld) => options[feld] != null);
     if (altfeld != null) {
         throw new errors_js_1.KasseneckValidationError('cancelReceipt', `${altfeld} gibt es unter /v3 nicht mehr: Rueckzahlungen gehen als payments hinaus.`, 'request');
@@ -213,6 +232,12 @@ async function cancelReceipt(transport, options) {
         params.note = options.note;
     if (zahlungen !== undefined)
         params.payments = zahlungen;
+    if (options.drawerId !== undefined)
+        params.drawerId = ladeKennung('cancelReceipt', options.drawerId);
+    if (options.refundTip !== undefined)
+        params.refundTip = options.refundTip;
+    if (options.tipRefundSource !== undefined)
+        params.tipRefundSource = options.tipRefundSource;
     const daten = await transport('cancelReceipt', params);
     return (0, errors_js_1.signiertGelesen)('cancelReceipt', () => stornoAusHuelle(daten));
 }
@@ -533,6 +558,14 @@ function gepruefterTip(tip) {
         }
         nutzlast['receivedImmediately'] = tip.receivedImmediately;
     }
+    if (tip.keptByEmployee != null) {
+        if (typeof tip.keptByEmployee !== 'boolean') {
+            throw eingabefehler('Trinkgeld: keptByEmployee muss true oder false sein.');
+        }
+        // `false` ist dasselbe wie weglassen: die Nutzlast bleibt wie bisher.
+        if (tip.keptByEmployee)
+            nutzlast['keptByEmployee'] = true;
+    }
     if (tip.recipients != null) {
         if (!Array.isArray(tip.recipients) || tip.recipients.length === 0) {
             throw eingabefehler('Trinkgeld: recipients darf nicht leer sein.');
@@ -557,7 +590,7 @@ function gepruefterTip(tip) {
     }
     return nutzlast;
 }
-const TIP_FELDER = ['cents', 'paymentMethod', 'recipients', 'receivedImmediately'];
+const TIP_FELDER = ['cents', 'paymentMethod', 'recipients', 'receivedImmediately', 'keptByEmployee'];
 /**
  * Zahlungsart des Aufrufers pruefen — unbekannt wirft, bevor etwas rausgeht.
  * `mixed` wirft ebenfalls: den Wert vergibt nur der Server (Beleg mit

package/dist/cjs/index.d.ts

@@ -1,5 +1,5 @@
 export { ReceiptType, type ReceiptTypeKey, VatRate, type VatRateKey, KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider, type CreditCardProviderKey, VoucherType, type VoucherTypeKey, VoucherAction, type VoucherActionKey, StripeLinkMode, type StripeLinkModeKey, } from './enums/index.js';
-export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, type ReturnDisposition, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, type PaymentErrorCode, PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors, type PaymentFieldError, type ReceiptEmailErrorCode, type ReceiptEmailVia, RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, type ReceiptEmailSendErrorCode, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, type ReceiptEmailFieldError, type ReceiptErrorCode, type ReceiptFieldError, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, remainingQuantities, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, type CashregisterAutoLogout, type CashregisterAutoLogoutPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, isZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
+export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, type ReturnDisposition, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, type PaymentErrorCode, PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors, type PaymentFieldError, type ReceiptEmailErrorCode, type ReceiptEmailVia, RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, type ReceiptEmailSendErrorCode, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, type ReceiptEmailFieldError, type ReceiptErrorCode, type ReceiptFieldError, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, remainingQuantities, TIP_REFUND_SOURCES, type TipRefundSource, isTipRefundSource, openStaffTipCents, cancellationItemsForTip, cancellationCashRefundCents, asksTipRefundSource, asksRefundTip, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, type CashregisterAutoLogout, type CashregisterAutoLogoutPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, isZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
 export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, 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, ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS, type PublicCall, type PosCall, createTransport, createBinaryTransport, createPdfOrDataTransport, 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, type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, getCashregisterReport, type CashregisterReportPeriod, getReportV2, type ReportV2, type ReportV2Metadata, type ReportV2Options, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
 export { type ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, type ReceiptDueErrorReason, receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, } from './receipt/due.js';
 export { parseServerTimeStamp, toViennaWallClock, type ViennaWallClock } from './vienna-time.js';

package/dist/cjs/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptSumCents = exports.receiptSubSumCents = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = exports.StripeLinkMode = exports.VoucherAction = exports.VoucherType = exports.CreditCardProvider = exports.KeckPaymentMethod = exports.VatRate = exports.ReceiptType = void 0;
-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.createPdfOrDataTransport = exports.createBinaryTransport = exports.createTransport = exports.UNKNOWN_OUTCOME_CALLS = exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = exports.DEFAULT_TIMEOUT_MS = exports.POS_BASE_URL = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.remainingQuantities = void 0;
-exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = exports.getPosSettings = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.mergePosSettings = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.toViennaWallClock = exports.parseServerTimeStamp = exports.isReceiptDueError = exports.RECEIPT_DUE_ERROR_REASONS = exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.getReportV2 = exports.getCashregisterReport = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyCashregisters = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = void 0;
+exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptValueVoucherSign = exports.receiptSumCents = exports.receiptSubSumCents = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = exports.StripeLinkMode = exports.VoucherAction = exports.VoucherType = exports.CreditCardProvider = exports.KeckPaymentMethod = exports.VatRate = exports.ReceiptType = void 0;
+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.createPdfOrDataTransport = exports.createBinaryTransport = exports.createTransport = exports.UNKNOWN_OUTCOME_CALLS = exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = exports.DEFAULT_TIMEOUT_MS = exports.POS_BASE_URL = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.asksRefundTip = exports.asksTipRefundSource = exports.cancellationCashRefundCents = exports.cancellationItemsForTip = exports.openStaffTipCents = exports.isTipRefundSource = exports.TIP_REFUND_SOURCES = exports.remainingQuantities = exports.receiptFieldErrors = void 0;
+exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = exports.getPosSettings = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.mergePosSettings = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.toViennaWallClock = exports.parseServerTimeStamp = exports.isReceiptDueError = exports.RECEIPT_DUE_ERROR_REASONS = exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.getReportV2 = exports.getCashregisterReport = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyCashregisters = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.cancelReceipt = exports.receiptLayoutFromResult = exports.cardRefundReference = exports.paymentsExpectedCents = exports.sellReceiptWithCompany = exports.sellReceipt = void 0;
 var index_js_1 = require("./enums/index.js");
 Object.defineProperty(exports, "ReceiptType", { enumerable: true, get: function () { return index_js_1.ReceiptType; } });
 Object.defineProperty(exports, "VatRate", { enumerable: true, get: function () { return index_js_1.VatRate; } });
@@ -25,6 +25,7 @@ Object.defineProperty(exports, "toReceiptPayload", { enumerable: true, get: func
 Object.defineProperty(exports, "fromReceiptPayload", { enumerable: true, get: function () { return index_js_2.fromReceiptPayload; } });
 Object.defineProperty(exports, "receiptSubSumCents", { enumerable: true, get: function () { return index_js_2.receiptSubSumCents; } });
 Object.defineProperty(exports, "receiptSumCents", { enumerable: true, get: function () { return index_js_2.receiptSumCents; } });
+Object.defineProperty(exports, "receiptValueVoucherSign", { enumerable: true, get: function () { return index_js_2.receiptValueVoucherSign; } });
 Object.defineProperty(exports, "RETURN_DISPOSITIONS", { enumerable: true, get: function () { return index_js_2.RETURN_DISPOSITIONS; } });
 Object.defineProperty(exports, "CANCELLATION_REASONS", { enumerable: true, get: function () { return index_js_2.CANCELLATION_REASONS; } });
 Object.defineProperty(exports, "CANCELLATION_STATUSES", { enumerable: true, get: function () { return index_js_2.CANCELLATION_STATUSES; } });
@@ -56,6 +57,13 @@ Object.defineProperty(exports, "receiptErrorCode", { enumerable: true, get: func
 Object.defineProperty(exports, "isReceiptError", { enumerable: true, get: function () { return index_js_2.isReceiptError; } });
 Object.defineProperty(exports, "receiptFieldErrors", { enumerable: true, get: function () { return index_js_2.receiptFieldErrors; } });
 Object.defineProperty(exports, "remainingQuantities", { enumerable: true, get: function () { return index_js_2.remainingQuantities; } });
+Object.defineProperty(exports, "TIP_REFUND_SOURCES", { enumerable: true, get: function () { return index_js_2.TIP_REFUND_SOURCES; } });
+Object.defineProperty(exports, "isTipRefundSource", { enumerable: true, get: function () { return index_js_2.isTipRefundSource; } });
+Object.defineProperty(exports, "openStaffTipCents", { enumerable: true, get: function () { return index_js_2.openStaffTipCents; } });
+Object.defineProperty(exports, "cancellationItemsForTip", { enumerable: true, get: function () { return index_js_2.cancellationItemsForTip; } });
+Object.defineProperty(exports, "cancellationCashRefundCents", { enumerable: true, get: function () { return index_js_2.cancellationCashRefundCents; } });
+Object.defineProperty(exports, "asksTipRefundSource", { enumerable: true, get: function () { return index_js_2.asksTipRefundSource; } });
+Object.defineProperty(exports, "asksRefundTip", { enumerable: true, get: function () { return index_js_2.asksRefundTip; } });
 Object.defineProperty(exports, "fromReceiptCompanyPayload", { enumerable: true, get: function () { return index_js_2.fromReceiptCompanyPayload; } });
 Object.defineProperty(exports, "receiptCompanyTaxInfo", { enumerable: true, get: function () { return index_js_2.receiptCompanyTaxInfo; } });
 Object.defineProperty(exports, "fromCashregisterPayload", { enumerable: true, get: function () { return index_js_2.fromCashregisterPayload; } });

package/dist/cjs/inventory/vertrag.d.ts

@@ -126,7 +126,7 @@ export type InventoryErrorCode = (typeof INVENTORY_ERROR_CODES)[number];
  * `route_missing` (Code des Pakets). Dieselbe Ableitung wie bei der
  * Rechnungs-API.
  */
-export declare const INVENTORY_REQUEST_ERROR_CODES: readonly ["account_not_found", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "route_missing"];
+export declare const INVENTORY_REQUEST_ERROR_CODES: readonly ["account_not_found", "action_confirmation_required", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "dialect_mismatch", "internal_translation_error", "live_not_enabled", "method_not_allowed", "mfa_required", "not_found", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "second_factor_required", "session_expired", "session_other_cashregister", "unauthorized", "user_disabled", "user_verification_failed", "route_missing"];
 export type InventoryRequestErrorCode = (typeof INVENTORY_REQUEST_ERROR_CODES)[number];
 /**
  * Hinweise einer Buchung (`warnings[].code`, `warningCodes.inventory`). Sie sind