@kreiseck/kasseneck-api 1.29.0 → 1.31.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 +33 -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 +15 -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 +12 -2
- package/dist/cjs/models/voucher.d.ts +96 -2
- package/dist/cjs/models/voucher.js +158 -5
- package/dist/cjs/pos/artikel.d.ts +12 -0
- package/dist/cjs/pos/artikel.js +2 -0
- package/dist/cjs/pos/client.js +11 -0
- package/dist/cjs/pos/errors.d.ts +1 -1
- package/dist/cjs/pos/errors.js +1 -0
- package/dist/cjs/pos/fremdgutschein-artikel.d.ts +66 -0
- package/dist/cjs/pos/fremdgutschein-artikel.js +74 -0
- package/dist/cjs/pos/gutschein.d.ts +13 -0
- package/dist/cjs/pos/gutschein.js +5 -1
- package/dist/cjs/pos/index.d.ts +7 -4
- package/dist/cjs/pos/index.js +43 -4
- package/dist/cjs/pos/rabatt-vorlagen.d.ts +79 -0
- package/dist/cjs/pos/rabatt-vorlagen.js +156 -0
- package/dist/cjs/pos/schicht-lesen.js +8 -0
- package/dist/cjs/pos/schicht-typen.d.ts +15 -0
- package/dist/cjs/pos/settings.d.ts +69 -3
- package/dist/cjs/pos/settings.js +72 -5
- package/dist/cjs/pos/texte.d.ts +235 -0
- package/dist/cjs/pos/texte.js +135 -1
- package/dist/cjs/pos/zusaetze.d.ts +3 -3
- package/dist/cjs/pos/zusaetze.js +4 -2
- 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/receipt/shift-sheet.js +8 -0
- package/dist/cjs/stored/draht.js +6 -0
- package/dist/cjs/stored/einstellungen.js +50 -2
- package/dist/cjs/stored/vokabular.d.ts +3 -1
- package/dist/cjs/stored/vokabular.js +52 -5
- 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 +96 -2
- package/dist/esm/models/voucher.js +152 -4
- package/dist/esm/pos/artikel.d.ts +12 -0
- package/dist/esm/pos/artikel.js +2 -0
- package/dist/esm/pos/client.js +12 -1
- package/dist/esm/pos/errors.d.ts +1 -1
- package/dist/esm/pos/errors.js +1 -0
- package/dist/esm/pos/fremdgutschein-artikel.d.ts +66 -0
- package/dist/esm/pos/fremdgutschein-artikel.js +67 -0
- package/dist/esm/pos/gutschein.d.ts +13 -0
- package/dist/esm/pos/gutschein.js +4 -0
- package/dist/esm/pos/index.d.ts +7 -4
- package/dist/esm/pos/index.js +8 -4
- package/dist/esm/pos/rabatt-vorlagen.d.ts +79 -0
- package/dist/esm/pos/rabatt-vorlagen.js +148 -0
- package/dist/esm/pos/schicht-lesen.js +8 -0
- package/dist/esm/pos/schicht-typen.d.ts +15 -0
- package/dist/esm/pos/settings.d.ts +69 -3
- package/dist/esm/pos/settings.js +67 -4
- package/dist/esm/pos/texte.d.ts +235 -0
- package/dist/esm/pos/texte.js +133 -0
- package/dist/esm/pos/zusaetze.d.ts +3 -3
- package/dist/esm/pos/zusaetze.js +4 -2
- 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/receipt/shift-sheet.js +8 -0
- package/dist/esm/stored/draht.js +7 -1
- package/dist/esm/stored/einstellungen.js +52 -4
- package/dist/esm/stored/vokabular.d.ts +3 -1
- package/dist/esm/stored/vokabular.js +51 -4
- package/dist/esm/version.d.ts +1 -1
- package/dist/esm/version.js +1 -1
- package/fixtures/add-on-cases.json +6 -4
- package/fixtures/discount-preset-cases.json +1074 -0
- 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/external-voucher-article-cases.json +311 -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 +226 -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/renames-1.0.json +18 -0
- package/fixtures/stored/voucher-cases.json +2800 -0
- package/fixtures/surface.json +62 -5
- 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 +262 -15
- package/fixtures/v3/zahlbetrag-faelle.json +2 -2
- package/package.json +1 -1
package/dist/cjs/models/index.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.
|
|
4
|
-
exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isManualReceiptErrorCode = exports.MANUAL_RECEIPT_ERROR_CODES = exports.readManualReceipt = exports.MANUAL_RECEIPT_REASONS = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.receiptOutputFieldErrors = exports.isReceiptOutputError = exports.receiptOutputErrorCode = exports.isReceiptOutputErrorCode = exports.RECEIPT_OUTPUT_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRY_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRIES_MAX = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_LOG_KINDS = exports.RECEIPT_OUTPUT_KINDS = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = void 0;
|
|
3
|
+
exports.fromReceiptPaymentPayload = exports.asksRefundTip = exports.asksTipRefundSource = exports.cancellationCashRefundCents = exports.cancellationItemsForTip = exports.openStaffTipCents = exports.isTipRefundSource = exports.TIP_REFUND_SOURCES = exports.remainingQuantities = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptValueVoucherSign = exports.receiptSumCents = exports.receiptSubSumCents = exports.readRegistrationInfo = exports.fromReceiptPayload = exports.toReceiptPayload = exports.EXTERNAL_VOUCHER_VAT_RATES_BP = exports.EXTERNAL_VOUCHER_TAXED_WITH_MAX = exports.EXTERNAL_VOUCHER_NUMBER_MAX = exports.OWN_VOUCHER_CODE_SHAPES = exports.ownVoucherCodeShape = exports.checkExternalVoucherNumber = exports.normalizeExternalVoucherNumber = exports.externalVoucherIsValid = exports.isExternalVoucher = exports.VOUCHER_SOURCES = exports.voucherServerFields = exports.isNewFormVoucher = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isVoucherFloatItem = exports.isVoucherItem = exports.isDiscountItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = void 0;
|
|
4
|
+
exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isManualReceiptErrorCode = exports.MANUAL_RECEIPT_ERROR_CODES = exports.readManualReceipt = exports.MANUAL_RECEIPT_REASONS = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.receiptOutputFieldErrors = exports.isReceiptOutputError = exports.receiptOutputErrorCode = exports.isReceiptOutputErrorCode = exports.RECEIPT_OUTPUT_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRY_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRIES_MAX = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_LOG_KINDS = exports.RECEIPT_OUTPUT_KINDS = exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = void 0;
|
|
5
5
|
var receipt_item_js_1 = require("./receipt-item.js");
|
|
6
6
|
Object.defineProperty(exports, "toReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.toReceiptItemPayload; } });
|
|
7
7
|
Object.defineProperty(exports, "fromReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.fromReceiptItemPayload; } });
|
|
@@ -18,6 +18,16 @@ Object.defineProperty(exports, "fromVoucherPayload", { enumerable: true, get: fu
|
|
|
18
18
|
Object.defineProperty(exports, "voucherIsValid", { enumerable: true, get: function () { return voucher_js_1.voucherIsValid; } });
|
|
19
19
|
Object.defineProperty(exports, "isNewFormVoucher", { enumerable: true, get: function () { return voucher_js_1.isNewFormVoucher; } });
|
|
20
20
|
Object.defineProperty(exports, "voucherServerFields", { enumerable: true, get: function () { return voucher_js_1.voucherServerFields; } });
|
|
21
|
+
Object.defineProperty(exports, "VOUCHER_SOURCES", { enumerable: true, get: function () { return voucher_js_1.VOUCHER_SOURCES; } });
|
|
22
|
+
Object.defineProperty(exports, "isExternalVoucher", { enumerable: true, get: function () { return voucher_js_1.isExternalVoucher; } });
|
|
23
|
+
Object.defineProperty(exports, "externalVoucherIsValid", { enumerable: true, get: function () { return voucher_js_1.externalVoucherIsValid; } });
|
|
24
|
+
Object.defineProperty(exports, "normalizeExternalVoucherNumber", { enumerable: true, get: function () { return voucher_js_1.normalizeExternalVoucherNumber; } });
|
|
25
|
+
Object.defineProperty(exports, "checkExternalVoucherNumber", { enumerable: true, get: function () { return voucher_js_1.checkExternalVoucherNumber; } });
|
|
26
|
+
Object.defineProperty(exports, "ownVoucherCodeShape", { enumerable: true, get: function () { return voucher_js_1.ownVoucherCodeShape; } });
|
|
27
|
+
Object.defineProperty(exports, "OWN_VOUCHER_CODE_SHAPES", { enumerable: true, get: function () { return voucher_js_1.OWN_VOUCHER_CODE_SHAPES; } });
|
|
28
|
+
Object.defineProperty(exports, "EXTERNAL_VOUCHER_NUMBER_MAX", { enumerable: true, get: function () { return voucher_js_1.EXTERNAL_VOUCHER_NUMBER_MAX; } });
|
|
29
|
+
Object.defineProperty(exports, "EXTERNAL_VOUCHER_TAXED_WITH_MAX", { enumerable: true, get: function () { return voucher_js_1.EXTERNAL_VOUCHER_TAXED_WITH_MAX; } });
|
|
30
|
+
Object.defineProperty(exports, "EXTERNAL_VOUCHER_VAT_RATES_BP", { enumerable: true, get: function () { return voucher_js_1.EXTERNAL_VOUCHER_VAT_RATES_BP; } });
|
|
21
31
|
var receipt_js_1 = require("./receipt.js");
|
|
22
32
|
Object.defineProperty(exports, "toReceiptPayload", { enumerable: true, get: function () { return receipt_js_1.toReceiptPayload; } });
|
|
23
33
|
Object.defineProperty(exports, "fromReceiptPayload", { enumerable: true, get: function () { return receipt_js_1.fromReceiptPayload; } });
|
|
@@ -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,61 @@ 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
|
+
* Wie sehr eine Eingabe einem eigenen Gutscheincode gleicht ([ownVoucherCodeShape]): `valid` = gueltiger eigener
|
|
247
|
+
* Code; `checksum` = 12 Zeichen des Code-Alphabets mit falschem Pruefzeichen (z. B. eine zwoelfstellige
|
|
248
|
+
* Webshop-Nummer); `length` = Muster `4-4-x` mit echten Bindestrichen `-` (nie `.`, `_`, `/`), aber nicht 12 Zeichen;
|
|
249
|
+
* `none` = keine Aehnlichkeit.
|
|
250
|
+
*/
|
|
251
|
+
export type OwnVoucherCodeShape = 'valid' | 'checksum' | 'length' | 'none';
|
|
252
|
+
export declare const OWN_VOUCHER_CODE_SHAPES: readonly OwnVoucherCodeShape[];
|
|
253
|
+
/**
|
|
254
|
+
* Form-Erkennung eigener Codes fuer das Feld „Code eingeben oder scannen“ (Web-Kasse und Kassen-App gleich):
|
|
255
|
+
* `valid` laeuft als eigener Gutschein, `checksum`/`length` fragt die Kasse nach („Sieht aus wie ein
|
|
256
|
+
* Kasseneck-Code, ist aber keiner. Als fremden Gutschein verwenden?“, `external_voucher.looks_like_own_code`),
|
|
257
|
+
* `none` geht bei Freigabe direkt in das Blatt „Fremder Gutschein“. Gelesen wie [checkExternalVoucherNumber]:
|
|
258
|
+
* Rand weg, `.`, `_`, `/` wie `-`, dann die Normalisierung von `VoucherCode` (gross, ohne Leerraum und `-`,
|
|
259
|
+
* O → 0, I/L → 1); `length` nur mit echten Bindestrichen. Eine Nachfrage weist nichts ab: der Server prueft die Fremdnummer selbst
|
|
260
|
+
* (`external_voucher_number_is_own_code` nur bei `valid`).
|
|
261
|
+
*/
|
|
262
|
+
export declare function ownVoucherCodeShape(text: unknown): OwnVoucherCodeShape;
|
|
263
|
+
/**
|
|
264
|
+
* Ist der Fremdgutschein sendbar? Die Form wie `gutschein-beleg.pruefeFremd` (ohne die Freigabe des Kontos, die
|
|
265
|
+
* kennt nur der Server bzw. `PosVoucherSettings.externalVouchers`): Aktion `sell`/`redeem`/`payout`, Art
|
|
266
|
+
* `multi_purpose`/`single_purpose`, gueltige Nummer (kein eigener Code), Betrag 1 bis 1.000.000 Cent; Einzweck mit
|
|
267
|
+
* einem Satz aus [EXTERNAL_VOUCHER_VAT_RATES_BP], Mehrzweck ohne; `taxedWith` nur bei Einzweck-Einloesung bzw.
|
|
268
|
+
* -Auszahlung (1 bis 40 Zeichen ohne Steuerzeichen); Auszahlung mit Grund (1 bis 200 Zeichen). Felder eigener
|
|
269
|
+
* Gutscheine (Code, Sorte, Artikel, Menge, Positionen) und Serverfelder nie.
|
|
270
|
+
*/
|
|
271
|
+
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.OWN_VOUCHER_CODE_SHAPES = 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,12 @@ 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.ownVoucherCodeShape = ownVoucherCodeShape;
|
|
15
|
+
exports.externalVoucherIsValid = externalVoucherIsValid;
|
|
11
16
|
const index_js_1 = require("../enums/index.js");
|
|
17
|
+
const validator_1 = require("@kreiseck/validator");
|
|
12
18
|
const money_js_1 = require("../money.js");
|
|
13
19
|
const enum_payload_js_1 = require("./enum-payload.js");
|
|
14
20
|
/** Arten der neuen Gutscheinform (die Altwerte sind `value` und `promo`). */
|
|
@@ -18,6 +24,11 @@ exports.NEUE_GUTSCHEINARTEN = [
|
|
|
18
24
|
index_js_1.VoucherType.service,
|
|
19
25
|
index_js_1.VoucherType.promotion,
|
|
20
26
|
];
|
|
27
|
+
exports.VOUCHER_SOURCES = Object.freeze(['external']);
|
|
28
|
+
/** Fremdgutschein (`source: 'external'`)? Zwilling von `gutschein-beleg.istFremd`. */
|
|
29
|
+
function isExternalVoucher(voucher) {
|
|
30
|
+
return voucher.source === 'external';
|
|
31
|
+
}
|
|
21
32
|
/**
|
|
22
33
|
* Verkauf ueber eine Sorte ohne Art (`typeId` ohne `type`): die Art kommt aus
|
|
23
34
|
* der Sorte. Zwilling von `gutschein-beleg.istSortenVerkauf`.
|
|
@@ -27,7 +38,8 @@ function istSortenVerkaufOhneArt(voucher) {
|
|
|
27
38
|
}
|
|
28
39
|
/** Gehoert der Gutschein zur neuen Form (Art, Aktion `payout` oder Verkauf ueber eine Sorte ohne Art)? */
|
|
29
40
|
function isNewFormVoucher(voucher) {
|
|
30
|
-
return exports.NEUE_GUTSCHEINARTEN.includes(voucher.type) || voucher.action === index_js_1.VoucherAction.payout || istSortenVerkaufOhneArt(voucher)
|
|
41
|
+
return exports.NEUE_GUTSCHEINARTEN.includes(voucher.type) || voucher.action === index_js_1.VoucherAction.payout || istSortenVerkaufOhneArt(voucher)
|
|
42
|
+
|| isExternalVoucher(voucher);
|
|
31
43
|
}
|
|
32
44
|
/**
|
|
33
45
|
* Wert-Verkauf: ein Mehrzweck- oder Einzweckgutschein wird verkauft (mit Art
|
|
@@ -35,7 +47,7 @@ function isNewFormVoucher(voucher) {
|
|
|
35
47
|
* Senden entscheiden daran, ob eine Sorte noetig ist.
|
|
36
48
|
*/
|
|
37
49
|
function istWertVerkauf(voucher) {
|
|
38
|
-
return voucher.action === index_js_1.VoucherAction.sell
|
|
50
|
+
return !isExternalVoucher(voucher) && voucher.action === index_js_1.VoucherAction.sell
|
|
39
51
|
&& (voucher.type === index_js_1.VoucherType.multi_purpose || voucher.type === index_js_1.VoucherType.single_purpose || istSortenVerkaufOhneArt(voucher));
|
|
40
52
|
}
|
|
41
53
|
/**
|
|
@@ -48,7 +60,7 @@ function voucherServerFields(voucher) {
|
|
|
48
60
|
return exports.GUTSCHEIN_SERVERFELDER.filter((feld) => voucher[feld] != null);
|
|
49
61
|
}
|
|
50
62
|
const NEUE_FELDER = [
|
|
51
|
-
'amountCents', 'articleId', 'quantity', 'positions', 'reason', 'typeId', 'typeName', 'payout', 'voucherType', 'voucherId', 'codeSuffix',
|
|
63
|
+
'source', 'number', 'amountCents', 'articleId', 'quantity', 'positions', 'reason', 'typeId', 'typeName', 'payout', 'voucherType', 'voucherId', 'codeSuffix',
|
|
52
64
|
'vatRateBp', 'article', 'balanceAfterCents', 'remainingQuantityAfter', 'taxedWith', 'exempt', 'zeroRateBucket', 'fromReturn',
|
|
53
65
|
];
|
|
54
66
|
function toVoucherPayload(voucher) {
|
|
@@ -81,6 +93,8 @@ function toVoucherPayload(voucher) {
|
|
|
81
93
|
* gesetzter Wert muss positiv sein.
|
|
82
94
|
*/
|
|
83
95
|
function voucherIsValid(voucher) {
|
|
96
|
+
if (isExternalVoucher(voucher))
|
|
97
|
+
return externalVoucherIsValid(voucher);
|
|
84
98
|
if (isNewFormVoucher(voucher))
|
|
85
99
|
return newFormVoucherIsValid(voucher);
|
|
86
100
|
if (voucher.type === index_js_1.VoucherType.value && voucher.valueCents == null) {
|
|
@@ -170,13 +184,21 @@ function newFormVoucherIsValid(v) {
|
|
|
170
184
|
* Stufe 4b antwortet darauf `voucher_type_required`). Paketintern.
|
|
171
185
|
*/
|
|
172
186
|
function wunschFormGueltig(v, sorteNoetig) {
|
|
187
|
+
if (isExternalVoucher(v))
|
|
188
|
+
return externalVoucherIsValid(v);
|
|
173
189
|
if (voucherServerFields(v).length > 0)
|
|
174
190
|
return false;
|
|
175
191
|
const r = v;
|
|
176
|
-
for (const feld of ['
|
|
192
|
+
for (const feld of ['article', 'balanceAfterCents', 'remainingQuantityAfter', 'exempt']) {
|
|
177
193
|
if (r[feld] != null)
|
|
178
194
|
return false;
|
|
179
195
|
}
|
|
196
|
+
// Felder nur des Fremdgutscheins (gutschein-beleg.NUR_BEI_FREMD): der Server weist sie an einem eigenen Wunsch
|
|
197
|
+
// schon gesendet ab, auch als `null` (`voucher_invalid`); eine andere Herkunft als `external` gibt es nicht.
|
|
198
|
+
for (const feld of ['number', 'taxedWith', 'vatRateBp', 'source']) {
|
|
199
|
+
if (r[feld] !== undefined)
|
|
200
|
+
return false;
|
|
201
|
+
}
|
|
180
202
|
if (v.valueCents != null)
|
|
181
203
|
return false;
|
|
182
204
|
// Die Sorte gehoert nur an einen Wert-Verkauf (Server: sorteId sonst voucher_invalid).
|
|
@@ -220,3 +242,134 @@ function wunschFormGueltig(v, sorteNoetig) {
|
|
|
220
242
|
// Altart mit neuer Aktion (payout + value/promo): nicht sendbar.
|
|
221
243
|
return false;
|
|
222
244
|
}
|
|
245
|
+
// ---- Fremdgutscheine (Server 2026-11) -------------------------------------------
|
|
246
|
+
/**
|
|
247
|
+
* Rand einer Fremdnummer (Zwilling von `gutschein-core.FREMD_RAND`): ASCII-Leerraum und die Unicode-Leerzeichen,
|
|
248
|
+
* die beim Kopieren aus Fremdsystemen mitkommen. Bewusst ohne U+0085 (NEL): ein Steuerzeichen, das nie still
|
|
249
|
+
* verschwindet, sondern die Nummer ungueltig macht.
|
|
250
|
+
*/
|
|
251
|
+
const FREMD_RAND = '\\t\\n\\v\\f\\r \\u00A0\\u1680\\u2000-\\u200A\\u2028\\u2029\\u202F\\u205F\\u3000\\uFEFF';
|
|
252
|
+
const FREMD_RAND_MUSTER = new RegExp(`^[${FREMD_RAND}]+|[${FREMD_RAND}]+$`, 'g');
|
|
253
|
+
const FREMD_NUMMER_MUSTER = /^[A-Za-z0-9\-_./]{1,40}$/;
|
|
254
|
+
/** Hoechstlaenge der Nummer eines Fremdgutscheins (nach dem Abschneiden des Rands). */
|
|
255
|
+
exports.EXTERNAL_VOUCHER_NUMBER_MAX = 40;
|
|
256
|
+
/** Hoechstlaenge von `taxedWith` (Vermerk, mit welchem Beleg im fremden System der Einzweckgutschein versteuert ist). */
|
|
257
|
+
exports.EXTERNAL_VOUCHER_TAXED_WITH_MAX = 40;
|
|
258
|
+
/**
|
|
259
|
+
* Saetze, mit denen ein fremder Einzweckgutschein verkauft sein kann (Basispunkte): die Saetze der Kasse
|
|
260
|
+
* (20, 10, 13, 19, 4,9 %) und 0 = befreit verkauft (Kleinunternehmer).
|
|
261
|
+
*/
|
|
262
|
+
exports.EXTERNAL_VOUCHER_VAT_RATES_BP = Object.freeze([2000, 1000, 1300, 1900, 490, 0]);
|
|
263
|
+
/**
|
|
264
|
+
* Nummer eines Fremdgutscheins in der Form, mit der der Server sie speichert und druckt
|
|
265
|
+
* (`gutschein-core.normiereFremdnummer`): Rand weg, **keine** Unicode-Normalisierung, Gross-/Kleinschreibung
|
|
266
|
+
* bleibt; dann 1 bis 40 Zeichen aus `A–Z a–z 0–9 - _ . /`. Sonst `null` (`external_voucher_number_invalid`).
|
|
267
|
+
* Einen eigenen Gutscheincode erkennt erst [checkExternalVoucherNumber].
|
|
268
|
+
*/
|
|
269
|
+
function normalizeExternalVoucherNumber(text) {
|
|
270
|
+
if (typeof text !== 'string')
|
|
271
|
+
return null;
|
|
272
|
+
const n = text.replace(FREMD_RAND_MUSTER, '');
|
|
273
|
+
return FREMD_NUMMER_MUSTER.test(n) ? n : null;
|
|
274
|
+
}
|
|
275
|
+
/**
|
|
276
|
+
* Prueft eine Fremdnummer in der Reihenfolge des Servers (`gutschein-beleg.pruefeFremd`): zuerst, ob sie ein
|
|
277
|
+
* gueltiger eigener Gutscheincode ist (12 Zeichen mit Pruefzeichen, in jeder Schreibweise der Kasse, auch mit `.`, `_`
|
|
278
|
+
* oder `/` als Trenner) – dann
|
|
279
|
+
* `external_voucher_number_is_own_code`, der Gutschein gehoert als eigener eingeloest –, danach die Form.
|
|
280
|
+
*/
|
|
281
|
+
function checkExternalVoucherNumber(text) {
|
|
282
|
+
// `.`, `_` und `/` zwischen den Gruppen liest die Pruefung wie `-` (Zwilling von `gutschein-core.istEigenerCode`):
|
|
283
|
+
// `7148.FGQA.935K` ist der eigene Code. Die Nummer selbst bleibt, wie sie kam.
|
|
284
|
+
if (typeof text === 'string' && validator_1.VoucherCode.validate(text.replace(/[._/]/g, '-')).ok)
|
|
285
|
+
return { ok: false, code: 'external_voucher_number_is_own_code' };
|
|
286
|
+
const number = normalizeExternalVoucherNumber(text);
|
|
287
|
+
return number === null ? { ok: false, code: 'external_voucher_number_invalid' } : { ok: true, number };
|
|
288
|
+
}
|
|
289
|
+
exports.OWN_VOUCHER_CODE_SHAPES = Object.freeze(['valid', 'checksum', 'length', 'none']);
|
|
290
|
+
/** Alphabet der eigenen Codes (Crockford-Base32 ohne U), nach der Normalisierung von `VoucherCode`. */
|
|
291
|
+
const CODE_ALPHABET = /^[0-9A-HJKMNP-TV-Z]+$/;
|
|
292
|
+
const CODE_GRUPPEN = /^[0-9A-Za-z]{4}-[0-9A-Za-z]{4}-[0-9A-Za-z]+$/;
|
|
293
|
+
/**
|
|
294
|
+
* Form-Erkennung eigener Codes fuer das Feld „Code eingeben oder scannen“ (Web-Kasse und Kassen-App gleich):
|
|
295
|
+
* `valid` laeuft als eigener Gutschein, `checksum`/`length` fragt die Kasse nach („Sieht aus wie ein
|
|
296
|
+
* Kasseneck-Code, ist aber keiner. Als fremden Gutschein verwenden?“, `external_voucher.looks_like_own_code`),
|
|
297
|
+
* `none` geht bei Freigabe direkt in das Blatt „Fremder Gutschein“. Gelesen wie [checkExternalVoucherNumber]:
|
|
298
|
+
* Rand weg, `.`, `_`, `/` wie `-`, dann die Normalisierung von `VoucherCode` (gross, ohne Leerraum und `-`,
|
|
299
|
+
* O → 0, I/L → 1); `length` nur mit echten Bindestrichen. Eine Nachfrage weist nichts ab: der Server prueft die Fremdnummer selbst
|
|
300
|
+
* (`external_voucher_number_is_own_code` nur bei `valid`).
|
|
301
|
+
*/
|
|
302
|
+
function ownVoucherCodeShape(text) {
|
|
303
|
+
if (typeof text !== 'string')
|
|
304
|
+
return 'none';
|
|
305
|
+
const roh = text.replace(FREMD_RAND_MUSTER, '');
|
|
306
|
+
const t = roh.replace(/[._/]/g, '-');
|
|
307
|
+
if (t === '')
|
|
308
|
+
return 'none';
|
|
309
|
+
if (validator_1.VoucherCode.validate(t).ok)
|
|
310
|
+
return 'valid';
|
|
311
|
+
const s = t.toUpperCase().replace(/[\s-]/g, '').replace(/O/g, '0').replace(/[IL]/g, '1');
|
|
312
|
+
if (!CODE_ALPHABET.test(s))
|
|
313
|
+
return 'none';
|
|
314
|
+
if (s.length === 12)
|
|
315
|
+
return 'checksum';
|
|
316
|
+
// Falsche Laenge nur mit echten Bindestrichen: eigene Codes stehen immer so da, `WEIN.2026/7` ist keiner.
|
|
317
|
+
return CODE_GRUPPEN.test(roh) ? 'length' : 'none';
|
|
318
|
+
}
|
|
319
|
+
/** Steuer- und Formatzeichen (`gutschein-core.STEUERZEICHEN`): nie in `taxedWith`. */
|
|
320
|
+
const STEUERZEICHEN = /[\p{Cc}\p{Cf}]/u;
|
|
321
|
+
/**
|
|
322
|
+
* Ist der Fremdgutschein sendbar? Die Form wie `gutschein-beleg.pruefeFremd` (ohne die Freigabe des Kontos, die
|
|
323
|
+
* kennt nur der Server bzw. `PosVoucherSettings.externalVouchers`): Aktion `sell`/`redeem`/`payout`, Art
|
|
324
|
+
* `multi_purpose`/`single_purpose`, gueltige Nummer (kein eigener Code), Betrag 1 bis 1.000.000 Cent; Einzweck mit
|
|
325
|
+
* einem Satz aus [EXTERNAL_VOUCHER_VAT_RATES_BP], Mehrzweck ohne; `taxedWith` nur bei Einzweck-Einloesung bzw.
|
|
326
|
+
* -Auszahlung (1 bis 40 Zeichen ohne Steuerzeichen); Auszahlung mit Grund (1 bis 200 Zeichen). Felder eigener
|
|
327
|
+
* Gutscheine (Code, Sorte, Artikel, Menge, Positionen) und Serverfelder nie.
|
|
328
|
+
*/
|
|
329
|
+
function externalVoucherIsValid(voucher) {
|
|
330
|
+
const v = voucher;
|
|
331
|
+
if (!isExternalVoucher(v))
|
|
332
|
+
return false;
|
|
333
|
+
if (voucherServerFields(v).length > 0)
|
|
334
|
+
return false;
|
|
335
|
+
const r = v;
|
|
336
|
+
// gutschein-beleg.NICHT_BEI_FREMD (gesendet heisst voucher_invalid, auch als null).
|
|
337
|
+
for (const feld of ['code', 'typeId', 'articleId', 'article', 'quantity', 'positions']) {
|
|
338
|
+
if (r[feld] !== undefined)
|
|
339
|
+
return false;
|
|
340
|
+
}
|
|
341
|
+
for (const feld of ['balanceAfterCents', 'remainingQuantityAfter', 'exempt']) {
|
|
342
|
+
if (r[feld] != null)
|
|
343
|
+
return false;
|
|
344
|
+
}
|
|
345
|
+
if (v.valueCents != null)
|
|
346
|
+
return false;
|
|
347
|
+
if (v.action !== index_js_1.VoucherAction.sell && v.action !== index_js_1.VoucherAction.redeem && v.action !== index_js_1.VoucherAction.payout)
|
|
348
|
+
return false;
|
|
349
|
+
if (v.type !== index_js_1.VoucherType.multi_purpose && v.type !== index_js_1.VoucherType.single_purpose)
|
|
350
|
+
return false;
|
|
351
|
+
if (!checkExternalVoucherNumber(v.number).ok)
|
|
352
|
+
return false;
|
|
353
|
+
if (!istCent(v.amountCents))
|
|
354
|
+
return false;
|
|
355
|
+
if (v.type === index_js_1.VoucherType.single_purpose) {
|
|
356
|
+
if (!(typeof v.vatRateBp === 'number' && exports.EXTERNAL_VOUCHER_VAT_RATES_BP.includes(v.vatRateBp)))
|
|
357
|
+
return false;
|
|
358
|
+
}
|
|
359
|
+
else if (v.vatRateBp != null) {
|
|
360
|
+
return false;
|
|
361
|
+
}
|
|
362
|
+
if (v.taxedWith != null) {
|
|
363
|
+
if (v.type !== index_js_1.VoucherType.single_purpose || v.action === index_js_1.VoucherAction.sell)
|
|
364
|
+
return false;
|
|
365
|
+
const t = typeof v.taxedWith === 'string' ? v.taxedWith.trim() : '';
|
|
366
|
+
if (t.length < 1 || t.length > exports.EXTERNAL_VOUCHER_TAXED_WITH_MAX || STEUERZEICHEN.test(t))
|
|
367
|
+
return false;
|
|
368
|
+
}
|
|
369
|
+
if (v.action === index_js_1.VoucherAction.payout) {
|
|
370
|
+
const g = typeof v.reason === 'string' ? v.reason.trim() : '';
|
|
371
|
+
if (g.length < 1 || g.length > MAX_GRUND)
|
|
372
|
+
return false;
|
|
373
|
+
}
|
|
374
|
+
return true;
|
|
375
|
+
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { InternerTransport } from '../client/aufrufe.js';
|
|
2
2
|
import { type PosReference } from './kachel-referenz.js';
|
|
3
|
+
import { type ArticleExternalVoucher } from './fremdgutschein-artikel.js';
|
|
3
4
|
/**
|
|
4
5
|
* Artikelgruppen (Kategorien der Kachel-Kasse) und Artikel in der Form, die
|
|
5
6
|
* die Kacheln brauchen, Backend: `article-endpoints.js`
|
|
@@ -121,6 +122,16 @@ export interface PosArticle {
|
|
|
121
122
|
* immer; wirksam wird es ueber [addOnsFor].
|
|
122
123
|
*/
|
|
123
124
|
addOns?: string[] | null;
|
|
125
|
+
/**
|
|
126
|
+
* Kachel verkauft einen fremden Gutschein (1.31.0): `multi_purpose` =
|
|
127
|
+
* Wertgutschein, `single_purpose` = Leistungsgutschein mit dem Satz des
|
|
128
|
+
* Artikels; null = normaler Artikel. Die Kasse fragt die Gutscheinnummer ab
|
|
129
|
+
* und sendet einen `vouchers[]`-Eintrag statt einer Position; sperren ueber
|
|
130
|
+
* [externalVoucherTileBlock]. Vor `stockTracked` werten (ein Fremdgutschein
|
|
131
|
+
* fuehrt nie Bestand). Optional wie `addOns`, der Leser setzt es immer; ein
|
|
132
|
+
* unbekannter Wert wird null.
|
|
133
|
+
*/
|
|
134
|
+
externalVoucher?: ArticleExternalVoucher | null;
|
|
124
135
|
}
|
|
125
136
|
/**
|
|
126
137
|
* Kann die Kachel gebucht werden? Mit festem Preis immer, ohne Preis nur mit
|
|
@@ -161,6 +172,7 @@ export interface PosArticlePayload {
|
|
|
161
172
|
askPrice?: boolean | null;
|
|
162
173
|
reference?: unknown;
|
|
163
174
|
addOns?: unknown;
|
|
175
|
+
externalVoucher?: unknown;
|
|
164
176
|
}
|
|
165
177
|
export declare function fromPosArticlePayload(p: PosArticlePayload): PosArticle;
|
|
166
178
|
/**
|
package/dist/cjs/pos/artikel.js
CHANGED
|
@@ -14,6 +14,7 @@ exports.listMyArticleGroups = listMyArticleGroups;
|
|
|
14
14
|
exports.listMyArticles = listMyArticles;
|
|
15
15
|
const errors_js_1 = require("../client/errors.js");
|
|
16
16
|
const kachel_referenz_js_1 = require("./kachel-referenz.js");
|
|
17
|
+
const fremdgutschein_artikel_js_1 = require("./fremdgutschein-artikel.js");
|
|
17
18
|
/** Zusatzliste am Draht: nur eine Liste von Texten zaehlt, sonst null. Paketintern. */
|
|
18
19
|
function addOnListe(wert) {
|
|
19
20
|
return Array.isArray(wert) ? wert.filter((s) => typeof s === 'string' && s !== '') : null;
|
|
@@ -106,6 +107,7 @@ function fromPosArticlePayload(p) {
|
|
|
106
107
|
askPrice: p.askPrice === true,
|
|
107
108
|
reference: (0, kachel_referenz_js_1.fromReferencePayload)(p.reference),
|
|
108
109
|
addOns: addOnListe(p.addOns),
|
|
110
|
+
externalVoucher: (0, fremdgutschein_artikel_js_1.isArticleExternalVoucher)(p.externalVoucher) ? p.externalVoucher : null,
|
|
109
111
|
};
|
|
110
112
|
}
|
|
111
113
|
/**
|
package/dist/cjs/pos/client.js
CHANGED
|
@@ -7,6 +7,7 @@ exports.setMyRegisterDeviceSettings = setMyRegisterDeviceSettings;
|
|
|
7
7
|
exports.setMyPosLogo = setMyPosLogo;
|
|
8
8
|
const errors_js_1 = require("../client/errors.js");
|
|
9
9
|
const gutschein_js_1 = require("./gutschein.js");
|
|
10
|
+
const rabatt_vorlagen_js_1 = require("./rabatt-vorlagen.js");
|
|
10
11
|
const settings_js_1 = require("./settings.js");
|
|
11
12
|
/*
|
|
12
13
|
* Die Einstellungs-Aufrufe am Draht `/api/v3`: Parameter und Antwort heissen
|
|
@@ -151,6 +152,16 @@ function pruefeTeil(name, teil, block, standard, werte) {
|
|
|
151
152
|
throw new errors_js_1.KasseneckValidationError(name, `${teil}.${schluessel}: true oder false erwartet`, 'request');
|
|
152
153
|
continue;
|
|
153
154
|
}
|
|
155
|
+
// Rabatt-Vorlagen: dieselbe Pruefung wie am Server, der erste Fehler mit Vorlage, Feld und Satz.
|
|
156
|
+
if (teil === 'business' && settings_js_1.POS_BUSINESS_OPTIONAL_LISTS.includes(schluessel)) {
|
|
157
|
+
const geprueft = (0, rabatt_vorlagen_js_1.checkDiscountPresets)(wert);
|
|
158
|
+
if (!geprueft.ok) {
|
|
159
|
+
const f = geprueft.errors[0];
|
|
160
|
+
const ort = `${teil}.${schluessel}${f.index === null ? '' : `[${f.index}]`}${f.field === null ? '' : `.${f.field}`}`;
|
|
161
|
+
throw new errors_js_1.KasseneckValidationError(name, `${ort}: ${f.message} (${rabatt_vorlagen_js_1.INVALID_DISCOUNT_PRESET})`, 'request');
|
|
162
|
+
}
|
|
163
|
+
continue;
|
|
164
|
+
}
|
|
154
165
|
const wahl = teil === 'business' ? settings_js_1.POS_BUSINESS_OPTIONAL_CHOICES : settings_js_1.POS_DEVICE_OPTIONAL_CHOICES;
|
|
155
166
|
if (!Object.prototype.hasOwnProperty.call(standard, schluessel) && !wahl.includes(schluessel)) {
|
|
156
167
|
throw new errors_js_1.KasseneckValidationError(name, `${teil}.${schluessel}: unbekanntes Feld`, 'request');
|
package/dist/cjs/pos/errors.d.ts
CHANGED
|
@@ -21,7 +21,7 @@ import { KasseneckApiError } from '../client/errors.js';
|
|
|
21
21
|
* ueber `KasseneckApiError.code` lesbar; die Kasse braucht dafuer einen
|
|
22
22
|
* Rueckfallzweig.
|
|
23
23
|
*/
|
|
24
|
-
export declare const POS_ERROR_CODES: readonly ["account_not_found", "action_confirmation_required", "admin_required", "after_count_not_permitted", "api_not_approved", "app_check_invalid", "app_check_missing", "article_not_found", "article_not_in_scope", "article_not_tracked", "cash_movement_exceeds_balance", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "comment_required", "count_already_voided", "count_not_found", "device_not_found", "dialect_mismatch", "drawer_inactive", "drawer_not_found", "idempotency_conflict", "idempotency_key_required", "internal_translation_error", "invalid_amount", "invalid_cursor", "invalid_denominations", "invalid_movement_type", "invalid_quantity", "invalid_serial", "live_not_enabled", "location_inactive", "location_not_found", "logo_invalid", "logo_invalid_type", "logo_too_large", "method_not_allowed", "mfa_required", "module_inactive", "not_found", "not_permitted", "note_required", "password_change_required", "print_job_not_found", "print_layout_failed", "printer_not_found", "recount_exhausted", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "second_factor_required", "serial_already_counted", "serial_not_allowed", "serial_required", "server_error", "session_expired", "session_other_cashregister", "shift_already_open", "shift_closed", "shift_mode_off", "shift_not_open", "stocktake_closed", "stocktake_closing", "stocktake_not_found", "stocktake_not_open", "tip_payout_exceeds_claim", "too_many_counts", "transfer_same_drawer", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
|
|
24
|
+
export declare const POS_ERROR_CODES: readonly ["account_not_found", "action_confirmation_required", "admin_required", "after_count_not_permitted", "api_not_approved", "app_check_invalid", "app_check_missing", "article_not_found", "article_not_in_scope", "article_not_tracked", "cash_movement_exceeds_balance", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "comment_required", "count_already_voided", "count_not_found", "device_not_found", "dialect_mismatch", "drawer_inactive", "drawer_not_found", "idempotency_conflict", "idempotency_key_required", "internal_translation_error", "invalid_amount", "invalid_cursor", "invalid_denominations", "invalid_discount_preset", "invalid_movement_type", "invalid_quantity", "invalid_serial", "live_not_enabled", "location_inactive", "location_not_found", "logo_invalid", "logo_invalid_type", "logo_too_large", "method_not_allowed", "mfa_required", "module_inactive", "not_found", "not_permitted", "note_required", "password_change_required", "print_job_not_found", "print_layout_failed", "printer_not_found", "recount_exhausted", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "response_translation_failed", "second_factor_required", "serial_already_counted", "serial_not_allowed", "serial_required", "server_error", "session_expired", "session_other_cashregister", "shift_already_open", "shift_closed", "shift_mode_off", "shift_not_open", "stocktake_closed", "stocktake_closing", "stocktake_not_found", "stocktake_not_open", "tip_payout_exceeds_claim", "too_many_counts", "transfer_same_drawer", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
|
|
25
25
|
export type PosErrorCode = typeof POS_ERROR_CODES[number];
|
|
26
26
|
export declare function isPosErrorCode(value: unknown): value is PosErrorCode;
|
|
27
27
|
/** Der Code eines geworfenen Fehlers, wenn er in [POS_ERROR_CODES] steht; sonst `undefined`. */
|
package/dist/cjs/pos/errors.js
CHANGED
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import type { PosExternalVouchers } from './gutschein.js';
|
|
2
|
+
/**
|
|
3
|
+
* Artikel als fremder Gutschein (Fremdgutscheine an der Kasse, 1.31.0): der
|
|
4
|
+
* Chef legt einen Artikel als Kachel „fremder Gutschein“ an. Die Kasse fragt
|
|
5
|
+
* beim Antippen die Gutscheinnummer (und ohne Preis den Betrag) ab und sendet
|
|
6
|
+
* statt einer Position einen `vouchers[]`-Eintrag
|
|
7
|
+
* `{ source: 'external', action: 'sell', type: externalVoucher, number, amountCents, vatRateBp? }`.
|
|
8
|
+
*
|
|
9
|
+
* Die Regeln am Artikel rechnet das Backend (`functions-kasse/fremdgutschein-artikel-core.js`)
|
|
10
|
+
* beim Speichern (`createMyArticle`/`updateMyArticle`, Code `article_external_voucher_invalid`
|
|
11
|
+
* mit `data.grund`); der Artikel-Editor des Kundenbereichs prueft vorher gleich. Vertrag sind
|
|
12
|
+
* die Pruefaelle `fixtures/external-voucher-article-cases.json` (byte-gleich mit dem Backend).
|
|
13
|
+
*/
|
|
14
|
+
/** Art des fremden Gutscheins am Artikel (`/v3` `externalVoucher`, gespeichert `fremdgutschein`). */
|
|
15
|
+
export type ArticleExternalVoucher = 'multi_purpose' | 'single_purpose';
|
|
16
|
+
export declare const ARTICLE_EXTERNAL_VOUCHER_TYPES: readonly ArticleExternalVoucher[];
|
|
17
|
+
/** Fehlercode beim Speichern eines Artikels, intern und unter `/v3` gleich. */
|
|
18
|
+
export declare const ARTICLE_EXTERNAL_VOUCHER_INVALID = "article_external_voucher_invalid";
|
|
19
|
+
/** Welche Regel verletzt ist (Antwortfeld `data.grund`), in der Reihenfolge, in der der Server prueft. */
|
|
20
|
+
export declare const EXTERNAL_VOUCHER_ARTICLE_REASONS: readonly ["invalid_type", "service_voucher", "add_ons", "stock_tracked", "reference", "asks_quantity", "rate_required", "invalid_rate", "price_required"];
|
|
21
|
+
export type ExternalVoucherArticleReason = typeof EXTERNAL_VOUCHER_ARTICLE_REASONS[number];
|
|
22
|
+
/**
|
|
23
|
+
* Ein Artikel im Editor (`/v3`-Form), soweit die Regeln ihn lesen. Bewusst
|
|
24
|
+
* `unknown` beim Wert: der Editor prueft auch, was nicht in den Typ passt.
|
|
25
|
+
*/
|
|
26
|
+
export interface ExternalVoucherArticleInput {
|
|
27
|
+
externalVoucher?: unknown;
|
|
28
|
+
unitPriceCents?: number | null;
|
|
29
|
+
vatRate?: number | null;
|
|
30
|
+
askPrice?: boolean | null;
|
|
31
|
+
serviceVoucher?: boolean | null;
|
|
32
|
+
addOns?: readonly unknown[] | null;
|
|
33
|
+
stockTracked?: boolean | null;
|
|
34
|
+
reference?: unknown;
|
|
35
|
+
askQuantity?: boolean | null;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Saetze, mit denen ein Einzweckgutschein verkauft werden kann (Prozent wie
|
|
39
|
+
* `PosArticle.vatRate`; 0 = befreit verkauft): die Saetze der Kasse, Backend
|
|
40
|
+
* `article-groups-core.STEUERSAETZE`, dieselben wie [EXTERNAL_VOUCHER_VAT_RATES_BP] / 100.
|
|
41
|
+
*/
|
|
42
|
+
export declare const ARTICLE_EXTERNAL_VOUCHER_VAT_RATES: readonly number[];
|
|
43
|
+
/** Ist der Wert eine Art fremder Gutschein? */
|
|
44
|
+
export declare function isArticleExternalVoucher(value: unknown): value is ArticleExternalVoucher;
|
|
45
|
+
/** Form des Werts beim Speichern: `null` heisst entfernen und ist gueltig. Zwilling von `pruefeWert`. */
|
|
46
|
+
export declare function checkExternalVoucherValue(value: unknown): ExternalVoucherArticleReason | null;
|
|
47
|
+
/**
|
|
48
|
+
* Regeln am wirksamen Artikelstand (Bestand + Aenderung), Zwilling von
|
|
49
|
+
* `pruefeArtikel`: `null` = passt. Ohne `externalVoucher` gilt keine Regel.
|
|
50
|
+
* Einzweck verlangt einen Satz der Kasse (0 = befreit verkauft), Mehrzweck ignoriert ihn;
|
|
51
|
+
* nie zusammen mit Leistungsgutschein, eigener Zusatzliste, Lagerbestand,
|
|
52
|
+
* Referenz oder Mengenabfrage (die Kasse fragt die Nummer selbst und bucht
|
|
53
|
+
* genau einen); ohne `askPrice` braucht er einen Preis ab 1 Cent.
|
|
54
|
+
*/
|
|
55
|
+
export declare function checkExternalVoucherArticle(a: ExternalVoucherArticleInput): ExternalVoucherArticleReason | null;
|
|
56
|
+
/** Warum die Kachel eines fremden Gutscheins gesperrt ist. */
|
|
57
|
+
export type ExternalVoucherTileBlock = 'not_enabled' | 'type_not_enabled';
|
|
58
|
+
/**
|
|
59
|
+
* Darf die Kachel verkaufen? `null` = ja (auch fuer jeden Artikel ohne
|
|
60
|
+
* `externalVoucher`). Gesperrt bei Freigabe `off` (oder ohne Angabe) und bei
|
|
61
|
+
* Einzweck ohne `all` -- dieselbe Regel, mit der der Server den Beleg abweist
|
|
62
|
+
* (`external_voucher_not_enabled`, `external_voucher_type_not_enabled`).
|
|
63
|
+
*/
|
|
64
|
+
export declare function externalVoucherTileBlock(article: {
|
|
65
|
+
externalVoucher?: ArticleExternalVoucher | null;
|
|
66
|
+
}, externalVouchers: PosExternalVouchers | null | undefined): ExternalVoucherTileBlock | null;
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.ARTICLE_EXTERNAL_VOUCHER_VAT_RATES = exports.EXTERNAL_VOUCHER_ARTICLE_REASONS = exports.ARTICLE_EXTERNAL_VOUCHER_INVALID = exports.ARTICLE_EXTERNAL_VOUCHER_TYPES = void 0;
|
|
4
|
+
exports.isArticleExternalVoucher = isArticleExternalVoucher;
|
|
5
|
+
exports.checkExternalVoucherValue = checkExternalVoucherValue;
|
|
6
|
+
exports.checkExternalVoucherArticle = checkExternalVoucherArticle;
|
|
7
|
+
exports.externalVoucherTileBlock = externalVoucherTileBlock;
|
|
8
|
+
exports.ARTICLE_EXTERNAL_VOUCHER_TYPES = Object.freeze(['multi_purpose', 'single_purpose']);
|
|
9
|
+
/** Fehlercode beim Speichern eines Artikels, intern und unter `/v3` gleich. */
|
|
10
|
+
exports.ARTICLE_EXTERNAL_VOUCHER_INVALID = 'article_external_voucher_invalid';
|
|
11
|
+
/** Welche Regel verletzt ist (Antwortfeld `data.grund`), in der Reihenfolge, in der der Server prueft. */
|
|
12
|
+
exports.EXTERNAL_VOUCHER_ARTICLE_REASONS = Object.freeze([
|
|
13
|
+
'invalid_type', 'service_voucher', 'add_ons', 'stock_tracked', 'reference', 'asks_quantity', 'rate_required', 'invalid_rate', 'price_required',
|
|
14
|
+
]);
|
|
15
|
+
/**
|
|
16
|
+
* Saetze, mit denen ein Einzweckgutschein verkauft werden kann (Prozent wie
|
|
17
|
+
* `PosArticle.vatRate`; 0 = befreit verkauft): die Saetze der Kasse, Backend
|
|
18
|
+
* `article-groups-core.STEUERSAETZE`, dieselben wie [EXTERNAL_VOUCHER_VAT_RATES_BP] / 100.
|
|
19
|
+
*/
|
|
20
|
+
exports.ARTICLE_EXTERNAL_VOUCHER_VAT_RATES = Object.freeze([20, 13, 10, 4.9, 0, 19]);
|
|
21
|
+
/** Ist der Wert eine Art fremder Gutschein? */
|
|
22
|
+
function isArticleExternalVoucher(value) {
|
|
23
|
+
return exports.ARTICLE_EXTERNAL_VOUCHER_TYPES.includes(value);
|
|
24
|
+
}
|
|
25
|
+
/** Form des Werts beim Speichern: `null` heisst entfernen und ist gueltig. Zwilling von `pruefeWert`. */
|
|
26
|
+
function checkExternalVoucherValue(value) {
|
|
27
|
+
return value === null || isArticleExternalVoucher(value) ? null : 'invalid_type';
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Regeln am wirksamen Artikelstand (Bestand + Aenderung), Zwilling von
|
|
31
|
+
* `pruefeArtikel`: `null` = passt. Ohne `externalVoucher` gilt keine Regel.
|
|
32
|
+
* Einzweck verlangt einen Satz der Kasse (0 = befreit verkauft), Mehrzweck ignoriert ihn;
|
|
33
|
+
* nie zusammen mit Leistungsgutschein, eigener Zusatzliste, Lagerbestand,
|
|
34
|
+
* Referenz oder Mengenabfrage (die Kasse fragt die Nummer selbst und bucht
|
|
35
|
+
* genau einen); ohne `askPrice` braucht er einen Preis ab 1 Cent.
|
|
36
|
+
*/
|
|
37
|
+
function checkExternalVoucherArticle(a) {
|
|
38
|
+
if (a.externalVoucher == null)
|
|
39
|
+
return null;
|
|
40
|
+
if (!isArticleExternalVoucher(a.externalVoucher))
|
|
41
|
+
return 'invalid_type';
|
|
42
|
+
if (a.serviceVoucher === true)
|
|
43
|
+
return 'service_voucher';
|
|
44
|
+
if (Array.isArray(a.addOns) && a.addOns.length > 0)
|
|
45
|
+
return 'add_ons';
|
|
46
|
+
if (a.stockTracked === true)
|
|
47
|
+
return 'stock_tracked';
|
|
48
|
+
if (a.reference)
|
|
49
|
+
return 'reference';
|
|
50
|
+
if (a.askQuantity === true)
|
|
51
|
+
return 'asks_quantity';
|
|
52
|
+
if (a.externalVoucher === 'single_purpose' && !(typeof a.vatRate === 'number' && Number.isFinite(a.vatRate)))
|
|
53
|
+
return 'rate_required';
|
|
54
|
+
if (a.externalVoucher === 'single_purpose' && !exports.ARTICLE_EXTERNAL_VOUCHER_VAT_RATES.includes(a.vatRate))
|
|
55
|
+
return 'invalid_rate';
|
|
56
|
+
if (a.askPrice !== true && !(typeof a.unitPriceCents === 'number' && Number.isInteger(a.unitPriceCents) && a.unitPriceCents >= 1))
|
|
57
|
+
return 'price_required';
|
|
58
|
+
return null;
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* Darf die Kachel verkaufen? `null` = ja (auch fuer jeden Artikel ohne
|
|
62
|
+
* `externalVoucher`). Gesperrt bei Freigabe `off` (oder ohne Angabe) und bei
|
|
63
|
+
* Einzweck ohne `all` -- dieselbe Regel, mit der der Server den Beleg abweist
|
|
64
|
+
* (`external_voucher_not_enabled`, `external_voucher_type_not_enabled`).
|
|
65
|
+
*/
|
|
66
|
+
function externalVoucherTileBlock(article, externalVouchers) {
|
|
67
|
+
if (article.externalVoucher == null)
|
|
68
|
+
return null;
|
|
69
|
+
if (externalVouchers !== 'multi_purpose' && externalVouchers !== 'all')
|
|
70
|
+
return 'not_enabled';
|
|
71
|
+
if (article.externalVoucher === 'single_purpose' && externalVouchers !== 'all')
|
|
72
|
+
return 'type_not_enabled';
|
|
73
|
+
return null;
|
|
74
|
+
}
|