@kreiseck/kasseneck-api 1.37.0 → 1.39.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 +39 -1
- package/README.md +19 -1
- package/dist/cjs/client/aufrufe.d.ts +2 -2
- package/dist/cjs/client/aufrufe.js +12 -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/payments/hobex-hps/connect-client.d.ts +17 -0
- package/dist/cjs/payments/hobex-hps/connect-client.js +17 -0
- package/dist/cjs/payments/hobex-hps/index.d.ts +1 -1
- package/dist/cjs/payments/index.d.ts +1 -1
- package/dist/cjs/pos/client.js +2 -1
- package/dist/cjs/pos/index.d.ts +1 -1
- package/dist/cjs/pos/index.js +7 -5
- package/dist/cjs/pos/schicht-lesen.js +5 -0
- package/dist/cjs/pos/schicht-typen.d.ts +11 -0
- package/dist/cjs/pos/settings.d.ts +14 -1
- package/dist/cjs/pos/settings.js +16 -2
- package/dist/cjs/pos/texte.d.ts +400 -2
- package/dist/cjs/pos/texte.js +152 -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/register/errors.d.ts +1 -1
- package/dist/cjs/register/errors.js +4 -0
- package/dist/cjs/register/index.d.ts +1 -1
- package/dist/cjs/register/index.js +3 -1
- package/dist/cjs/register/pairing.d.ts +51 -0
- package/dist/cjs/register/pairing.js +59 -0
- package/dist/cjs/stored/draht.js +25 -1
- package/dist/cjs/stored/einstellungen.js +5 -2
- package/dist/cjs/stored/vokabular.d.ts +1 -1
- package/dist/cjs/stored/vokabular.js +22 -2
- package/dist/cjs/version.d.ts +1 -1
- package/dist/cjs/version.js +1 -1
- package/dist/esm/client/aufrufe.d.ts +2 -2
- package/dist/esm/client/aufrufe.js +12 -0
- 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/payments/hobex-hps/connect-client.d.ts +17 -0
- package/dist/esm/payments/hobex-hps/connect-client.js +17 -0
- package/dist/esm/payments/hobex-hps/index.d.ts +1 -1
- package/dist/esm/payments/index.d.ts +1 -1
- package/dist/esm/pos/client.js +3 -2
- package/dist/esm/pos/index.d.ts +1 -1
- package/dist/esm/pos/index.js +1 -1
- package/dist/esm/pos/schicht-lesen.js +5 -0
- package/dist/esm/pos/schicht-typen.d.ts +11 -0
- package/dist/esm/pos/settings.d.ts +14 -1
- package/dist/esm/pos/settings.js +14 -1
- package/dist/esm/pos/texte.d.ts +400 -2
- package/dist/esm/pos/texte.js +152 -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/register/errors.d.ts +1 -1
- package/dist/esm/register/errors.js +4 -0
- package/dist/esm/register/index.d.ts +1 -1
- package/dist/esm/register/index.js +1 -1
- package/dist/esm/register/pairing.d.ts +51 -0
- package/dist/esm/register/pairing.js +57 -0
- package/dist/esm/stored/draht.js +25 -1
- package/dist/esm/stored/einstellungen.js +6 -3
- package/dist/esm/stored/vokabular.d.ts +1 -1
- package/dist/esm/stored/vokabular.js +22 -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 +458 -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 +16 -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 +702 -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 +210 -4
- package/fixtures/v3/stored/rechnungen.json +2 -2
- package/fixtures/v3/v3-vokabular.json +237 -20
- 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
|
+
}
|
|
@@ -22,7 +22,7 @@ import { KasseneckApiError } from '../client/errors.js';
|
|
|
22
22
|
* ueber `KasseneckApiError.code` lesbar; die Kasse braucht dafuer einen
|
|
23
23
|
* Rueckfallzweig.
|
|
24
24
|
*/
|
|
25
|
-
export declare const REGISTER_ERROR_CODES: readonly ["account_not_found", "action_confirmation_required", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_in_use", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "device_bound_elsewhere", "device_not_found", "device_not_paired", "device_takeover_required", "dialect_mismatch", "internal_translation_error", "licenses_exhausted", "live_not_enabled", "location_outside", "location_required", "login_failed", "login_mode_select_user", "login_unavailable", "method_not_allowed", "mfa_required", "not_found", "pairing_code_expired", "pairing_code_unknown", "pairing_code_used", "pairing_failed", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "register_user_only", "response_translation_failed", "second_factor_required", "session_ended", "session_expired", "session_not_running", "session_other_cashregister", "too_many_attempts", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
|
|
25
|
+
export declare const REGISTER_ERROR_CODES: readonly ["account_not_found", "action_confirmation_required", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "cashregister_in_use", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "device_bound_elsewhere", "device_not_found", "device_not_paired", "device_takeover_required", "dialect_mismatch", "internal_translation_error", "invalid_terminal_address", "licenses_exhausted", "live_not_enabled", "location_outside", "location_required", "login_failed", "login_mode_select_user", "login_unavailable", "method_not_allowed", "mfa_required", "not_found", "pairing_code_expired", "pairing_code_unknown", "pairing_code_used", "pairing_failed", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "register_user_only", "response_translation_failed", "second_factor_required", "server_error", "session_ended", "session_expired", "session_not_running", "session_other_cashregister", "terminal_id_mismatch", "too_many_attempts", "too_many_changes", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
|
|
26
26
|
export type RegisterErrorCode = typeof REGISTER_ERROR_CODES[number];
|
|
27
27
|
export declare function isRegisterErrorCode(value: unknown): value is RegisterErrorCode;
|
|
28
28
|
/** Der Code eines geworfenen Fehlers, wenn es einer der Kassen-Anmeldung ist; sonst `undefined`. */
|
|
@@ -41,6 +41,7 @@ export const REGISTER_ERROR_CODES = Object.freeze([
|
|
|
41
41
|
'device_takeover_required',
|
|
42
42
|
'dialect_mismatch',
|
|
43
43
|
'internal_translation_error',
|
|
44
|
+
'invalid_terminal_address',
|
|
44
45
|
'licenses_exhausted',
|
|
45
46
|
'live_not_enabled',
|
|
46
47
|
'location_outside',
|
|
@@ -62,11 +63,14 @@ export const REGISTER_ERROR_CODES = Object.freeze([
|
|
|
62
63
|
'register_user_only',
|
|
63
64
|
'response_translation_failed',
|
|
64
65
|
'second_factor_required',
|
|
66
|
+
'server_error',
|
|
65
67
|
'session_ended',
|
|
66
68
|
'session_expired',
|
|
67
69
|
'session_not_running',
|
|
68
70
|
'session_other_cashregister',
|
|
71
|
+
'terminal_id_mismatch',
|
|
69
72
|
'too_many_attempts',
|
|
73
|
+
'too_many_changes',
|
|
70
74
|
'unauthorized',
|
|
71
75
|
'user_disabled',
|
|
72
76
|
'user_verification_failed',
|
|
@@ -59,6 +59,6 @@
|
|
|
59
59
|
* daraus entstehende ID-Token und `sitzung.sessionId` ergeben zusammen
|
|
60
60
|
* `registerUserAuth` — ab da laeuft alles Weitere ueber den ueblichen Weg.
|
|
61
61
|
*/
|
|
62
|
-
export { type RegisterDeviceConnection, type RegisterDeviceCredentials, type PairRegisterDeviceOptions, type PairedRegisterDevice, type RegisterUserKind, type RegisterUserSummary, type RegisterUserPerms, REGISTER_PERMS, type RegisterScope, type RegisterUser, type RegisterUserSession, type ListRegisterUsersForDeviceOptions, type RegisterUserLoginOptions, type RegisterPinLoginOptions, type RegisterPinPolicy, type RegisterLoginMode, type RegisterDeviceUsers, type RegisterClientInfo, type RegisterGeo, type RegisterDeviceInfo, type RegisterSession, type RegisterSessionOverview, type ListRegisterSessionsForDeviceOptions, pairRegisterDevice, listRegisterUsersForDevice, listRegisterSessionsForDevice, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
|
|
62
|
+
export { type RegisterDeviceConnection, type RegisterDeviceCredentials, type PairRegisterDeviceOptions, type PairedRegisterDevice, type RegisterUserKind, type RegisterUserSummary, type RegisterUserPerms, REGISTER_PERMS, type RegisterScope, type RegisterUser, type RegisterUserSession, type ListRegisterUsersForDeviceOptions, type RegisterUserLoginOptions, type RegisterPinLoginOptions, type RegisterPinPolicy, type RegisterLoginMode, type RegisterDeviceUsers, type RegisterClientInfo, type RegisterGeo, type RegisterDeviceInfo, type RegisterSession, type RegisterSessionOverview, type ListRegisterSessionsForDeviceOptions, type ReportMyTerminalAddressOptions, type ReportedTerminalAddress, type ReportMyRegisterClientOptions, type ReportedRegisterClient, pairRegisterDevice, listRegisterUsersForDevice, listRegisterSessionsForDevice, reportMyTerminalAddress, reportMyRegisterClient, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
|
|
63
63
|
export { renewRegisterSession, endRegisterSession } from './session.js';
|
|
64
64
|
export { REGISTER_ERROR_CODES, type RegisterErrorCode, isRegisterErrorCode, registerErrorCode, registerFieldErrors, type RegisterFieldError, isRegisterError, type RegisterErrorDetails, registerErrorDetails, } from './errors.js';
|
|
@@ -59,6 +59,6 @@
|
|
|
59
59
|
* daraus entstehende ID-Token und `sitzung.sessionId` ergeben zusammen
|
|
60
60
|
* `registerUserAuth` — ab da laeuft alles Weitere ueber den ueblichen Weg.
|
|
61
61
|
*/
|
|
62
|
-
export { REGISTER_PERMS, pairRegisterDevice, listRegisterUsersForDevice, listRegisterSessionsForDevice, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
|
|
62
|
+
export { REGISTER_PERMS, pairRegisterDevice, listRegisterUsersForDevice, listRegisterSessionsForDevice, reportMyTerminalAddress, reportMyRegisterClient, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
|
|
63
63
|
export { renewRegisterSession, endRegisterSession } from './session.js';
|
|
64
64
|
export { REGISTER_ERROR_CODES, isRegisterErrorCode, registerErrorCode, registerFieldErrors, isRegisterError, registerErrorDetails, } from './errors.js';
|
|
@@ -354,6 +354,57 @@ export declare function pairRegisterDevice(options: PairRegisterDeviceOptions):
|
|
|
354
354
|
* Geraet meldet Erfolg. Danach das Geraet lokal vergessen.
|
|
355
355
|
*/
|
|
356
356
|
export declare function unpairRegisterDevice(options: ListRegisterUsersForDeviceOptions): Promise<void>;
|
|
357
|
+
/** Eingabe von [reportMyTerminalAddress]: Ausweis des Geraets plus die Adresse, unter der das Terminal geantwortet hat. */
|
|
358
|
+
export interface ReportMyTerminalAddressOptions extends RegisterDeviceConnection, RegisterDeviceCredentials {
|
|
359
|
+
/** Terminal-ID (TID) der Kasse; der Server schreibt nur, wenn sie zur Einrichtung dieses Geraets passt. */
|
|
360
|
+
tid: string;
|
|
361
|
+
/** IPv4-Adresse, unter der das Terminal antwortet. */
|
|
362
|
+
host: string;
|
|
363
|
+
/** Port, 1 bis 65535. */
|
|
364
|
+
port: number;
|
|
365
|
+
}
|
|
366
|
+
/** Antwort von [reportMyTerminalAddress]: ob der Server die Adresse geaendert hat (`false` = war schon so). */
|
|
367
|
+
export interface ReportedTerminalAddress {
|
|
368
|
+
changed: boolean;
|
|
369
|
+
}
|
|
370
|
+
/**
|
|
371
|
+
* Meldet still, dass das Kartenterminal der Kasse unter einer neuen Adresse
|
|
372
|
+
* antwortet (nur Kassenweg `/api/v3`, Ausweis des Geraets wie bei
|
|
373
|
+
* [listRegisterUsersForDevice]; keine Sitzung einer Person noetig).
|
|
374
|
+
*
|
|
375
|
+
* Der Server schreibt genau zwei Felder (IP und Port des Terminals) und nur,
|
|
376
|
+
* wenn die TID zur Einrichtung dieses Geraets passt; jede Aenderung steht im
|
|
377
|
+
* Kassen-Protokoll. Antwort `{ changed }`. Wiederholen ist gefahrlos: dieselbe
|
|
378
|
+
* Adresse noch einmal meldet `changed: false`. Die Kasse zeigt dazu nichts an.
|
|
379
|
+
*
|
|
380
|
+
* Fehlercodes: `terminal_id_mismatch`, `invalid_terminal_address`,
|
|
381
|
+
* `too_many_changes` (heute zu oft geaendert), dazu `device_not_paired`.
|
|
382
|
+
* Geprueft wird hier nur die Form; die Adresse beurteilt der Server.
|
|
383
|
+
*/
|
|
384
|
+
export declare function reportMyTerminalAddress(options: ReportMyTerminalAddressOptions): Promise<ReportedTerminalAddress>;
|
|
385
|
+
/** Eingabe von [reportMyRegisterClient]: Ausweis des Geraets plus die Bau-Kennung der laufenden Kasse. */
|
|
386
|
+
export interface ReportMyRegisterClientOptions extends RegisterDeviceConnection, RegisterDeviceCredentials {
|
|
387
|
+
/** Bau-Kennung der Kasse, z. B. `1.39.0/2026-11-13T18:20Z` (Browser) oder `kasse-app/1.0.3+34` (App). */
|
|
388
|
+
app: string;
|
|
389
|
+
}
|
|
390
|
+
/** Antwort von [reportMyRegisterClient]: ob der Server die Kennung geschrieben hat (`false` = unveraendert und jung genug). */
|
|
391
|
+
export interface ReportedRegisterClient {
|
|
392
|
+
written: boolean;
|
|
393
|
+
}
|
|
394
|
+
/**
|
|
395
|
+
* Meldet still, welche Fassung der Kasse auf diesem Geraet laeuft (nur
|
|
396
|
+
* Kassenweg `/api/v3`, Ausweis des Geraets wie bei [listRegisterUsersForDevice];
|
|
397
|
+
* keine Sitzung einer Person noetig). Gedacht fuer den Start, nach der
|
|
398
|
+
* Anmeldung und einen Takt von etwa 15 Minuten.
|
|
399
|
+
*
|
|
400
|
+
* Der Server schreibt die kuerzbare Kennung nur, wenn sie sich geaendert hat
|
|
401
|
+
* oder die letzte Meldung mindestens 10 Minuten alt ist; sonst `written: false`.
|
|
402
|
+
* Wiederholen ist gefahrlos. Die Kasse zeigt dazu nichts an.
|
|
403
|
+
*
|
|
404
|
+
* Fehlercodes: `device_not_paired` (falsches Geheimnis, unbekanntes oder
|
|
405
|
+
* gesperrtes Geraet), `server_error`. Geprueft wird hier nur die Form.
|
|
406
|
+
*/
|
|
407
|
+
export declare function reportMyRegisterClient(options: ReportMyRegisterClientOptions): Promise<ReportedRegisterClient>;
|
|
357
408
|
/** Eine laufende Sitzung an einer Kasse -- Zeile in der Auswahl. */
|
|
358
409
|
export interface RegisterSession {
|
|
359
410
|
id: string;
|
|
@@ -148,6 +148,63 @@ export async function unpairRegisterDevice(options) {
|
|
|
148
148
|
pflicht(name, 'deviceSecret', deviceSecret);
|
|
149
149
|
await transportFuer(verbindung)(name, { ownerUid, deviceId, deviceSecret }, undefined, [deviceSecret]);
|
|
150
150
|
}
|
|
151
|
+
/**
|
|
152
|
+
* Meldet still, dass das Kartenterminal der Kasse unter einer neuen Adresse
|
|
153
|
+
* antwortet (nur Kassenweg `/api/v3`, Ausweis des Geraets wie bei
|
|
154
|
+
* [listRegisterUsersForDevice]; keine Sitzung einer Person noetig).
|
|
155
|
+
*
|
|
156
|
+
* Der Server schreibt genau zwei Felder (IP und Port des Terminals) und nur,
|
|
157
|
+
* wenn die TID zur Einrichtung dieses Geraets passt; jede Aenderung steht im
|
|
158
|
+
* Kassen-Protokoll. Antwort `{ changed }`. Wiederholen ist gefahrlos: dieselbe
|
|
159
|
+
* Adresse noch einmal meldet `changed: false`. Die Kasse zeigt dazu nichts an.
|
|
160
|
+
*
|
|
161
|
+
* Fehlercodes: `terminal_id_mismatch`, `invalid_terminal_address`,
|
|
162
|
+
* `too_many_changes` (heute zu oft geaendert), dazu `device_not_paired`.
|
|
163
|
+
* Geprueft wird hier nur die Form; die Adresse beurteilt der Server.
|
|
164
|
+
*/
|
|
165
|
+
export async function reportMyTerminalAddress(options) {
|
|
166
|
+
const { ownerUid, deviceId, deviceSecret, tid, host, port, ...verbindung } = options;
|
|
167
|
+
const name = 'reportMyTerminalAddress';
|
|
168
|
+
pflicht(name, 'ownerUid', ownerUid);
|
|
169
|
+
pflicht(name, 'deviceId', deviceId);
|
|
170
|
+
pflicht(name, 'deviceSecret', deviceSecret);
|
|
171
|
+
pflicht(name, 'tid', tid);
|
|
172
|
+
pflicht(name, 'host', host);
|
|
173
|
+
if (typeof port !== 'number' || !Number.isInteger(port) || port < 1 || port > 65535) {
|
|
174
|
+
throw new KasseneckValidationError(name, 'port muss eine ganze Zahl von 1 bis 65535 sein', 'request');
|
|
175
|
+
}
|
|
176
|
+
const daten = await transportFuer(verbindung)(name, { ownerUid, deviceId, deviceSecret, tid, host, port }, undefined, [deviceSecret]);
|
|
177
|
+
if (typeof daten?.changed !== 'boolean') {
|
|
178
|
+
throw antwortfehler(name, 'Antwort enthaelt kein changed');
|
|
179
|
+
}
|
|
180
|
+
return { changed: daten.changed };
|
|
181
|
+
}
|
|
182
|
+
/**
|
|
183
|
+
* Meldet still, welche Fassung der Kasse auf diesem Geraet laeuft (nur
|
|
184
|
+
* Kassenweg `/api/v3`, Ausweis des Geraets wie bei [listRegisterUsersForDevice];
|
|
185
|
+
* keine Sitzung einer Person noetig). Gedacht fuer den Start, nach der
|
|
186
|
+
* Anmeldung und einen Takt von etwa 15 Minuten.
|
|
187
|
+
*
|
|
188
|
+
* Der Server schreibt die kuerzbare Kennung nur, wenn sie sich geaendert hat
|
|
189
|
+
* oder die letzte Meldung mindestens 10 Minuten alt ist; sonst `written: false`.
|
|
190
|
+
* Wiederholen ist gefahrlos. Die Kasse zeigt dazu nichts an.
|
|
191
|
+
*
|
|
192
|
+
* Fehlercodes: `device_not_paired` (falsches Geheimnis, unbekanntes oder
|
|
193
|
+
* gesperrtes Geraet), `server_error`. Geprueft wird hier nur die Form.
|
|
194
|
+
*/
|
|
195
|
+
export async function reportMyRegisterClient(options) {
|
|
196
|
+
const { ownerUid, deviceId, deviceSecret, app, ...verbindung } = options;
|
|
197
|
+
const name = 'reportMyRegisterClient';
|
|
198
|
+
pflicht(name, 'ownerUid', ownerUid);
|
|
199
|
+
pflicht(name, 'deviceId', deviceId);
|
|
200
|
+
pflicht(name, 'deviceSecret', deviceSecret);
|
|
201
|
+
pflicht(name, 'app', app);
|
|
202
|
+
const daten = await transportFuer(verbindung)(name, { ownerUid, deviceId, deviceSecret, app }, undefined, [deviceSecret]);
|
|
203
|
+
if (typeof daten?.written !== 'boolean') {
|
|
204
|
+
throw antwortfehler(name, 'Antwort enthaelt kein written');
|
|
205
|
+
}
|
|
206
|
+
return { written: daten.written };
|
|
207
|
+
}
|
|
151
208
|
/**
|
|
152
209
|
* Welche Sitzungen haelt diese Kasse gerade?
|
|
153
210
|
*
|
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,4 +1,4 @@
|
|
|
1
|
-
import { POS_BUSINESS_DEFAULTS, POS_BUSINESS_VALUES, POS_DEVICE_DEFAULTS, POS_DEVICE_OPTIONAL_FIELDS, POS_DEVICE_VALUES, POS_SHORTCUT_DEFAULTS, POS_SHORTCUT_SHARED_PAIRS, POS_BUSINESS_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_CHOICES, POS_BUSINESS_OPTIONAL_LISTS, POS_DEVICE_OPTIONAL_CHOICES, _optionalerWert, } from '../pos/settings.js';
|
|
1
|
+
import { POS_BUSINESS_DEFAULTS, POS_BUSINESS_VALUES, POS_DEVICE_DEFAULTS, POS_DEVICE_OPTIONAL_FIELDS, POS_DEVICE_OPTIONAL_SWITCHES, POS_DEVICE_VALUES, POS_SHORTCUT_DEFAULTS, POS_SHORTCUT_SHARED_PAIRS, POS_BUSINESS_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_CHOICES, POS_BUSINESS_OPTIONAL_LISTS, POS_DEVICE_OPTIONAL_CHOICES, _optionalerWert, } from '../pos/settings.js';
|
|
2
2
|
import { hat, innereNamen, istObjekt, regel } from './draht.js';
|
|
3
3
|
import { katalogVon } from './draht.js';
|
|
4
4
|
import { checkDiscountPresets, discountChipsFromPresets } from '../pos/rabatt-vorlagen.js';
|
|
@@ -49,7 +49,10 @@ const PRUEFER = {
|
|
|
49
49
|
* gueltiger Text gespeichert sind; sonst fehlen sie still, ohne Eintrag in
|
|
50
50
|
* `weggelassen` (der Server meldet sie dann auch nicht).
|
|
51
51
|
*/
|
|
52
|
-
const GERAET_OPTIONAL = Object.fromEntries(
|
|
52
|
+
const GERAET_OPTIONAL = Object.fromEntries([
|
|
53
|
+
...POS_DEVICE_OPTIONAL_FIELDS.map((feld) => [feld, (v) => _optionalerWert(v, false)]),
|
|
54
|
+
...POS_DEVICE_OPTIONAL_SWITCHES.map((feld) => [feld, (v) => typeof v === 'boolean']),
|
|
55
|
+
]);
|
|
53
56
|
/**
|
|
54
57
|
* Optionale Betriebs-Schalter (Zwilling von `BETRIEB_OPTIONAL` und
|
|
55
58
|
* `mischeBetrieb`): sie gehen nur hinaus, wenn sie als Wahrheitswert
|
|
@@ -290,6 +293,6 @@ export const _PRUEFER_FELDER = Object.freeze({
|
|
|
290
293
|
device: [...new Set([...Object.keys(PRUEFER.device), ...Object.keys(POS_DEVICE_VALUES), ...Object.keys(GERAET_OPTIONAL), 'shortcuts'])],
|
|
291
294
|
standard: {
|
|
292
295
|
business: [...Object.keys(POS_BUSINESS_DEFAULTS), ...POS_BUSINESS_OPTIONAL_FIELDS, ...POS_BUSINESS_OPTIONAL_CHOICES, ...POS_BUSINESS_OPTIONAL_LISTS],
|
|
293
|
-
device: [...Object.keys(POS_DEVICE_DEFAULTS), ...POS_DEVICE_OPTIONAL_FIELDS, ...POS_DEVICE_OPTIONAL_CHOICES],
|
|
296
|
+
device: [...Object.keys(POS_DEVICE_DEFAULTS), ...POS_DEVICE_OPTIONAL_FIELDS, ...POS_DEVICE_OPTIONAL_SWITCHES, ...POS_DEVICE_OPTIONAL_CHOICES],
|
|
294
297
|
},
|
|
295
298
|
});
|
|
@@ -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 = "ab188a33a1f0d07b187347e0293b935e41435fa61dc1078cd164b10cc2be5f46";
|
|
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 = "ab188a33a1f0d07b187347e0293b935e41435fa61dc1078cd164b10cc2be5f46";
|
|
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
|
},
|
|
@@ -247,6 +261,7 @@ export const SCHEMAS = {
|
|
|
247
261
|
"terminalVia": "terminalVia",
|
|
248
262
|
"terminalType": "terminalArt",
|
|
249
263
|
"shortcutHints": "tastenMarken",
|
|
264
|
+
"printerHint": "druckerHinweis",
|
|
250
265
|
"cartWidth": "korbBreite"
|
|
251
266
|
},
|
|
252
267
|
"vouchers": {
|
|
@@ -853,6 +868,11 @@ export const KATALOGE = {
|
|
|
853
868
|
"glas": "glass",
|
|
854
869
|
"sonstiges": "other"
|
|
855
870
|
},
|
|
871
|
+
"RECHNUNGSZAHLUNG_STEUERHINWEIS": {
|
|
872
|
+
"inkl_ust": "incl_vat",
|
|
873
|
+
"null_prozent": "zero_percent",
|
|
874
|
+
"siehe_rechnung": "see_invoice"
|
|
875
|
+
},
|
|
856
876
|
"REFERENZ_STUFE": {
|
|
857
877
|
"fragen": "optional",
|
|
858
878
|
"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
|