@kreiseck/kasseneck-api 1.36.0 → 1.37.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (115) hide show
  1. package/CHANGELOG.md +24 -1
  2. package/dist/cjs/client/aufrufe.d.ts +2 -2
  3. package/dist/cjs/client/aufrufe.js +5 -0
  4. package/dist/cjs/client/receipts.d.ts +1 -1
  5. package/dist/cjs/payments/hobex-hps/index.d.ts +2 -1
  6. package/dist/cjs/payments/hobex-hps/index.js +3 -1
  7. package/dist/cjs/payments/hobex-hps/outcome.d.ts +10 -0
  8. package/dist/cjs/payments/hobex-hps/payments.d.ts +54 -0
  9. package/dist/cjs/payments/hobex-hps/payments.js +157 -1
  10. package/dist/cjs/payments/hobex-hps/support.d.ts +19 -0
  11. package/dist/cjs/payments/hobex-hps/support.js +22 -0
  12. package/dist/cjs/payments/hobex-hps/transaction-response.js +1 -1
  13. package/dist/cjs/payments/index.d.ts +1 -1
  14. package/dist/cjs/payments/index.js +2 -1
  15. package/dist/cjs/pos/errors.d.ts +1 -1
  16. package/dist/cjs/pos/errors.js +1 -0
  17. package/dist/cjs/pos/index.d.ts +4 -4
  18. package/dist/cjs/pos/index.js +13 -5
  19. package/dist/cjs/pos/schicht-lesen.d.ts +3 -1
  20. package/dist/cjs/pos/schicht-lesen.js +23 -1
  21. package/dist/cjs/pos/schicht-typen.d.ts +39 -4
  22. package/dist/cjs/pos/schicht-typen.js +7 -2
  23. package/dist/cjs/pos/schicht.d.ts +6 -4
  24. package/dist/cjs/pos/schicht.js +6 -3
  25. package/dist/cjs/pos/settings.d.ts +37 -8
  26. package/dist/cjs/pos/settings.js +34 -10
  27. package/dist/cjs/pos/texte.d.ts +249 -2
  28. package/dist/cjs/pos/texte.js +139 -4
  29. package/dist/cjs/pos/trinkgeld.d.ts +30 -0
  30. package/dist/cjs/pos/trinkgeld.js +30 -0
  31. package/dist/cjs/receipt/shift-sheet.js +6 -1
  32. package/dist/cjs/register/pairing.d.ts +4 -0
  33. package/dist/cjs/register/pairing.js +2 -0
  34. package/dist/cjs/stored/vokabular.d.ts +1 -1
  35. package/dist/cjs/stored/vokabular.js +12 -1
  36. package/dist/cjs/version.d.ts +1 -1
  37. package/dist/cjs/version.js +1 -1
  38. package/dist/esm/client/aufrufe.d.ts +2 -2
  39. package/dist/esm/client/aufrufe.js +5 -0
  40. package/dist/esm/client/receipts.d.ts +1 -1
  41. package/dist/esm/payments/hobex-hps/index.d.ts +2 -1
  42. package/dist/esm/payments/hobex-hps/index.js +1 -0
  43. package/dist/esm/payments/hobex-hps/outcome.d.ts +10 -0
  44. package/dist/esm/payments/hobex-hps/payments.d.ts +54 -0
  45. package/dist/esm/payments/hobex-hps/payments.js +158 -2
  46. package/dist/esm/payments/hobex-hps/support.d.ts +19 -0
  47. package/dist/esm/payments/hobex-hps/support.js +19 -0
  48. package/dist/esm/payments/hobex-hps/transaction-response.js +1 -1
  49. package/dist/esm/payments/index.d.ts +1 -1
  50. package/dist/esm/payments/index.js +1 -1
  51. package/dist/esm/pos/errors.d.ts +1 -1
  52. package/dist/esm/pos/errors.js +1 -0
  53. package/dist/esm/pos/index.d.ts +4 -4
  54. package/dist/esm/pos/index.js +5 -5
  55. package/dist/esm/pos/schicht-lesen.d.ts +3 -1
  56. package/dist/esm/pos/schicht-lesen.js +22 -1
  57. package/dist/esm/pos/schicht-typen.d.ts +39 -4
  58. package/dist/esm/pos/schicht-typen.js +6 -1
  59. package/dist/esm/pos/schicht.d.ts +6 -4
  60. package/dist/esm/pos/schicht.js +6 -3
  61. package/dist/esm/pos/settings.d.ts +37 -8
  62. package/dist/esm/pos/settings.js +30 -9
  63. package/dist/esm/pos/texte.d.ts +249 -2
  64. package/dist/esm/pos/texte.js +138 -3
  65. package/dist/esm/pos/trinkgeld.d.ts +30 -0
  66. package/dist/esm/pos/trinkgeld.js +28 -0
  67. package/dist/esm/receipt/shift-sheet.js +6 -1
  68. package/dist/esm/register/pairing.d.ts +4 -0
  69. package/dist/esm/register/pairing.js +2 -0
  70. package/dist/esm/stored/vokabular.d.ts +1 -1
  71. package/dist/esm/stored/vokabular.js +12 -1
  72. package/dist/esm/version.d.ts +1 -1
  73. package/dist/esm/version.js +1 -1
  74. package/fixtures/duplicate-cases.json +1 -1
  75. package/fixtures/expected/duplicate.shift-close.hex +1 -1
  76. package/fixtures/expected/shift-close-card-tips.grid32.txt +44 -0
  77. package/fixtures/expected/shift-close-card-tips.grid48.txt +40 -0
  78. package/fixtures/expected/shift-close-card-tips.lines.json +479 -0
  79. package/fixtures/expected/shift-close-put-in.grid32.txt +1 -1
  80. package/fixtures/expected/shift-close-put-in.grid48.txt +1 -1
  81. package/fixtures/expected/shift-close-put-in.lines.json +1 -1
  82. package/fixtures/expected/shift-close-take-out.grid32.txt +1 -1
  83. package/fixtures/expected/shift-close-take-out.grid48.txt +1 -1
  84. package/fixtures/expected/shift-close-take-out.lines.json +1 -1
  85. package/fixtures/expected/shift-close.grid32.txt +1 -1
  86. package/fixtures/expected/shift-close.grid48.txt +1 -1
  87. package/fixtures/expected/shift-close.lines.json +1 -1
  88. package/fixtures/expected/shift-interim-card-tips.grid32.txt +34 -0
  89. package/fixtures/expected/shift-interim-card-tips.grid48.txt +31 -0
  90. package/fixtures/expected/shift-interim-card-tips.lines.json +344 -0
  91. package/fixtures/hobex-hps-codes.json +2 -2
  92. package/fixtures/invoice-api.schema.json +1 -1
  93. package/fixtures/invoice-texts.json +1 -1
  94. package/fixtures/pos-texts.json +300 -3
  95. package/fixtures/renames-1.0.json +10 -0
  96. package/fixtures/shift-ablauf-cases.json +4 -4
  97. package/fixtures/shift-cases.json +4 -2
  98. package/fixtures/shift-receipts-card-tips.json +73 -0
  99. package/fixtures/shift-receipts.json +9 -9
  100. package/fixtures/stored/card-tip-cases.json +132 -0
  101. package/fixtures/surface.json +21 -5
  102. package/fixtures/v3/antworten/belege.json +1 -1
  103. package/fixtures/v3/antworten/belegmail.json +1 -1
  104. package/fixtures/v3/antworten/berichte.json +1 -1
  105. package/fixtures/v3/antworten/kasse-belege.json +1 -1
  106. package/fixtures/v3/antworten/kasse.json +240 -3
  107. package/fixtures/v3/antworten/lager.json +1 -1
  108. package/fixtures/v3/antworten/rechnungen.json +1 -1
  109. package/fixtures/v3/antworten/storno.json +1 -1
  110. package/fixtures/v3/stored/belege.json +1 -1
  111. package/fixtures/v3/stored/kasse.json +2 -2
  112. package/fixtures/v3/stored/rechnungen.json +1 -1
  113. package/fixtures/v3/v3-vokabular.json +103 -14
  114. package/fixtures/v3/zahlbetrag-faelle.json +1 -1
  115. package/package.json +1 -1
@@ -6,7 +6,7 @@
6
6
  * die Backend-Functions (die Rewrites-Waechter der Web-App leiten daraus ab)
7
7
  * und sprechen den Kassenweg `/api/v3` (Schluessel und Werte englisch).
8
8
  */
9
- export { type PosTheme, type PosFontSize, type PosWatermark, type PosQuantity, type PosTipMode, type PosCheckoutMode, type PosCardProvider, type PosReceiptOutput, type PosShortcutAction, type PosShortcutMap, POS_SHORTCUT_ACTIONS, POS_SHORTCUT_DEFAULTS, type PosLayout, type PosCategoryPosition, type PosTileHeight, type PosPrinterType, type PosTerminalVia, type PosTerminalType, type PosPaperSize, type PosCodePage, type PosCut, type PosDrawerAutoOpen, type PosQrMode, type PosLogoSize, type PosSettingsFontSize, type PosTileStyle, type PosAutoLogoutMinutes, type PosDiscount, type PosWatermarkSide, type PosWatermarkStrength, type PosLogoScale, type PosWatermarkScale, type PosDoneScreenSeconds, type PosToggleMap, type PosBusinessSettings, type PosDeviceSettings, type PosSettings, POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, POS_DEVICE_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_CHOICES, POS_DEVICE_OPTIONAL_CHOICES, posTipKeptByDefault, posCustomDiscountAllowed, posTipKeptMode, tipKeptFor, type TipKeptDecision, DISCOUNT_PRESET_KIND, type PosDiscountPreset, type PosDiscountPresetKind, POS_BUSINESS_OPTIONAL_LISTS, posTipKinds, posTipStart, posCartWidth, POS_BUSINESS_VALUES, POS_DEVICE_VALUES, mergePosSettings, sanitizePosSettings, unknownPosSettingValues, posSettingsChanges, type PosOpen, POS_SHORTCUT_SHARED_PAIRS, posShortcutConflict, THEME, FONT_SIZE, WATERMARK, QUANTITY, TIP_MODE, TIP_KINDS, TIP_START, TIP_KEPT_MODE, type PosTipKeptMode, CART_WIDTH, type PosTipKind, type PosCartWidth, CHECKOUT_MODE, CARD_PROVIDER, RECEIPT_OUTPUT, LAYOUT, CATEGORY_POSITION, TILE_HEIGHT, PRINTER_TYPE, TERMINAL_VIA, TERMINAL_TYPE, PAPER_SIZE, CODE_PAGE, CUT, DRAWER_AUTO_OPEN, QR_MODE, LOGO_SIZE, SETTINGS_FONT_SIZE, TILE_STYLE, AUTO_LOGOUT_MINUTES, DISCOUNT, WATERMARK_SIDE, WATERMARK_STRENGTH, LOGO_SCALE, WATERMARK_SCALE, DONE_SCREEN_SECONDS, } from './settings.js';
9
+ export { type PosTheme, type PosFontSize, type PosWatermark, type PosQuantity, type PosTipMode, type PosCheckoutMode, type PosCardProvider, type PosReceiptOutput, type PosShortcutAction, type PosShortcutMap, POS_SHORTCUT_ACTIONS, POS_SHORTCUT_DEFAULTS, type PosLayout, type PosCategoryPosition, type PosTileHeight, type PosPrinterType, type PosTerminalVia, type PosTerminalType, type PosPaperSize, type PosCodePage, type PosCut, type PosDrawerAutoOpen, type PosQrMode, type PosLogoSize, type PosSettingsFontSize, type PosTileStyle, type PosAutoLogoutMinutes, type PosDiscount, type PosWatermarkSide, type PosWatermarkStrength, type PosLogoScale, type PosWatermarkScale, type PosDoneScreenSeconds, type PosToggleMap, type PosBusinessSettings, type PosDeviceSettings, type PosSettings, POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, POS_DEVICE_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_CHOICES, POS_DEVICE_OPTIONAL_CHOICES, posTipKeptByDefault, posCustomDiscountAllowed, posTipKeptMode, posTipCardKeptByDefault, posTipCardKeptMode, posTipSelfPayout, tipKeptFor, type TipKeptDecision, type TipPaymentKind, DISCOUNT_PRESET_KIND, type PosDiscountPreset, type PosDiscountPresetKind, POS_BUSINESS_OPTIONAL_LISTS, posTipKinds, posTipStart, posCartWidth, POS_BUSINESS_VALUES, POS_DEVICE_VALUES, mergePosSettings, sanitizePosSettings, unknownPosSettingValues, posSettingsChanges, type PosOpen, POS_SHORTCUT_SHARED_PAIRS, posShortcutConflict, THEME, FONT_SIZE, WATERMARK, QUANTITY, TIP_MODE, TIP_KINDS, TIP_START, TIP_KEPT_MODE, TIP_CARD_KEPT_MODE, type PosTipKeptMode, CART_WIDTH, type PosTipKind, type PosCartWidth, CHECKOUT_MODE, CARD_PROVIDER, RECEIPT_OUTPUT, LAYOUT, CATEGORY_POSITION, TILE_HEIGHT, PRINTER_TYPE, TERMINAL_VIA, TERMINAL_TYPE, PAPER_SIZE, CODE_PAGE, CUT, DRAWER_AUTO_OPEN, QR_MODE, LOGO_SIZE, SETTINGS_FONT_SIZE, TILE_STYLE, AUTO_LOGOUT_MINUTES, DISCOUNT, WATERMARK_SIDE, WATERMARK_STRENGTH, LOGO_SCALE, WATERMARK_SCALE, DONE_SCREEN_SECONDS, } from './settings.js';
10
10
  export { type ArticleGroup, type ArticleGroupPayload, fromArticleGroupPayload, type PosArticle, type PosArticlePayload, fromPosArticlePayload, listMyArticleGroups, listMyArticles, QUANTITY_RULES, type QuantityRule, type QuantityDefaults, quantityRuleForUnit, quantityDefaults, allowedQuantity, isBookableArticle, tilePrompts, } from './artikel.js';
11
11
  export { REFERENCE_MODES, type ReferenceMode, type PosReference, REFERENCE_INPUT_MAX, REFERENCE_LABEL_MAX, REFERENCE_HINT_MAX, REFERENCE_PATTERN_MAX, REFERENCE_PATTERN_TEMPLATES, cleanReferenceText, isValidReferencePattern, isDigitsOnlyPattern, type ReferenceCheckResult, checkReference, referenceLineName, fromReferencePayload, } from './kachel-referenz.js';
12
12
  export { ADD_ONS_MAX, ADD_ON_BLOCK_REASONS, type AddOnBlockReason, isSelectableAddOn, addOnsFor, addOnReferencesValid, addOnsOfItem, addOnRemap, addOnDisplayOrder, orderAddOnLines, } from './zusaetze.js';
@@ -19,7 +19,7 @@ export { distributeDiscount } from '../receipt/discount.js';
19
19
  export { cancelScopeOf, receiptsScopeOf, stockViewOf, voucherPermsOf, depositReturnOf, type VoucherPerms, type RegisterScope, type RegisterUserPerms } from '../register/pairing.js';
20
20
  export { type NetworkPrinter, type PrintJob, type PrintJobStatus, PRINT_JOB_STATUSES, type PrintJobSource, PRINT_JOB_SOURCES, isPrintJobFinished, type CreatePrintJobOptions, listMyPrinters, createPrintJob, getPrintJob, } from './drucker.js';
21
21
  export { type PrinterCatalogEntry, type PrinterCatalogValues, type PrinterCatalogValueField, type PrinterCatalogApproval, type PrinterDeviceTest, type PrinterCatalogSettings, type PrinterCatalogDeviceSettings, type PrinterCatalogCut, type PrinterCatalogQrMode, printerCatalogEntry, printerCatalogSettings, } from './drucker-katalog.js';
22
- export { listMyTipRecipients } from './trinkgeld.js';
22
+ export { listMyTipRecipients, getMyTipBalance, tipStatus, type GetMyTipBalanceOptions, type TipStatus, type TipStatusKind } from './trinkgeld.js';
23
23
  export { posDiscountPresets, discountPresetChipText, discountChipsFromPresets, checkDiscountPresets, discountBlockLines, INVALID_DISCOUNT_PRESET, DISCOUNT_PRESETS_MAX, DISCOUNT_PRESET_NAME_MAX, DISCOUNT_PRESET_PERCENT_BP, DISCOUNT_PRESET_AMOUNT_CENTS, DISCOUNT_PRESET_MESSAGES, type DiscountPresetReason, type DiscountPresetError, type DiscountPresetsCheck, type DiscountBlockLine, type DiscountTotal, } from './rabatt-vorlagen.js';
24
24
  export { depFolderName } from './dep.js';
25
25
  export { type RegisterInspectionInfo, type RegisterInspectionSignature, type InspectionSignatureStatus, type InspectionInfoRow, type InspectionInfoRowKey, type InspectionInfoSection, type InspectionInfoLinesOptions, getRegisterInspectionInfo, inspectionInfoRows, inspectionInfoLines, } from './kasseninfo.js';
@@ -31,9 +31,9 @@ export type { Stocktake, StocktakeItem, StocktakeCount, StocktakeCountResult, St
31
31
  export type { StocktakeStatus } from '../inventory/vertrag.js';
32
32
  export { VOUCHER_KINDS, VOUCHER_STATUSES, checkVoucher, reprintVoucherLabel, VOUCHER_SETTINGS_DEFAULTS, posVoucherSettingsFromWire, VOUCHER_PAYOUTS, VOUCHER_TYPE_KINDS, VOUCHER_AMOUNT_MODES, VOUCHER_TYPE_VALIDITY_PATTERNS, EXTERNAL_VOUCHERS, type PosExternalVouchers, type VoucherKind, type VoucherStatus, type VoucherValidity, type VoucherArticle, type VoucherCheck, type PosVoucherSettings, type PosVoucherReturnType, type VoucherPayout, type VoucherTypeKind, type PosVoucherType, type VoucherLabelTemplate, } from './gutschein.js';
33
33
  export { type GetMyDrawerStateOptions, type OpenMyShiftOptions, type RecordMyCashMovementOptions, type DrawerOpeningEntry, type LogMyDrawerOpeningsOptions, type GetMyShiftReportOptions, type TipPayout, type CloseMyShiftOptions, type AfterCountOption, type RecordMyShiftCountOptions, getMyDrawerState, openMyShift, recordMyCashMovement, logMyDrawerOpenings, getMyShiftReport, closeMyShift, recordMyShiftCount, sumDenominations, parseCentsAllowZero, newIdempotencyKey, shiftTipLines, durationText, type ShiftTipLine, type ShiftTipLineKey, } from './schicht.js';
34
- export { EUR_DENOMINATIONS, MOVEMENT_TYPES, MANUAL_MOVEMENT_TYPES, CASH_LOCATIONS, OPENING_REASONS, MANUAL_OPENING_REASONS, SHIFT_RECEIPT_KINDS, AFTER_COUNT_TYPES, type AfterCountType, type AfterCount, EXPECTED_PART_KEYS, DIFFERENCE_PART_TYPES, type ExpectedPartKey, type ShiftExpectedPart, type DifferencePartType, type ShiftDifferencePart, type LastShift, type ShiftCountResult, type EurDenomination, type MovementType, type ManualMovementType, type CashLocation, type OpeningReason, type ManualOpeningReason, type ShiftReceiptKind, type ShiftStatus, type ShiftActorRole, type Denominations, type ShiftActor, type DrawerInfo, type DrawerRights, type NonCashAmount, type ShiftTipTotals, type ShiftTip, type ShiftOwnerTip, type ShiftDiscount, type ShiftRunningTotals, type ShiftReconciliation, type Shift, type TipClaim, type DrawerOpening, type DrawerState, type CashMovement, type ShiftReceiptHeader, type ShiftReceiptMovement, type ShiftReceiptTip, type ShiftSummaryReceipt, type CashMovementReceipt, type ShiftReceipt, type OpenShiftResult, type CashMovementResult, type DrawerOpeningsResult, type ShiftReport, type CloseShiftResult, } from './schicht-typen.js';
34
+ export { EUR_DENOMINATIONS, MOVEMENT_TYPES, MANUAL_MOVEMENT_TYPES, CASH_LOCATIONS, OPENING_REASONS, MANUAL_OPENING_REASONS, SHIFT_RECEIPT_KINDS, AFTER_COUNT_TYPES, type AfterCountType, type AfterCount, EXPECTED_PART_KEYS, DIFFERENCE_PART_TYPES, type ExpectedPartKey, type ShiftExpectedPart, type DifferencePartType, type ShiftDifferencePart, type LastShift, type ShiftCountResult, type EurDenomination, type MovementType, type ManualMovementType, type CashLocation, type OpeningReason, type ManualOpeningReason, type ShiftReceiptKind, type ShiftStatus, type ShiftActorRole, type Denominations, type ShiftActor, type DrawerInfo, type DrawerRights, type NonCashAmount, type ShiftTipTotals, type ShiftTip, type ShiftOwnerTip, type ShiftDiscount, type ShiftRunningTotals, type ShiftReconciliation, type Shift, type TipClaim, type DrawerOpening, type DrawerState, type CashMovement, type ShiftReceiptHeader, type ShiftReceiptMovement, type ShiftReceiptTip, TIP_CLAIM_SCOPES, type TipClaimScope, type TipBalance, type TipBalanceOtherDrawer, type ShiftSummaryReceipt, type CashMovementReceipt, type ShiftReceipt, type OpenShiftResult, type CashMovementResult, type DrawerOpeningsResult, type ShiftReport, type CloseShiftResult, } from './schicht-typen.js';
35
35
  export { type ShiftReceiptLayoutOptions, shiftReceiptLayout, cashMovementLayout } from '../receipt/shift-sheet.js';
36
36
  export { RECEIPT_OUTPUT_KINDS, RECEIPT_OUTPUT_RESULTS, type ReceiptOutputKind, type ReceiptOutputResult } from '../models/receipt-output.js';
37
37
  export { RETURN_DISPOSITIONS, isReturnDisposition, type ReturnDisposition } from '../models/cancellation.js';
38
- export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, CANCELLATION_VOUCHER_ERROR_MESSAGES, cancellationErrorMessage, VOUCHER_ERROR_MESSAGES, voucherErrorMessage, DEPOSIT_ERROR_MESSAGES, depositErrorMessage, EXTERNAL_VOUCHER_TILE_MESSAGES, EXTERNAL_VOUCHER_ARTICLE_MESSAGES, externalVoucherArticleErrorMessage, EXTERNAL_VOUCHERS_LABELS, EXTERNAL_VOUCHER_KIND_LABELS, TIP_KEPT_MODE_LABELS, LABELS, labelText, RETURN_DISPOSITION_LABELS, receiptOutputLabel, type TextEntry, type MessageKey, type ErrorKind, type ErrorRule, type ErrorRuleDetail, type Surface, type ReceiptEmailMessageCode, type CancellationPaymentMessageCode, type LabelKey, } from './texte.js';
38
+ export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, CANCELLATION_VOUCHER_ERROR_MESSAGES, cancellationErrorMessage, VOUCHER_ERROR_MESSAGES, voucherErrorMessage, DEPOSIT_ERROR_MESSAGES, depositErrorMessage, EXTERNAL_VOUCHER_TILE_MESSAGES, EXTERNAL_VOUCHER_ARTICLE_MESSAGES, externalVoucherArticleErrorMessage, EXTERNAL_VOUCHERS_LABELS, EXTERNAL_VOUCHER_KIND_LABELS, TIP_KEPT_MODE_LABELS, TIP_CLAIM_SCOPE_LABELS, LABELS, labelText, RETURN_DISPOSITION_LABELS, receiptOutputLabel, type TextEntry, type MessageKey, type ErrorKind, type ErrorRule, type ErrorRuleDetail, type Surface, type ReceiptEmailMessageCode, type CancellationPaymentMessageCode, type LabelKey, } from './texte.js';
39
39
  export { roundUpSuggestions } from './aufrunden.js';
@@ -6,9 +6,9 @@
6
6
  * die Backend-Functions (die Rewrites-Waechter der Web-App leiten daraus ab)
7
7
  * und sprechen den Kassenweg `/api/v3` (Schluessel und Werte englisch).
8
8
  */
9
- export { POS_SHORTCUT_ACTIONS, POS_SHORTCUT_DEFAULTS, POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, POS_DEVICE_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_CHOICES, POS_DEVICE_OPTIONAL_CHOICES, posTipKeptByDefault, posCustomDiscountAllowed, posTipKeptMode, tipKeptFor, DISCOUNT_PRESET_KIND, POS_BUSINESS_OPTIONAL_LISTS, posTipKinds, posTipStart, posCartWidth, POS_BUSINESS_VALUES, POS_DEVICE_VALUES, mergePosSettings, sanitizePosSettings, unknownPosSettingValues, posSettingsChanges, POS_SHORTCUT_SHARED_PAIRS, posShortcutConflict,
9
+ export { POS_SHORTCUT_ACTIONS, POS_SHORTCUT_DEFAULTS, POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, POS_DEVICE_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_CHOICES, POS_DEVICE_OPTIONAL_CHOICES, posTipKeptByDefault, posCustomDiscountAllowed, posTipKeptMode, posTipCardKeptByDefault, posTipCardKeptMode, posTipSelfPayout, tipKeptFor, DISCOUNT_PRESET_KIND, POS_BUSINESS_OPTIONAL_LISTS, posTipKinds, posTipStart, posCartWidth, POS_BUSINESS_VALUES, POS_DEVICE_VALUES, mergePosSettings, sanitizePosSettings, unknownPosSettingValues, posSettingsChanges, POS_SHORTCUT_SHARED_PAIRS, posShortcutConflict,
10
10
  // Die Enums als Laufzeitlisten, benannt nach ihrem Feld.
11
- THEME, FONT_SIZE, WATERMARK, QUANTITY, TIP_MODE, TIP_KINDS, TIP_START, TIP_KEPT_MODE, CART_WIDTH, CHECKOUT_MODE, CARD_PROVIDER, RECEIPT_OUTPUT, LAYOUT, CATEGORY_POSITION, TILE_HEIGHT, PRINTER_TYPE, TERMINAL_VIA, TERMINAL_TYPE, PAPER_SIZE, CODE_PAGE, CUT, DRAWER_AUTO_OPEN, QR_MODE, LOGO_SIZE, SETTINGS_FONT_SIZE, TILE_STYLE, AUTO_LOGOUT_MINUTES, DISCOUNT, WATERMARK_SIDE, WATERMARK_STRENGTH, LOGO_SCALE, WATERMARK_SCALE, DONE_SCREEN_SECONDS, } from './settings.js';
11
+ THEME, FONT_SIZE, WATERMARK, QUANTITY, TIP_MODE, TIP_KINDS, TIP_START, TIP_KEPT_MODE, TIP_CARD_KEPT_MODE, CART_WIDTH, CHECKOUT_MODE, CARD_PROVIDER, RECEIPT_OUTPUT, LAYOUT, CATEGORY_POSITION, TILE_HEIGHT, PRINTER_TYPE, TERMINAL_VIA, TERMINAL_TYPE, PAPER_SIZE, CODE_PAGE, CUT, DRAWER_AUTO_OPEN, QR_MODE, LOGO_SIZE, SETTINGS_FONT_SIZE, TILE_STYLE, AUTO_LOGOUT_MINUTES, DISCOUNT, WATERMARK_SIDE, WATERMARK_STRENGTH, LOGO_SCALE, WATERMARK_SCALE, DONE_SCREEN_SECONDS, } from './settings.js';
12
12
  export { fromArticleGroupPayload, fromPosArticlePayload, listMyArticleGroups, listMyArticles, QUANTITY_RULES, quantityRuleForUnit, quantityDefaults, allowedQuantity, isBookableArticle, tilePrompts, } from './artikel.js';
13
13
  export { REFERENCE_MODES, REFERENCE_INPUT_MAX, REFERENCE_LABEL_MAX, REFERENCE_HINT_MAX, REFERENCE_PATTERN_MAX, REFERENCE_PATTERN_TEMPLATES, cleanReferenceText, isValidReferencePattern, isDigitsOnlyPattern, checkReference, referenceLineName, fromReferencePayload, } from './kachel-referenz.js';
14
14
  export { ADD_ONS_MAX, ADD_ON_BLOCK_REASONS, isSelectableAddOn, addOnsFor, addOnReferencesValid, addOnsOfItem, addOnRemap, addOnDisplayOrder, orderAddOnLines, } from './zusaetze.js';
@@ -26,7 +26,7 @@ export { PRINT_JOB_STATUSES, PRINT_JOB_SOURCES, isPrintJobFinished, listMyPrinte
26
26
  // Druckerkatalog (Connect-Einrichtung mit einem Klick): Normierung, Pruefung und der Katalog selbst bleiben im Modul,
27
27
  // nach aussen gehen nur das Erkennen und die vorgeschlagenen Einstellungen.
28
28
  export { printerCatalogEntry, printerCatalogSettings, } from './drucker-katalog.js';
29
- export { listMyTipRecipients } from './trinkgeld.js';
29
+ export { listMyTipRecipients, getMyTipBalance, tipStatus } from './trinkgeld.js';
30
30
  export { posDiscountPresets, discountPresetChipText, discountChipsFromPresets, checkDiscountPresets, discountBlockLines, INVALID_DISCOUNT_PRESET, DISCOUNT_PRESETS_MAX, DISCOUNT_PRESET_NAME_MAX, DISCOUNT_PRESET_PERCENT_BP, DISCOUNT_PRESET_AMOUNT_CENTS, DISCOUNT_PRESET_MESSAGES, } from './rabatt-vorlagen.js';
31
31
  // Prüfung (DEP) an der Kasse: Ordner auf dem USB-Stick (gleich in Web-Kasse und Kassen-App).
32
32
  export { depFolderName } from './dep.js';
@@ -41,12 +41,12 @@ export { listMyStocktakes, listMyStocktakeItems, listMyStocktakeCounts, recordMy
41
41
  export { VOUCHER_KINDS, VOUCHER_STATUSES, checkVoucher, reprintVoucherLabel, VOUCHER_SETTINGS_DEFAULTS, posVoucherSettingsFromWire, VOUCHER_PAYOUTS, VOUCHER_TYPE_KINDS, VOUCHER_AMOUNT_MODES, VOUCHER_TYPE_VALIDITY_PATTERNS, EXTERNAL_VOUCHERS, } from './gutschein.js';
42
42
  // Schicht, Kassenstand und Lade-Protokoll (1.9.0): Aufrufe, Kataloge, Helfer, Bons.
43
43
  export { getMyDrawerState, openMyShift, recordMyCashMovement, logMyDrawerOpenings, getMyShiftReport, closeMyShift, recordMyShiftCount, sumDenominations, parseCentsAllowZero, newIdempotencyKey, shiftTipLines, durationText, } from './schicht.js';
44
- export { EUR_DENOMINATIONS, MOVEMENT_TYPES, MANUAL_MOVEMENT_TYPES, CASH_LOCATIONS, OPENING_REASONS, MANUAL_OPENING_REASONS, SHIFT_RECEIPT_KINDS, AFTER_COUNT_TYPES, EXPECTED_PART_KEYS, DIFFERENCE_PART_TYPES, } from './schicht-typen.js';
44
+ export { EUR_DENOMINATIONS, MOVEMENT_TYPES, MANUAL_MOVEMENT_TYPES, CASH_LOCATIONS, OPENING_REASONS, MANUAL_OPENING_REASONS, SHIFT_RECEIPT_KINDS, AFTER_COUNT_TYPES, EXPECTED_PART_KEYS, DIFFERENCE_PART_TYPES, TIP_CLAIM_SCOPES, } from './schicht-typen.js';
45
45
  export { shiftReceiptLayout, cashMovementLayout } from '../receipt/shift-sheet.js';
46
46
  // Ausgaben eines Belegs (Belegdetail: Art und Ergebnis -> Beschriftung); dieselben Listen wie an der Wurzel.
47
47
  export { RECEIPT_OUTPUT_KINDS, RECEIPT_OUTPUT_RESULTS } from '../models/receipt-output.js';
48
48
  // Rueckgabe-Wahl beim Storno (Kassen-Dialog); dieselbe Liste wie an der Wurzel.
49
49
  export { RETURN_DISPOSITIONS, isReturnDisposition } from '../models/cancellation.js';
50
50
  // Was die Kasse selbst sagt: ein Katalog fuer Browser-Kasse und App.
51
- export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, CANCELLATION_VOUCHER_ERROR_MESSAGES, cancellationErrorMessage, VOUCHER_ERROR_MESSAGES, voucherErrorMessage, DEPOSIT_ERROR_MESSAGES, depositErrorMessage, EXTERNAL_VOUCHER_TILE_MESSAGES, EXTERNAL_VOUCHER_ARTICLE_MESSAGES, externalVoucherArticleErrorMessage, EXTERNAL_VOUCHERS_LABELS, EXTERNAL_VOUCHER_KIND_LABELS, TIP_KEPT_MODE_LABELS, LABELS, labelText, RETURN_DISPOSITION_LABELS, receiptOutputLabel, } from './texte.js';
51
+ export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, CANCELLATION_VOUCHER_ERROR_MESSAGES, cancellationErrorMessage, VOUCHER_ERROR_MESSAGES, voucherErrorMessage, DEPOSIT_ERROR_MESSAGES, depositErrorMessage, EXTERNAL_VOUCHER_TILE_MESSAGES, EXTERNAL_VOUCHER_ARTICLE_MESSAGES, externalVoucherArticleErrorMessage, EXTERNAL_VOUCHERS_LABELS, EXTERNAL_VOUCHER_KIND_LABELS, TIP_KEPT_MODE_LABELS, TIP_CLAIM_SCOPE_LABELS, LABELS, labelText, RETURN_DISPOSITION_LABELS, receiptOutputLabel, } from './texte.js';
52
52
  export { roundUpSuggestions } from './aufrunden.js';
@@ -12,7 +12,7 @@
12
12
  * stehen im Modell genau dann, wenn der Server sie sendet.
13
13
  */
14
14
  import { type ValidationScope } from '../client/errors.js';
15
- import type { CashMovement, CashMovementReceipt, CashMovementResult, DrawerOpeningsResult, OpenShiftResult, ShiftReport, CloseShiftResult, ShiftCountResult, DrawerState, Shift, ShiftSummaryReceipt } from './schicht-typen.js';
15
+ import type { CashMovement, CashMovementReceipt, CashMovementResult, DrawerOpeningsResult, OpenShiftResult, ShiftReport, CloseShiftResult, ShiftCountResult, DrawerState, Shift, ShiftSummaryReceipt, TipBalance } from './schicht-typen.js';
16
16
  type Roh = Record<string, unknown>;
17
17
  /** Wer liest (fuer die Meldung) und wo im Rumpf. */
18
18
  export interface Ort {
@@ -26,6 +26,8 @@ export declare function pflichtObjekt(ort: Ort, w: unknown): Roh;
26
26
  /** Eine Schicht; was nur mit `cashView` kommt, steht nur, wenn gesendet. */
27
27
  export declare function schicht(ort: Ort, w: unknown): Shift;
28
28
  export declare function ladeStand(ort: Ort, w: unknown): DrawerState;
29
+ /** „Mein Trinkgeld“ (getMyTipBalance): Stand der angemeldeten Person, Drahtform Feld fuer Feld. */
30
+ export declare function tipStand(ort: Ort, w: unknown): TipBalance;
29
31
  export declare function bewegung(ort: Ort, w: unknown): CashMovement;
30
32
  /** Bon-Daten eines Z- oder X-Bons; eine andere Art ist ein Fehler. */
31
33
  export declare function schichtBon(ort: Ort, w: unknown): ShiftSummaryReceipt;
@@ -95,7 +95,7 @@ function unbar(ort, w) {
95
95
  }
96
96
  function trinkgeld(ort, w) {
97
97
  const o = pflichtObjekt(ort, w);
98
- return {
98
+ const raus = {
99
99
  registerUserId: kennung(ort, o, 'registerUserId'),
100
100
  name: text(o.name),
101
101
  receivedImmediatelyCents: ganzzahl(ort, o, 'receivedImmediatelyCents'),
@@ -104,6 +104,10 @@ function trinkgeld(ort, w) {
104
104
  // Fehlt bei einem Backend vor der Regel R62: dann 0, statt die ganze Antwort zu verwerfen.
105
105
  refundedByEmployeeCents: o.refundedByEmployeeCents === undefined || o.refundedByEmployeeCents === null ? 0 : ganzzahl(ort, o, 'refundedByEmployeeCents'),
106
106
  };
107
+ // Kartentrinkgeld bar genommen: der Server sendet es nur, wenn es eines gibt -- gelesen wie gesendet.
108
+ if (o.cardTipsTakenCents !== undefined && o.cardTipsTakenCents !== null)
109
+ raus.cardTipsTakenCents = ganzzahl(ort, o, 'cardTipsTakenCents');
110
+ return raus;
107
111
  }
108
112
  /** Trinkgeld mit offenem Anspruch (Kassenstand, Bon). */
109
113
  function trinkgeldMitOffen(ort, w) {
@@ -280,6 +284,21 @@ export function ladeStand(ort, w) {
280
284
  wennWert(raus.drawer, lade, 'changeFloatCents', () => ganzzahl(ladeOrt, lade, 'changeFloatCents'));
281
285
  return raus;
282
286
  }
287
+ /** „Mein Trinkgeld“ (getMyTipBalance): Stand der angemeldeten Person, Drahtform Feld fuer Feld. */
288
+ export function tipStand(ort, w) {
289
+ const o = pflichtObjekt(ort, w);
290
+ return {
291
+ drawerId: kennung(ort, o, 'drawerId'),
292
+ claimScope: kennung(ort, o, 'claimScope'),
293
+ openCents: ganzzahl(ort, o, 'openCents'),
294
+ keptTodayCents: ganzzahl(ort, o, 'keptTodayCents'),
295
+ currency: kennung(ort, o, 'currency'),
296
+ otherDrawers: liste(ort, o, 'otherDrawers', (lOrt, lw) => {
297
+ const l = pflichtObjekt(lOrt, lw);
298
+ return { drawerId: kennung(lOrt, l, 'drawerId'), name: text(l.name), openCents: ganzzahl(lOrt, l, 'openCents') };
299
+ }),
300
+ };
301
+ }
283
302
  export function bewegung(ort, w) {
284
303
  const o = pflichtObjekt(ort, w);
285
304
  const empfaenger = objekt(o.recipient);
@@ -367,6 +386,8 @@ export function schichtBon(ort, w) {
367
386
  wennWert(r, o, 'interimDifferenceCents', () => ganzzahl(ort, o, 'interimDifferenceCents'));
368
387
  // Nur Anzeige: gewaehrte Rabatte je Name; der Server sendet sie erst ab dem ersten Rabatt.
369
388
  wennWert(r, o, 'discounts', () => liste(ort, o, 'discounts', rabatt));
389
+ // Kartentrinkgeld bar aus der Lade genommen (Summe); nur mit Karten-direkt.
390
+ wennWert(r, o, 'cardTipsTakenCents', () => ganzzahl(ort, o, 'cardTipsTakenCents'));
370
391
  wennWert(r, o, 'differenceParts', () => liste(ort, o, 'differenceParts', differenzTeil));
371
392
  wennDa(r, o, 'countedBeforePayoutCents', () => ganzzahlOderNull(ort, o, 'countedBeforePayoutCents'));
372
393
  wennDa(r, o, 'countedBeforePayoutDenominations', () => stueckelung(ort, o, 'countedBeforePayoutDenominations'));
@@ -111,14 +111,20 @@ export interface ShiftTipTotals {
111
111
  receivedImmediatelyCents: number;
112
112
  /** Behaelt der Betrieb und zahlt es ueber den Lohn („über Lohn“). */
113
113
  retainedCents: number;
114
- /** In dieser Schicht aus der Lade ausgezahlt („schon genommen“). */
114
+ /** In dieser Schicht aus der Lade ausgezahlt („genommen“). */
115
115
  paidOutCents: number;
116
116
  /**
117
117
  * Beim Storno selbst zurueckgegeben („Gibt die Mitarbeiterin direkt“, „selbst zurückgegeben“).
118
- * Eigene Zahl, damit „schon genommen“ nie negativ wird: offen = verdient − genommen + selbst
118
+ * Eigene Zahl, damit „genommen“ nie negativ wird: offen = verdient − genommen + selbst
119
119
  * zurueckgegeben. Fehlt es in der Antwort (Backend vor dieser Regel), gilt 0.
120
120
  */
121
121
  refundedByEmployeeCents: number;
122
+ /**
123
+ * Kartentrinkgeld, das die Mitarbeiterin beim Verkauf bar aus der Lade genommen hat (Spec
124
+ * 2026-11-11-kartentrinkgeld, § 4.3; Teil von `paidOutCents`). Der Server sendet es nur, wenn es eines gibt;
125
+ * fehlt = 0. Auf Bon und Kassenstand die Zeile „davon Kartentrinkgeld“ ([shiftTipLines]).
126
+ */
127
+ cardTipsTakenCents?: number;
122
128
  }
123
129
  /**
124
130
  * Trinkgeld eines Mitarbeiters mit seinem offenen Anspruch an die Lade
@@ -129,7 +135,7 @@ export interface ShiftTip extends ShiftTipTotals {
129
135
  /**
130
136
  * Offene Forderung an die Lade beim Oeffnen der Schicht („aus früheren Schichten“, Fix-Runde 2,
131
137
  * R64); ohne offene Schicht der ganze Anspruch. Fehlt es (Backend bzw. Schicht vor dieser Regel), 0.
132
- * Fuer den Leser geht auf: offen = aus früheren Schichten + verdient − über Lohn − schon genommen
138
+ * Fuer den Leser geht auf: offen = aus früheren Schichten + verdient − über Lohn − genommen
133
139
  * + selbst zurückgegeben.
134
140
  */
135
141
  carriedOverCents: number;
@@ -192,7 +198,7 @@ export interface ShiftReconciliation {
192
198
  * Anfang, Barverkaeufe, Trinkgeld bar, Storno bar, Einzahlungen, Ausgaben aus der Lade und die
193
199
  * Summe der Zwischenzaehlungs-Differenzen. Die Summe der Teile ist das Soll.
194
200
  */
195
- export declare const EXPECTED_PART_KEYS: readonly ["opening", "cash_sales", "cash_tips", "cancellations", "cash_in", "cash_out", "interim_difference"];
201
+ export declare const EXPECTED_PART_KEYS: readonly ["opening", "cash_sales", "cash_tips", "card_tips_taken", "cancellations", "cash_in", "cash_out", "interim_difference"];
196
202
  export type ExpectedPartKey = (typeof EXPECTED_PART_KEYS)[number];
197
203
  /** Ein Teil des Solls in Cent (Vorzeichen wie gebucht, Ausgaben negativ). */
198
204
  export interface ShiftExpectedPart {
@@ -272,6 +278,33 @@ export interface TipClaim {
272
278
  name: string | null;
273
279
  cents: number;
274
280
  }
281
+ /**
282
+ * Wo der offene Trinkgeld-Anspruch gefuehrt wird (Spec 2026-11-11-kartentrinkgeld, F2; Katalog
283
+ * `TRINKGELD_ANSPRUCH`): `per_drawer` = je Lade (Vorgabe), `per_person` = ein Stand je Person ueber alle Laden.
284
+ */
285
+ export declare const TIP_CLAIM_SCOPES: readonly ["per_drawer", "per_person"];
286
+ export type TipClaimScope = (typeof TIP_CLAIM_SCOPES)[number];
287
+ /** Eine andere Lade des Kontos mit offenem Betrag der Person (nur bei `per_drawer`). */
288
+ export interface TipBalanceOtherDrawer {
289
+ drawerId: string;
290
+ name: string | null;
291
+ openCents: number;
292
+ }
293
+ /**
294
+ * „Mein Trinkgeld“ ([getMyTipBalance]): der Stand der angemeldeten Person. `openCents` kann negativ sein (zu viel
295
+ * ausgezahlt, wird mit dem naechsten Trinkgeld verrechnet); `keptTodayCents` = heute genommen (ausgezahlt,
296
+ * bar gleich behalten, Kartentrinkgeld bar). Bei `per_person` die Summe ueber alle Laden, `otherDrawers` leer.
297
+ * Ohne Schichtbetrieb der Lade immer 0 (kein Anspruch).
298
+ */
299
+ export interface TipBalance {
300
+ drawerId: string;
301
+ /** Ein Wert aus [TIP_CLAIM_SCOPES] oder ein kuenftiger. */
302
+ claimScope: TipClaimScope | (string & {});
303
+ openCents: number;
304
+ keptTodayCents: number;
305
+ currency: string;
306
+ otherDrawers: TipBalanceOtherDrawer[];
307
+ }
275
308
  /** Eine gemeldete Oeffnung der Lade (nur mit `cashView`). */
276
309
  export interface DrawerOpening {
277
310
  /** Serverzeit des Eingangs. */
@@ -405,6 +438,8 @@ export interface ShiftSummaryReceipt extends ShiftReceiptHeader {
405
438
  openingsWithoutSale: number;
406
439
  /** Gewaehrte Rabatte je Name; fehlt, wenn es keine gab (der Bon bleibt dann wie bisher). */
407
440
  discounts?: ShiftDiscount[];
441
+ /** Kartentrinkgeld bar aus der Lade genommen, Summe (Soll − Betrag); fehlt ohne Karten-direkt. */
442
+ cardTipsTakenCents?: number;
408
443
  /** Entnommen bzw. eingelegt nach dem Zaehlen; fehlt, wenn kein Geld bewegt wurde. */
409
444
  afterCount?: AfterCount;
410
445
  /**
@@ -60,7 +60,12 @@ export const SHIFT_RECEIPT_KINDS = Object.freeze(['shift_close', 'shift_interim'
60
60
  * Summe der Zwischenzaehlungs-Differenzen. Die Summe der Teile ist das Soll.
61
61
  */
62
62
  export const EXPECTED_PART_KEYS = Object.freeze([
63
- 'opening', 'cash_sales', 'cash_tips', 'cancellations', 'cash_in', 'cash_out', 'interim_difference',
63
+ 'opening', 'cash_sales', 'cash_tips', 'card_tips_taken', 'cancellations', 'cash_in', 'cash_out', 'interim_difference',
64
64
  ]);
65
65
  /** Teile der Gesamtdifferenz einer geschlossenen Schicht mit Zwischenzaehlung: `interim` je Zaehlung, `closing` der Abschluss. */
66
66
  export const DIFFERENCE_PART_TYPES = Object.freeze(['interim', 'closing']);
67
+ /**
68
+ * Wo der offene Trinkgeld-Anspruch gefuehrt wird (Spec 2026-11-11-kartentrinkgeld, F2; Katalog
69
+ * `TRINKGELD_ANSPRUCH`): `per_drawer` = je Lade (Vorgabe), `per_person` = ein Stand je Person ueber alle Laden.
70
+ */
71
+ export const TIP_CLAIM_SCOPES = Object.freeze(['per_drawer', 'per_person']);
@@ -201,7 +201,7 @@ export declare function parseCentsAllowZero(text: string): number | null;
201
201
  */
202
202
  export declare function newIdempotencyKey(): string;
203
203
  /** Zeilen des Trinkgelds eines Mitarbeiters (siehe [shiftTipLines]). */
204
- export type ShiftTipLineKey = 'shift_receipt.tip_carried_over' | 'shift_receipt.tip_earned' | 'shift_receipt.tip_retained' | 'shift_receipt.tip_paid_out' | 'shift_receipt.tip_refunded_by_employee' | 'shift_receipt.tip_open';
204
+ export type ShiftTipLineKey = 'shift_receipt.tip_carried_over' | 'shift_receipt.tip_earned' | 'shift_receipt.tip_retained' | 'shift_receipt.tip_paid_out' | 'shift_receipt.tip_card_taken' | 'shift_receipt.tip_refunded_by_employee' | 'shift_receipt.tip_open';
205
205
  export interface ShiftTipLine {
206
206
  key: ShiftTipLineKey;
207
207
  /** Das Wort aus dem Katalog ([labelText]). */
@@ -211,10 +211,12 @@ export interface ShiftTipLine {
211
211
  /**
212
212
  * Was vom Trinkgeld eines Mitarbeiters dasteht – auf dem Bon, im Kassenstand
213
213
  * und beim Abschluss gleich (Rulings R50/R51): „verdient“ (sofort + über
214
- * Lohn) immer, „über Lohn“, „schon genommen“, „selbst zurückgegeben“ (R62)
214
+ * Lohn) immer, „über Lohn“, „genommen“, „selbst zurückgegeben“ (R62)
215
215
  * und „offen“ nur, wenn nicht 0. Davor „aus früheren Schichten“ (R64, nur ≠ 0):
216
- * offen = aus früheren Schichten + verdient − über Lohn − schon genommen +
217
- * selbst zurückgegeben.
216
+ * offen = aus früheren Schichten + verdient − über Lohn − genommen +
217
+ * selbst zurückgegeben. Hinter „genommen“ steht „davon Kartentrinkgeld“
218
+ * (bar aus der Lade genommen; Spec 2026-11-11-kartentrinkgeld, nur ≠ 0, Teil
219
+ * von „genommen“, kein eigener Summand).
218
220
  * Ist alles 0, gibt es keine Zeile, und der Mitarbeiter entfaellt ganz. Ohne
219
221
  * `openCents` (Laufstand) zaehlt offen als 0. Gemeinsame Faelle mit dem
220
222
  * Dart-Zwilling: `fixtures/shift-cases.json`.
@@ -189,10 +189,12 @@ export function newIdempotencyKey() {
189
189
  /**
190
190
  * Was vom Trinkgeld eines Mitarbeiters dasteht – auf dem Bon, im Kassenstand
191
191
  * und beim Abschluss gleich (Rulings R50/R51): „verdient“ (sofort + über
192
- * Lohn) immer, „über Lohn“, „schon genommen“, „selbst zurückgegeben“ (R62)
192
+ * Lohn) immer, „über Lohn“, „genommen“, „selbst zurückgegeben“ (R62)
193
193
  * und „offen“ nur, wenn nicht 0. Davor „aus früheren Schichten“ (R64, nur ≠ 0):
194
- * offen = aus früheren Schichten + verdient − über Lohn − schon genommen +
195
- * selbst zurückgegeben.
194
+ * offen = aus früheren Schichten + verdient − über Lohn − genommen +
195
+ * selbst zurückgegeben. Hinter „genommen“ steht „davon Kartentrinkgeld“
196
+ * (bar aus der Lade genommen; Spec 2026-11-11-kartentrinkgeld, nur ≠ 0, Teil
197
+ * von „genommen“, kein eigener Summand).
196
198
  * Ist alles 0, gibt es keine Zeile, und der Mitarbeiter entfaellt ganz. Ohne
197
199
  * `openCents` (Laufstand) zaehlt offen als 0. Gemeinsame Faelle mit dem
198
200
  * Dart-Zwilling: `fixtures/shift-cases.json`.
@@ -203,6 +205,7 @@ export function shiftTipLines(tip) {
203
205
  const zeilen = [
204
206
  ['shift_receipt.tip_retained', tip.retainedCents],
205
207
  ['shift_receipt.tip_paid_out', tip.paidOutCents],
208
+ ['shift_receipt.tip_card_taken', tip.cardTipsTakenCents ?? 0],
206
209
  ['shift_receipt.tip_refunded_by_employee', tip.refundedByEmployeeCents ?? 0],
207
210
  ['shift_receipt.tip_open', tip.openCents ?? 0],
208
211
  ];
@@ -38,6 +38,8 @@ export declare const TIP_START: readonly ["percent", "round_up", "total"];
38
38
  */
39
39
  export declare const TIP_KEPT_MODE: readonly ["ask", "always", "never"];
40
40
  export type PosTipKeptMode = typeof TIP_KEPT_MODE[number];
41
+ /** Dieselben drei Stufen fuer Kartentrinkgeld (`business.tipCardKeptMode`, Spec 2026-11-11-kartentrinkgeld). */
42
+ export declare const TIP_CARD_KEPT_MODE: readonly ["ask", "always", "never"];
41
43
  /**
42
44
  * Art einer Rabatt-Vorlage (`business.discountPresets[].kind`): Prozent oder fester Betrag
43
45
  * (gespeichert `art`: `prozent | betrag`).
@@ -239,6 +241,23 @@ export interface PosBusinessSettings {
239
241
  * gilt `ask`. Lesen ueber [posTipKeptMode], entscheiden ueber [tipKeptFor].
240
242
  */
241
243
  tipKeptMode?: PosOpen<PosTipKeptMode>;
244
+ /**
245
+ * Kartentrinkgeld „gleich behalten“ (Spec 2026-11-11-kartentrinkgeld, § 4.1): die Mitarbeiterin nimmt den
246
+ * Betrag beim Verkauf bar aus der Lade. Vorbelegung des Schalters bei Stufe `ask`. Optional wie
247
+ * `tipKeptByDefault`; fehlt es, gilt aus. Wirkt nur an Konten mit Kartentrinkgeld ueber die Kasse
248
+ * (`RegisterCashregisterInfo.cardTips`). Lesen ueber [posTipCardKeptByDefault].
249
+ */
250
+ tipCardKeptByDefault?: boolean;
251
+ /**
252
+ * Stufe fuer Kartentrinkgeld wie [tipKeptMode] (`ask` | `always` | `never`); fehlt es, gilt `ask`.
253
+ * Lesen ueber [posTipCardKeptMode], entscheiden ueber [tipKeptFor] mit `method: 'card'`.
254
+ */
255
+ tipCardKeptMode?: PosOpen<PosTipKeptMode>;
256
+ /**
257
+ * Not-Aus „Mitarbeiter zahlen sich ihr Trinkgeld selbst aus“ (Spec 2026-11-11, § 4.6): fehlt es, gilt an.
258
+ * `false` = eigenes Trinkgeld nur mit dem Recht `shift` auszahlbar (R49). Lesen ueber [posTipSelfPayout].
259
+ */
260
+ tipSelfPayout?: boolean;
242
261
  /**
243
262
  * Benannte Rabatt-Chips (Prozent oder Betrag, hoechstens 5). Optional: der Server sendet das Feld nur, wenn es
244
263
  * gespeichert ist; dann sind die Vorlagen die Quelle der Chips und `discountChips` spiegelt ihre Prozentwerte fuer
@@ -357,14 +376,14 @@ export declare function _optionalerWert(wert: unknown, schreiben: boolean): bool
357
376
  * [mergePosSettings] uebernimmt sie nur als Wahrheitswert; der Schreibweg
358
377
  * nimmt nur `true`/`false`.
359
378
  */
360
- export declare const POS_BUSINESS_OPTIONAL_FIELDS: readonly ["tipKeptByDefault", "customDiscountAllowed"];
379
+ export declare const POS_BUSINESS_OPTIONAL_FIELDS: readonly ["tipKeptByDefault", "customDiscountAllowed", "tipCardKeptByDefault", "tipSelfPayout"];
361
380
  /**
362
381
  * Optionale Betriebs-Einstellungen mit Wertemenge (Backend `BETRIEB_OPTIONAL`, Katalog
363
382
  * `KASSE_BETRIEB_WERTE.tipKinds[]`, `.tipStart` und `.tipKeptMode`): ohne Standardwert, der Server sendet sie nur,
364
383
  * wenn sie gespeichert sind. [mergePosSettings] uebernimmt sie, wenn sie die Form haben
365
384
  * (`tipKinds` eine nichtleere Liste von Texten, `tipStart` ein Text); den Wert prueft der Schreibweg.
366
385
  */
367
- export declare const POS_BUSINESS_OPTIONAL_CHOICES: readonly ["tipKinds", "tipStart", "tipKeptMode"];
386
+ export declare const POS_BUSINESS_OPTIONAL_CHOICES: readonly ["tipKinds", "tipStart", "tipKeptMode", "tipCardKeptMode"];
368
387
  /**
369
388
  * Optionale Betriebs-Listen aus Objekten (Backend `BETRIEB_OPTIONAL.rabattVorlagen`): ohne Standardwert, der Server
370
389
  * sendet sie nur, wenn sie gespeichert sind (auch als leere Liste). Der Leser uebernimmt die Eintraege, die die Form
@@ -389,18 +408,28 @@ export declare function posTipKeptByDefault(business: Readonly<Partial<PosBusine
389
408
  export declare function posCustomDiscountAllowed(business: Readonly<Partial<PosBusinessSettings>> | null | undefined): boolean;
390
409
  /** Wirksame Stufe „Trinkgeld gleich behalten“: die gespeicherte, wenn sie bekannt ist, sonst `ask`. */
391
410
  export declare function posTipKeptMode(business: Readonly<Partial<PosBusinessSettings>> | null | undefined): PosTipKeptMode;
392
- /** Ergebnis von [tipKeptFor]: zeigt die Kasse den Schalter, und wird das Bar-Trinkgeld gleich behalten? */
411
+ /** Kartentrinkgeld „gleich behalten“ (bar aus der Lade) vorbelegt? Fehlt die Einstellung, gilt aus. */
412
+ export declare function posTipCardKeptByDefault(business: Readonly<Partial<PosBusinessSettings>> | null | undefined): boolean;
413
+ /** Wirksame Stufe fuer Kartentrinkgeld: die gespeicherte, wenn sie bekannt ist, sonst `ask`. */
414
+ export declare function posTipCardKeptMode(business: Readonly<Partial<PosBusinessSettings>> | null | undefined): PosTipKeptMode;
415
+ /** Zahlen sich Mitarbeiter ihr Trinkgeld selbst aus (Not-Aus)? Fehlt die Einstellung, gilt ja. */
416
+ export declare function posTipSelfPayout(business: Readonly<Partial<PosBusinessSettings>> | null | undefined): boolean;
417
+ /** Zahlart des Trinkgelds, nach der die Stufe gilt: bar (`tipKeptMode`) oder Karte (`tipCardKeptMode`). */
418
+ export type TipPaymentKind = 'cash' | 'card';
419
+ /** Ergebnis von [tipKeptFor]: zeigt die Kasse den Schalter, und wird das Trinkgeld gleich behalten? */
393
420
  export interface TipKeptDecision {
394
421
  showSwitch: boolean;
395
422
  kept: boolean;
396
423
  }
397
424
  /**
398
- * Die eine Regel fuer Web-Kasse und Kassen-App beim Bar-Trinkgeld: `ask` zeigt den Schalter, gewaehlt ist
399
- * `wanted` (die Wahl am Schalter, ein Wahrheitswert), sonst die Vorbelegung `tipKeptByDefault`; `always` bzw. `never` zeigen
400
- * keinen Schalter und behalten gleich bzw. lassen offen, eine Schalterwahl zaehlt dann nicht. `kept` geht als
401
- * `tip.direkt` an den Beleg (der Server erzwingt die Stufe dort nicht).
425
+ * Die eine Regel fuer Web-Kasse und Kassen-App beim Trinkgeld: `ask` zeigt den Schalter, gewaehlt ist
426
+ * `wanted` (die Wahl am Schalter, ein Wahrheitswert), sonst die Vorbelegung (`tipKeptByDefault` bzw. bei Karte
427
+ * `tipCardKeptByDefault`); `always` bzw. `never` zeigen keinen Schalter und behalten gleich bzw. lassen offen, eine
428
+ * Schalterwahl zaehlt dann nicht. `kept` geht als `tip.keptByEmployee` an den Beleg (der Server erzwingt die Stufe
429
+ * dort nicht). `method` waehlt die Stufe der Zahlart: ohne Angabe bar wie bisher, `'card'` die Karten-Stufe
430
+ * (Spec 2026-11-11-kartentrinkgeld, § 4.1) -- „gleich behalten“ heisst bei Karte: bar aus der Lade nehmen.
402
431
  */
403
- export declare function tipKeptFor(business: Readonly<Partial<PosBusinessSettings>> | null | undefined, wanted?: boolean | null): TipKeptDecision;
432
+ export declare function tipKeptFor(business: Readonly<Partial<PosBusinessSettings>> | null | undefined, wanted?: boolean | null, method?: TipPaymentKind): TipKeptDecision;
404
433
  /**
405
434
  * Die Wertemenge je Feld, soweit das Feld eine hat: dagegen prueft der
406
435
  * Schreibweg vor dem Senden (ein deutscher Wert wie `'nacht'` geht so gar
@@ -39,6 +39,8 @@ export const TIP_START = TIP_KINDS;
39
39
  * `tipKeptByDefault`; `always`/`never` = kein Schalter, die Kasse setzt die Wahl selbst. Entscheidung ueber [tipKeptFor].
40
40
  */
41
41
  export const TIP_KEPT_MODE = ['ask', 'always', 'never'];
42
+ /** Dieselben drei Stufen fuer Kartentrinkgeld (`business.tipCardKeptMode`, Spec 2026-11-11-kartentrinkgeld). */
43
+ export const TIP_CARD_KEPT_MODE = TIP_KEPT_MODE;
42
44
  /**
43
45
  * Art einer Rabatt-Vorlage (`business.discountPresets[].kind`): Prozent oder fester Betrag
44
46
  * (gespeichert `art`: `prozent | betrag`).
@@ -221,7 +223,7 @@ const OPTIONALE = new Set(POS_DEVICE_OPTIONAL_FIELDS);
221
223
  * [mergePosSettings] uebernimmt sie nur als Wahrheitswert; der Schreibweg
222
224
  * nimmt nur `true`/`false`.
223
225
  */
224
- export const POS_BUSINESS_OPTIONAL_FIELDS = Object.freeze(['tipKeptByDefault', 'customDiscountAllowed']);
226
+ export const POS_BUSINESS_OPTIONAL_FIELDS = Object.freeze(['tipKeptByDefault', 'customDiscountAllowed', 'tipCardKeptByDefault', 'tipSelfPayout']);
225
227
  const OPTIONALE_SCHALTER = new Set(POS_BUSINESS_OPTIONAL_FIELDS);
226
228
  /**
227
229
  * Optionale Betriebs-Einstellungen mit Wertemenge (Backend `BETRIEB_OPTIONAL`, Katalog
@@ -229,7 +231,7 @@ const OPTIONALE_SCHALTER = new Set(POS_BUSINESS_OPTIONAL_FIELDS);
229
231
  * wenn sie gespeichert sind. [mergePosSettings] uebernimmt sie, wenn sie die Form haben
230
232
  * (`tipKinds` eine nichtleere Liste von Texten, `tipStart` ein Text); den Wert prueft der Schreibweg.
231
233
  */
232
- export const POS_BUSINESS_OPTIONAL_CHOICES = Object.freeze(['tipKinds', 'tipStart', 'tipKeptMode']);
234
+ export const POS_BUSINESS_OPTIONAL_CHOICES = Object.freeze(['tipKinds', 'tipStart', 'tipKeptMode', 'tipCardKeptMode']);
233
235
  /**
234
236
  * Optionale Betriebs-Listen aus Objekten (Backend `BETRIEB_OPTIONAL.rabattVorlagen`): ohne Standardwert, der Server
235
237
  * sendet sie nur, wenn sie gespeichert sind (auch als leere Liste). Der Leser uebernimmt die Eintraege, die die Form
@@ -295,19 +297,36 @@ export function posTipKeptMode(business) {
295
297
  const m = business?.tipKeptMode;
296
298
  return TIP_KEPT_MODE.includes(m) ? m : 'ask';
297
299
  }
300
+ /** Kartentrinkgeld „gleich behalten“ (bar aus der Lade) vorbelegt? Fehlt die Einstellung, gilt aus. */
301
+ export function posTipCardKeptByDefault(business) {
302
+ return !!business && business.tipCardKeptByDefault === true;
303
+ }
304
+ /** Wirksame Stufe fuer Kartentrinkgeld: die gespeicherte, wenn sie bekannt ist, sonst `ask`. */
305
+ export function posTipCardKeptMode(business) {
306
+ const m = business?.tipCardKeptMode;
307
+ return TIP_KEPT_MODE.includes(m) ? m : 'ask';
308
+ }
309
+ /** Zahlen sich Mitarbeiter ihr Trinkgeld selbst aus (Not-Aus)? Fehlt die Einstellung, gilt ja. */
310
+ export function posTipSelfPayout(business) {
311
+ return business?.tipSelfPayout !== false;
312
+ }
298
313
  /**
299
- * Die eine Regel fuer Web-Kasse und Kassen-App beim Bar-Trinkgeld: `ask` zeigt den Schalter, gewaehlt ist
300
- * `wanted` (die Wahl am Schalter, ein Wahrheitswert), sonst die Vorbelegung `tipKeptByDefault`; `always` bzw. `never` zeigen
301
- * keinen Schalter und behalten gleich bzw. lassen offen, eine Schalterwahl zaehlt dann nicht. `kept` geht als
302
- * `tip.direkt` an den Beleg (der Server erzwingt die Stufe dort nicht).
314
+ * Die eine Regel fuer Web-Kasse und Kassen-App beim Trinkgeld: `ask` zeigt den Schalter, gewaehlt ist
315
+ * `wanted` (die Wahl am Schalter, ein Wahrheitswert), sonst die Vorbelegung (`tipKeptByDefault` bzw. bei Karte
316
+ * `tipCardKeptByDefault`); `always` bzw. `never` zeigen keinen Schalter und behalten gleich bzw. lassen offen, eine
317
+ * Schalterwahl zaehlt dann nicht. `kept` geht als `tip.keptByEmployee` an den Beleg (der Server erzwingt die Stufe
318
+ * dort nicht). `method` waehlt die Stufe der Zahlart: ohne Angabe bar wie bisher, `'card'` die Karten-Stufe
319
+ * (Spec 2026-11-11-kartentrinkgeld, § 4.1) -- „gleich behalten“ heisst bei Karte: bar aus der Lade nehmen.
303
320
  */
304
- export function tipKeptFor(business, wanted) {
305
- const stufe = posTipKeptMode(business);
321
+ export function tipKeptFor(business, wanted, method = 'cash') {
322
+ const karte = method === 'card';
323
+ const stufe = karte ? posTipCardKeptMode(business) : posTipKeptMode(business);
306
324
  if (stufe === 'always')
307
325
  return { showSwitch: false, kept: true };
308
326
  if (stufe === 'never')
309
327
  return { showSwitch: false, kept: false };
310
- return { showSwitch: true, kept: typeof wanted === 'boolean' ? wanted : posTipKeptByDefault(business) };
328
+ const vorbelegt = karte ? posTipCardKeptByDefault(business) : posTipKeptByDefault(business);
329
+ return { showSwitch: true, kept: typeof wanted === 'boolean' ? wanted : vorbelegt };
311
330
  }
312
331
  /**
313
332
  * Die Wertemenge je Feld, soweit das Feld eine hat: dagegen prueft der
@@ -320,6 +339,7 @@ export const POS_BUSINESS_VALUES = Object.freeze({
320
339
  cardProvider: CARD_PROVIDER, tipMode: TIP_MODE, checkoutMode: CHECKOUT_MODE, receiptOutput: RECEIPT_OUTPUT,
321
340
  doneScreenSeconds: DONE_SCREEN_SECONDS, watermarkSide: WATERMARK_SIDE, watermarkStrength: WATERMARK_STRENGTH,
322
341
  logoScale: LOGO_SCALE, watermarkScale: WATERMARK_SCALE, tipKinds: TIP_KINDS, tipStart: TIP_START, tipKeptMode: TIP_KEPT_MODE,
342
+ tipCardKeptMode: TIP_KEPT_MODE,
323
343
  });
324
344
  /** Wie [POS_BUSINESS_VALUES] fuer die Geraete-Einstellungen. */
325
345
  export const POS_DEVICE_VALUES = Object.freeze({
@@ -357,6 +377,7 @@ const ALTWERTE_0X = Object.freeze({
357
377
  tipKinds: ['prozent', 'aufrunden', 'gesamt'],
358
378
  tipStart: ['prozent', 'aufrunden', 'gesamt'],
359
379
  tipKeptMode: ['fragen', 'immer', 'nie'],
380
+ tipCardKeptMode: ['fragen', 'immer', 'nie'],
360
381
  cartWidth: ['schmal', 'mittel', 'breit'],
361
382
  });
362
383
  /** Tasten-Aktionen der inneren Form (0.x). */