@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.
Files changed (66) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/dist/cjs/client/aufrufe.d.ts +5 -5
  3. package/dist/cjs/client/aufrufe.js +12 -2
  4. package/dist/cjs/client/transport.d.ts +3 -3
  5. package/dist/cjs/client/transport.js +2 -2
  6. package/dist/cjs/pos/connect-bestand.d.ts +27 -0
  7. package/dist/cjs/pos/connect-bestand.js +40 -0
  8. package/dist/cjs/pos/errors.d.ts +2 -2
  9. package/dist/cjs/pos/errors.js +2 -2
  10. package/dist/cjs/pos/index.d.ts +2 -0
  11. package/dist/cjs/pos/index.js +10 -2
  12. package/dist/cjs/pos/kasseninfo.d.ts +110 -0
  13. package/dist/cjs/pos/kasseninfo.js +266 -0
  14. package/dist/cjs/pos/texte.d.ts +162 -2
  15. package/dist/cjs/pos/texte.js +67 -3
  16. package/dist/cjs/stored/vokabular.d.ts +1 -1
  17. package/dist/cjs/stored/vokabular.js +6 -1
  18. package/dist/cjs/version.d.ts +1 -1
  19. package/dist/cjs/version.js +1 -1
  20. package/dist/esm/client/aufrufe.d.ts +5 -5
  21. package/dist/esm/client/aufrufe.js +12 -2
  22. package/dist/esm/client/transport.d.ts +3 -3
  23. package/dist/esm/client/transport.js +2 -2
  24. package/dist/esm/pos/connect-bestand.d.ts +27 -0
  25. package/dist/esm/pos/connect-bestand.js +37 -0
  26. package/dist/esm/pos/errors.d.ts +2 -2
  27. package/dist/esm/pos/errors.js +2 -2
  28. package/dist/esm/pos/index.d.ts +2 -0
  29. package/dist/esm/pos/index.js +4 -0
  30. package/dist/esm/pos/kasseninfo.d.ts +110 -0
  31. package/dist/esm/pos/kasseninfo.js +261 -0
  32. package/dist/esm/pos/texte.d.ts +162 -2
  33. package/dist/esm/pos/texte.js +67 -3
  34. package/dist/esm/stored/vokabular.d.ts +1 -1
  35. package/dist/esm/stored/vokabular.js +6 -1
  36. package/dist/esm/version.d.ts +1 -1
  37. package/dist/esm/version.js +1 -1
  38. package/fixtures/expected/print-cut.sale-cash-default.hex +34 -0
  39. package/fixtures/expected/print-cut.sale-cash-full.hex +34 -0
  40. package/fixtures/expected/print-cut.sale-cash-mm58-none.hex +27 -0
  41. package/fixtures/expected/print-cut.sale-cash-mm58-partial.hex +27 -0
  42. package/fixtures/expected/print-cut.sale-cash-none.hex +33 -0
  43. package/fixtures/expected/print-cut.sale-cash-partial.hex +34 -0
  44. package/fixtures/expected/print-cut.sale-cash-true.hex +34 -0
  45. package/fixtures/expected/print-cut.zero-start-none.hex +38 -0
  46. package/fixtures/hobex-hps-codes.json +1 -1
  47. package/fixtures/inspection-info-cases.json +2348 -0
  48. package/fixtures/invoice-api.schema.json +1 -1
  49. package/fixtures/invoice-texts.json +1 -1
  50. package/fixtures/pos-texts.json +194 -3
  51. package/fixtures/print-cut-cases.json +47 -0
  52. package/fixtures/surface.json +8 -3
  53. package/fixtures/v3/antworten/belege.json +1 -1
  54. package/fixtures/v3/antworten/belegmail.json +1 -1
  55. package/fixtures/v3/antworten/berichte.json +1 -1
  56. package/fixtures/v3/antworten/kasse-belege.json +1 -1
  57. package/fixtures/v3/antworten/kasse.json +1814 -912
  58. package/fixtures/v3/antworten/lager.json +1 -1
  59. package/fixtures/v3/antworten/rechnungen.json +33 -33
  60. package/fixtures/v3/antworten/storno.json +1 -1
  61. package/fixtures/v3/stored/belege.json +1 -1
  62. package/fixtures/v3/stored/kasse.json +167 -4
  63. package/fixtures/v3/stored/rechnungen.json +253 -253
  64. package/fixtures/v3/v3-vokabular.json +37 -4
  65. package/fixtures/v3/zahlbetrag-faelle.json +1 -1
  66. 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 42 Aufrufe des Kassenwegs. */
89
+ /** Einer der 48 Aufrufe des Kassenwegs. */
90
90
  export declare function isPosCall(name: string): boolean;
91
91
  /**
92
- * Nur ueber den Kassenweg erreichbar (36 Namen): unter `api.kasseneck.at/v3`
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 42 Aufrufe des Kassenwegs. */
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 (36 Namen): unter `api.kasseneck.at/v3`
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 47 Aufrufen des Kassenwegs, und die
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 36
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 47 Aufrufe des Kassenwegs.
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 36 reinen Kassenaufrufe gehen immer an den
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 47 Aufrufe des Kassenwegs dort, auch die elf
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
+ }
@@ -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 und Lade-Protokoll) auswerten:
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 24 Endpunkte in
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`).
@@ -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 und Lade-Protokoll) auswerten:
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 24 Endpunkte in
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`).
@@ -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';
@@ -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[];