@kreiseck/kasseneck-api 1.31.0 → 1.32.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 (119) hide show
  1. package/CHANGELOG.md +16 -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 +14 -0
  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/index.d.ts +4 -2
  23. package/dist/cjs/pos/index.js +24 -4
  24. package/dist/cjs/pos/leergut.d.ts +60 -0
  25. package/dist/cjs/pos/leergut.js +82 -0
  26. package/dist/cjs/pos/pfand.d.ts +144 -0
  27. package/dist/cjs/pos/pfand.js +382 -0
  28. package/dist/cjs/pos/settings.d.ts +3 -7
  29. package/dist/cjs/pos/settings.js +7 -0
  30. package/dist/cjs/pos/texte.d.ts +68 -0
  31. package/dist/cjs/pos/texte.js +40 -1
  32. package/dist/cjs/receipt/discount.js +3 -0
  33. package/dist/cjs/receipt/due.d.ts +6 -0
  34. package/dist/cjs/receipt/due.js +16 -5
  35. package/dist/cjs/receipt/gutschein-plan.d.ts +7 -1
  36. package/dist/cjs/receipt/gutschein-plan.js +16 -2
  37. package/dist/cjs/receipt/layout.js +108 -2
  38. package/dist/cjs/register/pairing.d.ts +15 -1
  39. package/dist/cjs/register/pairing.js +14 -1
  40. package/dist/cjs/stored/vokabular.d.ts +1 -1
  41. package/dist/cjs/stored/vokabular.js +72 -4
  42. package/dist/cjs/version.d.ts +1 -1
  43. package/dist/cjs/version.js +1 -1
  44. package/dist/esm/client/aufrufe.d.ts +3 -3
  45. package/dist/esm/client/aufrufe.js +8 -0
  46. package/dist/esm/client/receipts.d.ts +11 -0
  47. package/dist/esm/client/receipts.js +14 -0
  48. package/dist/esm/index.d.ts +2 -2
  49. package/dist/esm/index.js +2 -2
  50. package/dist/esm/models/index.d.ts +1 -1
  51. package/dist/esm/models/index.js +1 -1
  52. package/dist/esm/models/receipt-errors.d.ts +1 -1
  53. package/dist/esm/models/receipt-errors.js +9 -0
  54. package/dist/esm/models/receipt-item.d.ts +44 -2
  55. package/dist/esm/models/receipt-item.js +54 -1
  56. package/dist/esm/models/receipt.d.ts +17 -0
  57. package/dist/esm/models/receipt.js +9 -0
  58. package/dist/esm/pos/artikel.d.ts +14 -0
  59. package/dist/esm/pos/artikel.js +3 -0
  60. package/dist/esm/pos/client.d.ts +1 -0
  61. package/dist/esm/pos/client.js +3 -0
  62. package/dist/esm/pos/errors.d.ts +1 -1
  63. package/dist/esm/pos/errors.js +12 -0
  64. package/dist/esm/pos/index.d.ts +4 -2
  65. package/dist/esm/pos/index.js +4 -2
  66. package/dist/esm/pos/leergut.d.ts +60 -0
  67. package/dist/esm/pos/leergut.js +77 -0
  68. package/dist/esm/pos/pfand.d.ts +144 -0
  69. package/dist/esm/pos/pfand.js +371 -0
  70. package/dist/esm/pos/settings.d.ts +3 -7
  71. package/dist/esm/pos/settings.js +7 -0
  72. package/dist/esm/pos/texte.d.ts +68 -0
  73. package/dist/esm/pos/texte.js +38 -0
  74. package/dist/esm/receipt/discount.js +4 -1
  75. package/dist/esm/receipt/due.d.ts +6 -0
  76. package/dist/esm/receipt/due.js +17 -6
  77. package/dist/esm/receipt/gutschein-plan.d.ts +7 -1
  78. package/dist/esm/receipt/gutschein-plan.js +14 -2
  79. package/dist/esm/receipt/layout.js +109 -3
  80. package/dist/esm/register/pairing.d.ts +15 -1
  81. package/dist/esm/register/pairing.js +13 -1
  82. package/dist/esm/stored/vokabular.d.ts +1 -1
  83. package/dist/esm/stored/vokabular.js +72 -4
  84. package/dist/esm/version.d.ts +1 -1
  85. package/dist/esm/version.js +1 -1
  86. package/fixtures/deposit-cases.json +4758 -0
  87. package/fixtures/expected/deposit-return.grid32.txt +28 -0
  88. package/fixtures/expected/deposit-return.grid48.txt +28 -0
  89. package/fixtures/expected/deposit-return.lines.json +275 -0
  90. package/fixtures/expected/deposit-return.sheet32.json +194 -0
  91. package/fixtures/expected/deposit-return.sheet48.json +194 -0
  92. package/fixtures/expected/deposit.grid32.txt +34 -0
  93. package/fixtures/expected/deposit.grid48.txt +32 -0
  94. package/fixtures/expected/deposit.lines.json +316 -0
  95. package/fixtures/expected/deposit.sheet32.json +230 -0
  96. package/fixtures/expected/deposit.sheet48.json +218 -0
  97. package/fixtures/hobex-hps-codes.json +1 -1
  98. package/fixtures/invoice-api.schema.json +1 -1
  99. package/fixtures/invoice-texts.json +1 -1
  100. package/fixtures/manifest.json +16 -0
  101. package/fixtures/pos-texts.json +62 -1
  102. package/fixtures/receipts/deposit-return.json +63 -0
  103. package/fixtures/receipts/deposit.json +83 -0
  104. package/fixtures/return-code-cases.json +1338 -0
  105. package/fixtures/surface.json +44 -4
  106. package/fixtures/v3/antworten/belege.json +2 -2
  107. package/fixtures/v3/antworten/belegmail.json +2 -2
  108. package/fixtures/v3/antworten/berichte.json +2 -2
  109. package/fixtures/v3/antworten/kasse-belege.json +2 -2
  110. package/fixtures/v3/antworten/kasse.json +428 -13
  111. package/fixtures/v3/antworten/lager.json +1 -1
  112. package/fixtures/v3/antworten/rechnungen.json +2 -2
  113. package/fixtures/v3/antworten/storno.json +2 -2
  114. package/fixtures/v3/stored/belege.json +2 -2
  115. package/fixtures/v3/stored/kasse.json +42 -4
  116. package/fixtures/v3/stored/rechnungen.json +2 -2
  117. package/fixtures/v3/v3-vokabular.json +808 -27
  118. package/fixtures/v3/zahlbetrag-faelle.json +187 -3
  119. package/package.json +1 -1
@@ -109,15 +109,20 @@ function rechne(items, vouchers, receiptType, options) {
109
109
  const fluss = wertgutscheinFlussCents(gutscheine, art);
110
110
  const dueCents = t.zaehlerDeltaCents + fluss;
111
111
  // Ohne Auszahlungen darf der Zahlbetrag nicht negativ werden (Einloesung hoeher als die Summe).
112
- if (plan.mitPlan && dueCents + plan.auszahlungCents < 0) {
112
+ // Leergut ist nie deckbar und darf als Barauszahlung hinausgehen: es zaehlt in diesen Pruefungen nicht mit.
113
+ const leergut = (0, gutschein_plan_js_1.leergutCents)(kunde);
114
+ const nachGutscheinen = dueCents + plan.auszahlungCents - leergut;
115
+ if (plan.mitPlan && nachGutscheinen < 0) {
113
116
  throw new ReceiptDueError('invalid_voucher', 'die Gutscheine uebersteigen die Summe des Belegs.', 'voucher_exceeds_total');
114
117
  }
115
118
  // Ein Gutschein deckt nie das Trinkgeld (Personal wie Inhaber): der Zahlbetrag nach den Gutscheinen
116
119
  // muss die Trinkgeldzeilen tragen. Storno ausgenommen (dort gibt es keinen Plan).
117
120
  const trinkgeld = (0, gutschein_plan_js_1.trinkgeldCents)(kunde);
118
- if (plan.mitPlan && art !== 'cancellation' && trinkgeld > 0 && dueCents + plan.auszahlungCents < trinkgeld) {
121
+ if (plan.mitPlan && art !== 'cancellation' && trinkgeld > 0 && nachGutscheinen < trinkgeld) {
119
122
  throw new ReceiptDueError('invalid_voucher', 'die Gutscheine decken das Trinkgeld.', 'voucher_exceeds_total');
120
123
  }
124
+ // pfand-core.istLeergutAuszahlung: negativer Zahlbetrag eines Verkaufs mit Leergut, hoechstens die Leergutsumme.
125
+ const leergutAuszahlung = art !== 'cancellation' && leergut < 0 && dueCents < 0 && dueCents >= leergut;
121
126
  return {
122
127
  ergebnis: {
123
128
  dueCents,
@@ -131,6 +136,7 @@ function rechne(items, vouchers, receiptType, options) {
131
136
  amountRateSpecial: euroToCent(t.amountRateSpecial),
132
137
  amountRatOthers: euroToCent(t.amountRatOthers),
133
138
  },
139
+ ...(leergutAuszahlung ? { payout: 'deposit' } : {}),
134
140
  },
135
141
  kunde,
136
142
  minusJeTopf: plan.minusJeTopf,
@@ -430,10 +436,14 @@ const FUENF = ['amountRateStandard', 'amountRateReduced1', 'amountRateReduced2',
430
436
  /** `beleg-toepfe.belegToepfe`, Schritt fuer Schritt. */
431
437
  function belegToepfe(positionen, gutscheine) {
432
438
  const t = { amountRateStandard: 0, amountRateReduced1: 0, amountRateReduced2: 0, amountRateZero: 0, amountRateSpecial: 0, amountRatOthers: 0 };
433
- let personal = 0;
439
+ // Durchlaufende Posten (beleg-toepfe.durchlaufUndRest): Personal-Trinkgeld im 0-%-Topf, Pfand und Leergut im Topf ihres
440
+ // Satzes (Einweg hat 0 %, also Null). Sie liegen ungekuerzt im Topf, nach dem Rabatt, und zaehlen nicht in dessen Deckel.
441
+ const durchlauf = { amountRateStandard: 0, amountRateReduced1: 0, amountRateReduced2: 0, amountRateZero: 0, amountRateSpecial: 0, amountRatOthers: 0 };
434
442
  for (const p of positionen) {
435
443
  if (p.tip === 'staff')
436
- personal += p.amount * p.priceOne;
444
+ durchlauf.amountRateZero += p.amount * p.priceOne;
445
+ else if ((0, gutschein_plan_js_1.istPfandZeile)(p))
446
+ durchlauf[(0, gutschein_plan_js_1.topfFuerSatz)(p.vat)] += p.amount * p.priceOne;
437
447
  else
438
448
  t[(0, gutschein_plan_js_1.topfFuerSatz)(p.vat)] += p.priceOne * p.amount;
439
449
  }
@@ -466,7 +476,8 @@ function belegToepfe(positionen, gutscheine) {
466
476
  t[n] = (cents[i] - anteil[i]) / 100;
467
477
  });
468
478
  }
469
- t.amountRateZero += personal;
479
+ for (const n of [...FUENF, 'amountRatOthers'])
480
+ t[n] += durchlauf[n];
470
481
  const zaehlerDeltaCents = euroToCent(t.amountRateStandard) + euroToCent(t.amountRateReduced1) + euroToCent(t.amountRateReduced2) +
471
482
  euroToCent(t.amountRateZero) + euroToCent(t.amountRateSpecial) + euroToCent(t.amountRatOthers);
472
483
  return { ...t, zaehlerDeltaCents };
@@ -113,8 +113,14 @@ export interface PlanFehler {
113
113
  type TopfName = 'amountRateStandard' | 'amountRateReduced1' | 'amountRateReduced2' | 'amountRateZero' | 'amountRateSpecial' | 'amountRatOthers';
114
114
  /** `vat-buckets.bucketFuerSatz`. */
115
115
  export declare function topfFuerSatz(vat: number): TopfName;
116
- /** Position, die ein Gutschein decken darf: weder Trinkgeld noch Gutscheinzeile. */
116
+ /** Pfand- oder Leergutzeile: durchlaufend wie das Trinkgeld, nie rabattiert, nie von einem Gutschein gedeckt. */
117
+ export declare function istPfandZeile(p: {
118
+ kind?: string;
119
+ }): boolean;
120
+ /** Position, die ein Gutschein decken darf: weder Trinkgeld noch Gutscheinzeile noch Pfand oder Leergut (E18). */
117
121
  export declare function istDeckbar(p: Innen): boolean;
122
+ /** Summe der Leergutzeilen in Cent (<= 0), wie `pfand-core.leergutCents`: Menge x Einzelpreis, auf Cent gerundet. */
123
+ export declare function leergutCents(positionen: readonly Innen[]): number;
118
124
  /** Summe der Trinkgeldzeilen (Personal und Inhaber) in Cent, wie `centSumme(kunde.filter(istTip))` im Backend. */
119
125
  export declare function trinkgeldCents(kunde: readonly Innen[]): number;
120
126
  /** Wie beleg-toepfe: Euro in Positionsreihenfolge aufsummieren, erst die Summe auf Cent runden. */
@@ -2,7 +2,9 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.VOUCHER_ZERO_RATE_BUCKET_FROM = void 0;
4
4
  exports.topfFuerSatz = topfFuerSatz;
5
+ exports.istPfandZeile = istPfandZeile;
5
6
  exports.istDeckbar = istDeckbar;
7
+ exports.leergutCents = leergutCents;
6
8
  exports.trinkgeldCents = trinkgeldCents;
7
9
  exports.centSumme = centSumme;
8
10
  exports.kuSaetze = kuSaetze;
@@ -34,9 +36,21 @@ const TOPF_REIHENFOLGE = ['amountRateStandard', 'amountRateReduced1', 'amountRat
34
36
  function istGutscheinZeile(p) {
35
37
  return p.kind !== undefined && KINDS.includes(p.kind);
36
38
  }
37
- /** Position, die ein Gutschein decken darf: weder Trinkgeld noch Gutscheinzeile. */
39
+ /** Pfand- oder Leergutzeile: durchlaufend wie das Trinkgeld, nie rabattiert, nie von einem Gutschein gedeckt. */
40
+ function istPfandZeile(p) {
41
+ return p.kind === 'deposit' || p.kind === 'deposit_return';
42
+ }
43
+ /** Position, die ein Gutschein decken darf: weder Trinkgeld noch Gutscheinzeile noch Pfand oder Leergut (E18). */
38
44
  function istDeckbar(p) {
39
- return p.tip == null && p.kind !== 'tip' && !istGutscheinZeile(p);
45
+ return p.tip == null && p.kind !== 'tip' && !istGutscheinZeile(p) && !istPfandZeile(p);
46
+ }
47
+ /** Summe der Leergutzeilen in Cent (<= 0), wie `pfand-core.leergutCents`: Menge x Einzelpreis, auf Cent gerundet. */
48
+ function leergutCents(positionen) {
49
+ let summe = 0;
50
+ for (const p of positionen)
51
+ if (p.kind === 'deposit_return')
52
+ summe += Math.round(p.amount * Math.round(p.priceOne * 100));
53
+ return summe;
40
54
  }
41
55
  /** Summe der Trinkgeldzeilen (Personal und Inhaber) in Cent, wie `centSumme(kunde.filter(istTip))` im Backend. */
42
56
  function trinkgeldCents(kunde) {
@@ -454,6 +454,20 @@ function barZeilen(zahlung) {
454
454
  */
455
455
  function zahlungsZeilen(receipt) {
456
456
  const zahlungen = receipt.payments;
457
+ // Reiner Leergutbeleg: die negative Barzahlung ist eine Auszahlung an den Kunden.
458
+ if (istReinerLeergutBeleg(receipt)) {
459
+ const bar = zahlungen != null && zahlungen.length > 0
460
+ ? zahlungen.filter((z) => BAR_ZAHLARTEN.includes(zahlartSchluessel(z.method)) && z.amountCents < 0)
461
+ : [];
462
+ if (zahlungen == null || zahlungen.length === 0) {
463
+ if (BAR_ZAHLARTEN.includes(zahlartSchluessel(receipt.paymentMethod)) && (0, index_js_2.receiptSumCents)(receipt) < 0) {
464
+ return [paarZeile(LEERGUT_AUSZAHLUNG, `${formatCents((0, index_js_2.receiptSumCents)(receipt))} €`, 8, 4)];
465
+ }
466
+ }
467
+ else if (bar.length === zahlungen.length) {
468
+ return bar.map((z) => paarZeile(LEERGUT_AUSZAHLUNG, `${formatCents(z.amountCents)} €`, 8, 4));
469
+ }
470
+ }
457
471
  // Trägt der Beleg eine Gutschein-Zahlungszeile, entfällt, was 0 Cent kostet
458
472
  // (§ 132a Abs. 3 BAO: die Zahlungsart ist kein Pflichtinhalt, der Betrag bleibt).
459
473
  const mitGutschein = receipt.vouchers.some((v) => v.action === index_js_1.VoucherAction.redeem && v.type !== index_js_1.VoucherType.promo);
@@ -879,6 +893,79 @@ function positionsZeile(item, satz, zusatz = false) {
879
893
  ],
880
894
  };
881
895
  }
896
+ // ------------------------------------------------------------ Pfand & Leergut
897
+ /** Ueberschrift eines reinen Leergutbelegs (nur Leergut-Positionen). */
898
+ const LEERGUT_UEBERSCHRIFT = 'Leergut-Rückgabe';
899
+ /** Zahlungszeile eines reinen Leergutbelegs: das Pfand geht bar zurueck an den Kunden. */
900
+ const LEERGUT_AUSZAHLUNG = 'Bar ausgezahlt';
901
+ /** Zusatz an der 0-%-Zeile, wenn Einwegpfand darauf liegt (kein Entgelt, nicht steuerbar). */
902
+ const PFAND_NICHT_STEUERBAR = 'Pfand, nicht steuerbar';
903
+ /** Vorsatz der Fusszeile mit der gemeinsamen Ruecknahmestelle. */
904
+ const LEERGUT_STELLE_VORSATZ = 'Leergut-Rückgabe: ';
905
+ /** Reiner Leergutbeleg: mindestens eine Leergut-Position, sonst nur Trinkgeld/Rabatt-freie Leergutzeilen. */
906
+ function istReinerLeergutBeleg(receipt) {
907
+ return receipt.items.length > 0 && receipt.items.some(index_js_2.isDepositReturnItem) && receipt.items.every(index_js_2.isDepositReturnItem);
908
+ }
909
+ /**
910
+ * Pfandzeilen, die unter ihrer Warenposition stehen (`depositFor` zeigt auf eine Ware, nicht auf Trinkgeld,
911
+ * Rabatt, Pfand oder Leergut und nicht auf sich selbst). Alle anderen Pfandzeilen bleiben an ihrem Platz.
912
+ */
913
+ function pfandZuPosition(items) {
914
+ const zu = new Map();
915
+ items.forEach((it, i) => {
916
+ if (!(0, index_js_2.isDepositItem)(it))
917
+ return;
918
+ const ziel = it.depositFor;
919
+ if (typeof ziel !== 'number' || !Number.isInteger(ziel) || ziel < 0 || ziel >= items.length || ziel === i)
920
+ return;
921
+ const hauptzeile = items[ziel];
922
+ if ((0, index_js_2.isTipItem)(hauptzeile) || (0, index_js_2.isDiscountItem)(hauptzeile) || (0, index_js_2.isDepositItem)(hauptzeile) || (0, index_js_2.isDepositReturnItem)(hauptzeile))
923
+ return;
924
+ zu.set(ziel, [...(zu.get(ziel) ?? []), i]);
925
+ });
926
+ return zu;
927
+ }
928
+ /**
929
+ * Bon-Reihenfolge mit Pfand: Hauptposition, ihre Zusaetze (je mit eigener Pfandzeile direkt darunter), dann die
930
+ * Pfandzeile der Hauptposition. Ohne Pfandverweise bleibt `reihe` unveraendert.
931
+ */
932
+ function mitPfandReihenfolge(items, reihe, zu) {
933
+ if (zu.size === 0)
934
+ return reihe;
935
+ const gebunden = new Set();
936
+ for (const liste of zu.values())
937
+ for (const i of liste)
938
+ gebunden.add(i);
939
+ const raus = [];
940
+ let offen = [];
941
+ for (const i of reihe) {
942
+ if (gebunden.has(i))
943
+ continue;
944
+ if ((0, zusaetze_js_1.istGueltigerZusatz)(items, i)) {
945
+ raus.push(i, ...(zu.get(i) ?? []));
946
+ continue;
947
+ }
948
+ raus.push(...offen);
949
+ raus.push(i);
950
+ offen = zu.get(i) ?? [];
951
+ }
952
+ raus.push(...offen);
953
+ return raus;
954
+ }
955
+ /** Einwegpfand und -leergut auf dem 0-%-Satz in Cent (Pfandzeilen minus Leergut); `null`, wenn keins darauf liegt. */
956
+ function einwegPfandCents(receipt) {
957
+ let summe = 0;
958
+ let gefunden = false;
959
+ for (const it of receipt.items) {
960
+ if (!((0, index_js_2.isDepositItem)(it) || (0, index_js_2.isDepositReturnItem)(it)) || it.depositKind !== 'single_use')
961
+ continue;
962
+ if (steuersatz(it.vat).rate !== 0)
963
+ continue;
964
+ summe += (0, index_js_2.receiptItemTotalCents)(it);
965
+ gefunden = true;
966
+ }
967
+ return gefunden ? summe : null;
968
+ }
882
969
  // ---------------------------------------------------------------- Belegart
883
970
  const TESTKASSE_TEXT = 'TESTKASSE — kein gültiger Beleg';
884
971
  const TESTSIGNATUR_TEXT = 'TESTSIGNATUR — kein gültiger Beleg';
@@ -1056,6 +1143,9 @@ function belegartBlock(receipt) {
1056
1143
  for (const z of TRAINING_ERKLAERUNG)
1057
1144
  aus.push(textZeile(z, 'center'));
1058
1145
  }
1146
+ else if (istReinerLeergutBeleg(receipt)) {
1147
+ aus.push(textZeile(LEERGUT_UEBERSCHRIFT, 'center', true));
1148
+ }
1059
1149
  else if (t === 'start') {
1060
1150
  aus.push(bannerZeile('STARTBELEG'));
1061
1151
  aus.push(textZeile('Nullbeleg zur Inbetriebnahme', 'center'));
@@ -1200,7 +1290,12 @@ function buildReceiptLayout(receipt, company, options = {}) {
1200
1290
  const gutscheinZuordnung = gutscheinPositionen(receipt);
1201
1291
  // Zusatz-Kacheln: Zusaetze direkt unter ihrer Hauptposition (stabil); ohne
1202
1292
  // Verweise ist die Reihenfolge die des Belegs (byte-gleich).
1203
- const reihe = (0, zusaetze_js_1.addOnDisplayOrder)(receipt.items);
1293
+ const pfandZu = pfandZuPosition(receipt.items);
1294
+ const gebundenesPfand = new Set();
1295
+ for (const liste of pfandZu.values())
1296
+ for (const k of liste)
1297
+ gebundenesPfand.add(k);
1298
+ const reihe = mitPfandReihenfolge(receipt.items, (0, zusaetze_js_1.addOnDisplayOrder)(receipt.items), pfandZu);
1204
1299
  const an = (k) => receipt.items[reihe[k]];
1205
1300
  let i = 0;
1206
1301
  while (i < reihe.length) {
@@ -1209,7 +1304,7 @@ function buildReceiptLayout(receipt, company, options = {}) {
1209
1304
  const satz = steuersatz(item.vat);
1210
1305
  gruppeVon(satz).bruttoCents += (0, index_js_2.receiptItemTotalCents)(item);
1211
1306
  const gutschein = gutscheinZuordnung.get(reihe[i]);
1212
- lines.push(...(gutschein ? gutscheinPositionsZeilen(item, satz, gutschein) : [positionsZeile(item, satz, (0, zusaetze_js_1.istGueltigerZusatz)(receipt.items, reihe[i]))]));
1307
+ lines.push(...(gutschein ? gutscheinPositionsZeilen(item, satz, gutschein) : [positionsZeile(item, satz, (0, zusaetze_js_1.istGueltigerZusatz)(receipt.items, reihe[i]) || gebundenesPfand.has(reihe[i]))]));
1213
1308
  i += 1;
1214
1309
  continue;
1215
1310
  }
@@ -1305,6 +1400,10 @@ function buildReceiptLayout(receipt, company, options = {}) {
1305
1400
  formatCents(bruttoCents),
1306
1401
  ], paperSize));
1307
1402
  }
1403
+ // Einwegpfand liegt auf dem 0-%-Satz, ist aber kein Entgelt: die Zeile sagt es dem Leser der Tabelle.
1404
+ const einwegCents = einwegPfandCents(receipt);
1405
+ if (einwegCents !== null)
1406
+ lines.push(paarZeile(PFAND_NICHT_STEUERBAR, formatCents(einwegCents), 9, 3));
1308
1407
  // Mitarbeiter-Trinkgeld ist als Null-%-Umsatz erfasst (Erlass 2.4.2.1), aber
1309
1408
  // kein Umsatz des Betriebs — die Klarstellung steht direkt unter der
1310
1409
  // 0-%-Zeile, damit der Beleg (auch als Rechnung) nicht nach steuerfreiem
@@ -1393,6 +1492,13 @@ function buildReceiptLayout(receipt, company, options = {}) {
1393
1492
  lines.push(textZeile(fuss, 'center'));
1394
1493
  }
1395
1494
  }
1495
+ // Gemeinsame Ruecknahmestelle fuer Leergut (nur, wenn der Server sie gestempelt hat).
1496
+ const stelle = receipt.sharedReturnPoint;
1497
+ if (stelle != null) {
1498
+ const angabe = [stelle.name, stelle.address].filter((t) => t !== '').join(', ');
1499
+ if (angabe !== '')
1500
+ lines.push(textZeile(`${LEERGUT_STELLE_VORSATZ}${angabe}`, 'center'));
1501
+ }
1396
1502
  // --- Warnrahmen unten (Testkasse/Testsignatur)
1397
1503
  if (warnungen.length > 0) {
1398
1504
  lines.push({ kind: 'space', lines: 1 });
@@ -1,6 +1,7 @@
1
1
  import { type TransportOptions } from '../client/transport.js';
2
2
  import { type ReceiptCompany } from '../models/receipt-company.js';
3
3
  import type { PosSettings } from '../pos/settings.js';
4
+ import { type CashRegisterDeposit } from '../pos/pfand.js';
4
5
  /**
5
6
  * Verbindungsangaben ohne Anmeldung — alles, was [TransportOptions] ausser der
6
7
  * Anmeldung fuehrt. Alle Felder sind wahlfrei: ohne Angabe gelten der Kassenweg
@@ -142,11 +143,13 @@ export interface RegisterDeviceUsers {
142
143
  * Startbeleg fehlt): die Kasse sperrt das Kassieren VOR dem ersten Beleg
143
144
  * statt an createReceipt zu scheitern. Fehlt das Feld, gilt bereit.
144
145
  * `stockLocationId`: Lager-Standort der Kasse, fehlt = Standard-Standort.
146
+ * `deposit`: Pfand & Leergut der Kasse (Ruecknahme, Vorgaben); fehlt, solange der Betrieb kein Pfand eingeschaltet hat.
145
147
  */
146
148
  cashregister?: {
147
149
  ready: boolean;
148
150
  reason?: string | null;
149
151
  stockLocationId?: string;
152
+ deposit?: CashRegisterDeposit;
150
153
  };
151
154
  /** Das Geraet haengt an der Test-Umgebung des Betriebs. */
152
155
  testEnvironment: boolean;
@@ -209,6 +212,11 @@ export interface RegisterUserPerms {
209
212
  voucherRedeem?: boolean;
210
213
  /** Gutscheine verwalten, z. B. Etikett nachdrucken (fehlt: verweigert). */
211
214
  voucherManage?: boolean;
215
+ /**
216
+ * Leergut annehmen (Pfand & Leergut). Fehlt das Recht, gilt es als erteilt (Rollenvorgabe: Kassier und Chef) --
217
+ * siehe [depositReturnOf]; ein ausdrueckliches `false` sperrt. Unter /v3 loest der Server es bei der Anmeldung auf.
218
+ */
219
+ depositReturn?: boolean;
212
220
  [weiteresRecht: string]: boolean | RegisterScope | undefined;
213
221
  }
214
222
  /**
@@ -219,7 +227,7 @@ export interface RegisterUserPerms {
219
227
  * nicht fuehrt (Tippfehler, umbenanntes Recht), kommt hier nicht durch.
220
228
  * Die Gegenrichtung schliesst [_RechteVollstaendig] direkt darunter.
221
229
  */
222
- export declare const REGISTER_PERMS: readonly ["sell", "cancel", "articles", "layout", "reports", "takeover", "cancelScope", "receiptsScope", "drawer", "discount", "tipAssign", "stockView", "stockCosts", "stockMove", "stockLoss", "stocktakeCount", "stocktakeClose", "stockLocation", "voucherSell", "voucherRedeem", "voucherManage"];
230
+ export declare const REGISTER_PERMS: readonly ["sell", "cancel", "articles", "layout", "reports", "takeover", "cancelScope", "receiptsScope", "drawer", "discount", "tipAssign", "stockView", "stockCosts", "stockMove", "stockLoss", "stocktakeCount", "stocktakeClose", "stockLocation", "voucherSell", "voucherRedeem", "voucherManage", "depositReturn"];
223
231
  /** Reichweite lesen, mit der Migration des Backends (register-auth.js). */
224
232
  export declare function cancelScopeOf(perms: RegisterUserPerms | null | undefined): RegisterScope;
225
233
  export declare function receiptsScopeOf(perms: RegisterUserPerms | null | undefined): RegisterScope;
@@ -229,6 +237,12 @@ export declare function receiptsScopeOf(perms: RegisterUserPerms | null | undefi
229
237
  * sperrt; alle anderen Lager-Rechte gelten ohne Schluessel als verweigert.
230
238
  */
231
239
  export declare function stockViewOf(perms: RegisterUserPerms | null | undefined): boolean;
240
+ /**
241
+ * Darf der Benutzer Leergut annehmen? Ohne Schluessel gilt das Recht als erteilt (Rollenvorgabe `Leergut annehmen`
242
+ * ist fuer Kassier und Chef an, ein alter Server und `/api`-Antworten kennen es nicht); nur ein ausdrueckliches
243
+ * `false` sperrt. Ohne Rechte-Objekt: nein.
244
+ */
245
+ export declare function depositReturnOf(perms: Partial<RegisterUserPerms> | null | undefined): boolean;
232
246
  /** Die drei Gutschein-Rechte, aufgeloest (kein Schluessel fehlt mehr). */
233
247
  export interface VoucherPerms {
234
248
  voucherSell: boolean;
@@ -4,6 +4,7 @@ exports.REGISTER_PERMS = void 0;
4
4
  exports.cancelScopeOf = cancelScopeOf;
5
5
  exports.receiptsScopeOf = receiptsScopeOf;
6
6
  exports.stockViewOf = stockViewOf;
7
+ exports.depositReturnOf = depositReturnOf;
7
8
  exports.voucherPermsOf = voucherPermsOf;
8
9
  exports.pairRegisterDevice = pairRegisterDevice;
9
10
  exports.unpairRegisterDevice = unpairRegisterDevice;
@@ -15,6 +16,7 @@ const errors_js_1 = require("../client/errors.js");
15
16
  const transport_js_1 = require("../client/transport.js");
16
17
  const receipt_company_js_1 = require("../models/receipt-company.js");
17
18
  const client_js_1 = require("../pos/client.js");
19
+ const pfand_js_1 = require("../pos/pfand.js");
18
20
  /**
19
21
  * Die drei Aufrufe, die **ohne jede Identitaet** laufen: Kopplung eines
20
22
  * Geraets, Benutzerliste dieses Geraets, PIN-Anmeldung. Sie sind der Weg, auf
@@ -63,7 +65,7 @@ exports.REGISTER_PERMS = [
63
65
  'sell', 'cancel', 'articles', 'layout', 'reports', 'takeover',
64
66
  'cancelScope', 'receiptsScope', 'drawer', 'discount', 'tipAssign',
65
67
  'stockView', 'stockCosts', 'stockMove', 'stockLoss', 'stocktakeCount', 'stocktakeClose', 'stockLocation',
66
- 'voucherSell', 'voucherRedeem', 'voucherManage',
68
+ 'voucherSell', 'voucherRedeem', 'voucherManage', 'depositReturn',
67
69
  ];
68
70
  /** Reichweite lesen, mit der Migration des Backends (register-auth.js). */
69
71
  function cancelScopeOf(perms) {
@@ -90,6 +92,16 @@ function stockViewOf(perms) {
90
92
  return false;
91
93
  return perms.stockView === undefined ? true : perms.stockView === true;
92
94
  }
95
+ /**
96
+ * Darf der Benutzer Leergut annehmen? Ohne Schluessel gilt das Recht als erteilt (Rollenvorgabe `Leergut annehmen`
97
+ * ist fuer Kassier und Chef an, ein alter Server und `/api`-Antworten kennen es nicht); nur ein ausdrueckliches
98
+ * `false` sperrt. Ohne Rechte-Objekt: nein.
99
+ */
100
+ function depositReturnOf(perms) {
101
+ if (!perms)
102
+ return false;
103
+ return perms.depositReturn === undefined ? true : perms.depositReturn === true;
104
+ }
93
105
  /**
94
106
  * Gutschein-Rechte lesen. Das Backend loest sie bei der Anmeldung auf; ein
95
107
  * alter Server (und `/api`-Antworten) kennt sie nicht. Dann gilt je fehlendem
@@ -244,6 +256,7 @@ function kasseBereit(wert) {
244
256
  ready: roh['ready'],
245
257
  reason: typeof roh['reason'] === 'string' ? roh['reason'] : null,
246
258
  ...(typeof standort === 'string' && standort !== '' ? { stockLocationId: standort } : {}),
259
+ ...((0, pfand_js_1.cashRegisterDepositFromWire)(roh['deposit']) ? { deposit: (0, pfand_js_1.cashRegisterDepositFromWire)(roh['deposit']) } : {}),
247
260
  };
248
261
  }
249
262
  /** Die Regel aus der Antwort — oder `null`, wenn keine brauchbare kommt. */
@@ -1,5 +1,5 @@
1
1
  /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
2
- export declare const VOKABULAR_QUELLE = "04ab5e1d031979a4f0aa31ea000f4cbe1d6e557e2411e439899ac19a1bba0325";
2
+ export declare const VOKABULAR_QUELLE = "168261a0b5130d454fc3b5d51e8ee567d6a3e9a5d2d8e172829e9ccb17c47f31";
3
3
  /** Schema-Notation des Vertrags: Blatt 'aussen': 'innen', Objekt { __: 'innen', ... }, Liste [ { __: 'innen', ... } ]. */
4
4
  export type SchemaEintrag = string | SchemaObjekt | readonly [SchemaObjekt];
5
5
  export interface SchemaObjekt {
@@ -4,7 +4,7 @@
4
4
  Object.defineProperty(exports, "__esModule", { value: true });
5
5
  exports.ZUSATZ_KATALOGE = exports.KATALOGE = exports.ARTIKEL_FELDER = exports.SCHEMAS = exports.VOKABULAR_QUELLE = void 0;
6
6
  /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
7
- exports.VOKABULAR_QUELLE = "04ab5e1d031979a4f0aa31ea000f4cbe1d6e557e2411e439899ac19a1bba0325";
7
+ exports.VOKABULAR_QUELLE = "168261a0b5130d454fc3b5d51e8ee567d6a3e9a5d2d8e172829e9ccb17c47f31";
8
8
  /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
9
9
  exports.SCHEMAS = {
10
10
  "getReceipt": {
@@ -23,7 +23,12 @@ exports.SCHEMAS = {
23
23
  "__": "items",
24
24
  "receivedImmediately": "sofortErhalten",
25
25
  "keptByEmployee": "direkt",
26
- "addOnOf": "zusatzZu"
26
+ "addOnOf": "zusatzZu",
27
+ "depositTypeId": "pfandartId",
28
+ "depositFor": "pfandZu",
29
+ "depositKind": "pfandArt",
30
+ "perUnit": "jeStueck",
31
+ "ownFilling": "eigen"
27
32
  }
28
33
  ],
29
34
  "manualReceipt": {
@@ -35,6 +40,11 @@ exports.SCHEMAS = {
35
40
  "time": "uhrzeit",
36
41
  "reason": "grund",
37
42
  "note": "grundText"
43
+ },
44
+ "onPremises": "vorOrt",
45
+ "sharedReturnPoint": {
46
+ "__": "pfandStelle",
47
+ "address": "adresse"
38
48
  }
39
49
  },
40
50
  "taxNumber": "taxnr",
@@ -99,6 +109,12 @@ exports.SCHEMAS = {
99
109
  "layout.lines[].tone": {
100
110
  "$catalog": "LAYOUT_TON"
101
111
  },
112
+ "receipt.items[].kind": {
113
+ "$catalog": "PFAND_KIND"
114
+ },
115
+ "receipt.items[].depositKind": {
116
+ "$catalog": "PFAND_ART"
117
+ },
102
118
  "issuedVouchers[].type": {
103
119
  "$catalog": "GUTSCHEIN_ART"
104
120
  },
@@ -313,9 +329,36 @@ exports.SCHEMAS = {
313
329
  "__": "connect",
314
330
  "minimumVersion": "mindestversion",
315
331
  "deadline": "frist"
332
+ },
333
+ "deposit": {
334
+ "__": "pfand",
335
+ "singleUse": "einweg",
336
+ "reusable": "mehrweg",
337
+ "depositTypes": [
338
+ {
339
+ "__": "pfandarten",
340
+ "kind": "art",
341
+ "type": "typ",
342
+ "amounts": [
343
+ {
344
+ "__": "betraege",
345
+ "from": "ab"
346
+ }
347
+ ],
348
+ "returnRate": "rueckgabeSatz",
349
+ "used": "verwendet",
350
+ "active": "aktiv"
351
+ }
352
+ ]
316
353
  }
317
354
  },
318
355
  "werte": {
356
+ "deposit.depositTypes[].kind": {
357
+ "$catalog": "PFAND_ART"
358
+ },
359
+ "deposit.depositTypes[].type": {
360
+ "$catalog": "PFAND_TYP"
361
+ },
319
362
  "business.watermark": {
320
363
  "$catalog": "KASSE_BETRIEB_WERTE.watermark"
321
364
  },
@@ -428,7 +471,15 @@ exports.SCHEMAS = {
428
471
  "patternStrict": "musterStreng"
429
472
  },
430
473
  "addOns": "zusaetze",
431
- "externalVoucher": "fremdgutschein"
474
+ "externalVoucher": "fremdgutschein",
475
+ "deposits": [
476
+ {
477
+ "__": "pfand",
478
+ "depositTypeId": "pfandartId",
479
+ "quantity": "menge",
480
+ "ownFilling": "eigen"
481
+ }
482
+ ]
432
483
  }
433
484
  ]
434
485
  },
@@ -478,7 +529,8 @@ exports.ARTIKEL_FELDER = [
478
529
  "askPrice",
479
530
  "reference",
480
531
  "addOns",
481
- "externalVoucher"
532
+ "externalVoucher",
533
+ "deposits"
482
534
  ];
483
535
  /** Wertkataloge innen (deutsch) -> aussen (englisch). */
484
536
  exports.KATALOGE = {
@@ -777,6 +829,22 @@ exports.KATALOGE = {
777
829
  "stueck": "piece",
778
830
  "dezimal": "decimal"
779
831
  },
832
+ "PFAND_ART": {
833
+ "einweg": "single_use",
834
+ "mehrweg": "reusable"
835
+ },
836
+ "PFAND_KIND": {
837
+ "pfand": "deposit",
838
+ "pfand_rueckgabe": "deposit_return"
839
+ },
840
+ "PFAND_TYP": {
841
+ "flasche": "bottle",
842
+ "kiste": "crate",
843
+ "fass": "keg",
844
+ "becher": "cup",
845
+ "glas": "glass",
846
+ "sonstiges": "other"
847
+ },
780
848
  "REFERENZ_STUFE": {
781
849
  "fragen": "optional",
782
850
  "pflicht": "required"
@@ -4,4 +4,4 @@
4
4
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
5
5
  * beim Anheben der Version beide Stellen aendern.
6
6
  */
7
- export declare const PACKAGE_VERSION = "1.31.0";
7
+ export declare const PACKAGE_VERSION = "1.32.0";
@@ -7,4 +7,4 @@ exports.PACKAGE_VERSION = void 0;
7
7
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
8
8
  * beim Anheben der Version beide Stellen aendern.
9
9
  */
10
- exports.PACKAGE_VERSION = '1.31.0';
10
+ exports.PACKAGE_VERSION = '1.32.0';
@@ -13,7 +13,7 @@
13
13
  * umhuellt, muss ihn weiterhin absetzen koennen.
14
14
  */
15
15
  import type { FileOrData, FileOrDataCallOptions, PdfOrData, TransportBodyFields, TransportCallOptions } from './transport.js';
16
- export declare const ALL_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createDepExport", "createDepHandoverLink", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCashregisterReport", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getDepExport", "getDepExportFile", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "getReportV2", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyStock", "listMyStockLocations", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listReceipts", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "reportCustomerContract", "requestCustomerSignature", "revokeDepHandoverLink", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "recordMyShiftCount", "logReceiptOutputs", "getRegisterInspectionInfo", "reportConnectState", "registerTerminalDevice", "getTerminalAccess", "claimTerminal", "requestTerminalCode", "getTerminalCode", "reportTerminalLogin", "reportTerminalReady"];
16
+ export declare const ALL_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createDepExport", "createDepHandoverLink", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCashregisterReport", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getDepExport", "getDepExportFile", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "getReportV2", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyStock", "listMyStockLocations", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listReceipts", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "reportCustomerContract", "requestCustomerSignature", "revokeDepHandoverLink", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "recordMyShiftCount", "logReceiptOutputs", "getRegisterInspectionInfo", "reportConnectState", "learnMyLeergutCode", "listMyLeergutCodes", "registerTerminalDevice", "getTerminalAccess", "claimTerminal", "requestTerminalCode", "getTerminalCode", "reportTerminalLogin", "reportTerminalReady"];
17
17
  export type ApiCall = typeof ALL_CALLS[number];
18
18
  /**
19
19
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -29,7 +29,7 @@ export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "can
29
29
  * die fuenf DEP-Aufrufe); die Kasse ruft sie trotzdem ueber diesen Weg (ein Dialekt
30
30
  * je Client, Nachtrag §5.2).
31
31
  */
32
- export declare const POS_CALLS: readonly ["pairRegisterDevice", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "registerUserLogin", "registerPinLogin", "renewRegisterSession", "endRegisterSession", "unpairRegisterDevice", "listMyCashregisters", "listMyReceipts", "getReceipt", "createReceipt", "generateFullReceiptId", "cancelReceipt", "sendReceiptEmail", "listMyArticleGroups", "listMyArticles", "getKasseSettings", "setMyKasseSettings", "setMyKasseLogo", "setMyRegisterDeviceSettings", "listMyPrinters", "createPrintJob", "getPrintJob", "listMyTipRecipients", "listMyStockLocations", "listMyStock", "setMyCashregisterStockLocation", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "recordMyShiftCount", "logReceiptOutputs", "createDepExport", "getDepExport", "getDepExportFile", "createDepHandoverLink", "revokeDepHandoverLink", "getRegisterInspectionInfo", "reportConnectState"];
32
+ export declare const POS_CALLS: readonly ["pairRegisterDevice", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "registerUserLogin", "registerPinLogin", "renewRegisterSession", "endRegisterSession", "unpairRegisterDevice", "listMyCashregisters", "listMyReceipts", "getReceipt", "createReceipt", "generateFullReceiptId", "cancelReceipt", "sendReceiptEmail", "listMyArticleGroups", "listMyArticles", "getKasseSettings", "setMyKasseSettings", "setMyKasseLogo", "setMyRegisterDeviceSettings", "listMyPrinters", "createPrintJob", "getPrintJob", "listMyTipRecipients", "listMyStockLocations", "listMyStock", "setMyCashregisterStockLocation", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "recordMyShiftCount", "logReceiptOutputs", "createDepExport", "getDepExport", "getDepExportFile", "createDepHandoverLink", "revokeDepHandoverLink", "getRegisterInspectionInfo", "reportConnectState", "learnMyLeergutCode", "listMyLeergutCodes"];
33
33
  export type PublicCall = typeof PUBLIC_CALLS[number];
34
34
  export type PosCall = typeof POS_CALLS[number];
35
35
  /**
@@ -50,7 +50,7 @@ export type PosCall = typeof POS_CALLS[number];
50
50
  * [ALL_CALLS], [PUBLIC_CALLS] und [POS_CALLS] steht entweder hier oder in
51
51
  * [CALLS_WITHOUT_EFFECT] (Waechter `test/ausgang-einordnung.test.ts`).
52
52
  */
53
- export declare const UNKNOWN_OUTCOME_CALLS: readonly ["activateCashregister", "addVariant", "cancelInvoice", "cancelReceipt", "cancelStocktake", "changeStockCondition", "closeMyShift", "closeStocktake", "createArticle", "createCreditNote", "createCustomer", "createCustomerCashregister", "createInvoiceItem", "createPartnerCustomer", "createPartnerWebhook", "createPrintJob", "createReceipt", "createReservation", "createStocktake", "createVariantGroup", "createWebhook", "deactivateArticle", "deletePartnerWebhook", "deleteWebhook", "extendReservation", "financeWebService", "getTerminalCode", "hobexPayApi", "hobexRefundApi", "issueInvoice", "logMyDrawerOpenings", "logReceiptOutputs", "openMyShift", "orderSignatureCard", "pairRegisterDevice", "receiveGoods", "recordInvoicePayment", "recordMyCashMovement", "recordMyShiftCount", "recordMyStocktakeCount", "recordStockLoss", "recordStocktakeCount", "recountStocktake", "registerTerminalDevice", "releaseReservation", "reportConnectState", "reportCustomerContract", "requestCustomerSignature", "reverseStockMovement", "reviewStocktake", "revokeCustomerMandate", "rotatePartnerWebhookSecret", "rotateWebhookSecret", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "sendWebhookTest", "setCustomerMandate", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "transferStock", "unpairRegisterDevice", "updateArticle", "updateCustomer", "updateInvoiceItem", "updatePartnerWebhook", "updateVariantGroup", "updateWebhook", "voidMyStocktakeCount", "voidStocktakeCount", "withdrawInvoiceItem"];
53
+ export declare const UNKNOWN_OUTCOME_CALLS: readonly ["activateCashregister", "addVariant", "cancelInvoice", "cancelReceipt", "cancelStocktake", "changeStockCondition", "closeMyShift", "closeStocktake", "createArticle", "createCreditNote", "createCustomer", "createCustomerCashregister", "createInvoiceItem", "createPartnerCustomer", "createPartnerWebhook", "createPrintJob", "createReceipt", "createReservation", "createStocktake", "createVariantGroup", "createWebhook", "deactivateArticle", "deletePartnerWebhook", "deleteWebhook", "extendReservation", "financeWebService", "getTerminalCode", "hobexPayApi", "hobexRefundApi", "issueInvoice", "learnMyLeergutCode", "logMyDrawerOpenings", "logReceiptOutputs", "openMyShift", "orderSignatureCard", "pairRegisterDevice", "receiveGoods", "recordInvoicePayment", "recordMyCashMovement", "recordMyShiftCount", "recordMyStocktakeCount", "recordStockLoss", "recordStocktakeCount", "recountStocktake", "registerTerminalDevice", "releaseReservation", "reportConnectState", "reportCustomerContract", "requestCustomerSignature", "reverseStockMovement", "reviewStocktake", "revokeCustomerMandate", "rotatePartnerWebhookSecret", "rotateWebhookSecret", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "sendWebhookTest", "setCustomerMandate", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "transferStock", "unpairRegisterDevice", "updateArticle", "updateCustomer", "updateInvoiceItem", "updatePartnerWebhook", "updateVariantGroup", "updateWebhook", "voidMyStocktakeCount", "voidStocktakeCount", "withdrawInvoiceItem"];
54
54
  /** Warum ein Aufruf keine Wirkung hat, die ein Zeitlimit offen lassen koennte. */
55
55
  export type CallWithoutEffectReason = 'read' | 'repeatable';
56
56
  /**
@@ -151,6 +151,9 @@ export const ALL_CALLS = [
151
151
  'getRegisterInspectionInfo',
152
152
  // Connect-Bestand (./pos): welche Connect-Version an welchem Kassengeraet laeuft; nur ueber den Kassenweg.
153
153
  'reportConnectState',
154
+ // Leergut-Codes (Pfand, ./pos): Codes lernen und lesen; nur ueber den Kassenweg.
155
+ 'learnMyLeergutCode',
156
+ 'listMyLeergutCodes',
154
157
  // Kartenterminal am Handy: Geraet, Zugang, TID und Code (nur /v3).
155
158
  'registerTerminalDevice',
156
159
  'getTerminalAccess',
@@ -364,6 +367,9 @@ export const POS_CALLS = [
364
367
  'getRegisterInspectionInfo',
365
368
  // Connect-Bestand: nur ueber den Kassenweg, jeder Kassen-Benutzer.
366
369
  'reportConnectState',
370
+ // Leergut-Codes lernen und lesen: Kassen-Benutzer mit dem Recht depositReturn.
371
+ 'learnMyLeergutCode',
372
+ 'listMyLeergutCodes',
367
373
  ];
368
374
  /**
369
375
  * Die Aufrufe **mit Wirkung**, alphabetisch: sie legen etwas an, aendern oder
@@ -415,6 +421,7 @@ export const UNKNOWN_OUTCOME_CALLS = [
415
421
  'hobexPayApi',
416
422
  'hobexRefundApi',
417
423
  'issueInvoice',
424
+ 'learnMyLeergutCode',
418
425
  'logMyDrawerOpenings',
419
426
  'logReceiptOutputs',
420
427
  'openMyShift',
@@ -497,6 +504,7 @@ export const CALLS_WITHOUT_EFFECT = Object.freeze({
497
504
  generateFullReceiptId: 'read',
498
505
  getCashregisterReport: 'read',
499
506
  getArticle: 'read',
507
+ listMyLeergutCodes: 'read',
500
508
  getCustomer: 'read',
501
509
  getCustomerCredentials: 'read',
502
510
  getCustomerSignatureStatus: 'read',
@@ -66,6 +66,17 @@ export interface ReceiptCommonOptions {
66
66
  * Hauptlade der Kasse. Leer oder kein Text: wirft vor dem Senden.
67
67
  */
68
68
  drawerId?: string;
69
+ /**
70
+ * Pfand & Leergut: der Server setzt die Pfandzeilen aus den Artikeln (`deposits`) selbst und rechnet den Betrag.
71
+ * Ohne Angabe gilt die Vorgabe des Servers (an, solange der Betrieb Pfand eingeschaltet hat). Mit `false` setzt er
72
+ * keine; ausdrueckliche Zeilen `deposit` ohne `articleId` und `deposit_return` bleiben erlaubt.
73
+ */
74
+ autoDeposits?: boolean;
75
+ /**
76
+ * Pfand & Leergut: der Verkauf wird vor Ort verzehrt (`true`) oder mitgenommen (`false`). Ohne Angabe gilt die
77
+ * Vorgabe der Kasse (`CashRegisterDeposit.onPremisesDefault`). Nur ein Wahrheitswert; anderes wirft vor dem Senden.
78
+ */
79
+ onPremises?: boolean;
69
80
  /**
70
81
  * Schutz vor einem zweiten Beleg, wenn die Antwort verloren geht (Netzabbruch,
71
82
  * Zeitablauf, `outcome: 'unknown'`). Gilt je Kasse: dieselbe Anfrage mit