@kreiseck/kasseneck-api 1.31.0 → 1.32.1

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 (124) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/dist/cjs/client/aufrufe.d.ts +3 -3
  3. package/dist/cjs/client/aufrufe.js +8 -0
  4. package/dist/cjs/client/receipts.d.ts +11 -0
  5. package/dist/cjs/client/receipts.js +28 -2
  6. package/dist/cjs/index.d.ts +2 -2
  7. package/dist/cjs/index.js +8 -5
  8. package/dist/cjs/models/index.d.ts +1 -1
  9. package/dist/cjs/models/index.js +5 -2
  10. package/dist/cjs/models/receipt-errors.d.ts +1 -1
  11. package/dist/cjs/models/receipt-errors.js +9 -0
  12. package/dist/cjs/models/receipt-item.d.ts +44 -2
  13. package/dist/cjs/models/receipt-item.js +56 -1
  14. package/dist/cjs/models/receipt.d.ts +17 -0
  15. package/dist/cjs/models/receipt.js +9 -0
  16. package/dist/cjs/pos/artikel.d.ts +14 -0
  17. package/dist/cjs/pos/artikel.js +3 -0
  18. package/dist/cjs/pos/client.d.ts +1 -0
  19. package/dist/cjs/pos/client.js +3 -0
  20. package/dist/cjs/pos/errors.d.ts +1 -1
  21. package/dist/cjs/pos/errors.js +12 -0
  22. package/dist/cjs/pos/fremdgutschein-artikel.d.ts +3 -2
  23. package/dist/cjs/pos/fremdgutschein-artikel.js +4 -2
  24. package/dist/cjs/pos/index.d.ts +4 -2
  25. package/dist/cjs/pos/index.js +24 -4
  26. package/dist/cjs/pos/leergut.d.ts +60 -0
  27. package/dist/cjs/pos/leergut.js +82 -0
  28. package/dist/cjs/pos/pfand.d.ts +144 -0
  29. package/dist/cjs/pos/pfand.js +382 -0
  30. package/dist/cjs/pos/settings.d.ts +3 -7
  31. package/dist/cjs/pos/settings.js +7 -0
  32. package/dist/cjs/pos/texte.d.ts +72 -0
  33. package/dist/cjs/pos/texte.js +42 -1
  34. package/dist/cjs/receipt/discount.js +3 -0
  35. package/dist/cjs/receipt/due.d.ts +6 -0
  36. package/dist/cjs/receipt/due.js +16 -5
  37. package/dist/cjs/receipt/gutschein-plan.d.ts +7 -1
  38. package/dist/cjs/receipt/gutschein-plan.js +16 -2
  39. package/dist/cjs/receipt/layout.js +108 -2
  40. package/dist/cjs/register/pairing.d.ts +15 -1
  41. package/dist/cjs/register/pairing.js +14 -1
  42. package/dist/cjs/stored/vokabular.d.ts +1 -1
  43. package/dist/cjs/stored/vokabular.js +72 -4
  44. package/dist/cjs/version.d.ts +1 -1
  45. package/dist/cjs/version.js +1 -1
  46. package/dist/esm/client/aufrufe.d.ts +3 -3
  47. package/dist/esm/client/aufrufe.js +8 -0
  48. package/dist/esm/client/receipts.d.ts +11 -0
  49. package/dist/esm/client/receipts.js +29 -3
  50. package/dist/esm/index.d.ts +2 -2
  51. package/dist/esm/index.js +2 -2
  52. package/dist/esm/models/index.d.ts +1 -1
  53. package/dist/esm/models/index.js +1 -1
  54. package/dist/esm/models/receipt-errors.d.ts +1 -1
  55. package/dist/esm/models/receipt-errors.js +9 -0
  56. package/dist/esm/models/receipt-item.d.ts +44 -2
  57. package/dist/esm/models/receipt-item.js +54 -1
  58. package/dist/esm/models/receipt.d.ts +17 -0
  59. package/dist/esm/models/receipt.js +9 -0
  60. package/dist/esm/pos/artikel.d.ts +14 -0
  61. package/dist/esm/pos/artikel.js +3 -0
  62. package/dist/esm/pos/client.d.ts +1 -0
  63. package/dist/esm/pos/client.js +3 -0
  64. package/dist/esm/pos/errors.d.ts +1 -1
  65. package/dist/esm/pos/errors.js +12 -0
  66. package/dist/esm/pos/fremdgutschein-artikel.d.ts +3 -2
  67. package/dist/esm/pos/fremdgutschein-artikel.js +4 -2
  68. package/dist/esm/pos/index.d.ts +4 -2
  69. package/dist/esm/pos/index.js +4 -2
  70. package/dist/esm/pos/leergut.d.ts +60 -0
  71. package/dist/esm/pos/leergut.js +77 -0
  72. package/dist/esm/pos/pfand.d.ts +144 -0
  73. package/dist/esm/pos/pfand.js +371 -0
  74. package/dist/esm/pos/settings.d.ts +3 -7
  75. package/dist/esm/pos/settings.js +7 -0
  76. package/dist/esm/pos/texte.d.ts +72 -0
  77. package/dist/esm/pos/texte.js +40 -0
  78. package/dist/esm/receipt/discount.js +4 -1
  79. package/dist/esm/receipt/due.d.ts +6 -0
  80. package/dist/esm/receipt/due.js +17 -6
  81. package/dist/esm/receipt/gutschein-plan.d.ts +7 -1
  82. package/dist/esm/receipt/gutschein-plan.js +14 -2
  83. package/dist/esm/receipt/layout.js +109 -3
  84. package/dist/esm/register/pairing.d.ts +15 -1
  85. package/dist/esm/register/pairing.js +13 -1
  86. package/dist/esm/stored/vokabular.d.ts +1 -1
  87. package/dist/esm/stored/vokabular.js +72 -4
  88. package/dist/esm/version.d.ts +1 -1
  89. package/dist/esm/version.js +1 -1
  90. package/fixtures/deposit-cases.json +4758 -0
  91. package/fixtures/expected/deposit-return.grid32.txt +28 -0
  92. package/fixtures/expected/deposit-return.grid48.txt +28 -0
  93. package/fixtures/expected/deposit-return.lines.json +275 -0
  94. package/fixtures/expected/deposit-return.sheet32.json +194 -0
  95. package/fixtures/expected/deposit-return.sheet48.json +194 -0
  96. package/fixtures/expected/deposit.grid32.txt +34 -0
  97. package/fixtures/expected/deposit.grid48.txt +32 -0
  98. package/fixtures/expected/deposit.lines.json +316 -0
  99. package/fixtures/expected/deposit.sheet32.json +230 -0
  100. package/fixtures/expected/deposit.sheet48.json +218 -0
  101. package/fixtures/external-voucher-article-cases.json +20 -0
  102. package/fixtures/hobex-hps-codes.json +1 -1
  103. package/fixtures/invoice-api.schema.json +1 -1
  104. package/fixtures/invoice-texts.json +1 -1
  105. package/fixtures/manifest.json +16 -0
  106. package/fixtures/pos-texts.json +66 -1
  107. package/fixtures/receipts/deposit-return.json +63 -0
  108. package/fixtures/receipts/deposit.json +83 -0
  109. package/fixtures/return-code-cases.json +1338 -0
  110. package/fixtures/surface.json +45 -4
  111. package/fixtures/v3/antworten/belege.json +2 -2
  112. package/fixtures/v3/antworten/belegmail.json +2 -2
  113. package/fixtures/v3/antworten/berichte.json +2 -2
  114. package/fixtures/v3/antworten/kasse-belege.json +2 -2
  115. package/fixtures/v3/antworten/kasse.json +428 -13
  116. package/fixtures/v3/antworten/lager.json +1 -1
  117. package/fixtures/v3/antworten/rechnungen.json +2 -2
  118. package/fixtures/v3/antworten/storno.json +2 -2
  119. package/fixtures/v3/stored/belege.json +2 -2
  120. package/fixtures/v3/stored/kasse.json +42 -4
  121. package/fixtures/v3/stored/rechnungen.json +2 -2
  122. package/fixtures/v3/v3-vokabular.json +808 -27
  123. package/fixtures/v3/zahlbetrag-faelle.json +187 -3
  124. package/package.json +1 -1
@@ -0,0 +1,371 @@
1
+ /**
2
+ * Pfand & Leergut an der Kasse: Pfandarten und Einstellungen aus
3
+ * `getKasseSettings` (Block `deposit`), Pfandliste am Artikel und an der
4
+ * Gruppe (`deposits`) und die Pfand-Angaben des Kassenobjekts aus
5
+ * `listRegisterUsersForDevice`. Alles nur Lesen und Schreiben der Formen; die
6
+ * Rechnung (Betrag, Staffel nach Tag) kommt in einem eigenen Modul.
7
+ */
8
+ import { Gtin } from '@kreiseck/validator';
9
+ import { readVatRateByRate } from '../models/enum-payload.js';
10
+ /** Art einer Pfandart: Einweg oder Mehrweg. */
11
+ export const DEPOSIT_KINDS = ['single_use', 'reusable'];
12
+ /** Gebindetyp einer Pfandart (frei, nur zur Anzeige). */
13
+ export const DEPOSIT_TYPES = ['bottle', 'crate', 'keg', 'cup', 'glass', 'other'];
14
+ /** Wer nimmt Leergut an der Kasse zurueck: diese Kasse, eine gemeinsame Stelle oder niemand. */
15
+ export const DEPOSIT_RETURN_MODES = ['here', 'shared', 'none'];
16
+ /** Vorbelegung, ob Getraenke vor Ort getrunken oder mitgenommen werden. */
17
+ export const DEPOSIT_ON_PREMISES_DEFAULTS = ['on_premises', 'takeaway', 'ask'];
18
+ const istObjekt = (w) => w !== null && typeof w === 'object' && !Array.isArray(w);
19
+ const istGanz = (w, min) => Number.isInteger(w) && w >= min;
20
+ function aus(liste, value) {
21
+ return typeof value === 'string' && liste.includes(value) ? value : null;
22
+ }
23
+ function betrag(value) {
24
+ if (!istObjekt(value) || typeof value['from'] !== 'string' || !istGanz(value['cents'], 0))
25
+ return null;
26
+ return { from: value['from'], cents: value['cents'] };
27
+ }
28
+ function pfandart(value) {
29
+ if (!istObjekt(value) || typeof value['id'] !== 'string' || value['id'] === '')
30
+ return null;
31
+ const kind = aus(DEPOSIT_KINDS, value['kind']);
32
+ if (kind == null)
33
+ return null;
34
+ const rate = value['returnRate'];
35
+ return {
36
+ id: value['id'],
37
+ kind,
38
+ name: typeof value['name'] === 'string' ? value['name'] : '',
39
+ type: aus(DEPOSIT_TYPES, value['type']),
40
+ amounts: Array.isArray(value['amounts']) ? value['amounts'].map(betrag).filter((b) => b != null) : [],
41
+ returnRate: typeof rate === 'number' && Number.isFinite(rate) ? rate : null,
42
+ used: value['used'] === true,
43
+ active: value['active'] !== false,
44
+ };
45
+ }
46
+ /**
47
+ * Den Block `deposit` einer Antwort lesen. Kein Objekt (Pfand aus, alter
48
+ * Server) -> `undefined`: das Feld fehlt dann am Modell, es wird nichts erfunden.
49
+ * Eine Pfandart in unbekannter Form faellt weg.
50
+ */
51
+ export function posDepositSettingsFromWire(value) {
52
+ if (!istObjekt(value))
53
+ return undefined;
54
+ return {
55
+ singleUse: value['singleUse'] === true,
56
+ reusable: value['reusable'] === true,
57
+ depositTypes: Array.isArray(value['depositTypes']) ? value['depositTypes'].map(pfandart).filter((a) => a != null) : [],
58
+ };
59
+ }
60
+ /** Die Pfandliste eines Artikels oder einer Gruppe; keine Liste -> `null`, unlesbare Eintraege fallen weg. */
61
+ export function depositEntriesFromWire(value) {
62
+ if (!Array.isArray(value))
63
+ return null;
64
+ const raus = [];
65
+ for (const e of value) {
66
+ if (!istObjekt(e) || typeof e['depositTypeId'] !== 'string' || e['depositTypeId'] === '' || !istGanz(e['quantity'], 1))
67
+ continue;
68
+ raus.push({
69
+ depositTypeId: e['depositTypeId'],
70
+ quantity: e['quantity'],
71
+ ...(typeof e['gtin'] === 'string' && e['gtin'] !== '' ? { gtin: e['gtin'] } : {}),
72
+ ...(typeof e['ownFilling'] === 'boolean' ? { ownFilling: e['ownFilling'] } : {}),
73
+ });
74
+ }
75
+ return raus;
76
+ }
77
+ /** Die Pfand-Angaben eines Kassenobjekts; fehlt der Block oder ist er unbrauchbar -> `undefined`. */
78
+ export function cashRegisterDepositFromWire(value) {
79
+ if (!istObjekt(value))
80
+ return undefined;
81
+ const returns = aus(DEPOSIT_RETURN_MODES, value['returns']);
82
+ const onPremisesDefault = aus(DEPOSIT_ON_PREMISES_DEFAULTS, value['onPremisesDefault']);
83
+ if (returns == null || onPremisesDefault == null)
84
+ return undefined;
85
+ const stelle = value['sharedReturnPoint'];
86
+ return {
87
+ returns,
88
+ onPremisesDefault,
89
+ usualQuantity: istGanz(value['usualQuantity'], 1) ? value['usualQuantity'] : 1,
90
+ sharedReturnPoint: istObjekt(stelle) && typeof stelle['name'] === 'string'
91
+ ? { name: stelle['name'], address: typeof stelle['address'] === 'string' ? stelle['address'] : '' }
92
+ : null,
93
+ };
94
+ }
95
+ // ---------------------------------------------------------------------------------------------------------------
96
+ // Vorschau-Rechnung: dieselben Pfand- und Leergutzeilen wie der Server (`createReceipt`), damit der Korb sie vor
97
+ // dem Buchen zeigt. Vertrag sind die Pruefaelle `fixtures/deposit-cases.json` (Backend `pfand-faelle.json`).
98
+ // ---------------------------------------------------------------------------------------------------------------
99
+ /** EWP-GTIN der Einweg-Pfandzeile (gesetzlich festgelegt). */
100
+ const EWP_GTIN = '9010945000011';
101
+ /** Pfandangaben, wirksam fuer einen Artikel: Artikel vor Gruppe, `[]` = kein Pfand, `null`/fehlend = wie die Gruppe. */
102
+ export function depositsFor(article, group) {
103
+ if (article == null)
104
+ return [];
105
+ if (article.externalVoucher != null)
106
+ return []; // fremde Gutscheine tragen nie Pfand, auch nicht von der Gruppe
107
+ if (Array.isArray(article.deposits))
108
+ return article.deposits;
109
+ if (group != null && Array.isArray(group.deposits))
110
+ return group.deposits;
111
+ return [];
112
+ }
113
+ /** Pfandbetrag in Cent am Wiener Tag `day` (`YYYY-MM-DD`): letzter Eintrag mit `from <= day`, sonst `null`. */
114
+ export function depositAmountOn(type, day) {
115
+ let cents = null;
116
+ for (const e of type.amounts) {
117
+ if (e.from <= day)
118
+ cents = e.cents;
119
+ else
120
+ break;
121
+ }
122
+ return cents;
123
+ }
124
+ const tagFormat = new Intl.DateTimeFormat('en-CA', { timeZone: 'Europe/Vienna', year: 'numeric', month: '2-digit', day: '2-digit' });
125
+ /** Wiener Kalendertag `YYYY-MM-DD` zum Zeitpunkt `nowMs` (nie der UTC-Tag). */
126
+ export function viennaDay(nowMs) {
127
+ const teile = {};
128
+ for (const t of tagFormat.formatToParts(new Date(nowMs)))
129
+ teile[t.type] = t.value;
130
+ return `${teile['year']}-${teile['month']}-${teile['day']}`;
131
+ }
132
+ const istObj = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
133
+ const ganz = (v, min, max) => Number.isInteger(v) && v >= min && v <= max;
134
+ const nachId = (karte, id) => {
135
+ if (karte instanceof Map)
136
+ return karte.get(id);
137
+ return Object.prototype.hasOwnProperty.call(karte, id) ? karte[id] : undefined;
138
+ };
139
+ const fehler = (code) => ({ ok: false, code });
140
+ const OHNE_PFAND = ['tip', 'discount', 'voucher', 'voucher_float', 'deposit', 'deposit_return'];
141
+ const istHaupt = (it) => istObj(it) && !OHNE_PFAND.includes(it['kind']);
142
+ const mengeVon = (it) => (it['amount'] !== undefined && it['amount'] !== null ? it['amount'] : it['quantity']);
143
+ const satzVon = (it) => (it['vat'] !== undefined && it['vat'] !== null ? it['vat'] : it['vatRate']);
144
+ const hatVerweis = (it) => it['addOnOf'] !== undefined && it['addOnOf'] !== null;
145
+ const aktiv = (arten, id) => {
146
+ const a = typeof id === 'string' ? nachId(arten, id) : undefined;
147
+ return a && a.active !== false ? a : null;
148
+ };
149
+ function zeile(kind, art, name, quantity, cents, vatRate) {
150
+ return {
151
+ kind, name, quantity, amount: quantity,
152
+ unitPriceCents: cents, priceOneCents: cents, priceOne: cents / 100, vatRate, vat: vatRate,
153
+ depositTypeId: art.id, depositKind: art.kind,
154
+ };
155
+ }
156
+ function pfandPreis(art, haupt, day, smallBusiness) {
157
+ const cents = depositAmountOn(art, day);
158
+ if (cents === null)
159
+ return null;
160
+ if (art.kind === 'single_use')
161
+ return { cents, vatRate: 0 };
162
+ if (smallBusiness)
163
+ return { cents, vatRate: 0 };
164
+ const satz = satzVon(haupt);
165
+ return typeof satz === 'number' && Number.isFinite(satz) ? { cents, vatRate: satz } : null;
166
+ }
167
+ function abgeleitet(it, input) {
168
+ if (!input.auto || !istHaupt(it) || typeof it['articleId'] !== 'string' || it['articleId'] === '')
169
+ return [];
170
+ const a = nachId(input.articles, it['articleId']);
171
+ if (!a)
172
+ return [];
173
+ const g = a.groupId ? nachId(input.groups, a.groupId) : null;
174
+ return depositsFor(a, g);
175
+ }
176
+ function gtinOk(v) {
177
+ return typeof v === 'string' && Gtin.isValid(v);
178
+ }
179
+ function leergut(it, input) {
180
+ if (!input.cashRegister || input.cashRegister.returns !== 'here')
181
+ return fehler('deposit_return_not_offered');
182
+ if (input.mayReturn === false)
183
+ return fehler('not_permitted');
184
+ const art = aktiv(input.depositTypes, it['depositTypeId']);
185
+ if (!art)
186
+ return fehler('deposit_type_not_found');
187
+ if (art.kind === 'reusable' && art.used !== true)
188
+ return fehler('deposit_type_not_issued');
189
+ const quantity = it['quantity'];
190
+ if (!ganz(quantity, 1, 1000))
191
+ return fehler('invalid_deposit');
192
+ let codes;
193
+ if (it['codes'] !== undefined && it['codes'] !== null) {
194
+ if (!istObj(it['codes']))
195
+ return fehler('invalid_deposit');
196
+ const schluessel = Object.keys(it['codes']);
197
+ if (schluessel.length > 50)
198
+ return fehler('invalid_deposit');
199
+ let summe = 0;
200
+ for (const k of schluessel) {
201
+ const n = it['codes'][k];
202
+ if (!gtinOk(k) || !ganz(n, 1, 1000))
203
+ return fehler('invalid_deposit');
204
+ summe += n;
205
+ }
206
+ if (summe !== quantity)
207
+ return fehler('invalid_deposit');
208
+ codes = { ...it['codes'] };
209
+ }
210
+ const cents = depositAmountOn(art, input.day);
211
+ if (cents === null)
212
+ return fehler('invalid_deposit');
213
+ // Mehrweg-Leergut rechnet mit dem Rueckgabesatz der Pfandart (`returnRate` = Steuersatz), bei Kleinunternehmern 0.
214
+ let vatRate = 0;
215
+ if (art.kind === 'reusable' && !input.smallBusiness) {
216
+ if (art.returnRate === null || !Number.isFinite(art.returnRate))
217
+ return fehler('invalid_deposit');
218
+ vatRate = art.returnRate;
219
+ }
220
+ const z = zeile('deposit_return', art, 'Leergut ' + art.name.replace(/^Pfand /, ''), quantity, -cents, vatRate);
221
+ if (art.kind === 'single_use')
222
+ z['ean'] = EWP_GTIN;
223
+ if (codes)
224
+ z['codes'] = codes;
225
+ return { ok: true, line: z };
226
+ }
227
+ /**
228
+ * Pfand- und Leergutzeilen eines Belegs wie der Server: leitet Pfand zu Artikeln ab (`auto`), prueft ausdrueckliche
229
+ * `deposit`-Zeilen und `deposit_return`-Zeilen und rechnet `addOnOf` und `depositFor` auf die neuen Positionen um.
230
+ * Ohne Pfand-/Leergutzeile und ohne Ableitung kommen die Positionen unveraendert zurueck. Die Fehlercodes sind die
231
+ * von `createReceipt`.
232
+ */
233
+ export function withDepositLines(items, input) {
234
+ const liste = Array.isArray(items) ? items : [];
235
+ const dahinter = new Map();
236
+ const ersetzt = new Map();
237
+ const hinzu = (i, z) => { dahinter.set(i, [...(dahinter.get(i) ?? []), z]); };
238
+ for (let i = 0; i < liste.length; i += 1) {
239
+ const it = liste[i];
240
+ if (!istObj(it))
241
+ continue;
242
+ if (it['kind'] === 'deposit_return') {
243
+ const r = leergut(it, input);
244
+ if (!r.ok)
245
+ return r;
246
+ ersetzt.set(i, r.line);
247
+ continue;
248
+ }
249
+ if (it['kind'] === 'deposit') {
250
+ const verweis = it['depositFor'];
251
+ const haupt = Number.isInteger(verweis) ? liste[verweis] : null;
252
+ if (!istHaupt(haupt))
253
+ return fehler('invalid_deposit');
254
+ if (abgeleitet(haupt, input).length > 0)
255
+ return fehler('deposit_set_by_server');
256
+ const art = aktiv(input.depositTypes, it['depositTypeId']);
257
+ if (!art)
258
+ return fehler('deposit_type_not_found');
259
+ const menge = mengeVon(haupt);
260
+ if (!Number.isInteger(menge) || menge === 0)
261
+ return fehler('invalid_deposit_quantity');
262
+ const quantity = it['quantity'] === undefined || it['quantity'] === null ? menge : it['quantity'];
263
+ if (!Number.isInteger(quantity) || quantity % menge !== 0 || quantity / menge < 1)
264
+ return fehler('invalid_deposit_quantity');
265
+ const preis = pfandPreis(art, haupt, input.day, input.smallBusiness);
266
+ if (!preis)
267
+ return fehler('invalid_deposit');
268
+ const hatGtin = it['gtin'] !== undefined && it['gtin'] !== null;
269
+ if (hatGtin && !gtinOk(it['gtin']))
270
+ return fehler('invalid_deposit');
271
+ if (it['ownFilling'] !== undefined && it['ownFilling'] !== null && typeof it['ownFilling'] !== 'boolean')
272
+ return fehler('invalid_deposit');
273
+ if (it['ownFilling'] === true && !hatGtin)
274
+ return fehler('invalid_deposit');
275
+ const q = quantity;
276
+ const z = zeile('deposit', art, art.name, q, preis.cents, preis.vatRate);
277
+ z['depositFor'] = verweis;
278
+ z['perUnit'] = q / menge;
279
+ if (art.kind === 'single_use')
280
+ z['ean'] = EWP_GTIN;
281
+ if (hatGtin)
282
+ z['gtin'] = it['gtin'];
283
+ if (it['ownFilling'] === true)
284
+ z['ownFilling'] = true;
285
+ ersetzt.set(i, z);
286
+ continue;
287
+ }
288
+ const eintraege = abgeleitet(it, input);
289
+ if (!eintraege.length)
290
+ continue;
291
+ const menge = mengeVon(it);
292
+ const gelten = [];
293
+ for (const e of eintraege) {
294
+ const art = aktiv(input.depositTypes, e.depositTypeId);
295
+ if (!art)
296
+ return fehler('deposit_type_not_found');
297
+ if (art.kind === 'single_use' && input.onPremises === true)
298
+ continue;
299
+ gelten.push({ e, art });
300
+ }
301
+ if (!gelten.length)
302
+ continue;
303
+ if (!Number.isInteger(menge))
304
+ return fehler('invalid_deposit_quantity');
305
+ if (menge === 0)
306
+ continue;
307
+ for (const { e, art } of gelten) {
308
+ const preis = pfandPreis(art, it, input.day, input.smallBusiness);
309
+ if (!preis)
310
+ return fehler('invalid_deposit');
311
+ const z = zeile('deposit', art, art.name, e.quantity * menge, preis.cents, preis.vatRate);
312
+ z['depositFor'] = i;
313
+ z['perUnit'] = e.quantity;
314
+ if (art.kind === 'single_use')
315
+ z['ean'] = EWP_GTIN;
316
+ if (e.gtin)
317
+ z['gtin'] = e.gtin;
318
+ if (e.ownFilling === true)
319
+ z['ownFilling'] = true;
320
+ hinzu(i, z);
321
+ }
322
+ }
323
+ if (!ersetzt.size && !dahinter.size)
324
+ return { ok: true, items: [...liste] };
325
+ const neu = [];
326
+ let verschiebung = 0;
327
+ liste.forEach((_, i) => { neu.push(i + verschiebung); verschiebung += dahinter.get(i)?.length ?? 0; });
328
+ const umgerechnet = (v) => (typeof v === 'number' && Number.isInteger(v) ? neu[v] : undefined);
329
+ const raus = [];
330
+ liste.forEach((it, i) => {
331
+ if (!istObj(it)) {
332
+ raus.push(it);
333
+ return;
334
+ }
335
+ let z = ersetzt.get(i) ?? it;
336
+ if (z['kind'] === 'deposit' && umgerechnet(z['depositFor']) !== undefined)
337
+ z = { ...z, depositFor: umgerechnet(z['depositFor']) };
338
+ else if (hatVerweis(z) && umgerechnet(z['addOnOf']) !== undefined)
339
+ z = { ...z, addOnOf: umgerechnet(z['addOnOf']) };
340
+ raus.push(z);
341
+ for (const d of dahinter.get(i) ?? [])
342
+ raus.push({ ...d, depositFor: neu[i] });
343
+ });
344
+ return { ok: true, items: raus };
345
+ }
346
+ /**
347
+ * Die Leergutzeile zu `quantity` Stueck einer Pfandart, wie `withDepositLines` sie fuer eine
348
+ * `deposit_return`-Eingabe baut (fuer die Korb-Vorschau). Wirft, wenn sich keine Zeile ergibt
349
+ * (unbekannte Pfandart, Menge ausserhalb 1 bis 1000, Mehrweg ohne Rueckgabesatz, ungueltige Codes);
350
+ * ob die Kasse Leergut annimmt, prueft der Aufrufer.
351
+ */
352
+ export function depositReturnLine(type, quantity, options) {
353
+ const r = leergut({ kind: 'deposit_return', depositTypeId: type.id, quantity, ...(options.codes ? { codes: options.codes } : {}) }, { depositTypes: { [type.id]: type }, day: options.day, smallBusiness: options.smallBusiness, cashRegister: { returns: 'here' }, mayReturn: true });
354
+ if (!r.ok)
355
+ throw new Error(`Leergutzeile nicht moeglich: ${r.code}`);
356
+ const l = r.line;
357
+ const item = {
358
+ name: l['name'],
359
+ quantity: l['quantity'],
360
+ vat: readVatRateByRate(l['vatRate']),
361
+ priceCents: l['unitPriceCents'],
362
+ kind: 'deposit_return',
363
+ depositTypeId: l['depositTypeId'],
364
+ depositKind: type.kind,
365
+ };
366
+ if (typeof l['ean'] === 'string')
367
+ item.ean = l['ean'];
368
+ if (l['codes'] !== undefined)
369
+ item.codes = l['codes'];
370
+ return item;
371
+ }
@@ -12,6 +12,7 @@
12
12
  * bis die Buchung geklaert ist (Spec kachel-kasse § 9).
13
13
  */
14
14
  import { type PosVoucherSettings } from './gutschein.js';
15
+ import { type DepositSettings } from './pfand.js';
15
16
  export declare const THEME: readonly ["clear", "warm", "night", "contrast"];
16
17
  export type PosTheme = typeof THEME[number];
17
18
  export declare const FONT_SIZE: readonly ["S", "M", "L", "XL"];
@@ -335,6 +336,8 @@ export interface PosSettings {
335
336
  device: PosDeviceSettings;
336
337
  /** Gutschein-Verkauf der Kasse (Block `vouchers`); ohne Block ist Verkaufen aus. */
337
338
  vouchers: PosVoucherSettings;
339
+ /** Pfand & Leergut (Block `deposit`); fehlt, solange der Betrieb kein Pfand eingeschaltet hat. */
340
+ deposit?: DepositSettings;
338
341
  }
339
342
  export declare const POS_BUSINESS_DEFAULTS: Readonly<PosBusinessSettings>;
340
343
  export declare const POS_DEVICE_DEFAULTS: Readonly<PosDeviceSettings>;
@@ -429,13 +432,6 @@ export declare const _ALTFORM_0X: Readonly<{
429
432
  * dagegen stehen: er kann ein neuer Wert des Servers sein.
430
433
  */
431
434
  export declare function mergePosSettings<T extends object>(standard: Readonly<T>, stored: Partial<T> | null | undefined): T;
432
- /**
433
- * Einen gespeicherten oder zwischengespeicherten Stand `{business, device}`
434
- * lesen: gemischt mit den Standardwerten, ohne Werte und Tasten-Aktionen der
435
- * inneren Form 0.x (siehe [mergePosSettings]). Der Weg fuer jeden Stand, den
436
- * ein Verbraucher selbst abgelegt hat; ein Stand in der inneren Form ergibt
437
- * die Standardwerte, nie einen deutschen Wert und nie einen Absturz.
438
- */
439
435
  export declare function sanitizePosSettings(stored: unknown): PosSettings;
440
436
  /**
441
437
  * Die Felder, deren Wert dieses Paket nicht kennt (neuer Wert des Servers),
@@ -12,6 +12,7 @@
12
12
  * bis die Buchung geklaert ist (Spec kachel-kasse § 9).
13
13
  */
14
14
  import { posVoucherSettingsFromWire } from './gutschein.js';
15
+ import { posDepositSettingsFromWire } from './pfand.js';
15
16
  /*
16
17
  * Jedes Enum steht als Liste zur Laufzeit da, der Typ leitet sich daraus ab
17
18
  * (`typeof LISTE[number]`). So gibt es die Werte nur einmal, und die Zwillinge
@@ -436,6 +437,11 @@ export function mergePosSettings(standard, stored) {
436
437
  * ein Verbraucher selbst abgelegt hat; ein Stand in der inneren Form ergibt
437
438
  * die Standardwerte, nie einen deutschen Wert und nie einen Absturz.
438
439
  */
440
+ /** `{ deposit }`, wenn der Block lesbar ist, sonst nichts: ohne Block fehlt das Feld am Modell. */
441
+ function pfandBlock(wert) {
442
+ const deposit = posDepositSettingsFromWire(wert);
443
+ return deposit ? { deposit } : {};
444
+ }
439
445
  export function sanitizePosSettings(stored) {
440
446
  const roh = stored !== null && typeof stored === 'object' ? stored : {};
441
447
  const teil = (k) => {
@@ -446,6 +452,7 @@ export function sanitizePosSettings(stored) {
446
452
  business: mergePosSettings(POS_BUSINESS_DEFAULTS, teil('business')),
447
453
  device: mergePosSettings(POS_DEVICE_DEFAULTS, teil('device')),
448
454
  vouchers: posVoucherSettingsFromWire(eigen(roh, 'vouchers') ? roh['vouchers'] : undefined),
455
+ ...pfandBlock(eigen(roh, 'deposit') ? roh['deposit'] : undefined),
449
456
  };
450
457
  }
451
458
  /**
@@ -495,6 +495,9 @@ declare const MELDUNGEN_ROH: {
495
495
  readonly 'external_voucher_article.asks_quantity': {
496
496
  readonly text: "Ein fremder Gutschein fragt keine Menge ab.";
497
497
  };
498
+ readonly 'external_voucher_article.deposit': {
499
+ readonly text: "Ein fremder Gutschein hat kein Pfand.";
500
+ };
498
501
  readonly 'external_voucher_article.rate_required': {
499
502
  readonly text: "Ein Einzweckgutschein braucht den Steuersatz, mit dem er verkauft wird.";
500
503
  };
@@ -1005,6 +1008,33 @@ declare const MELDUNGEN_ROH: {
1005
1008
  readonly 'tip.unassigned_hint': {
1006
1009
  readonly text: "Trinkgeld ohne angemeldeten Benutzer.";
1007
1010
  };
1011
+ readonly 'deposit.changed': {
1012
+ readonly text: "Pfand wurde geändert. Bitte Summe prüfen.";
1013
+ };
1014
+ readonly 'deposit_error.not_enabled': {
1015
+ readonly text: "Pfand ist für diesen Betrieb nicht eingeschaltet.";
1016
+ };
1017
+ readonly 'deposit_error.type_not_found': {
1018
+ readonly text: "Diese Pfandart gibt es nicht mehr.";
1019
+ };
1020
+ readonly 'deposit_error.set_by_server': {
1021
+ readonly text: "Das Pfand bucht die Kasse selbst.";
1022
+ };
1023
+ readonly 'deposit_error.invalid_quantity': {
1024
+ readonly text: "Pfand gibt es nur für ganze Stück.";
1025
+ };
1026
+ readonly 'deposit_error.return_not_offered': {
1027
+ readonly text: "Diese Kasse nimmt kein Leergut zurück.";
1028
+ };
1029
+ readonly 'deposit_error.type_not_issued': {
1030
+ readonly text: "Dieses Leergut wurde hier nie verkauft.";
1031
+ };
1032
+ readonly 'deposit_error.follows_item': {
1033
+ readonly text: "Pfand wird mit seinem Artikel storniert.";
1034
+ };
1035
+ readonly 'deposit_error.invalid': {
1036
+ readonly text: "Die Pfand-Angaben stimmen nicht.";
1037
+ };
1008
1038
  };
1009
1039
  export type MessageKey = keyof typeof MELDUNGEN_ROH;
1010
1040
  export declare const MESSAGES: Record<MessageKey, TextEntry>;
@@ -1291,6 +1321,7 @@ export declare const EXTERNAL_VOUCHER_ARTICLE_MESSAGES: {
1291
1321
  readonly stock_tracked: "external_voucher_article.stock_tracked";
1292
1322
  readonly reference: "external_voucher_article.reference";
1293
1323
  readonly asks_quantity: "external_voucher_article.asks_quantity";
1324
+ readonly deposit: "external_voucher_article.deposit";
1294
1325
  readonly rate_required: "external_voucher_article.rate_required";
1295
1326
  readonly invalid_rate: "external_voucher_article.invalid_rate";
1296
1327
  readonly price_required: "external_voucher_article.price_required";
@@ -1337,6 +1368,23 @@ export declare const VOUCHER_ERROR_MESSAGES: {
1337
1368
  export type VoucherMessageCode = keyof typeof VOUCHER_ERROR_MESSAGES;
1338
1369
  /** Der Satz zu einem Gutschein-`code`; `undefined` für jeden anderen Code. */
1339
1370
  export declare function voucherErrorMessage(code: string | undefined | null): MessageKey | undefined;
1371
+ /**
1372
+ * Pfand-Fehler (`/v3`, createReceipt und cancelReceipt): welcher `code` des
1373
+ * Backends welchen Satz bekommt. Kassensprache, keine Rechtssprache.
1374
+ */
1375
+ export declare const DEPOSIT_ERROR_MESSAGES: {
1376
+ readonly deposit_not_enabled: "deposit_error.not_enabled";
1377
+ readonly deposit_type_not_found: "deposit_error.type_not_found";
1378
+ readonly deposit_set_by_server: "deposit_error.set_by_server";
1379
+ readonly invalid_deposit_quantity: "deposit_error.invalid_quantity";
1380
+ readonly deposit_return_not_offered: "deposit_error.return_not_offered";
1381
+ readonly deposit_type_not_issued: "deposit_error.type_not_issued";
1382
+ readonly deposit_follows_item: "deposit_error.follows_item";
1383
+ readonly invalid_deposit: "deposit_error.invalid";
1384
+ };
1385
+ export type DepositMessageCode = keyof typeof DEPOSIT_ERROR_MESSAGES;
1386
+ /** Der Satz zu einem Pfand-`code`; `undefined` für jeden anderen Code. */
1387
+ export declare function depositErrorMessage(code: string | undefined | null): MessageKey | undefined;
1340
1388
  /**
1341
1389
  * Beschriftungen: Knoepfe, Ueberschriften, Zeilennamen – was kein Satz ist.
1342
1390
  *
@@ -3019,6 +3067,30 @@ declare const BESCHRIFTUNGEN_ROH: {
3019
3067
  readonly 'settings.tip_start': {
3020
3068
  readonly text: "Zuerst offen";
3021
3069
  };
3070
+ readonly 'deposit.return': {
3071
+ readonly text: "Leergut";
3072
+ };
3073
+ readonly 'deposit.payout': {
3074
+ readonly text: "Bar auszahlen";
3075
+ };
3076
+ readonly 'deposit.offset': {
3077
+ readonly text: "Mit Einkauf verrechnen";
3078
+ };
3079
+ readonly 'deposit.unknown_code': {
3080
+ readonly text: "Welches Leergut ist das?";
3081
+ };
3082
+ readonly 'deposit.over_usual': {
3083
+ readonly text: "Mehr als üblich – trotzdem annehmen?";
3084
+ };
3085
+ readonly 'deposit.on_premises': {
3086
+ readonly text: "Vor Ort";
3087
+ };
3088
+ readonly 'deposit.takeaway': {
3089
+ readonly text: "Mitnahme";
3090
+ };
3091
+ readonly 'deposit.sum': {
3092
+ readonly text: "Summe Leergut";
3093
+ };
3022
3094
  };
3023
3095
  export type LabelKey = keyof typeof BESCHRIFTUNGEN_ROH;
3024
3096
  export declare const LABELS: Record<LabelKey, TextEntry>;
@@ -251,6 +251,7 @@ const MELDUNGEN_ROH = {
251
251
  'external_voucher_article.stock_tracked': { text: 'Ein fremder Gutschein führt keinen Lagerbestand.' },
252
252
  'external_voucher_article.reference': { text: 'Ein fremder Gutschein fragt keine Referenz ab, die Kasse fragt die Gutscheinnummer.' },
253
253
  'external_voucher_article.asks_quantity': { text: 'Ein fremder Gutschein fragt keine Menge ab.' },
254
+ 'external_voucher_article.deposit': { text: 'Ein fremder Gutschein hat kein Pfand.' },
254
255
  'external_voucher_article.rate_required': { text: 'Ein Einzweckgutschein braucht den Steuersatz, mit dem er verkauft wird.' },
255
256
  'external_voucher_article.invalid_rate': { text: 'Ein Einzweckgutschein braucht einen Steuersatz der Kasse: 20, 13, 10, 4,9, 0 oder 19 %.' },
256
257
  'external_voucher_article.price_required': { text: 'Ein fremder Gutschein braucht einen Preis oder „Betrag beim Antippen eingeben“.' },
@@ -477,6 +478,16 @@ const MELDUNGEN_ROH = {
477
478
  'shift.finish_step_first': { text: 'Erst den Schritt rechts abschließen oder abbrechen.' },
478
479
  'tip.revenue_hint': { text: 'Steuerpflichtiges Trinkgeld zählt als Umsatz des Betriebs und wird nicht ausgezahlt.' },
479
480
  'tip.unassigned_hint': { text: 'Trinkgeld ohne angemeldeten Benutzer.' },
481
+ // --- Pfand und Leergut (1.32.0): Fehlersätze (Zuordnung in DEPOSIT_ERROR_MESSAGES) ---
482
+ 'deposit.changed': { text: 'Pfand wurde geändert. Bitte Summe prüfen.' },
483
+ 'deposit_error.not_enabled': { text: 'Pfand ist für diesen Betrieb nicht eingeschaltet.' },
484
+ 'deposit_error.type_not_found': { text: 'Diese Pfandart gibt es nicht mehr.' },
485
+ 'deposit_error.set_by_server': { text: 'Das Pfand bucht die Kasse selbst.' },
486
+ 'deposit_error.invalid_quantity': { text: 'Pfand gibt es nur für ganze Stück.' },
487
+ 'deposit_error.return_not_offered': { text: 'Diese Kasse nimmt kein Leergut zurück.' },
488
+ 'deposit_error.type_not_issued': { text: 'Dieses Leergut wurde hier nie verkauft.' },
489
+ 'deposit_error.follows_item': { text: 'Pfand wird mit seinem Artikel storniert.' },
490
+ 'deposit_error.invalid': { text: 'Die Pfand-Angaben stimmen nicht.' },
480
491
  };
481
492
  // Auf den gemeinsamen Typ gebracht: `Object.entries(MESSAGES)` liefert sonst
482
493
  // pro Schluessel den engsten Literaltyp, und `placeholders`/`only` waeren nur
@@ -727,6 +738,7 @@ export const EXTERNAL_VOUCHER_ARTICLE_MESSAGES = {
727
738
  stock_tracked: 'external_voucher_article.stock_tracked',
728
739
  reference: 'external_voucher_article.reference',
729
740
  asks_quantity: 'external_voucher_article.asks_quantity',
741
+ deposit: 'external_voucher_article.deposit',
730
742
  rate_required: 'external_voucher_article.rate_required',
731
743
  invalid_rate: 'external_voucher_article.invalid_rate',
732
744
  price_required: 'external_voucher_article.price_required',
@@ -780,6 +792,25 @@ export function voucherErrorMessage(code) {
780
792
  const fehler = VOUCHER_ERROR_MESSAGES;
781
793
  return code !== undefined && code !== null ? fehler[code] : undefined;
782
794
  }
795
+ /**
796
+ * Pfand-Fehler (`/v3`, createReceipt und cancelReceipt): welcher `code` des
797
+ * Backends welchen Satz bekommt. Kassensprache, keine Rechtssprache.
798
+ */
799
+ export const DEPOSIT_ERROR_MESSAGES = {
800
+ deposit_not_enabled: 'deposit_error.not_enabled',
801
+ deposit_type_not_found: 'deposit_error.type_not_found',
802
+ deposit_set_by_server: 'deposit_error.set_by_server',
803
+ invalid_deposit_quantity: 'deposit_error.invalid_quantity',
804
+ deposit_return_not_offered: 'deposit_error.return_not_offered',
805
+ deposit_type_not_issued: 'deposit_error.type_not_issued',
806
+ deposit_follows_item: 'deposit_error.follows_item',
807
+ invalid_deposit: 'deposit_error.invalid',
808
+ };
809
+ /** Der Satz zu einem Pfand-`code`; `undefined` für jeden anderen Code. */
810
+ export function depositErrorMessage(code) {
811
+ const fehler = DEPOSIT_ERROR_MESSAGES;
812
+ return code !== undefined && code !== null && Object.prototype.hasOwnProperty.call(fehler, code) ? fehler[code] : undefined;
813
+ }
783
814
  /**
784
815
  * Beschriftungen: Knoepfe, Ueberschriften, Zeilennamen – was kein Satz ist.
785
816
  *
@@ -1424,6 +1455,15 @@ const BESCHRIFTUNGEN_ROH = {
1424
1455
  'tip.summary_percent': { text: 'Trinkgeld {tip} ({percent} %)', placeholders: ['tip', 'percent'] },
1425
1456
  'settings.tip_kinds': { text: 'Trinkgeld-Arten' },
1426
1457
  'settings.tip_start': { text: 'Zuerst offen' },
1458
+ // --- Pfand und Leergut (1.32.0) ---
1459
+ 'deposit.return': { text: 'Leergut' },
1460
+ 'deposit.payout': { text: 'Bar auszahlen' },
1461
+ 'deposit.offset': { text: 'Mit Einkauf verrechnen' },
1462
+ 'deposit.unknown_code': { text: 'Welches Leergut ist das?' },
1463
+ 'deposit.over_usual': { text: 'Mehr als üblich – trotzdem annehmen?' },
1464
+ 'deposit.on_premises': { text: 'Vor Ort' },
1465
+ 'deposit.takeaway': { text: 'Mitnahme' },
1466
+ 'deposit.sum': { text: 'Summe Leergut' },
1427
1467
  };
1428
1468
  export const LABELS = BESCHRIFTUNGEN_ROH;
1429
1469
  /**
@@ -1,4 +1,4 @@
1
- import { receiptItemTotalCents } from '../models/receipt-item.js';
1
+ import { isDepositItem, isDepositReturnItem, receiptItemTotalCents } from '../models/receipt-item.js';
2
2
  /**
3
3
  * Rabatt als negative Position(en) — eine je Steuersatz, anteilig zum
4
4
  * Bruttoumsatz dieses Satzes. So stimmt die MwSt-Tabelle des Belegs immer, das
@@ -18,6 +18,9 @@ export function distributeDiscount(items, discountCents, name = 'Rabatt') {
18
18
  // Umsatz je Steuersatz (nur positive Positionen -- Rabatte/Stornos zaehlen nicht mit)
19
19
  const gruppen = new Map();
20
20
  for (const p of items) {
21
+ // Pfand und Leergut werden nie rabattiert (durchlaufend, Spec E17).
22
+ if (isDepositItem(p) || isDepositReturnItem(p))
23
+ continue;
21
24
  const betrag = receiptItemTotalCents(p);
22
25
  if (betrag <= 0)
23
26
  continue;
@@ -151,6 +151,12 @@ export interface ReceiptDueBreakdown {
151
151
  valueVoucherFlowCents: number;
152
152
  /** Toepfe je auf Cent gerundet; `null` bei Start- und Nullbeleg. */
153
153
  bucketsCents: ReceiptDueBuckets | null;
154
+ /**
155
+ * `'deposit'`: der negative Zahlbetrag ist eine Leergut-Auszahlung (Beleg mit Leergut, Betrag hoechstens die
156
+ * Leergutsumme): genau eine Barzahlung ueber den Betrag, ohne Trinkgeld und ohne `tendered`. Ware fuehrt nie zu
157
+ * einer Auszahlung. Fehlt sonst.
158
+ */
159
+ payout?: 'deposit';
154
160
  }
155
161
  /**
156
162
  * Warum sich der Zahlbetrag nicht rechnen laesst. Fest wie ein Backend-Code;