@kreiseck/kasseneck-api 1.0.0-rc.4 → 1.0.0

package/fixtures/pos-message-cases.json

@@ -1,5 +1,5 @@
 {
-  "version": 1,
+  "version": 2,
   "cases": [
     { "name": "api: der Satz des Backends, woertlich",
       "error": { "kind": "api", "serverMessage": "Kopplungs-Code ist abgelaufen." },
@@ -7,6 +7,27 @@
     { "name": "api: auch ein Satz, der wie ein Ersatz aussieht, bleibt der des Backends",
       "error": { "kind": "api", "serverMessage": "PIN falsch, noch 2 Versuche." },
       "fallback": "Die Anmeldung ist fehlgeschlagen. Bitte erneut versuchen.", "expected": "PIN falsch, noch 2 Versuche." },
+    { "name": "api: ein fachlicher Code geht mit dem Satz des Backends durch",
+      "error": { "kind": "api", "code": "session_expired", "serverMessage": "Sitzung abgelaufen. Bitte erneut anmelden." },
+      "fallback": "Ersatz.", "expected": "Sitzung abgelaufen. Bitte erneut anmelden." },
+    { "name": "api route_missing: HTML statt Backend, Menschentext statt Satz des Pakets",
+      "error": { "kind": "api", "code": "route_missing", "serverMessage": "Route fehlt: die Antwort ist eine HTML-Seite statt des Backends" },
+      "fallback": "Ersatz.", "expected": { "key": "server.connection_disturbed" } },
+    { "name": "api dialect_mismatch: Server spricht nicht /v3, Ausgang unklar, erst nachsehen",
+      "error": { "kind": "api", "code": "dialect_mismatch", "serverMessage": "Server spricht nicht /v3 (Kennzeichen Kasseneck-Api-Version fehlt); Antwort verworfen" },
+      "fallback": "Ersatz.", "expected": { "key": "server.response_unreadable" } },
+    { "name": "api not_found: der Rand kennt den Endpunkt nicht",
+      "error": { "kind": "api", "code": "not_found", "serverMessage": "Unknown endpoint" },
+      "fallback": "Ersatz.", "expected": { "key": "server.connection_disturbed" } },
+    { "name": "api internal_translation_error: der Rand konnte die Anfrage nicht uebersetzen",
+      "error": { "kind": "api", "code": "internal_translation_error", "serverMessage": "Internal translation error" },
+      "fallback": "Ersatz.", "expected": { "key": "server.connection_disturbed" } },
+    { "name": "api response_translation_failed: der Rand konnte die Antwort nicht uebersetzen, Ausgang unklar",
+      "error": { "kind": "api", "code": "response_translation_failed", "serverMessage": "Response translation failed" },
+      "fallback": "Ersatz.", "expected": { "key": "server.response_unreadable" } },
+    { "name": "api response_unreadable: Erfolg gemeldet, Antwort unlesbar, Ausgang unklar",
+      "error": { "kind": "api", "code": "response_unreadable", "serverMessage": "Erfolg gemeldet, Antwort aber unlesbar (Antwort nicht lesbar). Der Vorgang kann ausgefuehrt sein: nicht wiederholen, sondern nachlesen." },
+      "fallback": "Ersatz.", "expected": { "key": "server.response_unreadable" } },
     { "name": "plain_text: sein eigener Text",
       "error": { "kind": "plain_text", "text": "Eigener Satz fuer den Schirm." },
       "fallback": "Ersatz.", "expected": "Eigener Satz fuer den Schirm." },
@@ -16,6 +37,15 @@
     { "name": "network: keine Verbindung",
       "error": { "kind": "network" },
       "fallback": "Ersatz.", "expected": { "key": "network.no_connection" } },
+    { "name": "timeout auf einem Aufruf mit Wirkung: Ausgang unklar, erst nachsehen",
+      "error": { "kind": "timeout", "outcome": "unknown" },
+      "fallback": "Ersatz.", "expected": { "key": "network.outcome_unknown" } },
+    { "name": "network auf einem Aufruf mit Wirkung: Ausgang unklar, erst nachsehen",
+      "error": { "kind": "network", "outcome": "unknown" },
+      "fallback": "Ersatz.", "expected": { "key": "network.outcome_unknown" } },
+    { "name": "network ohne Wirkung: abgelehnt, der Satz von rc.4",
+      "error": { "kind": "network", "outcome": "rejected" },
+      "fallback": "Ersatz.", "expected": { "key": "network.no_connection" } },
     { "name": "unexpected: HTML statt JSON (fehlender Rewrite)",
       "error": { "kind": "unexpected", "status": 404 },
       "fallback": "Ersatz.", "expected": { "key": "server.unexpected", "values": { "status": 404 } } },

package/fixtures/pos-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0-rc.4",
+  "version": "1.0.0",
   "messages": {
     "network.no_connection": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."
@@ -7,12 +7,21 @@
     "network.timeout": {
       "text": "Der Server antwortet nicht. Bitte die Internetverbindung prüfen und erneut versuchen."
     },
+    "network.outcome_unknown": {
+      "text": "Der Server hat nicht geantwortet, der Vorgang kann trotzdem gebucht sein. Bitte vor einem neuen Versuch prüfen, ob der letzte Vorgang schon gebucht ist."
+    },
     "server.unexpected": {
       "text": "Der Server hat unerwartet geantwortet (HTTP {status}). Bitte den Support verständigen.",
       "placeholders": [
         "status"
       ]
     },
+    "server.connection_disturbed": {
+      "text": "Die Verbindung zum Kassenserver ist gestört. Bitte kurz warten und erneut versuchen."
+    },
+    "server.response_unreadable": {
+      "text": "Die Antwort des Kassenservers war nicht lesbar. Bitte die Kasse neu öffnen und vor einem neuen Versuch prüfen, ob der letzte Vorgang schon gebucht ist."
+    },
     "pairing.code_missing": {
       "text": "Bitte den Kopplungs-Code eingeben."
     },
@@ -681,6 +690,48 @@
       "behavior": "fallback"
     }
   ],
+  "errorCodeRules": [
+    {
+      "kind": "api",
+      "codes": [
+        "dialect_mismatch",
+        "response_translation_failed",
+        "response_unreadable"
+      ],
+      "key": "server.response_unreadable"
+    },
+    {
+      "kind": "api",
+      "codes": [
+        "route_missing",
+        "not_found",
+        "internal_translation_error"
+      ],
+      "key": "server.connection_disturbed"
+    }
+  ],
+  "errorOutcomeRules": [
+    {
+      "kind": "timeout",
+      "outcome": "unknown",
+      "key": "network.outcome_unknown"
+    },
+    {
+      "kind": "network",
+      "outcome": "unknown",
+      "key": "network.outcome_unknown"
+    }
+  ],
+  "callsWithEffect": [
+    "createReceipt",
+    "cancelReceipt",
+    "financeWebService",
+    "hobexPayApi",
+    "hobexRefundApi",
+    "stripeCaptureIntent",
+    "createPrintJob",
+    "sendReceiptEmail"
+  ],
   "receiptEmailErrors": {
     "invalid_address": "receipt.mail_address_invalid",
     "too_many_requests": "receipt.mail_too_often",
@@ -714,6 +765,15 @@
     "pairing.pair_again": {
       "text": "Neu koppeln"
     },
+    "register.device_unnamed": {
+      "text": "Kasse"
+    },
+    "login.locked_seconds": {
+      "text": "Noch {seconds} s gesperrt",
+      "placeholders": [
+        "seconds"
+      ]
+    },
     "logout.question": {
       "text": "Wirklich abmelden?"
     },
@@ -789,6 +849,13 @@
     "split.remaining": {
       "text": "Rest"
     },
+    "split.remaining_with_rounding": {
+      "text": "Rest inkl. Rundung {amount} ({cents} ct)",
+      "placeholders": [
+        "amount",
+        "cents"
+      ]
+    },
     "split.divide": {
       "text": "÷ {n}",
       "placeholders": [

package/fixtures/receipt-due-errors.json

@@ -0,0 +1,56 @@
+{
+  "_note": "Eingaben, aus denen sich der Zahlbetrag nicht rechnen laesst: receiptDueCents wirft ReceiptDueError mit code receipt_due_unavailable und dem reason des Falls, vor jedem Aufruf (nichts gesendet). Eingabe in der Form von receipt-due-generated.json. Von Hand gepflegt; gilt fuer npm und Dart.",
+  "version": 1,
+  "code": "receipt_due_unavailable",
+  "reasons": ["unknown_receipt_type", "tip_not_allowed", "invalid_item", "invalid_voucher", "invalid_tip", "unknown_payment_method", "tip_conflict", "tip_recipient_missing", "tip_without_goods"],
+  "cases": [
+    { "name": "Trinkgeld ohne Ware, Personal",
+      "input": { "receiptType": "standard", "items": [], "vouchers": [], "tip": 100, "tipRecipient": "staff" },
+      "expected": { "reason": "tip_without_goods" } },
+    { "name": "Trinkgeld ohne Ware, Inhaber",
+      "input": { "receiptType": "standard", "items": [], "vouchers": [], "tip": 100, "tipRecipient": "owner" },
+      "expected": { "reason": "tip_without_goods" } },
+    { "name": "Trinkgeld ohne Ware ueber payments[].tipCents",
+      "input": { "receiptType": "standard", "items": [], "vouchers": [], "payments": [{ "method": "cash", "tipCents": 50 }], "tipRecipient": "staff" },
+      "expected": { "reason": "tip_without_goods" } },
+    { "name": "Trinkgeld auf Ware zu 0 Cent",
+      "input": { "receiptType": "standard", "items": [{ "name": "A", "quantity": 1, "priceCents": 0, "vatRate": 20 }], "vouchers": [], "tip": 100, "tipRecipient": "staff" },
+      "expected": { "reason": "tip_without_goods" } },
+    { "name": "Trinkgeld ohne Ware mit Empfaengern",
+      "input": { "receiptType": "training", "items": [], "vouchers": [], "tip": { "cents": 100, "recipients": [{ "cents": 100, "owner": false }] } },
+      "expected": { "reason": "tip_without_goods" } },
+    { "name": "Trinkgeld am Nullbeleg",
+      "input": { "receiptType": "zero", "items": [], "vouchers": [], "tip": 100, "tipRecipient": "staff" },
+      "expected": { "reason": "tip_not_allowed" } },
+    { "name": "Trinkgeld am Storno",
+      "input": { "receiptType": "cancellation", "items": [{ "name": "A", "quantity": -1, "priceCents": 100, "vatRate": 20 }], "vouchers": [], "tip": 100, "tipRecipient": "staff" },
+      "expected": { "reason": "tip_not_allowed" } },
+    { "name": "unbekannter Belegtyp",
+      "input": { "receiptType": "invoice", "items": [{ "name": "A", "quantity": 1, "priceCents": 100, "vatRate": 20 }], "vouchers": [] },
+      "expected": { "reason": "unknown_receipt_type" } },
+    { "name": "Position ohne Steuersatz",
+      "input": { "receiptType": "standard", "items": [{ "name": "A", "quantity": 1, "priceCents": 100 }], "vouchers": [] },
+      "expected": { "reason": "invalid_item" } },
+    { "name": "Position mit halbem Cent",
+      "input": { "receiptType": "standard", "items": [{ "name": "A", "quantity": 1, "priceCents": 1.5, "vatRate": 20 }], "vouchers": [] },
+      "expected": { "reason": "invalid_item" } },
+    { "name": "Gutschein mit halbem Cent",
+      "input": { "receiptType": "standard", "items": [{ "name": "A", "quantity": 1, "priceCents": 100, "vatRate": 20 }], "vouchers": [{ "action": "redeem", "type": "value", "valueCents": 0.5 }] },
+      "expected": { "reason": "invalid_voucher" } },
+    { "name": "Trinkgeld 0 Cent",
+      "input": { "receiptType": "standard", "items": [{ "name": "A", "quantity": 1, "priceCents": 100, "vatRate": 20 }], "vouchers": [], "tip": 0, "tipRecipient": "staff" },
+      "expected": { "reason": "invalid_tip" } },
+    { "name": "Anteile ergeben nicht den Betrag",
+      "input": { "receiptType": "standard", "items": [{ "name": "A", "quantity": 1, "priceCents": 100, "vatRate": 20 }], "vouchers": [], "tip": { "cents": 100, "recipients": [{ "cents": 60, "owner": false }] } },
+      "expected": { "reason": "invalid_tip" } },
+    { "name": "Trinkgeld an unbekannter Zahlart",
+      "input": { "receiptType": "standard", "items": [{ "name": "A", "quantity": 1, "priceCents": 100, "vatRate": 20 }], "vouchers": [], "payments": [{ "method": "voucher", "tipCents": 10 }], "tipRecipient": "staff" },
+      "expected": { "reason": "unknown_payment_method" } },
+    { "name": "tip und payments[].tipCents zugleich",
+      "input": { "receiptType": "standard", "items": [{ "name": "A", "quantity": 1, "priceCents": 100, "vatRate": 20 }], "vouchers": [], "tip": 10, "payments": [{ "method": "cash", "tipCents": 10 }], "tipRecipient": "staff" },
+      "expected": { "reason": "tip_conflict" } },
+    { "name": "Trinkgeld ohne tipRecipient",
+      "input": { "receiptType": "standard", "items": [{ "name": "A", "quantity": 1, "priceCents": 100, "vatRate": 20 }], "vouchers": [], "tip": 100 },
+      "expected": { "reason": "tip_recipient_missing" } }
+  ]
+}

package/fixtures/surface.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0-rc.4",
+  "version": "1.0.0",
   "baseUrls": {
     "public": "https://api.kasseneck.at/v3",
     "pos": "https://kasse.kasseneck.at/api/v3"
@@ -399,6 +399,16 @@
     "splitPayment"
   ],
   "pos": {
+    "callsWithEffect": [
+      "createReceipt",
+      "cancelReceipt",
+      "financeWebService",
+      "hobexPayApi",
+      "hobexRefundApi",
+      "stripeCaptureIntent",
+      "createPrintJob",
+      "sendReceiptEmail"
+    ],
     "posErrorCodes": [
       "account_not_found",
       "admin_required",

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": "cee31126cc755fd21441abae289997aeb0884a15eb230ce231defd8bb0bdc0fd",
+    "inputsSha256": "eb87e762005b16d104ba737b7d2ba9108eaddf0ed4b6eea9d96817c261759758",
     "backendPackage": "@kreiseck/kasseneck-api@0.31.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": "cee31126cc755fd21441abae289997aeb0884a15eb230ce231defd8bb0bdc0fd",
+    "inputsSha256": "eb87e762005b16d104ba737b7d2ba9108eaddf0ed4b6eea9d96817c261759758",
     "backendPackage": "@kreiseck/kasseneck-api@0.31.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": "cee31126cc755fd21441abae289997aeb0884a15eb230ce231defd8bb0bdc0fd",
+    "inputsSha256": "eb87e762005b16d104ba737b7d2ba9108eaddf0ed4b6eea9d96817c261759758",
     "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
     "inputs": [
       "docs/api/fehlercodes.json",

package/fixtures/v3/antworten/kasse.json

@@ -4,7 +4,7 @@
     "default": {
       "sha256": "bf1e7c100e328517c72d5badf31904183efe22d1fddec308e2fe2722068854bc",
       "head": [],
-      "inputsSha256": "c2bd7a2b137ff4a84a7b6e68dada87a7141168456147e3f53fb061309cc8ccc4",
+      "inputsSha256": "be31e4ca73dc3851a6b303da8aff60ba25842c6641fc24779051bb07a671b649",
       "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
       "inputs": [
         "functions-kasse/test/unit/fixtures/kassen-welt.js",
@@ -24,7 +24,7 @@
         "channel",
         "note"
       ],
-      "inputsSha256": "69aca2a0a94edbbdf175470da3f45974bbd16de3a25aa84a36fb94414c683ee1",
+      "inputsSha256": "e76a8dd30e5411d23956f19ec239b06dafaf882515f79bc10c2be4e33838fd5f",
       "backendPackage": "@kreiseck/kasseneck-api@0.14.0",
       "inputs": [
         "functions-kasse/gemeinsam/api-rand.js",

package/fixtures/v3/antworten/rechnungen.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": "238d2c4f15c8da89d9c2c47b15dadbbabb94e9e35217e913529317c794c8a247",
-    "inputsSha256": "cee31126cc755fd21441abae289997aeb0884a15eb230ce231defd8bb0bdc0fd",
+    "inputsSha256": "eb87e762005b16d104ba737b7d2ba9108eaddf0ed4b6eea9d96817c261759758",
     "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
     "inputs": [
       "docs/api/fehlercodes.json",

package/fixtures/v3/antworten/storno.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": "86c7d842017f818e348b80ebebdce8492cfcbd76e388cba9de41a5c888114e6a",
-    "inputsSha256": "cee31126cc755fd21441abae289997aeb0884a15eb230ce231defd8bb0bdc0fd",
+    "inputsSha256": "eb87e762005b16d104ba737b7d2ba9108eaddf0ed4b6eea9d96817c261759758",
     "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
     "inputs": [
       "docs/api/fehlercodes.json",

package/fixtures/v3/stored/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": "829b877ae07ecccd85a6780a6fdb0855ec50d87f7de49c891788fc65ca339b40",
-    "inputsSha256": "cee31126cc755fd21441abae289997aeb0884a15eb230ce231defd8bb0bdc0fd",
+    "inputsSha256": "eb87e762005b16d104ba737b7d2ba9108eaddf0ed4b6eea9d96817c261759758",
     "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
     "inputs": [
       "docs/api/fehlercodes.json",

package/fixtures/v3/stored/kasse.json

@@ -4,7 +4,7 @@
     "default": {
       "sha256": "993dc13a802ce4c2f795a20e7de2d6d0aad6e471e47b60762c32127046a46e95",
       "head": [],
-      "inputsSha256": "c2bd7a2b137ff4a84a7b6e68dada87a7141168456147e3f53fb061309cc8ccc4",
+      "inputsSha256": "be31e4ca73dc3851a6b303da8aff60ba25842c6641fc24779051bb07a671b649",
       "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
       "inputs": [
         "functions-kasse/test/unit/fixtures/kassen-welt.js",
@@ -24,7 +24,7 @@
         "note",
         "baseline"
       ],
-      "inputsSha256": "69aca2a0a94edbbdf175470da3f45974bbd16de3a25aa84a36fb94414c683ee1",
+      "inputsSha256": "e76a8dd30e5411d23956f19ec239b06dafaf882515f79bc10c2be4e33838fd5f",
       "backendPackage": "@kreiseck/kasseneck-api@0.14.0",
       "inputs": [
         "functions-kasse/gemeinsam/api-rand.js",

package/fixtures/v3/stored/rechnungen.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": "0684ee4733a672313c1532837424978086b8da43b0b2cc64154d396ad0a047be",
-    "inputsSha256": "cee31126cc755fd21441abae289997aeb0884a15eb230ce231defd8bb0bdc0fd",
+    "inputsSha256": "eb87e762005b16d104ba737b7d2ba9108eaddf0ed4b6eea9d96817c261759758",
     "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
     "inputs": [
       "docs/api/fehlercodes.json",

package/fixtures/v3/v3-vokabular.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": "29994ca53adc96e7cb49b9e3688b102a69c126544ef092fc6579a2e1fcd0d555",
-    "inputsSha256": "cee31126cc755fd21441abae289997aeb0884a15eb230ce231defd8bb0bdc0fd",
+    "inputsSha256": "eb87e762005b16d104ba737b7d2ba9108eaddf0ed4b6eea9d96817c261759758",
     "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
     "inputs": [
       "docs/api/fehlercodes.json",

package/fixtures/v3/zahlbetrag-faelle.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": "b49a1f665005b1f3b286d2c02268373f84dfb40638177ceba15dd3cda8a7da62",
-    "inputsSha256": "cee31126cc755fd21441abae289997aeb0884a15eb230ce231defd8bb0bdc0fd",
+    "inputsSha256": "eb87e762005b16d104ba737b7d2ba9108eaddf0ed4b6eea9d96817c261759758",
     "backendPackage": "@kreiseck/kasseneck-api@0.31.0",
     "inputs": [
       "docs/api/fehlercodes.json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "1.0.0-rc.4",
+  "version": "1.0.0",
   "description": "Austrian fiscal cash register (RKSV) client for JavaScript and TypeScript: signed receipts, cancellations, card payments, receipt printing (ESC/POS), invoices. RKSV-Registrierkasse für JavaScript und TypeScript.",
   "license": "Apache-2.0",
   "author": "Kreiseck",