@kreiseck/kasseneck-api 1.37.0 → 1.38.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 (149) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/README.md +16 -0
  3. package/dist/cjs/index.d.ts +1 -1
  4. package/dist/cjs/index.js +6 -5
  5. package/dist/cjs/invoice/texte.d.ts +18 -1
  6. package/dist/cjs/invoice/texte.js +43 -2
  7. package/dist/cjs/invoice/vertrag.d.ts +1 -1
  8. package/dist/cjs/invoice/vertrag.js +1 -0
  9. package/dist/cjs/models/cancellation.d.ts +1 -1
  10. package/dist/cjs/models/cancellation.js +2 -0
  11. package/dist/cjs/models/index.d.ts +2 -1
  12. package/dist/cjs/models/index.js +6 -3
  13. package/dist/cjs/models/invoice-payment-ref.d.ts +42 -0
  14. package/dist/cjs/models/invoice-payment-ref.js +38 -0
  15. package/dist/cjs/models/receipt-item.d.ts +10 -2
  16. package/dist/cjs/models/receipt-item.js +14 -1
  17. package/dist/cjs/models/receipt.d.ts +7 -0
  18. package/dist/cjs/models/receipt.js +6 -0
  19. package/dist/cjs/pos/schicht-lesen.js +5 -0
  20. package/dist/cjs/pos/schicht-typen.d.ts +11 -0
  21. package/dist/cjs/pos/texte.d.ts +13 -2
  22. package/dist/cjs/pos/texte.js +18 -3
  23. package/dist/cjs/receipt/index.d.ts +1 -0
  24. package/dist/cjs/receipt/index.js +4 -2
  25. package/dist/cjs/receipt/layout.d.ts +2 -2
  26. package/dist/cjs/receipt/layout.js +106 -117
  27. package/dist/cjs/receipt/shift-sheet.js +6 -1
  28. package/dist/cjs/receipt/vermerke.d.ts +80 -0
  29. package/dist/cjs/receipt/vermerke.js +167 -0
  30. package/dist/cjs/stored/draht.js +25 -1
  31. package/dist/cjs/stored/vokabular.d.ts +1 -1
  32. package/dist/cjs/stored/vokabular.js +21 -2
  33. package/dist/cjs/version.d.ts +1 -1
  34. package/dist/cjs/version.js +1 -1
  35. package/dist/esm/index.d.ts +1 -1
  36. package/dist/esm/index.js +1 -1
  37. package/dist/esm/invoice/texte.d.ts +18 -1
  38. package/dist/esm/invoice/texte.js +43 -2
  39. package/dist/esm/invoice/vertrag.d.ts +1 -1
  40. package/dist/esm/invoice/vertrag.js +1 -0
  41. package/dist/esm/models/cancellation.d.ts +1 -1
  42. package/dist/esm/models/cancellation.js +2 -0
  43. package/dist/esm/models/index.d.ts +2 -1
  44. package/dist/esm/models/index.js +2 -1
  45. package/dist/esm/models/invoice-payment-ref.d.ts +42 -0
  46. package/dist/esm/models/invoice-payment-ref.js +35 -0
  47. package/dist/esm/models/receipt-item.d.ts +10 -2
  48. package/dist/esm/models/receipt-item.js +13 -1
  49. package/dist/esm/models/receipt.d.ts +7 -0
  50. package/dist/esm/models/receipt.js +6 -0
  51. package/dist/esm/pos/schicht-lesen.js +5 -0
  52. package/dist/esm/pos/schicht-typen.d.ts +11 -0
  53. package/dist/esm/pos/texte.d.ts +13 -2
  54. package/dist/esm/pos/texte.js +18 -3
  55. package/dist/esm/receipt/index.d.ts +1 -0
  56. package/dist/esm/receipt/index.js +1 -0
  57. package/dist/esm/receipt/layout.d.ts +2 -2
  58. package/dist/esm/receipt/layout.js +103 -113
  59. package/dist/esm/receipt/shift-sheet.js +6 -1
  60. package/dist/esm/receipt/vermerke.d.ts +80 -0
  61. package/dist/esm/receipt/vermerke.js +155 -0
  62. package/dist/esm/stored/draht.js +25 -1
  63. package/dist/esm/stored/vokabular.d.ts +1 -1
  64. package/dist/esm/stored/vokabular.js +21 -2
  65. package/dist/esm/version.d.ts +1 -1
  66. package/dist/esm/version.js +1 -1
  67. package/fixtures/expected/invoice-payment-cancellation.grid32.txt +28 -0
  68. package/fixtures/expected/invoice-payment-cancellation.grid48.txt +26 -0
  69. package/fixtures/expected/invoice-payment-cancellation.lines.json +189 -0
  70. package/fixtures/expected/invoice-payment-cancellation.sheet32.json +194 -0
  71. package/fixtures/expected/invoice-payment-cancellation.sheet48.json +182 -0
  72. package/fixtures/expected/invoice-payment-manual-receipt.grid32.txt +30 -0
  73. package/fixtures/expected/invoice-payment-manual-receipt.grid48.txt +29 -0
  74. package/fixtures/expected/invoice-payment-manual-receipt.lines.json +199 -0
  75. package/fixtures/expected/invoice-payment-manual-receipt.sheet32.json +206 -0
  76. package/fixtures/expected/invoice-payment-manual-receipt.sheet48.json +200 -0
  77. package/fixtures/expected/invoice-payment-normal.grid32.txt +22 -0
  78. package/fixtures/expected/invoice-payment-normal.grid48.txt +21 -0
  79. package/fixtures/expected/invoice-payment-normal.lines.json +192 -0
  80. package/fixtures/expected/invoice-payment-normal.sheet32.json +158 -0
  81. package/fixtures/expected/invoice-payment-normal.sheet48.json +152 -0
  82. package/fixtures/expected/invoice-payment-outage.grid32.txt +23 -0
  83. package/fixtures/expected/invoice-payment-outage.grid48.txt +21 -0
  84. package/fixtures/expected/invoice-payment-outage.lines.json +172 -0
  85. package/fixtures/expected/invoice-payment-outage.sheet32.json +164 -0
  86. package/fixtures/expected/invoice-payment-outage.sheet48.json +152 -0
  87. package/fixtures/expected/invoice-payment-partial.grid32.txt +20 -0
  88. package/fixtures/expected/invoice-payment-partial.grid48.txt +20 -0
  89. package/fixtures/expected/invoice-payment-partial.lines.json +162 -0
  90. package/fixtures/expected/invoice-payment-partial.sheet32.json +146 -0
  91. package/fixtures/expected/invoice-payment-partial.sheet48.json +146 -0
  92. package/fixtures/expected/invoice-payment-refund.grid32.txt +20 -0
  93. package/fixtures/expected/invoice-payment-refund.grid48.txt +20 -0
  94. package/fixtures/expected/invoice-payment-refund.lines.json +162 -0
  95. package/fixtures/expected/invoice-payment-refund.sheet32.json +146 -0
  96. package/fixtures/expected/invoice-payment-refund.sheet48.json +146 -0
  97. package/fixtures/expected/invoice-payment-see-invoice.grid32.txt +22 -0
  98. package/fixtures/expected/invoice-payment-see-invoice.grid48.txt +21 -0
  99. package/fixtures/expected/invoice-payment-see-invoice.lines.json +192 -0
  100. package/fixtures/expected/invoice-payment-see-invoice.sheet32.json +158 -0
  101. package/fixtures/expected/invoice-payment-see-invoice.sheet48.json +152 -0
  102. package/fixtures/expected/invoice-payment-training.grid32.txt +30 -0
  103. package/fixtures/expected/invoice-payment-training.grid48.txt +27 -0
  104. package/fixtures/expected/invoice-payment-training.lines.json +183 -0
  105. package/fixtures/expected/invoice-payment-training.sheet32.json +206 -0
  106. package/fixtures/expected/invoice-payment-training.sheet48.json +188 -0
  107. package/fixtures/expected/invoice-payment-without-vat.grid32.txt +20 -0
  108. package/fixtures/expected/invoice-payment-without-vat.grid48.txt +19 -0
  109. package/fixtures/expected/invoice-payment-without-vat.lines.json +162 -0
  110. package/fixtures/expected/invoice-payment-without-vat.sheet32.json +146 -0
  111. package/fixtures/expected/invoice-payment-without-vat.sheet48.json +140 -0
  112. package/fixtures/expected/invoice-payment-zero-percent.grid32.txt +22 -0
  113. package/fixtures/expected/invoice-payment-zero-percent.grid48.txt +21 -0
  114. package/fixtures/expected/invoice-payment-zero-percent.lines.json +192 -0
  115. package/fixtures/expected/invoice-payment-zero-percent.sheet32.json +158 -0
  116. package/fixtures/expected/invoice-payment-zero-percent.sheet48.json +152 -0
  117. package/fixtures/hobex-hps-codes.json +1 -1
  118. package/fixtures/invoice-api.schema.json +3 -2
  119. package/fixtures/invoice-texts.json +37 -3
  120. package/fixtures/manifest.json +80 -0
  121. package/fixtures/pos-message-cases.json +3 -0
  122. package/fixtures/pos-texts.json +14 -1
  123. package/fixtures/receipt-due-generated.json +3 -3
  124. package/fixtures/receipt-due-voucher-generated.json +5 -5
  125. package/fixtures/receipts/invoice-payment-cancellation.json +70 -0
  126. package/fixtures/receipts/invoice-payment-manual-receipt.json +69 -0
  127. package/fixtures/receipts/invoice-payment-normal.json +65 -0
  128. package/fixtures/receipts/invoice-payment-outage.json +63 -0
  129. package/fixtures/receipts/invoice-payment-partial.json +63 -0
  130. package/fixtures/receipts/invoice-payment-refund.json +63 -0
  131. package/fixtures/receipts/invoice-payment-see-invoice.json +65 -0
  132. package/fixtures/receipts/invoice-payment-training.json +63 -0
  133. package/fixtures/receipts/invoice-payment-without-vat.json +63 -0
  134. package/fixtures/receipts/invoice-payment-zero-percent.json +65 -0
  135. package/fixtures/surface.json +3 -2
  136. package/fixtures/v3/antworten/belege.json +2 -2
  137. package/fixtures/v3/antworten/belegmail.json +2 -2
  138. package/fixtures/v3/antworten/berichte.json +2 -2
  139. package/fixtures/v3/antworten/kasse-belege.json +2 -2
  140. package/fixtures/v3/antworten/kasse.json +10 -127
  141. package/fixtures/v3/antworten/lager.json +1 -1
  142. package/fixtures/v3/antworten/rechnungen.json +2 -2
  143. package/fixtures/v3/antworten/storno.json +2 -2
  144. package/fixtures/v3/stored/belege.json +2 -2
  145. package/fixtures/v3/stored/kasse.json +3 -3
  146. package/fixtures/v3/stored/rechnungen.json +2 -2
  147. package/fixtures/v3/v3-vokabular.json +172 -18
  148. package/fixtures/v3/zahlbetrag-faelle.json +2 -2
  149. package/package.json +1 -1
@@ -0,0 +1,80 @@
1
+ import { type Receipt } from '../models/index.js';
2
+ /**
3
+ * Vermerke eines Belegs: was ihn als besonderen Beleg ausweist (Testkasse,
4
+ * Testsignatur, Training, Storno, Nacherfassung, Signaturausfall). Eine Quelle
5
+ * fuer die Regeln: der Bon ([buildReceiptLayout]) setzt seine Bloecke aus
6
+ * diesen Bausteinen, und [receiptNotes] gibt sie strukturiert hinaus, damit
7
+ * ein anderes Blatt (Kassenteil auf der A4-Rechnung, Zahlungsbestaetigung)
8
+ * dieselben Vermerke anordnet, ohne eigene Regeln zu erfinden.
9
+ *
10
+ * Die Woerter sind Pflichtwoerter und bleiben in jeder Sprache deutsch
11
+ * (RKSV § 11 Abs. 3: Trainings- und Stornobuchungen ausdruecklich als solche
12
+ * bezeichnen; § 17 Abs. 4 und 5: Signaturausfall, Nacherfassung).
13
+ *
14
+ * „Duplikat“ ist kein Vermerk des Belegs: das druckt nur der Nachdruck auf
15
+ * Papier ([markAsDuplicate]).
16
+ *
17
+ * Abhaengig nur vom Belegmodell und der Wiener Zeit, damit der Zwilling in der
18
+ * 0.x-Linie und in Dart dieselben Regeln ohne den Rest des Layouts hat.
19
+ */
20
+ /** Art eines Vermerks, in der festen Reihenfolge von [receiptNotes]. */
21
+ export type ReceiptNoteKind = 'test_cashregister' | 'test_signature' | 'training' | 'cancellation' | 'manual_receipt' | 'signature_outage';
22
+ /** Ein Vermerk: Titel (hervorgehoben) und Zeilen darunter, fertiger Text. */
23
+ export interface ReceiptNote {
24
+ kind: ReceiptNoteKind;
25
+ title: string;
26
+ lines: string[];
27
+ }
28
+ export interface ReceiptNotesOptions {
29
+ /** Beleg einer Testumgebung (wie [BuildReceiptLayoutOptions.testCashregister]). */
30
+ testCashregister?: boolean;
31
+ /** Produktionskonto mit Test-Signatureinheit (wie [BuildReceiptLayoutOptions.testSignature]). */
32
+ testSignature?: boolean;
33
+ }
34
+ export declare const TESTKASSE_TEXT = "TESTKASSE \u2014 kein g\u00FCltiger Beleg";
35
+ export declare const TESTSIGNATUR_TEXT = "TESTSIGNATUR \u2014 kein g\u00FCltiger Beleg";
36
+ /** Text, den das Backend statt einer Signatur ablegt, wenn die Karte ausfaellt. */
37
+ export declare const SIGNATUR_AUSGEFALLEN = "Sicherheitseinrichtung ausgefallen";
38
+ /** Wurde der Beleg ohne funktionierende Signatureinheit ausgestellt? */
39
+ export declare function receiptSignatureFailed(receipt: Pick<Receipt, 'sig'>): boolean;
40
+ /** Belegtyp als Zeichenkette (Enum-Objekt oder roher Serverwert). */
41
+ export declare function belegtyp(receipt: Pick<Receipt, 'receiptType'>): string;
42
+ export declare function testkasseVermerk(): ReceiptNote;
43
+ export declare function testsignaturVermerk(): ReceiptNote;
44
+ /** Trainingsbeleg: Titel und Erklaerung; sonst `null`. */
45
+ export declare function trainingVermerk(receipt: Receipt): ReceiptNote | null;
46
+ /** Stornobeleg: Bezug, Datum des Originals (wenn der Bezug es traegt, Backend seit 2026-09-04) und Grund; sonst `null`. */
47
+ export declare function stornoVermerk(receipt: Receipt): ReceiptNote | null;
48
+ /**
49
+ * Teile der Nacherfassung: Anlass (Art und Grund), Handbeleg (Nummer und Tag) und der USt-Hinweis.
50
+ * Der Vermerk (§ 17 Abs. 5 RKSV) besteht aus Titel, Anlass und Handbeleg; den USt-Hinweis setzt nur
51
+ * der Bon, denn ob er gilt, haengt an der Firma (Kleinunternehmer) und am Beleg (Zahlungsbeleg).
52
+ */
53
+ export interface NacherfassungTeile {
54
+ title: string;
55
+ anlass: string[];
56
+ handbeleg: string[];
57
+ /** „USt: Duplikat des Handbelegs“ bzw. „… der Handbelege“ (Registrierkassenerlass 3.3 Faelle 5 und 6, 2.4.11). */
58
+ ustHinweis: string;
59
+ }
60
+ /**
61
+ * Nacherfassung eines Handbelegs (manualReceipt): Art, Grund, Nummer und Tag
62
+ * des Handbelegs bzw. der Handbelege eines Tagessammelbelegs. Ohne Handbeleg `null`.
63
+ */
64
+ export declare function nacherfassungTeile(receipt: Receipt): NacherfassungTeile | null;
65
+ /** Signaturausfall (§ 17 Abs. 4 RKSV): der Vermerk ohne Zeilen; sonst `null`. */
66
+ export declare function signaturausfallVermerk(receipt: Receipt): ReceiptNote | null;
67
+ /**
68
+ * Die Vermerke eines Belegs in fester Reihenfolge: Testkasse, Testsignatur,
69
+ * Training, Storno, Nacherfassung, Signaturausfall. Ein gewoehnlicher Beleg
70
+ * hat keine (`[]`).
71
+ *
72
+ * Ob Testkasse oder Testsignatur, weiss nur der Aufrufer (er kennt das Konto),
73
+ * wie bei [buildReceiptLayout]. Eine unbekannte Option wirft
74
+ * (`KasseneckValidationError`, `scope: 'request'`): eine alte deutsche
75
+ * (`testKasse`) darf nie still wegfallen, sonst saehe ein Testbeleg gueltig aus.
76
+ *
77
+ * Firmendaten kennt diese Ausgabe nicht; der USt-Hinweis der Nacherfassung
78
+ * („USt: Duplikat …“) gehoert darum nicht zum Vermerk (siehe [NacherfassungTeile]).
79
+ */
80
+ export declare function receiptNotes(receipt: Receipt, options?: ReceiptNotesOptions): ReceiptNote[];
@@ -0,0 +1,155 @@
1
+ import { CANCELLATION_REASONS, isCancellationReason } from '../models/index.js';
2
+ import { parseServerTimeStamp, toViennaWallClock } from '../vienna-time.js';
3
+ import { KasseneckValidationError } from '../client/errors.js';
4
+ // ------------------------------------------------------------------- Texte
5
+ export const TESTKASSE_TEXT = 'TESTKASSE — kein gültiger Beleg';
6
+ export const TESTSIGNATUR_TEXT = 'TESTSIGNATUR — kein gültiger Beleg';
7
+ /** Text, den das Backend statt einer Signatur ablegt, wenn die Karte ausfaellt. */
8
+ export const SIGNATUR_AUSGEFALLEN = 'Sicherheitseinrichtung ausgefallen';
9
+ /**
10
+ * Derselbe Text base64url-kodiert -- so steht er als dritter JWS-Teil im Feld
11
+ * `sig` (Zwilling von `RKSVService.isSigSuccess`). Fest hinterlegt statt zur
12
+ * Laufzeit kodiert: `btoa`/`Buffer` sind in Browser und Node verschieden zu
13
+ * haben, und der Wert ist unveraenderlich.
14
+ */
15
+ const SIGNATUR_AUSGEFALLEN_BASE64URL = 'U2ljaGVyaGVpdHNlaW5yaWNodHVuZyBhdXNnZWZhbGxlbg';
16
+ /** Erklaerung am Trainingsbeleg (Wortlaut mit dem Betreiber abgestimmt). */
17
+ const TRAINING_ERKLAERUNG = [
18
+ 'Trainingsbuchung — kein Kauf, keine Zahlung, keine steuerliche Buchung.',
19
+ 'Sollten Sie diesen Beleg als Kunde erhalten haben, sagen Sie bitte dem Betrieb Bescheid.',
20
+ ];
21
+ /** Grund-Zeile nach einem Ausfall der Kasse; `other` druckt den eigenen Text. */
22
+ const NACHERFASSUNG_GRUND = {
23
+ network_outage: 'Internet', power_outage: 'Strom', device_failure: 'Gerät defekt', system_outage: 'Störung',
24
+ };
25
+ // ------------------------------------------------------------ Hilfsregeln
26
+ /** Wurde der Beleg ohne funktionierende Signatureinheit ausgestellt? */
27
+ export function receiptSignatureFailed(receipt) {
28
+ return receipt.sig.split('.')[2] === SIGNATUR_AUSGEFALLEN_BASE64URL;
29
+ }
30
+ /** Belegtyp als Zeichenkette (Enum-Objekt oder roher Serverwert). */
31
+ export function belegtyp(receipt) {
32
+ return typeof receipt.receiptType === 'object' ? receipt.receiptType.value : String(receipt.receiptType ?? '');
33
+ }
34
+ /**
35
+ * Datum des stornierten Originals: „11.08.2026, 09:02 Uhr". Ein unlesbarer
36
+ * Zeitstempel am BEZUG ist kein Grund, den Storno-Bon zu verweigern (der
37
+ * Beleg selbst ist gueltig) -- dann bleibt die Zeile weg.
38
+ */
39
+ function originalDatum(timeStamp) {
40
+ try {
41
+ const t = toViennaWallClock(parseServerTimeStamp(timeStamp));
42
+ const zwei = (n) => String(n).padStart(2, '0');
43
+ return `${zwei(t.day)}.${zwei(t.month)}.${t.year}, ${zwei(t.hour)}:${zwei(t.minute)} Uhr`;
44
+ }
45
+ catch {
46
+ return null;
47
+ }
48
+ }
49
+ /**
50
+ * Grund eines Stornos lesbar -- aus dem EINEN Katalog des Modells
51
+ * (`CANCELLATION_REASONS`, derselbe, den die Kasse anbietet und das Backend
52
+ * annimmt). Unbekannter Code (Fremdclient): sichtbar, aber ohne zu werfen.
53
+ */
54
+ function stornoGrundText(code) {
55
+ if (!code)
56
+ return null;
57
+ return isCancellationReason(code) ? CANCELLATION_REASONS[code] : code;
58
+ }
59
+ /** `YYYY-MM-DD` als `TT.MM.JJJJ`; anderes bleibt, wie es kam. */
60
+ function handbelegDatum(tag) {
61
+ const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(tag);
62
+ return m ? `${m[3]}.${m[2]}.${m[1]}` : tag;
63
+ }
64
+ // ---------------------------------------------------------------- Bausteine
65
+ export function testkasseVermerk() {
66
+ return { kind: 'test_cashregister', title: TESTKASSE_TEXT, lines: [] };
67
+ }
68
+ export function testsignaturVermerk() {
69
+ return { kind: 'test_signature', title: TESTSIGNATUR_TEXT, lines: [] };
70
+ }
71
+ /** Trainingsbeleg: Titel und Erklaerung; sonst `null`. */
72
+ export function trainingVermerk(receipt) {
73
+ return belegtyp(receipt) === 'training' ? { kind: 'training', title: 'TRAININGSBELEG', lines: [...TRAINING_ERKLAERUNG] } : null;
74
+ }
75
+ /** Stornobeleg: Bezug, Datum des Originals (wenn der Bezug es traegt, Backend seit 2026-09-04) und Grund; sonst `null`. */
76
+ export function stornoVermerk(receipt) {
77
+ if (belegtyp(receipt) !== 'cancellation')
78
+ return null;
79
+ const zeilen = [receipt.cancellationOf ? `Stornobuchung zu Beleg ${receipt.cancellationOf.receiptId}` : 'Stornobuchung'];
80
+ const datum = receipt.cancellationOf?.timeStamp ? originalDatum(receipt.cancellationOf.timeStamp) : null;
81
+ if (datum)
82
+ zeilen.push(`vom ${datum}`);
83
+ const grund = stornoGrundText(typeof receipt.cancellationReason === 'string' ? receipt.cancellationReason : undefined);
84
+ if (grund)
85
+ zeilen.push(`Grund: ${grund}`);
86
+ return { kind: 'cancellation', title: 'STORNOBELEG', lines: zeilen };
87
+ }
88
+ /**
89
+ * Nacherfassung eines Handbelegs (manualReceipt): Art, Grund, Nummer und Tag
90
+ * des Handbelegs bzw. der Handbelege eines Tagessammelbelegs. Ohne Handbeleg `null`.
91
+ */
92
+ export function nacherfassungTeile(receipt) {
93
+ const m = receipt.manualReceipt;
94
+ if (!m)
95
+ return null;
96
+ const anlass = [m.reason === 'outside_premises' ? 'Leistung außer Haus' : 'nach Ausfall der Kasse'];
97
+ const grund = m.reason === 'other' ? m.note : NACHERFASSUNG_GRUND[m.reason];
98
+ if (grund)
99
+ anlass.push(`Grund: ${grund}`);
100
+ const tag = handbelegDatum(m.date);
101
+ if (m.numberTo) {
102
+ return {
103
+ title: 'NACHERFASSUNG',
104
+ anlass,
105
+ handbeleg: ['Tagessammelbeleg', `Handbelege Nr. ${m.number} bis ${m.numberTo}`, `${m.count ? `${m.count} Belege ` : ''}vom ${tag}`],
106
+ ustHinweis: 'USt: Duplikat der Handbelege',
107
+ };
108
+ }
109
+ return {
110
+ title: 'NACHERFASSUNG',
111
+ anlass,
112
+ handbeleg: [`Handbeleg Nr. ${m.number}`, `vom ${tag}${m.time ? `, ${m.time} Uhr` : ''}`],
113
+ ustHinweis: 'USt: Duplikat des Handbelegs',
114
+ };
115
+ }
116
+ /** Signaturausfall (§ 17 Abs. 4 RKSV): der Vermerk ohne Zeilen; sonst `null`. */
117
+ export function signaturausfallVermerk(receipt) {
118
+ return receiptSignatureFailed(receipt) ? { kind: 'signature_outage', title: SIGNATUR_AUSGEFALLEN, lines: [] } : null;
119
+ }
120
+ // ------------------------------------------------------------------ Ausgabe
121
+ const OPTIONEN = new Set(['testCashregister', 'testSignature']);
122
+ const OPTIONEN_ALT = { testKasse: 'testCashregister', testSignatur: 'testSignature' };
123
+ /**
124
+ * Die Vermerke eines Belegs in fester Reihenfolge: Testkasse, Testsignatur,
125
+ * Training, Storno, Nacherfassung, Signaturausfall. Ein gewoehnlicher Beleg
126
+ * hat keine (`[]`).
127
+ *
128
+ * Ob Testkasse oder Testsignatur, weiss nur der Aufrufer (er kennt das Konto),
129
+ * wie bei [buildReceiptLayout]. Eine unbekannte Option wirft
130
+ * (`KasseneckValidationError`, `scope: 'request'`): eine alte deutsche
131
+ * (`testKasse`) darf nie still wegfallen, sonst saehe ein Testbeleg gueltig aus.
132
+ *
133
+ * Firmendaten kennt diese Ausgabe nicht; der USt-Hinweis der Nacherfassung
134
+ * („USt: Duplikat …“) gehoert darum nicht zum Vermerk (siehe [NacherfassungTeile]).
135
+ */
136
+ export function receiptNotes(receipt, options = {}) {
137
+ for (const name of Object.keys(options)) {
138
+ if (OPTIONEN.has(name))
139
+ continue;
140
+ const neu = OPTIONEN_ALT[name];
141
+ throw new KasseneckValidationError('receiptNotes', neu !== undefined ? `Option "${name}" heisst "${neu}"` : `Unbekannte Option "${name}"`, 'request');
142
+ }
143
+ const vermerke = [
144
+ options.testCashregister ? testkasseVermerk() : null,
145
+ options.testSignature ? testsignaturVermerk() : null,
146
+ trainingVermerk(receipt),
147
+ stornoVermerk(receipt),
148
+ (() => {
149
+ const teile = nacherfassungTeile(receipt);
150
+ return teile ? { kind: 'manual_receipt', title: teile.title, lines: [...teile.anlass, ...teile.handbeleg] } : null;
151
+ })(),
152
+ signaturausfallVermerk(receipt),
153
+ ];
154
+ return vermerke.filter((v) => v !== null);
155
+ }
@@ -233,6 +233,30 @@ export function _storedReceiptInner(doc, functionName) {
233
233
  export function pruefangabenDerHuelle(p) {
234
234
  return { karteRegistriertAm: alsIso(p.karteRegistriertAm), kasseRegistriertAm: alsIso(p.kasseRegistriertAm) };
235
235
  }
236
+ /**
237
+ * Steuerhinweis der Zahlung auf Rechnung: innen `steuerhinweis` (`inkl_ust` | `null_prozent` | `siehe_rechnung`),
238
+ * aussen `taxNote` (`incl_vat` | `zero_percent` | `see_invoice`). Der Vertrags-Export kennt die Umbenennung und den
239
+ * Wertekatalog inzwischen; diese Zeile bleibt trotzdem, weil sie bewusst deutsche UND englische Werte annimmt
240
+ * (Huellen kommen innen wie aussen vor). Ein anderer oder fehlender Wert ergibt keinen Hinweis; das alte Feld
241
+ * `includesVat` faellt weg.
242
+ */
243
+ const STEUERHINWEIS_AUSSEN = {
244
+ inkl_ust: 'incl_vat', null_prozent: 'zero_percent', siehe_rechnung: 'see_invoice',
245
+ incl_vat: 'incl_vat', zero_percent: 'zero_percent', see_invoice: 'see_invoice',
246
+ };
247
+ function rechnungszahlungNachAussen(beleg) {
248
+ if (!Array.isArray(beleg.invoicePayments))
249
+ return beleg;
250
+ const invoicePayments = beleg.invoicePayments.map((e) => {
251
+ if (!istObjekt(e))
252
+ return e;
253
+ const { steuerhinweis, taxNote, includesVat: _alt, ...rest } = e;
254
+ const roh = steuerhinweis ?? taxNote;
255
+ const aussen = typeof roh === 'string' && hat(STEUERHINWEIS_AUSSEN, roh) ? STEUERHINWEIS_AUSSEN[roh] : undefined;
256
+ return aussen === undefined ? rest : { ...rest, taxNote: aussen };
257
+ });
258
+ return { ...beleg, invoicePayments };
259
+ }
236
260
  /**
237
261
  * Eine Beleg-Huelle der inneren Form (`receipt`, Betriebsfelder, `kopfId`,
238
262
  * `pruefangaben`, `testKasse` ...) in die Drahtform von `getReceipt` unter
@@ -241,7 +265,7 @@ export function pruefangabenDerHuelle(p) {
241
265
  export function _receiptEnvelopeToWire(huelle) {
242
266
  const schema = SCHEMAS.getReceipt;
243
267
  const draht = werteNachAussen(schluesselNachAussen(huelle, schema.data), schema.werte);
244
- return istObjekt(draht.receipt) ? { ...draht, receipt: belegGutscheineNachAussen(belegRueckgabeNachAussen(draht.receipt)) } : draht;
268
+ return istObjekt(draht.receipt) ? { ...draht, receipt: rechnungszahlungNachAussen(belegGutscheineNachAussen(belegRueckgabeNachAussen(draht.receipt))) } : draht;
245
269
  }
246
270
  /**
247
271
  * Ein Belegdokument (`users/{uid}/cashregisters/{id}/receipts/{id}`) in der
@@ -1,5 +1,5 @@
1
1
  /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
2
- export declare const VOKABULAR_QUELLE = "78eb90dbffbd44f2b16d78963d35c6e977245f5f53bb171a19b73b15d5cb0a3c";
2
+ export declare const VOKABULAR_QUELLE = "7e41f406752cf109d3809bd187db0dfccceafbc3c9d88305edf32c98d57bced3";
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 = "78eb90dbffbd44f2b16d78963d35c6e977245f5f53bb171a19b73b15d5cb0a3c";
4
+ export const VOKABULAR_QUELLE = "7e41f406752cf109d3809bd187db0dfccceafbc3c9d88305edf32c98d57bced3";
5
5
  /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
6
6
  export const SCHEMAS = {
7
7
  "getReceipt": {
@@ -42,7 +42,18 @@ export const SCHEMAS = {
42
42
  "sharedReturnPoint": {
43
43
  "__": "pfandStelle",
44
44
  "address": "adresse"
45
- }
45
+ },
46
+ "invoicePayments": [
47
+ {
48
+ "__": "rechnungszahlung",
49
+ "invoiceNumber": "nummer",
50
+ "customerId": "kundeId",
51
+ "amountCents": "betragCents",
52
+ "partial": "teil",
53
+ "paidOn": "zahlungVom",
54
+ "taxNote": "steuerhinweis"
55
+ }
56
+ ]
46
57
  },
47
58
  "taxNumber": "taxnr",
48
59
  "vatId": "uid",
@@ -112,6 +123,9 @@ export const SCHEMAS = {
112
123
  "receipt.items[].depositKind": {
113
124
  "$catalog": "PFAND_ART"
114
125
  },
126
+ "receipt.invoicePayments[].taxNote": {
127
+ "$catalog": "RECHNUNGSZAHLUNG_STEUERHINWEIS"
128
+ },
115
129
  "issuedVouchers[].type": {
116
130
  "$catalog": "GUTSCHEIN_ART"
117
131
  },
@@ -853,6 +867,11 @@ export const KATALOGE = {
853
867
  "glas": "glass",
854
868
  "sonstiges": "other"
855
869
  },
870
+ "RECHNUNGSZAHLUNG_STEUERHINWEIS": {
871
+ "inkl_ust": "incl_vat",
872
+ "null_prozent": "zero_percent",
873
+ "siehe_rechnung": "see_invoice"
874
+ },
856
875
  "REFERENZ_STUFE": {
857
876
  "fragen": "optional",
858
877
  "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.37.0";
7
+ export declare const PACKAGE_VERSION = "1.38.0";
@@ -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.37.0';
7
+ export const PACKAGE_VERSION = '1.38.0';
@@ -0,0 +1,28 @@
1
+ Bäckerei Kornblum
2
+ Hauptplatz 1
3
+ 4830 Hallstatt
4
+ ATU12345675
5
+ +43 6134 12345
6
+
7
+ ================================
8
+ STORNOBELEG
9
+ ================================
10
+ Stornobuchung zu Beleg
11
+ AT0-KASSE1-117
12
+ vom 11.11.2026, 09:14 Uhr
13
+ Grund: Fehleingabe
14
+
15
+ Datum: 11.11.2026 11:02:05
16
+ Kassen-ID: KASSE1
17
+ Beleg-ID: AT0-KASSE1-119
18
+
19
+ Zahlung auf Rechnung -1569,60
20
+ 2026-0042
21
+ inkl. USt
22
+ --------------------------------
23
+ Gesamt: -1569,60 €
24
+ Zahlungsart: Barzahlung
25
+
26
+ [QR-Code]
27
+
28
+ Vielen Dank für Ihren Einkauf
@@ -0,0 +1,26 @@
1
+ Bäckerei Kornblum
2
+ Hauptplatz 1
3
+ 4830 Hallstatt
4
+ ATU12345675
5
+ +43 6134 12345
6
+
7
+ ================================================
8
+ STORNOBELEG
9
+ ================================================
10
+ Stornobuchung zu Beleg AT0-KASSE1-117
11
+ vom 11.11.2026, 09:14 Uhr
12
+ Grund: Fehleingabe
13
+
14
+ Datum: 11.11.2026 11:02:05
15
+ Kassen-ID: KASSE1
16
+ Beleg-ID: AT0-KASSE1-119
17
+
18
+ Zahlung auf Rechnung 2026-0042 -1569,60
19
+ inkl. USt
20
+ ------------------------------------------------
21
+ Gesamt: -1569,60 €
22
+ Zahlungsart: Barzahlung
23
+
24
+ [QR-Code]
25
+
26
+ Vielen Dank für Ihren Einkauf
@@ -0,0 +1,189 @@
1
+ {
2
+ "lines": [
3
+ {
4
+ "kind": "text",
5
+ "text": "Bäckerei Kornblum",
6
+ "align": "center",
7
+ "bold": true
8
+ },
9
+ {
10
+ "kind": "text",
11
+ "text": "Hauptplatz 1",
12
+ "align": "center",
13
+ "bold": false
14
+ },
15
+ {
16
+ "kind": "text",
17
+ "text": "4830 Hallstatt",
18
+ "align": "center",
19
+ "bold": false
20
+ },
21
+ {
22
+ "kind": "text",
23
+ "text": "ATU12345675",
24
+ "align": "center",
25
+ "bold": false
26
+ },
27
+ {
28
+ "kind": "text",
29
+ "text": "+43 6134 12345",
30
+ "align": "center",
31
+ "bold": false
32
+ },
33
+ {
34
+ "kind": "space",
35
+ "lines": 1
36
+ },
37
+ {
38
+ "kind": "banner",
39
+ "text": "STORNOBELEG",
40
+ "tone": "receipt_type"
41
+ },
42
+ {
43
+ "kind": "text",
44
+ "text": "Stornobuchung zu Beleg AT0-KASSE1-117",
45
+ "align": "center",
46
+ "bold": false
47
+ },
48
+ {
49
+ "kind": "text",
50
+ "text": "vom 11.11.2026, 09:14 Uhr",
51
+ "align": "center",
52
+ "bold": false
53
+ },
54
+ {
55
+ "kind": "text",
56
+ "text": "Grund: Fehleingabe",
57
+ "align": "center",
58
+ "bold": false
59
+ },
60
+ {
61
+ "kind": "space",
62
+ "lines": 1
63
+ },
64
+ {
65
+ "kind": "columns",
66
+ "columns": [
67
+ {
68
+ "text": "Datum:",
69
+ "width": 4,
70
+ "align": "left"
71
+ },
72
+ {
73
+ "text": "11.11.2026 11:02:05",
74
+ "width": 8,
75
+ "align": "right"
76
+ }
77
+ ]
78
+ },
79
+ {
80
+ "kind": "columns",
81
+ "columns": [
82
+ {
83
+ "text": "Kassen-ID:",
84
+ "width": 6,
85
+ "align": "left"
86
+ },
87
+ {
88
+ "text": "KASSE1",
89
+ "width": 6,
90
+ "align": "right"
91
+ }
92
+ ]
93
+ },
94
+ {
95
+ "kind": "columns",
96
+ "columns": [
97
+ {
98
+ "text": "Beleg-ID:",
99
+ "width": 6,
100
+ "align": "left"
101
+ },
102
+ {
103
+ "text": "AT0-KASSE1-119",
104
+ "width": 6,
105
+ "align": "right"
106
+ }
107
+ ]
108
+ },
109
+ {
110
+ "kind": "space",
111
+ "lines": 1
112
+ },
113
+ {
114
+ "kind": "columns",
115
+ "columns": [
116
+ {
117
+ "text": "Zahlung auf Rechnung 2026-0042",
118
+ "width": 8,
119
+ "align": "left"
120
+ },
121
+ {
122
+ "text": "-1569,60 ",
123
+ "width": 4,
124
+ "align": "right"
125
+ }
126
+ ]
127
+ },
128
+ {
129
+ "kind": "text",
130
+ "text": " inkl. USt",
131
+ "align": "left",
132
+ "bold": false
133
+ },
134
+ {
135
+ "kind": "rule",
136
+ "char": "-"
137
+ },
138
+ {
139
+ "kind": "columns",
140
+ "columns": [
141
+ {
142
+ "text": "Gesamt:",
143
+ "width": 6,
144
+ "align": "left"
145
+ },
146
+ {
147
+ "text": "-1569,60 €",
148
+ "width": 6,
149
+ "align": "right"
150
+ }
151
+ ]
152
+ },
153
+ {
154
+ "kind": "columns",
155
+ "columns": [
156
+ {
157
+ "text": "Zahlungsart:",
158
+ "width": 6,
159
+ "align": "left"
160
+ },
161
+ {
162
+ "text": "Barzahlung",
163
+ "width": 6,
164
+ "align": "right"
165
+ }
166
+ ]
167
+ },
168
+ {
169
+ "kind": "space",
170
+ "lines": 1
171
+ },
172
+ {
173
+ "kind": "qr",
174
+ "data": "_R1-AT1_KASSE1_AT0-KASSE1-119_2026-11-11T11:02:05_0,00_0,00_0,00_-1569,60_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR"
175
+ },
176
+ {
177
+ "kind": "space",
178
+ "lines": 1
179
+ },
180
+ {
181
+ "kind": "text",
182
+ "text": "Vielen Dank für Ihren Einkauf",
183
+ "align": "center",
184
+ "bold": false
185
+ }
186
+ ],
187
+ "paperSize": "mm80",
188
+ "ruleset": 2
189
+ }