@kreiseck/kasseneck-api 1.29.0 → 1.31.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 (144) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/README.md +27 -0
  3. package/dist/cjs/client/list-receipts.d.ts +5 -0
  4. package/dist/cjs/client/list-receipts.js +5 -1
  5. package/dist/cjs/client/receipts.d.ts +6 -0
  6. package/dist/cjs/client/receipts.js +1 -0
  7. package/dist/cjs/enums/voucher-type.d.ts +5 -1
  8. package/dist/cjs/enums/voucher-type.js +5 -1
  9. package/dist/cjs/index.d.ts +1 -1
  10. package/dist/cjs/index.js +15 -5
  11. package/dist/cjs/inventory/index.d.ts +2 -2
  12. package/dist/cjs/inventory/index.js +3 -2
  13. package/dist/cjs/inventory/typen.d.ts +39 -1
  14. package/dist/cjs/inventory/vertrag.d.ts +13 -2
  15. package/dist/cjs/inventory/vertrag.js +16 -1
  16. package/dist/cjs/inventory/webhook.d.ts +3 -0
  17. package/dist/cjs/inventory/webhook.js +39 -0
  18. package/dist/cjs/models/index.d.ts +1 -1
  19. package/dist/cjs/models/index.js +12 -2
  20. package/dist/cjs/models/voucher.d.ts +96 -2
  21. package/dist/cjs/models/voucher.js +158 -5
  22. package/dist/cjs/pos/artikel.d.ts +12 -0
  23. package/dist/cjs/pos/artikel.js +2 -0
  24. package/dist/cjs/pos/client.js +11 -0
  25. package/dist/cjs/pos/errors.d.ts +1 -1
  26. package/dist/cjs/pos/errors.js +1 -0
  27. package/dist/cjs/pos/fremdgutschein-artikel.d.ts +66 -0
  28. package/dist/cjs/pos/fremdgutschein-artikel.js +74 -0
  29. package/dist/cjs/pos/gutschein.d.ts +13 -0
  30. package/dist/cjs/pos/gutschein.js +5 -1
  31. package/dist/cjs/pos/index.d.ts +7 -4
  32. package/dist/cjs/pos/index.js +43 -4
  33. package/dist/cjs/pos/rabatt-vorlagen.d.ts +79 -0
  34. package/dist/cjs/pos/rabatt-vorlagen.js +156 -0
  35. package/dist/cjs/pos/schicht-lesen.js +8 -0
  36. package/dist/cjs/pos/schicht-typen.d.ts +15 -0
  37. package/dist/cjs/pos/settings.d.ts +69 -3
  38. package/dist/cjs/pos/settings.js +72 -5
  39. package/dist/cjs/pos/texte.d.ts +235 -0
  40. package/dist/cjs/pos/texte.js +135 -1
  41. package/dist/cjs/pos/zusaetze.d.ts +3 -3
  42. package/dist/cjs/pos/zusaetze.js +4 -2
  43. package/dist/cjs/receipt/due.d.ts +8 -1
  44. package/dist/cjs/receipt/due.js +1 -0
  45. package/dist/cjs/receipt/gutschein-plan.d.ts +11 -1
  46. package/dist/cjs/receipt/gutschein-plan.js +116 -1
  47. package/dist/cjs/receipt/layout.js +39 -6
  48. package/dist/cjs/receipt/shift-sheet.js +8 -0
  49. package/dist/cjs/stored/draht.js +6 -0
  50. package/dist/cjs/stored/einstellungen.js +50 -2
  51. package/dist/cjs/stored/vokabular.d.ts +3 -1
  52. package/dist/cjs/stored/vokabular.js +52 -5
  53. package/dist/cjs/version.d.ts +1 -1
  54. package/dist/cjs/version.js +1 -1
  55. package/dist/esm/client/list-receipts.d.ts +5 -0
  56. package/dist/esm/client/list-receipts.js +5 -2
  57. package/dist/esm/client/receipts.d.ts +6 -0
  58. package/dist/esm/client/receipts.js +1 -0
  59. package/dist/esm/enums/voucher-type.d.ts +5 -1
  60. package/dist/esm/enums/voucher-type.js +5 -1
  61. package/dist/esm/index.d.ts +1 -1
  62. package/dist/esm/index.js +1 -1
  63. package/dist/esm/inventory/index.d.ts +2 -2
  64. package/dist/esm/inventory/index.js +1 -1
  65. package/dist/esm/inventory/typen.d.ts +39 -1
  66. package/dist/esm/inventory/vertrag.d.ts +13 -2
  67. package/dist/esm/inventory/vertrag.js +15 -0
  68. package/dist/esm/inventory/webhook.d.ts +3 -0
  69. package/dist/esm/inventory/webhook.js +39 -0
  70. package/dist/esm/models/index.d.ts +1 -1
  71. package/dist/esm/models/index.js +1 -1
  72. package/dist/esm/models/voucher.d.ts +96 -2
  73. package/dist/esm/models/voucher.js +152 -4
  74. package/dist/esm/pos/artikel.d.ts +12 -0
  75. package/dist/esm/pos/artikel.js +2 -0
  76. package/dist/esm/pos/client.js +12 -1
  77. package/dist/esm/pos/errors.d.ts +1 -1
  78. package/dist/esm/pos/errors.js +1 -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/gutschein.d.ts +13 -0
  82. package/dist/esm/pos/gutschein.js +4 -0
  83. package/dist/esm/pos/index.d.ts +7 -4
  84. package/dist/esm/pos/index.js +8 -4
  85. package/dist/esm/pos/rabatt-vorlagen.d.ts +79 -0
  86. package/dist/esm/pos/rabatt-vorlagen.js +148 -0
  87. package/dist/esm/pos/schicht-lesen.js +8 -0
  88. package/dist/esm/pos/schicht-typen.d.ts +15 -0
  89. package/dist/esm/pos/settings.d.ts +69 -3
  90. package/dist/esm/pos/settings.js +67 -4
  91. package/dist/esm/pos/texte.d.ts +235 -0
  92. package/dist/esm/pos/texte.js +133 -0
  93. package/dist/esm/pos/zusaetze.d.ts +3 -3
  94. package/dist/esm/pos/zusaetze.js +4 -2
  95. package/dist/esm/receipt/due.d.ts +8 -1
  96. package/dist/esm/receipt/due.js +1 -0
  97. package/dist/esm/receipt/gutschein-plan.d.ts +11 -1
  98. package/dist/esm/receipt/gutschein-plan.js +117 -2
  99. package/dist/esm/receipt/layout.js +40 -7
  100. package/dist/esm/receipt/shift-sheet.js +8 -0
  101. package/dist/esm/stored/draht.js +7 -1
  102. package/dist/esm/stored/einstellungen.js +52 -4
  103. package/dist/esm/stored/vokabular.d.ts +3 -1
  104. package/dist/esm/stored/vokabular.js +51 -4
  105. package/dist/esm/version.d.ts +1 -1
  106. package/dist/esm/version.js +1 -1
  107. package/fixtures/add-on-cases.json +6 -4
  108. package/fixtures/discount-preset-cases.json +1074 -0
  109. package/fixtures/expected/voucher-external-redeem.grid32.txt +30 -0
  110. package/fixtures/expected/voucher-external-redeem.grid48.txt +27 -0
  111. package/fixtures/expected/voucher-external-redeem.lines.json +280 -0
  112. package/fixtures/expected/voucher-external-redeem.sheet32.json +206 -0
  113. package/fixtures/expected/voucher-external-redeem.sheet48.json +188 -0
  114. package/fixtures/expected/voucher-external-sale.grid32.txt +27 -0
  115. package/fixtures/expected/voucher-external-sale.grid48.txt +26 -0
  116. package/fixtures/expected/voucher-external-sale.lines.json +256 -0
  117. package/fixtures/expected/voucher-external-sale.sheet32.json +188 -0
  118. package/fixtures/expected/voucher-external-sale.sheet48.json +182 -0
  119. package/fixtures/external-voucher-article-cases.json +311 -0
  120. package/fixtures/hobex-hps-codes.json +1 -1
  121. package/fixtures/invoice-api.schema.json +1 -1
  122. package/fixtures/invoice-texts.json +1 -1
  123. package/fixtures/manifest.json +16 -0
  124. package/fixtures/pos-texts.json +226 -2
  125. package/fixtures/receipt-due-voucher-generated.json +2 -2
  126. package/fixtures/receipts/voucher-external-redeem.json +85 -0
  127. package/fixtures/receipts/voucher-external-sale.json +80 -0
  128. package/fixtures/renames-1.0.json +18 -0
  129. package/fixtures/stored/voucher-cases.json +2800 -0
  130. package/fixtures/surface.json +62 -5
  131. package/fixtures/v3/antworten/belege.json +4 -3
  132. package/fixtures/v3/antworten/belegmail.json +2 -2
  133. package/fixtures/v3/antworten/berichte.json +2 -2
  134. package/fixtures/v3/antworten/kasse-belege.json +4 -3
  135. package/fixtures/v3/antworten/kasse.json +16 -10
  136. package/fixtures/v3/antworten/lager.json +6 -3
  137. package/fixtures/v3/antworten/rechnungen.json +2 -2
  138. package/fixtures/v3/antworten/storno.json +2 -2
  139. package/fixtures/v3/stored/belege.json +2 -2
  140. package/fixtures/v3/stored/kasse.json +3 -3
  141. package/fixtures/v3/stored/rechnungen.json +2 -2
  142. package/fixtures/v3/v3-vokabular.json +262 -15
  143. package/fixtures/v3/zahlbetrag-faelle.json +2 -2
  144. package/package.json +1 -1
@@ -22,17 +22,19 @@
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.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;
32
33
  exports.receiptOutputLabel = receiptOutputLabel;
33
34
  exports.labelText = labelText;
34
35
  exports.messageText = messageText;
35
36
  exports.messageAppliesTo = messageAppliesTo;
37
+ const fremdgutschein_artikel_js_1 = require("./fremdgutschein-artikel.js");
36
38
  const errors_js_1 = require("../client/errors.js");
37
39
  const MELDUNGEN_ROH = {
38
40
  // --- Transport -----------------------------------------------------------
@@ -87,6 +89,16 @@ const MELDUNGEN_ROH = {
87
89
  'reference.format_invalid': { text: 'Das Format passt nicht.' },
88
90
  'reference.format_warning': { text: 'Das Format passt nicht. Trotzdem übernehmen?' },
89
91
  'discount.percent_invalid': { text: 'Bitte einen Prozentwert zwischen 0,1 und 100 eingeben.' },
92
+ // Rabatt-Vorlagen (benannte Rabatt-Chips, 1.31.0): Fehler der Pruefung (checkDiscountPresets) und der gesperrte Chip.
93
+ 'discount.preset_over_total': { text: 'Der Rabatt ist höher als der Betrag, auf den er gilt.' },
94
+ 'discount_preset.list': { text: 'Höchstens 5 Rabatt-Vorlagen als Liste.' },
95
+ 'discount_preset.entry': { text: 'Eine Rabatt-Vorlage ist ein Objekt mit Name, Art und Wert.' },
96
+ 'discount_preset.name': { text: 'Name mit 1 bis 24 Zeichen, ohne Steuerzeichen.' },
97
+ 'discount_preset.duplicate': { text: 'Diesen Namen gibt es schon.' },
98
+ 'discount_preset.kind': { text: 'Prozent oder Betrag.' },
99
+ 'discount_preset.percent': { text: 'Prozent zwischen 0,1 und 100 mit höchstens einer Nachkommastelle.' },
100
+ 'discount_preset.amount': { text: 'Betrag zwischen 0,01 € und 1.000.000,00 €.' },
101
+ 'discount_preset.unknown_field': { text: 'Unbekanntes Feld.' },
90
102
  // --- Kassieren -----------------------------------------------------------
91
103
  // Der Grund ueber dem Knopf, solange der Beleg nicht abgeschlossen werden kann.
92
104
  'checkout.nothing_entered': { text: 'Noch nichts erfasst – bitte zuerst eine Position aufnehmen.' },
@@ -100,6 +112,9 @@ const MELDUNGEN_ROH = {
100
112
  'tip.over_half': { text: 'Über 50 % Trinkgeld – wirklich? Steuerfrei ist nur ortsübliches Trinkgeld.' },
101
113
  // Bar-Trinkgeld „gleich behalten“ (Hinweis zur Einstellung, Beschriftungen unten).
102
114
  '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.' },
115
+ // Hinweis unter dem Trinkgeld beim Kassieren je nach Wahl (tipKeptFor): gleich behalten bzw. offen fuer den Benutzer.
116
+ 'tip.kept_hint': { text: 'Trinkgeld kommt als eigene Position auf den Beleg; der angemeldete Benutzer nimmt es gleich bar aus der Lade.' },
117
+ '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
118
  // --- Abschluss -----------------------------------------------------------
104
119
  'completion.failed': { text: 'Der Abschluss ist fehlgeschlagen.' },
105
120
  '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.' },
@@ -226,6 +241,33 @@ const MELDUNGEN_ROH = {
226
241
  'voucher_error.amount_mismatch': { text: 'Die Gutschein-Sorte hat sich geändert. Die Kasse lädt die Sorten neu.' },
227
242
  'voucher_error.service_not_allowed': { text: 'Dieser Artikel ist nicht als Leistungsgutschein freigegeben.' },
228
243
  'voucher_error.payout_not_allowed': { text: 'Dieser Gutschein kann nicht ausgezahlt werden.' },
244
+ // Fremdgutscheine (Server 2026-11): Woerter wie gutschein-transaktion.fehlerText im Backend.
245
+ 'voucher_error.external_not_enabled': { text: 'Fremde Gutscheine sind für dieses Konto nicht freigegeben.' },
246
+ 'voucher_error.external_type_not_enabled': { text: 'Fremde Einzweckgutscheine sind für dieses Konto nicht freigegeben.' },
247
+ 'voucher_error.external_number_invalid': { text: 'Gutscheinnummer prüfen: 1 bis 40 Zeichen, nur Buchstaben, Ziffern und - _ . / sind erlaubt.' },
248
+ 'voucher_error.external_number_is_own_code': { text: 'Das ist ein eigener Gutscheincode. Bitte als eigenen Gutschein einlösen.' },
249
+ 'voucher_error.external_duplicate': { text: 'Diese Gutscheinnummer steht schon auf dem Beleg.' },
250
+ // Fremdgutscheine an der Kasse (1.31.0): Kachel gesperrt (Zuordnung in EXTERNAL_VOUCHER_TILE_MESSAGES), Hinweis im
251
+ // Storno eines Belegs mit fremdem Gutschein-Verkauf, Hilfe-Satz unter dem Schalter im Kundenbereich.
252
+ 'external_voucher.not_enabled': { text: 'Fremde Gutscheine sind aus. Bitte im Panel freischalten.' },
253
+ 'external_voucher.type_not_enabled': { text: 'Fremde Leistungsgutscheine sind aus. Bitte im Panel freischalten.' },
254
+ // Eingabe in der Form eines eigenen Codes, aber keiner (ownVoucherCodeShape `checksum`/`length`): nachfragen, nie abweisen.
255
+ 'external_voucher.looks_like_own_code': { text: 'Sieht aus wie ein Kasseneck-Code, ist aber keiner. Als fremden Gutschein verwenden?' },
256
+ 'cancellation.external_voucher_check': { text: 'Vorher im eigenen Gutscheinsystem prüfen, ob er schon benutzt wurde.' },
257
+ '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.' },
258
+ // Artikel als fremder Gutschein speichern (article_external_voucher_invalid, Zuordnung je data.grund in
259
+ // EXTERNAL_VOUCHER_ARTICLE_MESSAGES): Woerter wie fremdgutschein-artikel-core im Backend; `invalid` fuer
260
+ // invalid_type und einen unbekannten Grund (der Backend-Satz dazu ist technisch); invalid_rate mit deutschem
261
+ // Dezimalkomma statt der Liste aus STEUERSAETZE.join.
262
+ 'external_voucher_article.invalid': { text: 'Diese Art von fremdem Gutschein gibt es nicht.' },
263
+ 'external_voucher_article.service_voucher': { text: 'Ein fremder Gutschein kann kein Leistungsgutschein mit Code sein.' },
264
+ 'external_voucher_article.add_ons': { text: 'Ein fremder Gutschein hat keine Zusätze.' },
265
+ 'external_voucher_article.stock_tracked': { text: 'Ein fremder Gutschein führt keinen Lagerbestand.' },
266
+ 'external_voucher_article.reference': { text: 'Ein fremder Gutschein fragt keine Referenz ab, die Kasse fragt die Gutscheinnummer.' },
267
+ 'external_voucher_article.asks_quantity': { text: 'Ein fremder Gutschein fragt keine Menge ab.' },
268
+ 'external_voucher_article.rate_required': { text: 'Ein Einzweckgutschein braucht den Steuersatz, mit dem er verkauft wird.' },
269
+ 'external_voucher_article.invalid_rate': { text: 'Ein Einzweckgutschein braucht einen Steuersatz der Kasse: 20, 13, 10, 4,9, 0 oder 19 %.' },
270
+ 'external_voucher_article.price_required': { text: 'Ein fremder Gutschein braucht einen Preis oder „Betrag beim Antippen eingeben“.' },
229
271
  // Satz der Kasse selbst (1.17.0): eine Verkaufszeile im Korb passt nach dem Neuladen der Sorten nicht mehr (Sorte
230
272
  // geaendert, deaktiviert oder geloescht). Die Zeile sperrt das Kassieren, bis sie entfernt und neu gewaehlt ist;
231
273
  // der Satz nach einer Absage des Servers bleibt voucher_error.type_not_found bzw. voucher_error.amount_mismatch.
@@ -681,6 +723,39 @@ function cancellationErrorMessage(code) {
681
723
  const gutschein = exports.CANCELLATION_VOUCHER_ERROR_MESSAGES;
682
724
  return (code !== undefined && code !== null && gutschein[code]) || cancellationPaymentErrorMessage(code);
683
725
  }
726
+ /**
727
+ * Fremdgutscheine an der Kasse (1.31.0): Satz zur gesperrten Kachel ([externalVoucherTileBlock]).
728
+ */
729
+ exports.EXTERNAL_VOUCHER_TILE_MESSAGES = {
730
+ not_enabled: 'external_voucher.not_enabled',
731
+ type_not_enabled: 'external_voucher.type_not_enabled',
732
+ };
733
+ /**
734
+ * Artikel als fremder Gutschein: Satz je verletzter Regel (`data.grund` zu
735
+ * `article_external_voucher_invalid`, bzw. [checkExternalVoucherArticle] im Editor).
736
+ */
737
+ exports.EXTERNAL_VOUCHER_ARTICLE_MESSAGES = {
738
+ invalid_type: 'external_voucher_article.invalid',
739
+ service_voucher: 'external_voucher_article.service_voucher',
740
+ add_ons: 'external_voucher_article.add_ons',
741
+ stock_tracked: 'external_voucher_article.stock_tracked',
742
+ reference: 'external_voucher_article.reference',
743
+ asks_quantity: 'external_voucher_article.asks_quantity',
744
+ rate_required: 'external_voucher_article.rate_required',
745
+ invalid_rate: 'external_voucher_article.invalid_rate',
746
+ price_required: 'external_voucher_article.price_required',
747
+ };
748
+ /**
749
+ * Der Satz zu einer Absage beim Speichern eines Artikels: nur fuer
750
+ * `article_external_voucher_invalid` (sonst `undefined`), je `grund`; ein
751
+ * unbekannter oder fehlender Grund (`reason` = `data.grund`) bekommt den allgemeinen Satz.
752
+ */
753
+ function externalVoucherArticleErrorMessage(code, reason) {
754
+ if (code !== fremdgutschein_artikel_js_1.ARTICLE_EXTERNAL_VOUCHER_INVALID)
755
+ return undefined;
756
+ const saetze = exports.EXTERNAL_VOUCHER_ARTICLE_MESSAGES;
757
+ return (typeof reason === 'string' && Object.prototype.hasOwnProperty.call(saetze, reason) ? saetze[reason] : undefined) ?? 'external_voucher_article.invalid';
758
+ }
684
759
  /**
685
760
  * Gutschein-Fehler (`/v3`): welcher `code` des Backends welchen Satz bekommt.
686
761
  * Wie RECEIPT_EMAIL_ERROR_MESSAGES: beide Kassen entscheiden am Code. Ein
@@ -708,6 +783,11 @@ exports.VOUCHER_ERROR_MESSAGES = {
708
783
  voucher_amount_mismatch: 'voucher_error.amount_mismatch',
709
784
  voucher_service_not_allowed: 'voucher_error.service_not_allowed',
710
785
  voucher_payout_not_allowed: 'voucher_error.payout_not_allowed',
786
+ external_voucher_not_enabled: 'voucher_error.external_not_enabled',
787
+ external_voucher_type_not_enabled: 'voucher_error.external_type_not_enabled',
788
+ external_voucher_number_invalid: 'voucher_error.external_number_invalid',
789
+ external_voucher_number_is_own_code: 'voucher_error.external_number_is_own_code',
790
+ external_voucher_duplicate: 'voucher_error.external_duplicate',
711
791
  };
712
792
  /** Der Satz zu einem Gutschein-`code`; `undefined` für jeden anderen Code. */
713
793
  function voucherErrorMessage(code) {
@@ -757,6 +837,24 @@ const BESCHRIFTUNGEN_ROH = {
757
837
  // Schalter beim Trinkgeld (nur Mitarbeiter-Trinkgeld, reine Barzahlung), vorbelegt aus der Einstellung.
758
838
  'checkout.tip_kept': { text: 'gleich behalten' },
759
839
  'tip.kept_setting': { text: 'Bar-Trinkgeld behält der Mitarbeiter gleich' },
840
+ // Stufe „Trinkgeld gleich behalten“ im Kundenbereich (business.tipKeptMode, Zuordnung TIP_KEPT_MODE_LABELS).
841
+ 'tip_kept_mode.title': { text: 'Trinkgeld gleich behalten' },
842
+ 'tip_kept_mode.always': { text: 'Immer gleich behalten' },
843
+ 'tip_kept_mode.never': { text: 'Immer offen lassen' },
844
+ 'tip_kept_mode.ask': { text: 'Jedes Mal fragen' },
845
+ // Editor „Rabatt-Vorlagen“ im Kundenbereich und in den Einstellungen der Kasse (business.discountPresets).
846
+ 'discount_presets.title': { text: 'Rabatt-Vorlagen' },
847
+ 'discount_presets.name': { text: 'Name' },
848
+ 'discount_presets.percent': { text: 'Prozent' },
849
+ 'discount_presets.amount': { text: 'Betrag' },
850
+ 'discount_presets.add': { text: 'Vorlage hinzufügen' },
851
+ 'discount_presets.remove': { text: 'Entfernen' },
852
+ 'discount_presets.limit': { text: 'Höchstens 5 Vorlagen.' },
853
+ // Block auf Z-Bon und Zwischenbericht (discountBlockLines): je Name „Name (n×)“, ab zwei Eintraegen die Summe.
854
+ 'shift_receipt.discounts': { text: 'Rabatte' },
855
+ 'shift_receipt.discounts_total': { text: 'Rabatte gesamt' },
856
+ 'shift_receipt.discount_line': { text: '{name} ({count}×)', placeholders: ['name', 'count'] },
857
+ 'shift_receipt.discount_unnamed': { text: 'Rabatt' },
760
858
  // Die Warte-Karte, solange der Betrag am Terminal steht; `{time}` ist der
761
859
  // Rest des Kartenfensters als m:ss.
762
860
  'card_payment.amount_on_terminal': { text: 'Betrag steht am Terminal' },
@@ -1075,6 +1173,25 @@ const BESCHRIFTUNGEN_ROH = {
1075
1173
  'addons.none': { text: 'Ohne Zusatz' },
1076
1174
  'addons.done': { text: 'Fertig' },
1077
1175
  'addons.open': { text: 'Zusätze' },
1176
+ // Fremdgutscheine an der Kasse (1.31.0): Kachel-Blatt („Gutscheinnummer“, Betrag = tile_prompt.amount), Blatt
1177
+ // „Fremder Gutschein“ beim Einlösen und Auszahlen (Betrag = voucher.amount, Grund = voucher.reason), Korbzeile,
1178
+ // Umschalter im Blatt „Gutschein auszahlen“; Schalter im Kundenbereich und Haken im Artikel-Editor.
1179
+ 'external_voucher.number': { text: 'Gutscheinnummer' },
1180
+ 'external_voucher.title': { text: 'Fremder Gutschein' },
1181
+ 'external_voucher.kind': { text: 'Art' },
1182
+ 'external_voucher.kind_value': { text: 'Wertgutschein' },
1183
+ 'external_voucher.kind_service': { text: 'Leistungsgutschein' },
1184
+ 'external_voucher.rate': { text: 'Satz' },
1185
+ 'external_voucher.taxed_with': { text: 'Versteuert mit (optional)' },
1186
+ 'external_voucher.line_name': { text: 'Gutschein Nr. {number}', placeholders: ['number'] },
1187
+ 'external_voucher.use_as_external': { text: 'Als fremden Gutschein' },
1188
+ 'voucher.payout_source_own': { text: 'Kasseneck-Gutschein' },
1189
+ 'voucher.payout_source_external': { text: 'Fremder Gutschein' },
1190
+ 'settings.external_vouchers': { text: 'Fremde Gutscheine' },
1191
+ 'settings.external_vouchers_off': { text: 'Aus' },
1192
+ 'settings.external_vouchers_multi_purpose': { text: 'Nur Wertgutscheine' },
1193
+ 'settings.external_vouchers_all': { text: 'Wert- und Leistungsgutscheine' },
1194
+ 'article.external_voucher': { text: 'Verkauft einen fremden Gutschein' },
1078
1195
  // Gutschein-Sorten als Kacheln im Reiter „Gutscheine“ (Stufe 4b, 1.17.0): Kachel je Sorte mit Betrag
1079
1196
  // oder „Betrag eingeben“, darunter klein die Art; dazu die feste Kachel „Leistungsgutschein“.
1080
1197
  'voucher.tab': { text: 'Gutscheine' },
@@ -1334,6 +1451,23 @@ exports.RETURN_DISPOSITION_LABELS = {
1334
1451
  defective: 'stock.return_defective',
1335
1452
  disposed: 'stock.return_disposed',
1336
1453
  };
1454
+ /** Stufe „Trinkgeld gleich behalten“ (`business.tipKeptMode`) -> Beschriftung im Kundenbereich. */
1455
+ exports.TIP_KEPT_MODE_LABELS = {
1456
+ ask: 'tip_kept_mode.ask',
1457
+ always: 'tip_kept_mode.always',
1458
+ never: 'tip_kept_mode.never',
1459
+ };
1460
+ /** Freigabe fuer Fremdgutscheine (`externalVouchers`) -> Beschriftung der Stufe im Kundenbereich. */
1461
+ exports.EXTERNAL_VOUCHERS_LABELS = {
1462
+ off: 'settings.external_vouchers_off',
1463
+ multi_purpose: 'settings.external_vouchers_multi_purpose',
1464
+ all: 'settings.external_vouchers_all',
1465
+ };
1466
+ /** Art eines fremden Gutscheins (Artikel, Blatt) -> Beschriftung: Wert- bzw. Leistungsgutschein. */
1467
+ exports.EXTERNAL_VOUCHER_KIND_LABELS = {
1468
+ multi_purpose: 'external_voucher.kind_value',
1469
+ single_purpose: 'external_voucher.kind_service',
1470
+ };
1337
1471
  /** Art einer Ausgabe -> Beschriftung (`receipt.output_<kind>`). */
1338
1472
  const AUSGABE_BESCHRIFTUNG = {
1339
1473
  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) {
@@ -1,7 +1,7 @@
1
1
  import { ReceiptType, type ReceiptTypeKey, KeckPaymentMethod } from '../enums/index.js';
2
2
  import type { ReceiptItem } from '../models/receipt-item.js';
3
3
  import type { Voucher } from '../models/voucher.js';
4
- import type { PosVoucherSettings, VoucherCheck } from '../pos/gutschein.js';
4
+ import type { PosExternalVouchers, PosVoucherSettings, VoucherCheck } from '../pos/gutschein.js';
5
5
  import { type VoucherDueArticle, type VoucherDueInfo, type VoucherDueType } from './gutschein-plan.js';
6
6
  export { VOUCHER_ZERO_RATE_BUCKET_FROM, type VoucherDueArticle, type VoucherDueInfo, type VoucherDueType } from './gutschein-plan.js';
7
7
  /**
@@ -104,6 +104,13 @@ export interface ReceiptDueOptions {
104
104
  * einen Wert-Verkauf ohne `typeId` nicht mehr.
105
105
  */
106
106
  voucherSettings?: PosVoucherSettings;
107
+ /**
108
+ * Freigabe fuer Fremdgutscheine (`getKasseSettings` `vouchers.externalVouchers`). Bei `off` rechnet ein
109
+ * Fremdgutschein nicht (`external_voucher_not_enabled`), ein fremder Einzweck nur bei `all`
110
+ * (`external_voucher_type_not_enabled`). Ohne Angabe gilt die aus `voucherSettings`; fehlen beide, prueft
111
+ * nur der Server die Freigabe.
112
+ */
113
+ externalVouchers?: PosExternalVouchers;
107
114
  /**
108
115
  * Artikel fuer den Verkauf von Dienstleistungsgutscheinen (Preis und Satz,
109
116
  * wie im Artikelstamm). Fehlt der verkaufte Artikel hier:
@@ -92,6 +92,7 @@ function rechne(items, vouchers, receiptType, options) {
92
92
  const plan = (0, gutschein_plan_js_1.planeGutscheine)(positionen, vouchers, art, {
93
93
  voucherInfo: options.voucherInfo,
94
94
  voucherSettings: options.voucherSettings,
95
+ ...(options.externalVouchers !== undefined ? { externalVouchers: options.externalVouchers } : {}),
95
96
  voucherTypes: options.voucherTypes,
96
97
  voucherArticles: options.voucherArticles,
97
98
  smallBusiness: options.smallBusiness,
@@ -1,5 +1,5 @@
1
1
  import type { Voucher } from '../models/voucher.js';
2
- import type { PosVoucherSettings, PosVoucherType, VoucherArticle, VoucherCheck } from '../pos/gutschein.js';
2
+ import type { PosExternalVouchers, PosVoucherSettings, PosVoucherType, VoucherArticle, VoucherCheck } from '../pos/gutschein.js';
3
3
  /**
4
4
  * Gutscheine der neuen Form im Zahlbetrag: Zwilling von
5
5
  * `gutschein-beleg.plane` im Backend, soweit er den Zahlbetrag bestimmt.
@@ -27,6 +27,11 @@ import type { PosVoucherSettings, PosVoucherType, VoucherArticle, VoucherCheck }
27
27
  * - Leistung verkaufen: Stueck mal Artikelpreis im Artikelsatz; einloesen: je
28
28
  * Satz eine Minuszeile ueber die gewaehlten Positionen.
29
29
  * - Aktion: Rabatt wie `promo`, Betrag aus der Pruefung, hoechstens die Summe.
30
+ * - Fremdgutschein (`source: 'external'`, Server 2026-11): dieselbe Strecke
31
+ * wie ein eigener Mehrzweck- bzw. Einzweckgutschein, nur ohne Pruefung und
32
+ * Saldo (verfuegbar ist genau der Betrag des Wunschs); Satz und Vermerk
33
+ * sagt der Wunsch, Satz 0 heisst befreit verkauft. Freigabe aus
34
+ * `externalVouchers` (sonst `voucherSettings.externalVouchers`).
30
35
  *
31
36
  * Kein Fehler wird still geschluckt: was der Server mit einem Gutschein-Code
32
37
  * abwiese, liefert `fehler` mit genau diesem Code (`voucher_*`). Der
@@ -77,6 +82,11 @@ export declare const VOUCHER_ZERO_RATE_BUCKET_FROM = "2099-12-31";
77
82
  export interface PlanOptionen {
78
83
  voucherInfo?: readonly VoucherDueInfo[];
79
84
  voucherSettings?: PosVoucherSettings;
85
+ /**
86
+ * Freigabe fuer Fremdgutscheine des Kontos; ohne Angabe die aus `voucherSettings`. Fehlen beide, prueft nur
87
+ * der Server die Freigabe.
88
+ */
89
+ externalVouchers?: PosExternalVouchers;
80
90
  voucherTypes?: readonly VoucherDueType[];
81
91
  voucherArticles?: readonly VoucherDueArticle[];
82
92
  smallBusiness?: boolean;
@@ -130,6 +130,63 @@ function kuTeile(kunde, betragCents) {
130
130
  nachRest[k].s.cents += 1;
131
131
  return saetze.filter((s) => s.cents > 0).map((s) => ({ satzBp: s.satzBp, cents: s.cents }));
132
132
  }
133
+ /** Steuer- und Formatzeichen (`gutschein-core.STEUERZEICHEN`). */
134
+ const STEUERZEICHEN = /[\p{Cc}\p{Cf}]/u;
135
+ /**
136
+ * Form eines Fremdgutschein-Wunschs in der Reihenfolge von `gutschein-beleg.pruefeFremd`: Freigabe, Aktion, Art,
137
+ * Freigabe der Art, Felder eigener Gutscheine, eigener Code, Nummer, Dublette, Betrag, Satz, Vermerk, Grund.
138
+ * `freigabe` undefined: die Freigabe prueft nur der Server.
139
+ */
140
+ function pruefeFremd(v, i, freigabe, gesehen) {
141
+ const nein = (fehler, text) => ({ fehler, text });
142
+ const falsch = (feld) => nein('voucher_invalid', `Gutschein ${i + 1}: ${feld} passt nicht zum Fremdgutschein.`);
143
+ if (freigabe === 'off')
144
+ return nein('external_voucher_not_enabled', `Gutschein ${i + 1}: Fremdgutscheine sind nicht freigegeben.`);
145
+ if (v.action !== 'sell' && v.action !== 'redeem' && v.action !== 'payout')
146
+ return falsch('action');
147
+ if (v.type !== 'multi_purpose' && v.type !== 'single_purpose')
148
+ return falsch('type');
149
+ if (v.type === 'single_purpose' && freigabe !== undefined && freigabe !== 'all') {
150
+ return nein('external_voucher_type_not_enabled', `Gutschein ${i + 1}: fremde Einzweckgutscheine sind nicht freigegeben.`);
151
+ }
152
+ const r = v;
153
+ for (const feld of ['code', 'typeId', 'articleId', 'article', 'quantity', 'positions']) {
154
+ if (r[feld] !== undefined)
155
+ return falsch(feld);
156
+ }
157
+ if (v.valueCents != null)
158
+ return falsch('valueCents');
159
+ const nummer = (0, voucher_js_1.checkExternalVoucherNumber)(v.number);
160
+ if (!nummer.ok)
161
+ return nein(nummer.code, `Gutschein ${i + 1}: die Nummer ist ${nummer.code === 'external_voucher_number_is_own_code' ? 'ein eigener Gutscheincode' : 'ungueltig'}.`);
162
+ if (gesehen.has(nummer.number))
163
+ return nein('external_voucher_duplicate', `Gutschein ${i + 1}: dieselbe Nummer steht zweimal am Beleg.`);
164
+ gesehen.add(nummer.number);
165
+ const c = v.amountCents;
166
+ if (!(typeof c === 'number' && Number.isInteger(c) && c >= 1 && c <= 1_000_000))
167
+ return falsch('amountCents');
168
+ if (v.type === 'single_purpose') {
169
+ if (!(typeof v.vatRateBp === 'number' && voucher_js_1.EXTERNAL_VOUCHER_VAT_RATES_BP.includes(v.vatRateBp)))
170
+ return falsch('vatRateBp');
171
+ }
172
+ else if (v.vatRateBp != null) {
173
+ return falsch('vatRateBp');
174
+ }
175
+ if (v.taxedWith != null) {
176
+ if (v.type !== 'single_purpose' || v.action === 'sell')
177
+ return falsch('taxedWith');
178
+ const t = typeof v.taxedWith === 'string' ? v.taxedWith.trim() : '';
179
+ if (t.length < 1 || t.length > voucher_js_1.EXTERNAL_VOUCHER_TAXED_WITH_MAX || STEUERZEICHEN.test(t))
180
+ return falsch('taxedWith');
181
+ }
182
+ if (v.action === 'payout') {
183
+ const g = typeof v.reason === 'string' ? v.reason.trim() : '';
184
+ if (g.length < 1 || g.length > 200)
185
+ return falsch('reason');
186
+ }
187
+ // Uebrige Serverfelder am Wunsch: wie bei eigenen Gutscheinen nie sendbar.
188
+ return (0, voucher_js_1.voucherIsValid)(v) ? null : falsch('Angaben');
189
+ }
133
190
  /**
134
191
  * Wuensche und gelesene Eintraege in Positionen und Belegeintraege, wie
135
192
  * `plane` sie baut. `kunde` sind Ware und Trinkgeld in innerer Form.
@@ -175,11 +232,19 @@ function planeGutscheine(kunde, vouchers, art, o) {
175
232
  return nein('voucher_invalid', 'Gutscheine der neuen Form gibt es nicht auf Schulungsbelegen.');
176
233
  if (kunde.some(istGutscheinZeile))
177
234
  return nein('voucher_invalid', 'Gutschein-Positionen setzt nur der Server.');
235
+ const freigabe = o.externalVouchers ?? o.voucherSettings?.externalVouchers;
236
+ const nummern = new Set();
178
237
  for (const [i, v] of vouchers.entries()) {
179
238
  if (istGelesen(v))
180
239
  return nein('voucher_invalid', `Gutschein ${i + 1}: Serverfelder an einem Wunsch.`);
181
240
  if (!(0, voucher_js_1.isNewFormVoucher)(v))
182
241
  continue;
242
+ if ((0, voucher_js_1.isExternalVoucher)(v)) {
243
+ const f = pruefeFremd(v, i, freigabe, nummern);
244
+ if (f)
245
+ return f;
246
+ continue;
247
+ }
183
248
  if ((0, voucher_js_1.istWertVerkauf)(v) && v.typeId == null) {
184
249
  // Wie gutschein-beleg.pruefeWuensche: ein Wert-Verkauf ohne Sorte ist voucher_type_required.
185
250
  // Nur eine alte Gutschein-Einstellung MIT Art (Aufrufer bis 1.16) rechnet wie bisher; ein Server ab
@@ -206,7 +271,8 @@ function planeGutscheine(kunde, vouchers, art, o) {
206
271
  if (wuensche.some((v) => v.action === 'payout') && vouchers.some((v) => !(0, voucher_js_1.isNewFormVoucher)(v) && v.type === 'promo')) {
207
272
  return nein('voucher_invalid', 'Rabatt und Auszahlung gehen nicht am selben Beleg.');
208
273
  }
209
- const codes = wuensche.filter((v) => v.action !== 'sell').map((v) => normalerCode(v.code));
274
+ // Die Nummer eines Fremdgutscheins prueft pruefeFremd (external_voucher_duplicate).
275
+ const codes = wuensche.filter((v) => v.action !== 'sell' && !(0, voucher_js_1.isExternalVoucher)(v)).map((v) => normalerCode(v.code));
210
276
  if (codes.some((c) => c == null))
211
277
  return nein('voucher_invalid', 'Ein Gutscheincode ist ungueltig.');
212
278
  if (new Set(codes).size !== codes.length)
@@ -252,6 +318,55 @@ function planeGutscheine(kunde, vouchers, art, o) {
252
318
  gutscheine.push(g);
253
319
  continue;
254
320
  }
321
+ if ((0, voucher_js_1.isExternalVoucher)(v)) {
322
+ // gutschein-beleg.plane mit sichtExtern: kein Dokument, kein Saldo, keine Statuspruefung.
323
+ const c = v.amountCents;
324
+ const satz = v.type === 'single_purpose' ? v.vatRateBp : 0;
325
+ if (v.action === 'sell') {
326
+ if (v.type === 'multi_purpose') {
327
+ if (nulltopf) {
328
+ zusatz.push(position(0, c, 'voucher_float'));
329
+ gutscheine.push({ action: 'sell', type: 'value', value: c / 100, imNullTopf: true });
330
+ }
331
+ else {
332
+ gutscheine.push({ action: 'sell', type: 'value', value: c / 100 });
333
+ }
334
+ }
335
+ else {
336
+ // Kleinunternehmer verkauft befreit: Satz 0, egal was gesendet wird.
337
+ zusatz.push(position(ku ? 0 : satz, c, 'voucher'));
338
+ }
339
+ }
340
+ else if (v.action === 'payout') {
341
+ if (v.type === 'multi_purpose') {
342
+ zusatz.push(position(0, -c, 'voucher_float'));
343
+ gutscheine.push({ action: 'payout', type: 'value', value: c / 100, imNullTopf: true });
344
+ }
345
+ else {
346
+ // Ohne Dokument berichtigt ein Kleinunternehmer-Konto im 0-%-Topf (nie USt, die es nie geschuldet hat).
347
+ zusatz.push(position(ku ? 0 : satz, -c, 'voucher'));
348
+ }
349
+ auszahlungCents += c;
350
+ }
351
+ else if (v.type === 'multi_purpose') {
352
+ gutscheine.push({ action: 'redeem', type: 'value', value: c / 100 });
353
+ }
354
+ else if (satz === 0 || ku) {
355
+ // Befreit verkauft (Satz 0) oder Kleinunternehmer-Konto: anteilig auf alle Toepfe des Korbs.
356
+ const teile = kuTeile(kunde, c);
357
+ if (!teile)
358
+ return nein('voucher_rate_mismatch', `Gutschein ${i + 1}: der Korb deckt den Betrag nicht.`);
359
+ for (const t of teile) {
360
+ zusatz.push(position(t.satzBp, -t.cents, 'voucher'));
361
+ minus(t.satzBp, t.cents);
362
+ }
363
+ }
364
+ else {
365
+ zusatz.push(position(satz, -c, 'voucher'));
366
+ minus(satz, c);
367
+ }
368
+ continue;
369
+ }
255
370
  if ((0, voucher_js_1.istWertVerkauf)(v) && v.typeId != null) {
256
371
  // Verkauf ueber eine Sorte (gutschein-beleg.plane): unbekannt, andere Art, falscher Fixbetrag. Eine andere Art
257
372
  // heisst: die Kasse hat eine alte Sicht (Sorte umgestellt) – wie ein anderer Fixbetrag voucher_amount_mismatch,
@@ -583,6 +583,10 @@ function nettoAusBrutto(bruttoCents, rate) {
583
583
  * nennt, allein stehen bleibt.
584
584
  */
585
585
  function gutscheinText(voucher) {
586
+ // Fremdgutschein: die Nummer des fremden Systems voll, ohne Gutscheinart (die steht beim Verkauf in der Position).
587
+ const fremd = fremdZeile(voucher);
588
+ if (fremd != null)
589
+ return fremd;
586
590
  let text = '';
587
591
  if (voucher.type === index_js_1.VoucherType.value) {
588
592
  text += 'Wertgutschein';
@@ -628,6 +632,15 @@ function gutscheinText(voucher) {
628
632
  * Text „ Grund: <Grund>“
629
633
  * Aktion Rabattzeile wie bisher (Aktionsgutschein)
630
634
  *
635
+ * Fremdgutschein wie der eigene, nur mit „Gutschein Nr. <Nummer>“ statt der
636
+ * (`source: 'external'`) Maske: Verkauf „Gutschein Nr. W-77 (Mehrzweckgutschein)“ bzw.
637
+ * „(Einzweckgutschein 20 %)“ (Name der Position vom Server),
638
+ * Einloesung Einzweck 8:4 „Gutschein Nr. FG-1234“ | „-20,00 A“ und
639
+ * Text „ Einzweck, versteuert mit FG-1234-V“ (nur mit
640
+ * `taxedWith`), Mehrzweck nach „Zwischensumme“ „Gutschein Nr.
641
+ * W-77“ | „-3,00 €“, Auszahlung „Auszahlung Gutschein Nr. …“;
642
+ * nie „Rest am Gutschein“ (den Saldo kennt nur das fremde System)
643
+ *
631
644
  * Vermerke sind Textzeilen mit zwei fuehrenden Leerzeichen; das Raster bricht
632
645
  * sie mit demselben Einzug um (grid.ts, haengender Einzug), auf 58 mm etwa
633
646
  * „ Einzweck, versteuert mit“ / „ Beleg K1-ID-4711“.
@@ -670,6 +683,16 @@ function gutscheinEndung(voucher) {
670
683
  return typeof voucher.code === 'string' && voucher.code.length >= 4 && voucher.code !== 'no-code' ? voucher.code.slice(-4) : null;
671
684
  }
672
685
  const MEHRZWECK_UST_TEXT = ' USt bei Einlösung';
686
+ /** Zeile eines Fremdgutscheins `Gutschein Nr. <Nummer>`; null bei einem eigenen Gutschein oder ohne Nummer. */
687
+ function fremdZeile(voucher) {
688
+ return (0, index_js_2.isExternalVoucher)(voucher) && typeof voucher.number === 'string' && voucher.number !== '' ? `Gutschein Nr. ${voucher.number}` : null;
689
+ }
690
+ /** Ein gelesener Eintrag mit Wert: beim Fremdgutschein ganze positive Cent, sonst wie [voucherIsValid]. */
691
+ function eintragGueltig(voucher) {
692
+ if (!(0, index_js_2.isExternalVoucher)(voucher))
693
+ return (0, index_js_2.voucherIsValid)(voucher);
694
+ return Number.isSafeInteger(voucher.valueCents) && voucher.valueCents > 0;
695
+ }
673
696
  /**
674
697
  * Welche Gutscheinposition (`voucher`/`voucher_float`) gehoert zu welchem
675
698
  * Eintrag? Jede Position hoechstens einem Eintrag, Eintraege in ihrer
@@ -698,10 +721,11 @@ function gutscheinPositionen(receipt) {
698
721
  zuordnung.set(i, { voucher, letzte: true });
699
722
  continue;
700
723
  }
724
+ const fremd = fremdZeile(voucher);
701
725
  const endung = gutscheinEndung(voucher);
702
- if (endung == null || (voucher.action !== index_js_1.VoucherAction.redeem && voucher.action !== index_js_1.VoucherAction.payout))
726
+ if ((fremd == null && endung == null) || (voucher.action !== index_js_1.VoucherAction.redeem && voucher.action !== index_js_1.VoucherAction.payout))
703
727
  continue;
704
- const name = `${voucher.action === index_js_1.VoucherAction.payout ? 'Auszahlung ' : ''}Gutschein ····-${endung}`;
728
+ const name = `${voucher.action === index_js_1.VoucherAction.payout ? 'Auszahlung ' : ''}${fremd ?? `Gutschein ····-${endung}`}`;
705
729
  const ziel = Number.isInteger(voucher.amountCents) ? Math.abs(voucher.amountCents) : Math.abs(voucher.valueCents ?? 0);
706
730
  const genommen = [];
707
731
  let summe = 0;
@@ -747,6 +771,12 @@ function gutscheinPositionsZeilen(item, satz, zu) {
747
771
  return zeilen;
748
772
  }
749
773
  const art = v.type === index_js_1.VoucherType.service ? 'Leistung' : 'Einzweck';
774
+ if ((0, index_js_2.isExternalVoucher)(v)) {
775
+ // Fremdgutschein: Vermerk nur mit `taxedWith` (Beleg im fremden System, wie gesendet), kein Rest.
776
+ if (typeof v.taxedWith === 'string' && v.taxedWith !== '')
777
+ zeilen.push(textZeile(` ${art}, versteuert mit ${v.taxedWith}`));
778
+ return zeilen;
779
+ }
750
780
  if (typeof v.taxedWith === 'string' && v.taxedWith !== '') {
751
781
  zeilen.push(textZeile(` ${art}, versteuert mit Beleg ${v.taxedWith}`));
752
782
  }
@@ -1225,17 +1255,18 @@ function buildReceiptLayout(receipt, company, options = {}) {
1225
1255
  continue;
1226
1256
  const wert = voucher.valueCents ?? 0;
1227
1257
  const vz = voucher.type === index_js_1.VoucherType.value ? wgVz : 1;
1228
- if ((0, index_js_2.voucherIsValid)(voucher) && voucher.action === index_js_1.VoucherAction.sell) {
1258
+ if (eintragGueltig(voucher) && voucher.action === index_js_1.VoucherAction.sell) {
1229
1259
  gruppeVon(steuersatz(index_js_1.VatRate.vat0)).bruttoCents += vz * wert;
1230
1260
  }
1231
1261
  if (voucher.action === index_js_1.VoucherAction.sell && voucher.type === index_js_1.VoucherType.value) {
1232
1262
  // Mehrzweck mit Code (vor dem Stichtag nur als Eintrag): wie die Position im 0-%-Topf.
1233
1263
  const mehrzweck = istMehrzweckMitCode(voucher);
1234
1264
  const code = gutscheinCodeZusatz(voucher);
1265
+ const fremd = fremdZeile(voucher);
1235
1266
  lines.push({
1236
1267
  kind: 'columns',
1237
1268
  columns: [
1238
- { text: `1 x ${mehrzweck ? `Mehrzweckgutschein${code}` : gutscheinText(voucher)}`, width: 7, align: 'left' },
1269
+ { text: `1 x ${fremd != null ? `${fremd} (Mehrzweckgutschein)` : mehrzweck ? `Mehrzweckgutschein${code}` : gutscheinText(voucher)}`, width: 7, align: 'left' },
1239
1270
  { text: `${formatCents(vz * wert)} ${index_js_1.VatRate.vat0.category}`, width: 5, align: 'right' },
1240
1271
  ],
1241
1272
  });
@@ -1315,8 +1346,10 @@ function buildReceiptLayout(receipt, company, options = {}) {
1315
1346
  // (Zahlungszeile laut Spec); eine Auszahlung ohne `zeroRateBucket`
1316
1347
  // (schreibt der Server nicht) zaehlt wie in receiptSumCents.
1317
1348
  const wert = voucher.valueCents ?? 0;
1318
- const endung = istMehrzweckMitCode(voucher) ? gutscheinEndung(voucher) : null;
1319
- const text = endung != null ? `Gutschein ····-${endung}` : gutscheinText(voucher);
1349
+ // Fremdgutschein: „Gutschein Nr. <Nummer>“, nie ein Rest (den Saldo kennt nur das fremde System).
1350
+ const fremd = fremdZeile(voucher);
1351
+ const endung = fremd == null && istMehrzweckMitCode(voucher) ? gutscheinEndung(voucher) : null;
1352
+ const text = fremd ?? (endung != null ? `Gutschein ····-${endung}` : gutscheinText(voucher));
1320
1353
  lines.push(paarZeile(voucher.action === index_js_1.VoucherAction.payout ? `Auszahlung ${text}` : text, wgVz === 1 ? `-${formatCents(wert)} €` : `${formatCents(wert)} €`, 8, 4));
1321
1354
  if (endung != null && wgVz === 1 && Number.isInteger(voucher.balanceAfterCents)) {
1322
1355
  lines.push(paarZeile(' Rest am Gutschein', `${formatCents(voucher.balanceAfterCents)} €`, 8, 4));
@@ -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));
@@ -161,6 +161,8 @@ const BELEG_GUTSCHEIN = {
161
161
  article: 'artikel', articleId: 'artikelId', quantity: 'stueck', positions: 'positionen',
162
162
  balanceAfterCents: 'saldoNachCents', remainingQuantityAfter: 'stueckOffenNach', taxedWith: 'versteuertMit', exempt: 'befreit',
163
163
  reason: 'grund', zeroRateBucket: 'imNullTopf', typeId: 'sorteId', typeName: 'sorteName', payout: 'auszahlung',
164
+ // Fremdgutschein: source external (GUTSCHEIN_QUELLE) und die Nummer des fremden Systems.
165
+ source: 'quelle', number: 'nummer',
164
166
  };
165
167
  const BELEG_GUTSCHEIN_AUSSEN = Object.fromEntries(Object.entries(BELEG_GUTSCHEIN).map(([aussen, innen]) => [innen, aussen]));
166
168
  const GUTSCHEIN_ARTIKEL_AUSSEN = { satzBp: 'vatRateBp', preisCents: 'priceCents' };
@@ -173,6 +175,7 @@ function gutscheinEintragNachAussen(v) {
173
175
  return v;
174
176
  const art = vokabular_js_1.KATALOGE.GUTSCHEIN_ART ?? {};
175
177
  const auszahlung = vokabular_js_1.KATALOGE.GUTSCHEIN_AUSZAHLUNG ?? {};
178
+ const quelle = vokabular_js_1.ZUSATZ_KATALOGE.GUTSCHEIN_QUELLE ?? {};
176
179
  const typNeu = typeof v.type === 'string' && (0, exports.hat)(art, v.type);
177
180
  if (!typNeu && !Object.keys(v).some((k) => (0, exports.hat)(BELEG_GUTSCHEIN_AUSSEN, k)))
178
181
  return v;
@@ -184,6 +187,8 @@ function gutscheinEintragNachAussen(v) {
184
187
  raus.voucherType = typeof w === 'string' && (0, exports.hat)(art, w) ? art[w] : w;
185
188
  else if (k === 'artikel')
186
189
  raus.article = (0, exports.istObjekt)(w) ? umbenannt(w, GUTSCHEIN_ARTIKEL_AUSSEN) : w;
190
+ else if (k === 'quelle')
191
+ raus.source = typeof w === 'string' && (0, exports.hat)(quelle, w) ? quelle[w] : w;
187
192
  else if (k === 'auszahlung')
188
193
  raus.payout = typeof w === 'string' && (0, exports.hat)(auszahlung, w) ? auszahlung[w] : w;
189
194
  else
@@ -308,6 +313,7 @@ function _storedArticleToWire(id, doc, functionName = 'fromStoredArticle') {
308
313
  const katalog = (pfad) => aeussereWerte(schema.werte[pfad]);
309
314
  const raus = nurBekannte(artikel, new Set(vokabular_js_1.ARTIKEL_FELDER), {
310
315
  quantityRule: katalog('articles[].quantityRule'), e1aGroup: katalog('articles[].e1aGroup'),
316
+ externalVoucher: katalog('articles[].externalVoucher'),
311
317
  });
312
318
  if ((0, exports.istObjekt)(raus.tile)) {
313
319
  const kachel = regel(regel(schema.data.articles).unter.tile).unter;