@kreiseck/kasseneck-api 0.17.0 → 0.19.0

package/fixtures/kasse-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.17.0",
+  "version": "0.19.0",
   "meldungen": {
     "netz.keine_verbindung": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."

package/fixtures/oberflaeche.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.17.0",
+  "version": "0.19.0",
   "aufrufe": [
     "activateCashregister",
     "cancelInvoice",
@@ -50,6 +50,7 @@
     "listRegisterUsersForDevice",
     "listRegisterSessionsForDevice",
     "pairRegisterDevice",
+    "recordInvoicePayment",
     "registerPinLogin",
     "registerUserLogin",
     "renewRegisterSession",
@@ -401,7 +402,9 @@
       "invoice_api_not_enabled",
       "invoice_setup_incomplete",
       "language_not_allowed",
-      "brand_not_found"
+      "brand_not_found",
+      "not_payable",
+      "payment_exceeds_invoice"
     ],
     "invoiceLanguages": [
       "de",
@@ -414,6 +417,15 @@
       "open",
       "overdue"
     ],
+    "invoiceNoticeCodes": [
+      "cash_receipt_required"
+    ],
+    "invoicePaymentMethods": [
+      "transfer",
+      "card",
+      "online",
+      "cash"
+    ],
     "invoiceSetupRequirements": [
       "module_active",
       "api_enabled",
@@ -492,7 +504,8 @@
       "getInvoicePdf",
       "getInvoiceXml",
       "getInvoiceSetupStatus",
-      "listBrands"
+      "listBrands",
+      "recordInvoicePayment"
     ],
     "taxSchemes": [
       "normal",

package/fixtures/rechnung-api-beispiele/issue-bezahlt.json

@@ -0,0 +1,32 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Shop kassiert per Karte, Rechnung entsteht bezahlt",
+  "anfrage": {
+    "idempotencyKey": "bsp-bezahlt",
+    "customerId": "kunde_beispiel",
+    "taxScheme": "normal",
+    "priceMode": "net",
+    "serviceStart": "2026-09-16",
+    "items": [
+      {
+        "description": "Beratung",
+        "quantity": 2,
+        "unitPriceCents": 5000,
+        "vatRate": 20,
+        "unit": "hour"
+      }
+    ],
+    "payment": {
+      "method": "card",
+      "reference": "pi_3QbeispielXYZ"
+    }
+  },
+  "erwartet": {
+    "ok": true,
+    "totals": {
+      "netCents": 10000,
+      "vatCents": 2000,
+      "grossCents": 12000
+    }
+  }
+}

package/fixtures/rechnung-api-beispiele/issue-fehler-zahlungsart.json

@@ -0,0 +1,26 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Unbekannte Zahlungsart",
+  "anfrage": {
+    "idempotencyKey": "bsp-zahlungsart",
+    "taxScheme": "normal",
+    "priceMode": "net",
+    "serviceStart": "2026-09-16",
+    "items": [
+      {
+        "description": "Beratung",
+        "quantity": 1,
+        "unitPriceCents": 5000,
+        "vatRate": 20
+      }
+    ],
+    "payment": {
+      "method": "bitcoin"
+    }
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": ["payment.method"]
+  }
+}

package/fixtures/rechnung-api-beispiele/zahlung-fehler-ohne-schluessel.json

@@ -0,0 +1,14 @@
+{
+  "aufruf": "recordInvoicePayment",
+  "beschreibung": "Ohne Idempotenz-Schluessel — eine Wiederholung wuerde zweimal buchen",
+  "anfrage": {
+    "invoiceId": "rechnung_beispiel",
+    "method": "transfer",
+    "amountCents": 12000
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": ["idempotencyKey"]
+  }
+}

package/fixtures/rechnung-api-beispiele/zahlung-nachtrag.json

@@ -0,0 +1,14 @@
+{
+  "aufruf": "recordInvoicePayment",
+  "beschreibung": "Ueberweisung trifft spaeter ein",
+  "anfrage": {
+    "idempotencyKey": "bsp-zahlung-1",
+    "invoiceId": "rechnung_beispiel",
+    "method": "transfer",
+    "amountCents": 12000,
+    "paidAt": "2026-09-20"
+  },
+  "erwartet": {
+    "ok": true
+  }
+}

package/fixtures/rechnung-api.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "Kasseneck Rechnungs-API",
   "version": 1,
-  "paket": "0.17.0",
+  "paket": "0.19.0",
   "aufrufe": {
     "createCustomer": {
       "anfrage": {
@@ -464,6 +464,38 @@
             "type": "string",
             "minLength": 1,
             "maxLength": 128
+          },
+          "payment": {
+            "type": "object",
+            "properties": {
+              "method": {
+                "enum": [
+                  "transfer",
+                  "card",
+                  "online",
+                  "cash"
+                ]
+              },
+              "amountCents": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 100000000
+              },
+              "paidAt": {
+                "type": "string",
+                "minLength": 10,
+                "maxLength": 10,
+                "format": "date"
+              },
+              "reference": {
+                "type": "string",
+                "maxLength": 100
+              }
+            },
+            "required": [
+              "method"
+            ],
+            "additionalProperties": false
           }
         },
         "required": [
@@ -784,6 +816,52 @@
         "properties": {},
         "additionalProperties": false
       }
+    },
+    "recordInvoicePayment": {
+      "anfrage": {
+        "type": "object",
+        "properties": {
+          "idempotencyKey": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 120
+          },
+          "invoiceId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "method": {
+            "enum": [
+              "transfer",
+              "card",
+              "online",
+              "cash"
+            ]
+          },
+          "amountCents": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100000000
+          },
+          "paidAt": {
+            "type": "string",
+            "minLength": 10,
+            "maxLength": 10,
+            "format": "date"
+          },
+          "reference": {
+            "type": "string",
+            "maxLength": 100
+          }
+        },
+        "required": [
+          "idempotencyKey",
+          "invoiceId",
+          "method"
+        ],
+        "additionalProperties": false
+      }
     }
   },
   "codes": [
@@ -805,7 +883,9 @@
     "invoice_api_not_enabled",
     "invoice_setup_incomplete",
     "language_not_allowed",
-    "brand_not_found"
+    "brand_not_found",
+    "not_payable",
+    "payment_exceeds_invoice"
   ],
   "gruende": [
     "cancellation",

package/fixtures/rechnung-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.17.0",
+  "version": "0.19.0",
   "sprachen": [
     "de",
     "en"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "RKSV-Registrierkasse fuer JavaScript und TypeScript: signierte Belege, Storno, Kartenzahlung, Bondruck. Austrian fiscal cash register (RKSV) API client.",
   "license": "Apache-2.0",
   "author": "Kreiseck",