@kreiseck/kasseneck-api 1.30.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 (150) hide show
  1. package/CHANGELOG.md +33 -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 +10 -5
  8. package/dist/cjs/models/index.d.ts +2 -2
  9. package/dist/cjs/models/index.js +7 -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/models/voucher.d.ts +18 -0
  17. package/dist/cjs/models/voucher.js +32 -1
  18. package/dist/cjs/pos/artikel.d.ts +26 -0
  19. package/dist/cjs/pos/artikel.js +5 -0
  20. package/dist/cjs/pos/client.d.ts +1 -0
  21. package/dist/cjs/pos/client.js +14 -0
  22. package/dist/cjs/pos/errors.d.ts +1 -1
  23. package/dist/cjs/pos/errors.js +13 -0
  24. package/dist/cjs/pos/fremdgutschein-artikel.d.ts +66 -0
  25. package/dist/cjs/pos/fremdgutschein-artikel.js +74 -0
  26. package/dist/cjs/pos/index.d.ts +9 -4
  27. package/dist/cjs/pos/index.js +62 -4
  28. package/dist/cjs/pos/leergut.d.ts +60 -0
  29. package/dist/cjs/pos/leergut.js +82 -0
  30. package/dist/cjs/pos/pfand.d.ts +144 -0
  31. package/dist/cjs/pos/pfand.js +382 -0
  32. package/dist/cjs/pos/rabatt-vorlagen.d.ts +79 -0
  33. package/dist/cjs/pos/rabatt-vorlagen.js +156 -0
  34. package/dist/cjs/pos/schicht-lesen.js +8 -0
  35. package/dist/cjs/pos/schicht-typen.d.ts +15 -0
  36. package/dist/cjs/pos/settings.d.ts +72 -10
  37. package/dist/cjs/pos/settings.js +79 -5
  38. package/dist/cjs/pos/texte.d.ts +283 -0
  39. package/dist/cjs/pos/texte.js +163 -1
  40. package/dist/cjs/pos/zusaetze.d.ts +3 -3
  41. package/dist/cjs/pos/zusaetze.js +4 -2
  42. package/dist/cjs/receipt/discount.js +3 -0
  43. package/dist/cjs/receipt/due.d.ts +6 -0
  44. package/dist/cjs/receipt/due.js +16 -5
  45. package/dist/cjs/receipt/gutschein-plan.d.ts +7 -1
  46. package/dist/cjs/receipt/gutschein-plan.js +16 -2
  47. package/dist/cjs/receipt/layout.js +108 -2
  48. package/dist/cjs/receipt/shift-sheet.js +8 -0
  49. package/dist/cjs/register/pairing.d.ts +15 -1
  50. package/dist/cjs/register/pairing.js +14 -1
  51. package/dist/cjs/stored/draht.js +1 -0
  52. package/dist/cjs/stored/einstellungen.js +50 -2
  53. package/dist/cjs/stored/vokabular.d.ts +1 -1
  54. package/dist/cjs/stored/vokabular.js +107 -5
  55. package/dist/cjs/version.d.ts +1 -1
  56. package/dist/cjs/version.js +1 -1
  57. package/dist/esm/client/aufrufe.d.ts +3 -3
  58. package/dist/esm/client/aufrufe.js +8 -0
  59. package/dist/esm/client/receipts.d.ts +11 -0
  60. package/dist/esm/client/receipts.js +14 -0
  61. package/dist/esm/index.d.ts +2 -2
  62. package/dist/esm/index.js +2 -2
  63. package/dist/esm/models/index.d.ts +2 -2
  64. package/dist/esm/models/index.js +2 -2
  65. package/dist/esm/models/receipt-errors.d.ts +1 -1
  66. package/dist/esm/models/receipt-errors.js +9 -0
  67. package/dist/esm/models/receipt-item.d.ts +44 -2
  68. package/dist/esm/models/receipt-item.js +54 -1
  69. package/dist/esm/models/receipt.d.ts +17 -0
  70. package/dist/esm/models/receipt.js +9 -0
  71. package/dist/esm/models/voucher.d.ts +18 -0
  72. package/dist/esm/models/voucher.js +30 -0
  73. package/dist/esm/pos/artikel.d.ts +26 -0
  74. package/dist/esm/pos/artikel.js +5 -0
  75. package/dist/esm/pos/client.d.ts +1 -0
  76. package/dist/esm/pos/client.js +15 -1
  77. package/dist/esm/pos/errors.d.ts +1 -1
  78. package/dist/esm/pos/errors.js +13 -0
  79. package/dist/esm/pos/fremdgutschein-artikel.d.ts +66 -0
  80. package/dist/esm/pos/fremdgutschein-artikel.js +67 -0
  81. package/dist/esm/pos/index.d.ts +9 -4
  82. package/dist/esm/pos/index.js +10 -4
  83. package/dist/esm/pos/leergut.d.ts +60 -0
  84. package/dist/esm/pos/leergut.js +77 -0
  85. package/dist/esm/pos/pfand.d.ts +144 -0
  86. package/dist/esm/pos/pfand.js +371 -0
  87. package/dist/esm/pos/rabatt-vorlagen.d.ts +79 -0
  88. package/dist/esm/pos/rabatt-vorlagen.js +148 -0
  89. package/dist/esm/pos/schicht-lesen.js +8 -0
  90. package/dist/esm/pos/schicht-typen.d.ts +15 -0
  91. package/dist/esm/pos/settings.d.ts +72 -10
  92. package/dist/esm/pos/settings.js +74 -4
  93. package/dist/esm/pos/texte.d.ts +283 -0
  94. package/dist/esm/pos/texte.js +160 -0
  95. package/dist/esm/pos/zusaetze.d.ts +3 -3
  96. package/dist/esm/pos/zusaetze.js +4 -2
  97. package/dist/esm/receipt/discount.js +4 -1
  98. package/dist/esm/receipt/due.d.ts +6 -0
  99. package/dist/esm/receipt/due.js +17 -6
  100. package/dist/esm/receipt/gutschein-plan.d.ts +7 -1
  101. package/dist/esm/receipt/gutschein-plan.js +14 -2
  102. package/dist/esm/receipt/layout.js +109 -3
  103. package/dist/esm/receipt/shift-sheet.js +8 -0
  104. package/dist/esm/register/pairing.d.ts +15 -1
  105. package/dist/esm/register/pairing.js +13 -1
  106. package/dist/esm/stored/draht.js +1 -0
  107. package/dist/esm/stored/einstellungen.js +52 -4
  108. package/dist/esm/stored/vokabular.d.ts +1 -1
  109. package/dist/esm/stored/vokabular.js +107 -5
  110. package/dist/esm/version.d.ts +1 -1
  111. package/dist/esm/version.js +1 -1
  112. package/fixtures/add-on-cases.json +6 -4
  113. package/fixtures/deposit-cases.json +4758 -0
  114. package/fixtures/discount-preset-cases.json +1074 -0
  115. package/fixtures/expected/deposit-return.grid32.txt +28 -0
  116. package/fixtures/expected/deposit-return.grid48.txt +28 -0
  117. package/fixtures/expected/deposit-return.lines.json +275 -0
  118. package/fixtures/expected/deposit-return.sheet32.json +194 -0
  119. package/fixtures/expected/deposit-return.sheet48.json +194 -0
  120. package/fixtures/expected/deposit.grid32.txt +34 -0
  121. package/fixtures/expected/deposit.grid48.txt +32 -0
  122. package/fixtures/expected/deposit.lines.json +316 -0
  123. package/fixtures/expected/deposit.sheet32.json +230 -0
  124. package/fixtures/expected/deposit.sheet48.json +218 -0
  125. package/fixtures/external-voucher-article-cases.json +311 -0
  126. package/fixtures/hobex-hps-codes.json +1 -1
  127. package/fixtures/invoice-api.schema.json +1 -1
  128. package/fixtures/invoice-texts.json +1 -1
  129. package/fixtures/manifest.json +16 -0
  130. package/fixtures/pos-texts.json +266 -1
  131. package/fixtures/receipt-due-voucher-generated.json +1 -1
  132. package/fixtures/receipts/deposit-return.json +63 -0
  133. package/fixtures/receipts/deposit.json +83 -0
  134. package/fixtures/renames-1.0.json +18 -0
  135. package/fixtures/return-code-cases.json +1338 -0
  136. package/fixtures/surface.json +92 -7
  137. package/fixtures/v3/antworten/belege.json +2 -2
  138. package/fixtures/v3/antworten/belegmail.json +2 -2
  139. package/fixtures/v3/antworten/berichte.json +2 -2
  140. package/fixtures/v3/antworten/kasse-belege.json +2 -2
  141. package/fixtures/v3/antworten/kasse.json +428 -13
  142. package/fixtures/v3/antworten/lager.json +1 -1
  143. package/fixtures/v3/antworten/rechnungen.json +2 -2
  144. package/fixtures/v3/antworten/storno.json +2 -2
  145. package/fixtures/v3/stored/belege.json +2 -2
  146. package/fixtures/v3/stored/kasse.json +42 -4
  147. package/fixtures/v3/stored/rechnungen.json +2 -2
  148. package/fixtures/v3/v3-vokabular.json +898 -31
  149. package/fixtures/v3/zahlbetrag-faelle.json +187 -3
  150. package/package.json +1 -1
@@ -20,6 +20,7 @@
20
20
  * `only`), die Platzhalter und die Arten der Fehlerregeln (Abschnitte
21
21
  * `placeholders` und `structure`).
22
22
  */
23
+ import { ARTICLE_EXTERNAL_VOUCHER_INVALID } from './fremdgutschein-artikel.js';
23
24
  import { isOutcomeUnknown, KasseneckApiError, KasseneckHttpError, KasseneckNetworkError } from '../client/errors.js';
24
25
  const MELDUNGEN_ROH = {
25
26
  // --- Transport -----------------------------------------------------------
@@ -74,6 +75,16 @@ const MELDUNGEN_ROH = {
74
75
  'reference.format_invalid': { text: 'Das Format passt nicht.' },
75
76
  'reference.format_warning': { text: 'Das Format passt nicht. Trotzdem übernehmen?' },
76
77
  'discount.percent_invalid': { text: 'Bitte einen Prozentwert zwischen 0,1 und 100 eingeben.' },
78
+ // Rabatt-Vorlagen (benannte Rabatt-Chips, 1.31.0): Fehler der Pruefung (checkDiscountPresets) und der gesperrte Chip.
79
+ 'discount.preset_over_total': { text: 'Der Rabatt ist höher als der Betrag, auf den er gilt.' },
80
+ 'discount_preset.list': { text: 'Höchstens 5 Rabatt-Vorlagen als Liste.' },
81
+ 'discount_preset.entry': { text: 'Eine Rabatt-Vorlage ist ein Objekt mit Name, Art und Wert.' },
82
+ 'discount_preset.name': { text: 'Name mit 1 bis 24 Zeichen, ohne Steuerzeichen.' },
83
+ 'discount_preset.duplicate': { text: 'Diesen Namen gibt es schon.' },
84
+ 'discount_preset.kind': { text: 'Prozent oder Betrag.' },
85
+ 'discount_preset.percent': { text: 'Prozent zwischen 0,1 und 100 mit höchstens einer Nachkommastelle.' },
86
+ 'discount_preset.amount': { text: 'Betrag zwischen 0,01 € und 1.000.000,00 €.' },
87
+ 'discount_preset.unknown_field': { text: 'Unbekanntes Feld.' },
77
88
  // --- Kassieren -----------------------------------------------------------
78
89
  // Der Grund ueber dem Knopf, solange der Beleg nicht abgeschlossen werden kann.
79
90
  'checkout.nothing_entered': { text: 'Noch nichts erfasst – bitte zuerst eine Position aufnehmen.' },
@@ -87,6 +98,9 @@ const MELDUNGEN_ROH = {
87
98
  'tip.over_half': { text: 'Über 50 % Trinkgeld – wirklich? Steuerfrei ist nur ortsübliches Trinkgeld.' },
88
99
  // Bar-Trinkgeld „gleich behalten“ (Hinweis zur Einstellung, Beschriftungen unten).
89
100
  'tip.kept_setting_hint': { text: 'Der Mitarbeiter steckt das Bar-Trinkgeld beim Verkauf gleich ein: es zählt nicht ins Soll der Lade und gilt als schon genommen. An der Kasse lässt es sich je Verkauf umstellen.' },
101
+ // Hinweis unter dem Trinkgeld beim Kassieren je nach Wahl (tipKeptFor): gleich behalten bzw. offen fuer den Benutzer.
102
+ 'tip.kept_hint': { text: 'Trinkgeld kommt als eigene Position auf den Beleg; der angemeldete Benutzer nimmt es gleich bar aus der Lade.' },
103
+ 'tip.open_hint': { text: 'Trinkgeld kommt als eigene Position auf den Beleg und bleibt für den angemeldeten Benutzer offen, bis es ausgezahlt wird.' },
90
104
  // --- Abschluss -----------------------------------------------------------
91
105
  'completion.failed': { text: 'Der Abschluss ist fehlgeschlagen.' },
92
106
  'completion.unknown': { text: 'Unklar, ob der Beleg entstanden ist – die Antwort kam nicht an. Bitte nicht noch einmal abschließen: der Beleg kann bereits erstellt und signiert sein. Im Panel unter „Belege“ nachsehen; nur wenn er dort fehlt, den Verkauf erneut abschließen.' },
@@ -219,6 +233,27 @@ const MELDUNGEN_ROH = {
219
233
  'voucher_error.external_number_invalid': { text: 'Gutscheinnummer prüfen: 1 bis 40 Zeichen, nur Buchstaben, Ziffern und - _ . / sind erlaubt.' },
220
234
  'voucher_error.external_number_is_own_code': { text: 'Das ist ein eigener Gutscheincode. Bitte als eigenen Gutschein einlösen.' },
221
235
  'voucher_error.external_duplicate': { text: 'Diese Gutscheinnummer steht schon auf dem Beleg.' },
236
+ // Fremdgutscheine an der Kasse (1.31.0): Kachel gesperrt (Zuordnung in EXTERNAL_VOUCHER_TILE_MESSAGES), Hinweis im
237
+ // Storno eines Belegs mit fremdem Gutschein-Verkauf, Hilfe-Satz unter dem Schalter im Kundenbereich.
238
+ 'external_voucher.not_enabled': { text: 'Fremde Gutscheine sind aus. Bitte im Panel freischalten.' },
239
+ 'external_voucher.type_not_enabled': { text: 'Fremde Leistungsgutscheine sind aus. Bitte im Panel freischalten.' },
240
+ // Eingabe in der Form eines eigenen Codes, aber keiner (ownVoucherCodeShape `checksum`/`length`): nachfragen, nie abweisen.
241
+ 'external_voucher.looks_like_own_code': { text: 'Sieht aus wie ein Kasseneck-Code, ist aber keiner. Als fremden Gutschein verwenden?' },
242
+ 'cancellation.external_voucher_check': { text: 'Vorher im eigenen Gutscheinsystem prüfen, ob er schon benutzt wurde.' },
243
+ 'settings.external_vouchers_hint': { text: 'Ob ein Gutschein Wert- oder Leistungsgutschein ist und mit welchem Satz er verkauft wurde, legt der Betrieb fest. Das Guthaben führt sein eigenes System.' },
244
+ // Artikel als fremder Gutschein speichern (article_external_voucher_invalid, Zuordnung je data.grund in
245
+ // EXTERNAL_VOUCHER_ARTICLE_MESSAGES): Woerter wie fremdgutschein-artikel-core im Backend; `invalid` fuer
246
+ // invalid_type und einen unbekannten Grund (der Backend-Satz dazu ist technisch); invalid_rate mit deutschem
247
+ // Dezimalkomma statt der Liste aus STEUERSAETZE.join.
248
+ 'external_voucher_article.invalid': { text: 'Diese Art von fremdem Gutschein gibt es nicht.' },
249
+ 'external_voucher_article.service_voucher': { text: 'Ein fremder Gutschein kann kein Leistungsgutschein mit Code sein.' },
250
+ 'external_voucher_article.add_ons': { text: 'Ein fremder Gutschein hat keine Zusätze.' },
251
+ 'external_voucher_article.stock_tracked': { text: 'Ein fremder Gutschein führt keinen Lagerbestand.' },
252
+ 'external_voucher_article.reference': { text: 'Ein fremder Gutschein fragt keine Referenz ab, die Kasse fragt die Gutscheinnummer.' },
253
+ 'external_voucher_article.asks_quantity': { text: 'Ein fremder Gutschein fragt keine Menge ab.' },
254
+ 'external_voucher_article.rate_required': { text: 'Ein Einzweckgutschein braucht den Steuersatz, mit dem er verkauft wird.' },
255
+ 'external_voucher_article.invalid_rate': { text: 'Ein Einzweckgutschein braucht einen Steuersatz der Kasse: 20, 13, 10, 4,9, 0 oder 19 %.' },
256
+ 'external_voucher_article.price_required': { text: 'Ein fremder Gutschein braucht einen Preis oder „Betrag beim Antippen eingeben“.' },
222
257
  // Satz der Kasse selbst (1.17.0): eine Verkaufszeile im Korb passt nach dem Neuladen der Sorten nicht mehr (Sorte
223
258
  // geaendert, deaktiviert oder geloescht). Die Zeile sperrt das Kassieren, bis sie entfernt und neu gewaehlt ist;
224
259
  // der Satz nach einer Absage des Servers bleibt voucher_error.type_not_found bzw. voucher_error.amount_mismatch.
@@ -442,6 +477,16 @@ const MELDUNGEN_ROH = {
442
477
  'shift.finish_step_first': { text: 'Erst den Schritt rechts abschließen oder abbrechen.' },
443
478
  'tip.revenue_hint': { text: 'Steuerpflichtiges Trinkgeld zählt als Umsatz des Betriebs und wird nicht ausgezahlt.' },
444
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.' },
445
490
  };
446
491
  // Auf den gemeinsamen Typ gebracht: `Object.entries(MESSAGES)` liefert sonst
447
492
  // pro Schluessel den engsten Literaltyp, und `placeholders`/`only` waeren nur
@@ -674,6 +719,39 @@ export function cancellationErrorMessage(code) {
674
719
  const gutschein = CANCELLATION_VOUCHER_ERROR_MESSAGES;
675
720
  return (code !== undefined && code !== null && gutschein[code]) || cancellationPaymentErrorMessage(code);
676
721
  }
722
+ /**
723
+ * Fremdgutscheine an der Kasse (1.31.0): Satz zur gesperrten Kachel ([externalVoucherTileBlock]).
724
+ */
725
+ export const EXTERNAL_VOUCHER_TILE_MESSAGES = {
726
+ not_enabled: 'external_voucher.not_enabled',
727
+ type_not_enabled: 'external_voucher.type_not_enabled',
728
+ };
729
+ /**
730
+ * Artikel als fremder Gutschein: Satz je verletzter Regel (`data.grund` zu
731
+ * `article_external_voucher_invalid`, bzw. [checkExternalVoucherArticle] im Editor).
732
+ */
733
+ export const EXTERNAL_VOUCHER_ARTICLE_MESSAGES = {
734
+ invalid_type: 'external_voucher_article.invalid',
735
+ service_voucher: 'external_voucher_article.service_voucher',
736
+ add_ons: 'external_voucher_article.add_ons',
737
+ stock_tracked: 'external_voucher_article.stock_tracked',
738
+ reference: 'external_voucher_article.reference',
739
+ asks_quantity: 'external_voucher_article.asks_quantity',
740
+ rate_required: 'external_voucher_article.rate_required',
741
+ invalid_rate: 'external_voucher_article.invalid_rate',
742
+ price_required: 'external_voucher_article.price_required',
743
+ };
744
+ /**
745
+ * Der Satz zu einer Absage beim Speichern eines Artikels: nur fuer
746
+ * `article_external_voucher_invalid` (sonst `undefined`), je `grund`; ein
747
+ * unbekannter oder fehlender Grund (`reason` = `data.grund`) bekommt den allgemeinen Satz.
748
+ */
749
+ export function externalVoucherArticleErrorMessage(code, reason) {
750
+ if (code !== ARTICLE_EXTERNAL_VOUCHER_INVALID)
751
+ return undefined;
752
+ const saetze = EXTERNAL_VOUCHER_ARTICLE_MESSAGES;
753
+ return (typeof reason === 'string' && Object.prototype.hasOwnProperty.call(saetze, reason) ? saetze[reason] : undefined) ?? 'external_voucher_article.invalid';
754
+ }
677
755
  /**
678
756
  * Gutschein-Fehler (`/v3`): welcher `code` des Backends welchen Satz bekommt.
679
757
  * Wie RECEIPT_EMAIL_ERROR_MESSAGES: beide Kassen entscheiden am Code. Ein
@@ -712,6 +790,25 @@ export function voucherErrorMessage(code) {
712
790
  const fehler = VOUCHER_ERROR_MESSAGES;
713
791
  return code !== undefined && code !== null ? fehler[code] : undefined;
714
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
+ }
715
812
  /**
716
813
  * Beschriftungen: Knoepfe, Ueberschriften, Zeilennamen – was kein Satz ist.
717
814
  *
@@ -755,6 +852,24 @@ const BESCHRIFTUNGEN_ROH = {
755
852
  // Schalter beim Trinkgeld (nur Mitarbeiter-Trinkgeld, reine Barzahlung), vorbelegt aus der Einstellung.
756
853
  'checkout.tip_kept': { text: 'gleich behalten' },
757
854
  'tip.kept_setting': { text: 'Bar-Trinkgeld behält der Mitarbeiter gleich' },
855
+ // Stufe „Trinkgeld gleich behalten“ im Kundenbereich (business.tipKeptMode, Zuordnung TIP_KEPT_MODE_LABELS).
856
+ 'tip_kept_mode.title': { text: 'Trinkgeld gleich behalten' },
857
+ 'tip_kept_mode.always': { text: 'Immer gleich behalten' },
858
+ 'tip_kept_mode.never': { text: 'Immer offen lassen' },
859
+ 'tip_kept_mode.ask': { text: 'Jedes Mal fragen' },
860
+ // Editor „Rabatt-Vorlagen“ im Kundenbereich und in den Einstellungen der Kasse (business.discountPresets).
861
+ 'discount_presets.title': { text: 'Rabatt-Vorlagen' },
862
+ 'discount_presets.name': { text: 'Name' },
863
+ 'discount_presets.percent': { text: 'Prozent' },
864
+ 'discount_presets.amount': { text: 'Betrag' },
865
+ 'discount_presets.add': { text: 'Vorlage hinzufügen' },
866
+ 'discount_presets.remove': { text: 'Entfernen' },
867
+ 'discount_presets.limit': { text: 'Höchstens 5 Vorlagen.' },
868
+ // Block auf Z-Bon und Zwischenbericht (discountBlockLines): je Name „Name (n×)“, ab zwei Eintraegen die Summe.
869
+ 'shift_receipt.discounts': { text: 'Rabatte' },
870
+ 'shift_receipt.discounts_total': { text: 'Rabatte gesamt' },
871
+ 'shift_receipt.discount_line': { text: '{name} ({count}×)', placeholders: ['name', 'count'] },
872
+ 'shift_receipt.discount_unnamed': { text: 'Rabatt' },
758
873
  // Die Warte-Karte, solange der Betrag am Terminal steht; `{time}` ist der
759
874
  // Rest des Kartenfensters als m:ss.
760
875
  'card_payment.amount_on_terminal': { text: 'Betrag steht am Terminal' },
@@ -1073,6 +1188,25 @@ const BESCHRIFTUNGEN_ROH = {
1073
1188
  'addons.none': { text: 'Ohne Zusatz' },
1074
1189
  'addons.done': { text: 'Fertig' },
1075
1190
  'addons.open': { text: 'Zusätze' },
1191
+ // Fremdgutscheine an der Kasse (1.31.0): Kachel-Blatt („Gutscheinnummer“, Betrag = tile_prompt.amount), Blatt
1192
+ // „Fremder Gutschein“ beim Einlösen und Auszahlen (Betrag = voucher.amount, Grund = voucher.reason), Korbzeile,
1193
+ // Umschalter im Blatt „Gutschein auszahlen“; Schalter im Kundenbereich und Haken im Artikel-Editor.
1194
+ 'external_voucher.number': { text: 'Gutscheinnummer' },
1195
+ 'external_voucher.title': { text: 'Fremder Gutschein' },
1196
+ 'external_voucher.kind': { text: 'Art' },
1197
+ 'external_voucher.kind_value': { text: 'Wertgutschein' },
1198
+ 'external_voucher.kind_service': { text: 'Leistungsgutschein' },
1199
+ 'external_voucher.rate': { text: 'Satz' },
1200
+ 'external_voucher.taxed_with': { text: 'Versteuert mit (optional)' },
1201
+ 'external_voucher.line_name': { text: 'Gutschein Nr. {number}', placeholders: ['number'] },
1202
+ 'external_voucher.use_as_external': { text: 'Als fremden Gutschein' },
1203
+ 'voucher.payout_source_own': { text: 'Kasseneck-Gutschein' },
1204
+ 'voucher.payout_source_external': { text: 'Fremder Gutschein' },
1205
+ 'settings.external_vouchers': { text: 'Fremde Gutscheine' },
1206
+ 'settings.external_vouchers_off': { text: 'Aus' },
1207
+ 'settings.external_vouchers_multi_purpose': { text: 'Nur Wertgutscheine' },
1208
+ 'settings.external_vouchers_all': { text: 'Wert- und Leistungsgutscheine' },
1209
+ 'article.external_voucher': { text: 'Verkauft einen fremden Gutschein' },
1076
1210
  // Gutschein-Sorten als Kacheln im Reiter „Gutscheine“ (Stufe 4b, 1.17.0): Kachel je Sorte mit Betrag
1077
1211
  // oder „Betrag eingeben“, darunter klein die Art; dazu die feste Kachel „Leistungsgutschein“.
1078
1212
  'voucher.tab': { text: 'Gutscheine' },
@@ -1319,6 +1453,15 @@ const BESCHRIFTUNGEN_ROH = {
1319
1453
  'tip.summary_percent': { text: 'Trinkgeld {tip} ({percent} %)', placeholders: ['tip', 'percent'] },
1320
1454
  'settings.tip_kinds': { text: 'Trinkgeld-Arten' },
1321
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' },
1322
1465
  };
1323
1466
  export const LABELS = BESCHRIFTUNGEN_ROH;
1324
1467
  /**
@@ -1332,6 +1475,23 @@ export const RETURN_DISPOSITION_LABELS = {
1332
1475
  defective: 'stock.return_defective',
1333
1476
  disposed: 'stock.return_disposed',
1334
1477
  };
1478
+ /** Stufe „Trinkgeld gleich behalten“ (`business.tipKeptMode`) -> Beschriftung im Kundenbereich. */
1479
+ export const TIP_KEPT_MODE_LABELS = {
1480
+ ask: 'tip_kept_mode.ask',
1481
+ always: 'tip_kept_mode.always',
1482
+ never: 'tip_kept_mode.never',
1483
+ };
1484
+ /** Freigabe fuer Fremdgutscheine (`externalVouchers`) -> Beschriftung der Stufe im Kundenbereich. */
1485
+ export const EXTERNAL_VOUCHERS_LABELS = {
1486
+ off: 'settings.external_vouchers_off',
1487
+ multi_purpose: 'settings.external_vouchers_multi_purpose',
1488
+ all: 'settings.external_vouchers_all',
1489
+ };
1490
+ /** Art eines fremden Gutscheins (Artikel, Blatt) -> Beschriftung: Wert- bzw. Leistungsgutschein. */
1491
+ export const EXTERNAL_VOUCHER_KIND_LABELS = {
1492
+ multi_purpose: 'external_voucher.kind_value',
1493
+ single_purpose: 'external_voucher.kind_service',
1494
+ };
1335
1495
  /** Art einer Ausgabe -> Beschriftung (`receipt.output_<kind>`). */
1336
1496
  const AUSGABE_BESCHRIFTUNG = {
1337
1497
  print: 'receipt.output_print',
@@ -10,14 +10,14 @@ import type { ArticleGroup, PosArticle } from './artikel.js';
10
10
  /** Hoechstens so viele Zusaetze je Liste (der Server weist mehr ab). */
11
11
  export declare const ADD_ONS_MAX = 30;
12
12
  /** Warum ein Artikel kein Zusatz sein kann (Panel zeigt den Grund an). */
13
- export declare const ADD_ON_BLOCK_REASONS: readonly ["inactive", "own_list", "asks_price", "reference", "asks_quantity", "no_price", "service_voucher"];
13
+ export declare const ADD_ON_BLOCK_REASONS: readonly ["inactive", "own_list", "asks_price", "reference", "asks_quantity", "no_price", "service_voucher", "external_voucher"];
14
14
  export type AddOnBlockReason = typeof ADD_ON_BLOCK_REASONS[number];
15
- type ZusatzArtikel = Pick<PosArticle, 'id' | 'active' | 'unitPriceCents'> & Partial<Pick<PosArticle, 'addOns' | 'askPrice' | 'reference' | 'askQuantity' | 'serviceVoucher'>>;
15
+ type ZusatzArtikel = Pick<PosArticle, 'id' | 'active' | 'unitPriceCents'> & Partial<Pick<PosArticle, 'addOns' | 'askPrice' | 'reference' | 'askQuantity' | 'serviceVoucher' | 'externalVoucher'>>;
16
16
  type ArtikelNachId<T> = ReadonlyMap<string, T> | Readonly<Record<string, T>>;
17
17
  /**
18
18
  * Taugt der Artikel als Zusatz? `null` = ja. Im Fenster wird ohne Abfrage
19
19
  * gebucht: Betrag, Referenz oder Menge fragen geht nicht, ein Preis muss
20
- * feststehen (0 erlaubt), ein Leistungsgutschein liefe am Gutschein-Weg vorbei,
20
+ * feststehen (0 erlaubt), ein Leistungsgutschein oder fremder Gutschein liefe am Gutschein-Weg vorbei,
21
21
  * und ein Artikel mit eigener Liste oeffnete selbst ein Fenster (eine Ebene).
22
22
  */
23
23
  export declare function isSelectableAddOn(a: ZusatzArtikel): AddOnBlockReason | null;
@@ -9,12 +9,12 @@
9
9
  /** Hoechstens so viele Zusaetze je Liste (der Server weist mehr ab). */
10
10
  export const ADD_ONS_MAX = 30;
11
11
  /** Warum ein Artikel kein Zusatz sein kann (Panel zeigt den Grund an). */
12
- export const ADD_ON_BLOCK_REASONS = ['inactive', 'own_list', 'asks_price', 'reference', 'asks_quantity', 'no_price', 'service_voucher'];
12
+ export const ADD_ON_BLOCK_REASONS = ['inactive', 'own_list', 'asks_price', 'reference', 'asks_quantity', 'no_price', 'service_voucher', 'external_voucher'];
13
13
  const eigeneListe = (a) => Array.isArray(a.addOns) && a.addOns.length > 0;
14
14
  /**
15
15
  * Taugt der Artikel als Zusatz? `null` = ja. Im Fenster wird ohne Abfrage
16
16
  * gebucht: Betrag, Referenz oder Menge fragen geht nicht, ein Preis muss
17
- * feststehen (0 erlaubt), ein Leistungsgutschein liefe am Gutschein-Weg vorbei,
17
+ * feststehen (0 erlaubt), ein Leistungsgutschein oder fremder Gutschein liefe am Gutschein-Weg vorbei,
18
18
  * und ein Artikel mit eigener Liste oeffnete selbst ein Fenster (eine Ebene).
19
19
  */
20
20
  export function isSelectableAddOn(a) {
@@ -32,6 +32,8 @@ export function isSelectableAddOn(a) {
32
32
  return 'no_price';
33
33
  if (a.serviceVoucher === true)
34
34
  return 'service_voucher';
35
+ if (a.externalVoucher != null)
36
+ return 'external_voucher';
35
37
  return null;
36
38
  }
37
39
  function nachId(karte, id) {
@@ -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 });
@@ -2,6 +2,7 @@ import { KasseneckValidationError } from '../client/errors.js';
2
2
  import { labelText, LABELS } from '../pos/texte.js';
3
3
  import { bewegungsBon, schichtBon } from '../pos/schicht-lesen.js';
4
4
  import { shiftTipLines } from '../pos/schicht.js';
5
+ import { discountBlockLines } from '../pos/rabatt-vorlagen.js';
5
6
  import { parseServerTimeStamp, toViennaWallClock } from '../vienna-time.js';
6
7
  import { CURRENT_LAYOUT_RULESET, formatCents } from './layout.js';
7
8
  const PAPIER = ['mm58', 'mm80'];
@@ -187,6 +188,13 @@ export function shiftReceiptLayout(receipt, options = {}) {
187
188
  for (const u of bon.nonCashByMethod)
188
189
  zeilen.push(betrag(zahlartText(u.method), u.cents));
189
190
  }
191
+ // Gewaehrte Rabatte je Name: nur wenn es welche gab, sonst bleibt der Bon wie bisher.
192
+ const rabatte = discountBlockLines(bon.discounts);
193
+ if (rabatte.length > 0) {
194
+ zeilen.push(text(labelText('shift_receipt.discounts'), 'left', true));
195
+ for (const r of rabatte)
196
+ zeilen.push(betrag(r.label, r.cents));
197
+ }
190
198
  zeilen.push(anzahl(labelText('shift_receipt.receipts'), bon.receiptCount));
191
199
  zeilen.push(anzahl(labelText('shift_receipt.cancellations'), bon.cancellationCount));
192
200
  zeilen.push(anzahl(labelText('shift_receipt.openings_without_sale'), bon.openingsWithoutSale));