@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.
- package/CHANGELOG.md +21 -0
- package/README.md +16 -0
- package/dist/cjs/index.d.ts +1 -1
- package/dist/cjs/index.js +6 -5
- package/dist/cjs/invoice/texte.d.ts +18 -1
- package/dist/cjs/invoice/texte.js +43 -2
- package/dist/cjs/invoice/vertrag.d.ts +1 -1
- package/dist/cjs/invoice/vertrag.js +1 -0
- package/dist/cjs/models/cancellation.d.ts +1 -1
- package/dist/cjs/models/cancellation.js +2 -0
- package/dist/cjs/models/index.d.ts +2 -1
- package/dist/cjs/models/index.js +6 -3
- package/dist/cjs/models/invoice-payment-ref.d.ts +42 -0
- package/dist/cjs/models/invoice-payment-ref.js +38 -0
- package/dist/cjs/models/receipt-item.d.ts +10 -2
- package/dist/cjs/models/receipt-item.js +14 -1
- package/dist/cjs/models/receipt.d.ts +7 -0
- package/dist/cjs/models/receipt.js +6 -0
- package/dist/cjs/pos/schicht-lesen.js +5 -0
- package/dist/cjs/pos/schicht-typen.d.ts +11 -0
- package/dist/cjs/pos/texte.d.ts +13 -2
- package/dist/cjs/pos/texte.js +18 -3
- package/dist/cjs/receipt/index.d.ts +1 -0
- package/dist/cjs/receipt/index.js +4 -2
- package/dist/cjs/receipt/layout.d.ts +2 -2
- package/dist/cjs/receipt/layout.js +106 -117
- package/dist/cjs/receipt/shift-sheet.js +6 -1
- package/dist/cjs/receipt/vermerke.d.ts +80 -0
- package/dist/cjs/receipt/vermerke.js +167 -0
- package/dist/cjs/stored/draht.js +25 -1
- package/dist/cjs/stored/vokabular.d.ts +1 -1
- package/dist/cjs/stored/vokabular.js +21 -2
- package/dist/cjs/version.d.ts +1 -1
- package/dist/cjs/version.js +1 -1
- package/dist/esm/index.d.ts +1 -1
- package/dist/esm/index.js +1 -1
- package/dist/esm/invoice/texte.d.ts +18 -1
- package/dist/esm/invoice/texte.js +43 -2
- package/dist/esm/invoice/vertrag.d.ts +1 -1
- package/dist/esm/invoice/vertrag.js +1 -0
- package/dist/esm/models/cancellation.d.ts +1 -1
- package/dist/esm/models/cancellation.js +2 -0
- package/dist/esm/models/index.d.ts +2 -1
- package/dist/esm/models/index.js +2 -1
- package/dist/esm/models/invoice-payment-ref.d.ts +42 -0
- package/dist/esm/models/invoice-payment-ref.js +35 -0
- package/dist/esm/models/receipt-item.d.ts +10 -2
- package/dist/esm/models/receipt-item.js +13 -1
- package/dist/esm/models/receipt.d.ts +7 -0
- package/dist/esm/models/receipt.js +6 -0
- package/dist/esm/pos/schicht-lesen.js +5 -0
- package/dist/esm/pos/schicht-typen.d.ts +11 -0
- package/dist/esm/pos/texte.d.ts +13 -2
- package/dist/esm/pos/texte.js +18 -3
- package/dist/esm/receipt/index.d.ts +1 -0
- package/dist/esm/receipt/index.js +1 -0
- package/dist/esm/receipt/layout.d.ts +2 -2
- package/dist/esm/receipt/layout.js +103 -113
- package/dist/esm/receipt/shift-sheet.js +6 -1
- package/dist/esm/receipt/vermerke.d.ts +80 -0
- package/dist/esm/receipt/vermerke.js +155 -0
- package/dist/esm/stored/draht.js +25 -1
- package/dist/esm/stored/vokabular.d.ts +1 -1
- package/dist/esm/stored/vokabular.js +21 -2
- package/dist/esm/version.d.ts +1 -1
- package/dist/esm/version.js +1 -1
- package/fixtures/expected/invoice-payment-cancellation.grid32.txt +28 -0
- package/fixtures/expected/invoice-payment-cancellation.grid48.txt +26 -0
- package/fixtures/expected/invoice-payment-cancellation.lines.json +189 -0
- package/fixtures/expected/invoice-payment-cancellation.sheet32.json +194 -0
- package/fixtures/expected/invoice-payment-cancellation.sheet48.json +182 -0
- package/fixtures/expected/invoice-payment-manual-receipt.grid32.txt +30 -0
- package/fixtures/expected/invoice-payment-manual-receipt.grid48.txt +29 -0
- package/fixtures/expected/invoice-payment-manual-receipt.lines.json +199 -0
- package/fixtures/expected/invoice-payment-manual-receipt.sheet32.json +206 -0
- package/fixtures/expected/invoice-payment-manual-receipt.sheet48.json +200 -0
- package/fixtures/expected/invoice-payment-normal.grid32.txt +22 -0
- package/fixtures/expected/invoice-payment-normal.grid48.txt +21 -0
- package/fixtures/expected/invoice-payment-normal.lines.json +192 -0
- package/fixtures/expected/invoice-payment-normal.sheet32.json +158 -0
- package/fixtures/expected/invoice-payment-normal.sheet48.json +152 -0
- package/fixtures/expected/invoice-payment-outage.grid32.txt +23 -0
- package/fixtures/expected/invoice-payment-outage.grid48.txt +21 -0
- package/fixtures/expected/invoice-payment-outage.lines.json +172 -0
- package/fixtures/expected/invoice-payment-outage.sheet32.json +164 -0
- package/fixtures/expected/invoice-payment-outage.sheet48.json +152 -0
- package/fixtures/expected/invoice-payment-partial.grid32.txt +20 -0
- package/fixtures/expected/invoice-payment-partial.grid48.txt +20 -0
- package/fixtures/expected/invoice-payment-partial.lines.json +162 -0
- package/fixtures/expected/invoice-payment-partial.sheet32.json +146 -0
- package/fixtures/expected/invoice-payment-partial.sheet48.json +146 -0
- package/fixtures/expected/invoice-payment-refund.grid32.txt +20 -0
- package/fixtures/expected/invoice-payment-refund.grid48.txt +20 -0
- package/fixtures/expected/invoice-payment-refund.lines.json +162 -0
- package/fixtures/expected/invoice-payment-refund.sheet32.json +146 -0
- package/fixtures/expected/invoice-payment-refund.sheet48.json +146 -0
- package/fixtures/expected/invoice-payment-see-invoice.grid32.txt +22 -0
- package/fixtures/expected/invoice-payment-see-invoice.grid48.txt +21 -0
- package/fixtures/expected/invoice-payment-see-invoice.lines.json +192 -0
- package/fixtures/expected/invoice-payment-see-invoice.sheet32.json +158 -0
- package/fixtures/expected/invoice-payment-see-invoice.sheet48.json +152 -0
- package/fixtures/expected/invoice-payment-training.grid32.txt +30 -0
- package/fixtures/expected/invoice-payment-training.grid48.txt +27 -0
- package/fixtures/expected/invoice-payment-training.lines.json +183 -0
- package/fixtures/expected/invoice-payment-training.sheet32.json +206 -0
- package/fixtures/expected/invoice-payment-training.sheet48.json +188 -0
- package/fixtures/expected/invoice-payment-without-vat.grid32.txt +20 -0
- package/fixtures/expected/invoice-payment-without-vat.grid48.txt +19 -0
- package/fixtures/expected/invoice-payment-without-vat.lines.json +162 -0
- package/fixtures/expected/invoice-payment-without-vat.sheet32.json +146 -0
- package/fixtures/expected/invoice-payment-without-vat.sheet48.json +140 -0
- package/fixtures/expected/invoice-payment-zero-percent.grid32.txt +22 -0
- package/fixtures/expected/invoice-payment-zero-percent.grid48.txt +21 -0
- package/fixtures/expected/invoice-payment-zero-percent.lines.json +192 -0
- package/fixtures/expected/invoice-payment-zero-percent.sheet32.json +158 -0
- package/fixtures/expected/invoice-payment-zero-percent.sheet48.json +152 -0
- package/fixtures/hobex-hps-codes.json +1 -1
- package/fixtures/invoice-api.schema.json +3 -2
- package/fixtures/invoice-texts.json +37 -3
- package/fixtures/manifest.json +80 -0
- package/fixtures/pos-message-cases.json +3 -0
- package/fixtures/pos-texts.json +14 -1
- package/fixtures/receipt-due-generated.json +3 -3
- package/fixtures/receipt-due-voucher-generated.json +5 -5
- package/fixtures/receipts/invoice-payment-cancellation.json +70 -0
- package/fixtures/receipts/invoice-payment-manual-receipt.json +69 -0
- package/fixtures/receipts/invoice-payment-normal.json +65 -0
- package/fixtures/receipts/invoice-payment-outage.json +63 -0
- package/fixtures/receipts/invoice-payment-partial.json +63 -0
- package/fixtures/receipts/invoice-payment-refund.json +63 -0
- package/fixtures/receipts/invoice-payment-see-invoice.json +65 -0
- package/fixtures/receipts/invoice-payment-training.json +63 -0
- package/fixtures/receipts/invoice-payment-without-vat.json +63 -0
- package/fixtures/receipts/invoice-payment-zero-percent.json +65 -0
- package/fixtures/surface.json +3 -2
- 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 +10 -127
- 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 +3 -3
- package/fixtures/v3/stored/rechnungen.json +2 -2
- package/fixtures/v3/v3-vokabular.json +172 -18
- package/fixtures/v3/zahlbetrag-faelle.json +2 -2
- 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
|
+
}
|
package/dist/esm/stored/draht.js
CHANGED
|
@@ -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 = "
|
|
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 = "
|
|
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"
|
package/dist/esm/version.d.ts
CHANGED
package/dist/esm/version.js
CHANGED
|
@@ -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
|
+
}
|