@kreiseck/kasseneck-api 1.29.0 → 1.30.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 +16 -0
- package/README.md +27 -0
- package/dist/cjs/client/list-receipts.d.ts +5 -0
- package/dist/cjs/client/list-receipts.js +5 -1
- package/dist/cjs/client/receipts.d.ts +6 -0
- package/dist/cjs/client/receipts.js +1 -0
- package/dist/cjs/enums/voucher-type.d.ts +5 -1
- package/dist/cjs/enums/voucher-type.js +5 -1
- package/dist/cjs/index.d.ts +1 -1
- package/dist/cjs/index.js +13 -5
- package/dist/cjs/inventory/index.d.ts +2 -2
- package/dist/cjs/inventory/index.js +3 -2
- package/dist/cjs/inventory/typen.d.ts +39 -1
- package/dist/cjs/inventory/vertrag.d.ts +13 -2
- package/dist/cjs/inventory/vertrag.js +16 -1
- package/dist/cjs/inventory/webhook.d.ts +3 -0
- package/dist/cjs/inventory/webhook.js +39 -0
- package/dist/cjs/models/index.d.ts +1 -1
- package/dist/cjs/models/index.js +10 -2
- package/dist/cjs/models/voucher.d.ts +78 -2
- package/dist/cjs/models/voucher.js +127 -5
- package/dist/cjs/pos/gutschein.d.ts +13 -0
- package/dist/cjs/pos/gutschein.js +5 -1
- package/dist/cjs/pos/index.d.ts +1 -1
- package/dist/cjs/pos/index.js +3 -2
- package/dist/cjs/pos/texte.d.ts +20 -0
- package/dist/cjs/pos/texte.js +11 -0
- package/dist/cjs/receipt/due.d.ts +8 -1
- package/dist/cjs/receipt/due.js +1 -0
- package/dist/cjs/receipt/gutschein-plan.d.ts +11 -1
- package/dist/cjs/receipt/gutschein-plan.js +116 -1
- package/dist/cjs/receipt/layout.js +39 -6
- package/dist/cjs/stored/draht.js +5 -0
- package/dist/cjs/stored/vokabular.d.ts +3 -1
- package/dist/cjs/stored/vokabular.js +15 -2
- package/dist/cjs/version.d.ts +1 -1
- package/dist/cjs/version.js +1 -1
- package/dist/esm/client/list-receipts.d.ts +5 -0
- package/dist/esm/client/list-receipts.js +5 -2
- package/dist/esm/client/receipts.d.ts +6 -0
- package/dist/esm/client/receipts.js +1 -0
- package/dist/esm/enums/voucher-type.d.ts +5 -1
- package/dist/esm/enums/voucher-type.js +5 -1
- package/dist/esm/index.d.ts +1 -1
- package/dist/esm/index.js +1 -1
- package/dist/esm/inventory/index.d.ts +2 -2
- package/dist/esm/inventory/index.js +1 -1
- package/dist/esm/inventory/typen.d.ts +39 -1
- package/dist/esm/inventory/vertrag.d.ts +13 -2
- package/dist/esm/inventory/vertrag.js +15 -0
- package/dist/esm/inventory/webhook.d.ts +3 -0
- package/dist/esm/inventory/webhook.js +39 -0
- package/dist/esm/models/index.d.ts +1 -1
- package/dist/esm/models/index.js +1 -1
- package/dist/esm/models/voucher.d.ts +78 -2
- package/dist/esm/models/voucher.js +122 -4
- package/dist/esm/pos/gutschein.d.ts +13 -0
- package/dist/esm/pos/gutschein.js +4 -0
- package/dist/esm/pos/index.d.ts +1 -1
- package/dist/esm/pos/index.js +1 -1
- package/dist/esm/pos/texte.d.ts +20 -0
- package/dist/esm/pos/texte.js +11 -0
- package/dist/esm/receipt/due.d.ts +8 -1
- package/dist/esm/receipt/due.js +1 -0
- package/dist/esm/receipt/gutschein-plan.d.ts +11 -1
- package/dist/esm/receipt/gutschein-plan.js +117 -2
- package/dist/esm/receipt/layout.js +40 -7
- package/dist/esm/stored/draht.js +6 -1
- package/dist/esm/stored/vokabular.d.ts +3 -1
- package/dist/esm/stored/vokabular.js +14 -1
- package/dist/esm/version.d.ts +1 -1
- package/dist/esm/version.js +1 -1
- package/fixtures/expected/voucher-external-redeem.grid32.txt +30 -0
- package/fixtures/expected/voucher-external-redeem.grid48.txt +27 -0
- package/fixtures/expected/voucher-external-redeem.lines.json +280 -0
- package/fixtures/expected/voucher-external-redeem.sheet32.json +206 -0
- package/fixtures/expected/voucher-external-redeem.sheet48.json +188 -0
- package/fixtures/expected/voucher-external-sale.grid32.txt +27 -0
- package/fixtures/expected/voucher-external-sale.grid48.txt +26 -0
- package/fixtures/expected/voucher-external-sale.lines.json +256 -0
- package/fixtures/expected/voucher-external-sale.sheet32.json +188 -0
- package/fixtures/expected/voucher-external-sale.sheet48.json +182 -0
- package/fixtures/hobex-hps-codes.json +1 -1
- package/fixtures/invoice-api.schema.json +1 -1
- package/fixtures/invoice-texts.json +1 -1
- package/fixtures/manifest.json +16 -0
- package/fixtures/pos-texts.json +22 -2
- package/fixtures/receipt-due-voucher-generated.json +2 -2
- package/fixtures/receipts/voucher-external-redeem.json +85 -0
- package/fixtures/receipts/voucher-external-sale.json +80 -0
- package/fixtures/stored/voucher-cases.json +2800 -0
- package/fixtures/surface.json +14 -2
- package/fixtures/v3/antworten/belege.json +4 -3
- package/fixtures/v3/antworten/belegmail.json +2 -2
- package/fixtures/v3/antworten/berichte.json +2 -2
- package/fixtures/v3/antworten/kasse-belege.json +4 -3
- package/fixtures/v3/antworten/kasse.json +16 -10
- package/fixtures/v3/antworten/lager.json +6 -3
- 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 +169 -8
- package/fixtures/v3/zahlbetrag-faelle.json +2 -2
- package/package.json +1 -1
|
@@ -12,7 +12,22 @@ import { VoucherAction, VoucherType } from '../enums/index.js';
|
|
|
12
12
|
*/
|
|
13
13
|
export interface Voucher {
|
|
14
14
|
name?: string;
|
|
15
|
+
/**
|
|
16
|
+
* Code eines eigenen Gutscheins (Einloesung, Auszahlung). Am gelesenen Eintrag die Maske. Ein Wunsch der
|
|
17
|
+
* Altform mit frei getipptem Code ist veraltet ([LegacyValueVoucherWish]).
|
|
18
|
+
*/
|
|
15
19
|
code?: string;
|
|
20
|
+
/**
|
|
21
|
+
* Fremdgutschein (Server 2026-11): `external` = Gutschein eines anderen Systems (Warenwirtschaft, Webshop) mit
|
|
22
|
+
* seiner Nummer in [number]. Kein Dokument bei Kasseneck, kein Saldo, keine Pruefung: Art, Satz und Betrag sagt
|
|
23
|
+
* der Betrieb. Fehlt bei eigenen Gutscheinen.
|
|
24
|
+
*/
|
|
25
|
+
source?: VoucherSource | string;
|
|
26
|
+
/**
|
|
27
|
+
* Nummer des Fremdgutscheins (nur mit `source: 'external'`): nach [normalizeExternalVoucherNumber] 1 bis 40
|
|
28
|
+
* Zeichen aus `A–Z a–z 0–9 - _ . /`; ein eigener Gutscheincode ist keine Fremdnummer. Steht voll am Bon.
|
|
29
|
+
*/
|
|
30
|
+
number?: string;
|
|
16
31
|
action: VoucherAction | string;
|
|
17
32
|
/**
|
|
18
33
|
* Art des Gutscheins. Beim Verkauf ueber eine Sorte die Art der Sorte
|
|
@@ -119,6 +134,8 @@ export interface VoucherArticle {
|
|
|
119
134
|
export interface VoucherPayload {
|
|
120
135
|
name?: string | null;
|
|
121
136
|
code?: string | null;
|
|
137
|
+
source?: string;
|
|
138
|
+
number?: string;
|
|
122
139
|
action: string;
|
|
123
140
|
type: string;
|
|
124
141
|
value?: number | null;
|
|
@@ -142,16 +159,35 @@ export interface VoucherPayload {
|
|
|
142
159
|
exempt?: boolean;
|
|
143
160
|
zeroRateBucket?: boolean;
|
|
144
161
|
}
|
|
162
|
+
/**
|
|
163
|
+
* Wunsch der Altform: Wertgutschein mit frei getipptem Code (`{ action, type: 'value', code, valueCents }`).
|
|
164
|
+
* Nur als Typ fuer Aufrufer, die ihn noch senden; ein gelesener Beleg ist davon nicht betroffen.
|
|
165
|
+
*
|
|
166
|
+
* @deprecated Server 2026-11: der Weg bleibt gueltig, die Antwort traegt `deprecation`
|
|
167
|
+
* ([ReceiptWithCompany.deprecation]). Der Code wird nicht geprueft, steuerlich ist das ein fremder
|
|
168
|
+
* Mehrzweckgutschein. Einen Gutschein eines anderen Systems als Fremdgutschein senden: `{ source: 'external',
|
|
169
|
+
* action, type: 'multi_purpose', number, amountCents }`; eigene Gutscheine ueber eine Sorte (`typeId`)
|
|
170
|
+
* verkaufen und mit ihrem Code einloesen.
|
|
171
|
+
*/
|
|
172
|
+
export type LegacyValueVoucherWish = Voucher & {
|
|
173
|
+
type: 'value';
|
|
174
|
+
code: string;
|
|
175
|
+
};
|
|
145
176
|
/** Arten der neuen Gutscheinform (die Altwerte sind `value` und `promo`). */
|
|
146
177
|
export declare const NEUE_GUTSCHEINARTEN: readonly string[];
|
|
178
|
+
/** Herkunft eines Gutscheins: `external` = Fremdgutschein (Katalog `GUTSCHEIN_QUELLE`). */
|
|
179
|
+
export type VoucherSource = 'external';
|
|
180
|
+
export declare const VOUCHER_SOURCES: readonly VoucherSource[];
|
|
181
|
+
/** Fremdgutschein (`source: 'external'`)? Zwilling von `gutschein-beleg.istFremd`. */
|
|
182
|
+
export declare function isExternalVoucher(voucher: Pick<Voucher, 'source'>): boolean;
|
|
147
183
|
/** Gehoert der Gutschein zur neuen Form (Art, Aktion `payout` oder Verkauf ueber eine Sorte ohne Art)? */
|
|
148
|
-
export declare function isNewFormVoucher(voucher: Pick<Voucher, 'type' | 'action' | 'typeId'>): boolean;
|
|
184
|
+
export declare function isNewFormVoucher(voucher: Pick<Voucher, 'type' | 'action' | 'typeId'> & Pick<Voucher, 'source'>): boolean;
|
|
149
185
|
/**
|
|
150
186
|
* Wert-Verkauf: ein Mehrzweck- oder Einzweckgutschein wird verkauft (mit Art
|
|
151
187
|
* oder nur ueber die Sorte). Paketintern: Zahlbetrag und Pruefung vor dem
|
|
152
188
|
* Senden entscheiden daran, ob eine Sorte noetig ist.
|
|
153
189
|
*/
|
|
154
|
-
export declare function istWertVerkauf(voucher: Pick<Voucher, 'type' | 'action' | 'typeId'>): boolean;
|
|
190
|
+
export declare function istWertVerkauf(voucher: Pick<Voucher, 'type' | 'action' | 'typeId'> & Pick<Voucher, 'source'>): boolean;
|
|
155
191
|
/**
|
|
156
192
|
* Felder, die nur der Server setzt; an einem Wunsch sind sie `voucher_invalid`.
|
|
157
193
|
* Sortenname und Auszahlung friert der Server beim Verkauf ein (Stufe 4b).
|
|
@@ -175,3 +211,43 @@ export declare function fromVoucherPayload(payload: VoucherPayload): Voucher;
|
|
|
175
211
|
* Stufe 4b antwortet darauf `voucher_type_required`). Paketintern.
|
|
176
212
|
*/
|
|
177
213
|
export declare function wunschFormGueltig(v: Voucher, sorteNoetig: boolean): boolean;
|
|
214
|
+
/** Hoechstlaenge der Nummer eines Fremdgutscheins (nach dem Abschneiden des Rands). */
|
|
215
|
+
export declare const EXTERNAL_VOUCHER_NUMBER_MAX = 40;
|
|
216
|
+
/** Hoechstlaenge von `taxedWith` (Vermerk, mit welchem Beleg im fremden System der Einzweckgutschein versteuert ist). */
|
|
217
|
+
export declare const EXTERNAL_VOUCHER_TAXED_WITH_MAX = 40;
|
|
218
|
+
/**
|
|
219
|
+
* Saetze, mit denen ein fremder Einzweckgutschein verkauft sein kann (Basispunkte): die Saetze der Kasse
|
|
220
|
+
* (20, 10, 13, 19, 4,9 %) und 0 = befreit verkauft (Kleinunternehmer).
|
|
221
|
+
*/
|
|
222
|
+
export declare const EXTERNAL_VOUCHER_VAT_RATES_BP: readonly number[];
|
|
223
|
+
/**
|
|
224
|
+
* Nummer eines Fremdgutscheins in der Form, mit der der Server sie speichert und druckt
|
|
225
|
+
* (`gutschein-core.normiereFremdnummer`): Rand weg, **keine** Unicode-Normalisierung, Gross-/Kleinschreibung
|
|
226
|
+
* bleibt; dann 1 bis 40 Zeichen aus `A–Z a–z 0–9 - _ . /`. Sonst `null` (`external_voucher_number_invalid`).
|
|
227
|
+
* Einen eigenen Gutscheincode erkennt erst [checkExternalVoucherNumber].
|
|
228
|
+
*/
|
|
229
|
+
export declare function normalizeExternalVoucherNumber(text: unknown): string | null;
|
|
230
|
+
/** Ergebnis von [checkExternalVoucherNumber]: die Nummer wie gespeichert, oder der Fehlercode des Servers. */
|
|
231
|
+
export type ExternalVoucherNumberCheck = {
|
|
232
|
+
ok: true;
|
|
233
|
+
number: string;
|
|
234
|
+
} | {
|
|
235
|
+
ok: false;
|
|
236
|
+
code: 'external_voucher_number_is_own_code' | 'external_voucher_number_invalid';
|
|
237
|
+
};
|
|
238
|
+
/**
|
|
239
|
+
* Prueft eine Fremdnummer in der Reihenfolge des Servers (`gutschein-beleg.pruefeFremd`): zuerst, ob sie ein
|
|
240
|
+
* gueltiger eigener Gutscheincode ist (12 Zeichen mit Pruefzeichen, in jeder Schreibweise der Kasse, auch mit `.`, `_`
|
|
241
|
+
* oder `/` als Trenner) – dann
|
|
242
|
+
* `external_voucher_number_is_own_code`, der Gutschein gehoert als eigener eingeloest –, danach die Form.
|
|
243
|
+
*/
|
|
244
|
+
export declare function checkExternalVoucherNumber(text: unknown): ExternalVoucherNumberCheck;
|
|
245
|
+
/**
|
|
246
|
+
* Ist der Fremdgutschein sendbar? Die Form wie `gutschein-beleg.pruefeFremd` (ohne die Freigabe des Kontos, die
|
|
247
|
+
* kennt nur der Server bzw. `PosVoucherSettings.externalVouchers`): Aktion `sell`/`redeem`/`payout`, Art
|
|
248
|
+
* `multi_purpose`/`single_purpose`, gueltige Nummer (kein eigener Code), Betrag 1 bis 1.000.000 Cent; Einzweck mit
|
|
249
|
+
* einem Satz aus [EXTERNAL_VOUCHER_VAT_RATES_BP], Mehrzweck ohne; `taxedWith` nur bei Einzweck-Einloesung bzw.
|
|
250
|
+
* -Auszahlung (1 bis 40 Zeichen ohne Steuerzeichen); Auszahlung mit Grund (1 bis 200 Zeichen). Felder eigener
|
|
251
|
+
* Gutscheine (Code, Sorte, Artikel, Menge, Positionen) und Serverfelder nie.
|
|
252
|
+
*/
|
|
253
|
+
export declare function externalVoucherIsValid(voucher: Voucher): boolean;
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.GUTSCHEIN_SERVERFELDER = exports.NEUE_GUTSCHEINARTEN = void 0;
|
|
3
|
+
exports.EXTERNAL_VOUCHER_VAT_RATES_BP = exports.EXTERNAL_VOUCHER_TAXED_WITH_MAX = exports.EXTERNAL_VOUCHER_NUMBER_MAX = exports.GUTSCHEIN_SERVERFELDER = exports.VOUCHER_SOURCES = exports.NEUE_GUTSCHEINARTEN = void 0;
|
|
4
|
+
exports.isExternalVoucher = isExternalVoucher;
|
|
4
5
|
exports.isNewFormVoucher = isNewFormVoucher;
|
|
5
6
|
exports.istWertVerkauf = istWertVerkauf;
|
|
6
7
|
exports.voucherServerFields = voucherServerFields;
|
|
@@ -8,7 +9,11 @@ exports.toVoucherPayload = toVoucherPayload;
|
|
|
8
9
|
exports.voucherIsValid = voucherIsValid;
|
|
9
10
|
exports.fromVoucherPayload = fromVoucherPayload;
|
|
10
11
|
exports.wunschFormGueltig = wunschFormGueltig;
|
|
12
|
+
exports.normalizeExternalVoucherNumber = normalizeExternalVoucherNumber;
|
|
13
|
+
exports.checkExternalVoucherNumber = checkExternalVoucherNumber;
|
|
14
|
+
exports.externalVoucherIsValid = externalVoucherIsValid;
|
|
11
15
|
const index_js_1 = require("../enums/index.js");
|
|
16
|
+
const validator_1 = require("@kreiseck/validator");
|
|
12
17
|
const money_js_1 = require("../money.js");
|
|
13
18
|
const enum_payload_js_1 = require("./enum-payload.js");
|
|
14
19
|
/** Arten der neuen Gutscheinform (die Altwerte sind `value` und `promo`). */
|
|
@@ -18,6 +23,11 @@ exports.NEUE_GUTSCHEINARTEN = [
|
|
|
18
23
|
index_js_1.VoucherType.service,
|
|
19
24
|
index_js_1.VoucherType.promotion,
|
|
20
25
|
];
|
|
26
|
+
exports.VOUCHER_SOURCES = Object.freeze(['external']);
|
|
27
|
+
/** Fremdgutschein (`source: 'external'`)? Zwilling von `gutschein-beleg.istFremd`. */
|
|
28
|
+
function isExternalVoucher(voucher) {
|
|
29
|
+
return voucher.source === 'external';
|
|
30
|
+
}
|
|
21
31
|
/**
|
|
22
32
|
* Verkauf ueber eine Sorte ohne Art (`typeId` ohne `type`): die Art kommt aus
|
|
23
33
|
* der Sorte. Zwilling von `gutschein-beleg.istSortenVerkauf`.
|
|
@@ -27,7 +37,8 @@ function istSortenVerkaufOhneArt(voucher) {
|
|
|
27
37
|
}
|
|
28
38
|
/** Gehoert der Gutschein zur neuen Form (Art, Aktion `payout` oder Verkauf ueber eine Sorte ohne Art)? */
|
|
29
39
|
function isNewFormVoucher(voucher) {
|
|
30
|
-
return exports.NEUE_GUTSCHEINARTEN.includes(voucher.type) || voucher.action === index_js_1.VoucherAction.payout || istSortenVerkaufOhneArt(voucher)
|
|
40
|
+
return exports.NEUE_GUTSCHEINARTEN.includes(voucher.type) || voucher.action === index_js_1.VoucherAction.payout || istSortenVerkaufOhneArt(voucher)
|
|
41
|
+
|| isExternalVoucher(voucher);
|
|
31
42
|
}
|
|
32
43
|
/**
|
|
33
44
|
* Wert-Verkauf: ein Mehrzweck- oder Einzweckgutschein wird verkauft (mit Art
|
|
@@ -35,7 +46,7 @@ function isNewFormVoucher(voucher) {
|
|
|
35
46
|
* Senden entscheiden daran, ob eine Sorte noetig ist.
|
|
36
47
|
*/
|
|
37
48
|
function istWertVerkauf(voucher) {
|
|
38
|
-
return voucher.action === index_js_1.VoucherAction.sell
|
|
49
|
+
return !isExternalVoucher(voucher) && voucher.action === index_js_1.VoucherAction.sell
|
|
39
50
|
&& (voucher.type === index_js_1.VoucherType.multi_purpose || voucher.type === index_js_1.VoucherType.single_purpose || istSortenVerkaufOhneArt(voucher));
|
|
40
51
|
}
|
|
41
52
|
/**
|
|
@@ -48,7 +59,7 @@ function voucherServerFields(voucher) {
|
|
|
48
59
|
return exports.GUTSCHEIN_SERVERFELDER.filter((feld) => voucher[feld] != null);
|
|
49
60
|
}
|
|
50
61
|
const NEUE_FELDER = [
|
|
51
|
-
'amountCents', 'articleId', 'quantity', 'positions', 'reason', 'typeId', 'typeName', 'payout', 'voucherType', 'voucherId', 'codeSuffix',
|
|
62
|
+
'source', 'number', 'amountCents', 'articleId', 'quantity', 'positions', 'reason', 'typeId', 'typeName', 'payout', 'voucherType', 'voucherId', 'codeSuffix',
|
|
52
63
|
'vatRateBp', 'article', 'balanceAfterCents', 'remainingQuantityAfter', 'taxedWith', 'exempt', 'zeroRateBucket', 'fromReturn',
|
|
53
64
|
];
|
|
54
65
|
function toVoucherPayload(voucher) {
|
|
@@ -81,6 +92,8 @@ function toVoucherPayload(voucher) {
|
|
|
81
92
|
* gesetzter Wert muss positiv sein.
|
|
82
93
|
*/
|
|
83
94
|
function voucherIsValid(voucher) {
|
|
95
|
+
if (isExternalVoucher(voucher))
|
|
96
|
+
return externalVoucherIsValid(voucher);
|
|
84
97
|
if (isNewFormVoucher(voucher))
|
|
85
98
|
return newFormVoucherIsValid(voucher);
|
|
86
99
|
if (voucher.type === index_js_1.VoucherType.value && voucher.valueCents == null) {
|
|
@@ -170,13 +183,21 @@ function newFormVoucherIsValid(v) {
|
|
|
170
183
|
* Stufe 4b antwortet darauf `voucher_type_required`). Paketintern.
|
|
171
184
|
*/
|
|
172
185
|
function wunschFormGueltig(v, sorteNoetig) {
|
|
186
|
+
if (isExternalVoucher(v))
|
|
187
|
+
return externalVoucherIsValid(v);
|
|
173
188
|
if (voucherServerFields(v).length > 0)
|
|
174
189
|
return false;
|
|
175
190
|
const r = v;
|
|
176
|
-
for (const feld of ['
|
|
191
|
+
for (const feld of ['article', 'balanceAfterCents', 'remainingQuantityAfter', 'exempt']) {
|
|
177
192
|
if (r[feld] != null)
|
|
178
193
|
return false;
|
|
179
194
|
}
|
|
195
|
+
// Felder nur des Fremdgutscheins (gutschein-beleg.NUR_BEI_FREMD): der Server weist sie an einem eigenen Wunsch
|
|
196
|
+
// schon gesendet ab, auch als `null` (`voucher_invalid`); eine andere Herkunft als `external` gibt es nicht.
|
|
197
|
+
for (const feld of ['number', 'taxedWith', 'vatRateBp', 'source']) {
|
|
198
|
+
if (r[feld] !== undefined)
|
|
199
|
+
return false;
|
|
200
|
+
}
|
|
180
201
|
if (v.valueCents != null)
|
|
181
202
|
return false;
|
|
182
203
|
// Die Sorte gehoert nur an einen Wert-Verkauf (Server: sorteId sonst voucher_invalid).
|
|
@@ -220,3 +241,104 @@ function wunschFormGueltig(v, sorteNoetig) {
|
|
|
220
241
|
// Altart mit neuer Aktion (payout + value/promo): nicht sendbar.
|
|
221
242
|
return false;
|
|
222
243
|
}
|
|
244
|
+
// ---- Fremdgutscheine (Server 2026-11) -------------------------------------------
|
|
245
|
+
/**
|
|
246
|
+
* Rand einer Fremdnummer (Zwilling von `gutschein-core.FREMD_RAND`): ASCII-Leerraum und die Unicode-Leerzeichen,
|
|
247
|
+
* die beim Kopieren aus Fremdsystemen mitkommen. Bewusst ohne U+0085 (NEL): ein Steuerzeichen, das nie still
|
|
248
|
+
* verschwindet, sondern die Nummer ungueltig macht.
|
|
249
|
+
*/
|
|
250
|
+
const FREMD_RAND = '\\t\\n\\v\\f\\r \\u00A0\\u1680\\u2000-\\u200A\\u2028\\u2029\\u202F\\u205F\\u3000\\uFEFF';
|
|
251
|
+
const FREMD_RAND_MUSTER = new RegExp(`^[${FREMD_RAND}]+|[${FREMD_RAND}]+$`, 'g');
|
|
252
|
+
const FREMD_NUMMER_MUSTER = /^[A-Za-z0-9\-_./]{1,40}$/;
|
|
253
|
+
/** Hoechstlaenge der Nummer eines Fremdgutscheins (nach dem Abschneiden des Rands). */
|
|
254
|
+
exports.EXTERNAL_VOUCHER_NUMBER_MAX = 40;
|
|
255
|
+
/** Hoechstlaenge von `taxedWith` (Vermerk, mit welchem Beleg im fremden System der Einzweckgutschein versteuert ist). */
|
|
256
|
+
exports.EXTERNAL_VOUCHER_TAXED_WITH_MAX = 40;
|
|
257
|
+
/**
|
|
258
|
+
* Saetze, mit denen ein fremder Einzweckgutschein verkauft sein kann (Basispunkte): die Saetze der Kasse
|
|
259
|
+
* (20, 10, 13, 19, 4,9 %) und 0 = befreit verkauft (Kleinunternehmer).
|
|
260
|
+
*/
|
|
261
|
+
exports.EXTERNAL_VOUCHER_VAT_RATES_BP = Object.freeze([2000, 1000, 1300, 1900, 490, 0]);
|
|
262
|
+
/**
|
|
263
|
+
* Nummer eines Fremdgutscheins in der Form, mit der der Server sie speichert und druckt
|
|
264
|
+
* (`gutschein-core.normiereFremdnummer`): Rand weg, **keine** Unicode-Normalisierung, Gross-/Kleinschreibung
|
|
265
|
+
* bleibt; dann 1 bis 40 Zeichen aus `A–Z a–z 0–9 - _ . /`. Sonst `null` (`external_voucher_number_invalid`).
|
|
266
|
+
* Einen eigenen Gutscheincode erkennt erst [checkExternalVoucherNumber].
|
|
267
|
+
*/
|
|
268
|
+
function normalizeExternalVoucherNumber(text) {
|
|
269
|
+
if (typeof text !== 'string')
|
|
270
|
+
return null;
|
|
271
|
+
const n = text.replace(FREMD_RAND_MUSTER, '');
|
|
272
|
+
return FREMD_NUMMER_MUSTER.test(n) ? n : null;
|
|
273
|
+
}
|
|
274
|
+
/**
|
|
275
|
+
* Prueft eine Fremdnummer in der Reihenfolge des Servers (`gutschein-beleg.pruefeFremd`): zuerst, ob sie ein
|
|
276
|
+
* gueltiger eigener Gutscheincode ist (12 Zeichen mit Pruefzeichen, in jeder Schreibweise der Kasse, auch mit `.`, `_`
|
|
277
|
+
* oder `/` als Trenner) – dann
|
|
278
|
+
* `external_voucher_number_is_own_code`, der Gutschein gehoert als eigener eingeloest –, danach die Form.
|
|
279
|
+
*/
|
|
280
|
+
function checkExternalVoucherNumber(text) {
|
|
281
|
+
// `.`, `_` und `/` zwischen den Gruppen liest die Pruefung wie `-` (Zwilling von `gutschein-core.istEigenerCode`):
|
|
282
|
+
// `7148.FGQA.935K` ist der eigene Code. Die Nummer selbst bleibt, wie sie kam.
|
|
283
|
+
if (typeof text === 'string' && validator_1.VoucherCode.validate(text.replace(/[._/]/g, '-')).ok)
|
|
284
|
+
return { ok: false, code: 'external_voucher_number_is_own_code' };
|
|
285
|
+
const number = normalizeExternalVoucherNumber(text);
|
|
286
|
+
return number === null ? { ok: false, code: 'external_voucher_number_invalid' } : { ok: true, number };
|
|
287
|
+
}
|
|
288
|
+
/** Steuer- und Formatzeichen (`gutschein-core.STEUERZEICHEN`): nie in `taxedWith`. */
|
|
289
|
+
const STEUERZEICHEN = /[\p{Cc}\p{Cf}]/u;
|
|
290
|
+
/**
|
|
291
|
+
* Ist der Fremdgutschein sendbar? Die Form wie `gutschein-beleg.pruefeFremd` (ohne die Freigabe des Kontos, die
|
|
292
|
+
* kennt nur der Server bzw. `PosVoucherSettings.externalVouchers`): Aktion `sell`/`redeem`/`payout`, Art
|
|
293
|
+
* `multi_purpose`/`single_purpose`, gueltige Nummer (kein eigener Code), Betrag 1 bis 1.000.000 Cent; Einzweck mit
|
|
294
|
+
* einem Satz aus [EXTERNAL_VOUCHER_VAT_RATES_BP], Mehrzweck ohne; `taxedWith` nur bei Einzweck-Einloesung bzw.
|
|
295
|
+
* -Auszahlung (1 bis 40 Zeichen ohne Steuerzeichen); Auszahlung mit Grund (1 bis 200 Zeichen). Felder eigener
|
|
296
|
+
* Gutscheine (Code, Sorte, Artikel, Menge, Positionen) und Serverfelder nie.
|
|
297
|
+
*/
|
|
298
|
+
function externalVoucherIsValid(voucher) {
|
|
299
|
+
const v = voucher;
|
|
300
|
+
if (!isExternalVoucher(v))
|
|
301
|
+
return false;
|
|
302
|
+
if (voucherServerFields(v).length > 0)
|
|
303
|
+
return false;
|
|
304
|
+
const r = v;
|
|
305
|
+
// gutschein-beleg.NICHT_BEI_FREMD (gesendet heisst voucher_invalid, auch als null).
|
|
306
|
+
for (const feld of ['code', 'typeId', 'articleId', 'article', 'quantity', 'positions']) {
|
|
307
|
+
if (r[feld] !== undefined)
|
|
308
|
+
return false;
|
|
309
|
+
}
|
|
310
|
+
for (const feld of ['balanceAfterCents', 'remainingQuantityAfter', 'exempt']) {
|
|
311
|
+
if (r[feld] != null)
|
|
312
|
+
return false;
|
|
313
|
+
}
|
|
314
|
+
if (v.valueCents != null)
|
|
315
|
+
return false;
|
|
316
|
+
if (v.action !== index_js_1.VoucherAction.sell && v.action !== index_js_1.VoucherAction.redeem && v.action !== index_js_1.VoucherAction.payout)
|
|
317
|
+
return false;
|
|
318
|
+
if (v.type !== index_js_1.VoucherType.multi_purpose && v.type !== index_js_1.VoucherType.single_purpose)
|
|
319
|
+
return false;
|
|
320
|
+
if (!checkExternalVoucherNumber(v.number).ok)
|
|
321
|
+
return false;
|
|
322
|
+
if (!istCent(v.amountCents))
|
|
323
|
+
return false;
|
|
324
|
+
if (v.type === index_js_1.VoucherType.single_purpose) {
|
|
325
|
+
if (!(typeof v.vatRateBp === 'number' && exports.EXTERNAL_VOUCHER_VAT_RATES_BP.includes(v.vatRateBp)))
|
|
326
|
+
return false;
|
|
327
|
+
}
|
|
328
|
+
else if (v.vatRateBp != null) {
|
|
329
|
+
return false;
|
|
330
|
+
}
|
|
331
|
+
if (v.taxedWith != null) {
|
|
332
|
+
if (v.type !== index_js_1.VoucherType.single_purpose || v.action === index_js_1.VoucherAction.sell)
|
|
333
|
+
return false;
|
|
334
|
+
const t = typeof v.taxedWith === 'string' ? v.taxedWith.trim() : '';
|
|
335
|
+
if (t.length < 1 || t.length > exports.EXTERNAL_VOUCHER_TAXED_WITH_MAX || STEUERZEICHEN.test(t))
|
|
336
|
+
return false;
|
|
337
|
+
}
|
|
338
|
+
if (v.action === index_js_1.VoucherAction.payout) {
|
|
339
|
+
const g = typeof v.reason === 'string' ? v.reason.trim() : '';
|
|
340
|
+
if (g.length < 1 || g.length > MAX_GRUND)
|
|
341
|
+
return false;
|
|
342
|
+
}
|
|
343
|
+
return true;
|
|
344
|
+
}
|
|
@@ -36,6 +36,14 @@ export declare const VOUCHER_TYPE_KINDS: readonly VoucherTypeKind[];
|
|
|
36
36
|
export declare const VOUCHER_AMOUNT_MODES: readonly ('free' | 'fixed')[];
|
|
37
37
|
/** Gueltigkeit einer Sorte: unbefristet oder N Jahre (das Muster der Sorte, nicht das eines Gutscheins). */
|
|
38
38
|
export declare const VOUCHER_TYPE_VALIDITY_PATTERNS: readonly ('unlimited' | 'years')[];
|
|
39
|
+
/**
|
|
40
|
+
* Freigabe fuer Fremdgutscheine des Kontos (`vouchers.externalVouchers`): `off` keine, `multi_purpose` nur
|
|
41
|
+
* Wertgutscheine (Mehrzweck) eines anderen Systems, `all` dazu Einzweckgutscheine. Die Kasse zeigt den Weg
|
|
42
|
+
* „Fremdgutschein“ nur ab `multi_purpose`, die Art Einzweck nur bei `all`; der Server prueft dieselbe Freigabe
|
|
43
|
+
* (`external_voucher_not_enabled`, `external_voucher_type_not_enabled`). Die Test-Umgebung ist immer `all`.
|
|
44
|
+
*/
|
|
45
|
+
export type PosExternalVouchers = 'off' | 'multi_purpose' | 'all';
|
|
46
|
+
export declare const EXTERNAL_VOUCHERS: readonly PosExternalVouchers[];
|
|
39
47
|
/** Der Artikel eines Dienstleistungsgutscheins. */
|
|
40
48
|
export interface VoucherArticle {
|
|
41
49
|
id: string;
|
|
@@ -158,6 +166,11 @@ export interface PosVoucherSettings {
|
|
|
158
166
|
* passende Sorte). Fehlt sie, zeigt die Kasse „Als Gutschein“ nicht.
|
|
159
167
|
*/
|
|
160
168
|
returnType?: PosVoucherReturnType;
|
|
169
|
+
/**
|
|
170
|
+
* Freigabe fuer Fremdgutscheine (Server 2026-11, [EXTERNAL_VOUCHERS]). Der Leser setzt sie immer; fehlt sie
|
|
171
|
+
* am Draht (aelterer Server) oder ist sie unbekannt, gilt `off`.
|
|
172
|
+
*/
|
|
173
|
+
externalVouchers?: PosExternalVouchers;
|
|
161
174
|
}
|
|
162
175
|
/** Sorte fuer Rueckgaben (`vouchers.returnType`): Kennung und Name. */
|
|
163
176
|
export interface PosVoucherReturnType {
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.VOUCHER_SETTINGS_DEFAULTS = exports.VOUCHER_TYPE_VALIDITY_PATTERNS = exports.VOUCHER_AMOUNT_MODES = exports.VOUCHER_TYPE_KINDS = exports.VOUCHER_PAYOUTS = exports.VOUCHER_STATUSES = exports.VOUCHER_KINDS = void 0;
|
|
3
|
+
exports.VOUCHER_SETTINGS_DEFAULTS = exports.EXTERNAL_VOUCHERS = exports.VOUCHER_TYPE_VALIDITY_PATTERNS = exports.VOUCHER_AMOUNT_MODES = exports.VOUCHER_TYPE_KINDS = exports.VOUCHER_PAYOUTS = exports.VOUCHER_STATUSES = exports.VOUCHER_KINDS = void 0;
|
|
4
4
|
exports.posVoucherSettingsFromWire = posVoucherSettingsFromWire;
|
|
5
5
|
exports.checkVoucher = checkVoucher;
|
|
6
6
|
exports.reprintVoucherLabel = reprintVoucherLabel;
|
|
@@ -19,10 +19,12 @@ exports.VOUCHER_TYPE_KINDS = Object.freeze(['multi_purpose', 'single_purpose']);
|
|
|
19
19
|
exports.VOUCHER_AMOUNT_MODES = Object.freeze(['free', 'fixed']);
|
|
20
20
|
/** Gueltigkeit einer Sorte: unbefristet oder N Jahre (das Muster der Sorte, nicht das eines Gutscheins). */
|
|
21
21
|
exports.VOUCHER_TYPE_VALIDITY_PATTERNS = Object.freeze(['unlimited', 'years']);
|
|
22
|
+
exports.EXTERNAL_VOUCHERS = Object.freeze(['off', 'multi_purpose', 'all']);
|
|
22
23
|
/** Ohne Block `vouchers` (alter Server, Konto ohne Schalter): Verkaufen ist aus. */
|
|
23
24
|
exports.VOUCHER_SETTINGS_DEFAULTS = Object.freeze({
|
|
24
25
|
sale: false, valueVoucherType: null, vatRateBp: null,
|
|
25
26
|
typeSale: false, types: Object.freeze([]), serviceArticles: false, labelDefault: null,
|
|
27
|
+
externalVouchers: 'off',
|
|
26
28
|
});
|
|
27
29
|
/**
|
|
28
30
|
* Block `vouchers` einer Einstellungs-Antwort, geschlossen im Zweifel: ist
|
|
@@ -83,6 +85,8 @@ function posVoucherSettingsFromWire(block) {
|
|
|
83
85
|
serviceArticles: leistung,
|
|
84
86
|
labelDefault: vorlageVomDraht(b['labelDefault']),
|
|
85
87
|
...rueckgabeSorteVomDraht(b['returnType']),
|
|
88
|
+
// Unbekannt oder fehlend: aus (schliesst nur den Fremdgutschein, nie den Block).
|
|
89
|
+
externalVouchers: exports.EXTERNAL_VOUCHERS.includes(b['externalVouchers']) ? b['externalVouchers'] : 'off',
|
|
86
90
|
};
|
|
87
91
|
}
|
|
88
92
|
/** `vouchers.returnType`, nur stimmig (Kennung wie eine Sorte, Name als Text); sonst fehlt es. */
|
package/dist/cjs/pos/index.d.ts
CHANGED
|
@@ -23,7 +23,7 @@ export { STOCK_LOCATION_TYPES, type StockLocationType, type StockLocation, type
|
|
|
23
23
|
export { type ListMyStocktakesOptions, type ListMyStocktakeItemsOptions, type ListMyStocktakeCountsOptions, type RecordMyStocktakeCountOptions, type VoidMyStocktakeCountOptions, listMyStocktakes, listMyStocktakeItems, listMyStocktakeCounts, recordMyStocktakeCount, voidMyStocktakeCount, parseQuantityMilli, } from './inventur.js';
|
|
24
24
|
export type { Stocktake, StocktakeItem, StocktakeCount, StocktakeCountResult, StocktakeItemPage, StocktakeCountPage, StocktakeActor, StocktakeProgress, StocktakeReview, StocktakeRecount, StocktakeScope, } from '../inventory/typen.js';
|
|
25
25
|
export type { StocktakeStatus } from '../inventory/vertrag.js';
|
|
26
|
-
export { VOUCHER_KINDS, VOUCHER_STATUSES, checkVoucher, reprintVoucherLabel, VOUCHER_SETTINGS_DEFAULTS, posVoucherSettingsFromWire, VOUCHER_PAYOUTS, VOUCHER_TYPE_KINDS, VOUCHER_AMOUNT_MODES, VOUCHER_TYPE_VALIDITY_PATTERNS, type VoucherKind, type VoucherStatus, type VoucherValidity, type VoucherArticle, type VoucherCheck, type PosVoucherSettings, type PosVoucherReturnType, type VoucherPayout, type VoucherTypeKind, type PosVoucherType, type VoucherLabelTemplate, } from './gutschein.js';
|
|
26
|
+
export { VOUCHER_KINDS, VOUCHER_STATUSES, checkVoucher, reprintVoucherLabel, VOUCHER_SETTINGS_DEFAULTS, posVoucherSettingsFromWire, VOUCHER_PAYOUTS, VOUCHER_TYPE_KINDS, VOUCHER_AMOUNT_MODES, VOUCHER_TYPE_VALIDITY_PATTERNS, EXTERNAL_VOUCHERS, type PosExternalVouchers, type VoucherKind, type VoucherStatus, type VoucherValidity, type VoucherArticle, type VoucherCheck, type PosVoucherSettings, type PosVoucherReturnType, type VoucherPayout, type VoucherTypeKind, type PosVoucherType, type VoucherLabelTemplate, } from './gutschein.js';
|
|
27
27
|
export { type GetMyDrawerStateOptions, type OpenMyShiftOptions, type RecordMyCashMovementOptions, type DrawerOpeningEntry, type LogMyDrawerOpeningsOptions, type GetMyShiftReportOptions, type TipPayout, type CloseMyShiftOptions, type AfterCountOption, type RecordMyShiftCountOptions, getMyDrawerState, openMyShift, recordMyCashMovement, logMyDrawerOpenings, getMyShiftReport, closeMyShift, recordMyShiftCount, sumDenominations, parseCentsAllowZero, newIdempotencyKey, shiftTipLines, durationText, type ShiftTipLine, type ShiftTipLineKey, } from './schicht.js';
|
|
28
28
|
export { EUR_DENOMINATIONS, MOVEMENT_TYPES, MANUAL_MOVEMENT_TYPES, CASH_LOCATIONS, OPENING_REASONS, MANUAL_OPENING_REASONS, SHIFT_RECEIPT_KINDS, AFTER_COUNT_TYPES, type AfterCountType, type AfterCount, EXPECTED_PART_KEYS, DIFFERENCE_PART_TYPES, type ExpectedPartKey, type ShiftExpectedPart, type DifferencePartType, type ShiftDifferencePart, type LastShift, type ShiftCountResult, type EurDenomination, type MovementType, type ManualMovementType, type CashLocation, type OpeningReason, type ManualOpeningReason, type ShiftReceiptKind, type ShiftStatus, type ShiftActorRole, type Denominations, type ShiftActor, type DrawerInfo, type DrawerRights, type NonCashAmount, type ShiftTipTotals, type ShiftTip, type ShiftOwnerTip, type ShiftRunningTotals, type ShiftReconciliation, type Shift, type TipClaim, type DrawerOpening, type DrawerState, type CashMovement, type ShiftReceiptHeader, type ShiftReceiptMovement, type ShiftReceiptTip, type ShiftSummaryReceipt, type CashMovementReceipt, type ShiftReceipt, type OpenShiftResult, type CashMovementResult, type DrawerOpeningsResult, type ShiftReport, type CloseShiftResult, } from './schicht-typen.js';
|
|
29
29
|
export { type ShiftReceiptLayoutOptions, shiftReceiptLayout, cashMovementLayout } from '../receipt/shift-sheet.js';
|
package/dist/cjs/pos/index.js
CHANGED
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.LOGO_SCALE = exports.WATERMARK_STRENGTH = exports.WATERMARK_SIDE = exports.DISCOUNT = exports.AUTO_LOGOUT_MINUTES = exports.TILE_STYLE = exports.SETTINGS_FONT_SIZE = exports.LOGO_SIZE = exports.QR_MODE = exports.DRAWER_AUTO_OPEN = exports.CUT = exports.CODE_PAGE = exports.PAPER_SIZE = exports.TERMINAL_TYPE = exports.TERMINAL_VIA = exports.PRINTER_TYPE = exports.TILE_HEIGHT = exports.CATEGORY_POSITION = exports.LAYOUT = exports.RECEIPT_OUTPUT = exports.CARD_PROVIDER = exports.CHECKOUT_MODE = exports.CART_WIDTH = exports.TIP_START = exports.TIP_KINDS = exports.TIP_MODE = exports.QUANTITY = exports.WATERMARK = exports.FONT_SIZE = exports.THEME = exports.posShortcutConflict = exports.POS_SHORTCUT_SHARED_PAIRS = exports.posSettingsChanges = exports.unknownPosSettingValues = exports.sanitizePosSettings = exports.mergePosSettings = exports.POS_DEVICE_VALUES = exports.POS_BUSINESS_VALUES = exports.posCartWidth = exports.posTipStart = exports.posTipKinds = exports.posTipKeptByDefault = exports.POS_DEVICE_OPTIONAL_CHOICES = exports.POS_BUSINESS_OPTIONAL_CHOICES = exports.POS_BUSINESS_OPTIONAL_FIELDS = exports.POS_DEVICE_OPTIONAL_FIELDS = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.POS_SHORTCUT_DEFAULTS = exports.POS_SHORTCUT_ACTIONS = void 0;
|
|
4
4
|
exports.PRINT_JOB_SOURCES = exports.PRINT_JOB_STATUSES = exports.voucherPermsOf = exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.posFieldErrors = exports.isPosError = exports.posErrorCode = exports.isPosErrorCode = exports.POS_ERROR_CODES = exports.posSettingsFromWire = exports.setMyPosLogo = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = exports.getPosSettings = exports.orderAddOnLines = exports.addOnDisplayOrder = exports.addOnRemap = exports.addOnsOfItem = exports.addOnReferencesValid = exports.addOnsFor = exports.isSelectableAddOn = exports.ADD_ON_BLOCK_REASONS = exports.ADD_ONS_MAX = exports.fromReferencePayload = exports.referenceLineName = exports.checkReference = exports.isDigitsOnlyPattern = exports.isValidReferencePattern = exports.cleanReferenceText = exports.REFERENCE_PATTERN_TEMPLATES = exports.REFERENCE_PATTERN_MAX = exports.REFERENCE_HINT_MAX = exports.REFERENCE_LABEL_MAX = exports.REFERENCE_INPUT_MAX = exports.REFERENCE_MODES = exports.tilePrompts = exports.isBookableArticle = exports.allowedQuantity = exports.quantityDefaults = exports.quantityRuleForUnit = exports.QUANTITY_RULES = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.DONE_SCREEN_SECONDS = exports.WATERMARK_SCALE = void 0;
|
|
5
|
-
exports.
|
|
6
|
-
exports.roundUpSuggestions = exports.receiptOutputLabel = exports.RETURN_DISPOSITION_LABELS = exports.labelText = exports.LABELS = exports.voucherErrorMessage = exports.VOUCHER_ERROR_MESSAGES = exports.cancellationErrorMessage = exports.CANCELLATION_VOUCHER_ERROR_MESSAGES = exports.cancellationPaymentErrorMessage = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.receiptEmailErrorMessage = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.messageAppliesTo = exports.messageText = exports.messageOutcome = exports.findErrorRule = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = exports.isReturnDisposition = exports.RETURN_DISPOSITIONS = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_KINDS = exports.cashMovementLayout = exports.shiftReceiptLayout = exports.DIFFERENCE_PART_TYPES = exports.EXPECTED_PART_KEYS = void 0;
|
|
5
|
+
exports.SHIFT_RECEIPT_KINDS = exports.MANUAL_OPENING_REASONS = exports.OPENING_REASONS = exports.CASH_LOCATIONS = exports.MANUAL_MOVEMENT_TYPES = exports.MOVEMENT_TYPES = exports.EUR_DENOMINATIONS = exports.durationText = exports.shiftTipLines = exports.newIdempotencyKey = exports.parseCentsAllowZero = exports.sumDenominations = exports.recordMyShiftCount = exports.closeMyShift = exports.getMyShiftReport = exports.logMyDrawerOpenings = exports.recordMyCashMovement = exports.openMyShift = exports.getMyDrawerState = exports.EXTERNAL_VOUCHERS = exports.VOUCHER_TYPE_VALIDITY_PATTERNS = exports.VOUCHER_AMOUNT_MODES = exports.VOUCHER_TYPE_KINDS = exports.VOUCHER_PAYOUTS = exports.posVoucherSettingsFromWire = exports.VOUCHER_SETTINGS_DEFAULTS = exports.reprintVoucherLabel = exports.checkVoucher = exports.VOUCHER_STATUSES = exports.VOUCHER_KINDS = exports.parseQuantityMilli = exports.voidMyStocktakeCount = exports.recordMyStocktakeCount = exports.listMyStocktakeCounts = exports.listMyStocktakeItems = exports.listMyStocktakes = exports.setMyCashregisterStockLocation = exports.listMyStock = exports.listMyStockLocations = exports.STOCK_LOCATION_TYPES = exports.reportConnectState = exports.inspectionInfoLines = exports.inspectionInfoRows = exports.getRegisterInspectionInfo = exports.depFolderName = exports.listMyTipRecipients = exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.isPrintJobFinished = void 0;
|
|
6
|
+
exports.roundUpSuggestions = exports.receiptOutputLabel = exports.RETURN_DISPOSITION_LABELS = exports.labelText = exports.LABELS = exports.voucherErrorMessage = exports.VOUCHER_ERROR_MESSAGES = exports.cancellationErrorMessage = exports.CANCELLATION_VOUCHER_ERROR_MESSAGES = exports.cancellationPaymentErrorMessage = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.receiptEmailErrorMessage = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.messageAppliesTo = exports.messageText = exports.messageOutcome = exports.findErrorRule = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = exports.isReturnDisposition = exports.RETURN_DISPOSITIONS = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_KINDS = exports.cashMovementLayout = exports.shiftReceiptLayout = exports.DIFFERENCE_PART_TYPES = exports.EXPECTED_PART_KEYS = exports.AFTER_COUNT_TYPES = void 0;
|
|
7
7
|
/**
|
|
8
8
|
* Kachel-Kasse: Einstellungen, Artikelgruppen/Artikel fuer Kacheln,
|
|
9
9
|
* Rabattverteilung, Drucker, Trinkgeld-Empfaenger, Lager (Standorte, Bestand,
|
|
@@ -165,6 +165,7 @@ Object.defineProperty(exports, "VOUCHER_PAYOUTS", { enumerable: true, get: funct
|
|
|
165
165
|
Object.defineProperty(exports, "VOUCHER_TYPE_KINDS", { enumerable: true, get: function () { return gutschein_js_1.VOUCHER_TYPE_KINDS; } });
|
|
166
166
|
Object.defineProperty(exports, "VOUCHER_AMOUNT_MODES", { enumerable: true, get: function () { return gutschein_js_1.VOUCHER_AMOUNT_MODES; } });
|
|
167
167
|
Object.defineProperty(exports, "VOUCHER_TYPE_VALIDITY_PATTERNS", { enumerable: true, get: function () { return gutschein_js_1.VOUCHER_TYPE_VALIDITY_PATTERNS; } });
|
|
168
|
+
Object.defineProperty(exports, "EXTERNAL_VOUCHERS", { enumerable: true, get: function () { return gutschein_js_1.EXTERNAL_VOUCHERS; } });
|
|
168
169
|
// Schicht, Kassenstand und Lade-Protokoll (1.9.0): Aufrufe, Kataloge, Helfer, Bons.
|
|
169
170
|
var schicht_js_1 = require("./schicht.js");
|
|
170
171
|
Object.defineProperty(exports, "getMyDrawerState", { enumerable: true, get: function () { return schicht_js_1.getMyDrawerState; } });
|
package/dist/cjs/pos/texte.d.ts
CHANGED
|
@@ -414,6 +414,21 @@ declare const MELDUNGEN_ROH: {
|
|
|
414
414
|
readonly 'voucher_error.payout_not_allowed': {
|
|
415
415
|
readonly text: "Dieser Gutschein kann nicht ausgezahlt werden.";
|
|
416
416
|
};
|
|
417
|
+
readonly 'voucher_error.external_not_enabled': {
|
|
418
|
+
readonly text: "Fremde Gutscheine sind für dieses Konto nicht freigegeben.";
|
|
419
|
+
};
|
|
420
|
+
readonly 'voucher_error.external_type_not_enabled': {
|
|
421
|
+
readonly text: "Fremde Einzweckgutscheine sind für dieses Konto nicht freigegeben.";
|
|
422
|
+
};
|
|
423
|
+
readonly 'voucher_error.external_number_invalid': {
|
|
424
|
+
readonly text: "Gutscheinnummer prüfen: 1 bis 40 Zeichen, nur Buchstaben, Ziffern und - _ . / sind erlaubt.";
|
|
425
|
+
};
|
|
426
|
+
readonly 'voucher_error.external_number_is_own_code': {
|
|
427
|
+
readonly text: "Das ist ein eigener Gutscheincode. Bitte als eigenen Gutschein einlösen.";
|
|
428
|
+
};
|
|
429
|
+
readonly 'voucher_error.external_duplicate': {
|
|
430
|
+
readonly text: "Diese Gutscheinnummer steht schon auf dem Beleg.";
|
|
431
|
+
};
|
|
417
432
|
readonly 'voucher.type_changed': {
|
|
418
433
|
readonly text: "Diese Gutschein-Sorte hat sich geändert. Bitte die Zeile entfernen und die Kachel neu antippen.";
|
|
419
434
|
};
|
|
@@ -1210,6 +1225,11 @@ export declare const VOUCHER_ERROR_MESSAGES: {
|
|
|
1210
1225
|
readonly voucher_amount_mismatch: "voucher_error.amount_mismatch";
|
|
1211
1226
|
readonly voucher_service_not_allowed: "voucher_error.service_not_allowed";
|
|
1212
1227
|
readonly voucher_payout_not_allowed: "voucher_error.payout_not_allowed";
|
|
1228
|
+
readonly external_voucher_not_enabled: "voucher_error.external_not_enabled";
|
|
1229
|
+
readonly external_voucher_type_not_enabled: "voucher_error.external_type_not_enabled";
|
|
1230
|
+
readonly external_voucher_number_invalid: "voucher_error.external_number_invalid";
|
|
1231
|
+
readonly external_voucher_number_is_own_code: "voucher_error.external_number_is_own_code";
|
|
1232
|
+
readonly external_voucher_duplicate: "voucher_error.external_duplicate";
|
|
1213
1233
|
};
|
|
1214
1234
|
export type VoucherMessageCode = keyof typeof VOUCHER_ERROR_MESSAGES;
|
|
1215
1235
|
/** Der Satz zu einem Gutschein-`code`; `undefined` für jeden anderen Code. */
|
package/dist/cjs/pos/texte.js
CHANGED
|
@@ -226,6 +226,12 @@ const MELDUNGEN_ROH = {
|
|
|
226
226
|
'voucher_error.amount_mismatch': { text: 'Die Gutschein-Sorte hat sich geändert. Die Kasse lädt die Sorten neu.' },
|
|
227
227
|
'voucher_error.service_not_allowed': { text: 'Dieser Artikel ist nicht als Leistungsgutschein freigegeben.' },
|
|
228
228
|
'voucher_error.payout_not_allowed': { text: 'Dieser Gutschein kann nicht ausgezahlt werden.' },
|
|
229
|
+
// Fremdgutscheine (Server 2026-11): Woerter wie gutschein-transaktion.fehlerText im Backend.
|
|
230
|
+
'voucher_error.external_not_enabled': { text: 'Fremde Gutscheine sind für dieses Konto nicht freigegeben.' },
|
|
231
|
+
'voucher_error.external_type_not_enabled': { text: 'Fremde Einzweckgutscheine sind für dieses Konto nicht freigegeben.' },
|
|
232
|
+
'voucher_error.external_number_invalid': { text: 'Gutscheinnummer prüfen: 1 bis 40 Zeichen, nur Buchstaben, Ziffern und - _ . / sind erlaubt.' },
|
|
233
|
+
'voucher_error.external_number_is_own_code': { text: 'Das ist ein eigener Gutscheincode. Bitte als eigenen Gutschein einlösen.' },
|
|
234
|
+
'voucher_error.external_duplicate': { text: 'Diese Gutscheinnummer steht schon auf dem Beleg.' },
|
|
229
235
|
// Satz der Kasse selbst (1.17.0): eine Verkaufszeile im Korb passt nach dem Neuladen der Sorten nicht mehr (Sorte
|
|
230
236
|
// geaendert, deaktiviert oder geloescht). Die Zeile sperrt das Kassieren, bis sie entfernt und neu gewaehlt ist;
|
|
231
237
|
// der Satz nach einer Absage des Servers bleibt voucher_error.type_not_found bzw. voucher_error.amount_mismatch.
|
|
@@ -708,6 +714,11 @@ exports.VOUCHER_ERROR_MESSAGES = {
|
|
|
708
714
|
voucher_amount_mismatch: 'voucher_error.amount_mismatch',
|
|
709
715
|
voucher_service_not_allowed: 'voucher_error.service_not_allowed',
|
|
710
716
|
voucher_payout_not_allowed: 'voucher_error.payout_not_allowed',
|
|
717
|
+
external_voucher_not_enabled: 'voucher_error.external_not_enabled',
|
|
718
|
+
external_voucher_type_not_enabled: 'voucher_error.external_type_not_enabled',
|
|
719
|
+
external_voucher_number_invalid: 'voucher_error.external_number_invalid',
|
|
720
|
+
external_voucher_number_is_own_code: 'voucher_error.external_number_is_own_code',
|
|
721
|
+
external_voucher_duplicate: 'voucher_error.external_duplicate',
|
|
711
722
|
};
|
|
712
723
|
/** Der Satz zu einem Gutschein-`code`; `undefined` für jeden anderen Code. */
|
|
713
724
|
function voucherErrorMessage(code) {
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { ReceiptType, type ReceiptTypeKey, KeckPaymentMethod } from '../enums/index.js';
|
|
2
2
|
import type { ReceiptItem } from '../models/receipt-item.js';
|
|
3
3
|
import type { Voucher } from '../models/voucher.js';
|
|
4
|
-
import type { PosVoucherSettings, VoucherCheck } from '../pos/gutschein.js';
|
|
4
|
+
import type { PosExternalVouchers, PosVoucherSettings, VoucherCheck } from '../pos/gutschein.js';
|
|
5
5
|
import { type VoucherDueArticle, type VoucherDueInfo, type VoucherDueType } from './gutschein-plan.js';
|
|
6
6
|
export { VOUCHER_ZERO_RATE_BUCKET_FROM, type VoucherDueArticle, type VoucherDueInfo, type VoucherDueType } from './gutschein-plan.js';
|
|
7
7
|
/**
|
|
@@ -104,6 +104,13 @@ export interface ReceiptDueOptions {
|
|
|
104
104
|
* einen Wert-Verkauf ohne `typeId` nicht mehr.
|
|
105
105
|
*/
|
|
106
106
|
voucherSettings?: PosVoucherSettings;
|
|
107
|
+
/**
|
|
108
|
+
* Freigabe fuer Fremdgutscheine (`getKasseSettings` `vouchers.externalVouchers`). Bei `off` rechnet ein
|
|
109
|
+
* Fremdgutschein nicht (`external_voucher_not_enabled`), ein fremder Einzweck nur bei `all`
|
|
110
|
+
* (`external_voucher_type_not_enabled`). Ohne Angabe gilt die aus `voucherSettings`; fehlen beide, prueft
|
|
111
|
+
* nur der Server die Freigabe.
|
|
112
|
+
*/
|
|
113
|
+
externalVouchers?: PosExternalVouchers;
|
|
107
114
|
/**
|
|
108
115
|
* Artikel fuer den Verkauf von Dienstleistungsgutscheinen (Preis und Satz,
|
|
109
116
|
* wie im Artikelstamm). Fehlt der verkaufte Artikel hier:
|
package/dist/cjs/receipt/due.js
CHANGED
|
@@ -92,6 +92,7 @@ function rechne(items, vouchers, receiptType, options) {
|
|
|
92
92
|
const plan = (0, gutschein_plan_js_1.planeGutscheine)(positionen, vouchers, art, {
|
|
93
93
|
voucherInfo: options.voucherInfo,
|
|
94
94
|
voucherSettings: options.voucherSettings,
|
|
95
|
+
...(options.externalVouchers !== undefined ? { externalVouchers: options.externalVouchers } : {}),
|
|
95
96
|
voucherTypes: options.voucherTypes,
|
|
96
97
|
voucherArticles: options.voucherArticles,
|
|
97
98
|
smallBusiness: options.smallBusiness,
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { Voucher } from '../models/voucher.js';
|
|
2
|
-
import type { PosVoucherSettings, PosVoucherType, VoucherArticle, VoucherCheck } from '../pos/gutschein.js';
|
|
2
|
+
import type { PosExternalVouchers, PosVoucherSettings, PosVoucherType, VoucherArticle, VoucherCheck } from '../pos/gutschein.js';
|
|
3
3
|
/**
|
|
4
4
|
* Gutscheine der neuen Form im Zahlbetrag: Zwilling von
|
|
5
5
|
* `gutschein-beleg.plane` im Backend, soweit er den Zahlbetrag bestimmt.
|
|
@@ -27,6 +27,11 @@ import type { PosVoucherSettings, PosVoucherType, VoucherArticle, VoucherCheck }
|
|
|
27
27
|
* - Leistung verkaufen: Stueck mal Artikelpreis im Artikelsatz; einloesen: je
|
|
28
28
|
* Satz eine Minuszeile ueber die gewaehlten Positionen.
|
|
29
29
|
* - Aktion: Rabatt wie `promo`, Betrag aus der Pruefung, hoechstens die Summe.
|
|
30
|
+
* - Fremdgutschein (`source: 'external'`, Server 2026-11): dieselbe Strecke
|
|
31
|
+
* wie ein eigener Mehrzweck- bzw. Einzweckgutschein, nur ohne Pruefung und
|
|
32
|
+
* Saldo (verfuegbar ist genau der Betrag des Wunschs); Satz und Vermerk
|
|
33
|
+
* sagt der Wunsch, Satz 0 heisst befreit verkauft. Freigabe aus
|
|
34
|
+
* `externalVouchers` (sonst `voucherSettings.externalVouchers`).
|
|
30
35
|
*
|
|
31
36
|
* Kein Fehler wird still geschluckt: was der Server mit einem Gutschein-Code
|
|
32
37
|
* abwiese, liefert `fehler` mit genau diesem Code (`voucher_*`). Der
|
|
@@ -77,6 +82,11 @@ export declare const VOUCHER_ZERO_RATE_BUCKET_FROM = "2099-12-31";
|
|
|
77
82
|
export interface PlanOptionen {
|
|
78
83
|
voucherInfo?: readonly VoucherDueInfo[];
|
|
79
84
|
voucherSettings?: PosVoucherSettings;
|
|
85
|
+
/**
|
|
86
|
+
* Freigabe fuer Fremdgutscheine des Kontos; ohne Angabe die aus `voucherSettings`. Fehlen beide, prueft nur
|
|
87
|
+
* der Server die Freigabe.
|
|
88
|
+
*/
|
|
89
|
+
externalVouchers?: PosExternalVouchers;
|
|
80
90
|
voucherTypes?: readonly VoucherDueType[];
|
|
81
91
|
voucherArticles?: readonly VoucherDueArticle[];
|
|
82
92
|
smallBusiness?: boolean;
|