@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
@@ -1,7 +1,7 @@
1
1
  import { ReceiptType, VoucherAction, VoucherType } from '../enums/index.js';
2
2
  import { VoucherCode } from '@kreiseck/validator';
3
3
  import { toViennaWallClock } from '../vienna-time.js';
4
- import { centSumme, istDeckbar, kuSaetze, planeGutscheine, topfFuerSatz, trinkgeldCents, } from './gutschein-plan.js';
4
+ import { centSumme, istDeckbar, istPfandZeile, leergutCents, kuSaetze, planeGutscheine, topfFuerSatz, trinkgeldCents, } from './gutschein-plan.js';
5
5
  export { VOUCHER_ZERO_RATE_BUCKET_FROM } from './gutschein-plan.js';
6
6
  /**
7
7
  * Warum sich der Zahlbetrag nicht rechnen laesst. Fest wie ein Backend-Code;
@@ -100,15 +100,20 @@ function rechne(items, vouchers, receiptType, options) {
100
100
  const fluss = wertgutscheinFlussCents(gutscheine, art);
101
101
  const dueCents = t.zaehlerDeltaCents + fluss;
102
102
  // Ohne Auszahlungen darf der Zahlbetrag nicht negativ werden (Einloesung hoeher als die Summe).
103
- if (plan.mitPlan && dueCents + plan.auszahlungCents < 0) {
103
+ // Leergut ist nie deckbar und darf als Barauszahlung hinausgehen: es zaehlt in diesen Pruefungen nicht mit.
104
+ const leergut = leergutCents(kunde);
105
+ const nachGutscheinen = dueCents + plan.auszahlungCents - leergut;
106
+ if (plan.mitPlan && nachGutscheinen < 0) {
104
107
  throw new ReceiptDueError('invalid_voucher', 'die Gutscheine uebersteigen die Summe des Belegs.', 'voucher_exceeds_total');
105
108
  }
106
109
  // Ein Gutschein deckt nie das Trinkgeld (Personal wie Inhaber): der Zahlbetrag nach den Gutscheinen
107
110
  // muss die Trinkgeldzeilen tragen. Storno ausgenommen (dort gibt es keinen Plan).
108
111
  const trinkgeld = trinkgeldCents(kunde);
109
- if (plan.mitPlan && art !== 'cancellation' && trinkgeld > 0 && dueCents + plan.auszahlungCents < trinkgeld) {
112
+ if (plan.mitPlan && art !== 'cancellation' && trinkgeld > 0 && nachGutscheinen < trinkgeld) {
110
113
  throw new ReceiptDueError('invalid_voucher', 'die Gutscheine decken das Trinkgeld.', 'voucher_exceeds_total');
111
114
  }
115
+ // pfand-core.istLeergutAuszahlung: negativer Zahlbetrag eines Verkaufs mit Leergut, hoechstens die Leergutsumme.
116
+ const leergutAuszahlung = art !== 'cancellation' && leergut < 0 && dueCents < 0 && dueCents >= leergut;
112
117
  return {
113
118
  ergebnis: {
114
119
  dueCents,
@@ -122,6 +127,7 @@ function rechne(items, vouchers, receiptType, options) {
122
127
  amountRateSpecial: euroToCent(t.amountRateSpecial),
123
128
  amountRatOthers: euroToCent(t.amountRatOthers),
124
129
  },
130
+ ...(leergutAuszahlung ? { payout: 'deposit' } : {}),
125
131
  },
126
132
  kunde,
127
133
  minusJeTopf: plan.minusJeTopf,
@@ -421,10 +427,14 @@ const FUENF = ['amountRateStandard', 'amountRateReduced1', 'amountRateReduced2',
421
427
  /** `beleg-toepfe.belegToepfe`, Schritt fuer Schritt. */
422
428
  function belegToepfe(positionen, gutscheine) {
423
429
  const t = { amountRateStandard: 0, amountRateReduced1: 0, amountRateReduced2: 0, amountRateZero: 0, amountRateSpecial: 0, amountRatOthers: 0 };
424
- let personal = 0;
430
+ // Durchlaufende Posten (beleg-toepfe.durchlaufUndRest): Personal-Trinkgeld im 0-%-Topf, Pfand und Leergut im Topf ihres
431
+ // Satzes (Einweg hat 0 %, also Null). Sie liegen ungekuerzt im Topf, nach dem Rabatt, und zaehlen nicht in dessen Deckel.
432
+ const durchlauf = { amountRateStandard: 0, amountRateReduced1: 0, amountRateReduced2: 0, amountRateZero: 0, amountRateSpecial: 0, amountRatOthers: 0 };
425
433
  for (const p of positionen) {
426
434
  if (p.tip === 'staff')
427
- personal += p.amount * p.priceOne;
435
+ durchlauf.amountRateZero += p.amount * p.priceOne;
436
+ else if (istPfandZeile(p))
437
+ durchlauf[topfFuerSatz(p.vat)] += p.amount * p.priceOne;
428
438
  else
429
439
  t[topfFuerSatz(p.vat)] += p.priceOne * p.amount;
430
440
  }
@@ -457,7 +467,8 @@ function belegToepfe(positionen, gutscheine) {
457
467
  t[n] = (cents[i] - anteil[i]) / 100;
458
468
  });
459
469
  }
460
- t.amountRateZero += personal;
470
+ for (const n of [...FUENF, 'amountRatOthers'])
471
+ t[n] += durchlauf[n];
461
472
  const zaehlerDeltaCents = euroToCent(t.amountRateStandard) + euroToCent(t.amountRateReduced1) + euroToCent(t.amountRateReduced2) +
462
473
  euroToCent(t.amountRateZero) + euroToCent(t.amountRateSpecial) + euroToCent(t.amountRatOthers);
463
474
  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. */
@@ -25,9 +25,21 @@ const TOPF_REIHENFOLGE = ['amountRateStandard', 'amountRateReduced1', 'amountRat
25
25
  function istGutscheinZeile(p) {
26
26
  return p.kind !== undefined && KINDS.includes(p.kind);
27
27
  }
28
- /** Position, die ein Gutschein decken darf: weder Trinkgeld noch Gutscheinzeile. */
28
+ /** Pfand- oder Leergutzeile: durchlaufend wie das Trinkgeld, nie rabattiert, nie von einem Gutschein gedeckt. */
29
+ export function istPfandZeile(p) {
30
+ return p.kind === 'deposit' || p.kind === 'deposit_return';
31
+ }
32
+ /** Position, die ein Gutschein decken darf: weder Trinkgeld noch Gutscheinzeile noch Pfand oder Leergut (E18). */
29
33
  export function istDeckbar(p) {
30
- return p.tip == null && p.kind !== 'tip' && !istGutscheinZeile(p);
34
+ return p.tip == null && p.kind !== 'tip' && !istGutscheinZeile(p) && !istPfandZeile(p);
35
+ }
36
+ /** Summe der Leergutzeilen in Cent (<= 0), wie `pfand-core.leergutCents`: Menge x Einzelpreis, auf Cent gerundet. */
37
+ export function leergutCents(positionen) {
38
+ let summe = 0;
39
+ for (const p of positionen)
40
+ if (p.kind === 'deposit_return')
41
+ summe += Math.round(p.amount * Math.round(p.priceOne * 100));
42
+ return summe;
31
43
  }
32
44
  /** Summe der Trinkgeldzeilen (Personal und Inhaber) in Cent, wie `centSumme(kunde.filter(istTip))` im Backend. */
33
45
  export function trinkgeldCents(kunde) {
@@ -1,5 +1,5 @@
1
1
  import { VatRate, VoucherAction, VoucherType } from '../enums/index.js';
2
- import { CANCELLATION_REASONS, isCancellationReason, receiptCompanyTaxInfo, receiptItemTotalCents, isDiscountItem, isTipItem, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, voucherIsValid, isExternalVoucher, } from '../models/index.js';
2
+ import { CANCELLATION_REASONS, isCancellationReason, receiptCompanyTaxInfo, receiptItemTotalCents, isDepositItem, isDepositReturnItem, isDiscountItem, isTipItem, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, voucherIsValid, isExternalVoucher, } from '../models/index.js';
3
3
  import { parseServerTimeStamp, toViennaWallClock } from '../vienna-time.js';
4
4
  import { KasseneckValidationError } from '../client/errors.js';
5
5
  import { addOnDisplayOrder, istGueltigerZusatz } from '../pos/zusaetze.js';
@@ -442,6 +442,20 @@ function barZeilen(zahlung) {
442
442
  */
443
443
  function zahlungsZeilen(receipt) {
444
444
  const zahlungen = receipt.payments;
445
+ // Reiner Leergutbeleg: die negative Barzahlung ist eine Auszahlung an den Kunden.
446
+ if (istReinerLeergutBeleg(receipt)) {
447
+ const bar = zahlungen != null && zahlungen.length > 0
448
+ ? zahlungen.filter((z) => BAR_ZAHLARTEN.includes(zahlartSchluessel(z.method)) && z.amountCents < 0)
449
+ : [];
450
+ if (zahlungen == null || zahlungen.length === 0) {
451
+ if (BAR_ZAHLARTEN.includes(zahlartSchluessel(receipt.paymentMethod)) && receiptSumCents(receipt) < 0) {
452
+ return [paarZeile(LEERGUT_AUSZAHLUNG, `${formatCents(receiptSumCents(receipt))} €`, 8, 4)];
453
+ }
454
+ }
455
+ else if (bar.length === zahlungen.length) {
456
+ return bar.map((z) => paarZeile(LEERGUT_AUSZAHLUNG, `${formatCents(z.amountCents)} €`, 8, 4));
457
+ }
458
+ }
445
459
  // Trägt der Beleg eine Gutschein-Zahlungszeile, entfällt, was 0 Cent kostet
446
460
  // (§ 132a Abs. 3 BAO: die Zahlungsart ist kein Pflichtinhalt, der Betrag bleibt).
447
461
  const mitGutschein = receipt.vouchers.some((v) => v.action === VoucherAction.redeem && v.type !== VoucherType.promo);
@@ -867,6 +881,79 @@ function positionsZeile(item, satz, zusatz = false) {
867
881
  ],
868
882
  };
869
883
  }
884
+ // ------------------------------------------------------------ Pfand & Leergut
885
+ /** Ueberschrift eines reinen Leergutbelegs (nur Leergut-Positionen). */
886
+ const LEERGUT_UEBERSCHRIFT = 'Leergut-Rückgabe';
887
+ /** Zahlungszeile eines reinen Leergutbelegs: das Pfand geht bar zurueck an den Kunden. */
888
+ const LEERGUT_AUSZAHLUNG = 'Bar ausgezahlt';
889
+ /** Zusatz an der 0-%-Zeile, wenn Einwegpfand darauf liegt (kein Entgelt, nicht steuerbar). */
890
+ const PFAND_NICHT_STEUERBAR = 'Pfand, nicht steuerbar';
891
+ /** Vorsatz der Fusszeile mit der gemeinsamen Ruecknahmestelle. */
892
+ const LEERGUT_STELLE_VORSATZ = 'Leergut-Rückgabe: ';
893
+ /** Reiner Leergutbeleg: mindestens eine Leergut-Position, sonst nur Trinkgeld/Rabatt-freie Leergutzeilen. */
894
+ function istReinerLeergutBeleg(receipt) {
895
+ return receipt.items.length > 0 && receipt.items.some(isDepositReturnItem) && receipt.items.every(isDepositReturnItem);
896
+ }
897
+ /**
898
+ * Pfandzeilen, die unter ihrer Warenposition stehen (`depositFor` zeigt auf eine Ware, nicht auf Trinkgeld,
899
+ * Rabatt, Pfand oder Leergut und nicht auf sich selbst). Alle anderen Pfandzeilen bleiben an ihrem Platz.
900
+ */
901
+ function pfandZuPosition(items) {
902
+ const zu = new Map();
903
+ items.forEach((it, i) => {
904
+ if (!isDepositItem(it))
905
+ return;
906
+ const ziel = it.depositFor;
907
+ if (typeof ziel !== 'number' || !Number.isInteger(ziel) || ziel < 0 || ziel >= items.length || ziel === i)
908
+ return;
909
+ const hauptzeile = items[ziel];
910
+ if (isTipItem(hauptzeile) || isDiscountItem(hauptzeile) || isDepositItem(hauptzeile) || isDepositReturnItem(hauptzeile))
911
+ return;
912
+ zu.set(ziel, [...(zu.get(ziel) ?? []), i]);
913
+ });
914
+ return zu;
915
+ }
916
+ /**
917
+ * Bon-Reihenfolge mit Pfand: Hauptposition, ihre Zusaetze (je mit eigener Pfandzeile direkt darunter), dann die
918
+ * Pfandzeile der Hauptposition. Ohne Pfandverweise bleibt `reihe` unveraendert.
919
+ */
920
+ function mitPfandReihenfolge(items, reihe, zu) {
921
+ if (zu.size === 0)
922
+ return reihe;
923
+ const gebunden = new Set();
924
+ for (const liste of zu.values())
925
+ for (const i of liste)
926
+ gebunden.add(i);
927
+ const raus = [];
928
+ let offen = [];
929
+ for (const i of reihe) {
930
+ if (gebunden.has(i))
931
+ continue;
932
+ if (istGueltigerZusatz(items, i)) {
933
+ raus.push(i, ...(zu.get(i) ?? []));
934
+ continue;
935
+ }
936
+ raus.push(...offen);
937
+ raus.push(i);
938
+ offen = zu.get(i) ?? [];
939
+ }
940
+ raus.push(...offen);
941
+ return raus;
942
+ }
943
+ /** Einwegpfand und -leergut auf dem 0-%-Satz in Cent (Pfandzeilen minus Leergut); `null`, wenn keins darauf liegt. */
944
+ function einwegPfandCents(receipt) {
945
+ let summe = 0;
946
+ let gefunden = false;
947
+ for (const it of receipt.items) {
948
+ if (!(isDepositItem(it) || isDepositReturnItem(it)) || it.depositKind !== 'single_use')
949
+ continue;
950
+ if (steuersatz(it.vat).rate !== 0)
951
+ continue;
952
+ summe += receiptItemTotalCents(it);
953
+ gefunden = true;
954
+ }
955
+ return gefunden ? summe : null;
956
+ }
870
957
  // ---------------------------------------------------------------- Belegart
871
958
  const TESTKASSE_TEXT = 'TESTKASSE — kein gültiger Beleg';
872
959
  const TESTSIGNATUR_TEXT = 'TESTSIGNATUR — kein gültiger Beleg';
@@ -1044,6 +1131,9 @@ function belegartBlock(receipt) {
1044
1131
  for (const z of TRAINING_ERKLAERUNG)
1045
1132
  aus.push(textZeile(z, 'center'));
1046
1133
  }
1134
+ else if (istReinerLeergutBeleg(receipt)) {
1135
+ aus.push(textZeile(LEERGUT_UEBERSCHRIFT, 'center', true));
1136
+ }
1047
1137
  else if (t === 'start') {
1048
1138
  aus.push(bannerZeile('STARTBELEG'));
1049
1139
  aus.push(textZeile('Nullbeleg zur Inbetriebnahme', 'center'));
@@ -1188,7 +1278,12 @@ export function buildReceiptLayout(receipt, company, options = {}) {
1188
1278
  const gutscheinZuordnung = gutscheinPositionen(receipt);
1189
1279
  // Zusatz-Kacheln: Zusaetze direkt unter ihrer Hauptposition (stabil); ohne
1190
1280
  // Verweise ist die Reihenfolge die des Belegs (byte-gleich).
1191
- const reihe = addOnDisplayOrder(receipt.items);
1281
+ const pfandZu = pfandZuPosition(receipt.items);
1282
+ const gebundenesPfand = new Set();
1283
+ for (const liste of pfandZu.values())
1284
+ for (const k of liste)
1285
+ gebundenesPfand.add(k);
1286
+ const reihe = mitPfandReihenfolge(receipt.items, addOnDisplayOrder(receipt.items), pfandZu);
1192
1287
  const an = (k) => receipt.items[reihe[k]];
1193
1288
  let i = 0;
1194
1289
  while (i < reihe.length) {
@@ -1197,7 +1292,7 @@ export function buildReceiptLayout(receipt, company, options = {}) {
1197
1292
  const satz = steuersatz(item.vat);
1198
1293
  gruppeVon(satz).bruttoCents += receiptItemTotalCents(item);
1199
1294
  const gutschein = gutscheinZuordnung.get(reihe[i]);
1200
- lines.push(...(gutschein ? gutscheinPositionsZeilen(item, satz, gutschein) : [positionsZeile(item, satz, istGueltigerZusatz(receipt.items, reihe[i]))]));
1295
+ lines.push(...(gutschein ? gutscheinPositionsZeilen(item, satz, gutschein) : [positionsZeile(item, satz, istGueltigerZusatz(receipt.items, reihe[i]) || gebundenesPfand.has(reihe[i]))]));
1201
1296
  i += 1;
1202
1297
  continue;
1203
1298
  }
@@ -1293,6 +1388,10 @@ export function buildReceiptLayout(receipt, company, options = {}) {
1293
1388
  formatCents(bruttoCents),
1294
1389
  ], paperSize));
1295
1390
  }
1391
+ // Einwegpfand liegt auf dem 0-%-Satz, ist aber kein Entgelt: die Zeile sagt es dem Leser der Tabelle.
1392
+ const einwegCents = einwegPfandCents(receipt);
1393
+ if (einwegCents !== null)
1394
+ lines.push(paarZeile(PFAND_NICHT_STEUERBAR, formatCents(einwegCents), 9, 3));
1296
1395
  // Mitarbeiter-Trinkgeld ist als Null-%-Umsatz erfasst (Erlass 2.4.2.1), aber
1297
1396
  // kein Umsatz des Betriebs — die Klarstellung steht direkt unter der
1298
1397
  // 0-%-Zeile, damit der Beleg (auch als Rechnung) nicht nach steuerfreiem
@@ -1381,6 +1480,13 @@ export function buildReceiptLayout(receipt, company, options = {}) {
1381
1480
  lines.push(textZeile(fuss, 'center'));
1382
1481
  }
1383
1482
  }
1483
+ // Gemeinsame Ruecknahmestelle fuer Leergut (nur, wenn der Server sie gestempelt hat).
1484
+ const stelle = receipt.sharedReturnPoint;
1485
+ if (stelle != null) {
1486
+ const angabe = [stelle.name, stelle.address].filter((t) => t !== '').join(', ');
1487
+ if (angabe !== '')
1488
+ lines.push(textZeile(`${LEERGUT_STELLE_VORSATZ}${angabe}`, 'center'));
1489
+ }
1384
1490
  // --- Warnrahmen unten (Testkasse/Testsignatur)
1385
1491
  if (warnungen.length > 0) {
1386
1492
  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;
@@ -2,6 +2,7 @@ import { KasseneckValidationError } from '../client/errors.js';
2
2
  import { createTransport } from '../client/transport.js';
3
3
  import { fromReceiptCompanyPayload } from '../models/receipt-company.js';
4
4
  import { posSettingsFromWire } from '../pos/client.js';
5
+ import { cashRegisterDepositFromWire } from '../pos/pfand.js';
5
6
  /**
6
7
  * Die drei Aufrufe, die **ohne jede Identitaet** laufen: Kopplung eines
7
8
  * Geraets, Benutzerliste dieses Geraets, PIN-Anmeldung. Sie sind der Weg, auf
@@ -50,7 +51,7 @@ export const REGISTER_PERMS = [
50
51
  'sell', 'cancel', 'articles', 'layout', 'reports', 'takeover',
51
52
  'cancelScope', 'receiptsScope', 'drawer', 'discount', 'tipAssign',
52
53
  'stockView', 'stockCosts', 'stockMove', 'stockLoss', 'stocktakeCount', 'stocktakeClose', 'stockLocation',
53
- 'voucherSell', 'voucherRedeem', 'voucherManage',
54
+ 'voucherSell', 'voucherRedeem', 'voucherManage', 'depositReturn',
54
55
  ];
55
56
  /** Reichweite lesen, mit der Migration des Backends (register-auth.js). */
56
57
  export function cancelScopeOf(perms) {
@@ -77,6 +78,16 @@ export function stockViewOf(perms) {
77
78
  return false;
78
79
  return perms.stockView === undefined ? true : perms.stockView === true;
79
80
  }
81
+ /**
82
+ * Darf der Benutzer Leergut annehmen? Ohne Schluessel gilt das Recht als erteilt (Rollenvorgabe `Leergut annehmen`
83
+ * ist fuer Kassier und Chef an, ein alter Server und `/api`-Antworten kennen es nicht); nur ein ausdrueckliches
84
+ * `false` sperrt. Ohne Rechte-Objekt: nein.
85
+ */
86
+ export function depositReturnOf(perms) {
87
+ if (!perms)
88
+ return false;
89
+ return perms.depositReturn === undefined ? true : perms.depositReturn === true;
90
+ }
80
91
  /**
81
92
  * Gutschein-Rechte lesen. Das Backend loest sie bei der Anmeldung auf; ein
82
93
  * alter Server (und `/api`-Antworten) kennt sie nicht. Dann gilt je fehlendem
@@ -231,6 +242,7 @@ function kasseBereit(wert) {
231
242
  ready: roh['ready'],
232
243
  reason: typeof roh['reason'] === 'string' ? roh['reason'] : null,
233
244
  ...(typeof standort === 'string' && standort !== '' ? { stockLocationId: standort } : {}),
245
+ ...(cashRegisterDepositFromWire(roh['deposit']) ? { deposit: cashRegisterDepositFromWire(roh['deposit']) } : {}),
234
246
  };
235
247
  }
236
248
  /** 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 {
@@ -1,7 +1,7 @@
1
1
  // Erzeugt von scripts/stored-vokabular.mjs aus fixtures/v3/v3-vokabular.json.
2
2
  // Nicht von Hand aendern: test/stored.test.ts vergleicht mit dem Vertrag.
3
3
  /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
4
- export const VOKABULAR_QUELLE = "04ab5e1d031979a4f0aa31ea000f4cbe1d6e557e2411e439899ac19a1bba0325";
4
+ export const VOKABULAR_QUELLE = "168261a0b5130d454fc3b5d51e8ee567d6a3e9a5d2d8e172829e9ccb17c47f31";
5
5
  /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
6
6
  export const SCHEMAS = {
7
7
  "getReceipt": {
@@ -20,7 +20,12 @@ export const SCHEMAS = {
20
20
  "__": "items",
21
21
  "receivedImmediately": "sofortErhalten",
22
22
  "keptByEmployee": "direkt",
23
- "addOnOf": "zusatzZu"
23
+ "addOnOf": "zusatzZu",
24
+ "depositTypeId": "pfandartId",
25
+ "depositFor": "pfandZu",
26
+ "depositKind": "pfandArt",
27
+ "perUnit": "jeStueck",
28
+ "ownFilling": "eigen"
24
29
  }
25
30
  ],
26
31
  "manualReceipt": {
@@ -32,6 +37,11 @@ export const SCHEMAS = {
32
37
  "time": "uhrzeit",
33
38
  "reason": "grund",
34
39
  "note": "grundText"
40
+ },
41
+ "onPremises": "vorOrt",
42
+ "sharedReturnPoint": {
43
+ "__": "pfandStelle",
44
+ "address": "adresse"
35
45
  }
36
46
  },
37
47
  "taxNumber": "taxnr",
@@ -96,6 +106,12 @@ export const SCHEMAS = {
96
106
  "layout.lines[].tone": {
97
107
  "$catalog": "LAYOUT_TON"
98
108
  },
109
+ "receipt.items[].kind": {
110
+ "$catalog": "PFAND_KIND"
111
+ },
112
+ "receipt.items[].depositKind": {
113
+ "$catalog": "PFAND_ART"
114
+ },
99
115
  "issuedVouchers[].type": {
100
116
  "$catalog": "GUTSCHEIN_ART"
101
117
  },
@@ -310,9 +326,36 @@ export const SCHEMAS = {
310
326
  "__": "connect",
311
327
  "minimumVersion": "mindestversion",
312
328
  "deadline": "frist"
329
+ },
330
+ "deposit": {
331
+ "__": "pfand",
332
+ "singleUse": "einweg",
333
+ "reusable": "mehrweg",
334
+ "depositTypes": [
335
+ {
336
+ "__": "pfandarten",
337
+ "kind": "art",
338
+ "type": "typ",
339
+ "amounts": [
340
+ {
341
+ "__": "betraege",
342
+ "from": "ab"
343
+ }
344
+ ],
345
+ "returnRate": "rueckgabeSatz",
346
+ "used": "verwendet",
347
+ "active": "aktiv"
348
+ }
349
+ ]
313
350
  }
314
351
  },
315
352
  "werte": {
353
+ "deposit.depositTypes[].kind": {
354
+ "$catalog": "PFAND_ART"
355
+ },
356
+ "deposit.depositTypes[].type": {
357
+ "$catalog": "PFAND_TYP"
358
+ },
316
359
  "business.watermark": {
317
360
  "$catalog": "KASSE_BETRIEB_WERTE.watermark"
318
361
  },
@@ -425,7 +468,15 @@ export const SCHEMAS = {
425
468
  "patternStrict": "musterStreng"
426
469
  },
427
470
  "addOns": "zusaetze",
428
- "externalVoucher": "fremdgutschein"
471
+ "externalVoucher": "fremdgutschein",
472
+ "deposits": [
473
+ {
474
+ "__": "pfand",
475
+ "depositTypeId": "pfandartId",
476
+ "quantity": "menge",
477
+ "ownFilling": "eigen"
478
+ }
479
+ ]
429
480
  }
430
481
  ]
431
482
  },
@@ -475,7 +526,8 @@ export const ARTIKEL_FELDER = [
475
526
  "askPrice",
476
527
  "reference",
477
528
  "addOns",
478
- "externalVoucher"
529
+ "externalVoucher",
530
+ "deposits"
479
531
  ];
480
532
  /** Wertkataloge innen (deutsch) -> aussen (englisch). */
481
533
  export const KATALOGE = {
@@ -774,6 +826,22 @@ export const KATALOGE = {
774
826
  "stueck": "piece",
775
827
  "dezimal": "decimal"
776
828
  },
829
+ "PFAND_ART": {
830
+ "einweg": "single_use",
831
+ "mehrweg": "reusable"
832
+ },
833
+ "PFAND_KIND": {
834
+ "pfand": "deposit",
835
+ "pfand_rueckgabe": "deposit_return"
836
+ },
837
+ "PFAND_TYP": {
838
+ "flasche": "bottle",
839
+ "kiste": "crate",
840
+ "fass": "keg",
841
+ "becher": "cup",
842
+ "glas": "glass",
843
+ "sonstiges": "other"
844
+ },
777
845
  "REFERENZ_STUFE": {
778
846
  "fragen": "optional",
779
847
  "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.1";
@@ -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 const PACKAGE_VERSION = '1.31.0';
7
+ export const PACKAGE_VERSION = '1.32.1';