@kreiseck/kasseneck-api 1.26.0 → 1.28.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 (115) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/dist/cjs/client/aufrufe.d.ts +3 -3
  3. package/dist/cjs/client/aufrufe.js +3 -0
  4. package/dist/cjs/models/receipt-errors.d.ts +1 -1
  5. package/dist/cjs/models/receipt-errors.js +2 -0
  6. package/dist/cjs/models/receipt-item.d.ts +10 -0
  7. package/dist/cjs/models/receipt-item.js +8 -0
  8. package/dist/cjs/pos/artikel.d.ts +17 -0
  9. package/dist/cjs/pos/artikel.js +7 -0
  10. package/dist/cjs/pos/aufrunden.d.ts +6 -0
  11. package/dist/cjs/pos/aufrunden.js +59 -0
  12. package/dist/cjs/pos/client.js +12 -1
  13. package/dist/cjs/pos/index.d.ts +5 -3
  14. package/dist/cjs/pos/index.js +27 -4
  15. package/dist/cjs/pos/schicht-lesen.d.ts +2 -1
  16. package/dist/cjs/pos/schicht-lesen.js +48 -1
  17. package/dist/cjs/pos/schicht-typen.d.ts +106 -3
  18. package/dist/cjs/pos/schicht-typen.js +14 -4
  19. package/dist/cjs/pos/schicht.d.ts +28 -2
  20. package/dist/cjs/pos/schicht.js +19 -0
  21. package/dist/cjs/pos/settings.d.ts +39 -0
  22. package/dist/cjs/pos/settings.js +65 -4
  23. package/dist/cjs/pos/texte.d.ts +305 -0
  24. package/dist/cjs/pos/texte.js +113 -0
  25. package/dist/cjs/pos/zusaetze.d.ts +70 -0
  26. package/dist/cjs/pos/zusaetze.js +159 -0
  27. package/dist/cjs/receipt/grid.js +16 -3
  28. package/dist/cjs/receipt/layout.js +16 -9
  29. package/dist/cjs/receipt/shift-sheet.js +29 -0
  30. package/dist/cjs/stored/einstellungen.js +31 -4
  31. package/dist/cjs/stored/vokabular.d.ts +1 -1
  32. package/dist/cjs/stored/vokabular.js +35 -5
  33. package/dist/cjs/version.d.ts +1 -1
  34. package/dist/cjs/version.js +1 -1
  35. package/dist/esm/client/aufrufe.d.ts +3 -3
  36. package/dist/esm/client/aufrufe.js +3 -0
  37. package/dist/esm/models/receipt-errors.d.ts +1 -1
  38. package/dist/esm/models/receipt-errors.js +2 -0
  39. package/dist/esm/models/receipt-item.d.ts +10 -0
  40. package/dist/esm/models/receipt-item.js +8 -0
  41. package/dist/esm/pos/artikel.d.ts +17 -0
  42. package/dist/esm/pos/artikel.js +6 -0
  43. package/dist/esm/pos/aufrunden.d.ts +6 -0
  44. package/dist/esm/pos/aufrunden.js +56 -0
  45. package/dist/esm/pos/client.js +13 -2
  46. package/dist/esm/pos/index.d.ts +5 -3
  47. package/dist/esm/pos/index.js +6 -4
  48. package/dist/esm/pos/schicht-lesen.d.ts +2 -1
  49. package/dist/esm/pos/schicht-lesen.js +47 -1
  50. package/dist/esm/pos/schicht-typen.d.ts +106 -3
  51. package/dist/esm/pos/schicht-typen.js +13 -3
  52. package/dist/esm/pos/schicht.d.ts +28 -2
  53. package/dist/esm/pos/schicht.js +19 -1
  54. package/dist/esm/pos/settings.d.ts +39 -0
  55. package/dist/esm/pos/settings.js +60 -3
  56. package/dist/esm/pos/texte.d.ts +305 -0
  57. package/dist/esm/pos/texte.js +113 -0
  58. package/dist/esm/pos/zusaetze.d.ts +70 -0
  59. package/dist/esm/pos/zusaetze.js +148 -0
  60. package/dist/esm/receipt/grid.js +16 -3
  61. package/dist/esm/receipt/layout.js +16 -9
  62. package/dist/esm/receipt/shift-sheet.js +29 -0
  63. package/dist/esm/stored/einstellungen.js +32 -5
  64. package/dist/esm/stored/vokabular.d.ts +1 -1
  65. package/dist/esm/stored/vokabular.js +35 -5
  66. package/dist/esm/version.d.ts +1 -1
  67. package/dist/esm/version.js +1 -1
  68. package/fixtures/add-on-cases.json +103 -0
  69. package/fixtures/duplicate-cases.json +6 -0
  70. package/fixtures/expected/add-ons.grid32.txt +31 -0
  71. package/fixtures/expected/add-ons.grid48.txt +27 -0
  72. package/fixtures/expected/add-ons.lines.json +270 -0
  73. package/fixtures/expected/add-ons.sheet32.json +212 -0
  74. package/fixtures/expected/add-ons.sheet48.json +188 -0
  75. package/fixtures/expected/duplicate.shift-close.hex +28 -27
  76. package/fixtures/expected/shift-close-blind.grid32.txt +1 -0
  77. package/fixtures/expected/shift-close-blind.grid48.txt +1 -0
  78. package/fixtures/expected/shift-close-blind.lines.json +6 -0
  79. package/fixtures/expected/shift-close-put-in.grid32.txt +1 -0
  80. package/fixtures/expected/shift-close-put-in.grid48.txt +1 -0
  81. package/fixtures/expected/shift-close-put-in.lines.json +6 -0
  82. package/fixtures/expected/shift-close-take-out.grid32.txt +1 -0
  83. package/fixtures/expected/shift-close-take-out.grid48.txt +1 -0
  84. package/fixtures/expected/shift-close-take-out.lines.json +6 -0
  85. package/fixtures/expected/shift-close.grid32.txt +1 -0
  86. package/fixtures/expected/shift-close.grid48.txt +1 -0
  87. package/fixtures/expected/shift-close.lines.json +6 -0
  88. package/fixtures/expected/shift-interim.grid32.txt +1 -0
  89. package/fixtures/expected/shift-interim.grid48.txt +1 -0
  90. package/fixtures/expected/shift-interim.lines.json +6 -0
  91. package/fixtures/hobex-hps-codes.json +1 -1
  92. package/fixtures/invoice-api.schema.json +1 -1
  93. package/fixtures/invoice-texts.json +1 -1
  94. package/fixtures/manifest.json +8 -0
  95. package/fixtures/pos-texts.json +352 -1
  96. package/fixtures/receipts/add-ons.json +70 -0
  97. package/fixtures/renames-1.0.json +30 -0
  98. package/fixtures/shift-ablauf-cases.json +182 -0
  99. package/fixtures/shift-receipts.json +15 -15
  100. package/fixtures/surface.json +50 -2
  101. package/fixtures/tip-round-up-cases.json +27 -0
  102. package/fixtures/v3/antworten/belege.json +2 -2
  103. package/fixtures/v3/antworten/belegmail.json +2 -2
  104. package/fixtures/v3/antworten/berichte.json +2 -2
  105. package/fixtures/v3/antworten/kasse-belege.json +2 -2
  106. package/fixtures/v3/antworten/kasse.json +504 -4
  107. package/fixtures/v3/antworten/lager.json +1 -1
  108. package/fixtures/v3/antworten/rechnungen.json +2 -2
  109. package/fixtures/v3/antworten/storno.json +2 -2
  110. package/fixtures/v3/stored/belege.json +2 -2
  111. package/fixtures/v3/stored/kasse.json +520 -12
  112. package/fixtures/v3/stored/rechnungen.json +2 -2
  113. package/fixtures/v3/v3-vokabular.json +160 -19
  114. package/fixtures/v3/zahlbetrag-faelle.json +2 -2
  115. package/package.json +1 -1
@@ -1,8 +1,8 @@
1
1
  import type { InternerTransport } from '../client/aufrufe.js';
2
- import { type AfterCountType, type CashLocation, type CashMovementResult, type CloseShiftResult, type Denominations, type DrawerOpeningsResult, type DrawerState, type ManualMovementType, type OpeningReason, type OpenShiftResult, type ShiftReport, type ShiftTipTotals } from './schicht-typen.js';
2
+ import { type AfterCountType, type CashLocation, type CashMovementResult, type CloseShiftResult, type Denominations, type DrawerOpeningsResult, type DrawerState, type ManualMovementType, type OpeningReason, type OpenShiftResult, type ShiftCountResult, type ShiftReport, type ShiftTipTotals } from './schicht-typen.js';
3
3
  /**
4
4
  * Schicht, Kassenstand und Lade-Protokoll an der Kasse (Backend
5
- * schicht-endpoints.js). Alle sechs Aufrufe gibt es nur ueber den Kassenweg
5
+ * schicht-endpoints.js). Alle sieben Aufrufe gibt es nur ueber den Kassenweg
6
6
  * `/api/v3`; sie laufen mit dem Kassen-Benutzer-Weg (`registerUserAuth`).
7
7
  *
8
8
  * Rechte am Server: `shift` (Schicht oeffnen und schliessen, Bericht),
@@ -125,6 +125,26 @@ export interface CloseMyShiftOptions {
125
125
  * danach derselbe Betrag, gilt er als dieselbe Zaehlung.
126
126
  */
127
127
  checkOnly?: boolean;
128
+ /**
129
+ * `countedCents` ist der Stand **vor** den Trinkgeld-Auszahlungen derselben Anfrage: die
130
+ * Kasse zaehlt zuerst, zahlt dann aus. Der Server speichert den Rohwert (Antwort:
131
+ * `shift.countedBeforePayoutCents`, auf dem Bon „Gezaehlt“) und rechnet Ist und Differenz
132
+ * mit dem Stand nach der Auszahlung. Ohne die Angabe zaehlt der Betrag wie bisher als Ist.
133
+ */
134
+ countedBeforePayout?: boolean;
135
+ }
136
+ /**
137
+ * Zwischenzaehlung waehrend der Schicht ([recordMyShiftCount], Recht `cashView`): der Kassenstand
138
+ * wird gezaehlt, ohne die Schicht zu schliessen.
139
+ */
140
+ export interface RecordMyShiftCountOptions {
141
+ idempotencyKey: string;
142
+ shiftId: string;
143
+ /** Gezaehltes Bargeld in Cent (`0` erlaubt). */
144
+ countedCents: number;
145
+ denominations?: Denominations | null;
146
+ /** Freitext zur Zaehlung (z. B. Grund einer Abweichung). */
147
+ comment?: string;
128
148
  }
129
149
  /** Entnehmen oder Einlegen beim Abschluss (siehe [CloseMyShiftOptions.afterCount]). */
130
150
  export interface AfterCountOption {
@@ -148,6 +168,12 @@ export declare function getMyShiftReport(transport: InternerTransport, options:
148
168
  * `checkOnly` nur pruefen: `status: 'ready'` statt Schliessen.
149
169
  */
150
170
  export declare function closeMyShift(transport: InternerTransport, options: CloseMyShiftOptions): Promise<CloseShiftResult>;
171
+ /**
172
+ * Zwischenzaehlung festhalten (Recht `cashView`, ohne es `not_permitted`): der Server vergleicht die Zaehlung mit dem Soll
173
+ * und haelt die Differenz fest, die Schicht bleibt offen. Antwort: Soll, Zaehlung und Differenz
174
+ * dieser Zaehlung. Derselbe `idempotencyKey` ergibt dieselbe Antwort und keinen zweiten Eintrag.
175
+ */
176
+ export declare function recordMyShiftCount(transport: InternerTransport, options: RecordMyShiftCountOptions): Promise<ShiftCountResult>;
151
177
  /**
152
178
  * Summe einer Stueckelung in Cent, oder `null`, wenn sie keine ist: ein
153
179
  * Schluessel, der kein Euro-Wert ist ([EUR_DENOMINATIONS], genau so
@@ -1,6 +1,6 @@
1
1
  import { KasseneckValidationError } from '../client/errors.js';
2
2
  import { anfrage, schluessel } from '../inventory/schreiben.js';
3
- import { abschluss, bericht, gebucht, geoeffnet, gemeldet, ladeStand } from './schicht-lesen.js';
3
+ import { abschluss, bericht, gebucht, geoeffnet, gemeldet, gezaehlt, ladeStand } from './schicht-lesen.js';
4
4
  import { labelText } from './texte.js';
5
5
  import { CASH_LOCATIONS, EUR_DENOMINATIONS, } from './schicht-typen.js';
6
6
  const antwort = (name) => ({ name, pfad: '', scope: 'response' });
@@ -104,6 +104,8 @@ export async function closeMyShift(transport, options) {
104
104
  }
105
105
  if (p.checkOnly !== undefined && typeof p.checkOnly !== 'boolean')
106
106
  throw anfragefehler(name, 'checkOnly muss true oder false sein');
107
+ if (p.countedBeforePayout !== undefined && typeof p.countedBeforePayout !== 'boolean')
108
+ throw anfragefehler(name, 'countedBeforePayout muss true oder false sein');
107
109
  // Nur die Form: die Art (Katalog) und die Grenzen prueft der Server.
108
110
  if (p.afterCount !== undefined && p.afterCount !== null) {
109
111
  if (typeof p.afterCount !== 'object' || Array.isArray(p.afterCount))
@@ -112,6 +114,22 @@ export async function closeMyShift(transport, options) {
112
114
  }
113
115
  return rufe(transport, name, p, abschluss);
114
116
  }
117
+ /**
118
+ * Zwischenzaehlung festhalten (Recht `cashView`, ohne es `not_permitted`): der Server vergleicht die Zaehlung mit dem Soll
119
+ * und haelt die Differenz fest, die Schicht bleibt offen. Antwort: Soll, Zaehlung und Differenz
120
+ * dieser Zaehlung. Derselbe `idempotencyKey` ergibt dieselbe Antwort und keinen zweiten Eintrag.
121
+ */
122
+ export async function recordMyShiftCount(transport, options) {
123
+ const name = 'recordMyShiftCount';
124
+ const p = anfrage(name, options);
125
+ kennung(name, p, 'shiftId');
126
+ schluessel(name, p, { pflicht: true });
127
+ cent(name, 'countedCents', p.countedCents);
128
+ stueckelungPruefen(name, p);
129
+ if (p.comment !== undefined && typeof p.comment !== 'string')
130
+ throw anfragefehler(name, 'comment muss ein Text sein');
131
+ return rufe(transport, name, p, gezaehlt);
132
+ }
115
133
  // ---- Helfer der Kasse ---------------------------------------------------------
116
134
  const ANZAHL_MAX = 100000;
117
135
  const WERTE = new Set(EUR_DENOMINATIONS.map(String));
@@ -22,6 +22,18 @@ export declare const QUANTITY: readonly ["off", "x", "kg"];
22
22
  export type PosQuantity = typeof QUANTITY[number];
23
23
  export declare const TIP_MODE: readonly ["amount", "total", "both"];
24
24
  export type PosTipMode = typeof TIP_MODE[number];
25
+ /**
26
+ * Trinkgeld-Arten, die die Kasse anbietet (`business.tipKinds`): Prozent, Aufrunden
27
+ * (der Gast zahlt auf einen runden Betrag) und Gesamt (der Gast nennt den Betrag, den er insgesamt zahlt).
28
+ * `business.tipStart` ist die zuerst offene Art und liegt immer unter den angebotenen.
29
+ */
30
+ export declare const TIP_KINDS: readonly ["percent", "round_up", "total"];
31
+ export type PosTipKind = typeof TIP_KINDS[number];
32
+ /** Die zuerst offene Trinkgeld-Art (`business.tipStart`): dieselben Werte wie [TIP_KINDS]. */
33
+ export declare const TIP_START: readonly ["percent", "round_up", "total"];
34
+ /** Breite der rechten Spalte (Korb) an diesem Geraet (`device.cartWidth`); in der schmalen Ansicht ohne Wirkung. */
35
+ export declare const CART_WIDTH: readonly ["narrow", "medium", "wide"];
36
+ export type PosCartWidth = typeof CART_WIDTH[number];
25
37
  export declare const CHECKOUT_MODE: readonly ["page", "panel"];
26
38
  export type PosCheckoutMode = typeof CHECKOUT_MODE[number];
27
39
  /** Kartenanbieter: Karte gibt es erst mit eingerichtetem Anbieter; 'external' = eigenes Terminal ohne Anbindung. */
@@ -197,6 +209,14 @@ export interface PosBusinessSettings {
197
209
  * Lesen ueber [posTipKeptByDefault]. Siehe [POS_BUSINESS_OPTIONAL_FIELDS].
198
210
  */
199
211
  tipKeptByDefault?: boolean;
212
+ /**
213
+ * Angebotene Trinkgeld-Arten (nichtleere Teilmenge von [TIP_KINDS], Reihenfolge wie
214
+ * gespeichert). Optional: der Server sendet das Feld nur, wenn es gespeichert ist; fehlt es,
215
+ * gelten alle drei. Lesen ueber [posTipKinds]. `tipMode` folgt den Arten (der Server leitet ihn ab).
216
+ */
217
+ tipKinds?: PosOpen<PosTipKind>[];
218
+ /** Zuerst offene Trinkgeld-Art; optional, fehlt sie, gilt Prozent (sonst die erste Art). Lesen ueber [posTipStart]. */
219
+ tipStart?: PosOpen<PosTipKind>;
200
220
  }
201
221
  /** Aktionen der Kasse, die eine Taste bekommen koennen (Schluessel von `device.shortcuts`). */
202
222
  export declare const POS_SHORTCUT_ACTIONS: readonly ["checkout", "complete", "cancel", "customAmount", "cash", "card", "exactAmount", "receipts", "undoLast", "settings", "logout", "tip", "fullscreen", "clearTendered", "clearCart", "splitPayment", "shiftStatus", "openDrawer", "voucherPayout"];
@@ -256,6 +276,8 @@ export interface PosDeviceSettings {
256
276
  * [POS_DEVICE_OPTIONAL_FIELDS].
257
277
  */
258
278
  drawerId?: string | null;
279
+ /** Breite der rechten Spalte; optional, fehlt sie, gilt `narrow`. Lesen ueber [posCartWidth]. */
280
+ cartWidth?: PosOpen<PosCartWidth>;
259
281
  terminalIp: string;
260
282
  terminalPort: number;
261
283
  terminalVia: PosOpen<PosTerminalVia>;
@@ -291,6 +313,23 @@ export declare function _optionalerWert(wert: unknown, schreiben: boolean): bool
291
313
  * nimmt nur `true`/`false`.
292
314
  */
293
315
  export declare const POS_BUSINESS_OPTIONAL_FIELDS: readonly ["tipKeptByDefault"];
316
+ /**
317
+ * Optionale Betriebs-Einstellungen mit Wertemenge (Backend `BETRIEB_OPTIONAL`, Katalog
318
+ * `KASSE_BETRIEB_WERTE.tipKinds[]` und `.tipStart`): ohne Standardwert, der Server sendet sie nur,
319
+ * wenn sie gespeichert sind. [mergePosSettings] uebernimmt sie, wenn sie die Form haben
320
+ * (`tipKinds` eine nichtleere Liste von Texten, `tipStart` ein Text); den Wert prueft der Schreibweg.
321
+ */
322
+ export declare const POS_BUSINESS_OPTIONAL_CHOICES: readonly ["tipKinds", "tipStart"];
323
+ /** Optionale Geraete-Einstellungen mit Wertemenge (Backend `GERAET_OPTIONAL`, Katalog `KASSE_GERAET_WERTE.cartWidth`). */
324
+ export declare const POS_DEVICE_OPTIONAL_CHOICES: readonly ["cartWidth"];
325
+ /** Hat der Wert die Form eines optionalen Wahlfeldes? Texte, die der Server neu einfuehren koennte, bleiben (kein Altwert 0.x). */
326
+ export declare function _optionalerWahlwert(feld: string, wert: unknown): boolean;
327
+ /** Wirksame Trinkgeld-Arten: die gespeicherten, sonst alle drei. */
328
+ export declare function posTipKinds(business: Readonly<Partial<PosBusinessSettings>> | null | undefined): PosOpen<PosTipKind>[];
329
+ /** Wirksame Start-Art: die gespeicherte, wenn sie angeboten wird, sonst Prozent (oder die erste angebotene Art). */
330
+ export declare function posTipStart(business: Readonly<Partial<PosBusinessSettings>> | null | undefined): PosOpen<PosTipKind>;
331
+ /** Wirksame Breite der rechten Spalte; ohne Angabe `narrow`. */
332
+ export declare function posCartWidth(device: Readonly<Partial<PosDeviceSettings>> | null | undefined): PosOpen<PosCartWidth>;
294
333
  /** Bar-Trinkgeld „gleich behalten“ vorbelegt? Fehlt die Einstellung, gilt aus. */
295
334
  export declare function posTipKeptByDefault(business: Readonly<Partial<PosBusinessSettings>> | null | undefined): boolean;
296
335
  /**
@@ -25,6 +25,16 @@ export const FONT_SIZE = ['S', 'M', 'L', 'XL'];
25
25
  export const WATERMARK = ['off', 'login', 'everywhere'];
26
26
  export const QUANTITY = ['off', 'x', 'kg'];
27
27
  export const TIP_MODE = ['amount', 'total', 'both'];
28
+ /**
29
+ * Trinkgeld-Arten, die die Kasse anbietet (`business.tipKinds`): Prozent, Aufrunden
30
+ * (der Gast zahlt auf einen runden Betrag) und Gesamt (der Gast nennt den Betrag, den er insgesamt zahlt).
31
+ * `business.tipStart` ist die zuerst offene Art und liegt immer unter den angebotenen.
32
+ */
33
+ export const TIP_KINDS = ['percent', 'round_up', 'total'];
34
+ /** Die zuerst offene Trinkgeld-Art (`business.tipStart`): dieselben Werte wie [TIP_KINDS]. */
35
+ export const TIP_START = TIP_KINDS;
36
+ /** Breite der rechten Spalte (Korb) an diesem Geraet (`device.cartWidth`); in der schmalen Ansicht ohne Wirkung. */
37
+ export const CART_WIDTH = ['narrow', 'medium', 'wide'];
28
38
  export const CHECKOUT_MODE = ['page', 'panel'];
29
39
  /** Kartenanbieter: Karte gibt es erst mit eingerichtetem Anbieter; 'external' = eigenes Terminal ohne Anbindung. */
30
40
  export const CARD_PROVIDER = ['none', 'external', 'gptom', 'hobex', 'mypos', 'stripe'];
@@ -202,6 +212,41 @@ const OPTIONALE = new Set(POS_DEVICE_OPTIONAL_FIELDS);
202
212
  */
203
213
  export const POS_BUSINESS_OPTIONAL_FIELDS = Object.freeze(['tipKeptByDefault']);
204
214
  const OPTIONALE_SCHALTER = new Set(POS_BUSINESS_OPTIONAL_FIELDS);
215
+ /**
216
+ * Optionale Betriebs-Einstellungen mit Wertemenge (Backend `BETRIEB_OPTIONAL`, Katalog
217
+ * `KASSE_BETRIEB_WERTE.tipKinds[]` und `.tipStart`): ohne Standardwert, der Server sendet sie nur,
218
+ * wenn sie gespeichert sind. [mergePosSettings] uebernimmt sie, wenn sie die Form haben
219
+ * (`tipKinds` eine nichtleere Liste von Texten, `tipStart` ein Text); den Wert prueft der Schreibweg.
220
+ */
221
+ export const POS_BUSINESS_OPTIONAL_CHOICES = Object.freeze(['tipKinds', 'tipStart']);
222
+ /** Optionale Geraete-Einstellungen mit Wertemenge (Backend `GERAET_OPTIONAL`, Katalog `KASSE_GERAET_WERTE.cartWidth`). */
223
+ export const POS_DEVICE_OPTIONAL_CHOICES = Object.freeze(['cartWidth']);
224
+ /** Hat der Wert die Form eines optionalen Wahlfeldes? Texte, die der Server neu einfuehren koennte, bleiben (kein Altwert 0.x). */
225
+ export function _optionalerWahlwert(feld, wert) {
226
+ if (feld === 'tipKinds') {
227
+ return Array.isArray(wert) && wert.length > 0 && wert.every((x) => typeof x === 'string' && !_istAltwert0x('tipKinds', x));
228
+ }
229
+ return typeof wert === 'string' && wert !== '' && !_istAltwert0x(feld, wert);
230
+ }
231
+ const OPTIONALE_WAHL = new Set([...POS_BUSINESS_OPTIONAL_CHOICES, ...POS_DEVICE_OPTIONAL_CHOICES]);
232
+ /** Wirksame Trinkgeld-Arten: die gespeicherten, sonst alle drei. */
233
+ export function posTipKinds(business) {
234
+ const k = business?.tipKinds;
235
+ return Array.isArray(k) && k.length > 0 ? [...k] : [...TIP_KINDS];
236
+ }
237
+ /** Wirksame Start-Art: die gespeicherte, wenn sie angeboten wird, sonst Prozent (oder die erste angebotene Art). */
238
+ export function posTipStart(business) {
239
+ const arten = posTipKinds(business);
240
+ const start = business?.tipStart;
241
+ if (typeof start === 'string' && arten.includes(start))
242
+ return start;
243
+ return arten.includes('percent') ? 'percent' : arten[0];
244
+ }
245
+ /** Wirksame Breite der rechten Spalte; ohne Angabe `narrow`. */
246
+ export function posCartWidth(device) {
247
+ const w = device?.cartWidth;
248
+ return typeof w === 'string' && w !== '' ? w : 'narrow';
249
+ }
205
250
  /** Bar-Trinkgeld „gleich behalten“ vorbelegt? Fehlt die Einstellung, gilt aus. */
206
251
  export function posTipKeptByDefault(business) {
207
252
  return !!business && business.tipKeptByDefault === true;
@@ -216,13 +261,13 @@ export const POS_BUSINESS_VALUES = Object.freeze({
216
261
  tileStyle: TILE_STYLE, autoLogoutMinutes: AUTO_LOGOUT_MINUTES, quantity: QUANTITY, discount: DISCOUNT,
217
262
  cardProvider: CARD_PROVIDER, tipMode: TIP_MODE, checkoutMode: CHECKOUT_MODE, receiptOutput: RECEIPT_OUTPUT,
218
263
  doneScreenSeconds: DONE_SCREEN_SECONDS, watermarkSide: WATERMARK_SIDE, watermarkStrength: WATERMARK_STRENGTH,
219
- logoScale: LOGO_SCALE, watermarkScale: WATERMARK_SCALE,
264
+ logoScale: LOGO_SCALE, watermarkScale: WATERMARK_SCALE, tipKinds: TIP_KINDS, tipStart: TIP_START,
220
265
  });
221
266
  /** Wie [POS_BUSINESS_VALUES] fuer die Geraete-Einstellungen. */
222
267
  export const POS_DEVICE_VALUES = Object.freeze({
223
268
  layout: LAYOUT, categoryPosition: CATEGORY_POSITION, tileHeight: TILE_HEIGHT, printerType: PRINTER_TYPE,
224
269
  paperSize: PAPER_SIZE, codePage: CODE_PAGE, cut: CUT, qrMode: QR_MODE, drawerAutoOpen: DRAWER_AUTO_OPEN,
225
- terminalVia: TERMINAL_VIA, terminalType: TERMINAL_TYPE,
270
+ terminalVia: TERMINAL_VIA, terminalType: TERMINAL_TYPE, cartWidth: CART_WIDTH,
226
271
  });
227
272
  /** Eigene Eigenschaft, nie eine geerbte (`toString`, `constructor`, `__proto__`). */
228
273
  const eigen = (o, k) => Object.prototype.hasOwnProperty.call(o, k);
@@ -251,6 +296,9 @@ const ALTWERTE_0X = Object.freeze({
251
296
  drawerAutoOpen: ['bar', 'immer', 'nie'],
252
297
  terminalVia: ['direkt'],
253
298
  terminalType: ['keins'],
299
+ tipKinds: ['prozent', 'aufrunden', 'gesamt'],
300
+ tipStart: ['prozent', 'aufrunden', 'gesamt'],
301
+ cartWidth: ['schmal', 'mittel', 'breit'],
254
302
  });
255
303
  /** Tasten-Aktionen der inneren Form (0.x). */
256
304
  const ALTAKTIONEN_0X = new Set([
@@ -291,6 +339,8 @@ export function mergePosSettings(standard, stored) {
291
339
  out[key] = wert;
292
340
  if (OPTIONALE_SCHALTER.has(key) && typeof wert === 'boolean')
293
341
  out[key] = wert;
342
+ if (OPTIONALE_WAHL.has(key) && _optionalerWahlwert(key, wert))
343
+ out[key] = Array.isArray(wert) ? [...wert] : wert;
294
344
  continue;
295
345
  }
296
346
  const wert = stored[key];
@@ -348,7 +398,14 @@ export function unknownPosSettingValues(settings) {
348
398
  const erlaubt = mengen[k];
349
399
  if (!erlaubt || !eigen(block, k))
350
400
  continue;
351
- if (!erlaubt.includes(block[k]))
401
+ const wert = block[k];
402
+ // Eine Liste (tipKinds): unbekannt, sobald ein Eintrag fremd ist.
403
+ if (Array.isArray(wert)) {
404
+ if (wert.some((e) => !erlaubt.includes(e)))
405
+ raus.push(`${teil}.${k}`);
406
+ continue;
407
+ }
408
+ if (!erlaubt.includes(wert))
352
409
  raus.push(`${teil}.${k}`);
353
410
  }
354
411
  };
@@ -892,6 +892,29 @@ declare const MELDUNGEN_ROH: {
892
892
  readonly placeholders: readonly ["target"];
893
893
  readonly only: readonly ["app"];
894
894
  };
895
+ readonly 'shift.started_taken_over': {
896
+ readonly text: "Schicht {number} hat begonnen – mit {amount} in der Lade, übernommen von Schicht {from} ({time}).";
897
+ readonly placeholders: readonly ["number", "amount", "from", "time"];
898
+ };
899
+ readonly 'tip.summary': {
900
+ readonly text: "Trinkgeld {tip} · der Gast zahlt {total}";
901
+ readonly placeholders: readonly ["tip", "total"];
902
+ };
903
+ readonly 'tip.total_below_sum': {
904
+ readonly text: "Der Betrag liegt unter der Summe.";
905
+ };
906
+ readonly 'shift.interim_saved': {
907
+ readonly text: "Zählung festgehalten.";
908
+ };
909
+ readonly 'shift.finish_step_first': {
910
+ readonly text: "Erst den Schritt rechts abschließen oder abbrechen.";
911
+ };
912
+ readonly 'tip.revenue_hint': {
913
+ readonly text: "Steuerpflichtiges Trinkgeld zählt als Umsatz des Betriebs und wird nicht ausgezahlt.";
914
+ };
915
+ readonly 'tip.unassigned_hint': {
916
+ readonly text: "Trinkgeld ohne angemeldeten Benutzer.";
917
+ };
895
918
  };
896
919
  export type MessageKey = keyof typeof MELDUNGEN_ROH;
897
920
  export declare const MESSAGES: Record<MessageKey, TextEntry>;
@@ -1683,6 +1706,9 @@ declare const BESCHRIFTUNGEN_ROH: {
1683
1706
  readonly 'cash_movement.type_handover_difference': {
1684
1707
  readonly text: "Übergabedifferenz";
1685
1708
  };
1709
+ readonly 'cash_movement.type_interim_difference': {
1710
+ readonly text: "Zwischenzählung";
1711
+ };
1686
1712
  readonly 'shift_receipt.title_close': {
1687
1713
  readonly text: "Schichtabschluss";
1688
1714
  };
@@ -2084,6 +2110,19 @@ declare const BESCHRIFTUNGEN_ROH: {
2084
2110
  readonly 'tile_prompt.apply_anyway': {
2085
2111
  readonly text: "Trotzdem übernehmen";
2086
2112
  };
2113
+ readonly 'addons.title': {
2114
+ readonly text: "Zusätze zu {name}";
2115
+ readonly placeholders: readonly ["name"];
2116
+ };
2117
+ readonly 'addons.none': {
2118
+ readonly text: "Ohne Zusatz";
2119
+ };
2120
+ readonly 'addons.done': {
2121
+ readonly text: "Fertig";
2122
+ };
2123
+ readonly 'addons.open': {
2124
+ readonly text: "Zusätze";
2125
+ };
2087
2126
  readonly 'voucher.tab': {
2088
2127
  readonly text: "Gutscheine";
2089
2128
  };
@@ -2496,6 +2535,272 @@ declare const BESCHRIFTUNGEN_ROH: {
2496
2535
  readonly text: "Nullbeleg {number} erstellt, {time}";
2497
2536
  readonly placeholders: readonly ["number", "time"];
2498
2537
  };
2538
+ readonly 'zero_receipt.done_title': {
2539
+ readonly text: "Nullbeleg erstellt";
2540
+ };
2541
+ readonly 'zero_receipt.back': {
2542
+ readonly text: "Zurück zur Prüfung";
2543
+ };
2544
+ readonly 'dep.export': {
2545
+ readonly text: "DEP exportieren";
2546
+ };
2547
+ readonly 'dep.period_question': {
2548
+ readonly text: "Welcher Zeitraum?";
2549
+ };
2550
+ readonly 'common.close': {
2551
+ readonly text: "Schließen";
2552
+ };
2553
+ readonly 'shift.state_closed': {
2554
+ readonly text: "Schicht geschlossen";
2555
+ };
2556
+ readonly 'shift.start_title': {
2557
+ readonly text: "Schicht beginnen";
2558
+ };
2559
+ readonly 'shift.band_closed': {
2560
+ readonly text: "Zum Verkaufen rechts die Schicht beginnen.";
2561
+ };
2562
+ readonly 'shift.band_closing': {
2563
+ readonly text: "Verkaufen ist pausiert, bis du fertig bist oder abbrichst.";
2564
+ };
2565
+ readonly 'shift.band_interim': {
2566
+ readonly text: "Verkaufen ist kurz pausiert.";
2567
+ };
2568
+ readonly 'shift.band_cash': {
2569
+ readonly text: "Zum Verkaufen auf die Kacheln tippen.";
2570
+ };
2571
+ readonly 'tip.revenue_title': {
2572
+ readonly text: "Als Umsatz erfasst";
2573
+ };
2574
+ readonly 'tip.revenue_badge': {
2575
+ readonly text: "Umsatz";
2576
+ };
2577
+ readonly 'tip.unassigned': {
2578
+ readonly text: "Nicht zugeordnet";
2579
+ };
2580
+ readonly 'shift.last_shift': {
2581
+ readonly text: "Letzte Schicht";
2582
+ };
2583
+ readonly 'shift.in_drawer_by_system': {
2584
+ readonly text: "Laut Kasse in der Lade";
2585
+ };
2586
+ readonly 'shift.take_over_amount': {
2587
+ readonly text: "{amount} übernehmen";
2588
+ readonly placeholders: readonly ["amount"];
2589
+ };
2590
+ readonly 'shift.top_up': {
2591
+ readonly text: "Auffüllen";
2592
+ };
2593
+ readonly 'shift.missing': {
2594
+ readonly text: "fehlen {amount}";
2595
+ readonly placeholders: readonly ["amount"];
2596
+ };
2597
+ readonly 'shift.count_coins': {
2598
+ readonly text: "Scheine und Münzen zählen";
2599
+ };
2600
+ readonly 'shift.count_please': {
2601
+ readonly text: "Zähl bitte, was in der Lade liegt.";
2602
+ };
2603
+ readonly 'drawer.open_for_count': {
2604
+ readonly text: "Lade öffnen zum Zählen";
2605
+ };
2606
+ readonly 'drawer.open_for_tips': {
2607
+ readonly text: "Lade öffnen für Trinkgeld";
2608
+ };
2609
+ readonly 'drawer.open_for_take': {
2610
+ readonly text: "Lade öffnen zum Entnehmen";
2611
+ };
2612
+ readonly 'shift.close_title_numbered': {
2613
+ readonly text: "Schicht {number} schließen";
2614
+ readonly placeholders: readonly ["number"];
2615
+ };
2616
+ readonly 'shift.closed_title': {
2617
+ readonly text: "Schicht {number} geschlossen";
2618
+ readonly placeholders: readonly ["number"];
2619
+ };
2620
+ readonly 'shift.running_since_drawer': {
2621
+ readonly text: "{drawer} · läuft seit {time} ({duration})";
2622
+ readonly placeholders: readonly ["drawer", "time", "duration"];
2623
+ };
2624
+ readonly 'shift.step_count': {
2625
+ readonly text: "Zählen";
2626
+ };
2627
+ readonly 'shift.step_tips': {
2628
+ readonly text: "Trinkgeld";
2629
+ };
2630
+ readonly 'shift.step_take': {
2631
+ readonly text: "Entnehmen";
2632
+ };
2633
+ readonly 'shift.step_done': {
2634
+ readonly text: "Fertig";
2635
+ };
2636
+ readonly 'shift.expected': {
2637
+ readonly text: "In der Lade sollten sein";
2638
+ };
2639
+ readonly 'shift.of_which_cash_tips': {
2640
+ readonly text: "davon Trinkgeld bar";
2641
+ };
2642
+ readonly 'shift.breakdown': {
2643
+ readonly text: "So setzt sich das zusammen";
2644
+ };
2645
+ readonly 'shift.part_opening': {
2646
+ readonly text: "Anfang";
2647
+ };
2648
+ readonly 'shift.part_cash_sales': {
2649
+ readonly text: "Barverkäufe";
2650
+ };
2651
+ readonly 'shift.part_cash_tips': {
2652
+ readonly text: "Trinkgeld bar";
2653
+ };
2654
+ readonly 'shift.part_cancellations': {
2655
+ readonly text: "Storno bar";
2656
+ };
2657
+ readonly 'shift.part_cash_in': {
2658
+ readonly text: "Einzahlungen";
2659
+ };
2660
+ readonly 'shift.part_cash_out': {
2661
+ readonly text: "Ausgaben aus der Lade";
2662
+ };
2663
+ readonly 'shift.part_interim': {
2664
+ readonly text: "Zwischenzählung";
2665
+ };
2666
+ readonly 'tip.who_takes_now': {
2667
+ readonly text: "Wer nimmt sein Trinkgeld jetzt bar mit?";
2668
+ };
2669
+ readonly 'tip.later_hint': {
2670
+ readonly text: "Was du nicht auszahlst, bleibt offen und wird in einer späteren Schicht ausgezahlt.";
2671
+ };
2672
+ readonly 'tip.later': {
2673
+ readonly text: "Später";
2674
+ };
2675
+ readonly 'tip.pay_out': {
2676
+ readonly text: "Auszahlen";
2677
+ };
2678
+ readonly 'tip.pay_out_amount': {
2679
+ readonly text: "{amount} auszahlen";
2680
+ readonly placeholders: readonly ["amount"];
2681
+ };
2682
+ readonly 'shift.now_in_drawer': {
2683
+ readonly text: "Jetzt in der Lade";
2684
+ };
2685
+ readonly 'shift.interim_title': {
2686
+ readonly text: "Schicht {number} zählen";
2687
+ readonly placeholders: readonly ["number"];
2688
+ };
2689
+ readonly 'shift.interim_save': {
2690
+ readonly text: "Zählung festhalten";
2691
+ };
2692
+ readonly 'shift.opening_not_counted': {
2693
+ readonly text: "Anfang nicht gezählt";
2694
+ };
2695
+ readonly 'shift.taken_over_unchecked_by': {
2696
+ readonly text: "{name}, {time}";
2697
+ readonly placeholders: readonly ["name", "time"];
2698
+ };
2699
+ readonly 'shift.taken_over_unchecked': {
2700
+ readonly text: "Schicht {number} wurde ohne Zählen übernommen";
2701
+ readonly placeholders: readonly ["number"];
2702
+ };
2703
+ readonly 'tip.kind_percent': {
2704
+ readonly text: "Prozent";
2705
+ };
2706
+ readonly 'tip.kind_round_up': {
2707
+ readonly text: "Aufrunden";
2708
+ };
2709
+ readonly 'tip.kind_total': {
2710
+ readonly text: "Gesamt";
2711
+ };
2712
+ readonly 'tip.round_to': {
2713
+ readonly text: "auf {amount}";
2714
+ readonly placeholders: readonly ["amount"];
2715
+ };
2716
+ readonly 'tip.guest_pays_total': {
2717
+ readonly text: "Der Gast zahlt insgesamt";
2718
+ };
2719
+ readonly 'tip.remainder_is_tip': {
2720
+ readonly text: "Rest ist Trinkgeld";
2721
+ };
2722
+ readonly 'voucher.section': {
2723
+ readonly text: "Gutschein";
2724
+ };
2725
+ readonly 'voucher.code_placeholder': {
2726
+ readonly text: "Code eingeben oder scannen";
2727
+ };
2728
+ readonly 'settings.cart_width': {
2729
+ readonly text: "Breite der rechten Spalte";
2730
+ };
2731
+ readonly 'settings.cart_width_narrow': {
2732
+ readonly text: "Schmal";
2733
+ };
2734
+ readonly 'settings.cart_width_medium': {
2735
+ readonly text: "Mittel";
2736
+ };
2737
+ readonly 'settings.cart_width_wide': {
2738
+ readonly text: "Breit";
2739
+ };
2740
+ readonly 'shift_receipt.opening_not_counted': {
2741
+ readonly text: "Anfang übernommen, nicht gezählt";
2742
+ };
2743
+ readonly 'shift_receipt.interim_count': {
2744
+ readonly text: "Zwischenzählung";
2745
+ };
2746
+ readonly 'shift_receipt.counted_before_payout': {
2747
+ readonly text: "Gezählt";
2748
+ };
2749
+ readonly 'shift_receipt.difference_part_interim': {
2750
+ readonly text: "davon Zwischenzählung";
2751
+ };
2752
+ readonly 'shift_receipt.difference_part_closing': {
2753
+ readonly text: "davon Abschluss";
2754
+ };
2755
+ readonly 'shift.state_closing': {
2756
+ readonly text: "Schicht wird geschlossen";
2757
+ };
2758
+ readonly 'shift.state_interim': {
2759
+ readonly text: "Zwischenzählung";
2760
+ };
2761
+ readonly 'shift.tips_paid_out': {
2762
+ readonly text: "Trinkgeld ausgezahlt";
2763
+ };
2764
+ readonly 'shift.difference_none': {
2765
+ readonly text: "stimmt";
2766
+ };
2767
+ readonly 'shift.start_new': {
2768
+ readonly text: "Neue Schicht beginnen";
2769
+ };
2770
+ readonly 'shift.drawer_from_to': {
2771
+ readonly text: "{drawer} · {from} bis {to}";
2772
+ readonly placeholders: readonly ["drawer", "from", "to"];
2773
+ };
2774
+ readonly 'shift.running_since_by': {
2775
+ readonly text: "{drawer} · läuft seit {time} ({name})";
2776
+ readonly placeholders: readonly ["drawer", "time", "name"];
2777
+ };
2778
+ readonly 'shift.z_receipt_printed': {
2779
+ readonly text: "Z-Bon gedruckt";
2780
+ };
2781
+ readonly 'shift.count_now': {
2782
+ readonly text: "Jetzt zählen";
2783
+ };
2784
+ readonly 'shift.interim_entry': {
2785
+ readonly text: "Zwischenzählung";
2786
+ };
2787
+ readonly 'drawer.open': {
2788
+ readonly text: "Lade öffnen";
2789
+ };
2790
+ readonly 'time.today_at': {
2791
+ readonly text: "heute {time}";
2792
+ readonly placeholders: readonly ["time"];
2793
+ };
2794
+ readonly 'tip.summary_percent': {
2795
+ readonly text: "Trinkgeld {tip} ({percent} %)";
2796
+ readonly placeholders: readonly ["tip", "percent"];
2797
+ };
2798
+ readonly 'settings.tip_kinds': {
2799
+ readonly text: "Trinkgeld-Arten";
2800
+ };
2801
+ readonly 'settings.tip_start': {
2802
+ readonly text: "Zuerst offen";
2803
+ };
2499
2804
  };
2500
2805
  export type LabelKey = keyof typeof BESCHRIFTUNGEN_ROH;
2501
2806
  export declare const LABELS: Record<LabelKey, TextEntry>;