@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
@@ -17,6 +17,7 @@ import { KasseneckValidationError } from '../client/errors.js';
17
17
  import { verifyWebhookSignature as pruefeSignatur } from '../partner/webhook-signatur.js';
18
18
  import { artikel, bestandGeaendert, objekt, reservierung, unterMindestbestand, variantengruppe } from './lesen.js';
19
19
  import { INVENTORY_WEBHOOK_EVENTS } from './vertrag.js';
20
+ import { vollerBeleg } from '../client/list-receipts.js';
20
21
  export { WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_TOLERANCE_SEC, } from '../partner/webhook-signatur.js';
21
22
  /**
22
23
  * Prueft die Signatur einer Zustellung. `true` nur, wenn Kopf, Zeitfenster
@@ -63,6 +64,9 @@ function kaputt(grund) {
63
64
  * - `variant_group.created|updated` tragen die Gruppe wie `getVariantGroup`
64
65
  * (seit 1.6.0). Zwei Zustellungen koennen sich ueberholen: den Stand nur
65
66
  * uebernehmen, wenn `data.updatedAt` neuer ist als der gespeicherte.
67
+ * - `receipt.created|cancelled` (Beleg-Webhooks) tragen den Beleg wie
68
+ * `listReceipts` mit `view: 'full'` ([ReceiptCreatedEventData],
69
+ * [ReceiptCancelledEventData]).
66
70
  * - Ein Rumpf, der keine Huelle ist, oder eine Bruchzahl in einer Menge wirft
67
71
  * `KasseneckValidationError` (`scope: 'response'`).
68
72
  *
@@ -107,7 +111,42 @@ export function parseInventoryWebhookEvent(rawBody) {
107
111
  case 'variant_group.created':
108
112
  case 'variant_group.updated':
109
113
  return { ...huelle, type: huelle.type, data: variantengruppe(ort, data) };
114
+ case 'receipt.created':
115
+ return { ...huelle, type: huelle.type, data: belegDaten(data) };
116
+ case 'receipt.cancelled':
117
+ return { ...huelle, type: huelle.type, data: stornoDaten(data) };
110
118
  default:
111
119
  return { ...huelle, type: huelle.type, data: artikel(ort, data) };
112
120
  }
113
121
  }
122
+ /** `data` von `receipt.created`: der Beleg der vollen Ansicht, bei einer gekuerzten Zustellung mit Hinweis. */
123
+ function belegDaten(data) {
124
+ const beleg = objekt(data['receipt']);
125
+ if (!beleg)
126
+ throw kaputt('Ereignis ohne data.receipt');
127
+ return {
128
+ receipt: vollerBeleg(beleg),
129
+ ...(data['truncated'] === true ? { truncated: true } : {}),
130
+ ...(typeof data['hint'] === 'string' ? { hint: data['hint'] } : {}),
131
+ };
132
+ }
133
+ const ganzOderNull = (w) => (typeof w === 'number' && Number.isInteger(w) ? w : null);
134
+ const textOderNull = (w) => (typeof w === 'string' && w !== '' ? w : null);
135
+ /** `data` von `receipt.cancelled`: dazu Bezug, stornierte Positionen und Rueckzahlungen aus dem Storno-Beleg. */
136
+ function stornoDaten(data) {
137
+ const { cancellationOf, cancelledItems, refunds } = data;
138
+ if (cancellationOf !== null && typeof cancellationOf !== 'string')
139
+ throw kaputt('data.cancellationOf ist weder Text noch null');
140
+ if (!Array.isArray(cancelledItems) || cancelledItems.some((x) => !objekt(x)))
141
+ throw kaputt('data.cancelledItems ist keine Liste von Positionen');
142
+ if (!Array.isArray(refunds) || refunds.some((x) => !objekt(x)))
143
+ throw kaputt('data.refunds ist keine Liste von Rueckzahlungen');
144
+ return {
145
+ ...belegDaten(data),
146
+ cancellationOf: cancellationOf === '' ? null : cancellationOf,
147
+ cancelledItems: cancelledItems.map((p) => ({ index: ganzOderNull(p['index']), quantity: ganzOderNull(p['quantity']) })),
148
+ refunds: refunds.map((r) => ({
149
+ refundOf: textOderNull(r['refundOf']), amountCents: ganzOderNull(r['amountCents']), method: textOderNull(r['method']),
150
+ })),
151
+ };
152
+ }
@@ -1,5 +1,5 @@
1
1
  export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, isDiscountItem, isVoucherItem, isVoucherFloatItem, } from './receipt-item.js';
2
- export { type Voucher, type VoucherArticle, type IssuedVoucher, type ReturnIssuedVoucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, isNewFormVoucher, voucherServerFields } from './voucher.js';
2
+ export { type Voucher, type VoucherArticle, type IssuedVoucher, type ReturnIssuedVoucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, isNewFormVoucher, voucherServerFields, type VoucherSource, type LegacyValueVoucherWish, VOUCHER_SOURCES, isExternalVoucher, externalVoucherIsValid, normalizeExternalVoucherNumber, checkExternalVoucherNumber, type ExternalVoucherNumberCheck, ownVoucherCodeShape, OWN_VOUCHER_CODE_SHAPES, type OwnVoucherCodeShape, EXTERNAL_VOUCHER_NUMBER_MAX, EXTERNAL_VOUCHER_TAXED_WITH_MAX, EXTERNAL_VOUCHER_VAT_RATES_BP, } from './voucher.js';
3
3
  export { type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, readRegistrationInfo, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, } from './receipt.js';
4
4
  export { type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, type ReturnDisposition, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, remainingQuantities, TIP_REFUND_SOURCES, type TipRefundSource, isTipRefundSource, openStaffTipCents, cancellationItemsForTip, cancellationCashRefundCents, asksTipRefundSource, asksRefundTip, } from './cancellation.js';
5
5
  export { type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, } from './receipt-payment.js';
@@ -1,5 +1,5 @@
1
1
  export { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, isTipItem, isDiscountItem, isVoucherItem, isVoucherFloatItem, } from './receipt-item.js';
2
- export { toVoucherPayload, fromVoucherPayload, voucherIsValid, isNewFormVoucher, voucherServerFields } from './voucher.js';
2
+ export { toVoucherPayload, fromVoucherPayload, voucherIsValid, isNewFormVoucher, voucherServerFields, VOUCHER_SOURCES, isExternalVoucher, externalVoucherIsValid, normalizeExternalVoucherNumber, checkExternalVoucherNumber, ownVoucherCodeShape, OWN_VOUCHER_CODE_SHAPES, EXTERNAL_VOUCHER_NUMBER_MAX, EXTERNAL_VOUCHER_TAXED_WITH_MAX, EXTERNAL_VOUCHER_VAT_RATES_BP, } from './voucher.js';
3
3
  export { toReceiptPayload, fromReceiptPayload, readRegistrationInfo, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, } from './receipt.js';
4
4
  export { RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, remainingQuantities, TIP_REFUND_SOURCES, isTipRefundSource, openStaffTipCents, cancellationItemsForTip, cancellationCashRefundCents, asksTipRefundSource, asksRefundTip, } from './cancellation.js';
5
5
  export { fromReceiptPaymentPayload, toReceiptPaymentPayload, } from './receipt-payment.js';
@@ -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,4 +1,5 @@
1
1
  import { VoucherAction, VoucherType } from '../enums/index.js';
2
+ import { VoucherCode } from '@kreiseck/validator';
2
3
  import { euroToCents } from '../money.js';
3
4
  import { readEnumKey, requireEnumKey } from './enum-payload.js';
4
5
  /** Arten der neuen Gutscheinform (die Altwerte sind `value` und `promo`). */
@@ -8,6 +9,11 @@ export const NEUE_GUTSCHEINARTEN = [
8
9
  VoucherType.service,
9
10
  VoucherType.promotion,
10
11
  ];
12
+ export const VOUCHER_SOURCES = Object.freeze(['external']);
13
+ /** Fremdgutschein (`source: 'external'`)? Zwilling von `gutschein-beleg.istFremd`. */
14
+ export function isExternalVoucher(voucher) {
15
+ return voucher.source === 'external';
16
+ }
11
17
  /**
12
18
  * Verkauf ueber eine Sorte ohne Art (`typeId` ohne `type`): die Art kommt aus
13
19
  * der Sorte. Zwilling von `gutschein-beleg.istSortenVerkauf`.
@@ -17,7 +23,8 @@ function istSortenVerkaufOhneArt(voucher) {
17
23
  }
18
24
  /** Gehoert der Gutschein zur neuen Form (Art, Aktion `payout` oder Verkauf ueber eine Sorte ohne Art)? */
19
25
  export function isNewFormVoucher(voucher) {
20
- return NEUE_GUTSCHEINARTEN.includes(voucher.type) || voucher.action === VoucherAction.payout || istSortenVerkaufOhneArt(voucher);
26
+ return NEUE_GUTSCHEINARTEN.includes(voucher.type) || voucher.action === VoucherAction.payout || istSortenVerkaufOhneArt(voucher)
27
+ || isExternalVoucher(voucher);
21
28
  }
22
29
  /**
23
30
  * Wert-Verkauf: ein Mehrzweck- oder Einzweckgutschein wird verkauft (mit Art
@@ -25,7 +32,7 @@ export function isNewFormVoucher(voucher) {
25
32
  * Senden entscheiden daran, ob eine Sorte noetig ist.
26
33
  */
27
34
  export function istWertVerkauf(voucher) {
28
- return voucher.action === VoucherAction.sell
35
+ return !isExternalVoucher(voucher) && voucher.action === VoucherAction.sell
29
36
  && (voucher.type === VoucherType.multi_purpose || voucher.type === VoucherType.single_purpose || istSortenVerkaufOhneArt(voucher));
30
37
  }
31
38
  /**
@@ -38,7 +45,7 @@ export function voucherServerFields(voucher) {
38
45
  return GUTSCHEIN_SERVERFELDER.filter((feld) => voucher[feld] != null);
39
46
  }
40
47
  const NEUE_FELDER = [
41
- 'amountCents', 'articleId', 'quantity', 'positions', 'reason', 'typeId', 'typeName', 'payout', 'voucherType', 'voucherId', 'codeSuffix',
48
+ 'source', 'number', 'amountCents', 'articleId', 'quantity', 'positions', 'reason', 'typeId', 'typeName', 'payout', 'voucherType', 'voucherId', 'codeSuffix',
42
49
  'vatRateBp', 'article', 'balanceAfterCents', 'remainingQuantityAfter', 'taxedWith', 'exempt', 'zeroRateBucket', 'fromReturn',
43
50
  ];
44
51
  export function toVoucherPayload(voucher) {
@@ -71,6 +78,8 @@ export function toVoucherPayload(voucher) {
71
78
  * gesetzter Wert muss positiv sein.
72
79
  */
73
80
  export function voucherIsValid(voucher) {
81
+ if (isExternalVoucher(voucher))
82
+ return externalVoucherIsValid(voucher);
74
83
  if (isNewFormVoucher(voucher))
75
84
  return newFormVoucherIsValid(voucher);
76
85
  if (voucher.type === VoucherType.value && voucher.valueCents == null) {
@@ -160,13 +169,21 @@ function newFormVoucherIsValid(v) {
160
169
  * Stufe 4b antwortet darauf `voucher_type_required`). Paketintern.
161
170
  */
162
171
  export function wunschFormGueltig(v, sorteNoetig) {
172
+ if (isExternalVoucher(v))
173
+ return externalVoucherIsValid(v);
163
174
  if (voucherServerFields(v).length > 0)
164
175
  return false;
165
176
  const r = v;
166
- for (const feld of ['vatRateBp', 'article', 'balanceAfterCents', 'remainingQuantityAfter', 'taxedWith', 'exempt']) {
177
+ for (const feld of ['article', 'balanceAfterCents', 'remainingQuantityAfter', 'exempt']) {
167
178
  if (r[feld] != null)
168
179
  return false;
169
180
  }
181
+ // Felder nur des Fremdgutscheins (gutschein-beleg.NUR_BEI_FREMD): der Server weist sie an einem eigenen Wunsch
182
+ // schon gesendet ab, auch als `null` (`voucher_invalid`); eine andere Herkunft als `external` gibt es nicht.
183
+ for (const feld of ['number', 'taxedWith', 'vatRateBp', 'source']) {
184
+ if (r[feld] !== undefined)
185
+ return false;
186
+ }
170
187
  if (v.valueCents != null)
171
188
  return false;
172
189
  // Die Sorte gehoert nur an einen Wert-Verkauf (Server: sorteId sonst voucher_invalid).
@@ -210,3 +227,134 @@ export function wunschFormGueltig(v, sorteNoetig) {
210
227
  // Altart mit neuer Aktion (payout + value/promo): nicht sendbar.
211
228
  return false;
212
229
  }
230
+ // ---- Fremdgutscheine (Server 2026-11) -------------------------------------------
231
+ /**
232
+ * Rand einer Fremdnummer (Zwilling von `gutschein-core.FREMD_RAND`): ASCII-Leerraum und die Unicode-Leerzeichen,
233
+ * die beim Kopieren aus Fremdsystemen mitkommen. Bewusst ohne U+0085 (NEL): ein Steuerzeichen, das nie still
234
+ * verschwindet, sondern die Nummer ungueltig macht.
235
+ */
236
+ const FREMD_RAND = '\\t\\n\\v\\f\\r \\u00A0\\u1680\\u2000-\\u200A\\u2028\\u2029\\u202F\\u205F\\u3000\\uFEFF';
237
+ const FREMD_RAND_MUSTER = new RegExp(`^[${FREMD_RAND}]+|[${FREMD_RAND}]+$`, 'g');
238
+ const FREMD_NUMMER_MUSTER = /^[A-Za-z0-9\-_./]{1,40}$/;
239
+ /** Hoechstlaenge der Nummer eines Fremdgutscheins (nach dem Abschneiden des Rands). */
240
+ export const EXTERNAL_VOUCHER_NUMBER_MAX = 40;
241
+ /** Hoechstlaenge von `taxedWith` (Vermerk, mit welchem Beleg im fremden System der Einzweckgutschein versteuert ist). */
242
+ export const EXTERNAL_VOUCHER_TAXED_WITH_MAX = 40;
243
+ /**
244
+ * Saetze, mit denen ein fremder Einzweckgutschein verkauft sein kann (Basispunkte): die Saetze der Kasse
245
+ * (20, 10, 13, 19, 4,9 %) und 0 = befreit verkauft (Kleinunternehmer).
246
+ */
247
+ export const EXTERNAL_VOUCHER_VAT_RATES_BP = Object.freeze([2000, 1000, 1300, 1900, 490, 0]);
248
+ /**
249
+ * Nummer eines Fremdgutscheins in der Form, mit der der Server sie speichert und druckt
250
+ * (`gutschein-core.normiereFremdnummer`): Rand weg, **keine** Unicode-Normalisierung, Gross-/Kleinschreibung
251
+ * bleibt; dann 1 bis 40 Zeichen aus `A–Z a–z 0–9 - _ . /`. Sonst `null` (`external_voucher_number_invalid`).
252
+ * Einen eigenen Gutscheincode erkennt erst [checkExternalVoucherNumber].
253
+ */
254
+ export function normalizeExternalVoucherNumber(text) {
255
+ if (typeof text !== 'string')
256
+ return null;
257
+ const n = text.replace(FREMD_RAND_MUSTER, '');
258
+ return FREMD_NUMMER_MUSTER.test(n) ? n : null;
259
+ }
260
+ /**
261
+ * Prueft eine Fremdnummer in der Reihenfolge des Servers (`gutschein-beleg.pruefeFremd`): zuerst, ob sie ein
262
+ * gueltiger eigener Gutscheincode ist (12 Zeichen mit Pruefzeichen, in jeder Schreibweise der Kasse, auch mit `.`, `_`
263
+ * oder `/` als Trenner) – dann
264
+ * `external_voucher_number_is_own_code`, der Gutschein gehoert als eigener eingeloest –, danach die Form.
265
+ */
266
+ export function checkExternalVoucherNumber(text) {
267
+ // `.`, `_` und `/` zwischen den Gruppen liest die Pruefung wie `-` (Zwilling von `gutschein-core.istEigenerCode`):
268
+ // `7148.FGQA.935K` ist der eigene Code. Die Nummer selbst bleibt, wie sie kam.
269
+ if (typeof text === 'string' && VoucherCode.validate(text.replace(/[._/]/g, '-')).ok)
270
+ return { ok: false, code: 'external_voucher_number_is_own_code' };
271
+ const number = normalizeExternalVoucherNumber(text);
272
+ return number === null ? { ok: false, code: 'external_voucher_number_invalid' } : { ok: true, number };
273
+ }
274
+ export const OWN_VOUCHER_CODE_SHAPES = Object.freeze(['valid', 'checksum', 'length', 'none']);
275
+ /** Alphabet der eigenen Codes (Crockford-Base32 ohne U), nach der Normalisierung von `VoucherCode`. */
276
+ const CODE_ALPHABET = /^[0-9A-HJKMNP-TV-Z]+$/;
277
+ const CODE_GRUPPEN = /^[0-9A-Za-z]{4}-[0-9A-Za-z]{4}-[0-9A-Za-z]+$/;
278
+ /**
279
+ * Form-Erkennung eigener Codes fuer das Feld „Code eingeben oder scannen“ (Web-Kasse und Kassen-App gleich):
280
+ * `valid` laeuft als eigener Gutschein, `checksum`/`length` fragt die Kasse nach („Sieht aus wie ein
281
+ * Kasseneck-Code, ist aber keiner. Als fremden Gutschein verwenden?“, `external_voucher.looks_like_own_code`),
282
+ * `none` geht bei Freigabe direkt in das Blatt „Fremder Gutschein“. Gelesen wie [checkExternalVoucherNumber]:
283
+ * Rand weg, `.`, `_`, `/` wie `-`, dann die Normalisierung von `VoucherCode` (gross, ohne Leerraum und `-`,
284
+ * O → 0, I/L → 1); `length` nur mit echten Bindestrichen. Eine Nachfrage weist nichts ab: der Server prueft die Fremdnummer selbst
285
+ * (`external_voucher_number_is_own_code` nur bei `valid`).
286
+ */
287
+ export function ownVoucherCodeShape(text) {
288
+ if (typeof text !== 'string')
289
+ return 'none';
290
+ const roh = text.replace(FREMD_RAND_MUSTER, '');
291
+ const t = roh.replace(/[._/]/g, '-');
292
+ if (t === '')
293
+ return 'none';
294
+ if (VoucherCode.validate(t).ok)
295
+ return 'valid';
296
+ const s = t.toUpperCase().replace(/[\s-]/g, '').replace(/O/g, '0').replace(/[IL]/g, '1');
297
+ if (!CODE_ALPHABET.test(s))
298
+ return 'none';
299
+ if (s.length === 12)
300
+ return 'checksum';
301
+ // Falsche Laenge nur mit echten Bindestrichen: eigene Codes stehen immer so da, `WEIN.2026/7` ist keiner.
302
+ return CODE_GRUPPEN.test(roh) ? 'length' : 'none';
303
+ }
304
+ /** Steuer- und Formatzeichen (`gutschein-core.STEUERZEICHEN`): nie in `taxedWith`. */
305
+ const STEUERZEICHEN = /[\p{Cc}\p{Cf}]/u;
306
+ /**
307
+ * Ist der Fremdgutschein sendbar? Die Form wie `gutschein-beleg.pruefeFremd` (ohne die Freigabe des Kontos, die
308
+ * kennt nur der Server bzw. `PosVoucherSettings.externalVouchers`): Aktion `sell`/`redeem`/`payout`, Art
309
+ * `multi_purpose`/`single_purpose`, gueltige Nummer (kein eigener Code), Betrag 1 bis 1.000.000 Cent; Einzweck mit
310
+ * einem Satz aus [EXTERNAL_VOUCHER_VAT_RATES_BP], Mehrzweck ohne; `taxedWith` nur bei Einzweck-Einloesung bzw.
311
+ * -Auszahlung (1 bis 40 Zeichen ohne Steuerzeichen); Auszahlung mit Grund (1 bis 200 Zeichen). Felder eigener
312
+ * Gutscheine (Code, Sorte, Artikel, Menge, Positionen) und Serverfelder nie.
313
+ */
314
+ export function externalVoucherIsValid(voucher) {
315
+ const v = voucher;
316
+ if (!isExternalVoucher(v))
317
+ return false;
318
+ if (voucherServerFields(v).length > 0)
319
+ return false;
320
+ const r = v;
321
+ // gutschein-beleg.NICHT_BEI_FREMD (gesendet heisst voucher_invalid, auch als null).
322
+ for (const feld of ['code', 'typeId', 'articleId', 'article', 'quantity', 'positions']) {
323
+ if (r[feld] !== undefined)
324
+ return false;
325
+ }
326
+ for (const feld of ['balanceAfterCents', 'remainingQuantityAfter', 'exempt']) {
327
+ if (r[feld] != null)
328
+ return false;
329
+ }
330
+ if (v.valueCents != null)
331
+ return false;
332
+ if (v.action !== VoucherAction.sell && v.action !== VoucherAction.redeem && v.action !== VoucherAction.payout)
333
+ return false;
334
+ if (v.type !== VoucherType.multi_purpose && v.type !== VoucherType.single_purpose)
335
+ return false;
336
+ if (!checkExternalVoucherNumber(v.number).ok)
337
+ return false;
338
+ if (!istCent(v.amountCents))
339
+ return false;
340
+ if (v.type === VoucherType.single_purpose) {
341
+ if (!(typeof v.vatRateBp === 'number' && EXTERNAL_VOUCHER_VAT_RATES_BP.includes(v.vatRateBp)))
342
+ return false;
343
+ }
344
+ else if (v.vatRateBp != null) {
345
+ return false;
346
+ }
347
+ if (v.taxedWith != null) {
348
+ if (v.type !== VoucherType.single_purpose || v.action === VoucherAction.sell)
349
+ return false;
350
+ const t = typeof v.taxedWith === 'string' ? v.taxedWith.trim() : '';
351
+ if (t.length < 1 || t.length > EXTERNAL_VOUCHER_TAXED_WITH_MAX || STEUERZEICHEN.test(t))
352
+ return false;
353
+ }
354
+ if (v.action === VoucherAction.payout) {
355
+ const g = typeof v.reason === 'string' ? v.reason.trim() : '';
356
+ if (g.length < 1 || g.length > MAX_GRUND)
357
+ return false;
358
+ }
359
+ return true;
360
+ }
@@ -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
  /**
@@ -1,5 +1,6 @@
1
1
  import { KasseneckValidationError } from '../client/errors.js';
2
2
  import { fromReferencePayload } from './kachel-referenz.js';
3
+ import { isArticleExternalVoucher } from './fremdgutschein-artikel.js';
3
4
  /** Zusatzliste am Draht: nur eine Liste von Texten zaehlt, sonst null. Paketintern. */
4
5
  export function addOnListe(wert) {
5
6
  return Array.isArray(wert) ? wert.filter((s) => typeof s === 'string' && s !== '') : null;
@@ -92,6 +93,7 @@ export function fromPosArticlePayload(p) {
92
93
  askPrice: p.askPrice === true,
93
94
  reference: fromReferencePayload(p.reference),
94
95
  addOns: addOnListe(p.addOns),
96
+ externalVoucher: isArticleExternalVoucher(p.externalVoucher) ? p.externalVoucher : null,
95
97
  };
96
98
  }
97
99
  /**
@@ -1,6 +1,7 @@
1
1
  import { KasseneckValidationError } from '../client/errors.js';
2
2
  import { posVoucherSettingsFromWire } from './gutschein.js';
3
- import { POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, POS_BUSINESS_VALUES, POS_DEVICE_VALUES, POS_SHORTCUT_ACTIONS, POS_DEVICE_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_CHOICES, POS_DEVICE_OPTIONAL_CHOICES, mergePosSettings, posShortcutConflict, _istAltwert0x, _optionalerWert, } from './settings.js';
3
+ import { checkDiscountPresets, INVALID_DISCOUNT_PRESET } from './rabatt-vorlagen.js';
4
+ import { POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, POS_BUSINESS_VALUES, POS_DEVICE_VALUES, POS_SHORTCUT_ACTIONS, POS_DEVICE_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_CHOICES, POS_BUSINESS_OPTIONAL_LISTS, POS_DEVICE_OPTIONAL_CHOICES, mergePosSettings, posShortcutConflict, _istAltwert0x, _optionalerWert, } from './settings.js';
4
5
  /*
5
6
  * Die Einstellungs-Aufrufe am Draht `/api/v3`: Parameter und Antwort heissen
6
7
  * `business`/`device`, Schluessel und Werte englisch (Nachtrag §11.7.2).
@@ -144,6 +145,16 @@ function pruefeTeil(name, teil, block, standard, werte) {
144
145
  throw new KasseneckValidationError(name, `${teil}.${schluessel}: true oder false erwartet`, 'request');
145
146
  continue;
146
147
  }
148
+ // Rabatt-Vorlagen: dieselbe Pruefung wie am Server, der erste Fehler mit Vorlage, Feld und Satz.
149
+ if (teil === 'business' && POS_BUSINESS_OPTIONAL_LISTS.includes(schluessel)) {
150
+ const geprueft = checkDiscountPresets(wert);
151
+ if (!geprueft.ok) {
152
+ const f = geprueft.errors[0];
153
+ const ort = `${teil}.${schluessel}${f.index === null ? '' : `[${f.index}]`}${f.field === null ? '' : `.${f.field}`}`;
154
+ throw new KasseneckValidationError(name, `${ort}: ${f.message} (${INVALID_DISCOUNT_PRESET})`, 'request');
155
+ }
156
+ continue;
157
+ }
147
158
  const wahl = teil === 'business' ? POS_BUSINESS_OPTIONAL_CHOICES : POS_DEVICE_OPTIONAL_CHOICES;
148
159
  if (!Object.prototype.hasOwnProperty.call(standard, schluessel) && !wahl.includes(schluessel)) {
149
160
  throw new 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`. */
@@ -50,6 +50,7 @@ export const POS_ERROR_CODES = Object.freeze([
50
50
  'invalid_amount',
51
51
  'invalid_cursor',
52
52
  'invalid_denominations',
53
+ 'invalid_discount_preset',
53
54
  'invalid_movement_type',
54
55
  'invalid_quantity',
55
56
  '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;