@kreiseck/kasseneck-api 1.31.0 → 1.32.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 (119) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/dist/cjs/client/aufrufe.d.ts +3 -3
  3. package/dist/cjs/client/aufrufe.js +8 -0
  4. package/dist/cjs/client/receipts.d.ts +11 -0
  5. package/dist/cjs/client/receipts.js +14 -0
  6. package/dist/cjs/index.d.ts +2 -2
  7. package/dist/cjs/index.js +8 -5
  8. package/dist/cjs/models/index.d.ts +1 -1
  9. package/dist/cjs/models/index.js +5 -2
  10. package/dist/cjs/models/receipt-errors.d.ts +1 -1
  11. package/dist/cjs/models/receipt-errors.js +9 -0
  12. package/dist/cjs/models/receipt-item.d.ts +44 -2
  13. package/dist/cjs/models/receipt-item.js +56 -1
  14. package/dist/cjs/models/receipt.d.ts +17 -0
  15. package/dist/cjs/models/receipt.js +9 -0
  16. package/dist/cjs/pos/artikel.d.ts +14 -0
  17. package/dist/cjs/pos/artikel.js +3 -0
  18. package/dist/cjs/pos/client.d.ts +1 -0
  19. package/dist/cjs/pos/client.js +3 -0
  20. package/dist/cjs/pos/errors.d.ts +1 -1
  21. package/dist/cjs/pos/errors.js +12 -0
  22. package/dist/cjs/pos/index.d.ts +4 -2
  23. package/dist/cjs/pos/index.js +24 -4
  24. package/dist/cjs/pos/leergut.d.ts +60 -0
  25. package/dist/cjs/pos/leergut.js +82 -0
  26. package/dist/cjs/pos/pfand.d.ts +144 -0
  27. package/dist/cjs/pos/pfand.js +382 -0
  28. package/dist/cjs/pos/settings.d.ts +3 -7
  29. package/dist/cjs/pos/settings.js +7 -0
  30. package/dist/cjs/pos/texte.d.ts +68 -0
  31. package/dist/cjs/pos/texte.js +40 -1
  32. package/dist/cjs/receipt/discount.js +3 -0
  33. package/dist/cjs/receipt/due.d.ts +6 -0
  34. package/dist/cjs/receipt/due.js +16 -5
  35. package/dist/cjs/receipt/gutschein-plan.d.ts +7 -1
  36. package/dist/cjs/receipt/gutschein-plan.js +16 -2
  37. package/dist/cjs/receipt/layout.js +108 -2
  38. package/dist/cjs/register/pairing.d.ts +15 -1
  39. package/dist/cjs/register/pairing.js +14 -1
  40. package/dist/cjs/stored/vokabular.d.ts +1 -1
  41. package/dist/cjs/stored/vokabular.js +72 -4
  42. package/dist/cjs/version.d.ts +1 -1
  43. package/dist/cjs/version.js +1 -1
  44. package/dist/esm/client/aufrufe.d.ts +3 -3
  45. package/dist/esm/client/aufrufe.js +8 -0
  46. package/dist/esm/client/receipts.d.ts +11 -0
  47. package/dist/esm/client/receipts.js +14 -0
  48. package/dist/esm/index.d.ts +2 -2
  49. package/dist/esm/index.js +2 -2
  50. package/dist/esm/models/index.d.ts +1 -1
  51. package/dist/esm/models/index.js +1 -1
  52. package/dist/esm/models/receipt-errors.d.ts +1 -1
  53. package/dist/esm/models/receipt-errors.js +9 -0
  54. package/dist/esm/models/receipt-item.d.ts +44 -2
  55. package/dist/esm/models/receipt-item.js +54 -1
  56. package/dist/esm/models/receipt.d.ts +17 -0
  57. package/dist/esm/models/receipt.js +9 -0
  58. package/dist/esm/pos/artikel.d.ts +14 -0
  59. package/dist/esm/pos/artikel.js +3 -0
  60. package/dist/esm/pos/client.d.ts +1 -0
  61. package/dist/esm/pos/client.js +3 -0
  62. package/dist/esm/pos/errors.d.ts +1 -1
  63. package/dist/esm/pos/errors.js +12 -0
  64. package/dist/esm/pos/index.d.ts +4 -2
  65. package/dist/esm/pos/index.js +4 -2
  66. package/dist/esm/pos/leergut.d.ts +60 -0
  67. package/dist/esm/pos/leergut.js +77 -0
  68. package/dist/esm/pos/pfand.d.ts +144 -0
  69. package/dist/esm/pos/pfand.js +371 -0
  70. package/dist/esm/pos/settings.d.ts +3 -7
  71. package/dist/esm/pos/settings.js +7 -0
  72. package/dist/esm/pos/texte.d.ts +68 -0
  73. package/dist/esm/pos/texte.js +38 -0
  74. package/dist/esm/receipt/discount.js +4 -1
  75. package/dist/esm/receipt/due.d.ts +6 -0
  76. package/dist/esm/receipt/due.js +17 -6
  77. package/dist/esm/receipt/gutschein-plan.d.ts +7 -1
  78. package/dist/esm/receipt/gutschein-plan.js +14 -2
  79. package/dist/esm/receipt/layout.js +109 -3
  80. package/dist/esm/register/pairing.d.ts +15 -1
  81. package/dist/esm/register/pairing.js +13 -1
  82. package/dist/esm/stored/vokabular.d.ts +1 -1
  83. package/dist/esm/stored/vokabular.js +72 -4
  84. package/dist/esm/version.d.ts +1 -1
  85. package/dist/esm/version.js +1 -1
  86. package/fixtures/deposit-cases.json +4758 -0
  87. package/fixtures/expected/deposit-return.grid32.txt +28 -0
  88. package/fixtures/expected/deposit-return.grid48.txt +28 -0
  89. package/fixtures/expected/deposit-return.lines.json +275 -0
  90. package/fixtures/expected/deposit-return.sheet32.json +194 -0
  91. package/fixtures/expected/deposit-return.sheet48.json +194 -0
  92. package/fixtures/expected/deposit.grid32.txt +34 -0
  93. package/fixtures/expected/deposit.grid48.txt +32 -0
  94. package/fixtures/expected/deposit.lines.json +316 -0
  95. package/fixtures/expected/deposit.sheet32.json +230 -0
  96. package/fixtures/expected/deposit.sheet48.json +218 -0
  97. package/fixtures/hobex-hps-codes.json +1 -1
  98. package/fixtures/invoice-api.schema.json +1 -1
  99. package/fixtures/invoice-texts.json +1 -1
  100. package/fixtures/manifest.json +16 -0
  101. package/fixtures/pos-texts.json +62 -1
  102. package/fixtures/receipts/deposit-return.json +63 -0
  103. package/fixtures/receipts/deposit.json +83 -0
  104. package/fixtures/return-code-cases.json +1338 -0
  105. package/fixtures/surface.json +44 -4
  106. package/fixtures/v3/antworten/belege.json +2 -2
  107. package/fixtures/v3/antworten/belegmail.json +2 -2
  108. package/fixtures/v3/antworten/berichte.json +2 -2
  109. package/fixtures/v3/antworten/kasse-belege.json +2 -2
  110. package/fixtures/v3/antworten/kasse.json +428 -13
  111. package/fixtures/v3/antworten/lager.json +1 -1
  112. package/fixtures/v3/antworten/rechnungen.json +2 -2
  113. package/fixtures/v3/antworten/storno.json +2 -2
  114. package/fixtures/v3/stored/belege.json +2 -2
  115. package/fixtures/v3/stored/kasse.json +42 -4
  116. package/fixtures/v3/stored/rechnungen.json +2 -2
  117. package/fixtures/v3/v3-vokabular.json +808 -27
  118. package/fixtures/v3/zahlbetrag-faelle.json +187 -3
  119. package/package.json +1 -1
@@ -12,6 +12,7 @@
12
12
  * bis die Buchung geklaert ist (Spec kachel-kasse § 9).
13
13
  */
14
14
  import { type PosVoucherSettings } from './gutschein.js';
15
+ import { type DepositSettings } from './pfand.js';
15
16
  export declare const THEME: readonly ["clear", "warm", "night", "contrast"];
16
17
  export type PosTheme = typeof THEME[number];
17
18
  export declare const FONT_SIZE: readonly ["S", "M", "L", "XL"];
@@ -335,6 +336,8 @@ export interface PosSettings {
335
336
  device: PosDeviceSettings;
336
337
  /** Gutschein-Verkauf der Kasse (Block `vouchers`); ohne Block ist Verkaufen aus. */
337
338
  vouchers: PosVoucherSettings;
339
+ /** Pfand & Leergut (Block `deposit`); fehlt, solange der Betrieb kein Pfand eingeschaltet hat. */
340
+ deposit?: DepositSettings;
338
341
  }
339
342
  export declare const POS_BUSINESS_DEFAULTS: Readonly<PosBusinessSettings>;
340
343
  export declare const POS_DEVICE_DEFAULTS: Readonly<PosDeviceSettings>;
@@ -429,13 +432,6 @@ export declare const _ALTFORM_0X: Readonly<{
429
432
  * dagegen stehen: er kann ein neuer Wert des Servers sein.
430
433
  */
431
434
  export declare function mergePosSettings<T extends object>(standard: Readonly<T>, stored: Partial<T> | null | undefined): T;
432
- /**
433
- * Einen gespeicherten oder zwischengespeicherten Stand `{business, device}`
434
- * lesen: gemischt mit den Standardwerten, ohne Werte und Tasten-Aktionen der
435
- * inneren Form 0.x (siehe [mergePosSettings]). Der Weg fuer jeden Stand, den
436
- * ein Verbraucher selbst abgelegt hat; ein Stand in der inneren Form ergibt
437
- * die Standardwerte, nie einen deutschen Wert und nie einen Absturz.
438
- */
439
435
  export declare function sanitizePosSettings(stored: unknown): PosSettings;
440
436
  /**
441
437
  * Die Felder, deren Wert dieses Paket nicht kennt (neuer Wert des Servers),
@@ -12,6 +12,7 @@
12
12
  * bis die Buchung geklaert ist (Spec kachel-kasse § 9).
13
13
  */
14
14
  import { posVoucherSettingsFromWire } from './gutschein.js';
15
+ import { posDepositSettingsFromWire } from './pfand.js';
15
16
  /*
16
17
  * Jedes Enum steht als Liste zur Laufzeit da, der Typ leitet sich daraus ab
17
18
  * (`typeof LISTE[number]`). So gibt es die Werte nur einmal, und die Zwillinge
@@ -436,6 +437,11 @@ export function mergePosSettings(standard, stored) {
436
437
  * ein Verbraucher selbst abgelegt hat; ein Stand in der inneren Form ergibt
437
438
  * die Standardwerte, nie einen deutschen Wert und nie einen Absturz.
438
439
  */
440
+ /** `{ deposit }`, wenn der Block lesbar ist, sonst nichts: ohne Block fehlt das Feld am Modell. */
441
+ function pfandBlock(wert) {
442
+ const deposit = posDepositSettingsFromWire(wert);
443
+ return deposit ? { deposit } : {};
444
+ }
439
445
  export function sanitizePosSettings(stored) {
440
446
  const roh = stored !== null && typeof stored === 'object' ? stored : {};
441
447
  const teil = (k) => {
@@ -446,6 +452,7 @@ export function sanitizePosSettings(stored) {
446
452
  business: mergePosSettings(POS_BUSINESS_DEFAULTS, teil('business')),
447
453
  device: mergePosSettings(POS_DEVICE_DEFAULTS, teil('device')),
448
454
  vouchers: posVoucherSettingsFromWire(eigen(roh, 'vouchers') ? roh['vouchers'] : undefined),
455
+ ...pfandBlock(eigen(roh, 'deposit') ? roh['deposit'] : undefined),
449
456
  };
450
457
  }
451
458
  /**
@@ -1005,6 +1005,33 @@ declare const MELDUNGEN_ROH: {
1005
1005
  readonly 'tip.unassigned_hint': {
1006
1006
  readonly text: "Trinkgeld ohne angemeldeten Benutzer.";
1007
1007
  };
1008
+ readonly 'deposit.changed': {
1009
+ readonly text: "Pfand wurde geändert. Bitte Summe prüfen.";
1010
+ };
1011
+ readonly 'deposit_error.not_enabled': {
1012
+ readonly text: "Pfand ist für diesen Betrieb nicht eingeschaltet.";
1013
+ };
1014
+ readonly 'deposit_error.type_not_found': {
1015
+ readonly text: "Diese Pfandart gibt es nicht mehr.";
1016
+ };
1017
+ readonly 'deposit_error.set_by_server': {
1018
+ readonly text: "Das Pfand bucht die Kasse selbst.";
1019
+ };
1020
+ readonly 'deposit_error.invalid_quantity': {
1021
+ readonly text: "Pfand gibt es nur für ganze Stück.";
1022
+ };
1023
+ readonly 'deposit_error.return_not_offered': {
1024
+ readonly text: "Diese Kasse nimmt kein Leergut zurück.";
1025
+ };
1026
+ readonly 'deposit_error.type_not_issued': {
1027
+ readonly text: "Dieses Leergut wurde hier nie verkauft.";
1028
+ };
1029
+ readonly 'deposit_error.follows_item': {
1030
+ readonly text: "Pfand wird mit seinem Artikel storniert.";
1031
+ };
1032
+ readonly 'deposit_error.invalid': {
1033
+ readonly text: "Die Pfand-Angaben stimmen nicht.";
1034
+ };
1008
1035
  };
1009
1036
  export type MessageKey = keyof typeof MELDUNGEN_ROH;
1010
1037
  export declare const MESSAGES: Record<MessageKey, TextEntry>;
@@ -1337,6 +1364,23 @@ export declare const VOUCHER_ERROR_MESSAGES: {
1337
1364
  export type VoucherMessageCode = keyof typeof VOUCHER_ERROR_MESSAGES;
1338
1365
  /** Der Satz zu einem Gutschein-`code`; `undefined` für jeden anderen Code. */
1339
1366
  export declare function voucherErrorMessage(code: string | undefined | null): MessageKey | undefined;
1367
+ /**
1368
+ * Pfand-Fehler (`/v3`, createReceipt und cancelReceipt): welcher `code` des
1369
+ * Backends welchen Satz bekommt. Kassensprache, keine Rechtssprache.
1370
+ */
1371
+ export declare const DEPOSIT_ERROR_MESSAGES: {
1372
+ readonly deposit_not_enabled: "deposit_error.not_enabled";
1373
+ readonly deposit_type_not_found: "deposit_error.type_not_found";
1374
+ readonly deposit_set_by_server: "deposit_error.set_by_server";
1375
+ readonly invalid_deposit_quantity: "deposit_error.invalid_quantity";
1376
+ readonly deposit_return_not_offered: "deposit_error.return_not_offered";
1377
+ readonly deposit_type_not_issued: "deposit_error.type_not_issued";
1378
+ readonly deposit_follows_item: "deposit_error.follows_item";
1379
+ readonly invalid_deposit: "deposit_error.invalid";
1380
+ };
1381
+ export type DepositMessageCode = keyof typeof DEPOSIT_ERROR_MESSAGES;
1382
+ /** Der Satz zu einem Pfand-`code`; `undefined` für jeden anderen Code. */
1383
+ export declare function depositErrorMessage(code: string | undefined | null): MessageKey | undefined;
1340
1384
  /**
1341
1385
  * Beschriftungen: Knoepfe, Ueberschriften, Zeilennamen – was kein Satz ist.
1342
1386
  *
@@ -3019,6 +3063,30 @@ declare const BESCHRIFTUNGEN_ROH: {
3019
3063
  readonly 'settings.tip_start': {
3020
3064
  readonly text: "Zuerst offen";
3021
3065
  };
3066
+ readonly 'deposit.return': {
3067
+ readonly text: "Leergut";
3068
+ };
3069
+ readonly 'deposit.payout': {
3070
+ readonly text: "Bar auszahlen";
3071
+ };
3072
+ readonly 'deposit.offset': {
3073
+ readonly text: "Mit Einkauf verrechnen";
3074
+ };
3075
+ readonly 'deposit.unknown_code': {
3076
+ readonly text: "Welches Leergut ist das?";
3077
+ };
3078
+ readonly 'deposit.over_usual': {
3079
+ readonly text: "Mehr als üblich – trotzdem annehmen?";
3080
+ };
3081
+ readonly 'deposit.on_premises': {
3082
+ readonly text: "Vor Ort";
3083
+ };
3084
+ readonly 'deposit.takeaway': {
3085
+ readonly text: "Mitnahme";
3086
+ };
3087
+ readonly 'deposit.sum': {
3088
+ readonly text: "Summe Leergut";
3089
+ };
3022
3090
  };
3023
3091
  export type LabelKey = keyof typeof BESCHRIFTUNGEN_ROH;
3024
3092
  export declare const LABELS: Record<LabelKey, TextEntry>;
@@ -477,6 +477,16 @@ const MELDUNGEN_ROH = {
477
477
  'shift.finish_step_first': { text: 'Erst den Schritt rechts abschließen oder abbrechen.' },
478
478
  'tip.revenue_hint': { text: 'Steuerpflichtiges Trinkgeld zählt als Umsatz des Betriebs und wird nicht ausgezahlt.' },
479
479
  'tip.unassigned_hint': { text: 'Trinkgeld ohne angemeldeten Benutzer.' },
480
+ // --- Pfand und Leergut (1.32.0): Fehlersätze (Zuordnung in DEPOSIT_ERROR_MESSAGES) ---
481
+ 'deposit.changed': { text: 'Pfand wurde geändert. Bitte Summe prüfen.' },
482
+ 'deposit_error.not_enabled': { text: 'Pfand ist für diesen Betrieb nicht eingeschaltet.' },
483
+ 'deposit_error.type_not_found': { text: 'Diese Pfandart gibt es nicht mehr.' },
484
+ 'deposit_error.set_by_server': { text: 'Das Pfand bucht die Kasse selbst.' },
485
+ 'deposit_error.invalid_quantity': { text: 'Pfand gibt es nur für ganze Stück.' },
486
+ 'deposit_error.return_not_offered': { text: 'Diese Kasse nimmt kein Leergut zurück.' },
487
+ 'deposit_error.type_not_issued': { text: 'Dieses Leergut wurde hier nie verkauft.' },
488
+ 'deposit_error.follows_item': { text: 'Pfand wird mit seinem Artikel storniert.' },
489
+ 'deposit_error.invalid': { text: 'Die Pfand-Angaben stimmen nicht.' },
480
490
  };
481
491
  // Auf den gemeinsamen Typ gebracht: `Object.entries(MESSAGES)` liefert sonst
482
492
  // pro Schluessel den engsten Literaltyp, und `placeholders`/`only` waeren nur
@@ -780,6 +790,25 @@ export function voucherErrorMessage(code) {
780
790
  const fehler = VOUCHER_ERROR_MESSAGES;
781
791
  return code !== undefined && code !== null ? fehler[code] : undefined;
782
792
  }
793
+ /**
794
+ * Pfand-Fehler (`/v3`, createReceipt und cancelReceipt): welcher `code` des
795
+ * Backends welchen Satz bekommt. Kassensprache, keine Rechtssprache.
796
+ */
797
+ export const DEPOSIT_ERROR_MESSAGES = {
798
+ deposit_not_enabled: 'deposit_error.not_enabled',
799
+ deposit_type_not_found: 'deposit_error.type_not_found',
800
+ deposit_set_by_server: 'deposit_error.set_by_server',
801
+ invalid_deposit_quantity: 'deposit_error.invalid_quantity',
802
+ deposit_return_not_offered: 'deposit_error.return_not_offered',
803
+ deposit_type_not_issued: 'deposit_error.type_not_issued',
804
+ deposit_follows_item: 'deposit_error.follows_item',
805
+ invalid_deposit: 'deposit_error.invalid',
806
+ };
807
+ /** Der Satz zu einem Pfand-`code`; `undefined` für jeden anderen Code. */
808
+ export function depositErrorMessage(code) {
809
+ const fehler = DEPOSIT_ERROR_MESSAGES;
810
+ return code !== undefined && code !== null && Object.prototype.hasOwnProperty.call(fehler, code) ? fehler[code] : undefined;
811
+ }
783
812
  /**
784
813
  * Beschriftungen: Knoepfe, Ueberschriften, Zeilennamen – was kein Satz ist.
785
814
  *
@@ -1424,6 +1453,15 @@ const BESCHRIFTUNGEN_ROH = {
1424
1453
  'tip.summary_percent': { text: 'Trinkgeld {tip} ({percent} %)', placeholders: ['tip', 'percent'] },
1425
1454
  'settings.tip_kinds': { text: 'Trinkgeld-Arten' },
1426
1455
  'settings.tip_start': { text: 'Zuerst offen' },
1456
+ // --- Pfand und Leergut (1.32.0) ---
1457
+ 'deposit.return': { text: 'Leergut' },
1458
+ 'deposit.payout': { text: 'Bar auszahlen' },
1459
+ 'deposit.offset': { text: 'Mit Einkauf verrechnen' },
1460
+ 'deposit.unknown_code': { text: 'Welches Leergut ist das?' },
1461
+ 'deposit.over_usual': { text: 'Mehr als üblich – trotzdem annehmen?' },
1462
+ 'deposit.on_premises': { text: 'Vor Ort' },
1463
+ 'deposit.takeaway': { text: 'Mitnahme' },
1464
+ 'deposit.sum': { text: 'Summe Leergut' },
1427
1465
  };
1428
1466
  export const LABELS = BESCHRIFTUNGEN_ROH;
1429
1467
  /**
@@ -1,4 +1,4 @@
1
- import { receiptItemTotalCents } from '../models/receipt-item.js';
1
+ import { isDepositItem, isDepositReturnItem, receiptItemTotalCents } from '../models/receipt-item.js';
2
2
  /**
3
3
  * Rabatt als negative Position(en) — eine je Steuersatz, anteilig zum
4
4
  * Bruttoumsatz dieses Satzes. So stimmt die MwSt-Tabelle des Belegs immer, das
@@ -18,6 +18,9 @@ export function distributeDiscount(items, discountCents, name = 'Rabatt') {
18
18
  // Umsatz je Steuersatz (nur positive Positionen -- Rabatte/Stornos zaehlen nicht mit)
19
19
  const gruppen = new Map();
20
20
  for (const p of items) {
21
+ // Pfand und Leergut werden nie rabattiert (durchlaufend, Spec E17).
22
+ if (isDepositItem(p) || isDepositReturnItem(p))
23
+ continue;
21
24
  const betrag = receiptItemTotalCents(p);
22
25
  if (betrag <= 0)
23
26
  continue;
@@ -151,6 +151,12 @@ export interface ReceiptDueBreakdown {
151
151
  valueVoucherFlowCents: number;
152
152
  /** Toepfe je auf Cent gerundet; `null` bei Start- und Nullbeleg. */
153
153
  bucketsCents: ReceiptDueBuckets | null;
154
+ /**
155
+ * `'deposit'`: der negative Zahlbetrag ist eine Leergut-Auszahlung (Beleg mit Leergut, Betrag hoechstens die
156
+ * Leergutsumme): genau eine Barzahlung ueber den Betrag, ohne Trinkgeld und ohne `tendered`. Ware fuehrt nie zu
157
+ * einer Auszahlung. Fehlt sonst.
158
+ */
159
+ payout?: 'deposit';
154
160
  }
155
161
  /**
156
162
  * Warum sich der Zahlbetrag nicht rechnen laesst. Fest wie ein Backend-Code;
@@ -1,7 +1,7 @@
1
1
  import { ReceiptType, VoucherAction, VoucherType } from '../enums/index.js';
2
2
  import { VoucherCode } from '@kreiseck/validator';
3
3
  import { toViennaWallClock } from '../vienna-time.js';
4
- import { centSumme, istDeckbar, kuSaetze, planeGutscheine, topfFuerSatz, trinkgeldCents, } from './gutschein-plan.js';
4
+ import { centSumme, istDeckbar, istPfandZeile, leergutCents, kuSaetze, planeGutscheine, topfFuerSatz, trinkgeldCents, } from './gutschein-plan.js';
5
5
  export { VOUCHER_ZERO_RATE_BUCKET_FROM } from './gutschein-plan.js';
6
6
  /**
7
7
  * Warum sich der Zahlbetrag nicht rechnen laesst. Fest wie ein Backend-Code;
@@ -100,15 +100,20 @@ function rechne(items, vouchers, receiptType, options) {
100
100
  const fluss = wertgutscheinFlussCents(gutscheine, art);
101
101
  const dueCents = t.zaehlerDeltaCents + fluss;
102
102
  // Ohne Auszahlungen darf der Zahlbetrag nicht negativ werden (Einloesung hoeher als die Summe).
103
- if (plan.mitPlan && dueCents + plan.auszahlungCents < 0) {
103
+ // Leergut ist nie deckbar und darf als Barauszahlung hinausgehen: es zaehlt in diesen Pruefungen nicht mit.
104
+ const leergut = leergutCents(kunde);
105
+ const nachGutscheinen = dueCents + plan.auszahlungCents - leergut;
106
+ if (plan.mitPlan && nachGutscheinen < 0) {
104
107
  throw new ReceiptDueError('invalid_voucher', 'die Gutscheine uebersteigen die Summe des Belegs.', 'voucher_exceeds_total');
105
108
  }
106
109
  // Ein Gutschein deckt nie das Trinkgeld (Personal wie Inhaber): der Zahlbetrag nach den Gutscheinen
107
110
  // muss die Trinkgeldzeilen tragen. Storno ausgenommen (dort gibt es keinen Plan).
108
111
  const trinkgeld = trinkgeldCents(kunde);
109
- if (plan.mitPlan && art !== 'cancellation' && trinkgeld > 0 && dueCents + plan.auszahlungCents < trinkgeld) {
112
+ if (plan.mitPlan && art !== 'cancellation' && trinkgeld > 0 && nachGutscheinen < trinkgeld) {
110
113
  throw new ReceiptDueError('invalid_voucher', 'die Gutscheine decken das Trinkgeld.', 'voucher_exceeds_total');
111
114
  }
115
+ // pfand-core.istLeergutAuszahlung: negativer Zahlbetrag eines Verkaufs mit Leergut, hoechstens die Leergutsumme.
116
+ const leergutAuszahlung = art !== 'cancellation' && leergut < 0 && dueCents < 0 && dueCents >= leergut;
112
117
  return {
113
118
  ergebnis: {
114
119
  dueCents,
@@ -122,6 +127,7 @@ function rechne(items, vouchers, receiptType, options) {
122
127
  amountRateSpecial: euroToCent(t.amountRateSpecial),
123
128
  amountRatOthers: euroToCent(t.amountRatOthers),
124
129
  },
130
+ ...(leergutAuszahlung ? { payout: 'deposit' } : {}),
125
131
  },
126
132
  kunde,
127
133
  minusJeTopf: plan.minusJeTopf,
@@ -421,10 +427,14 @@ const FUENF = ['amountRateStandard', 'amountRateReduced1', 'amountRateReduced2',
421
427
  /** `beleg-toepfe.belegToepfe`, Schritt fuer Schritt. */
422
428
  function belegToepfe(positionen, gutscheine) {
423
429
  const t = { amountRateStandard: 0, amountRateReduced1: 0, amountRateReduced2: 0, amountRateZero: 0, amountRateSpecial: 0, amountRatOthers: 0 };
424
- let personal = 0;
430
+ // Durchlaufende Posten (beleg-toepfe.durchlaufUndRest): Personal-Trinkgeld im 0-%-Topf, Pfand und Leergut im Topf ihres
431
+ // Satzes (Einweg hat 0 %, also Null). Sie liegen ungekuerzt im Topf, nach dem Rabatt, und zaehlen nicht in dessen Deckel.
432
+ const durchlauf = { amountRateStandard: 0, amountRateReduced1: 0, amountRateReduced2: 0, amountRateZero: 0, amountRateSpecial: 0, amountRatOthers: 0 };
425
433
  for (const p of positionen) {
426
434
  if (p.tip === 'staff')
427
- personal += p.amount * p.priceOne;
435
+ durchlauf.amountRateZero += p.amount * p.priceOne;
436
+ else if (istPfandZeile(p))
437
+ durchlauf[topfFuerSatz(p.vat)] += p.amount * p.priceOne;
428
438
  else
429
439
  t[topfFuerSatz(p.vat)] += p.priceOne * p.amount;
430
440
  }
@@ -457,7 +467,8 @@ function belegToepfe(positionen, gutscheine) {
457
467
  t[n] = (cents[i] - anteil[i]) / 100;
458
468
  });
459
469
  }
460
- t.amountRateZero += personal;
470
+ for (const n of [...FUENF, 'amountRatOthers'])
471
+ t[n] += durchlauf[n];
461
472
  const zaehlerDeltaCents = euroToCent(t.amountRateStandard) + euroToCent(t.amountRateReduced1) + euroToCent(t.amountRateReduced2) +
462
473
  euroToCent(t.amountRateZero) + euroToCent(t.amountRateSpecial) + euroToCent(t.amountRatOthers);
463
474
  return { ...t, zaehlerDeltaCents };
@@ -113,8 +113,14 @@ export interface PlanFehler {
113
113
  type TopfName = 'amountRateStandard' | 'amountRateReduced1' | 'amountRateReduced2' | 'amountRateZero' | 'amountRateSpecial' | 'amountRatOthers';
114
114
  /** `vat-buckets.bucketFuerSatz`. */
115
115
  export declare function topfFuerSatz(vat: number): TopfName;
116
- /** Position, die ein Gutschein decken darf: weder Trinkgeld noch Gutscheinzeile. */
116
+ /** Pfand- oder Leergutzeile: durchlaufend wie das Trinkgeld, nie rabattiert, nie von einem Gutschein gedeckt. */
117
+ export declare function istPfandZeile(p: {
118
+ kind?: string;
119
+ }): boolean;
120
+ /** Position, die ein Gutschein decken darf: weder Trinkgeld noch Gutscheinzeile noch Pfand oder Leergut (E18). */
117
121
  export declare function istDeckbar(p: Innen): boolean;
122
+ /** Summe der Leergutzeilen in Cent (<= 0), wie `pfand-core.leergutCents`: Menge x Einzelpreis, auf Cent gerundet. */
123
+ export declare function leergutCents(positionen: readonly Innen[]): number;
118
124
  /** Summe der Trinkgeldzeilen (Personal und Inhaber) in Cent, wie `centSumme(kunde.filter(istTip))` im Backend. */
119
125
  export declare function trinkgeldCents(kunde: readonly Innen[]): number;
120
126
  /** Wie beleg-toepfe: Euro in Positionsreihenfolge aufsummieren, erst die Summe auf Cent runden. */
@@ -25,9 +25,21 @@ const TOPF_REIHENFOLGE = ['amountRateStandard', 'amountRateReduced1', 'amountRat
25
25
  function istGutscheinZeile(p) {
26
26
  return p.kind !== undefined && KINDS.includes(p.kind);
27
27
  }
28
- /** Position, die ein Gutschein decken darf: weder Trinkgeld noch Gutscheinzeile. */
28
+ /** Pfand- oder Leergutzeile: durchlaufend wie das Trinkgeld, nie rabattiert, nie von einem Gutschein gedeckt. */
29
+ export function istPfandZeile(p) {
30
+ return p.kind === 'deposit' || p.kind === 'deposit_return';
31
+ }
32
+ /** Position, die ein Gutschein decken darf: weder Trinkgeld noch Gutscheinzeile noch Pfand oder Leergut (E18). */
29
33
  export function istDeckbar(p) {
30
- return p.tip == null && p.kind !== 'tip' && !istGutscheinZeile(p);
34
+ return p.tip == null && p.kind !== 'tip' && !istGutscheinZeile(p) && !istPfandZeile(p);
35
+ }
36
+ /** Summe der Leergutzeilen in Cent (<= 0), wie `pfand-core.leergutCents`: Menge x Einzelpreis, auf Cent gerundet. */
37
+ export function leergutCents(positionen) {
38
+ let summe = 0;
39
+ for (const p of positionen)
40
+ if (p.kind === 'deposit_return')
41
+ summe += Math.round(p.amount * Math.round(p.priceOne * 100));
42
+ return summe;
31
43
  }
32
44
  /** Summe der Trinkgeldzeilen (Personal und Inhaber) in Cent, wie `centSumme(kunde.filter(istTip))` im Backend. */
33
45
  export function trinkgeldCents(kunde) {
@@ -1,5 +1,5 @@
1
1
  import { VatRate, VoucherAction, VoucherType } from '../enums/index.js';
2
- import { CANCELLATION_REASONS, isCancellationReason, receiptCompanyTaxInfo, receiptItemTotalCents, isDiscountItem, isTipItem, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, voucherIsValid, isExternalVoucher, } from '../models/index.js';
2
+ import { CANCELLATION_REASONS, isCancellationReason, receiptCompanyTaxInfo, receiptItemTotalCents, isDepositItem, isDepositReturnItem, isDiscountItem, isTipItem, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, voucherIsValid, isExternalVoucher, } from '../models/index.js';
3
3
  import { parseServerTimeStamp, toViennaWallClock } from '../vienna-time.js';
4
4
  import { KasseneckValidationError } from '../client/errors.js';
5
5
  import { addOnDisplayOrder, istGueltigerZusatz } from '../pos/zusaetze.js';
@@ -442,6 +442,20 @@ function barZeilen(zahlung) {
442
442
  */
443
443
  function zahlungsZeilen(receipt) {
444
444
  const zahlungen = receipt.payments;
445
+ // Reiner Leergutbeleg: die negative Barzahlung ist eine Auszahlung an den Kunden.
446
+ if (istReinerLeergutBeleg(receipt)) {
447
+ const bar = zahlungen != null && zahlungen.length > 0
448
+ ? zahlungen.filter((z) => BAR_ZAHLARTEN.includes(zahlartSchluessel(z.method)) && z.amountCents < 0)
449
+ : [];
450
+ if (zahlungen == null || zahlungen.length === 0) {
451
+ if (BAR_ZAHLARTEN.includes(zahlartSchluessel(receipt.paymentMethod)) && receiptSumCents(receipt) < 0) {
452
+ return [paarZeile(LEERGUT_AUSZAHLUNG, `${formatCents(receiptSumCents(receipt))} €`, 8, 4)];
453
+ }
454
+ }
455
+ else if (bar.length === zahlungen.length) {
456
+ return bar.map((z) => paarZeile(LEERGUT_AUSZAHLUNG, `${formatCents(z.amountCents)} €`, 8, 4));
457
+ }
458
+ }
445
459
  // Trägt der Beleg eine Gutschein-Zahlungszeile, entfällt, was 0 Cent kostet
446
460
  // (§ 132a Abs. 3 BAO: die Zahlungsart ist kein Pflichtinhalt, der Betrag bleibt).
447
461
  const mitGutschein = receipt.vouchers.some((v) => v.action === VoucherAction.redeem && v.type !== VoucherType.promo);
@@ -867,6 +881,79 @@ function positionsZeile(item, satz, zusatz = false) {
867
881
  ],
868
882
  };
869
883
  }
884
+ // ------------------------------------------------------------ Pfand & Leergut
885
+ /** Ueberschrift eines reinen Leergutbelegs (nur Leergut-Positionen). */
886
+ const LEERGUT_UEBERSCHRIFT = 'Leergut-Rückgabe';
887
+ /** Zahlungszeile eines reinen Leergutbelegs: das Pfand geht bar zurueck an den Kunden. */
888
+ const LEERGUT_AUSZAHLUNG = 'Bar ausgezahlt';
889
+ /** Zusatz an der 0-%-Zeile, wenn Einwegpfand darauf liegt (kein Entgelt, nicht steuerbar). */
890
+ const PFAND_NICHT_STEUERBAR = 'Pfand, nicht steuerbar';
891
+ /** Vorsatz der Fusszeile mit der gemeinsamen Ruecknahmestelle. */
892
+ const LEERGUT_STELLE_VORSATZ = 'Leergut-Rückgabe: ';
893
+ /** Reiner Leergutbeleg: mindestens eine Leergut-Position, sonst nur Trinkgeld/Rabatt-freie Leergutzeilen. */
894
+ function istReinerLeergutBeleg(receipt) {
895
+ return receipt.items.length > 0 && receipt.items.some(isDepositReturnItem) && receipt.items.every(isDepositReturnItem);
896
+ }
897
+ /**
898
+ * Pfandzeilen, die unter ihrer Warenposition stehen (`depositFor` zeigt auf eine Ware, nicht auf Trinkgeld,
899
+ * Rabatt, Pfand oder Leergut und nicht auf sich selbst). Alle anderen Pfandzeilen bleiben an ihrem Platz.
900
+ */
901
+ function pfandZuPosition(items) {
902
+ const zu = new Map();
903
+ items.forEach((it, i) => {
904
+ if (!isDepositItem(it))
905
+ return;
906
+ const ziel = it.depositFor;
907
+ if (typeof ziel !== 'number' || !Number.isInteger(ziel) || ziel < 0 || ziel >= items.length || ziel === i)
908
+ return;
909
+ const hauptzeile = items[ziel];
910
+ if (isTipItem(hauptzeile) || isDiscountItem(hauptzeile) || isDepositItem(hauptzeile) || isDepositReturnItem(hauptzeile))
911
+ return;
912
+ zu.set(ziel, [...(zu.get(ziel) ?? []), i]);
913
+ });
914
+ return zu;
915
+ }
916
+ /**
917
+ * Bon-Reihenfolge mit Pfand: Hauptposition, ihre Zusaetze (je mit eigener Pfandzeile direkt darunter), dann die
918
+ * Pfandzeile der Hauptposition. Ohne Pfandverweise bleibt `reihe` unveraendert.
919
+ */
920
+ function mitPfandReihenfolge(items, reihe, zu) {
921
+ if (zu.size === 0)
922
+ return reihe;
923
+ const gebunden = new Set();
924
+ for (const liste of zu.values())
925
+ for (const i of liste)
926
+ gebunden.add(i);
927
+ const raus = [];
928
+ let offen = [];
929
+ for (const i of reihe) {
930
+ if (gebunden.has(i))
931
+ continue;
932
+ if (istGueltigerZusatz(items, i)) {
933
+ raus.push(i, ...(zu.get(i) ?? []));
934
+ continue;
935
+ }
936
+ raus.push(...offen);
937
+ raus.push(i);
938
+ offen = zu.get(i) ?? [];
939
+ }
940
+ raus.push(...offen);
941
+ return raus;
942
+ }
943
+ /** Einwegpfand und -leergut auf dem 0-%-Satz in Cent (Pfandzeilen minus Leergut); `null`, wenn keins darauf liegt. */
944
+ function einwegPfandCents(receipt) {
945
+ let summe = 0;
946
+ let gefunden = false;
947
+ for (const it of receipt.items) {
948
+ if (!(isDepositItem(it) || isDepositReturnItem(it)) || it.depositKind !== 'single_use')
949
+ continue;
950
+ if (steuersatz(it.vat).rate !== 0)
951
+ continue;
952
+ summe += receiptItemTotalCents(it);
953
+ gefunden = true;
954
+ }
955
+ return gefunden ? summe : null;
956
+ }
870
957
  // ---------------------------------------------------------------- Belegart
871
958
  const TESTKASSE_TEXT = 'TESTKASSE — kein gültiger Beleg';
872
959
  const TESTSIGNATUR_TEXT = 'TESTSIGNATUR — kein gültiger Beleg';
@@ -1044,6 +1131,9 @@ function belegartBlock(receipt) {
1044
1131
  for (const z of TRAINING_ERKLAERUNG)
1045
1132
  aus.push(textZeile(z, 'center'));
1046
1133
  }
1134
+ else if (istReinerLeergutBeleg(receipt)) {
1135
+ aus.push(textZeile(LEERGUT_UEBERSCHRIFT, 'center', true));
1136
+ }
1047
1137
  else if (t === 'start') {
1048
1138
  aus.push(bannerZeile('STARTBELEG'));
1049
1139
  aus.push(textZeile('Nullbeleg zur Inbetriebnahme', 'center'));
@@ -1188,7 +1278,12 @@ export function buildReceiptLayout(receipt, company, options = {}) {
1188
1278
  const gutscheinZuordnung = gutscheinPositionen(receipt);
1189
1279
  // Zusatz-Kacheln: Zusaetze direkt unter ihrer Hauptposition (stabil); ohne
1190
1280
  // Verweise ist die Reihenfolge die des Belegs (byte-gleich).
1191
- const reihe = addOnDisplayOrder(receipt.items);
1281
+ const pfandZu = pfandZuPosition(receipt.items);
1282
+ const gebundenesPfand = new Set();
1283
+ for (const liste of pfandZu.values())
1284
+ for (const k of liste)
1285
+ gebundenesPfand.add(k);
1286
+ const reihe = mitPfandReihenfolge(receipt.items, addOnDisplayOrder(receipt.items), pfandZu);
1192
1287
  const an = (k) => receipt.items[reihe[k]];
1193
1288
  let i = 0;
1194
1289
  while (i < reihe.length) {
@@ -1197,7 +1292,7 @@ export function buildReceiptLayout(receipt, company, options = {}) {
1197
1292
  const satz = steuersatz(item.vat);
1198
1293
  gruppeVon(satz).bruttoCents += receiptItemTotalCents(item);
1199
1294
  const gutschein = gutscheinZuordnung.get(reihe[i]);
1200
- lines.push(...(gutschein ? gutscheinPositionsZeilen(item, satz, gutschein) : [positionsZeile(item, satz, istGueltigerZusatz(receipt.items, reihe[i]))]));
1295
+ lines.push(...(gutschein ? gutscheinPositionsZeilen(item, satz, gutschein) : [positionsZeile(item, satz, istGueltigerZusatz(receipt.items, reihe[i]) || gebundenesPfand.has(reihe[i]))]));
1201
1296
  i += 1;
1202
1297
  continue;
1203
1298
  }
@@ -1293,6 +1388,10 @@ export function buildReceiptLayout(receipt, company, options = {}) {
1293
1388
  formatCents(bruttoCents),
1294
1389
  ], paperSize));
1295
1390
  }
1391
+ // Einwegpfand liegt auf dem 0-%-Satz, ist aber kein Entgelt: die Zeile sagt es dem Leser der Tabelle.
1392
+ const einwegCents = einwegPfandCents(receipt);
1393
+ if (einwegCents !== null)
1394
+ lines.push(paarZeile(PFAND_NICHT_STEUERBAR, formatCents(einwegCents), 9, 3));
1296
1395
  // Mitarbeiter-Trinkgeld ist als Null-%-Umsatz erfasst (Erlass 2.4.2.1), aber
1297
1396
  // kein Umsatz des Betriebs — die Klarstellung steht direkt unter der
1298
1397
  // 0-%-Zeile, damit der Beleg (auch als Rechnung) nicht nach steuerfreiem
@@ -1381,6 +1480,13 @@ export function buildReceiptLayout(receipt, company, options = {}) {
1381
1480
  lines.push(textZeile(fuss, 'center'));
1382
1481
  }
1383
1482
  }
1483
+ // Gemeinsame Ruecknahmestelle fuer Leergut (nur, wenn der Server sie gestempelt hat).
1484
+ const stelle = receipt.sharedReturnPoint;
1485
+ if (stelle != null) {
1486
+ const angabe = [stelle.name, stelle.address].filter((t) => t !== '').join(', ');
1487
+ if (angabe !== '')
1488
+ lines.push(textZeile(`${LEERGUT_STELLE_VORSATZ}${angabe}`, 'center'));
1489
+ }
1384
1490
  // --- Warnrahmen unten (Testkasse/Testsignatur)
1385
1491
  if (warnungen.length > 0) {
1386
1492
  lines.push({ kind: 'space', lines: 1 });
@@ -1,6 +1,7 @@
1
1
  import { type TransportOptions } from '../client/transport.js';
2
2
  import { type ReceiptCompany } from '../models/receipt-company.js';
3
3
  import type { PosSettings } from '../pos/settings.js';
4
+ import { type CashRegisterDeposit } from '../pos/pfand.js';
4
5
  /**
5
6
  * Verbindungsangaben ohne Anmeldung — alles, was [TransportOptions] ausser der
6
7
  * Anmeldung fuehrt. Alle Felder sind wahlfrei: ohne Angabe gelten der Kassenweg
@@ -142,11 +143,13 @@ export interface RegisterDeviceUsers {
142
143
  * Startbeleg fehlt): die Kasse sperrt das Kassieren VOR dem ersten Beleg
143
144
  * statt an createReceipt zu scheitern. Fehlt das Feld, gilt bereit.
144
145
  * `stockLocationId`: Lager-Standort der Kasse, fehlt = Standard-Standort.
146
+ * `deposit`: Pfand & Leergut der Kasse (Ruecknahme, Vorgaben); fehlt, solange der Betrieb kein Pfand eingeschaltet hat.
145
147
  */
146
148
  cashregister?: {
147
149
  ready: boolean;
148
150
  reason?: string | null;
149
151
  stockLocationId?: string;
152
+ deposit?: CashRegisterDeposit;
150
153
  };
151
154
  /** Das Geraet haengt an der Test-Umgebung des Betriebs. */
152
155
  testEnvironment: boolean;
@@ -209,6 +212,11 @@ export interface RegisterUserPerms {
209
212
  voucherRedeem?: boolean;
210
213
  /** Gutscheine verwalten, z. B. Etikett nachdrucken (fehlt: verweigert). */
211
214
  voucherManage?: boolean;
215
+ /**
216
+ * Leergut annehmen (Pfand & Leergut). Fehlt das Recht, gilt es als erteilt (Rollenvorgabe: Kassier und Chef) --
217
+ * siehe [depositReturnOf]; ein ausdrueckliches `false` sperrt. Unter /v3 loest der Server es bei der Anmeldung auf.
218
+ */
219
+ depositReturn?: boolean;
212
220
  [weiteresRecht: string]: boolean | RegisterScope | undefined;
213
221
  }
214
222
  /**
@@ -219,7 +227,7 @@ export interface RegisterUserPerms {
219
227
  * nicht fuehrt (Tippfehler, umbenanntes Recht), kommt hier nicht durch.
220
228
  * Die Gegenrichtung schliesst [_RechteVollstaendig] direkt darunter.
221
229
  */
222
- export declare const REGISTER_PERMS: readonly ["sell", "cancel", "articles", "layout", "reports", "takeover", "cancelScope", "receiptsScope", "drawer", "discount", "tipAssign", "stockView", "stockCosts", "stockMove", "stockLoss", "stocktakeCount", "stocktakeClose", "stockLocation", "voucherSell", "voucherRedeem", "voucherManage"];
230
+ export declare const REGISTER_PERMS: readonly ["sell", "cancel", "articles", "layout", "reports", "takeover", "cancelScope", "receiptsScope", "drawer", "discount", "tipAssign", "stockView", "stockCosts", "stockMove", "stockLoss", "stocktakeCount", "stocktakeClose", "stockLocation", "voucherSell", "voucherRedeem", "voucherManage", "depositReturn"];
223
231
  /** Reichweite lesen, mit der Migration des Backends (register-auth.js). */
224
232
  export declare function cancelScopeOf(perms: RegisterUserPerms | null | undefined): RegisterScope;
225
233
  export declare function receiptsScopeOf(perms: RegisterUserPerms | null | undefined): RegisterScope;
@@ -229,6 +237,12 @@ export declare function receiptsScopeOf(perms: RegisterUserPerms | null | undefi
229
237
  * sperrt; alle anderen Lager-Rechte gelten ohne Schluessel als verweigert.
230
238
  */
231
239
  export declare function stockViewOf(perms: RegisterUserPerms | null | undefined): boolean;
240
+ /**
241
+ * Darf der Benutzer Leergut annehmen? Ohne Schluessel gilt das Recht als erteilt (Rollenvorgabe `Leergut annehmen`
242
+ * ist fuer Kassier und Chef an, ein alter Server und `/api`-Antworten kennen es nicht); nur ein ausdrueckliches
243
+ * `false` sperrt. Ohne Rechte-Objekt: nein.
244
+ */
245
+ export declare function depositReturnOf(perms: Partial<RegisterUserPerms> | null | undefined): boolean;
232
246
  /** Die drei Gutschein-Rechte, aufgeloest (kein Schluessel fehlt mehr). */
233
247
  export interface VoucherPerms {
234
248
  voucherSell: boolean;
@@ -2,6 +2,7 @@ import { KasseneckValidationError } from '../client/errors.js';
2
2
  import { createTransport } from '../client/transport.js';
3
3
  import { fromReceiptCompanyPayload } from '../models/receipt-company.js';
4
4
  import { posSettingsFromWire } from '../pos/client.js';
5
+ import { cashRegisterDepositFromWire } from '../pos/pfand.js';
5
6
  /**
6
7
  * Die drei Aufrufe, die **ohne jede Identitaet** laufen: Kopplung eines
7
8
  * Geraets, Benutzerliste dieses Geraets, PIN-Anmeldung. Sie sind der Weg, auf
@@ -50,7 +51,7 @@ export const REGISTER_PERMS = [
50
51
  'sell', 'cancel', 'articles', 'layout', 'reports', 'takeover',
51
52
  'cancelScope', 'receiptsScope', 'drawer', 'discount', 'tipAssign',
52
53
  'stockView', 'stockCosts', 'stockMove', 'stockLoss', 'stocktakeCount', 'stocktakeClose', 'stockLocation',
53
- 'voucherSell', 'voucherRedeem', 'voucherManage',
54
+ 'voucherSell', 'voucherRedeem', 'voucherManage', 'depositReturn',
54
55
  ];
55
56
  /** Reichweite lesen, mit der Migration des Backends (register-auth.js). */
56
57
  export function cancelScopeOf(perms) {
@@ -77,6 +78,16 @@ export function stockViewOf(perms) {
77
78
  return false;
78
79
  return perms.stockView === undefined ? true : perms.stockView === true;
79
80
  }
81
+ /**
82
+ * Darf der Benutzer Leergut annehmen? Ohne Schluessel gilt das Recht als erteilt (Rollenvorgabe `Leergut annehmen`
83
+ * ist fuer Kassier und Chef an, ein alter Server und `/api`-Antworten kennen es nicht); nur ein ausdrueckliches
84
+ * `false` sperrt. Ohne Rechte-Objekt: nein.
85
+ */
86
+ export function depositReturnOf(perms) {
87
+ if (!perms)
88
+ return false;
89
+ return perms.depositReturn === undefined ? true : perms.depositReturn === true;
90
+ }
80
91
  /**
81
92
  * Gutschein-Rechte lesen. Das Backend loest sie bei der Anmeldung auf; ein
82
93
  * alter Server (und `/api`-Antworten) kennt sie nicht. Dann gilt je fehlendem
@@ -231,6 +242,7 @@ function kasseBereit(wert) {
231
242
  ready: roh['ready'],
232
243
  reason: typeof roh['reason'] === 'string' ? roh['reason'] : null,
233
244
  ...(typeof standort === 'string' && standort !== '' ? { stockLocationId: standort } : {}),
245
+ ...(cashRegisterDepositFromWire(roh['deposit']) ? { deposit: cashRegisterDepositFromWire(roh['deposit']) } : {}),
234
246
  };
235
247
  }
236
248
  /** Die Regel aus der Antwort — oder `null`, wenn keine brauchbare kommt. */
@@ -1,5 +1,5 @@
1
1
  /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
2
- export declare const VOKABULAR_QUELLE = "04ab5e1d031979a4f0aa31ea000f4cbe1d6e557e2411e439899ac19a1bba0325";
2
+ export declare const VOKABULAR_QUELLE = "168261a0b5130d454fc3b5d51e8ee567d6a3e9a5d2d8e172829e9ccb17c47f31";
3
3
  /** Schema-Notation des Vertrags: Blatt 'aussen': 'innen', Objekt { __: 'innen', ... }, Liste [ { __: 'innen', ... } ]. */
4
4
  export type SchemaEintrag = string | SchemaObjekt | readonly [SchemaObjekt];
5
5
  export interface SchemaObjekt {