@kreiseck/kasseneck-api 1.22.0 → 1.24.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 +19 -0
- package/dist/cjs/client/aufrufe.d.ts +5 -5
- package/dist/cjs/client/aufrufe.js +12 -2
- package/dist/cjs/client/transport.d.ts +3 -3
- package/dist/cjs/client/transport.js +2 -2
- package/dist/cjs/pos/connect-bestand.d.ts +27 -0
- package/dist/cjs/pos/connect-bestand.js +40 -0
- package/dist/cjs/pos/errors.d.ts +2 -2
- package/dist/cjs/pos/errors.js +2 -2
- package/dist/cjs/pos/index.d.ts +2 -0
- package/dist/cjs/pos/index.js +10 -2
- package/dist/cjs/pos/kasseninfo.d.ts +110 -0
- package/dist/cjs/pos/kasseninfo.js +266 -0
- package/dist/cjs/pos/texte.d.ts +162 -2
- package/dist/cjs/pos/texte.js +67 -3
- package/dist/cjs/stored/vokabular.d.ts +1 -1
- package/dist/cjs/stored/vokabular.js +6 -1
- package/dist/cjs/version.d.ts +1 -1
- package/dist/cjs/version.js +1 -1
- package/dist/esm/client/aufrufe.d.ts +5 -5
- package/dist/esm/client/aufrufe.js +12 -2
- package/dist/esm/client/transport.d.ts +3 -3
- package/dist/esm/client/transport.js +2 -2
- package/dist/esm/pos/connect-bestand.d.ts +27 -0
- package/dist/esm/pos/connect-bestand.js +37 -0
- package/dist/esm/pos/errors.d.ts +2 -2
- package/dist/esm/pos/errors.js +2 -2
- package/dist/esm/pos/index.d.ts +2 -0
- package/dist/esm/pos/index.js +4 -0
- package/dist/esm/pos/kasseninfo.d.ts +110 -0
- package/dist/esm/pos/kasseninfo.js +261 -0
- package/dist/esm/pos/texte.d.ts +162 -2
- package/dist/esm/pos/texte.js +67 -3
- package/dist/esm/stored/vokabular.d.ts +1 -1
- package/dist/esm/stored/vokabular.js +6 -1
- package/dist/esm/version.d.ts +1 -1
- package/dist/esm/version.js +1 -1
- package/fixtures/expected/print-cut.sale-cash-default.hex +34 -0
- package/fixtures/expected/print-cut.sale-cash-full.hex +34 -0
- package/fixtures/expected/print-cut.sale-cash-mm58-none.hex +27 -0
- package/fixtures/expected/print-cut.sale-cash-mm58-partial.hex +27 -0
- package/fixtures/expected/print-cut.sale-cash-none.hex +33 -0
- package/fixtures/expected/print-cut.sale-cash-partial.hex +34 -0
- package/fixtures/expected/print-cut.sale-cash-true.hex +34 -0
- package/fixtures/expected/print-cut.zero-start-none.hex +38 -0
- package/fixtures/hobex-hps-codes.json +1 -1
- package/fixtures/inspection-info-cases.json +2348 -0
- package/fixtures/invoice-api.schema.json +1 -1
- package/fixtures/invoice-texts.json +1 -1
- package/fixtures/pos-texts.json +194 -3
- package/fixtures/print-cut-cases.json +47 -0
- package/fixtures/surface.json +8 -3
- package/fixtures/v3/antworten/belege.json +1 -1
- package/fixtures/v3/antworten/belegmail.json +1 -1
- package/fixtures/v3/antworten/berichte.json +1 -1
- package/fixtures/v3/antworten/kasse-belege.json +1 -1
- package/fixtures/v3/antworten/kasse.json +1814 -912
- package/fixtures/v3/antworten/lager.json +1 -1
- package/fixtures/v3/antworten/rechnungen.json +33 -33
- package/fixtures/v3/antworten/storno.json +1 -1
- package/fixtures/v3/stored/belege.json +1 -1
- package/fixtures/v3/stored/kasse.json +167 -4
- package/fixtures/v3/stored/rechnungen.json +253 -253
- package/fixtures/v3/v3-vokabular.json +37 -4
- package/fixtures/v3/zahlbetrag-faelle.json +1 -1
- package/package.json +3 -1
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
* umhuellt, muss ihn weiterhin absetzen koennen.
|
|
14
14
|
*/
|
|
15
15
|
import type { FileOrData, FileOrDataCallOptions, PdfOrData, TransportBodyFields, TransportCallOptions } from './transport.js';
|
|
16
|
-
export declare const ALL_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createDepExport", "createDepHandoverLink", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCashregisterReport", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getDepExport", "getDepExportFile", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "getReportV2", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyStock", "listMyStockLocations", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listReceipts", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "reportCustomerContract", "requestCustomerSignature", "revokeDepHandoverLink", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "logReceiptOutputs"];
|
|
16
|
+
export declare const ALL_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createDepExport", "createDepHandoverLink", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCashregisterReport", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getDepExport", "getDepExportFile", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "getReportV2", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyStock", "listMyStockLocations", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listReceipts", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "reportCustomerContract", "requestCustomerSignature", "revokeDepHandoverLink", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "logReceiptOutputs", "getRegisterInspectionInfo", "reportConnectState"];
|
|
17
17
|
export type ApiCall = typeof ALL_CALLS[number];
|
|
18
18
|
/**
|
|
19
19
|
* Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
|
|
@@ -29,7 +29,7 @@ export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "can
|
|
|
29
29
|
* die fuenf DEP-Aufrufe); die Kasse ruft sie trotzdem ueber diesen Weg (ein Dialekt
|
|
30
30
|
* je Client, Nachtrag §5.2).
|
|
31
31
|
*/
|
|
32
|
-
export declare const POS_CALLS: readonly ["pairRegisterDevice", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "registerUserLogin", "registerPinLogin", "renewRegisterSession", "endRegisterSession", "unpairRegisterDevice", "listMyCashregisters", "listMyReceipts", "getReceipt", "createReceipt", "generateFullReceiptId", "cancelReceipt", "sendReceiptEmail", "listMyArticleGroups", "listMyArticles", "getKasseSettings", "setMyKasseSettings", "setMyKasseLogo", "setMyRegisterDeviceSettings", "listMyPrinters", "createPrintJob", "getPrintJob", "listMyTipRecipients", "listMyStockLocations", "listMyStock", "setMyCashregisterStockLocation", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "logReceiptOutputs", "createDepExport", "getDepExport", "getDepExportFile", "createDepHandoverLink", "revokeDepHandoverLink"];
|
|
32
|
+
export declare const POS_CALLS: readonly ["pairRegisterDevice", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "registerUserLogin", "registerPinLogin", "renewRegisterSession", "endRegisterSession", "unpairRegisterDevice", "listMyCashregisters", "listMyReceipts", "getReceipt", "createReceipt", "generateFullReceiptId", "cancelReceipt", "sendReceiptEmail", "listMyArticleGroups", "listMyArticles", "getKasseSettings", "setMyKasseSettings", "setMyKasseLogo", "setMyRegisterDeviceSettings", "listMyPrinters", "createPrintJob", "getPrintJob", "listMyTipRecipients", "listMyStockLocations", "listMyStock", "setMyCashregisterStockLocation", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "logReceiptOutputs", "createDepExport", "getDepExport", "getDepExportFile", "createDepHandoverLink", "revokeDepHandoverLink", "getRegisterInspectionInfo", "reportConnectState"];
|
|
33
33
|
export type PublicCall = typeof PUBLIC_CALLS[number];
|
|
34
34
|
export type PosCall = typeof POS_CALLS[number];
|
|
35
35
|
/**
|
|
@@ -50,7 +50,7 @@ export type PosCall = typeof POS_CALLS[number];
|
|
|
50
50
|
* [ALL_CALLS], [PUBLIC_CALLS] und [POS_CALLS] steht entweder hier oder in
|
|
51
51
|
* [CALLS_WITHOUT_EFFECT] (Waechter `test/ausgang-einordnung.test.ts`).
|
|
52
52
|
*/
|
|
53
|
-
export declare const UNKNOWN_OUTCOME_CALLS: readonly ["activateCashregister", "addVariant", "cancelInvoice", "cancelReceipt", "cancelStocktake", "changeStockCondition", "closeMyShift", "closeStocktake", "createArticle", "createCreditNote", "createCustomer", "createCustomerCashregister", "createInvoiceItem", "createPartnerCustomer", "createPartnerWebhook", "createPrintJob", "createReceipt", "createReservation", "createStocktake", "createVariantGroup", "createWebhook", "deactivateArticle", "deletePartnerWebhook", "deleteWebhook", "extendReservation", "financeWebService", "hobexPayApi", "hobexRefundApi", "issueInvoice", "logMyDrawerOpenings", "logReceiptOutputs", "openMyShift", "orderSignatureCard", "pairRegisterDevice", "receiveGoods", "recordInvoicePayment", "recordMyCashMovement", "recordMyStocktakeCount", "recordStockLoss", "recordStocktakeCount", "recountStocktake", "releaseReservation", "reportCustomerContract", "requestCustomerSignature", "reverseStockMovement", "reviewStocktake", "revokeCustomerMandate", "rotatePartnerWebhookSecret", "rotateWebhookSecret", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "sendWebhookTest", "setCustomerMandate", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "transferStock", "unpairRegisterDevice", "updateArticle", "updateCustomer", "updateInvoiceItem", "updatePartnerWebhook", "updateVariantGroup", "updateWebhook", "voidMyStocktakeCount", "voidStocktakeCount", "withdrawInvoiceItem"];
|
|
53
|
+
export declare const UNKNOWN_OUTCOME_CALLS: readonly ["activateCashregister", "addVariant", "cancelInvoice", "cancelReceipt", "cancelStocktake", "changeStockCondition", "closeMyShift", "closeStocktake", "createArticle", "createCreditNote", "createCustomer", "createCustomerCashregister", "createInvoiceItem", "createPartnerCustomer", "createPartnerWebhook", "createPrintJob", "createReceipt", "createReservation", "createStocktake", "createVariantGroup", "createWebhook", "deactivateArticle", "deletePartnerWebhook", "deleteWebhook", "extendReservation", "financeWebService", "hobexPayApi", "hobexRefundApi", "issueInvoice", "logMyDrawerOpenings", "logReceiptOutputs", "openMyShift", "orderSignatureCard", "pairRegisterDevice", "receiveGoods", "recordInvoicePayment", "recordMyCashMovement", "recordMyStocktakeCount", "recordStockLoss", "recordStocktakeCount", "recountStocktake", "releaseReservation", "reportConnectState", "reportCustomerContract", "requestCustomerSignature", "reverseStockMovement", "reviewStocktake", "revokeCustomerMandate", "rotatePartnerWebhookSecret", "rotateWebhookSecret", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "sendWebhookTest", "setCustomerMandate", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "transferStock", "unpairRegisterDevice", "updateArticle", "updateCustomer", "updateInvoiceItem", "updatePartnerWebhook", "updateVariantGroup", "updateWebhook", "voidMyStocktakeCount", "voidStocktakeCount", "withdrawInvoiceItem"];
|
|
54
54
|
/** Warum ein Aufruf keine Wirkung hat, die ein Zeitlimit offen lassen koennte. */
|
|
55
55
|
export type CallWithoutEffectReason = 'read' | 'repeatable';
|
|
56
56
|
/**
|
|
@@ -86,10 +86,10 @@ export declare const CALLS_WITHOUT_EFFECT: Readonly<Record<string, CallWithoutEf
|
|
|
86
86
|
* absetzt, sagt es mit `hasEffect: true`.
|
|
87
87
|
*/
|
|
88
88
|
export declare function isUnknownOutcomeCall(name: string): boolean;
|
|
89
|
-
/** Einer der
|
|
89
|
+
/** Einer der 48 Aufrufe des Kassenwegs. */
|
|
90
90
|
export declare function isPosCall(name: string): boolean;
|
|
91
91
|
/**
|
|
92
|
-
* Nur ueber den Kassenweg erreichbar (
|
|
92
|
+
* Nur ueber den Kassenweg erreichbar (37 Namen): unter `api.kasseneck.at/v3`
|
|
93
93
|
* gibt es sie nicht. Der Transport schickt sie darum ohne eigene Basis an
|
|
94
94
|
* [POS_BASE_URL] statt an die oeffentliche Basis.
|
|
95
95
|
*/
|
|
@@ -146,6 +146,10 @@ export const ALL_CALLS = [
|
|
|
146
146
|
'closeMyShift',
|
|
147
147
|
// Ausgaben eines Belegs (Drucke, Teilen) melden: nur ueber den Kassenweg.
|
|
148
148
|
'logReceiptOutputs',
|
|
149
|
+
// Kasseninfo fuer die Pruefung (Kassennachschau, Stufe 2b, ./pos): nur ueber den Kassenweg.
|
|
150
|
+
'getRegisterInspectionInfo',
|
|
151
|
+
// Connect-Bestand (./pos): welche Connect-Version an welchem Kassengeraet laeuft; nur ueber den Kassenweg.
|
|
152
|
+
'reportConnectState',
|
|
149
153
|
];
|
|
150
154
|
/**
|
|
151
155
|
* Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
|
|
@@ -338,6 +342,10 @@ export const POS_CALLS = [
|
|
|
338
342
|
'getDepExportFile',
|
|
339
343
|
'createDepHandoverLink',
|
|
340
344
|
'revokeDepHandoverLink',
|
|
345
|
+
// Kasseninfo fuer die Pruefung (Stufe 2b): nur ueber den Kassenweg, jeder Kassen-Benutzer.
|
|
346
|
+
'getRegisterInspectionInfo',
|
|
347
|
+
// Connect-Bestand: nur ueber den Kassenweg, jeder Kassen-Benutzer.
|
|
348
|
+
'reportConnectState',
|
|
341
349
|
];
|
|
342
350
|
/**
|
|
343
351
|
* Die Aufrufe **mit Wirkung**, alphabetisch: sie legen etwas an, aendern oder
|
|
@@ -400,6 +408,7 @@ export const UNKNOWN_OUTCOME_CALLS = [
|
|
|
400
408
|
'recordStocktakeCount',
|
|
401
409
|
'recountStocktake',
|
|
402
410
|
'releaseReservation',
|
|
411
|
+
'reportConnectState',
|
|
403
412
|
'reportCustomerContract',
|
|
404
413
|
'requestCustomerSignature',
|
|
405
414
|
'reverseStockMovement',
|
|
@@ -491,6 +500,7 @@ export const CALLS_WITHOUT_EFFECT = Object.freeze({
|
|
|
491
500
|
getPartnerInfo: 'read',
|
|
492
501
|
getPrintJob: 'read',
|
|
493
502
|
getReceipt: 'read',
|
|
503
|
+
getRegisterInspectionInfo: 'read',
|
|
494
504
|
getReportV2: 'read',
|
|
495
505
|
getReservation: 'read',
|
|
496
506
|
getStock: 'read',
|
|
@@ -552,12 +562,12 @@ export function isUnknownOutcomeCall(name) {
|
|
|
552
562
|
const OEFFENTLICH = new Set(PUBLIC_CALLS);
|
|
553
563
|
const KASSENWEG = new Set(POS_CALLS);
|
|
554
564
|
const NUR_KASSE = new Set(POS_CALLS.filter((name) => !OEFFENTLICH.has(name)));
|
|
555
|
-
/** Einer der
|
|
565
|
+
/** Einer der 48 Aufrufe des Kassenwegs. */
|
|
556
566
|
export function isPosCall(name) {
|
|
557
567
|
return KASSENWEG.has(name);
|
|
558
568
|
}
|
|
559
569
|
/**
|
|
560
|
-
* Nur ueber den Kassenweg erreichbar (
|
|
570
|
+
* Nur ueber den Kassenweg erreichbar (37 Namen): unter `api.kasseneck.at/v3`
|
|
561
571
|
* gibt es sie nicht. Der Transport schickt sie darum ohne eigene Basis an
|
|
562
572
|
* [POS_BASE_URL] statt an die oeffentliche Basis.
|
|
563
573
|
*/
|
|
@@ -91,16 +91,16 @@ export interface TransportOptions {
|
|
|
91
91
|
auth: KasseneckAuth;
|
|
92
92
|
/**
|
|
93
93
|
* Abweichende Basis der **oeffentlichen** Aufrufe (Vorgabe
|
|
94
|
-
* [DEFAULT_BASE_URL]): alles ausser den
|
|
94
|
+
* [DEFAULT_BASE_URL]): alles ausser den 48 Aufrufen des Kassenwegs, und die
|
|
95
95
|
* elf oeffentlichen davon nur, wenn nicht mit `registerUserAuth`
|
|
96
96
|
* angemeldet. Muss auf `/v3` enden (eigene Proxys erlaubt), sonst wirft das
|
|
97
97
|
* Anlegen; `/v1` oder `/api` gibt es in der 1.x-Linie nicht.
|
|
98
98
|
*/
|
|
99
99
|
baseUrl?: string;
|
|
100
100
|
/**
|
|
101
|
-
* Abweichende Basis des **Kassenwegs** (Vorgabe [POS_BASE_URL]): die
|
|
101
|
+
* Abweichende Basis des **Kassenwegs** (Vorgabe [POS_BASE_URL]): die 37
|
|
102
102
|
* reinen Kassenaufrufe (Kopplung, Anmeldung, Einstellungen, Artikel,
|
|
103
|
-
* Drucker, ...) und mit `registerUserAuth` alle
|
|
103
|
+
* Drucker, ...) und mit `registerUserAuth` alle 48 Aufrufe des Kassenwegs.
|
|
104
104
|
* Die Web-Kasse gibt `'/api/v3'` (gleicher Ursprung). Muss auf `/v3` enden
|
|
105
105
|
* (in der Regel `/api/v3`), sonst wirft das Anlegen.
|
|
106
106
|
*/
|
|
@@ -150,9 +150,9 @@ function createCore(options) {
|
|
|
150
150
|
pruefeKennung(kennung);
|
|
151
151
|
const kopfzeilenSenden = options.omitKasseneckHeaders !== true;
|
|
152
152
|
/**
|
|
153
|
-
* Basis je Aufruf. Die
|
|
153
|
+
* Basis je Aufruf. Die 37 reinen Kassenaufrufe gehen immer an den
|
|
154
154
|
* Kassenweg (unter der oeffentlichen Basis gibt es sie nicht), und die
|
|
155
|
-
* Kassen-Anmeldung ruft alle
|
|
155
|
+
* Kassen-Anmeldung ruft alle 48 Aufrufe des Kassenwegs dort, auch die elf
|
|
156
156
|
* oeffentlichen (Kanal `app`, darunter die DEP-Aufrufe). Was der Kassenweg gar nicht fuehrt
|
|
157
157
|
* (Berichte, Zahlungen, FinanzOnline), geht an die oeffentliche Basis.
|
|
158
158
|
*/
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import type { InternerTransport } from '../client/aufrufe.js';
|
|
2
|
+
/**
|
|
3
|
+
* Was die Kasse ueber Kasseneck Connect an Kasseneck meldet (Bestand: welche Connect-Version an welchem
|
|
4
|
+
* Kassengeraet laeuft). Nur Angaben, die die Kasse von Connect liest – nie IP, Rechner- oder Benutzername.
|
|
5
|
+
* Aeltere Connect-Versionen kennen `osVersion`, `arch` und `features` nicht: dann `null` bzw. `[]`.
|
|
6
|
+
*/
|
|
7
|
+
export interface ConnectStateReport {
|
|
8
|
+
/** Kassengeraet, an dem Connect laeuft. */
|
|
9
|
+
deviceId: string;
|
|
10
|
+
/** Connect-Version, z. B. `1.4.0`. */
|
|
11
|
+
version: string;
|
|
12
|
+
/** `macos`, `windows` oder `linux`. */
|
|
13
|
+
os: string;
|
|
14
|
+
osVersion: string | null;
|
|
15
|
+
arch: string | null;
|
|
16
|
+
/** Faehigkeiten aus `GET /v1/status` (`bluetooth`, `https`, `update` …). */
|
|
17
|
+
features: string[];
|
|
18
|
+
/** Ob HTTPS vertraut ist (`tls.trusted`), `null` ohne HTTPS. */
|
|
19
|
+
httpsTrusted: boolean | null;
|
|
20
|
+
/** Bluetooth-Stand (`poweredOn`, `poweredOff`, `unauthorized` …), `null` ohne Bluetooth. */
|
|
21
|
+
bluetooth: string | null;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* Meldet den Stand von Kasseneck Connect an diesem Kassengeraet (`reportConnectState`, nur Kassenweg).
|
|
25
|
+
* Geprueft wird nur die Form; was der Server nicht annimmt, lehnt er mit `invalid_connect_report` ab.
|
|
26
|
+
*/
|
|
27
|
+
export declare function reportConnectState(transport: InternerTransport, report: ConnectStateReport): Promise<void>;
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { KasseneckValidationError } from '../client/errors.js';
|
|
2
|
+
const FELDER = ['deviceId', 'version', 'os', 'osVersion', 'arch', 'features', 'httpsTrusted', 'bluetooth'];
|
|
3
|
+
/**
|
|
4
|
+
* Meldet den Stand von Kasseneck Connect an diesem Kassengeraet (`reportConnectState`, nur Kassenweg).
|
|
5
|
+
* Geprueft wird nur die Form; was der Server nicht annimmt, lehnt er mit `invalid_connect_report` ab.
|
|
6
|
+
*/
|
|
7
|
+
export async function reportConnectState(transport, report) {
|
|
8
|
+
const name = 'reportConnectState';
|
|
9
|
+
const anfrage = (grund) => new KasseneckValidationError(name, grund, 'request');
|
|
10
|
+
if (report === null || typeof report !== 'object' || Array.isArray(report))
|
|
11
|
+
throw anfrage('Anfrage muss ein Objekt sein');
|
|
12
|
+
const fremd = Object.keys(report).find((k) => !FELDER.includes(k));
|
|
13
|
+
if (fremd != null)
|
|
14
|
+
throw anfrage(`unbekanntes Feld "${fremd}"`);
|
|
15
|
+
const text = (v) => typeof v === 'string' && v.length > 0;
|
|
16
|
+
const textOderNull = (v) => v === null || typeof v === 'string';
|
|
17
|
+
if (!text(report.deviceId))
|
|
18
|
+
throw anfrage('deviceId fehlt');
|
|
19
|
+
if (!text(report.version))
|
|
20
|
+
throw anfrage('version fehlt');
|
|
21
|
+
if (!text(report.os))
|
|
22
|
+
throw anfrage('os fehlt');
|
|
23
|
+
if (!textOderNull(report.osVersion))
|
|
24
|
+
throw anfrage('osVersion muss Text oder null sein');
|
|
25
|
+
if (!textOderNull(report.arch))
|
|
26
|
+
throw anfrage('arch muss Text oder null sein');
|
|
27
|
+
if (!Array.isArray(report.features) || !report.features.every((f) => typeof f === 'string'))
|
|
28
|
+
throw anfrage('features muss eine Liste von Texten sein');
|
|
29
|
+
if (!(report.httpsTrusted === null || typeof report.httpsTrusted === 'boolean'))
|
|
30
|
+
throw anfrage('httpsTrusted muss true, false oder null sein');
|
|
31
|
+
if (!textOderNull(report.bluetooth))
|
|
32
|
+
throw anfrage('bluetooth muss Text oder null sein');
|
|
33
|
+
await transport(name, {
|
|
34
|
+
deviceId: report.deviceId, version: report.version, os: report.os, osVersion: report.osVersion, arch: report.arch,
|
|
35
|
+
features: [...report.features], httpsTrusted: report.httpsTrusted, bluetooth: report.bluetooth,
|
|
36
|
+
});
|
|
37
|
+
}
|
package/dist/esm/pos/errors.d.ts
CHANGED
|
@@ -2,13 +2,13 @@ import { KasseneckApiError } from '../client/errors.js';
|
|
|
2
2
|
/**
|
|
3
3
|
* Fehler der Kassen-Aufrufe um den Verkauf herum (Einstellungen, Logo,
|
|
4
4
|
* Artikel, Drucker, Trinkgeld-Empfaenger, Lager, Inventur zaehlen, Schicht,
|
|
5
|
-
* Kassenstand
|
|
5
|
+
* Kassenstand, Lade-Protokoll und Kasseninfo fuer die Pruefung) auswerten:
|
|
6
6
|
* am `code`, nie am Text.
|
|
7
7
|
* Belege, Storno und Belegmail haben eigene Listen (`RECEIPT_ERROR_CODES`,
|
|
8
8
|
* `CANCELLATION_ERROR_CODES`, `RECEIPT_EMAIL_ERROR_CODES`), die Anmeldung
|
|
9
9
|
* `REGISTER_ERROR_CODES` im Unterpfad `./register`.
|
|
10
10
|
*
|
|
11
|
-
* Abgeleitet aus dem Vertrags-Export (Fehlerfaelle dieser
|
|
11
|
+
* Abgeleitet aus dem Vertrags-Export (Fehlerfaelle dieser 25 Endpunkte in
|
|
12
12
|
* `fixtures/v3/antworten/kasse.json` und ihre Handler-Codes); ein Test haelt
|
|
13
13
|
* die Liste deckungsgleich. `validation` traegt `data.errors[]` mit dem
|
|
14
14
|
* aeusseren Feldpfad (`business.theme`, `device.shortcuts.splitPayment`).
|
package/dist/esm/pos/errors.js
CHANGED
|
@@ -2,13 +2,13 @@ import { KasseneckApiError } from '../client/errors.js';
|
|
|
2
2
|
/**
|
|
3
3
|
* Fehler der Kassen-Aufrufe um den Verkauf herum (Einstellungen, Logo,
|
|
4
4
|
* Artikel, Drucker, Trinkgeld-Empfaenger, Lager, Inventur zaehlen, Schicht,
|
|
5
|
-
* Kassenstand
|
|
5
|
+
* Kassenstand, Lade-Protokoll und Kasseninfo fuer die Pruefung) auswerten:
|
|
6
6
|
* am `code`, nie am Text.
|
|
7
7
|
* Belege, Storno und Belegmail haben eigene Listen (`RECEIPT_ERROR_CODES`,
|
|
8
8
|
* `CANCELLATION_ERROR_CODES`, `RECEIPT_EMAIL_ERROR_CODES`), die Anmeldung
|
|
9
9
|
* `REGISTER_ERROR_CODES` im Unterpfad `./register`.
|
|
10
10
|
*
|
|
11
|
-
* Abgeleitet aus dem Vertrags-Export (Fehlerfaelle dieser
|
|
11
|
+
* Abgeleitet aus dem Vertrags-Export (Fehlerfaelle dieser 25 Endpunkte in
|
|
12
12
|
* `fixtures/v3/antworten/kasse.json` und ihre Handler-Codes); ein Test haelt
|
|
13
13
|
* die Liste deckungsgleich. `validation` traegt `data.errors[]` mit dem
|
|
14
14
|
* aeusseren Feldpfad (`business.theme`, `device.shortcuts.splitPayment`).
|
package/dist/esm/pos/index.d.ts
CHANGED
|
@@ -15,6 +15,8 @@ export { cancelScopeOf, receiptsScopeOf, stockViewOf, voucherPermsOf, type Vouch
|
|
|
15
15
|
export { type NetworkPrinter, type PrintJob, type PrintJobStatus, PRINT_JOB_STATUSES, type PrintJobSource, PRINT_JOB_SOURCES, isPrintJobFinished, type CreatePrintJobOptions, listMyPrinters, createPrintJob, getPrintJob, } from './drucker.js';
|
|
16
16
|
export { listMyTipRecipients } from './trinkgeld.js';
|
|
17
17
|
export { depFolderName } from './dep.js';
|
|
18
|
+
export { type RegisterInspectionInfo, type RegisterInspectionSignature, type InspectionSignatureStatus, type InspectionInfoRow, type InspectionInfoRowKey, type InspectionInfoSection, type InspectionInfoLinesOptions, getRegisterInspectionInfo, inspectionInfoRows, inspectionInfoLines, } from './kasseninfo.js';
|
|
19
|
+
export { type ConnectStateReport, reportConnectState } from './connect-bestand.js';
|
|
18
20
|
export { STOCK_LOCATION_TYPES, type StockLocationType, type StockLocation, type StockLocationAddress, type StockLevel, type StockValue, type StockList, type ListMyStockOptions, type SetMyCashregisterStockLocationOptions, type CashregisterStockLocation, listMyStockLocations, listMyStock, setMyCashregisterStockLocation, } from './lager.js';
|
|
19
21
|
export { type ListMyStocktakesOptions, type ListMyStocktakeItemsOptions, type ListMyStocktakeCountsOptions, type RecordMyStocktakeCountOptions, type VoidMyStocktakeCountOptions, listMyStocktakes, listMyStocktakeItems, listMyStocktakeCounts, recordMyStocktakeCount, voidMyStocktakeCount, parseQuantityMilli, } from './inventur.js';
|
|
20
22
|
export type { Stocktake, StocktakeItem, StocktakeCount, StocktakeCountResult, StocktakeItemPage, StocktakeCountPage, StocktakeActor, StocktakeProgress, StocktakeReview, StocktakeRecount, StocktakeScope, } from '../inventory/typen.js';
|
package/dist/esm/pos/index.js
CHANGED
|
@@ -20,6 +20,10 @@ export { PRINT_JOB_STATUSES, PRINT_JOB_SOURCES, isPrintJobFinished, listMyPrinte
|
|
|
20
20
|
export { listMyTipRecipients } from './trinkgeld.js';
|
|
21
21
|
// Prüfung (DEP) an der Kasse: Ordner auf dem USB-Stick (gleich in Web-Kasse und Kassen-App).
|
|
22
22
|
export { depFolderName } from './dep.js';
|
|
23
|
+
// Prüfung an der Kasse: Kasseninfo für den Prüfer, am Bildschirm und als Ausdruck (gleich im Dart-Zwilling).
|
|
24
|
+
export { getRegisterInspectionInfo, inspectionInfoRows, inspectionInfoLines, } from './kasseninfo.js';
|
|
25
|
+
// Connect-Bestand: die Kasse meldet Version und System von Kasseneck Connect.
|
|
26
|
+
export { reportConnectState } from './connect-bestand.js';
|
|
23
27
|
export { STOCK_LOCATION_TYPES, listMyStockLocations, listMyStock, setMyCashregisterStockLocation, } from './lager.js';
|
|
24
28
|
export { listMyStocktakes, listMyStocktakeItems, listMyStocktakeCounts, recordMyStocktakeCount, voidMyStocktakeCount, parseQuantityMilli, } from './inventur.js';
|
|
25
29
|
// Gutschein pruefen und Etikett nachdrucken an der Kasse; Gutschein-Sorten (Stufe 4b, 1.17.0).
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import type { InternerTransport } from '../client/aufrufe.js';
|
|
2
|
+
/**
|
|
3
|
+
* Kasseninfo fuer die Pruefung (Kassennachschau, Stufe 2b): was die Kasse dem
|
|
4
|
+
* Pruefer ueber sich sagt – Produkt, Hersteller, Kassen-ID, Signatur,
|
|
5
|
+
* DEP, Abschluesse und Kontakt. Die Werte kommen vom Kassenweg
|
|
6
|
+
* (`getRegisterInspectionInfo`), die Woerter aus dem Katalog (`inspection.*`).
|
|
7
|
+
*
|
|
8
|
+
* Am Bildschirm und auf dem Ausdruck steht derselbe Text: [inspectionInfoRows]
|
|
9
|
+
* fuer den Bildschirm (Bezeichnung und Wertzeilen), [inspectionInfoLines] fuer
|
|
10
|
+
* den Bondrucker (Textzeilen in Bonbreite). Die Prueffaelle stehen in
|
|
11
|
+
* `fixtures/inspection-info-cases.json`; der Dart-Zwilling rechnet gegen
|
|
12
|
+
* dieselbe Datei.
|
|
13
|
+
*
|
|
14
|
+
* Fehlt ein Wert, entfaellt die Zeile; ein „unbekannt“ steht nie da.
|
|
15
|
+
*/
|
|
16
|
+
/** Stand der Signatureinheit: in Betrieb oder ein offener Ausfall der Kasse. */
|
|
17
|
+
export type InspectionSignatureStatus = 'active' | 'outage';
|
|
18
|
+
/**
|
|
19
|
+
* Signatureinheit der Kasse, wie das Zertifikat sie nennt. Zeitpunkte als
|
|
20
|
+
* ISO-8601 in UTC; die Seriennummer dezimal als Text (sie kann groesser als
|
|
21
|
+
* 2^53 sein). Was der Server nicht sicher weiss, fehlt.
|
|
22
|
+
*/
|
|
23
|
+
export interface RegisterInspectionSignature {
|
|
24
|
+
/** Anbieter der Karte; heute nur `a_trust`. Fehlt bei Testkarten und unbekanntem Anbieter. */
|
|
25
|
+
provider?: string;
|
|
26
|
+
serialHex?: string;
|
|
27
|
+
serialDecimal?: string;
|
|
28
|
+
/** Inhaber laut Zertifikat, etwa `UID ATU12345675`. */
|
|
29
|
+
holder?: string;
|
|
30
|
+
/** Aussteller laut Zertifikat. */
|
|
31
|
+
issuer?: string;
|
|
32
|
+
validFrom?: string;
|
|
33
|
+
validTo?: string;
|
|
34
|
+
/** `true` nur, wenn der Inhaber mit A-Trust abgeglichen ist und passt. */
|
|
35
|
+
holderChecked?: boolean;
|
|
36
|
+
/** Testkarte (Sandbox); fehlt die Angabe, gilt `false`. */
|
|
37
|
+
testCard: boolean;
|
|
38
|
+
/** Fehlt, wenn der Server keinen oder einen diesem Paket unbekannten Stand meldet. */
|
|
39
|
+
status?: InspectionSignatureStatus;
|
|
40
|
+
/** Beginn eines offenen Ausfalls (nur bei `status: 'outage'`). */
|
|
41
|
+
outageSince?: string;
|
|
42
|
+
}
|
|
43
|
+
/** Antwort von [getRegisterInspectionInfo]. Jedes Feld kann fehlen, `signature` ist dann `null`. */
|
|
44
|
+
export interface RegisterInspectionInfo {
|
|
45
|
+
cashregisterId?: string;
|
|
46
|
+
product?: {
|
|
47
|
+
name?: string;
|
|
48
|
+
cloudBased?: boolean;
|
|
49
|
+
};
|
|
50
|
+
manufacturer?: {
|
|
51
|
+
name?: string;
|
|
52
|
+
vatId?: string;
|
|
53
|
+
};
|
|
54
|
+
/** `null` ohne Signatureinheit oder ohne lesbares Zertifikat einer echten Karte. */
|
|
55
|
+
signature: RegisterInspectionSignature | null;
|
|
56
|
+
/** Zeitplan des Monatsbelegs; `monthlyTime` als `HH:MM` in `timeZone`. */
|
|
57
|
+
closings?: {
|
|
58
|
+
monthlyDay?: number;
|
|
59
|
+
monthlyTime?: string;
|
|
60
|
+
timeZone?: string;
|
|
61
|
+
annualIsDecember?: boolean;
|
|
62
|
+
};
|
|
63
|
+
/** Kontaktadresse fuer den Pruefer; kommt nur vom Server, nie fest aus der Kasse. */
|
|
64
|
+
contactEmail?: string;
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Kasseninfo fuer die Pruefung (`getRegisterInspectionInfo`, nur Kassenweg).
|
|
68
|
+
* Jeder Kassen-Benutzer darf sie lesen, ebenso ein Geraet mit API-Schluessel;
|
|
69
|
+
* die Kasse ist die der Anmeldung. Liest nur, aendert nichts.
|
|
70
|
+
*/
|
|
71
|
+
export declare function getRegisterInspectionInfo(transport: InternerTransport): Promise<RegisterInspectionInfo>;
|
|
72
|
+
/** Teil der Kasseninfo, zu dem eine Zeile gehoert; vor `signature` steht die Ueberschrift „Signatur“. */
|
|
73
|
+
export type InspectionInfoSection = 'register' | 'signature' | 'operation';
|
|
74
|
+
/** Kennung einer Zeile der Kasseninfo, in der Reihenfolge der Ausgabe. */
|
|
75
|
+
export type InspectionInfoRowKey = 'product' | 'manufacturer' | 'cashregister_id' | 'unit' | 'hosting' | 'certificate' | 'holder' | 'issuer' | 'valid' | 'check' | 'status' | 'dep' | 'closings' | 'contact';
|
|
76
|
+
/**
|
|
77
|
+
* Eine Zeile der Kasseninfo am Bildschirm: Bezeichnung und eine oder mehrere
|
|
78
|
+
* Wertzeilen (die Seriennummer hat zwei). `label` ist leer bei `product`: die
|
|
79
|
+
* Zeile steht ohne Bezeichnung ueber die ganze Breite.
|
|
80
|
+
*/
|
|
81
|
+
export interface InspectionInfoRow {
|
|
82
|
+
key: InspectionInfoRowKey;
|
|
83
|
+
section: InspectionInfoSection;
|
|
84
|
+
label: string;
|
|
85
|
+
value: string[];
|
|
86
|
+
}
|
|
87
|
+
/** Optionen von [inspectionInfoLines]. */
|
|
88
|
+
export interface InspectionInfoLinesOptions {
|
|
89
|
+
/** Zeichen je Zeile des Bondruckers (meist 32, 42 oder 48), mindestens 24. */
|
|
90
|
+
width: number;
|
|
91
|
+
/** Zeitpunkt des Drucks; die letzte Zeile nennt ihn in Wiener Zeit. */
|
|
92
|
+
printedAt: Date;
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* Die Zeilen der Kasseninfo fuer den Bildschirm, in der Reihenfolge des
|
|
96
|
+
* Ausdrucks. Ueberschrift („Kasseninfo für die Prüfung“, `inspection.title`),
|
|
97
|
+
* die Ueberschrift vor dem Teil `signature` (`inspection.signature`) und der
|
|
98
|
+
* Absatz „So arbeitet die Kasse:“ (`inspection.how_it_works`,
|
|
99
|
+
* `inspection.how_it_works_text`) kommen aus dem Katalog.
|
|
100
|
+
*/
|
|
101
|
+
export declare function inspectionInfoRows(info: RegisterInspectionInfo): InspectionInfoRow[];
|
|
102
|
+
/**
|
|
103
|
+
* Die Kasseninfo als Textzeilen fuer den Bondrucker: kein Belegkopf, keine
|
|
104
|
+
* Belegnummer, nicht signiert (kein Beleg). Ueberschriften in Grossschrift,
|
|
105
|
+
* Bezeichnungen in einer Spalte von 13 Zeichen, lange Werte brechen wortweise
|
|
106
|
+
* in der Wertspalte um. Zwischen den Bloecken eine Leerzeile, am Ende
|
|
107
|
+
* „Gedruckt TT.MM.JJJJ, HH:MM“ (Wiener Zeit). Keine Zeile ist laenger als
|
|
108
|
+
* [InspectionInfoLinesOptions.width].
|
|
109
|
+
*/
|
|
110
|
+
export declare function inspectionInfoLines(info: RegisterInspectionInfo, options: InspectionInfoLinesOptions): string[];
|