@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.
- package/CHANGELOG.md +22 -0
- package/dist/cjs/client/aufrufe.d.ts +3 -3
- package/dist/cjs/client/aufrufe.js +8 -0
- package/dist/cjs/client/receipts.d.ts +11 -0
- package/dist/cjs/client/receipts.js +28 -2
- package/dist/cjs/index.d.ts +2 -2
- package/dist/cjs/index.js +8 -5
- package/dist/cjs/models/index.d.ts +1 -1
- package/dist/cjs/models/index.js +5 -2
- package/dist/cjs/models/receipt-errors.d.ts +1 -1
- package/dist/cjs/models/receipt-errors.js +9 -0
- package/dist/cjs/models/receipt-item.d.ts +44 -2
- package/dist/cjs/models/receipt-item.js +56 -1
- package/dist/cjs/models/receipt.d.ts +17 -0
- package/dist/cjs/models/receipt.js +9 -0
- package/dist/cjs/pos/artikel.d.ts +14 -0
- package/dist/cjs/pos/artikel.js +3 -0
- package/dist/cjs/pos/client.d.ts +1 -0
- package/dist/cjs/pos/client.js +3 -0
- package/dist/cjs/pos/errors.d.ts +1 -1
- package/dist/cjs/pos/errors.js +12 -0
- package/dist/cjs/pos/fremdgutschein-artikel.d.ts +3 -2
- package/dist/cjs/pos/fremdgutschein-artikel.js +4 -2
- package/dist/cjs/pos/index.d.ts +4 -2
- package/dist/cjs/pos/index.js +24 -4
- package/dist/cjs/pos/leergut.d.ts +60 -0
- package/dist/cjs/pos/leergut.js +82 -0
- package/dist/cjs/pos/pfand.d.ts +144 -0
- package/dist/cjs/pos/pfand.js +382 -0
- package/dist/cjs/pos/settings.d.ts +3 -7
- package/dist/cjs/pos/settings.js +7 -0
- package/dist/cjs/pos/texte.d.ts +72 -0
- package/dist/cjs/pos/texte.js +42 -1
- package/dist/cjs/receipt/discount.js +3 -0
- package/dist/cjs/receipt/due.d.ts +6 -0
- package/dist/cjs/receipt/due.js +16 -5
- package/dist/cjs/receipt/gutschein-plan.d.ts +7 -1
- package/dist/cjs/receipt/gutschein-plan.js +16 -2
- package/dist/cjs/receipt/layout.js +108 -2
- package/dist/cjs/register/pairing.d.ts +15 -1
- package/dist/cjs/register/pairing.js +14 -1
- package/dist/cjs/stored/vokabular.d.ts +1 -1
- package/dist/cjs/stored/vokabular.js +72 -4
- package/dist/cjs/version.d.ts +1 -1
- package/dist/cjs/version.js +1 -1
- package/dist/esm/client/aufrufe.d.ts +3 -3
- package/dist/esm/client/aufrufe.js +8 -0
- package/dist/esm/client/receipts.d.ts +11 -0
- package/dist/esm/client/receipts.js +29 -3
- package/dist/esm/index.d.ts +2 -2
- package/dist/esm/index.js +2 -2
- package/dist/esm/models/index.d.ts +1 -1
- package/dist/esm/models/index.js +1 -1
- package/dist/esm/models/receipt-errors.d.ts +1 -1
- package/dist/esm/models/receipt-errors.js +9 -0
- package/dist/esm/models/receipt-item.d.ts +44 -2
- package/dist/esm/models/receipt-item.js +54 -1
- package/dist/esm/models/receipt.d.ts +17 -0
- package/dist/esm/models/receipt.js +9 -0
- package/dist/esm/pos/artikel.d.ts +14 -0
- package/dist/esm/pos/artikel.js +3 -0
- package/dist/esm/pos/client.d.ts +1 -0
- package/dist/esm/pos/client.js +3 -0
- package/dist/esm/pos/errors.d.ts +1 -1
- package/dist/esm/pos/errors.js +12 -0
- package/dist/esm/pos/fremdgutschein-artikel.d.ts +3 -2
- package/dist/esm/pos/fremdgutschein-artikel.js +4 -2
- package/dist/esm/pos/index.d.ts +4 -2
- package/dist/esm/pos/index.js +4 -2
- package/dist/esm/pos/leergut.d.ts +60 -0
- package/dist/esm/pos/leergut.js +77 -0
- package/dist/esm/pos/pfand.d.ts +144 -0
- package/dist/esm/pos/pfand.js +371 -0
- package/dist/esm/pos/settings.d.ts +3 -7
- package/dist/esm/pos/settings.js +7 -0
- package/dist/esm/pos/texte.d.ts +72 -0
- package/dist/esm/pos/texte.js +40 -0
- package/dist/esm/receipt/discount.js +4 -1
- package/dist/esm/receipt/due.d.ts +6 -0
- package/dist/esm/receipt/due.js +17 -6
- package/dist/esm/receipt/gutschein-plan.d.ts +7 -1
- package/dist/esm/receipt/gutschein-plan.js +14 -2
- package/dist/esm/receipt/layout.js +109 -3
- package/dist/esm/register/pairing.d.ts +15 -1
- package/dist/esm/register/pairing.js +13 -1
- package/dist/esm/stored/vokabular.d.ts +1 -1
- package/dist/esm/stored/vokabular.js +72 -4
- package/dist/esm/version.d.ts +1 -1
- package/dist/esm/version.js +1 -1
- package/fixtures/deposit-cases.json +4758 -0
- package/fixtures/expected/deposit-return.grid32.txt +28 -0
- package/fixtures/expected/deposit-return.grid48.txt +28 -0
- package/fixtures/expected/deposit-return.lines.json +275 -0
- package/fixtures/expected/deposit-return.sheet32.json +194 -0
- package/fixtures/expected/deposit-return.sheet48.json +194 -0
- package/fixtures/expected/deposit.grid32.txt +34 -0
- package/fixtures/expected/deposit.grid48.txt +32 -0
- package/fixtures/expected/deposit.lines.json +316 -0
- package/fixtures/expected/deposit.sheet32.json +230 -0
- package/fixtures/expected/deposit.sheet48.json +218 -0
- package/fixtures/external-voucher-article-cases.json +20 -0
- package/fixtures/hobex-hps-codes.json +1 -1
- package/fixtures/invoice-api.schema.json +1 -1
- package/fixtures/invoice-texts.json +1 -1
- package/fixtures/manifest.json +16 -0
- package/fixtures/pos-texts.json +66 -1
- package/fixtures/receipts/deposit-return.json +63 -0
- package/fixtures/receipts/deposit.json +83 -0
- package/fixtures/return-code-cases.json +1338 -0
- package/fixtures/surface.json +45 -4
- package/fixtures/v3/antworten/belege.json +2 -2
- package/fixtures/v3/antworten/belegmail.json +2 -2
- package/fixtures/v3/antworten/berichte.json +2 -2
- package/fixtures/v3/antworten/kasse-belege.json +2 -2
- package/fixtures/v3/antworten/kasse.json +428 -13
- package/fixtures/v3/antworten/lager.json +1 -1
- package/fixtures/v3/antworten/rechnungen.json +2 -2
- package/fixtures/v3/antworten/storno.json +2 -2
- package/fixtures/v3/stored/belege.json +2 -2
- package/fixtures/v3/stored/kasse.json +42 -4
- package/fixtures/v3/stored/rechnungen.json +2 -2
- package/fixtures/v3/v3-vokabular.json +808 -27
- package/fixtures/v3/zahlbetrag-faelle.json +187 -3
- package/package.json +1 -1
package/dist/esm/receipt/due.js
CHANGED
|
@@ -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
|
-
|
|
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 &&
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
|
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 = "
|
|
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 = "
|
|
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"
|
package/dist/esm/version.d.ts
CHANGED
package/dist/esm/version.js
CHANGED