# Kasseneck API

> Kasseneck ist eine österreichische Registrierkassen-/RKSV-Plattform (ein Produkt der Kreiseck). Die Kasseneck API ist eine HTTPS-Schnittstelle, mit der POS-Systeme, Kassenhersteller und Integrationspartner RKSV-konforme Belege erstellen (signieren), abrufen und als PDF laden. Belege werden mit ES256 signiert und in ein manipulationssicheres DEP (Datenerfassungsprotokoll) verkettet, gemäß RKSV / BAO §131 / BMF.

Basis-URL: `https://api.kasseneck.at/v2/` (HTTPS, versioniert). Antwort-Envelope: `{ "status": "success"|"error", "message": string, "data": object }` (HTTP 200, fachliche Fehler ebenfalls mit status "error").

Authentifizierung (Geräte-Endpunkte): Header `Authorization: Bearer <api_key>` (Präfix `kr_live_` bzw. `kr_test_`) und `cashregister-token: <token>` (Präfix `cb_live_` / `cb_test_`). Umgebungen: `kr_test_` = Sandbox (production:false, Testsignatur, nicht rechtsgültig, zum Integrieren); `kr_live_` = echte, rechtsgültige RKSV-Belege.

## Endpunkte

- [createReceipt](https://api.kasseneck.at/v2/createReceipt): POST. Erstellt und signiert einen Beleg. Erster Beleg einer Kasse muss `receiptType:"start"` sein (Startbeleg, ohne Positionen), danach `standard` mit `items`. `receiptType`: start | standard | zero | cancellation | training. Body: `{"params":{"receiptType","paymentMethod","items":[{"name","quantity","unitPriceCents","vatRate"}],"vouchers"?}}`. Erfordert aktives Modul `registrierkasse`. Antwort: `data.receipt` mit `sig` (JWS ES256), `qr`, `fullReceiptId`.
- [getReceipt](https://api.kasseneck.at/v2/getReceipt): POST. Ruft einen Beleg per `receiptId` ab. Body: `{"params":{"receiptId"}}`.
- [downloadReceipt](https://api.kasseneck.at/v2/downloadReceipt): GET. Liefert das Beleg-PDF (`application/pdf`). Autorisierung nur über `?fullReceiptId=<token>` aus der createReceipt-Antwort (Capability-Link, kein API-Schlüssel).

## SDKs

- [kasseneck_api (Dart/Flutter)](https://pub.dev/packages/kasseneck_api): offizielles Paket auf pub.dev für Flutter-/Dart-Apps. Empfohlener Weg zur Integration ohne manuelle HTTP-Aufrufe. Installation: `dependencies: kasseneck_api: ^1.0.0` in der pubspec.yaml.

## Dokumentation

- [OpenAPI 3.1 Spezifikation](https://api.kasseneck.at/openapi.yaml): vollständige maschinenlesbare Definition aller Endpunkte, Parameter, Schemas und Beispiele.
- [Interaktive Referenz](https://api.kasseneck.at/reference): durchsuchbare Endpunkt-Referenz für Menschen.
- [Startseite / Einstieg](https://api.kasseneck.at/): Überblick, Authentifizierung, Schnellstart mit curl.

## Hinweise

- USt-Sätze (Österreich) für `items.vat`: 20, 10, 13, 0, 19, 4.9.
- Zahlungsarten (`paymentMethod`): cash, creditCard, online, uberApp, uberCard, uberCash, boltApp, boltCash, boltCard.
- Zugang und API-Schlüssel auf Anfrage. Kasseneck — ein Produkt der Kreiseck.