@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
@@ -1,7 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.asksRefundTip = exports.asksTipRefundSource = exports.cancellationCashRefundCents = exports.cancellationItemsForTip = exports.openStaffTipCents = exports.isTipRefundSource = exports.TIP_REFUND_SOURCES = exports.remainingQuantities = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptValueVoucherSign = exports.receiptSumCents = exports.receiptSubSumCents = exports.readRegistrationInfo = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherServerFields = exports.isNewFormVoucher = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isVoucherFloatItem = exports.isVoucherItem = exports.isDiscountItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = void 0;
4
- exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isManualReceiptErrorCode = exports.MANUAL_RECEIPT_ERROR_CODES = exports.readManualReceipt = exports.MANUAL_RECEIPT_REASONS = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.receiptOutputFieldErrors = exports.isReceiptOutputError = exports.receiptOutputErrorCode = exports.isReceiptOutputErrorCode = exports.RECEIPT_OUTPUT_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRY_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRIES_MAX = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_LOG_KINDS = exports.RECEIPT_OUTPUT_KINDS = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = void 0;
3
+ exports.fromReceiptPaymentPayload = exports.asksRefundTip = exports.asksTipRefundSource = exports.cancellationCashRefundCents = exports.cancellationItemsForTip = exports.openStaffTipCents = exports.isTipRefundSource = exports.TIP_REFUND_SOURCES = exports.remainingQuantities = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptValueVoucherSign = exports.receiptSumCents = exports.receiptSubSumCents = exports.readRegistrationInfo = exports.fromReceiptPayload = exports.toReceiptPayload = exports.EXTERNAL_VOUCHER_VAT_RATES_BP = exports.EXTERNAL_VOUCHER_TAXED_WITH_MAX = exports.EXTERNAL_VOUCHER_NUMBER_MAX = exports.OWN_VOUCHER_CODE_SHAPES = exports.ownVoucherCodeShape = exports.checkExternalVoucherNumber = exports.normalizeExternalVoucherNumber = exports.externalVoucherIsValid = exports.isExternalVoucher = exports.VOUCHER_SOURCES = exports.voucherServerFields = exports.isNewFormVoucher = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isVoucherFloatItem = exports.isVoucherItem = exports.isDiscountItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = void 0;
4
+ exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isManualReceiptErrorCode = exports.MANUAL_RECEIPT_ERROR_CODES = exports.readManualReceipt = exports.MANUAL_RECEIPT_REASONS = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.receiptOutputFieldErrors = exports.isReceiptOutputError = exports.receiptOutputErrorCode = exports.isReceiptOutputErrorCode = exports.RECEIPT_OUTPUT_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRY_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRIES_MAX = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_LOG_KINDS = exports.RECEIPT_OUTPUT_KINDS = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = void 0;
5
5
  var receipt_item_js_1 = require("./receipt-item.js");
6
6
  Object.defineProperty(exports, "toReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.toReceiptItemPayload; } });
7
7
  Object.defineProperty(exports, "fromReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.fromReceiptItemPayload; } });
@@ -18,6 +18,16 @@ Object.defineProperty(exports, "fromVoucherPayload", { enumerable: true, get: fu
18
18
  Object.defineProperty(exports, "voucherIsValid", { enumerable: true, get: function () { return voucher_js_1.voucherIsValid; } });
19
19
  Object.defineProperty(exports, "isNewFormVoucher", { enumerable: true, get: function () { return voucher_js_1.isNewFormVoucher; } });
20
20
  Object.defineProperty(exports, "voucherServerFields", { enumerable: true, get: function () { return voucher_js_1.voucherServerFields; } });
21
+ Object.defineProperty(exports, "VOUCHER_SOURCES", { enumerable: true, get: function () { return voucher_js_1.VOUCHER_SOURCES; } });
22
+ Object.defineProperty(exports, "isExternalVoucher", { enumerable: true, get: function () { return voucher_js_1.isExternalVoucher; } });
23
+ Object.defineProperty(exports, "externalVoucherIsValid", { enumerable: true, get: function () { return voucher_js_1.externalVoucherIsValid; } });
24
+ Object.defineProperty(exports, "normalizeExternalVoucherNumber", { enumerable: true, get: function () { return voucher_js_1.normalizeExternalVoucherNumber; } });
25
+ Object.defineProperty(exports, "checkExternalVoucherNumber", { enumerable: true, get: function () { return voucher_js_1.checkExternalVoucherNumber; } });
26
+ Object.defineProperty(exports, "ownVoucherCodeShape", { enumerable: true, get: function () { return voucher_js_1.ownVoucherCodeShape; } });
27
+ Object.defineProperty(exports, "OWN_VOUCHER_CODE_SHAPES", { enumerable: true, get: function () { return voucher_js_1.OWN_VOUCHER_CODE_SHAPES; } });
28
+ Object.defineProperty(exports, "EXTERNAL_VOUCHER_NUMBER_MAX", { enumerable: true, get: function () { return voucher_js_1.EXTERNAL_VOUCHER_NUMBER_MAX; } });
29
+ Object.defineProperty(exports, "EXTERNAL_VOUCHER_TAXED_WITH_MAX", { enumerable: true, get: function () { return voucher_js_1.EXTERNAL_VOUCHER_TAXED_WITH_MAX; } });
30
+ Object.defineProperty(exports, "EXTERNAL_VOUCHER_VAT_RATES_BP", { enumerable: true, get: function () { return voucher_js_1.EXTERNAL_VOUCHER_VAT_RATES_BP; } });
21
31
  var receipt_js_1 = require("./receipt.js");
22
32
  Object.defineProperty(exports, "toReceiptPayload", { enumerable: true, get: function () { return receipt_js_1.toReceiptPayload; } });
23
33
  Object.defineProperty(exports, "fromReceiptPayload", { enumerable: true, get: function () { return receipt_js_1.fromReceiptPayload; } });
@@ -12,7 +12,22 @@ import { VoucherAction, VoucherType } from '../enums/index.js';
12
12
  */
13
13
  export interface Voucher {
14
14
  name?: string;
15
+ /**
16
+ * Code eines eigenen Gutscheins (Einloesung, Auszahlung). Am gelesenen Eintrag die Maske. Ein Wunsch der
17
+ * Altform mit frei getipptem Code ist veraltet ([LegacyValueVoucherWish]).
18
+ */
15
19
  code?: string;
20
+ /**
21
+ * Fremdgutschein (Server 2026-11): `external` = Gutschein eines anderen Systems (Warenwirtschaft, Webshop) mit
22
+ * seiner Nummer in [number]. Kein Dokument bei Kasseneck, kein Saldo, keine Pruefung: Art, Satz und Betrag sagt
23
+ * der Betrieb. Fehlt bei eigenen Gutscheinen.
24
+ */
25
+ source?: VoucherSource | string;
26
+ /**
27
+ * Nummer des Fremdgutscheins (nur mit `source: 'external'`): nach [normalizeExternalVoucherNumber] 1 bis 40
28
+ * Zeichen aus `A–Z a–z 0–9 - _ . /`; ein eigener Gutscheincode ist keine Fremdnummer. Steht voll am Bon.
29
+ */
30
+ number?: string;
16
31
  action: VoucherAction | string;
17
32
  /**
18
33
  * Art des Gutscheins. Beim Verkauf ueber eine Sorte die Art der Sorte
@@ -119,6 +134,8 @@ export interface VoucherArticle {
119
134
  export interface VoucherPayload {
120
135
  name?: string | null;
121
136
  code?: string | null;
137
+ source?: string;
138
+ number?: string;
122
139
  action: string;
123
140
  type: string;
124
141
  value?: number | null;
@@ -142,16 +159,35 @@ export interface VoucherPayload {
142
159
  exempt?: boolean;
143
160
  zeroRateBucket?: boolean;
144
161
  }
162
+ /**
163
+ * Wunsch der Altform: Wertgutschein mit frei getipptem Code (`{ action, type: 'value', code, valueCents }`).
164
+ * Nur als Typ fuer Aufrufer, die ihn noch senden; ein gelesener Beleg ist davon nicht betroffen.
165
+ *
166
+ * @deprecated Server 2026-11: der Weg bleibt gueltig, die Antwort traegt `deprecation`
167
+ * ([ReceiptWithCompany.deprecation]). Der Code wird nicht geprueft, steuerlich ist das ein fremder
168
+ * Mehrzweckgutschein. Einen Gutschein eines anderen Systems als Fremdgutschein senden: `{ source: 'external',
169
+ * action, type: 'multi_purpose', number, amountCents }`; eigene Gutscheine ueber eine Sorte (`typeId`)
170
+ * verkaufen und mit ihrem Code einloesen.
171
+ */
172
+ export type LegacyValueVoucherWish = Voucher & {
173
+ type: 'value';
174
+ code: string;
175
+ };
145
176
  /** Arten der neuen Gutscheinform (die Altwerte sind `value` und `promo`). */
146
177
  export declare const NEUE_GUTSCHEINARTEN: readonly string[];
178
+ /** Herkunft eines Gutscheins: `external` = Fremdgutschein (Katalog `GUTSCHEIN_QUELLE`). */
179
+ export type VoucherSource = 'external';
180
+ export declare const VOUCHER_SOURCES: readonly VoucherSource[];
181
+ /** Fremdgutschein (`source: 'external'`)? Zwilling von `gutschein-beleg.istFremd`. */
182
+ export declare function isExternalVoucher(voucher: Pick<Voucher, 'source'>): boolean;
147
183
  /** Gehoert der Gutschein zur neuen Form (Art, Aktion `payout` oder Verkauf ueber eine Sorte ohne Art)? */
148
- export declare function isNewFormVoucher(voucher: Pick<Voucher, 'type' | 'action' | 'typeId'>): boolean;
184
+ export declare function isNewFormVoucher(voucher: Pick<Voucher, 'type' | 'action' | 'typeId'> & Pick<Voucher, 'source'>): boolean;
149
185
  /**
150
186
  * Wert-Verkauf: ein Mehrzweck- oder Einzweckgutschein wird verkauft (mit Art
151
187
  * oder nur ueber die Sorte). Paketintern: Zahlbetrag und Pruefung vor dem
152
188
  * Senden entscheiden daran, ob eine Sorte noetig ist.
153
189
  */
154
- export declare function istWertVerkauf(voucher: Pick<Voucher, 'type' | 'action' | 'typeId'>): boolean;
190
+ export declare function istWertVerkauf(voucher: Pick<Voucher, 'type' | 'action' | 'typeId'> & Pick<Voucher, 'source'>): boolean;
155
191
  /**
156
192
  * Felder, die nur der Server setzt; an einem Wunsch sind sie `voucher_invalid`.
157
193
  * Sortenname und Auszahlung friert der Server beim Verkauf ein (Stufe 4b).
@@ -175,3 +211,61 @@ export declare function fromVoucherPayload(payload: VoucherPayload): Voucher;
175
211
  * Stufe 4b antwortet darauf `voucher_type_required`). Paketintern.
176
212
  */
177
213
  export declare function wunschFormGueltig(v: Voucher, sorteNoetig: boolean): boolean;
214
+ /** Hoechstlaenge der Nummer eines Fremdgutscheins (nach dem Abschneiden des Rands). */
215
+ export declare const EXTERNAL_VOUCHER_NUMBER_MAX = 40;
216
+ /** Hoechstlaenge von `taxedWith` (Vermerk, mit welchem Beleg im fremden System der Einzweckgutschein versteuert ist). */
217
+ export declare const EXTERNAL_VOUCHER_TAXED_WITH_MAX = 40;
218
+ /**
219
+ * Saetze, mit denen ein fremder Einzweckgutschein verkauft sein kann (Basispunkte): die Saetze der Kasse
220
+ * (20, 10, 13, 19, 4,9 %) und 0 = befreit verkauft (Kleinunternehmer).
221
+ */
222
+ export declare const EXTERNAL_VOUCHER_VAT_RATES_BP: readonly number[];
223
+ /**
224
+ * Nummer eines Fremdgutscheins in der Form, mit der der Server sie speichert und druckt
225
+ * (`gutschein-core.normiereFremdnummer`): Rand weg, **keine** Unicode-Normalisierung, Gross-/Kleinschreibung
226
+ * bleibt; dann 1 bis 40 Zeichen aus `A–Z a–z 0–9 - _ . /`. Sonst `null` (`external_voucher_number_invalid`).
227
+ * Einen eigenen Gutscheincode erkennt erst [checkExternalVoucherNumber].
228
+ */
229
+ export declare function normalizeExternalVoucherNumber(text: unknown): string | null;
230
+ /** Ergebnis von [checkExternalVoucherNumber]: die Nummer wie gespeichert, oder der Fehlercode des Servers. */
231
+ export type ExternalVoucherNumberCheck = {
232
+ ok: true;
233
+ number: string;
234
+ } | {
235
+ ok: false;
236
+ code: 'external_voucher_number_is_own_code' | 'external_voucher_number_invalid';
237
+ };
238
+ /**
239
+ * Prueft eine Fremdnummer in der Reihenfolge des Servers (`gutschein-beleg.pruefeFremd`): zuerst, ob sie ein
240
+ * gueltiger eigener Gutscheincode ist (12 Zeichen mit Pruefzeichen, in jeder Schreibweise der Kasse, auch mit `.`, `_`
241
+ * oder `/` als Trenner) – dann
242
+ * `external_voucher_number_is_own_code`, der Gutschein gehoert als eigener eingeloest –, danach die Form.
243
+ */
244
+ export declare function checkExternalVoucherNumber(text: unknown): ExternalVoucherNumberCheck;
245
+ /**
246
+ * Wie sehr eine Eingabe einem eigenen Gutscheincode gleicht ([ownVoucherCodeShape]): `valid` = gueltiger eigener
247
+ * Code; `checksum` = 12 Zeichen des Code-Alphabets mit falschem Pruefzeichen (z. B. eine zwoelfstellige
248
+ * Webshop-Nummer); `length` = Muster `4-4-x` mit echten Bindestrichen `-` (nie `.`, `_`, `/`), aber nicht 12 Zeichen;
249
+ * `none` = keine Aehnlichkeit.
250
+ */
251
+ export type OwnVoucherCodeShape = 'valid' | 'checksum' | 'length' | 'none';
252
+ export declare const OWN_VOUCHER_CODE_SHAPES: readonly OwnVoucherCodeShape[];
253
+ /**
254
+ * Form-Erkennung eigener Codes fuer das Feld „Code eingeben oder scannen“ (Web-Kasse und Kassen-App gleich):
255
+ * `valid` laeuft als eigener Gutschein, `checksum`/`length` fragt die Kasse nach („Sieht aus wie ein
256
+ * Kasseneck-Code, ist aber keiner. Als fremden Gutschein verwenden?“, `external_voucher.looks_like_own_code`),
257
+ * `none` geht bei Freigabe direkt in das Blatt „Fremder Gutschein“. Gelesen wie [checkExternalVoucherNumber]:
258
+ * Rand weg, `.`, `_`, `/` wie `-`, dann die Normalisierung von `VoucherCode` (gross, ohne Leerraum und `-`,
259
+ * O → 0, I/L → 1); `length` nur mit echten Bindestrichen. Eine Nachfrage weist nichts ab: der Server prueft die Fremdnummer selbst
260
+ * (`external_voucher_number_is_own_code` nur bei `valid`).
261
+ */
262
+ export declare function ownVoucherCodeShape(text: unknown): OwnVoucherCodeShape;
263
+ /**
264
+ * Ist der Fremdgutschein sendbar? Die Form wie `gutschein-beleg.pruefeFremd` (ohne die Freigabe des Kontos, die
265
+ * kennt nur der Server bzw. `PosVoucherSettings.externalVouchers`): Aktion `sell`/`redeem`/`payout`, Art
266
+ * `multi_purpose`/`single_purpose`, gueltige Nummer (kein eigener Code), Betrag 1 bis 1.000.000 Cent; Einzweck mit
267
+ * einem Satz aus [EXTERNAL_VOUCHER_VAT_RATES_BP], Mehrzweck ohne; `taxedWith` nur bei Einzweck-Einloesung bzw.
268
+ * -Auszahlung (1 bis 40 Zeichen ohne Steuerzeichen); Auszahlung mit Grund (1 bis 200 Zeichen). Felder eigener
269
+ * Gutscheine (Code, Sorte, Artikel, Menge, Positionen) und Serverfelder nie.
270
+ */
271
+ export declare function externalVoucherIsValid(voucher: Voucher): boolean;
@@ -1,6 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.GUTSCHEIN_SERVERFELDER = exports.NEUE_GUTSCHEINARTEN = void 0;
3
+ exports.OWN_VOUCHER_CODE_SHAPES = exports.EXTERNAL_VOUCHER_VAT_RATES_BP = exports.EXTERNAL_VOUCHER_TAXED_WITH_MAX = exports.EXTERNAL_VOUCHER_NUMBER_MAX = exports.GUTSCHEIN_SERVERFELDER = exports.VOUCHER_SOURCES = exports.NEUE_GUTSCHEINARTEN = void 0;
4
+ exports.isExternalVoucher = isExternalVoucher;
4
5
  exports.isNewFormVoucher = isNewFormVoucher;
5
6
  exports.istWertVerkauf = istWertVerkauf;
6
7
  exports.voucherServerFields = voucherServerFields;
@@ -8,7 +9,12 @@ exports.toVoucherPayload = toVoucherPayload;
8
9
  exports.voucherIsValid = voucherIsValid;
9
10
  exports.fromVoucherPayload = fromVoucherPayload;
10
11
  exports.wunschFormGueltig = wunschFormGueltig;
12
+ exports.normalizeExternalVoucherNumber = normalizeExternalVoucherNumber;
13
+ exports.checkExternalVoucherNumber = checkExternalVoucherNumber;
14
+ exports.ownVoucherCodeShape = ownVoucherCodeShape;
15
+ exports.externalVoucherIsValid = externalVoucherIsValid;
11
16
  const index_js_1 = require("../enums/index.js");
17
+ const validator_1 = require("@kreiseck/validator");
12
18
  const money_js_1 = require("../money.js");
13
19
  const enum_payload_js_1 = require("./enum-payload.js");
14
20
  /** Arten der neuen Gutscheinform (die Altwerte sind `value` und `promo`). */
@@ -18,6 +24,11 @@ exports.NEUE_GUTSCHEINARTEN = [
18
24
  index_js_1.VoucherType.service,
19
25
  index_js_1.VoucherType.promotion,
20
26
  ];
27
+ exports.VOUCHER_SOURCES = Object.freeze(['external']);
28
+ /** Fremdgutschein (`source: 'external'`)? Zwilling von `gutschein-beleg.istFremd`. */
29
+ function isExternalVoucher(voucher) {
30
+ return voucher.source === 'external';
31
+ }
21
32
  /**
22
33
  * Verkauf ueber eine Sorte ohne Art (`typeId` ohne `type`): die Art kommt aus
23
34
  * der Sorte. Zwilling von `gutschein-beleg.istSortenVerkauf`.
@@ -27,7 +38,8 @@ function istSortenVerkaufOhneArt(voucher) {
27
38
  }
28
39
  /** Gehoert der Gutschein zur neuen Form (Art, Aktion `payout` oder Verkauf ueber eine Sorte ohne Art)? */
29
40
  function isNewFormVoucher(voucher) {
30
- return exports.NEUE_GUTSCHEINARTEN.includes(voucher.type) || voucher.action === index_js_1.VoucherAction.payout || istSortenVerkaufOhneArt(voucher);
41
+ return exports.NEUE_GUTSCHEINARTEN.includes(voucher.type) || voucher.action === index_js_1.VoucherAction.payout || istSortenVerkaufOhneArt(voucher)
42
+ || isExternalVoucher(voucher);
31
43
  }
32
44
  /**
33
45
  * Wert-Verkauf: ein Mehrzweck- oder Einzweckgutschein wird verkauft (mit Art
@@ -35,7 +47,7 @@ function isNewFormVoucher(voucher) {
35
47
  * Senden entscheiden daran, ob eine Sorte noetig ist.
36
48
  */
37
49
  function istWertVerkauf(voucher) {
38
- return voucher.action === index_js_1.VoucherAction.sell
50
+ return !isExternalVoucher(voucher) && voucher.action === index_js_1.VoucherAction.sell
39
51
  && (voucher.type === index_js_1.VoucherType.multi_purpose || voucher.type === index_js_1.VoucherType.single_purpose || istSortenVerkaufOhneArt(voucher));
40
52
  }
41
53
  /**
@@ -48,7 +60,7 @@ function voucherServerFields(voucher) {
48
60
  return exports.GUTSCHEIN_SERVERFELDER.filter((feld) => voucher[feld] != null);
49
61
  }
50
62
  const NEUE_FELDER = [
51
- 'amountCents', 'articleId', 'quantity', 'positions', 'reason', 'typeId', 'typeName', 'payout', 'voucherType', 'voucherId', 'codeSuffix',
63
+ 'source', 'number', 'amountCents', 'articleId', 'quantity', 'positions', 'reason', 'typeId', 'typeName', 'payout', 'voucherType', 'voucherId', 'codeSuffix',
52
64
  'vatRateBp', 'article', 'balanceAfterCents', 'remainingQuantityAfter', 'taxedWith', 'exempt', 'zeroRateBucket', 'fromReturn',
53
65
  ];
54
66
  function toVoucherPayload(voucher) {
@@ -81,6 +93,8 @@ function toVoucherPayload(voucher) {
81
93
  * gesetzter Wert muss positiv sein.
82
94
  */
83
95
  function voucherIsValid(voucher) {
96
+ if (isExternalVoucher(voucher))
97
+ return externalVoucherIsValid(voucher);
84
98
  if (isNewFormVoucher(voucher))
85
99
  return newFormVoucherIsValid(voucher);
86
100
  if (voucher.type === index_js_1.VoucherType.value && voucher.valueCents == null) {
@@ -170,13 +184,21 @@ function newFormVoucherIsValid(v) {
170
184
  * Stufe 4b antwortet darauf `voucher_type_required`). Paketintern.
171
185
  */
172
186
  function wunschFormGueltig(v, sorteNoetig) {
187
+ if (isExternalVoucher(v))
188
+ return externalVoucherIsValid(v);
173
189
  if (voucherServerFields(v).length > 0)
174
190
  return false;
175
191
  const r = v;
176
- for (const feld of ['vatRateBp', 'article', 'balanceAfterCents', 'remainingQuantityAfter', 'taxedWith', 'exempt']) {
192
+ for (const feld of ['article', 'balanceAfterCents', 'remainingQuantityAfter', 'exempt']) {
177
193
  if (r[feld] != null)
178
194
  return false;
179
195
  }
196
+ // Felder nur des Fremdgutscheins (gutschein-beleg.NUR_BEI_FREMD): der Server weist sie an einem eigenen Wunsch
197
+ // schon gesendet ab, auch als `null` (`voucher_invalid`); eine andere Herkunft als `external` gibt es nicht.
198
+ for (const feld of ['number', 'taxedWith', 'vatRateBp', 'source']) {
199
+ if (r[feld] !== undefined)
200
+ return false;
201
+ }
180
202
  if (v.valueCents != null)
181
203
  return false;
182
204
  // Die Sorte gehoert nur an einen Wert-Verkauf (Server: sorteId sonst voucher_invalid).
@@ -220,3 +242,134 @@ function wunschFormGueltig(v, sorteNoetig) {
220
242
  // Altart mit neuer Aktion (payout + value/promo): nicht sendbar.
221
243
  return false;
222
244
  }
245
+ // ---- Fremdgutscheine (Server 2026-11) -------------------------------------------
246
+ /**
247
+ * Rand einer Fremdnummer (Zwilling von `gutschein-core.FREMD_RAND`): ASCII-Leerraum und die Unicode-Leerzeichen,
248
+ * die beim Kopieren aus Fremdsystemen mitkommen. Bewusst ohne U+0085 (NEL): ein Steuerzeichen, das nie still
249
+ * verschwindet, sondern die Nummer ungueltig macht.
250
+ */
251
+ const FREMD_RAND = '\\t\\n\\v\\f\\r \\u00A0\\u1680\\u2000-\\u200A\\u2028\\u2029\\u202F\\u205F\\u3000\\uFEFF';
252
+ const FREMD_RAND_MUSTER = new RegExp(`^[${FREMD_RAND}]+|[${FREMD_RAND}]+$`, 'g');
253
+ const FREMD_NUMMER_MUSTER = /^[A-Za-z0-9\-_./]{1,40}$/;
254
+ /** Hoechstlaenge der Nummer eines Fremdgutscheins (nach dem Abschneiden des Rands). */
255
+ exports.EXTERNAL_VOUCHER_NUMBER_MAX = 40;
256
+ /** Hoechstlaenge von `taxedWith` (Vermerk, mit welchem Beleg im fremden System der Einzweckgutschein versteuert ist). */
257
+ exports.EXTERNAL_VOUCHER_TAXED_WITH_MAX = 40;
258
+ /**
259
+ * Saetze, mit denen ein fremder Einzweckgutschein verkauft sein kann (Basispunkte): die Saetze der Kasse
260
+ * (20, 10, 13, 19, 4,9 %) und 0 = befreit verkauft (Kleinunternehmer).
261
+ */
262
+ exports.EXTERNAL_VOUCHER_VAT_RATES_BP = Object.freeze([2000, 1000, 1300, 1900, 490, 0]);
263
+ /**
264
+ * Nummer eines Fremdgutscheins in der Form, mit der der Server sie speichert und druckt
265
+ * (`gutschein-core.normiereFremdnummer`): Rand weg, **keine** Unicode-Normalisierung, Gross-/Kleinschreibung
266
+ * bleibt; dann 1 bis 40 Zeichen aus `A–Z a–z 0–9 - _ . /`. Sonst `null` (`external_voucher_number_invalid`).
267
+ * Einen eigenen Gutscheincode erkennt erst [checkExternalVoucherNumber].
268
+ */
269
+ function normalizeExternalVoucherNumber(text) {
270
+ if (typeof text !== 'string')
271
+ return null;
272
+ const n = text.replace(FREMD_RAND_MUSTER, '');
273
+ return FREMD_NUMMER_MUSTER.test(n) ? n : null;
274
+ }
275
+ /**
276
+ * Prueft eine Fremdnummer in der Reihenfolge des Servers (`gutschein-beleg.pruefeFremd`): zuerst, ob sie ein
277
+ * gueltiger eigener Gutscheincode ist (12 Zeichen mit Pruefzeichen, in jeder Schreibweise der Kasse, auch mit `.`, `_`
278
+ * oder `/` als Trenner) – dann
279
+ * `external_voucher_number_is_own_code`, der Gutschein gehoert als eigener eingeloest –, danach die Form.
280
+ */
281
+ function checkExternalVoucherNumber(text) {
282
+ // `.`, `_` und `/` zwischen den Gruppen liest die Pruefung wie `-` (Zwilling von `gutschein-core.istEigenerCode`):
283
+ // `7148.FGQA.935K` ist der eigene Code. Die Nummer selbst bleibt, wie sie kam.
284
+ if (typeof text === 'string' && validator_1.VoucherCode.validate(text.replace(/[._/]/g, '-')).ok)
285
+ return { ok: false, code: 'external_voucher_number_is_own_code' };
286
+ const number = normalizeExternalVoucherNumber(text);
287
+ return number === null ? { ok: false, code: 'external_voucher_number_invalid' } : { ok: true, number };
288
+ }
289
+ exports.OWN_VOUCHER_CODE_SHAPES = Object.freeze(['valid', 'checksum', 'length', 'none']);
290
+ /** Alphabet der eigenen Codes (Crockford-Base32 ohne U), nach der Normalisierung von `VoucherCode`. */
291
+ const CODE_ALPHABET = /^[0-9A-HJKMNP-TV-Z]+$/;
292
+ const CODE_GRUPPEN = /^[0-9A-Za-z]{4}-[0-9A-Za-z]{4}-[0-9A-Za-z]+$/;
293
+ /**
294
+ * Form-Erkennung eigener Codes fuer das Feld „Code eingeben oder scannen“ (Web-Kasse und Kassen-App gleich):
295
+ * `valid` laeuft als eigener Gutschein, `checksum`/`length` fragt die Kasse nach („Sieht aus wie ein
296
+ * Kasseneck-Code, ist aber keiner. Als fremden Gutschein verwenden?“, `external_voucher.looks_like_own_code`),
297
+ * `none` geht bei Freigabe direkt in das Blatt „Fremder Gutschein“. Gelesen wie [checkExternalVoucherNumber]:
298
+ * Rand weg, `.`, `_`, `/` wie `-`, dann die Normalisierung von `VoucherCode` (gross, ohne Leerraum und `-`,
299
+ * O → 0, I/L → 1); `length` nur mit echten Bindestrichen. Eine Nachfrage weist nichts ab: der Server prueft die Fremdnummer selbst
300
+ * (`external_voucher_number_is_own_code` nur bei `valid`).
301
+ */
302
+ function ownVoucherCodeShape(text) {
303
+ if (typeof text !== 'string')
304
+ return 'none';
305
+ const roh = text.replace(FREMD_RAND_MUSTER, '');
306
+ const t = roh.replace(/[._/]/g, '-');
307
+ if (t === '')
308
+ return 'none';
309
+ if (validator_1.VoucherCode.validate(t).ok)
310
+ return 'valid';
311
+ const s = t.toUpperCase().replace(/[\s-]/g, '').replace(/O/g, '0').replace(/[IL]/g, '1');
312
+ if (!CODE_ALPHABET.test(s))
313
+ return 'none';
314
+ if (s.length === 12)
315
+ return 'checksum';
316
+ // Falsche Laenge nur mit echten Bindestrichen: eigene Codes stehen immer so da, `WEIN.2026/7` ist keiner.
317
+ return CODE_GRUPPEN.test(roh) ? 'length' : 'none';
318
+ }
319
+ /** Steuer- und Formatzeichen (`gutschein-core.STEUERZEICHEN`): nie in `taxedWith`. */
320
+ const STEUERZEICHEN = /[\p{Cc}\p{Cf}]/u;
321
+ /**
322
+ * Ist der Fremdgutschein sendbar? Die Form wie `gutschein-beleg.pruefeFremd` (ohne die Freigabe des Kontos, die
323
+ * kennt nur der Server bzw. `PosVoucherSettings.externalVouchers`): Aktion `sell`/`redeem`/`payout`, Art
324
+ * `multi_purpose`/`single_purpose`, gueltige Nummer (kein eigener Code), Betrag 1 bis 1.000.000 Cent; Einzweck mit
325
+ * einem Satz aus [EXTERNAL_VOUCHER_VAT_RATES_BP], Mehrzweck ohne; `taxedWith` nur bei Einzweck-Einloesung bzw.
326
+ * -Auszahlung (1 bis 40 Zeichen ohne Steuerzeichen); Auszahlung mit Grund (1 bis 200 Zeichen). Felder eigener
327
+ * Gutscheine (Code, Sorte, Artikel, Menge, Positionen) und Serverfelder nie.
328
+ */
329
+ function externalVoucherIsValid(voucher) {
330
+ const v = voucher;
331
+ if (!isExternalVoucher(v))
332
+ return false;
333
+ if (voucherServerFields(v).length > 0)
334
+ return false;
335
+ const r = v;
336
+ // gutschein-beleg.NICHT_BEI_FREMD (gesendet heisst voucher_invalid, auch als null).
337
+ for (const feld of ['code', 'typeId', 'articleId', 'article', 'quantity', 'positions']) {
338
+ if (r[feld] !== undefined)
339
+ return false;
340
+ }
341
+ for (const feld of ['balanceAfterCents', 'remainingQuantityAfter', 'exempt']) {
342
+ if (r[feld] != null)
343
+ return false;
344
+ }
345
+ if (v.valueCents != null)
346
+ return false;
347
+ if (v.action !== index_js_1.VoucherAction.sell && v.action !== index_js_1.VoucherAction.redeem && v.action !== index_js_1.VoucherAction.payout)
348
+ return false;
349
+ if (v.type !== index_js_1.VoucherType.multi_purpose && v.type !== index_js_1.VoucherType.single_purpose)
350
+ return false;
351
+ if (!checkExternalVoucherNumber(v.number).ok)
352
+ return false;
353
+ if (!istCent(v.amountCents))
354
+ return false;
355
+ if (v.type === index_js_1.VoucherType.single_purpose) {
356
+ if (!(typeof v.vatRateBp === 'number' && exports.EXTERNAL_VOUCHER_VAT_RATES_BP.includes(v.vatRateBp)))
357
+ return false;
358
+ }
359
+ else if (v.vatRateBp != null) {
360
+ return false;
361
+ }
362
+ if (v.taxedWith != null) {
363
+ if (v.type !== index_js_1.VoucherType.single_purpose || v.action === index_js_1.VoucherAction.sell)
364
+ return false;
365
+ const t = typeof v.taxedWith === 'string' ? v.taxedWith.trim() : '';
366
+ if (t.length < 1 || t.length > exports.EXTERNAL_VOUCHER_TAXED_WITH_MAX || STEUERZEICHEN.test(t))
367
+ return false;
368
+ }
369
+ if (v.action === index_js_1.VoucherAction.payout) {
370
+ const g = typeof v.reason === 'string' ? v.reason.trim() : '';
371
+ if (g.length < 1 || g.length > MAX_GRUND)
372
+ return false;
373
+ }
374
+ return true;
375
+ }
@@ -1,5 +1,6 @@
1
1
  import type { InternerTransport } from '../client/aufrufe.js';
2
2
  import { type PosReference } from './kachel-referenz.js';
3
+ import { type ArticleExternalVoucher } from './fremdgutschein-artikel.js';
3
4
  /**
4
5
  * Artikelgruppen (Kategorien der Kachel-Kasse) und Artikel in der Form, die
5
6
  * die Kacheln brauchen, Backend: `article-endpoints.js`
@@ -121,6 +122,16 @@ export interface PosArticle {
121
122
  * immer; wirksam wird es ueber [addOnsFor].
122
123
  */
123
124
  addOns?: string[] | null;
125
+ /**
126
+ * Kachel verkauft einen fremden Gutschein (1.31.0): `multi_purpose` =
127
+ * Wertgutschein, `single_purpose` = Leistungsgutschein mit dem Satz des
128
+ * Artikels; null = normaler Artikel. Die Kasse fragt die Gutscheinnummer ab
129
+ * und sendet einen `vouchers[]`-Eintrag statt einer Position; sperren ueber
130
+ * [externalVoucherTileBlock]. Vor `stockTracked` werten (ein Fremdgutschein
131
+ * fuehrt nie Bestand). Optional wie `addOns`, der Leser setzt es immer; ein
132
+ * unbekannter Wert wird null.
133
+ */
134
+ externalVoucher?: ArticleExternalVoucher | null;
124
135
  }
125
136
  /**
126
137
  * Kann die Kachel gebucht werden? Mit festem Preis immer, ohne Preis nur mit
@@ -161,6 +172,7 @@ export interface PosArticlePayload {
161
172
  askPrice?: boolean | null;
162
173
  reference?: unknown;
163
174
  addOns?: unknown;
175
+ externalVoucher?: unknown;
164
176
  }
165
177
  export declare function fromPosArticlePayload(p: PosArticlePayload): PosArticle;
166
178
  /**
@@ -14,6 +14,7 @@ exports.listMyArticleGroups = listMyArticleGroups;
14
14
  exports.listMyArticles = listMyArticles;
15
15
  const errors_js_1 = require("../client/errors.js");
16
16
  const kachel_referenz_js_1 = require("./kachel-referenz.js");
17
+ const fremdgutschein_artikel_js_1 = require("./fremdgutschein-artikel.js");
17
18
  /** Zusatzliste am Draht: nur eine Liste von Texten zaehlt, sonst null. Paketintern. */
18
19
  function addOnListe(wert) {
19
20
  return Array.isArray(wert) ? wert.filter((s) => typeof s === 'string' && s !== '') : null;
@@ -106,6 +107,7 @@ function fromPosArticlePayload(p) {
106
107
  askPrice: p.askPrice === true,
107
108
  reference: (0, kachel_referenz_js_1.fromReferencePayload)(p.reference),
108
109
  addOns: addOnListe(p.addOns),
110
+ externalVoucher: (0, fremdgutschein_artikel_js_1.isArticleExternalVoucher)(p.externalVoucher) ? p.externalVoucher : null,
109
111
  };
110
112
  }
111
113
  /**
@@ -7,6 +7,7 @@ exports.setMyRegisterDeviceSettings = setMyRegisterDeviceSettings;
7
7
  exports.setMyPosLogo = setMyPosLogo;
8
8
  const errors_js_1 = require("../client/errors.js");
9
9
  const gutschein_js_1 = require("./gutschein.js");
10
+ const rabatt_vorlagen_js_1 = require("./rabatt-vorlagen.js");
10
11
  const settings_js_1 = require("./settings.js");
11
12
  /*
12
13
  * Die Einstellungs-Aufrufe am Draht `/api/v3`: Parameter und Antwort heissen
@@ -151,6 +152,16 @@ function pruefeTeil(name, teil, block, standard, werte) {
151
152
  throw new errors_js_1.KasseneckValidationError(name, `${teil}.${schluessel}: true oder false erwartet`, 'request');
152
153
  continue;
153
154
  }
155
+ // Rabatt-Vorlagen: dieselbe Pruefung wie am Server, der erste Fehler mit Vorlage, Feld und Satz.
156
+ if (teil === 'business' && settings_js_1.POS_BUSINESS_OPTIONAL_LISTS.includes(schluessel)) {
157
+ const geprueft = (0, rabatt_vorlagen_js_1.checkDiscountPresets)(wert);
158
+ if (!geprueft.ok) {
159
+ const f = geprueft.errors[0];
160
+ const ort = `${teil}.${schluessel}${f.index === null ? '' : `[${f.index}]`}${f.field === null ? '' : `.${f.field}`}`;
161
+ throw new errors_js_1.KasseneckValidationError(name, `${ort}: ${f.message} (${rabatt_vorlagen_js_1.INVALID_DISCOUNT_PRESET})`, 'request');
162
+ }
163
+ continue;
164
+ }
154
165
  const wahl = teil === 'business' ? settings_js_1.POS_BUSINESS_OPTIONAL_CHOICES : settings_js_1.POS_DEVICE_OPTIONAL_CHOICES;
155
166
  if (!Object.prototype.hasOwnProperty.call(standard, schluessel) && !wahl.includes(schluessel)) {
156
167
  throw new errors_js_1.KasseneckValidationError(name, `${teil}.${schluessel}: unbekanntes Feld`, 'request');
@@ -21,7 +21,7 @@ import { KasseneckApiError } from '../client/errors.js';
21
21
  * ueber `KasseneckApiError.code` lesbar; die Kasse braucht dafuer einen
22
22
  * Rueckfallzweig.
23
23
  */
24
- export declare const POS_ERROR_CODES: readonly ["account_not_found", "action_confirmation_required", "admin_required", "after_count_not_permitted", "api_not_approved", "app_check_invalid", "app_check_missing", "article_not_found", "article_not_in_scope", "article_not_tracked", "cash_movement_exceeds_balance", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "comment_required", "count_already_voided", "count_not_found", "device_not_found", "dialect_mismatch", "drawer_inactive", "drawer_not_found", "idempotency_conflict", "idempotency_key_required", "internal_translation_error", "invalid_amount", "invalid_cursor", "invalid_denominations", "invalid_movement_type", "invalid_quantity", "invalid_serial", "live_not_enabled", "location_inactive", "location_not_found", "logo_invalid", "logo_invalid_type", "logo_too_large", "method_not_allowed", "mfa_required", "module_inactive", "not_found", "not_permitted", "note_required", "password_change_required", "print_job_not_found", "print_layout_failed", "printer_not_found", "recount_exhausted", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "second_factor_required", "serial_already_counted", "serial_not_allowed", "serial_required", "server_error", "session_expired", "session_other_cashregister", "shift_already_open", "shift_closed", "shift_mode_off", "shift_not_open", "stocktake_closed", "stocktake_closing", "stocktake_not_found", "stocktake_not_open", "tip_payout_exceeds_claim", "too_many_counts", "transfer_same_drawer", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
24
+ export declare const POS_ERROR_CODES: readonly ["account_not_found", "action_confirmation_required", "admin_required", "after_count_not_permitted", "api_not_approved", "app_check_invalid", "app_check_missing", "article_not_found", "article_not_in_scope", "article_not_tracked", "cash_movement_exceeds_balance", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "comment_required", "count_already_voided", "count_not_found", "device_not_found", "dialect_mismatch", "drawer_inactive", "drawer_not_found", "idempotency_conflict", "idempotency_key_required", "internal_translation_error", "invalid_amount", "invalid_cursor", "invalid_denominations", "invalid_discount_preset", "invalid_movement_type", "invalid_quantity", "invalid_serial", "live_not_enabled", "location_inactive", "location_not_found", "logo_invalid", "logo_invalid_type", "logo_too_large", "method_not_allowed", "mfa_required", "module_inactive", "not_found", "not_permitted", "note_required", "password_change_required", "print_job_not_found", "print_layout_failed", "printer_not_found", "recount_exhausted", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "second_factor_required", "serial_already_counted", "serial_not_allowed", "serial_required", "server_error", "session_expired", "session_other_cashregister", "shift_already_open", "shift_closed", "shift_mode_off", "shift_not_open", "stocktake_closed", "stocktake_closing", "stocktake_not_found", "stocktake_not_open", "tip_payout_exceeds_claim", "too_many_counts", "transfer_same_drawer", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
25
25
  export type PosErrorCode = typeof POS_ERROR_CODES[number];
26
26
  export declare function isPosErrorCode(value: unknown): value is PosErrorCode;
27
27
  /** Der Code eines geworfenen Fehlers, wenn er in [POS_ERROR_CODES] steht; sonst `undefined`. */
@@ -57,6 +57,7 @@ exports.POS_ERROR_CODES = Object.freeze([
57
57
  'invalid_amount',
58
58
  'invalid_cursor',
59
59
  'invalid_denominations',
60
+ 'invalid_discount_preset',
60
61
  'invalid_movement_type',
61
62
  'invalid_quantity',
62
63
  'invalid_serial',
@@ -0,0 +1,66 @@
1
+ import type { PosExternalVouchers } from './gutschein.js';
2
+ /**
3
+ * Artikel als fremder Gutschein (Fremdgutscheine an der Kasse, 1.31.0): der
4
+ * Chef legt einen Artikel als Kachel „fremder Gutschein“ an. Die Kasse fragt
5
+ * beim Antippen die Gutscheinnummer (und ohne Preis den Betrag) ab und sendet
6
+ * statt einer Position einen `vouchers[]`-Eintrag
7
+ * `{ source: 'external', action: 'sell', type: externalVoucher, number, amountCents, vatRateBp? }`.
8
+ *
9
+ * Die Regeln am Artikel rechnet das Backend (`functions-kasse/fremdgutschein-artikel-core.js`)
10
+ * beim Speichern (`createMyArticle`/`updateMyArticle`, Code `article_external_voucher_invalid`
11
+ * mit `data.grund`); der Artikel-Editor des Kundenbereichs prueft vorher gleich. Vertrag sind
12
+ * die Pruefaelle `fixtures/external-voucher-article-cases.json` (byte-gleich mit dem Backend).
13
+ */
14
+ /** Art des fremden Gutscheins am Artikel (`/v3` `externalVoucher`, gespeichert `fremdgutschein`). */
15
+ export type ArticleExternalVoucher = 'multi_purpose' | 'single_purpose';
16
+ export declare const ARTICLE_EXTERNAL_VOUCHER_TYPES: readonly ArticleExternalVoucher[];
17
+ /** Fehlercode beim Speichern eines Artikels, intern und unter `/v3` gleich. */
18
+ export declare const ARTICLE_EXTERNAL_VOUCHER_INVALID = "article_external_voucher_invalid";
19
+ /** Welche Regel verletzt ist (Antwortfeld `data.grund`), in der Reihenfolge, in der der Server prueft. */
20
+ export declare const EXTERNAL_VOUCHER_ARTICLE_REASONS: readonly ["invalid_type", "service_voucher", "add_ons", "stock_tracked", "reference", "asks_quantity", "rate_required", "invalid_rate", "price_required"];
21
+ export type ExternalVoucherArticleReason = typeof EXTERNAL_VOUCHER_ARTICLE_REASONS[number];
22
+ /**
23
+ * Ein Artikel im Editor (`/v3`-Form), soweit die Regeln ihn lesen. Bewusst
24
+ * `unknown` beim Wert: der Editor prueft auch, was nicht in den Typ passt.
25
+ */
26
+ export interface ExternalVoucherArticleInput {
27
+ externalVoucher?: unknown;
28
+ unitPriceCents?: number | null;
29
+ vatRate?: number | null;
30
+ askPrice?: boolean | null;
31
+ serviceVoucher?: boolean | null;
32
+ addOns?: readonly unknown[] | null;
33
+ stockTracked?: boolean | null;
34
+ reference?: unknown;
35
+ askQuantity?: boolean | null;
36
+ }
37
+ /**
38
+ * Saetze, mit denen ein Einzweckgutschein verkauft werden kann (Prozent wie
39
+ * `PosArticle.vatRate`; 0 = befreit verkauft): die Saetze der Kasse, Backend
40
+ * `article-groups-core.STEUERSAETZE`, dieselben wie [EXTERNAL_VOUCHER_VAT_RATES_BP] / 100.
41
+ */
42
+ export declare const ARTICLE_EXTERNAL_VOUCHER_VAT_RATES: readonly number[];
43
+ /** Ist der Wert eine Art fremder Gutschein? */
44
+ export declare function isArticleExternalVoucher(value: unknown): value is ArticleExternalVoucher;
45
+ /** Form des Werts beim Speichern: `null` heisst entfernen und ist gueltig. Zwilling von `pruefeWert`. */
46
+ export declare function checkExternalVoucherValue(value: unknown): ExternalVoucherArticleReason | null;
47
+ /**
48
+ * Regeln am wirksamen Artikelstand (Bestand + Aenderung), Zwilling von
49
+ * `pruefeArtikel`: `null` = passt. Ohne `externalVoucher` gilt keine Regel.
50
+ * Einzweck verlangt einen Satz der Kasse (0 = befreit verkauft), Mehrzweck ignoriert ihn;
51
+ * nie zusammen mit Leistungsgutschein, eigener Zusatzliste, Lagerbestand,
52
+ * Referenz oder Mengenabfrage (die Kasse fragt die Nummer selbst und bucht
53
+ * genau einen); ohne `askPrice` braucht er einen Preis ab 1 Cent.
54
+ */
55
+ export declare function checkExternalVoucherArticle(a: ExternalVoucherArticleInput): ExternalVoucherArticleReason | null;
56
+ /** Warum die Kachel eines fremden Gutscheins gesperrt ist. */
57
+ export type ExternalVoucherTileBlock = 'not_enabled' | 'type_not_enabled';
58
+ /**
59
+ * Darf die Kachel verkaufen? `null` = ja (auch fuer jeden Artikel ohne
60
+ * `externalVoucher`). Gesperrt bei Freigabe `off` (oder ohne Angabe) und bei
61
+ * Einzweck ohne `all` -- dieselbe Regel, mit der der Server den Beleg abweist
62
+ * (`external_voucher_not_enabled`, `external_voucher_type_not_enabled`).
63
+ */
64
+ export declare function externalVoucherTileBlock(article: {
65
+ externalVoucher?: ArticleExternalVoucher | null;
66
+ }, externalVouchers: PosExternalVouchers | null | undefined): ExternalVoucherTileBlock | null;
@@ -0,0 +1,74 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ARTICLE_EXTERNAL_VOUCHER_VAT_RATES = exports.EXTERNAL_VOUCHER_ARTICLE_REASONS = exports.ARTICLE_EXTERNAL_VOUCHER_INVALID = exports.ARTICLE_EXTERNAL_VOUCHER_TYPES = void 0;
4
+ exports.isArticleExternalVoucher = isArticleExternalVoucher;
5
+ exports.checkExternalVoucherValue = checkExternalVoucherValue;
6
+ exports.checkExternalVoucherArticle = checkExternalVoucherArticle;
7
+ exports.externalVoucherTileBlock = externalVoucherTileBlock;
8
+ exports.ARTICLE_EXTERNAL_VOUCHER_TYPES = Object.freeze(['multi_purpose', 'single_purpose']);
9
+ /** Fehlercode beim Speichern eines Artikels, intern und unter `/v3` gleich. */
10
+ exports.ARTICLE_EXTERNAL_VOUCHER_INVALID = 'article_external_voucher_invalid';
11
+ /** Welche Regel verletzt ist (Antwortfeld `data.grund`), in der Reihenfolge, in der der Server prueft. */
12
+ exports.EXTERNAL_VOUCHER_ARTICLE_REASONS = Object.freeze([
13
+ 'invalid_type', 'service_voucher', 'add_ons', 'stock_tracked', 'reference', 'asks_quantity', 'rate_required', 'invalid_rate', 'price_required',
14
+ ]);
15
+ /**
16
+ * Saetze, mit denen ein Einzweckgutschein verkauft werden kann (Prozent wie
17
+ * `PosArticle.vatRate`; 0 = befreit verkauft): die Saetze der Kasse, Backend
18
+ * `article-groups-core.STEUERSAETZE`, dieselben wie [EXTERNAL_VOUCHER_VAT_RATES_BP] / 100.
19
+ */
20
+ exports.ARTICLE_EXTERNAL_VOUCHER_VAT_RATES = Object.freeze([20, 13, 10, 4.9, 0, 19]);
21
+ /** Ist der Wert eine Art fremder Gutschein? */
22
+ function isArticleExternalVoucher(value) {
23
+ return exports.ARTICLE_EXTERNAL_VOUCHER_TYPES.includes(value);
24
+ }
25
+ /** Form des Werts beim Speichern: `null` heisst entfernen und ist gueltig. Zwilling von `pruefeWert`. */
26
+ function checkExternalVoucherValue(value) {
27
+ return value === null || isArticleExternalVoucher(value) ? null : 'invalid_type';
28
+ }
29
+ /**
30
+ * Regeln am wirksamen Artikelstand (Bestand + Aenderung), Zwilling von
31
+ * `pruefeArtikel`: `null` = passt. Ohne `externalVoucher` gilt keine Regel.
32
+ * Einzweck verlangt einen Satz der Kasse (0 = befreit verkauft), Mehrzweck ignoriert ihn;
33
+ * nie zusammen mit Leistungsgutschein, eigener Zusatzliste, Lagerbestand,
34
+ * Referenz oder Mengenabfrage (die Kasse fragt die Nummer selbst und bucht
35
+ * genau einen); ohne `askPrice` braucht er einen Preis ab 1 Cent.
36
+ */
37
+ function checkExternalVoucherArticle(a) {
38
+ if (a.externalVoucher == null)
39
+ return null;
40
+ if (!isArticleExternalVoucher(a.externalVoucher))
41
+ return 'invalid_type';
42
+ if (a.serviceVoucher === true)
43
+ return 'service_voucher';
44
+ if (Array.isArray(a.addOns) && a.addOns.length > 0)
45
+ return 'add_ons';
46
+ if (a.stockTracked === true)
47
+ return 'stock_tracked';
48
+ if (a.reference)
49
+ return 'reference';
50
+ if (a.askQuantity === true)
51
+ return 'asks_quantity';
52
+ if (a.externalVoucher === 'single_purpose' && !(typeof a.vatRate === 'number' && Number.isFinite(a.vatRate)))
53
+ return 'rate_required';
54
+ if (a.externalVoucher === 'single_purpose' && !exports.ARTICLE_EXTERNAL_VOUCHER_VAT_RATES.includes(a.vatRate))
55
+ return 'invalid_rate';
56
+ if (a.askPrice !== true && !(typeof a.unitPriceCents === 'number' && Number.isInteger(a.unitPriceCents) && a.unitPriceCents >= 1))
57
+ return 'price_required';
58
+ return null;
59
+ }
60
+ /**
61
+ * Darf die Kachel verkaufen? `null` = ja (auch fuer jeden Artikel ohne
62
+ * `externalVoucher`). Gesperrt bei Freigabe `off` (oder ohne Angabe) und bei
63
+ * Einzweck ohne `all` -- dieselbe Regel, mit der der Server den Beleg abweist
64
+ * (`external_voucher_not_enabled`, `external_voucher_type_not_enabled`).
65
+ */
66
+ function externalVoucherTileBlock(article, externalVouchers) {
67
+ if (article.externalVoucher == null)
68
+ return null;
69
+ if (externalVouchers !== 'multi_purpose' && externalVouchers !== 'all')
70
+ return 'not_enabled';
71
+ if (article.externalVoucher === 'single_purpose' && externalVouchers !== 'all')
72
+ return 'type_not_enabled';
73
+ return null;
74
+ }