@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
|
@@ -17,6 +17,7 @@ import { KasseneckValidationError } from '../client/errors.js';
|
|
|
17
17
|
import { verifyWebhookSignature as pruefeSignatur } from '../partner/webhook-signatur.js';
|
|
18
18
|
import { artikel, bestandGeaendert, objekt, reservierung, unterMindestbestand, variantengruppe } from './lesen.js';
|
|
19
19
|
import { INVENTORY_WEBHOOK_EVENTS } from './vertrag.js';
|
|
20
|
+
import { vollerBeleg } from '../client/list-receipts.js';
|
|
20
21
|
export { WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_TOLERANCE_SEC, } from '../partner/webhook-signatur.js';
|
|
21
22
|
/**
|
|
22
23
|
* Prueft die Signatur einer Zustellung. `true` nur, wenn Kopf, Zeitfenster
|
|
@@ -63,6 +64,9 @@ function kaputt(grund) {
|
|
|
63
64
|
* - `variant_group.created|updated` tragen die Gruppe wie `getVariantGroup`
|
|
64
65
|
* (seit 1.6.0). Zwei Zustellungen koennen sich ueberholen: den Stand nur
|
|
65
66
|
* uebernehmen, wenn `data.updatedAt` neuer ist als der gespeicherte.
|
|
67
|
+
* - `receipt.created|cancelled` (Beleg-Webhooks) tragen den Beleg wie
|
|
68
|
+
* `listReceipts` mit `view: 'full'` ([ReceiptCreatedEventData],
|
|
69
|
+
* [ReceiptCancelledEventData]).
|
|
66
70
|
* - Ein Rumpf, der keine Huelle ist, oder eine Bruchzahl in einer Menge wirft
|
|
67
71
|
* `KasseneckValidationError` (`scope: 'response'`).
|
|
68
72
|
*
|
|
@@ -107,7 +111,42 @@ export function parseInventoryWebhookEvent(rawBody) {
|
|
|
107
111
|
case 'variant_group.created':
|
|
108
112
|
case 'variant_group.updated':
|
|
109
113
|
return { ...huelle, type: huelle.type, data: variantengruppe(ort, data) };
|
|
114
|
+
case 'receipt.created':
|
|
115
|
+
return { ...huelle, type: huelle.type, data: belegDaten(data) };
|
|
116
|
+
case 'receipt.cancelled':
|
|
117
|
+
return { ...huelle, type: huelle.type, data: stornoDaten(data) };
|
|
110
118
|
default:
|
|
111
119
|
return { ...huelle, type: huelle.type, data: artikel(ort, data) };
|
|
112
120
|
}
|
|
113
121
|
}
|
|
122
|
+
/** `data` von `receipt.created`: der Beleg der vollen Ansicht, bei einer gekuerzten Zustellung mit Hinweis. */
|
|
123
|
+
function belegDaten(data) {
|
|
124
|
+
const beleg = objekt(data['receipt']);
|
|
125
|
+
if (!beleg)
|
|
126
|
+
throw kaputt('Ereignis ohne data.receipt');
|
|
127
|
+
return {
|
|
128
|
+
receipt: vollerBeleg(beleg),
|
|
129
|
+
...(data['truncated'] === true ? { truncated: true } : {}),
|
|
130
|
+
...(typeof data['hint'] === 'string' ? { hint: data['hint'] } : {}),
|
|
131
|
+
};
|
|
132
|
+
}
|
|
133
|
+
const ganzOderNull = (w) => (typeof w === 'number' && Number.isInteger(w) ? w : null);
|
|
134
|
+
const textOderNull = (w) => (typeof w === 'string' && w !== '' ? w : null);
|
|
135
|
+
/** `data` von `receipt.cancelled`: dazu Bezug, stornierte Positionen und Rueckzahlungen aus dem Storno-Beleg. */
|
|
136
|
+
function stornoDaten(data) {
|
|
137
|
+
const { cancellationOf, cancelledItems, refunds } = data;
|
|
138
|
+
if (cancellationOf !== null && typeof cancellationOf !== 'string')
|
|
139
|
+
throw kaputt('data.cancellationOf ist weder Text noch null');
|
|
140
|
+
if (!Array.isArray(cancelledItems) || cancelledItems.some((x) => !objekt(x)))
|
|
141
|
+
throw kaputt('data.cancelledItems ist keine Liste von Positionen');
|
|
142
|
+
if (!Array.isArray(refunds) || refunds.some((x) => !objekt(x)))
|
|
143
|
+
throw kaputt('data.refunds ist keine Liste von Rueckzahlungen');
|
|
144
|
+
return {
|
|
145
|
+
...belegDaten(data),
|
|
146
|
+
cancellationOf: cancellationOf === '' ? null : cancellationOf,
|
|
147
|
+
cancelledItems: cancelledItems.map((p) => ({ index: ganzOderNull(p['index']), quantity: ganzOderNull(p['quantity']) })),
|
|
148
|
+
refunds: refunds.map((r) => ({
|
|
149
|
+
refundOf: textOderNull(r['refundOf']), amountCents: ganzOderNull(r['amountCents']), method: textOderNull(r['method']),
|
|
150
|
+
})),
|
|
151
|
+
};
|
|
152
|
+
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, isDiscountItem, isVoucherItem, isVoucherFloatItem, } from './receipt-item.js';
|
|
2
|
-
export { type Voucher, type VoucherArticle, type IssuedVoucher, type ReturnIssuedVoucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, isNewFormVoucher, voucherServerFields } from './voucher.js';
|
|
2
|
+
export { type Voucher, type VoucherArticle, type IssuedVoucher, type ReturnIssuedVoucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, isNewFormVoucher, voucherServerFields, type VoucherSource, type LegacyValueVoucherWish, VOUCHER_SOURCES, isExternalVoucher, externalVoucherIsValid, normalizeExternalVoucherNumber, checkExternalVoucherNumber, type ExternalVoucherNumberCheck, ownVoucherCodeShape, OWN_VOUCHER_CODE_SHAPES, type OwnVoucherCodeShape, EXTERNAL_VOUCHER_NUMBER_MAX, EXTERNAL_VOUCHER_TAXED_WITH_MAX, EXTERNAL_VOUCHER_VAT_RATES_BP, } from './voucher.js';
|
|
3
3
|
export { type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, readRegistrationInfo, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, } from './receipt.js';
|
|
4
4
|
export { type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, type ReturnDisposition, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, remainingQuantities, TIP_REFUND_SOURCES, type TipRefundSource, isTipRefundSource, openStaffTipCents, cancellationItemsForTip, cancellationCashRefundCents, asksTipRefundSource, asksRefundTip, } from './cancellation.js';
|
|
5
5
|
export { type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, } from './receipt-payment.js';
|
package/dist/esm/models/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
export { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, isTipItem, isDiscountItem, isVoucherItem, isVoucherFloatItem, } from './receipt-item.js';
|
|
2
|
-
export { toVoucherPayload, fromVoucherPayload, voucherIsValid, isNewFormVoucher, voucherServerFields } from './voucher.js';
|
|
2
|
+
export { toVoucherPayload, fromVoucherPayload, voucherIsValid, isNewFormVoucher, voucherServerFields, VOUCHER_SOURCES, isExternalVoucher, externalVoucherIsValid, normalizeExternalVoucherNumber, checkExternalVoucherNumber, ownVoucherCodeShape, OWN_VOUCHER_CODE_SHAPES, EXTERNAL_VOUCHER_NUMBER_MAX, EXTERNAL_VOUCHER_TAXED_WITH_MAX, EXTERNAL_VOUCHER_VAT_RATES_BP, } from './voucher.js';
|
|
3
3
|
export { toReceiptPayload, fromReceiptPayload, readRegistrationInfo, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, } from './receipt.js';
|
|
4
4
|
export { RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, remainingQuantities, TIP_REFUND_SOURCES, isTipRefundSource, openStaffTipCents, cancellationItemsForTip, cancellationCashRefundCents, asksTipRefundSource, asksRefundTip, } from './cancellation.js';
|
|
5
5
|
export { fromReceiptPaymentPayload, toReceiptPaymentPayload, } from './receipt-payment.js';
|
|
@@ -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,4 +1,5 @@
|
|
|
1
1
|
import { VoucherAction, VoucherType } from '../enums/index.js';
|
|
2
|
+
import { VoucherCode } from '@kreiseck/validator';
|
|
2
3
|
import { euroToCents } from '../money.js';
|
|
3
4
|
import { readEnumKey, requireEnumKey } from './enum-payload.js';
|
|
4
5
|
/** Arten der neuen Gutscheinform (die Altwerte sind `value` und `promo`). */
|
|
@@ -8,6 +9,11 @@ export const NEUE_GUTSCHEINARTEN = [
|
|
|
8
9
|
VoucherType.service,
|
|
9
10
|
VoucherType.promotion,
|
|
10
11
|
];
|
|
12
|
+
export const VOUCHER_SOURCES = Object.freeze(['external']);
|
|
13
|
+
/** Fremdgutschein (`source: 'external'`)? Zwilling von `gutschein-beleg.istFremd`. */
|
|
14
|
+
export function isExternalVoucher(voucher) {
|
|
15
|
+
return voucher.source === 'external';
|
|
16
|
+
}
|
|
11
17
|
/**
|
|
12
18
|
* Verkauf ueber eine Sorte ohne Art (`typeId` ohne `type`): die Art kommt aus
|
|
13
19
|
* der Sorte. Zwilling von `gutschein-beleg.istSortenVerkauf`.
|
|
@@ -17,7 +23,8 @@ function istSortenVerkaufOhneArt(voucher) {
|
|
|
17
23
|
}
|
|
18
24
|
/** Gehoert der Gutschein zur neuen Form (Art, Aktion `payout` oder Verkauf ueber eine Sorte ohne Art)? */
|
|
19
25
|
export function isNewFormVoucher(voucher) {
|
|
20
|
-
return NEUE_GUTSCHEINARTEN.includes(voucher.type) || voucher.action === VoucherAction.payout || istSortenVerkaufOhneArt(voucher)
|
|
26
|
+
return NEUE_GUTSCHEINARTEN.includes(voucher.type) || voucher.action === VoucherAction.payout || istSortenVerkaufOhneArt(voucher)
|
|
27
|
+
|| isExternalVoucher(voucher);
|
|
21
28
|
}
|
|
22
29
|
/**
|
|
23
30
|
* Wert-Verkauf: ein Mehrzweck- oder Einzweckgutschein wird verkauft (mit Art
|
|
@@ -25,7 +32,7 @@ export function isNewFormVoucher(voucher) {
|
|
|
25
32
|
* Senden entscheiden daran, ob eine Sorte noetig ist.
|
|
26
33
|
*/
|
|
27
34
|
export function istWertVerkauf(voucher) {
|
|
28
|
-
return voucher.action === VoucherAction.sell
|
|
35
|
+
return !isExternalVoucher(voucher) && voucher.action === VoucherAction.sell
|
|
29
36
|
&& (voucher.type === VoucherType.multi_purpose || voucher.type === VoucherType.single_purpose || istSortenVerkaufOhneArt(voucher));
|
|
30
37
|
}
|
|
31
38
|
/**
|
|
@@ -38,7 +45,7 @@ export function voucherServerFields(voucher) {
|
|
|
38
45
|
return GUTSCHEIN_SERVERFELDER.filter((feld) => voucher[feld] != null);
|
|
39
46
|
}
|
|
40
47
|
const NEUE_FELDER = [
|
|
41
|
-
'amountCents', 'articleId', 'quantity', 'positions', 'reason', 'typeId', 'typeName', 'payout', 'voucherType', 'voucherId', 'codeSuffix',
|
|
48
|
+
'source', 'number', 'amountCents', 'articleId', 'quantity', 'positions', 'reason', 'typeId', 'typeName', 'payout', 'voucherType', 'voucherId', 'codeSuffix',
|
|
42
49
|
'vatRateBp', 'article', 'balanceAfterCents', 'remainingQuantityAfter', 'taxedWith', 'exempt', 'zeroRateBucket', 'fromReturn',
|
|
43
50
|
];
|
|
44
51
|
export function toVoucherPayload(voucher) {
|
|
@@ -71,6 +78,8 @@ export function toVoucherPayload(voucher) {
|
|
|
71
78
|
* gesetzter Wert muss positiv sein.
|
|
72
79
|
*/
|
|
73
80
|
export function voucherIsValid(voucher) {
|
|
81
|
+
if (isExternalVoucher(voucher))
|
|
82
|
+
return externalVoucherIsValid(voucher);
|
|
74
83
|
if (isNewFormVoucher(voucher))
|
|
75
84
|
return newFormVoucherIsValid(voucher);
|
|
76
85
|
if (voucher.type === VoucherType.value && voucher.valueCents == null) {
|
|
@@ -160,13 +169,21 @@ function newFormVoucherIsValid(v) {
|
|
|
160
169
|
* Stufe 4b antwortet darauf `voucher_type_required`). Paketintern.
|
|
161
170
|
*/
|
|
162
171
|
export function wunschFormGueltig(v, sorteNoetig) {
|
|
172
|
+
if (isExternalVoucher(v))
|
|
173
|
+
return externalVoucherIsValid(v);
|
|
163
174
|
if (voucherServerFields(v).length > 0)
|
|
164
175
|
return false;
|
|
165
176
|
const r = v;
|
|
166
|
-
for (const feld of ['
|
|
177
|
+
for (const feld of ['article', 'balanceAfterCents', 'remainingQuantityAfter', 'exempt']) {
|
|
167
178
|
if (r[feld] != null)
|
|
168
179
|
return false;
|
|
169
180
|
}
|
|
181
|
+
// Felder nur des Fremdgutscheins (gutschein-beleg.NUR_BEI_FREMD): der Server weist sie an einem eigenen Wunsch
|
|
182
|
+
// schon gesendet ab, auch als `null` (`voucher_invalid`); eine andere Herkunft als `external` gibt es nicht.
|
|
183
|
+
for (const feld of ['number', 'taxedWith', 'vatRateBp', 'source']) {
|
|
184
|
+
if (r[feld] !== undefined)
|
|
185
|
+
return false;
|
|
186
|
+
}
|
|
170
187
|
if (v.valueCents != null)
|
|
171
188
|
return false;
|
|
172
189
|
// Die Sorte gehoert nur an einen Wert-Verkauf (Server: sorteId sonst voucher_invalid).
|
|
@@ -210,3 +227,134 @@ export function wunschFormGueltig(v, sorteNoetig) {
|
|
|
210
227
|
// Altart mit neuer Aktion (payout + value/promo): nicht sendbar.
|
|
211
228
|
return false;
|
|
212
229
|
}
|
|
230
|
+
// ---- Fremdgutscheine (Server 2026-11) -------------------------------------------
|
|
231
|
+
/**
|
|
232
|
+
* Rand einer Fremdnummer (Zwilling von `gutschein-core.FREMD_RAND`): ASCII-Leerraum und die Unicode-Leerzeichen,
|
|
233
|
+
* die beim Kopieren aus Fremdsystemen mitkommen. Bewusst ohne U+0085 (NEL): ein Steuerzeichen, das nie still
|
|
234
|
+
* verschwindet, sondern die Nummer ungueltig macht.
|
|
235
|
+
*/
|
|
236
|
+
const FREMD_RAND = '\\t\\n\\v\\f\\r \\u00A0\\u1680\\u2000-\\u200A\\u2028\\u2029\\u202F\\u205F\\u3000\\uFEFF';
|
|
237
|
+
const FREMD_RAND_MUSTER = new RegExp(`^[${FREMD_RAND}]+|[${FREMD_RAND}]+$`, 'g');
|
|
238
|
+
const FREMD_NUMMER_MUSTER = /^[A-Za-z0-9\-_./]{1,40}$/;
|
|
239
|
+
/** Hoechstlaenge der Nummer eines Fremdgutscheins (nach dem Abschneiden des Rands). */
|
|
240
|
+
export const EXTERNAL_VOUCHER_NUMBER_MAX = 40;
|
|
241
|
+
/** Hoechstlaenge von `taxedWith` (Vermerk, mit welchem Beleg im fremden System der Einzweckgutschein versteuert ist). */
|
|
242
|
+
export const EXTERNAL_VOUCHER_TAXED_WITH_MAX = 40;
|
|
243
|
+
/**
|
|
244
|
+
* Saetze, mit denen ein fremder Einzweckgutschein verkauft sein kann (Basispunkte): die Saetze der Kasse
|
|
245
|
+
* (20, 10, 13, 19, 4,9 %) und 0 = befreit verkauft (Kleinunternehmer).
|
|
246
|
+
*/
|
|
247
|
+
export const EXTERNAL_VOUCHER_VAT_RATES_BP = Object.freeze([2000, 1000, 1300, 1900, 490, 0]);
|
|
248
|
+
/**
|
|
249
|
+
* Nummer eines Fremdgutscheins in der Form, mit der der Server sie speichert und druckt
|
|
250
|
+
* (`gutschein-core.normiereFremdnummer`): Rand weg, **keine** Unicode-Normalisierung, Gross-/Kleinschreibung
|
|
251
|
+
* bleibt; dann 1 bis 40 Zeichen aus `A–Z a–z 0–9 - _ . /`. Sonst `null` (`external_voucher_number_invalid`).
|
|
252
|
+
* Einen eigenen Gutscheincode erkennt erst [checkExternalVoucherNumber].
|
|
253
|
+
*/
|
|
254
|
+
export function normalizeExternalVoucherNumber(text) {
|
|
255
|
+
if (typeof text !== 'string')
|
|
256
|
+
return null;
|
|
257
|
+
const n = text.replace(FREMD_RAND_MUSTER, '');
|
|
258
|
+
return FREMD_NUMMER_MUSTER.test(n) ? n : null;
|
|
259
|
+
}
|
|
260
|
+
/**
|
|
261
|
+
* Prueft eine Fremdnummer in der Reihenfolge des Servers (`gutschein-beleg.pruefeFremd`): zuerst, ob sie ein
|
|
262
|
+
* gueltiger eigener Gutscheincode ist (12 Zeichen mit Pruefzeichen, in jeder Schreibweise der Kasse, auch mit `.`, `_`
|
|
263
|
+
* oder `/` als Trenner) – dann
|
|
264
|
+
* `external_voucher_number_is_own_code`, der Gutschein gehoert als eigener eingeloest –, danach die Form.
|
|
265
|
+
*/
|
|
266
|
+
export function checkExternalVoucherNumber(text) {
|
|
267
|
+
// `.`, `_` und `/` zwischen den Gruppen liest die Pruefung wie `-` (Zwilling von `gutschein-core.istEigenerCode`):
|
|
268
|
+
// `7148.FGQA.935K` ist der eigene Code. Die Nummer selbst bleibt, wie sie kam.
|
|
269
|
+
if (typeof text === 'string' && VoucherCode.validate(text.replace(/[._/]/g, '-')).ok)
|
|
270
|
+
return { ok: false, code: 'external_voucher_number_is_own_code' };
|
|
271
|
+
const number = normalizeExternalVoucherNumber(text);
|
|
272
|
+
return number === null ? { ok: false, code: 'external_voucher_number_invalid' } : { ok: true, number };
|
|
273
|
+
}
|
|
274
|
+
export const OWN_VOUCHER_CODE_SHAPES = Object.freeze(['valid', 'checksum', 'length', 'none']);
|
|
275
|
+
/** Alphabet der eigenen Codes (Crockford-Base32 ohne U), nach der Normalisierung von `VoucherCode`. */
|
|
276
|
+
const CODE_ALPHABET = /^[0-9A-HJKMNP-TV-Z]+$/;
|
|
277
|
+
const CODE_GRUPPEN = /^[0-9A-Za-z]{4}-[0-9A-Za-z]{4}-[0-9A-Za-z]+$/;
|
|
278
|
+
/**
|
|
279
|
+
* Form-Erkennung eigener Codes fuer das Feld „Code eingeben oder scannen“ (Web-Kasse und Kassen-App gleich):
|
|
280
|
+
* `valid` laeuft als eigener Gutschein, `checksum`/`length` fragt die Kasse nach („Sieht aus wie ein
|
|
281
|
+
* Kasseneck-Code, ist aber keiner. Als fremden Gutschein verwenden?“, `external_voucher.looks_like_own_code`),
|
|
282
|
+
* `none` geht bei Freigabe direkt in das Blatt „Fremder Gutschein“. Gelesen wie [checkExternalVoucherNumber]:
|
|
283
|
+
* Rand weg, `.`, `_`, `/` wie `-`, dann die Normalisierung von `VoucherCode` (gross, ohne Leerraum und `-`,
|
|
284
|
+
* O → 0, I/L → 1); `length` nur mit echten Bindestrichen. Eine Nachfrage weist nichts ab: der Server prueft die Fremdnummer selbst
|
|
285
|
+
* (`external_voucher_number_is_own_code` nur bei `valid`).
|
|
286
|
+
*/
|
|
287
|
+
export function ownVoucherCodeShape(text) {
|
|
288
|
+
if (typeof text !== 'string')
|
|
289
|
+
return 'none';
|
|
290
|
+
const roh = text.replace(FREMD_RAND_MUSTER, '');
|
|
291
|
+
const t = roh.replace(/[._/]/g, '-');
|
|
292
|
+
if (t === '')
|
|
293
|
+
return 'none';
|
|
294
|
+
if (VoucherCode.validate(t).ok)
|
|
295
|
+
return 'valid';
|
|
296
|
+
const s = t.toUpperCase().replace(/[\s-]/g, '').replace(/O/g, '0').replace(/[IL]/g, '1');
|
|
297
|
+
if (!CODE_ALPHABET.test(s))
|
|
298
|
+
return 'none';
|
|
299
|
+
if (s.length === 12)
|
|
300
|
+
return 'checksum';
|
|
301
|
+
// Falsche Laenge nur mit echten Bindestrichen: eigene Codes stehen immer so da, `WEIN.2026/7` ist keiner.
|
|
302
|
+
return CODE_GRUPPEN.test(roh) ? 'length' : 'none';
|
|
303
|
+
}
|
|
304
|
+
/** Steuer- und Formatzeichen (`gutschein-core.STEUERZEICHEN`): nie in `taxedWith`. */
|
|
305
|
+
const STEUERZEICHEN = /[\p{Cc}\p{Cf}]/u;
|
|
306
|
+
/**
|
|
307
|
+
* Ist der Fremdgutschein sendbar? Die Form wie `gutschein-beleg.pruefeFremd` (ohne die Freigabe des Kontos, die
|
|
308
|
+
* kennt nur der Server bzw. `PosVoucherSettings.externalVouchers`): Aktion `sell`/`redeem`/`payout`, Art
|
|
309
|
+
* `multi_purpose`/`single_purpose`, gueltige Nummer (kein eigener Code), Betrag 1 bis 1.000.000 Cent; Einzweck mit
|
|
310
|
+
* einem Satz aus [EXTERNAL_VOUCHER_VAT_RATES_BP], Mehrzweck ohne; `taxedWith` nur bei Einzweck-Einloesung bzw.
|
|
311
|
+
* -Auszahlung (1 bis 40 Zeichen ohne Steuerzeichen); Auszahlung mit Grund (1 bis 200 Zeichen). Felder eigener
|
|
312
|
+
* Gutscheine (Code, Sorte, Artikel, Menge, Positionen) und Serverfelder nie.
|
|
313
|
+
*/
|
|
314
|
+
export function externalVoucherIsValid(voucher) {
|
|
315
|
+
const v = voucher;
|
|
316
|
+
if (!isExternalVoucher(v))
|
|
317
|
+
return false;
|
|
318
|
+
if (voucherServerFields(v).length > 0)
|
|
319
|
+
return false;
|
|
320
|
+
const r = v;
|
|
321
|
+
// gutschein-beleg.NICHT_BEI_FREMD (gesendet heisst voucher_invalid, auch als null).
|
|
322
|
+
for (const feld of ['code', 'typeId', 'articleId', 'article', 'quantity', 'positions']) {
|
|
323
|
+
if (r[feld] !== undefined)
|
|
324
|
+
return false;
|
|
325
|
+
}
|
|
326
|
+
for (const feld of ['balanceAfterCents', 'remainingQuantityAfter', 'exempt']) {
|
|
327
|
+
if (r[feld] != null)
|
|
328
|
+
return false;
|
|
329
|
+
}
|
|
330
|
+
if (v.valueCents != null)
|
|
331
|
+
return false;
|
|
332
|
+
if (v.action !== VoucherAction.sell && v.action !== VoucherAction.redeem && v.action !== VoucherAction.payout)
|
|
333
|
+
return false;
|
|
334
|
+
if (v.type !== VoucherType.multi_purpose && v.type !== VoucherType.single_purpose)
|
|
335
|
+
return false;
|
|
336
|
+
if (!checkExternalVoucherNumber(v.number).ok)
|
|
337
|
+
return false;
|
|
338
|
+
if (!istCent(v.amountCents))
|
|
339
|
+
return false;
|
|
340
|
+
if (v.type === VoucherType.single_purpose) {
|
|
341
|
+
if (!(typeof v.vatRateBp === 'number' && EXTERNAL_VOUCHER_VAT_RATES_BP.includes(v.vatRateBp)))
|
|
342
|
+
return false;
|
|
343
|
+
}
|
|
344
|
+
else if (v.vatRateBp != null) {
|
|
345
|
+
return false;
|
|
346
|
+
}
|
|
347
|
+
if (v.taxedWith != null) {
|
|
348
|
+
if (v.type !== VoucherType.single_purpose || v.action === VoucherAction.sell)
|
|
349
|
+
return false;
|
|
350
|
+
const t = typeof v.taxedWith === 'string' ? v.taxedWith.trim() : '';
|
|
351
|
+
if (t.length < 1 || t.length > EXTERNAL_VOUCHER_TAXED_WITH_MAX || STEUERZEICHEN.test(t))
|
|
352
|
+
return false;
|
|
353
|
+
}
|
|
354
|
+
if (v.action === VoucherAction.payout) {
|
|
355
|
+
const g = typeof v.reason === 'string' ? v.reason.trim() : '';
|
|
356
|
+
if (g.length < 1 || g.length > MAX_GRUND)
|
|
357
|
+
return false;
|
|
358
|
+
}
|
|
359
|
+
return true;
|
|
360
|
+
}
|
|
@@ -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/esm/pos/artikel.js
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { KasseneckValidationError } from '../client/errors.js';
|
|
2
2
|
import { fromReferencePayload } from './kachel-referenz.js';
|
|
3
|
+
import { isArticleExternalVoucher } from './fremdgutschein-artikel.js';
|
|
3
4
|
/** Zusatzliste am Draht: nur eine Liste von Texten zaehlt, sonst null. Paketintern. */
|
|
4
5
|
export function addOnListe(wert) {
|
|
5
6
|
return Array.isArray(wert) ? wert.filter((s) => typeof s === 'string' && s !== '') : null;
|
|
@@ -92,6 +93,7 @@ export function fromPosArticlePayload(p) {
|
|
|
92
93
|
askPrice: p.askPrice === true,
|
|
93
94
|
reference: fromReferencePayload(p.reference),
|
|
94
95
|
addOns: addOnListe(p.addOns),
|
|
96
|
+
externalVoucher: isArticleExternalVoucher(p.externalVoucher) ? p.externalVoucher : null,
|
|
95
97
|
};
|
|
96
98
|
}
|
|
97
99
|
/**
|
package/dist/esm/pos/client.js
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { KasseneckValidationError } from '../client/errors.js';
|
|
2
2
|
import { posVoucherSettingsFromWire } from './gutschein.js';
|
|
3
|
-
import {
|
|
3
|
+
import { checkDiscountPresets, INVALID_DISCOUNT_PRESET } from './rabatt-vorlagen.js';
|
|
4
|
+
import { POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, POS_BUSINESS_VALUES, POS_DEVICE_VALUES, POS_SHORTCUT_ACTIONS, POS_DEVICE_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_CHOICES, POS_BUSINESS_OPTIONAL_LISTS, POS_DEVICE_OPTIONAL_CHOICES, mergePosSettings, posShortcutConflict, _istAltwert0x, _optionalerWert, } from './settings.js';
|
|
4
5
|
/*
|
|
5
6
|
* Die Einstellungs-Aufrufe am Draht `/api/v3`: Parameter und Antwort heissen
|
|
6
7
|
* `business`/`device`, Schluessel und Werte englisch (Nachtrag §11.7.2).
|
|
@@ -144,6 +145,16 @@ function pruefeTeil(name, teil, block, standard, werte) {
|
|
|
144
145
|
throw new KasseneckValidationError(name, `${teil}.${schluessel}: true oder false erwartet`, 'request');
|
|
145
146
|
continue;
|
|
146
147
|
}
|
|
148
|
+
// Rabatt-Vorlagen: dieselbe Pruefung wie am Server, der erste Fehler mit Vorlage, Feld und Satz.
|
|
149
|
+
if (teil === 'business' && POS_BUSINESS_OPTIONAL_LISTS.includes(schluessel)) {
|
|
150
|
+
const geprueft = checkDiscountPresets(wert);
|
|
151
|
+
if (!geprueft.ok) {
|
|
152
|
+
const f = geprueft.errors[0];
|
|
153
|
+
const ort = `${teil}.${schluessel}${f.index === null ? '' : `[${f.index}]`}${f.field === null ? '' : `.${f.field}`}`;
|
|
154
|
+
throw new KasseneckValidationError(name, `${ort}: ${f.message} (${INVALID_DISCOUNT_PRESET})`, 'request');
|
|
155
|
+
}
|
|
156
|
+
continue;
|
|
157
|
+
}
|
|
147
158
|
const wahl = teil === 'business' ? POS_BUSINESS_OPTIONAL_CHOICES : POS_DEVICE_OPTIONAL_CHOICES;
|
|
148
159
|
if (!Object.prototype.hasOwnProperty.call(standard, schluessel) && !wahl.includes(schluessel)) {
|
|
149
160
|
throw new KasseneckValidationError(name, `${teil}.${schluessel}: unbekanntes Feld`, 'request');
|
package/dist/esm/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/esm/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;
|