@kreiseck/kasseneck-api 1.5.0 → 1.6.0

package/dist/esm/invoice/endpunkte.js

@@ -12,6 +12,12 @@
  * **Nicht automatisch wiederholen.** Wer nach einem Zeitlimit erneut
  * ausstellt, tut das mit **demselben** `idempotencyKey`: dann kommt die schon
  * ausgestellte Rechnung zurueck (`replayed: true`) statt einer zweiten.
+ * Jeder Aufruf mit Wirkung (ausstellen, stornieren, gutschreiben, Zahlung
+ * nachtragen, Kunde anlegen oder aendern) meldet nach Zeitlimit, Netzfehler,
+ * HTTP 5xx oder unlesbarer Antwort `outcome: 'unknown'`: er kann gewirkt
+ * haben. Mit Schluessel denselben Schluessel erneut senden, ohne Schluessel
+ * (`updateCustomer`, `createCustomer` ohne) erst nachlesen. Lesen und der
+ * Probelauf (`previewInvoice`) bleiben `'rejected'`.
  *
  * Nach dem Senden wird nichts hart gecastet: fehlt ein zugesagtes Feld, wirft
  * der Aufruf `KasseneckValidationError` mit `scope:'response'`.
@@ -93,7 +99,10 @@ export async function searchCustomers(transport, search) {
 }
 // ---- Rechnungen -------------------------------------------------------------
 export async function issueInvoice(transport, request) {
-    const daten = await transport('issueInvoice', nutzlast(request));
+    const params = nutzlast(request);
+    // Ohne Typen kann `dryRun: true` hier ankommen: dann ist es ein Probelauf
+    // ohne Wirkung (sonst: `previewInvoice`).
+    const daten = await transport('issueInvoice', params, undefined, undefined, { hasEffect: params['dryRun'] !== true });
     const ergebnis = {
         invoice: pflichtObjekt('issueInvoice', daten, 'invoice'),
         replayed: objekt(daten)['replayed'] === true,
@@ -114,7 +123,9 @@ export async function issueInvoice(transport, request) {
  * Probelauf und Ausstellen kann sich der Kunde oder das Konto aendern.
  */
 export async function previewInvoice(transport, request) {
-    const daten = await transport('issueInvoice', { ...nutzlast(request), dryRun: true });
+    // Ein Probelauf schreibt nichts: nach einem Zeitlimit bleibt er `rejected`,
+    // obwohl `issueInvoice` sonst Wirkung hat.
+    const daten = await transport('issueInvoice', { ...nutzlast(request), dryRun: true }, undefined, undefined, { hasEffect: false });
     const ergebnis = { preview: pflichtObjekt('issueInvoice', daten, 'preview') };
     const notice = hinweise(daten);
     if (notice)

package/dist/esm/pos/texte.d.ts

@@ -661,12 +661,17 @@ export interface ErrorRuleDetail {
 export declare function findErrorRule(kind: ErrorKind, detail?: ErrorRuleDetail): ErrorRule;
 /**
  * Kassen-Aufrufe mit Wirkung, die sich nach einem Netzfehler nicht gefahrlos
- * wiederholen lassen: die sechs, deren Ausgang das Paket selbst als unklar
- * fuehrt (Beleg, auch Null- und Startbeleg ueber `createReceipt`, Storno,
- * FinanzOnline, die drei Geldwege), dazu der Druckjob (zweiter Bon) und die
- * Belegmail (zweite Mail). Ob die Anfrage vor dem Abriss schon draussen war,
- * sieht das Paket nicht (fetch wirft in beiden Faellen gleich); darum gilt
- * hier immer der vorsichtige Satz.
+ * wiederholen lassen: Beleg (auch Null- und Startbeleg ueber
+ * `createReceipt`), Storno, FinanzOnline, die drei Geldwege, der Druckjob
+ * (zweiter Bon) und die Belegmail (zweite Mail). Ob die Anfrage vor dem
+ * Abriss schon draussen war, sieht das Paket nicht (fetch wirft in beiden
+ * Faellen gleich); darum gilt hier immer der vorsichtige Satz, auch fuer
+ * einen Fehler, der vor dem Senden entstand.
+ *
+ * Seit 1.5.1 fuehrt der Transport jeden Aufruf mit Wirkung als unklar
+ * (`UNKNOWN_OUTCOME_CALLS`, eine Obermenge dieser Liste), und
+ * [messageOutcome] folgt zuerst ihm. Die Liste bleibt als Vertrag der
+ * Kassentexte (`callsWithEffect` in `fixtures/pos-texts.json`) unveraendert.
  */
 export declare const CALLS_WITH_EFFECT: readonly ["createReceipt", "cancelReceipt", "financeWebService", "hobexPayApi", "hobexRefundApi", "stripeCaptureIntent", "createPrintJob", "sendReceiptEmail"];
 /**

package/dist/esm/pos/texte.js

@@ -368,12 +368,17 @@ export function findErrorRule(kind, detail = {}) {
 }
 /**
  * Kassen-Aufrufe mit Wirkung, die sich nach einem Netzfehler nicht gefahrlos
- * wiederholen lassen: die sechs, deren Ausgang das Paket selbst als unklar
- * fuehrt (Beleg, auch Null- und Startbeleg ueber `createReceipt`, Storno,
- * FinanzOnline, die drei Geldwege), dazu der Druckjob (zweiter Bon) und die
- * Belegmail (zweite Mail). Ob die Anfrage vor dem Abriss schon draussen war,
- * sieht das Paket nicht (fetch wirft in beiden Faellen gleich); darum gilt
- * hier immer der vorsichtige Satz.
+ * wiederholen lassen: Beleg (auch Null- und Startbeleg ueber
+ * `createReceipt`), Storno, FinanzOnline, die drei Geldwege, der Druckjob
+ * (zweiter Bon) und die Belegmail (zweite Mail). Ob die Anfrage vor dem
+ * Abriss schon draussen war, sieht das Paket nicht (fetch wirft in beiden
+ * Faellen gleich); darum gilt hier immer der vorsichtige Satz, auch fuer
+ * einen Fehler, der vor dem Senden entstand.
+ *
+ * Seit 1.5.1 fuehrt der Transport jeden Aufruf mit Wirkung als unklar
+ * (`UNKNOWN_OUTCOME_CALLS`, eine Obermenge dieser Liste), und
+ * [messageOutcome] folgt zuerst ihm. Die Liste bleibt als Vertrag der
+ * Kassentexte (`callsWithEffect` in `fixtures/pos-texts.json`) unveraendert.
  */
 export const CALLS_WITH_EFFECT = Object.freeze([
     'createReceipt',

package/dist/esm/stored/vokabular.d.ts

@@ -1,5 +1,5 @@
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-export declare const VOKABULAR_QUELLE = "d351a778c02888291e325068f96156ad1346859f6ff97bae27f91089e9619e8c";
+export declare const VOKABULAR_QUELLE = "6e6eae018f1e84116d3942cbfd35bc2d5d6f5c5e5551823c7ed88f15ed407744";
 /** Schema-Notation des Vertrags: Blatt 'aussen': 'innen', Objekt { __: 'innen', ... }, Liste [ { __: 'innen', ... } ]. */
 export type SchemaEintrag = string | SchemaObjekt | readonly [SchemaObjekt];
 export interface SchemaObjekt {

package/dist/esm/stored/vokabular.js

@@ -1,7 +1,7 @@
 // Erzeugt von scripts/stored-vokabular.mjs aus fixtures/v3/v3-vokabular.json.
 // Nicht von Hand aendern: test/stored.test.ts vergleicht mit dem Vertrag.
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-export const VOKABULAR_QUELLE = "d351a778c02888291e325068f96156ad1346859f6ff97bae27f91089e9619e8c";
+export const VOKABULAR_QUELLE = "6e6eae018f1e84116d3942cbfd35bc2d5d6f5c5e5551823c7ed88f15ed407744";
 /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
 export const SCHEMAS = {
     "getReceipt": {

package/dist/esm/version.d.ts

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export declare const PACKAGE_VERSION = "1.5.0";
+export declare const PACKAGE_VERSION = "1.6.0";

package/dist/esm/version.js

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export const PACKAGE_VERSION = '1.5.0';
+export const PACKAGE_VERSION = '1.6.0';

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.5.0",
+  "version": "1.6.0",
   "measuredOn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/invoice-api.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "Kasseneck Rechnungs-API",
   "version": 2,
-  "package": "1.5.0",
+  "package": "1.6.0",
   "endpoints": {
     "createCustomer": {
       "request": {

package/fixtures/invoice-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.5.0",
+  "version": "1.6.0",
   "languages": [
     "de",
     "en"

package/fixtures/pos-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.5.0",
+  "version": "1.6.0",
   "messages": {
     "network.no_connection": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."

package/fixtures/surface.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.5.0",
+  "version": "1.6.0",
   "baseUrls": {
     "public": "https://api.kasseneck.at/v3",
     "pos": "https://kasse.kasseneck.at/api/v3"
@@ -81,7 +81,12 @@
       "extendReservation",
       "releaseReservation",
       "getReservation",
-      "listReservations"
+      "listReservations",
+      "createVariantGroup",
+      "updateVariantGroup",
+      "getVariantGroup",
+      "listVariantGroups",
+      "addVariant"
     ],
     "pos": [
       "cancelReceipt",
@@ -202,7 +207,12 @@
       "extendReservation",
       "releaseReservation",
       "getReservation",
-      "listReservations"
+      "listReservations",
+      "createVariantGroup",
+      "updateVariantGroup",
+      "getVariantGroup",
+      "listVariantGroups",
+      "addVariant"
     ],
     "pos": [
       "pairRegisterDevice",
@@ -235,6 +245,63 @@
       "setMyCashregisterStockLocation"
     ]
   },
+  "unknownOutcomeCalls": [
+    "activateCashregister",
+    "addVariant",
+    "cancelInvoice",
+    "cancelReceipt",
+    "changeStockCondition",
+    "createArticle",
+    "createCreditNote",
+    "createCustomer",
+    "createCustomerCashregister",
+    "createInvoiceItem",
+    "createPartnerCustomer",
+    "createPartnerWebhook",
+    "createPrintJob",
+    "createReceipt",
+    "createReservation",
+    "createVariantGroup",
+    "createWebhook",
+    "deactivateArticle",
+    "deletePartnerWebhook",
+    "deleteWebhook",
+    "extendReservation",
+    "financeWebService",
+    "hobexPayApi",
+    "hobexRefundApi",
+    "issueInvoice",
+    "pairRegisterDevice",
+    "receiveGoods",
+    "recordInvoicePayment",
+    "recordStockLoss",
+    "releaseReservation",
+    "reportCustomerContract",
+    "requestCustomerSignature",
+    "reverseStockMovement",
+    "revokeCustomerMandate",
+    "rotatePartnerWebhookSecret",
+    "rotateWebhookSecret",
+    "sendPartnerCustomerFonLink",
+    "sendPartnerWebhookTest",
+    "sendReceiptEmail",
+    "sendWebhookTest",
+    "setCustomerMandate",
+    "setMyCashregisterStockLocation",
+    "setMyKasseLogo",
+    "setMyKasseSettings",
+    "setMyRegisterDeviceSettings",
+    "stripeCaptureIntent",
+    "transferStock",
+    "unpairRegisterDevice",
+    "updateArticle",
+    "updateCustomer",
+    "updateInvoiceItem",
+    "updatePartnerWebhook",
+    "updateVariantGroup",
+    "updateWebhook",
+    "withdrawInvoiceItem"
+  ],
   "enums": {
     "autoLogoutMinutes": [
       0,
@@ -1016,7 +1083,12 @@
       "extendReservation",
       "releaseReservation",
       "getReservation",
-      "listReservations"
+      "listReservations",
+      "createVariantGroup",
+      "updateVariantGroup",
+      "getVariantGroup",
+      "listVariantGroups",
+      "addVariant"
     ],
     "inventoryErrorCodes": [
       "validation",
@@ -1079,7 +1151,12 @@
       "reason_required",
       "insufficient_available",
       "reservation_not_found",
-      "reservation_not_active"
+      "reservation_not_active",
+      "variant_group_not_found",
+      "variant_already_exists",
+      "invalid_variant_attributes",
+      "variant_group_inactive",
+      "variant_limit"
     ],
     "inventoryRequestErrorCodes": [
       "account_not_found",
@@ -1128,7 +1205,9 @@
       "article.deactivated",
       "reservation.expired",
       "reservation.released",
-      "reservation.redeemed"
+      "reservation.redeemed",
+      "variant_group.created",
+      "variant_group.updated"
     ],
     "landedCostAllocations": [
       "value",

package/fixtures/v3/antworten/belege.json

@@ -2,7 +2,7 @@
   "_hinweis": "Vertrags-Export /v3, erzeugt aus den echten Handlern (npm run vertrag:v3 in functions/ und functions-kasse/). Nicht von Hand pflegen.",
   "_quelle": {
     "sha256": "61892b91e6a8a0f273dcfdeb63809d92d98fb837a3c0baa782f03b29dd3b8b7a",
-    "inputsSha256": "b9dd3d819a4be22c35a201a788e7fcf947d90b6af7d9e41d3d74be3b48f8aa8e",
+    "inputsSha256": "8490315ac4059c3b26274649b8c3323295b26a6422a02da3a3cc241338cc797b",
     "backendPackage": "@kreiseck/kasseneck-api@0.33.0",
     "inputs": [
       "docs/api/fehlercodes.json",

package/fixtures/v3/antworten/belegmail.json

@@ -2,7 +2,7 @@
   "_hinweis": "Vertrags-Export /v3, erzeugt aus den echten Handlern (npm run vertrag:v3 in functions/ und functions-kasse/). Nicht von Hand pflegen.",
   "_quelle": {
     "sha256": "265bcf3e14cdea33ec3c4df399eb487d40c0d7793ee23d2ee12bcf664bcad550",
-    "inputsSha256": "b9dd3d819a4be22c35a201a788e7fcf947d90b6af7d9e41d3d74be3b48f8aa8e",
+    "inputsSha256": "8490315ac4059c3b26274649b8c3323295b26a6422a02da3a3cc241338cc797b",
     "backendPackage": "@kreiseck/kasseneck-api@0.33.0",
     "inputs": [
       "docs/api/fehlercodes.json",

package/fixtures/v3/antworten/kasse-belege.json

@@ -2,7 +2,7 @@
   "_hinweis": "Vertrags-Export /v3, erzeugt aus den echten Handlern (npm run vertrag:v3 in functions/ und functions-kasse/). Nicht von Hand pflegen.",
   "_quelle": {
     "sha256": "aad7147db385e4a6d88ba5fb59d24c04e7e1f01195778aa70ccdc68fb90adcd7",
-    "inputsSha256": "b9dd3d819a4be22c35a201a788e7fcf947d90b6af7d9e41d3d74be3b48f8aa8e",
+    "inputsSha256": "8490315ac4059c3b26274649b8c3323295b26a6422a02da3a3cc241338cc797b",
     "backendPackage": "@kreiseck/kasseneck-api@0.33.0",
     "inputs": [
       "docs/api/fehlercodes.json",

package/fixtures/v3/antworten/kasse.json

@@ -4,7 +4,7 @@
     "default": {
       "sha256": "bf1e7c100e328517c72d5badf31904183efe22d1fddec308e2fe2722068854bc",
       "head": [],
-      "inputsSha256": "3a500a9049bc0b7b3955d14e4df69e7c690270bdd6a31071c2ef50f08a9b30cb",
+      "inputsSha256": "10b8007647d9d9ba2a1c904b320f1ad5a97f66ab2ae3f4511ba18bfcbd616dea",
       "backendPackage": "@kreiseck/kasseneck-api@0.33.0",
       "inputs": [
         "functions-kasse/test/unit/fixtures/kassen-welt.js",
@@ -24,7 +24,7 @@
         "channel",
         "note"
       ],
-      "inputsSha256": "d1a29138f9bfdb32a861df2bc101f5be672e182c1387aa4f8f1786ab8de8fcc1",
+      "inputsSha256": "35cb1bb7c33a3eb238dd7a4a38ef604df1170e108afb3a8800fbf17ea6d3a3cb",
       "backendPackage": "@kreiseck/kasseneck-api@0.14.0",
       "inputs": [
         "functions-kasse/gemeinsam/api-rand.js",