@kreiseck/kasseneck-api 0.14.0 → 0.16.0

package/fixtures/oberflaeche.json

@@ -1,8 +1,11 @@
 {
-  "version": "0.14.0",
+  "version": "0.16.0",
   "aufrufe": [
     "activateCashregister",
+    "cancelInvoice",
     "cancelReceipt",
+    "createCreditNote",
+    "createCustomer",
     "createCustomerCashregister",
     "createPartnerCustomer",
     "checkPartnerCustomerEmail",
@@ -16,9 +19,14 @@
     "endRegisterSession",
     "financeWebService",
     "generateFullReceiptId",
+    "getCustomer",
     "getCustomerCredentials",
     "getCustomerSignatureStatus",
     "getFirstReceiptDate",
+    "getInvoice",
+    "getInvoicePdf",
+    "getInvoiceSetupStatus",
+    "getInvoiceXml",
     "getKasseSettings",
     "getPartnerCustomer",
     "getPartnerInfo",
@@ -26,7 +34,9 @@
     "getReceipt",
     "hobexPayApi",
     "hobexRefundApi",
+    "issueInvoice",
     "listCustomerCashregisters",
+    "listInvoices",
     "listMyArticleGroups",
     "listMyArticles",
     "listMyCashregisters",
@@ -43,6 +53,7 @@
     "registerUserLogin",
     "renewRegisterSession",
     "requestCustomerSignature",
+    "searchCustomers",
     "sendPartnerCustomerFonLink",
     "sendPartnerWebhookTest",
     "sendReceiptEmail",
@@ -51,6 +62,7 @@
     "stripeCaptureIntent",
     "unpairRegisterDevice",
     "rotatePartnerWebhookSecret",
+    "updateCustomer",
     "updatePartnerWebhook"
   ],
   "enums": {
@@ -348,5 +360,93 @@
       "test",
       "data"
     ]
+  },
+  "rechnung": {
+    "creditNoteReasons": [
+      "cancellation",
+      "price_reduction",
+      "return",
+      "incorrect_invoice",
+      "other"
+    ],
+    "customerTypes": [
+      "private",
+      "company"
+    ],
+    "docTypes": [
+      "RE",
+      "GU"
+    ],
+    "einvoiceFormats": [
+      "ubl",
+      "cii"
+    ],
+    "invoiceErrorCodes": [
+      "validation",
+      "idempotency_conflict",
+      "module_inactive",
+      "customer_not_found",
+      "customer_exists",
+      "short_code_taken",
+      "short_code_immutable",
+      "recipient_required",
+      "invoice_requirements_missing",
+      "invoice_not_found",
+      "invoice_ambiguous",
+      "not_cancellable",
+      "partial_credit_exists",
+      "credit_exceeds_invoice",
+      "einvoice_incomplete",
+      "invoice_api_not_enabled",
+      "invoice_setup_incomplete"
+    ],
+    "invoiceListStatus": [
+      "final",
+      "paid",
+      "cancelled",
+      "open",
+      "overdue"
+    ],
+    "invoiceSetupRequirements": [
+      "module_active",
+      "api_enabled",
+      "live_enabled",
+      "business_name",
+      "address",
+      "vat_id",
+      "bank_account",
+      "number_format"
+    ],
+    "priceModes": [
+      "net",
+      "gross"
+    ],
+    "rechnungAufrufe": [
+      "createCustomer",
+      "getCustomer",
+      "updateCustomer",
+      "searchCustomers",
+      "issueInvoice",
+      "cancelInvoice",
+      "createCreditNote",
+      "getInvoice",
+      "listInvoices",
+      "getInvoicePdf",
+      "getInvoiceXml",
+      "getInvoiceSetupStatus"
+    ],
+    "taxSchemes": [
+      "normal",
+      "smallBusiness",
+      "reverseCharge",
+      "igLieferung",
+      "exportThirdCountry"
+    ],
+    "vatRates": [
+      0,
+      10,
+      13,
+      20
+    ]
   }
 }

package/fixtures/rechnung-api-beispiele/credit-fehler-grund.json

@@ -0,0 +1,24 @@
+{
+  "aufruf": "createCreditNote",
+  "beschreibung": "Unbekannter Grund",
+  "anfrage": {
+    "idempotencyKey": "bsp-12",
+    "invoiceId": "rechnung_beispiel",
+    "reason": "storno",
+    "items": [
+      {
+        "description": "Nachlass",
+        "quantity": 1,
+        "unitPriceCents": 5000,
+        "vatRate": 20
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "reason"
+    ]
+  }
+}

package/fixtures/rechnung-api-beispiele/credit-ok.json

@@ -0,0 +1,20 @@
+{
+  "aufruf": "createCreditNote",
+  "beschreibung": "Teilgutschrift als Preisnachlass",
+  "anfrage": {
+    "idempotencyKey": "bsp-11",
+    "invoiceId": "rechnung_beispiel",
+    "reason": "price_reduction",
+    "items": [
+      {
+        "description": "Nachlass Beratung",
+        "quantity": 1,
+        "unitPriceCents": 5000,
+        "vatRate": 20
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": true
+  }
+}

package/fixtures/rechnung-api-beispiele/customer-fehler-uid.json

@@ -0,0 +1,25 @@
+{
+  "aufruf": "createCustomer",
+  "beschreibung": "UID-Nummer im falschen Format",
+  "anfrage": {
+    "customer": {
+      "type": "company",
+      "name": "Café Muster GmbH",
+      "street": "Hauptplatz",
+      "houseNumber": "3",
+      "zip": "1010",
+      "city": "Wien",
+      "country": "AT",
+      "email": "rechnung@cafe-muster.example",
+      "externalId": "shop-4711",
+      "vatId": "ATU1"
+    }
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "customer.vatId"
+    ]
+  }
+}

package/fixtures/rechnung-api-beispiele/customer-get-fehler-beide.json

@@ -0,0 +1,15 @@
+{
+  "aufruf": "getCustomer",
+  "beschreibung": "Genau eine Kennung angeben",
+  "anfrage": {
+    "customerId": "kunde_beispiel",
+    "externalId": "shop-4711"
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "customerId"
+    ]
+  }
+}

package/fixtures/rechnung-api-beispiele/customer-ok.json

@@ -0,0 +1,20 @@
+{
+  "aufruf": "createCustomer",
+  "beschreibung": "Firmenkunde mit Kennung aus dem Shop",
+  "anfrage": {
+    "customer": {
+      "type": "company",
+      "name": "Café Muster GmbH",
+      "street": "Hauptplatz",
+      "houseNumber": "3",
+      "zip": "1010",
+      "city": "Wien",
+      "country": "AT",
+      "email": "rechnung@cafe-muster.example",
+      "externalId": "shop-4711"
+    }
+  },
+  "erwartet": {
+    "ok": true
+  }
+}

package/fixtures/rechnung-api-beispiele/customer-search-fehler-leer.json

@@ -0,0 +1,14 @@
+{
+  "aufruf": "searchCustomers",
+  "beschreibung": "Suche ohne Suchbegriff",
+  "anfrage": {
+    "limit": 10
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "externalId"
+    ]
+  }
+}

package/fixtures/rechnung-api-beispiele/issue-brutto-20.json

@@ -0,0 +1,27 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Bruttopreis: der Server rechnet die USt heraus",
+  "anfrage": {
+    "idempotencyKey": "bsp-2",
+    "customerId": "kunde_beispiel",
+    "taxScheme": "normal",
+    "priceMode": "gross",
+    "serviceStart": "2026-09-14",
+    "items": [
+      {
+        "description": "Frühstück",
+        "quantity": 1,
+        "unitPriceCents": 1200,
+        "vatRate": 20
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": true,
+    "totals": {
+      "netCents": 1000,
+      "vatCents": 200,
+      "grossCents": 1200
+    }
+  }
+}

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

@@ -0,0 +1,26 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Beträge in ganzen Cent",
+  "anfrage": {
+    "idempotencyKey": "bsp-9",
+    "customerId": "kunde_beispiel",
+    "taxScheme": "normal",
+    "priceMode": "net",
+    "serviceStart": "2026-09-14",
+    "items": [
+      {
+        "description": "Beratung",
+        "quantity": 1,
+        "unitPriceCents": 12.5,
+        "vatRate": 20
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "items[0].unitPriceCents"
+    ]
+  }
+}

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

@@ -0,0 +1,26 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Menge null",
+  "anfrage": {
+    "idempotencyKey": "bsp-10",
+    "customerId": "kunde_beispiel",
+    "taxScheme": "normal",
+    "priceMode": "net",
+    "serviceStart": "2026-09-14",
+    "items": [
+      {
+        "description": "Beratung",
+        "quantity": 0,
+        "unitPriceCents": 5000,
+        "vatRate": 20
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "items[0].quantity"
+    ]
+  }
+}

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

@@ -0,0 +1,26 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Negativer Preis gehört in eine Gutschrift",
+  "anfrage": {
+    "idempotencyKey": "bsp-7",
+    "customerId": "kunde_beispiel",
+    "taxScheme": "normal",
+    "priceMode": "net",
+    "serviceStart": "2026-09-14",
+    "items": [
+      {
+        "description": "Nachlass",
+        "quantity": 1,
+        "unitPriceCents": -1,
+        "vatRate": 20
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "items[0].unitPriceCents"
+    ]
+  }
+}

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

@@ -0,0 +1,26 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Steuerfreies Schema mit USt-Satz",
+  "anfrage": {
+    "idempotencyKey": "bsp-6",
+    "customerId": "kunde_beispiel",
+    "taxScheme": "smallBusiness",
+    "priceMode": "net",
+    "serviceStart": "2026-09-14",
+    "items": [
+      {
+        "description": "Reparatur",
+        "quantity": 1,
+        "unitPriceCents": 5000,
+        "vatRate": 20
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "items[0].vatRate"
+    ]
+  }
+}

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

@@ -0,0 +1,27 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Die Nummer vergibt der Server",
+  "anfrage": {
+    "idempotencyKey": "bsp-8",
+    "customerId": "kunde_beispiel",
+    "taxScheme": "normal",
+    "priceMode": "net",
+    "serviceStart": "2026-09-14",
+    "items": [
+      {
+        "description": "Beratung",
+        "quantity": 1,
+        "unitPriceCents": 5000,
+        "vatRate": 20
+      }
+    ],
+    "number": "2026-0001"
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "number"
+    ]
+  }
+}

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

@@ -0,0 +1,33 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Zwei Steuersätze auf einer Rechnung",
+  "anfrage": {
+    "idempotencyKey": "bsp-4",
+    "customerId": "kunde_beispiel",
+    "taxScheme": "normal",
+    "priceMode": "net",
+    "serviceStart": "2026-09-14",
+    "items": [
+      {
+        "description": "Beratung",
+        "quantity": 1,
+        "unitPriceCents": 10000,
+        "vatRate": 20
+      },
+      {
+        "description": "Buch",
+        "quantity": 1,
+        "unitPriceCents": 5000,
+        "vatRate": 10
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": true,
+    "totals": {
+      "netCents": 15000,
+      "vatCents": 2500,
+      "grossCents": 17500
+    }
+  }
+}

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

@@ -0,0 +1,27 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Kleinunternehmer: USt-Satz 0",
+  "anfrage": {
+    "idempotencyKey": "bsp-5",
+    "customerId": "kunde_beispiel",
+    "taxScheme": "smallBusiness",
+    "priceMode": "net",
+    "serviceStart": "2026-09-14",
+    "items": [
+      {
+        "description": "Reparatur",
+        "quantity": 1,
+        "unitPriceCents": 5000,
+        "vatRate": 0
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": true,
+    "totals": {
+      "netCents": 5000,
+      "vatCents": 0,
+      "grossCents": 5000
+    }
+  }
+}

package/fixtures/rechnung-api-beispiele/issue-netto-20.json

@@ -0,0 +1,28 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Zwei Positionen netto zu 20 %",
+  "anfrage": {
+    "idempotencyKey": "bsp-1",
+    "customerId": "kunde_beispiel",
+    "taxScheme": "normal",
+    "priceMode": "net",
+    "serviceStart": "2026-09-14",
+    "items": [
+      {
+        "description": "Beratung",
+        "quantity": 2,
+        "unitPriceCents": 5000,
+        "vatRate": 20,
+        "unit": "Std"
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": true,
+    "totals": {
+      "netCents": 10000,
+      "vatCents": 2000,
+      "grossCents": 12000
+    }
+  }
+}

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

@@ -0,0 +1,28 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Zeilenrabatt, gerundet wie auf dem PDF",
+  "anfrage": {
+    "idempotencyKey": "bsp-3",
+    "customerId": "kunde_beispiel",
+    "taxScheme": "normal",
+    "priceMode": "net",
+    "serviceStart": "2026-09-14",
+    "items": [
+      {
+        "description": "Kaffee",
+        "quantity": 3,
+        "unitPriceCents": 999,
+        "vatRate": 20,
+        "discountPct": 10
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": true,
+    "totals": {
+      "netCents": 2697,
+      "vatCents": 539,
+      "grossCents": 3236
+    }
+  }
+}

package/fixtures/rechnung-api-beispiele/setup-status-fehler-feld.json

@@ -0,0 +1,14 @@
+{
+  "aufruf": "getInvoiceSetupStatus",
+  "beschreibung": "Der Status kennt keine Parameter",
+  "anfrage": {
+    "environment": "live"
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "environment"
+    ]
+  }
+}

package/fixtures/rechnung-api-beispiele/setup-status-ok.json

@@ -0,0 +1,8 @@
+{
+  "aufruf": "getInvoiceSetupStatus",
+  "beschreibung": "Einrichtung abfragen, ohne Parameter",
+  "anfrage": {},
+  "erwartet": {
+    "ok": true
+  }
+}