@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
@@ -22,17 +22,20 @@
22
22
  * `placeholders` und `structure`).
23
23
  */
24
24
  Object.defineProperty(exports, "__esModule", { value: true });
25
- exports.RETURN_DISPOSITION_LABELS = exports.LABELS = exports.VOUCHER_ERROR_MESSAGES = exports.CANCELLATION_VOUCHER_ERROR_MESSAGES = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = void 0;
25
+ exports.EXTERNAL_VOUCHER_KIND_LABELS = exports.EXTERNAL_VOUCHERS_LABELS = exports.TIP_KEPT_MODE_LABELS = exports.RETURN_DISPOSITION_LABELS = exports.LABELS = exports.DEPOSIT_ERROR_MESSAGES = exports.VOUCHER_ERROR_MESSAGES = exports.EXTERNAL_VOUCHER_ARTICLE_MESSAGES = exports.EXTERNAL_VOUCHER_TILE_MESSAGES = exports.CANCELLATION_VOUCHER_ERROR_MESSAGES = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = void 0;
26
26
  exports.findErrorRule = findErrorRule;
27
27
  exports.messageOutcome = messageOutcome;
28
28
  exports.receiptEmailErrorMessage = receiptEmailErrorMessage;
29
29
  exports.cancellationPaymentErrorMessage = cancellationPaymentErrorMessage;
30
30
  exports.cancellationErrorMessage = cancellationErrorMessage;
31
+ exports.externalVoucherArticleErrorMessage = externalVoucherArticleErrorMessage;
31
32
  exports.voucherErrorMessage = voucherErrorMessage;
33
+ exports.depositErrorMessage = depositErrorMessage;
32
34
  exports.receiptOutputLabel = receiptOutputLabel;
33
35
  exports.labelText = labelText;
34
36
  exports.messageText = messageText;
35
37
  exports.messageAppliesTo = messageAppliesTo;
38
+ const fremdgutschein_artikel_js_1 = require("./fremdgutschein-artikel.js");
36
39
  const errors_js_1 = require("../client/errors.js");
37
40
  const MELDUNGEN_ROH = {
38
41
  // --- Transport -----------------------------------------------------------
@@ -87,6 +90,16 @@ const MELDUNGEN_ROH = {
87
90
  'reference.format_invalid': { text: 'Das Format passt nicht.' },
88
91
  'reference.format_warning': { text: 'Das Format passt nicht. Trotzdem übernehmen?' },
89
92
  'discount.percent_invalid': { text: 'Bitte einen Prozentwert zwischen 0,1 und 100 eingeben.' },
93
+ // Rabatt-Vorlagen (benannte Rabatt-Chips, 1.31.0): Fehler der Pruefung (checkDiscountPresets) und der gesperrte Chip.
94
+ 'discount.preset_over_total': { text: 'Der Rabatt ist höher als der Betrag, auf den er gilt.' },
95
+ 'discount_preset.list': { text: 'Höchstens 5 Rabatt-Vorlagen als Liste.' },
96
+ 'discount_preset.entry': { text: 'Eine Rabatt-Vorlage ist ein Objekt mit Name, Art und Wert.' },
97
+ 'discount_preset.name': { text: 'Name mit 1 bis 24 Zeichen, ohne Steuerzeichen.' },
98
+ 'discount_preset.duplicate': { text: 'Diesen Namen gibt es schon.' },
99
+ 'discount_preset.kind': { text: 'Prozent oder Betrag.' },
100
+ 'discount_preset.percent': { text: 'Prozent zwischen 0,1 und 100 mit höchstens einer Nachkommastelle.' },
101
+ 'discount_preset.amount': { text: 'Betrag zwischen 0,01 € und 1.000.000,00 €.' },
102
+ 'discount_preset.unknown_field': { text: 'Unbekanntes Feld.' },
90
103
  // --- Kassieren -----------------------------------------------------------
91
104
  // Der Grund ueber dem Knopf, solange der Beleg nicht abgeschlossen werden kann.
92
105
  'checkout.nothing_entered': { text: 'Noch nichts erfasst – bitte zuerst eine Position aufnehmen.' },
@@ -100,6 +113,9 @@ const MELDUNGEN_ROH = {
100
113
  'tip.over_half': { text: 'Über 50 % Trinkgeld – wirklich? Steuerfrei ist nur ortsübliches Trinkgeld.' },
101
114
  // Bar-Trinkgeld „gleich behalten“ (Hinweis zur Einstellung, Beschriftungen unten).
102
115
  '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.' },
116
+ // Hinweis unter dem Trinkgeld beim Kassieren je nach Wahl (tipKeptFor): gleich behalten bzw. offen fuer den Benutzer.
117
+ 'tip.kept_hint': { text: 'Trinkgeld kommt als eigene Position auf den Beleg; der angemeldete Benutzer nimmt es gleich bar aus der Lade.' },
118
+ 'tip.open_hint': { text: 'Trinkgeld kommt als eigene Position auf den Beleg und bleibt für den angemeldeten Benutzer offen, bis es ausgezahlt wird.' },
103
119
  // --- Abschluss -----------------------------------------------------------
104
120
  'completion.failed': { text: 'Der Abschluss ist fehlgeschlagen.' },
105
121
  '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.' },
@@ -232,6 +248,27 @@ const MELDUNGEN_ROH = {
232
248
  'voucher_error.external_number_invalid': { text: 'Gutscheinnummer prüfen: 1 bis 40 Zeichen, nur Buchstaben, Ziffern und - _ . / sind erlaubt.' },
233
249
  'voucher_error.external_number_is_own_code': { text: 'Das ist ein eigener Gutscheincode. Bitte als eigenen Gutschein einlösen.' },
234
250
  'voucher_error.external_duplicate': { text: 'Diese Gutscheinnummer steht schon auf dem Beleg.' },
251
+ // Fremdgutscheine an der Kasse (1.31.0): Kachel gesperrt (Zuordnung in EXTERNAL_VOUCHER_TILE_MESSAGES), Hinweis im
252
+ // Storno eines Belegs mit fremdem Gutschein-Verkauf, Hilfe-Satz unter dem Schalter im Kundenbereich.
253
+ 'external_voucher.not_enabled': { text: 'Fremde Gutscheine sind aus. Bitte im Panel freischalten.' },
254
+ 'external_voucher.type_not_enabled': { text: 'Fremde Leistungsgutscheine sind aus. Bitte im Panel freischalten.' },
255
+ // Eingabe in der Form eines eigenen Codes, aber keiner (ownVoucherCodeShape `checksum`/`length`): nachfragen, nie abweisen.
256
+ 'external_voucher.looks_like_own_code': { text: 'Sieht aus wie ein Kasseneck-Code, ist aber keiner. Als fremden Gutschein verwenden?' },
257
+ 'cancellation.external_voucher_check': { text: 'Vorher im eigenen Gutscheinsystem prüfen, ob er schon benutzt wurde.' },
258
+ '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.' },
259
+ // Artikel als fremder Gutschein speichern (article_external_voucher_invalid, Zuordnung je data.grund in
260
+ // EXTERNAL_VOUCHER_ARTICLE_MESSAGES): Woerter wie fremdgutschein-artikel-core im Backend; `invalid` fuer
261
+ // invalid_type und einen unbekannten Grund (der Backend-Satz dazu ist technisch); invalid_rate mit deutschem
262
+ // Dezimalkomma statt der Liste aus STEUERSAETZE.join.
263
+ 'external_voucher_article.invalid': { text: 'Diese Art von fremdem Gutschein gibt es nicht.' },
264
+ 'external_voucher_article.service_voucher': { text: 'Ein fremder Gutschein kann kein Leistungsgutschein mit Code sein.' },
265
+ 'external_voucher_article.add_ons': { text: 'Ein fremder Gutschein hat keine Zusätze.' },
266
+ 'external_voucher_article.stock_tracked': { text: 'Ein fremder Gutschein führt keinen Lagerbestand.' },
267
+ 'external_voucher_article.reference': { text: 'Ein fremder Gutschein fragt keine Referenz ab, die Kasse fragt die Gutscheinnummer.' },
268
+ 'external_voucher_article.asks_quantity': { text: 'Ein fremder Gutschein fragt keine Menge ab.' },
269
+ 'external_voucher_article.rate_required': { text: 'Ein Einzweckgutschein braucht den Steuersatz, mit dem er verkauft wird.' },
270
+ 'external_voucher_article.invalid_rate': { text: 'Ein Einzweckgutschein braucht einen Steuersatz der Kasse: 20, 13, 10, 4,9, 0 oder 19 %.' },
271
+ 'external_voucher_article.price_required': { text: 'Ein fremder Gutschein braucht einen Preis oder „Betrag beim Antippen eingeben“.' },
235
272
  // Satz der Kasse selbst (1.17.0): eine Verkaufszeile im Korb passt nach dem Neuladen der Sorten nicht mehr (Sorte
236
273
  // geaendert, deaktiviert oder geloescht). Die Zeile sperrt das Kassieren, bis sie entfernt und neu gewaehlt ist;
237
274
  // der Satz nach einer Absage des Servers bleibt voucher_error.type_not_found bzw. voucher_error.amount_mismatch.
@@ -455,6 +492,16 @@ const MELDUNGEN_ROH = {
455
492
  'shift.finish_step_first': { text: 'Erst den Schritt rechts abschließen oder abbrechen.' },
456
493
  'tip.revenue_hint': { text: 'Steuerpflichtiges Trinkgeld zählt als Umsatz des Betriebs und wird nicht ausgezahlt.' },
457
494
  'tip.unassigned_hint': { text: 'Trinkgeld ohne angemeldeten Benutzer.' },
495
+ // --- Pfand und Leergut (1.32.0): Fehlersätze (Zuordnung in DEPOSIT_ERROR_MESSAGES) ---
496
+ 'deposit.changed': { text: 'Pfand wurde geändert. Bitte Summe prüfen.' },
497
+ 'deposit_error.not_enabled': { text: 'Pfand ist für diesen Betrieb nicht eingeschaltet.' },
498
+ 'deposit_error.type_not_found': { text: 'Diese Pfandart gibt es nicht mehr.' },
499
+ 'deposit_error.set_by_server': { text: 'Das Pfand bucht die Kasse selbst.' },
500
+ 'deposit_error.invalid_quantity': { text: 'Pfand gibt es nur für ganze Stück.' },
501
+ 'deposit_error.return_not_offered': { text: 'Diese Kasse nimmt kein Leergut zurück.' },
502
+ 'deposit_error.type_not_issued': { text: 'Dieses Leergut wurde hier nie verkauft.' },
503
+ 'deposit_error.follows_item': { text: 'Pfand wird mit seinem Artikel storniert.' },
504
+ 'deposit_error.invalid': { text: 'Die Pfand-Angaben stimmen nicht.' },
458
505
  };
459
506
  // Auf den gemeinsamen Typ gebracht: `Object.entries(MESSAGES)` liefert sonst
460
507
  // pro Schluessel den engsten Literaltyp, und `placeholders`/`only` waeren nur
@@ -687,6 +734,39 @@ function cancellationErrorMessage(code) {
687
734
  const gutschein = exports.CANCELLATION_VOUCHER_ERROR_MESSAGES;
688
735
  return (code !== undefined && code !== null && gutschein[code]) || cancellationPaymentErrorMessage(code);
689
736
  }
737
+ /**
738
+ * Fremdgutscheine an der Kasse (1.31.0): Satz zur gesperrten Kachel ([externalVoucherTileBlock]).
739
+ */
740
+ exports.EXTERNAL_VOUCHER_TILE_MESSAGES = {
741
+ not_enabled: 'external_voucher.not_enabled',
742
+ type_not_enabled: 'external_voucher.type_not_enabled',
743
+ };
744
+ /**
745
+ * Artikel als fremder Gutschein: Satz je verletzter Regel (`data.grund` zu
746
+ * `article_external_voucher_invalid`, bzw. [checkExternalVoucherArticle] im Editor).
747
+ */
748
+ exports.EXTERNAL_VOUCHER_ARTICLE_MESSAGES = {
749
+ invalid_type: 'external_voucher_article.invalid',
750
+ service_voucher: 'external_voucher_article.service_voucher',
751
+ add_ons: 'external_voucher_article.add_ons',
752
+ stock_tracked: 'external_voucher_article.stock_tracked',
753
+ reference: 'external_voucher_article.reference',
754
+ asks_quantity: 'external_voucher_article.asks_quantity',
755
+ rate_required: 'external_voucher_article.rate_required',
756
+ invalid_rate: 'external_voucher_article.invalid_rate',
757
+ price_required: 'external_voucher_article.price_required',
758
+ };
759
+ /**
760
+ * Der Satz zu einer Absage beim Speichern eines Artikels: nur fuer
761
+ * `article_external_voucher_invalid` (sonst `undefined`), je `grund`; ein
762
+ * unbekannter oder fehlender Grund (`reason` = `data.grund`) bekommt den allgemeinen Satz.
763
+ */
764
+ function externalVoucherArticleErrorMessage(code, reason) {
765
+ if (code !== fremdgutschein_artikel_js_1.ARTICLE_EXTERNAL_VOUCHER_INVALID)
766
+ return undefined;
767
+ const saetze = exports.EXTERNAL_VOUCHER_ARTICLE_MESSAGES;
768
+ return (typeof reason === 'string' && Object.prototype.hasOwnProperty.call(saetze, reason) ? saetze[reason] : undefined) ?? 'external_voucher_article.invalid';
769
+ }
690
770
  /**
691
771
  * Gutschein-Fehler (`/v3`): welcher `code` des Backends welchen Satz bekommt.
692
772
  * Wie RECEIPT_EMAIL_ERROR_MESSAGES: beide Kassen entscheiden am Code. Ein
@@ -725,6 +805,25 @@ function voucherErrorMessage(code) {
725
805
  const fehler = exports.VOUCHER_ERROR_MESSAGES;
726
806
  return code !== undefined && code !== null ? fehler[code] : undefined;
727
807
  }
808
+ /**
809
+ * Pfand-Fehler (`/v3`, createReceipt und cancelReceipt): welcher `code` des
810
+ * Backends welchen Satz bekommt. Kassensprache, keine Rechtssprache.
811
+ */
812
+ exports.DEPOSIT_ERROR_MESSAGES = {
813
+ deposit_not_enabled: 'deposit_error.not_enabled',
814
+ deposit_type_not_found: 'deposit_error.type_not_found',
815
+ deposit_set_by_server: 'deposit_error.set_by_server',
816
+ invalid_deposit_quantity: 'deposit_error.invalid_quantity',
817
+ deposit_return_not_offered: 'deposit_error.return_not_offered',
818
+ deposit_type_not_issued: 'deposit_error.type_not_issued',
819
+ deposit_follows_item: 'deposit_error.follows_item',
820
+ invalid_deposit: 'deposit_error.invalid',
821
+ };
822
+ /** Der Satz zu einem Pfand-`code`; `undefined` für jeden anderen Code. */
823
+ function depositErrorMessage(code) {
824
+ const fehler = exports.DEPOSIT_ERROR_MESSAGES;
825
+ return code !== undefined && code !== null && Object.prototype.hasOwnProperty.call(fehler, code) ? fehler[code] : undefined;
826
+ }
728
827
  /**
729
828
  * Beschriftungen: Knoepfe, Ueberschriften, Zeilennamen – was kein Satz ist.
730
829
  *
@@ -768,6 +867,24 @@ const BESCHRIFTUNGEN_ROH = {
768
867
  // Schalter beim Trinkgeld (nur Mitarbeiter-Trinkgeld, reine Barzahlung), vorbelegt aus der Einstellung.
769
868
  'checkout.tip_kept': { text: 'gleich behalten' },
770
869
  'tip.kept_setting': { text: 'Bar-Trinkgeld behält der Mitarbeiter gleich' },
870
+ // Stufe „Trinkgeld gleich behalten“ im Kundenbereich (business.tipKeptMode, Zuordnung TIP_KEPT_MODE_LABELS).
871
+ 'tip_kept_mode.title': { text: 'Trinkgeld gleich behalten' },
872
+ 'tip_kept_mode.always': { text: 'Immer gleich behalten' },
873
+ 'tip_kept_mode.never': { text: 'Immer offen lassen' },
874
+ 'tip_kept_mode.ask': { text: 'Jedes Mal fragen' },
875
+ // Editor „Rabatt-Vorlagen“ im Kundenbereich und in den Einstellungen der Kasse (business.discountPresets).
876
+ 'discount_presets.title': { text: 'Rabatt-Vorlagen' },
877
+ 'discount_presets.name': { text: 'Name' },
878
+ 'discount_presets.percent': { text: 'Prozent' },
879
+ 'discount_presets.amount': { text: 'Betrag' },
880
+ 'discount_presets.add': { text: 'Vorlage hinzufügen' },
881
+ 'discount_presets.remove': { text: 'Entfernen' },
882
+ 'discount_presets.limit': { text: 'Höchstens 5 Vorlagen.' },
883
+ // Block auf Z-Bon und Zwischenbericht (discountBlockLines): je Name „Name (n×)“, ab zwei Eintraegen die Summe.
884
+ 'shift_receipt.discounts': { text: 'Rabatte' },
885
+ 'shift_receipt.discounts_total': { text: 'Rabatte gesamt' },
886
+ 'shift_receipt.discount_line': { text: '{name} ({count}×)', placeholders: ['name', 'count'] },
887
+ 'shift_receipt.discount_unnamed': { text: 'Rabatt' },
771
888
  // Die Warte-Karte, solange der Betrag am Terminal steht; `{time}` ist der
772
889
  // Rest des Kartenfensters als m:ss.
773
890
  'card_payment.amount_on_terminal': { text: 'Betrag steht am Terminal' },
@@ -1086,6 +1203,25 @@ const BESCHRIFTUNGEN_ROH = {
1086
1203
  'addons.none': { text: 'Ohne Zusatz' },
1087
1204
  'addons.done': { text: 'Fertig' },
1088
1205
  'addons.open': { text: 'Zusätze' },
1206
+ // Fremdgutscheine an der Kasse (1.31.0): Kachel-Blatt („Gutscheinnummer“, Betrag = tile_prompt.amount), Blatt
1207
+ // „Fremder Gutschein“ beim Einlösen und Auszahlen (Betrag = voucher.amount, Grund = voucher.reason), Korbzeile,
1208
+ // Umschalter im Blatt „Gutschein auszahlen“; Schalter im Kundenbereich und Haken im Artikel-Editor.
1209
+ 'external_voucher.number': { text: 'Gutscheinnummer' },
1210
+ 'external_voucher.title': { text: 'Fremder Gutschein' },
1211
+ 'external_voucher.kind': { text: 'Art' },
1212
+ 'external_voucher.kind_value': { text: 'Wertgutschein' },
1213
+ 'external_voucher.kind_service': { text: 'Leistungsgutschein' },
1214
+ 'external_voucher.rate': { text: 'Satz' },
1215
+ 'external_voucher.taxed_with': { text: 'Versteuert mit (optional)' },
1216
+ 'external_voucher.line_name': { text: 'Gutschein Nr. {number}', placeholders: ['number'] },
1217
+ 'external_voucher.use_as_external': { text: 'Als fremden Gutschein' },
1218
+ 'voucher.payout_source_own': { text: 'Kasseneck-Gutschein' },
1219
+ 'voucher.payout_source_external': { text: 'Fremder Gutschein' },
1220
+ 'settings.external_vouchers': { text: 'Fremde Gutscheine' },
1221
+ 'settings.external_vouchers_off': { text: 'Aus' },
1222
+ 'settings.external_vouchers_multi_purpose': { text: 'Nur Wertgutscheine' },
1223
+ 'settings.external_vouchers_all': { text: 'Wert- und Leistungsgutscheine' },
1224
+ 'article.external_voucher': { text: 'Verkauft einen fremden Gutschein' },
1089
1225
  // Gutschein-Sorten als Kacheln im Reiter „Gutscheine“ (Stufe 4b, 1.17.0): Kachel je Sorte mit Betrag
1090
1226
  // oder „Betrag eingeben“, darunter klein die Art; dazu die feste Kachel „Leistungsgutschein“.
1091
1227
  'voucher.tab': { text: 'Gutscheine' },
@@ -1332,6 +1468,15 @@ const BESCHRIFTUNGEN_ROH = {
1332
1468
  'tip.summary_percent': { text: 'Trinkgeld {tip} ({percent} %)', placeholders: ['tip', 'percent'] },
1333
1469
  'settings.tip_kinds': { text: 'Trinkgeld-Arten' },
1334
1470
  'settings.tip_start': { text: 'Zuerst offen' },
1471
+ // --- Pfand und Leergut (1.32.0) ---
1472
+ 'deposit.return': { text: 'Leergut' },
1473
+ 'deposit.payout': { text: 'Bar auszahlen' },
1474
+ 'deposit.offset': { text: 'Mit Einkauf verrechnen' },
1475
+ 'deposit.unknown_code': { text: 'Welches Leergut ist das?' },
1476
+ 'deposit.over_usual': { text: 'Mehr als üblich – trotzdem annehmen?' },
1477
+ 'deposit.on_premises': { text: 'Vor Ort' },
1478
+ 'deposit.takeaway': { text: 'Mitnahme' },
1479
+ 'deposit.sum': { text: 'Summe Leergut' },
1335
1480
  };
1336
1481
  exports.LABELS = BESCHRIFTUNGEN_ROH;
1337
1482
  /**
@@ -1345,6 +1490,23 @@ exports.RETURN_DISPOSITION_LABELS = {
1345
1490
  defective: 'stock.return_defective',
1346
1491
  disposed: 'stock.return_disposed',
1347
1492
  };
1493
+ /** Stufe „Trinkgeld gleich behalten“ (`business.tipKeptMode`) -> Beschriftung im Kundenbereich. */
1494
+ exports.TIP_KEPT_MODE_LABELS = {
1495
+ ask: 'tip_kept_mode.ask',
1496
+ always: 'tip_kept_mode.always',
1497
+ never: 'tip_kept_mode.never',
1498
+ };
1499
+ /** Freigabe fuer Fremdgutscheine (`externalVouchers`) -> Beschriftung der Stufe im Kundenbereich. */
1500
+ exports.EXTERNAL_VOUCHERS_LABELS = {
1501
+ off: 'settings.external_vouchers_off',
1502
+ multi_purpose: 'settings.external_vouchers_multi_purpose',
1503
+ all: 'settings.external_vouchers_all',
1504
+ };
1505
+ /** Art eines fremden Gutscheins (Artikel, Blatt) -> Beschriftung: Wert- bzw. Leistungsgutschein. */
1506
+ exports.EXTERNAL_VOUCHER_KIND_LABELS = {
1507
+ multi_purpose: 'external_voucher.kind_value',
1508
+ single_purpose: 'external_voucher.kind_service',
1509
+ };
1348
1510
  /** Art einer Ausgabe -> Beschriftung (`receipt.output_<kind>`). */
1349
1511
  const AUSGABE_BESCHRIFTUNG = {
1350
1512
  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;
@@ -20,12 +20,12 @@ exports.orderAddOnLines = orderAddOnLines;
20
20
  /** Hoechstens so viele Zusaetze je Liste (der Server weist mehr ab). */
21
21
  exports.ADD_ONS_MAX = 30;
22
22
  /** Warum ein Artikel kein Zusatz sein kann (Panel zeigt den Grund an). */
23
- exports.ADD_ON_BLOCK_REASONS = ['inactive', 'own_list', 'asks_price', 'reference', 'asks_quantity', 'no_price', 'service_voucher'];
23
+ exports.ADD_ON_BLOCK_REASONS = ['inactive', 'own_list', 'asks_price', 'reference', 'asks_quantity', 'no_price', 'service_voucher', 'external_voucher'];
24
24
  const eigeneListe = (a) => Array.isArray(a.addOns) && a.addOns.length > 0;
25
25
  /**
26
26
  * Taugt der Artikel als Zusatz? `null` = ja. Im Fenster wird ohne Abfrage
27
27
  * gebucht: Betrag, Referenz oder Menge fragen geht nicht, ein Preis muss
28
- * feststehen (0 erlaubt), ein Leistungsgutschein liefe am Gutschein-Weg vorbei,
28
+ * feststehen (0 erlaubt), ein Leistungsgutschein oder fremder Gutschein liefe am Gutschein-Weg vorbei,
29
29
  * und ein Artikel mit eigener Liste oeffnete selbst ein Fenster (eine Ebene).
30
30
  */
31
31
  function isSelectableAddOn(a) {
@@ -43,6 +43,8 @@ function isSelectableAddOn(a) {
43
43
  return 'no_price';
44
44
  if (a.serviceVoucher === true)
45
45
  return 'service_voucher';
46
+ if (a.externalVoucher != null)
47
+ return 'external_voucher';
46
48
  return null;
47
49
  }
48
50
  function nachId(karte, id) {
@@ -21,6 +21,9 @@ function distributeDiscount(items, discountCents, name = 'Rabatt') {
21
21
  // Umsatz je Steuersatz (nur positive Positionen -- Rabatte/Stornos zaehlen nicht mit)
22
22
  const gruppen = new Map();
23
23
  for (const p of items) {
24
+ // Pfand und Leergut werden nie rabattiert (durchlaufend, Spec E17).
25
+ if ((0, receipt_item_js_1.isDepositItem)(p) || (0, receipt_item_js_1.isDepositReturnItem)(p))
26
+ continue;
24
27
  const betrag = (0, receipt_item_js_1.receiptItemTotalCents)(p);
25
28
  if (betrag <= 0)
26
29
  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;
@@ -109,15 +109,20 @@ function rechne(items, vouchers, receiptType, options) {
109
109
  const fluss = wertgutscheinFlussCents(gutscheine, art);
110
110
  const dueCents = t.zaehlerDeltaCents + fluss;
111
111
  // Ohne Auszahlungen darf der Zahlbetrag nicht negativ werden (Einloesung hoeher als die Summe).
112
- if (plan.mitPlan && dueCents + plan.auszahlungCents < 0) {
112
+ // Leergut ist nie deckbar und darf als Barauszahlung hinausgehen: es zaehlt in diesen Pruefungen nicht mit.
113
+ const leergut = (0, gutschein_plan_js_1.leergutCents)(kunde);
114
+ const nachGutscheinen = dueCents + plan.auszahlungCents - leergut;
115
+ if (plan.mitPlan && nachGutscheinen < 0) {
113
116
  throw new ReceiptDueError('invalid_voucher', 'die Gutscheine uebersteigen die Summe des Belegs.', 'voucher_exceeds_total');
114
117
  }
115
118
  // Ein Gutschein deckt nie das Trinkgeld (Personal wie Inhaber): der Zahlbetrag nach den Gutscheinen
116
119
  // muss die Trinkgeldzeilen tragen. Storno ausgenommen (dort gibt es keinen Plan).
117
120
  const trinkgeld = (0, gutschein_plan_js_1.trinkgeldCents)(kunde);
118
- if (plan.mitPlan && art !== 'cancellation' && trinkgeld > 0 && dueCents + plan.auszahlungCents < trinkgeld) {
121
+ if (plan.mitPlan && art !== 'cancellation' && trinkgeld > 0 && nachGutscheinen < trinkgeld) {
119
122
  throw new ReceiptDueError('invalid_voucher', 'die Gutscheine decken das Trinkgeld.', 'voucher_exceeds_total');
120
123
  }
124
+ // pfand-core.istLeergutAuszahlung: negativer Zahlbetrag eines Verkaufs mit Leergut, hoechstens die Leergutsumme.
125
+ const leergutAuszahlung = art !== 'cancellation' && leergut < 0 && dueCents < 0 && dueCents >= leergut;
121
126
  return {
122
127
  ergebnis: {
123
128
  dueCents,
@@ -131,6 +136,7 @@ function rechne(items, vouchers, receiptType, options) {
131
136
  amountRateSpecial: euroToCent(t.amountRateSpecial),
132
137
  amountRatOthers: euroToCent(t.amountRatOthers),
133
138
  },
139
+ ...(leergutAuszahlung ? { payout: 'deposit' } : {}),
134
140
  },
135
141
  kunde,
136
142
  minusJeTopf: plan.minusJeTopf,
@@ -430,10 +436,14 @@ const FUENF = ['amountRateStandard', 'amountRateReduced1', 'amountRateReduced2',
430
436
  /** `beleg-toepfe.belegToepfe`, Schritt fuer Schritt. */
431
437
  function belegToepfe(positionen, gutscheine) {
432
438
  const t = { amountRateStandard: 0, amountRateReduced1: 0, amountRateReduced2: 0, amountRateZero: 0, amountRateSpecial: 0, amountRatOthers: 0 };
433
- let personal = 0;
439
+ // Durchlaufende Posten (beleg-toepfe.durchlaufUndRest): Personal-Trinkgeld im 0-%-Topf, Pfand und Leergut im Topf ihres
440
+ // Satzes (Einweg hat 0 %, also Null). Sie liegen ungekuerzt im Topf, nach dem Rabatt, und zaehlen nicht in dessen Deckel.
441
+ const durchlauf = { amountRateStandard: 0, amountRateReduced1: 0, amountRateReduced2: 0, amountRateZero: 0, amountRateSpecial: 0, amountRatOthers: 0 };
434
442
  for (const p of positionen) {
435
443
  if (p.tip === 'staff')
436
- personal += p.amount * p.priceOne;
444
+ durchlauf.amountRateZero += p.amount * p.priceOne;
445
+ else if ((0, gutschein_plan_js_1.istPfandZeile)(p))
446
+ durchlauf[(0, gutschein_plan_js_1.topfFuerSatz)(p.vat)] += p.amount * p.priceOne;
437
447
  else
438
448
  t[(0, gutschein_plan_js_1.topfFuerSatz)(p.vat)] += p.priceOne * p.amount;
439
449
  }
@@ -466,7 +476,8 @@ function belegToepfe(positionen, gutscheine) {
466
476
  t[n] = (cents[i] - anteil[i]) / 100;
467
477
  });
468
478
  }
469
- t.amountRateZero += personal;
479
+ for (const n of [...FUENF, 'amountRatOthers'])
480
+ t[n] += durchlauf[n];
470
481
  const zaehlerDeltaCents = euroToCent(t.amountRateStandard) + euroToCent(t.amountRateReduced1) + euroToCent(t.amountRateReduced2) +
471
482
  euroToCent(t.amountRateZero) + euroToCent(t.amountRateSpecial) + euroToCent(t.amountRatOthers);
472
483
  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. */
@@ -2,7 +2,9 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.VOUCHER_ZERO_RATE_BUCKET_FROM = void 0;
4
4
  exports.topfFuerSatz = topfFuerSatz;
5
+ exports.istPfandZeile = istPfandZeile;
5
6
  exports.istDeckbar = istDeckbar;
7
+ exports.leergutCents = leergutCents;
6
8
  exports.trinkgeldCents = trinkgeldCents;
7
9
  exports.centSumme = centSumme;
8
10
  exports.kuSaetze = kuSaetze;
@@ -34,9 +36,21 @@ const TOPF_REIHENFOLGE = ['amountRateStandard', 'amountRateReduced1', 'amountRat
34
36
  function istGutscheinZeile(p) {
35
37
  return p.kind !== undefined && KINDS.includes(p.kind);
36
38
  }
37
- /** Position, die ein Gutschein decken darf: weder Trinkgeld noch Gutscheinzeile. */
39
+ /** Pfand- oder Leergutzeile: durchlaufend wie das Trinkgeld, nie rabattiert, nie von einem Gutschein gedeckt. */
40
+ function istPfandZeile(p) {
41
+ return p.kind === 'deposit' || p.kind === 'deposit_return';
42
+ }
43
+ /** Position, die ein Gutschein decken darf: weder Trinkgeld noch Gutscheinzeile noch Pfand oder Leergut (E18). */
38
44
  function istDeckbar(p) {
39
- return p.tip == null && p.kind !== 'tip' && !istGutscheinZeile(p);
45
+ return p.tip == null && p.kind !== 'tip' && !istGutscheinZeile(p) && !istPfandZeile(p);
46
+ }
47
+ /** Summe der Leergutzeilen in Cent (<= 0), wie `pfand-core.leergutCents`: Menge x Einzelpreis, auf Cent gerundet. */
48
+ function leergutCents(positionen) {
49
+ let summe = 0;
50
+ for (const p of positionen)
51
+ if (p.kind === 'deposit_return')
52
+ summe += Math.round(p.amount * Math.round(p.priceOne * 100));
53
+ return summe;
40
54
  }
41
55
  /** Summe der Trinkgeldzeilen (Personal und Inhaber) in Cent, wie `centSumme(kunde.filter(istTip))` im Backend. */
42
56
  function trinkgeldCents(kunde) {
@@ -454,6 +454,20 @@ function barZeilen(zahlung) {
454
454
  */
455
455
  function zahlungsZeilen(receipt) {
456
456
  const zahlungen = receipt.payments;
457
+ // Reiner Leergutbeleg: die negative Barzahlung ist eine Auszahlung an den Kunden.
458
+ if (istReinerLeergutBeleg(receipt)) {
459
+ const bar = zahlungen != null && zahlungen.length > 0
460
+ ? zahlungen.filter((z) => BAR_ZAHLARTEN.includes(zahlartSchluessel(z.method)) && z.amountCents < 0)
461
+ : [];
462
+ if (zahlungen == null || zahlungen.length === 0) {
463
+ if (BAR_ZAHLARTEN.includes(zahlartSchluessel(receipt.paymentMethod)) && (0, index_js_2.receiptSumCents)(receipt) < 0) {
464
+ return [paarZeile(LEERGUT_AUSZAHLUNG, `${formatCents((0, index_js_2.receiptSumCents)(receipt))} €`, 8, 4)];
465
+ }
466
+ }
467
+ else if (bar.length === zahlungen.length) {
468
+ return bar.map((z) => paarZeile(LEERGUT_AUSZAHLUNG, `${formatCents(z.amountCents)} €`, 8, 4));
469
+ }
470
+ }
457
471
  // Trägt der Beleg eine Gutschein-Zahlungszeile, entfällt, was 0 Cent kostet
458
472
  // (§ 132a Abs. 3 BAO: die Zahlungsart ist kein Pflichtinhalt, der Betrag bleibt).
459
473
  const mitGutschein = receipt.vouchers.some((v) => v.action === index_js_1.VoucherAction.redeem && v.type !== index_js_1.VoucherType.promo);
@@ -879,6 +893,79 @@ function positionsZeile(item, satz, zusatz = false) {
879
893
  ],
880
894
  };
881
895
  }
896
+ // ------------------------------------------------------------ Pfand & Leergut
897
+ /** Ueberschrift eines reinen Leergutbelegs (nur Leergut-Positionen). */
898
+ const LEERGUT_UEBERSCHRIFT = 'Leergut-Rückgabe';
899
+ /** Zahlungszeile eines reinen Leergutbelegs: das Pfand geht bar zurueck an den Kunden. */
900
+ const LEERGUT_AUSZAHLUNG = 'Bar ausgezahlt';
901
+ /** Zusatz an der 0-%-Zeile, wenn Einwegpfand darauf liegt (kein Entgelt, nicht steuerbar). */
902
+ const PFAND_NICHT_STEUERBAR = 'Pfand, nicht steuerbar';
903
+ /** Vorsatz der Fusszeile mit der gemeinsamen Ruecknahmestelle. */
904
+ const LEERGUT_STELLE_VORSATZ = 'Leergut-Rückgabe: ';
905
+ /** Reiner Leergutbeleg: mindestens eine Leergut-Position, sonst nur Trinkgeld/Rabatt-freie Leergutzeilen. */
906
+ function istReinerLeergutBeleg(receipt) {
907
+ return receipt.items.length > 0 && receipt.items.some(index_js_2.isDepositReturnItem) && receipt.items.every(index_js_2.isDepositReturnItem);
908
+ }
909
+ /**
910
+ * Pfandzeilen, die unter ihrer Warenposition stehen (`depositFor` zeigt auf eine Ware, nicht auf Trinkgeld,
911
+ * Rabatt, Pfand oder Leergut und nicht auf sich selbst). Alle anderen Pfandzeilen bleiben an ihrem Platz.
912
+ */
913
+ function pfandZuPosition(items) {
914
+ const zu = new Map();
915
+ items.forEach((it, i) => {
916
+ if (!(0, index_js_2.isDepositItem)(it))
917
+ return;
918
+ const ziel = it.depositFor;
919
+ if (typeof ziel !== 'number' || !Number.isInteger(ziel) || ziel < 0 || ziel >= items.length || ziel === i)
920
+ return;
921
+ const hauptzeile = items[ziel];
922
+ if ((0, index_js_2.isTipItem)(hauptzeile) || (0, index_js_2.isDiscountItem)(hauptzeile) || (0, index_js_2.isDepositItem)(hauptzeile) || (0, index_js_2.isDepositReturnItem)(hauptzeile))
923
+ return;
924
+ zu.set(ziel, [...(zu.get(ziel) ?? []), i]);
925
+ });
926
+ return zu;
927
+ }
928
+ /**
929
+ * Bon-Reihenfolge mit Pfand: Hauptposition, ihre Zusaetze (je mit eigener Pfandzeile direkt darunter), dann die
930
+ * Pfandzeile der Hauptposition. Ohne Pfandverweise bleibt `reihe` unveraendert.
931
+ */
932
+ function mitPfandReihenfolge(items, reihe, zu) {
933
+ if (zu.size === 0)
934
+ return reihe;
935
+ const gebunden = new Set();
936
+ for (const liste of zu.values())
937
+ for (const i of liste)
938
+ gebunden.add(i);
939
+ const raus = [];
940
+ let offen = [];
941
+ for (const i of reihe) {
942
+ if (gebunden.has(i))
943
+ continue;
944
+ if ((0, zusaetze_js_1.istGueltigerZusatz)(items, i)) {
945
+ raus.push(i, ...(zu.get(i) ?? []));
946
+ continue;
947
+ }
948
+ raus.push(...offen);
949
+ raus.push(i);
950
+ offen = zu.get(i) ?? [];
951
+ }
952
+ raus.push(...offen);
953
+ return raus;
954
+ }
955
+ /** Einwegpfand und -leergut auf dem 0-%-Satz in Cent (Pfandzeilen minus Leergut); `null`, wenn keins darauf liegt. */
956
+ function einwegPfandCents(receipt) {
957
+ let summe = 0;
958
+ let gefunden = false;
959
+ for (const it of receipt.items) {
960
+ if (!((0, index_js_2.isDepositItem)(it) || (0, index_js_2.isDepositReturnItem)(it)) || it.depositKind !== 'single_use')
961
+ continue;
962
+ if (steuersatz(it.vat).rate !== 0)
963
+ continue;
964
+ summe += (0, index_js_2.receiptItemTotalCents)(it);
965
+ gefunden = true;
966
+ }
967
+ return gefunden ? summe : null;
968
+ }
882
969
  // ---------------------------------------------------------------- Belegart
883
970
  const TESTKASSE_TEXT = 'TESTKASSE — kein gültiger Beleg';
884
971
  const TESTSIGNATUR_TEXT = 'TESTSIGNATUR — kein gültiger Beleg';
@@ -1056,6 +1143,9 @@ function belegartBlock(receipt) {
1056
1143
  for (const z of TRAINING_ERKLAERUNG)
1057
1144
  aus.push(textZeile(z, 'center'));
1058
1145
  }
1146
+ else if (istReinerLeergutBeleg(receipt)) {
1147
+ aus.push(textZeile(LEERGUT_UEBERSCHRIFT, 'center', true));
1148
+ }
1059
1149
  else if (t === 'start') {
1060
1150
  aus.push(bannerZeile('STARTBELEG'));
1061
1151
  aus.push(textZeile('Nullbeleg zur Inbetriebnahme', 'center'));
@@ -1200,7 +1290,12 @@ function buildReceiptLayout(receipt, company, options = {}) {
1200
1290
  const gutscheinZuordnung = gutscheinPositionen(receipt);
1201
1291
  // Zusatz-Kacheln: Zusaetze direkt unter ihrer Hauptposition (stabil); ohne
1202
1292
  // Verweise ist die Reihenfolge die des Belegs (byte-gleich).
1203
- const reihe = (0, zusaetze_js_1.addOnDisplayOrder)(receipt.items);
1293
+ const pfandZu = pfandZuPosition(receipt.items);
1294
+ const gebundenesPfand = new Set();
1295
+ for (const liste of pfandZu.values())
1296
+ for (const k of liste)
1297
+ gebundenesPfand.add(k);
1298
+ const reihe = mitPfandReihenfolge(receipt.items, (0, zusaetze_js_1.addOnDisplayOrder)(receipt.items), pfandZu);
1204
1299
  const an = (k) => receipt.items[reihe[k]];
1205
1300
  let i = 0;
1206
1301
  while (i < reihe.length) {
@@ -1209,7 +1304,7 @@ function buildReceiptLayout(receipt, company, options = {}) {
1209
1304
  const satz = steuersatz(item.vat);
1210
1305
  gruppeVon(satz).bruttoCents += (0, index_js_2.receiptItemTotalCents)(item);
1211
1306
  const gutschein = gutscheinZuordnung.get(reihe[i]);
1212
- lines.push(...(gutschein ? gutscheinPositionsZeilen(item, satz, gutschein) : [positionsZeile(item, satz, (0, zusaetze_js_1.istGueltigerZusatz)(receipt.items, reihe[i]))]));
1307
+ lines.push(...(gutschein ? gutscheinPositionsZeilen(item, satz, gutschein) : [positionsZeile(item, satz, (0, zusaetze_js_1.istGueltigerZusatz)(receipt.items, reihe[i]) || gebundenesPfand.has(reihe[i]))]));
1213
1308
  i += 1;
1214
1309
  continue;
1215
1310
  }
@@ -1305,6 +1400,10 @@ function buildReceiptLayout(receipt, company, options = {}) {
1305
1400
  formatCents(bruttoCents),
1306
1401
  ], paperSize));
1307
1402
  }
1403
+ // Einwegpfand liegt auf dem 0-%-Satz, ist aber kein Entgelt: die Zeile sagt es dem Leser der Tabelle.
1404
+ const einwegCents = einwegPfandCents(receipt);
1405
+ if (einwegCents !== null)
1406
+ lines.push(paarZeile(PFAND_NICHT_STEUERBAR, formatCents(einwegCents), 9, 3));
1308
1407
  // Mitarbeiter-Trinkgeld ist als Null-%-Umsatz erfasst (Erlass 2.4.2.1), aber
1309
1408
  // kein Umsatz des Betriebs — die Klarstellung steht direkt unter der
1310
1409
  // 0-%-Zeile, damit der Beleg (auch als Rechnung) nicht nach steuerfreiem
@@ -1393,6 +1492,13 @@ function buildReceiptLayout(receipt, company, options = {}) {
1393
1492
  lines.push(textZeile(fuss, 'center'));
1394
1493
  }
1395
1494
  }
1495
+ // Gemeinsame Ruecknahmestelle fuer Leergut (nur, wenn der Server sie gestempelt hat).
1496
+ const stelle = receipt.sharedReturnPoint;
1497
+ if (stelle != null) {
1498
+ const angabe = [stelle.name, stelle.address].filter((t) => t !== '').join(', ');
1499
+ if (angabe !== '')
1500
+ lines.push(textZeile(`${LEERGUT_STELLE_VORSATZ}${angabe}`, 'center'));
1501
+ }
1396
1502
  // --- Warnrahmen unten (Testkasse/Testsignatur)
1397
1503
  if (warnungen.length > 0) {
1398
1504
  lines.push({ kind: 'space', lines: 1 });
@@ -6,6 +6,7 @@ const errors_js_1 = require("../client/errors.js");
6
6
  const texte_js_1 = require("../pos/texte.js");
7
7
  const schicht_lesen_js_1 = require("../pos/schicht-lesen.js");
8
8
  const schicht_js_1 = require("../pos/schicht.js");
9
+ const rabatt_vorlagen_js_1 = require("../pos/rabatt-vorlagen.js");
9
10
  const vienna_time_js_1 = require("../vienna-time.js");
10
11
  const layout_js_1 = require("./layout.js");
11
12
  const PAPIER = ['mm58', 'mm80'];
@@ -191,6 +192,13 @@ function shiftReceiptLayout(receipt, options = {}) {
191
192
  for (const u of bon.nonCashByMethod)
192
193
  zeilen.push(betrag(zahlartText(u.method), u.cents));
193
194
  }
195
+ // Gewaehrte Rabatte je Name: nur wenn es welche gab, sonst bleibt der Bon wie bisher.
196
+ const rabatte = (0, rabatt_vorlagen_js_1.discountBlockLines)(bon.discounts);
197
+ if (rabatte.length > 0) {
198
+ zeilen.push(text((0, texte_js_1.labelText)('shift_receipt.discounts'), 'left', true));
199
+ for (const r of rabatte)
200
+ zeilen.push(betrag(r.label, r.cents));
201
+ }
194
202
  zeilen.push(anzahl((0, texte_js_1.labelText)('shift_receipt.receipts'), bon.receiptCount));
195
203
  zeilen.push(anzahl((0, texte_js_1.labelText)('shift_receipt.cancellations'), bon.cancellationCount));
196
204
  zeilen.push(anzahl((0, texte_js_1.labelText)('shift_receipt.openings_without_sale'), bon.openingsWithoutSale));