@kreiseck/kasseneck-api 0.27.1 → 0.27.3

package/CHANGELOG.md

@@ -4,6 +4,37 @@ Was vor 0.7.0 geschah, steht in der Commit-Historie (`git log`); ab hier wird
 es hier geführt. Ein Eintrag nennt die Änderung **und ihren Grund** —
 nur der Grund überlebt den nächsten Umbau.
 
+## 0.27.3
+
+- **`rechnungSummen` ist als veraltet markiert** (`@deprecated`), das Rechenergebnis bleibt
+  unverändert. Grund: seit dem 23.09.2026, 17:05 Uhr stellt der Server jede neue Rechnung über den
+  exakten Kern (`rechnungRechnen`) aus; `rechnungSummen` rechnet nach Weg 2 und liegt an
+  Halbcent-Grenzen einen Cent je Satz daneben (21,35 € netto zu 10 %: 23,48 € statt 23,49 €). Auf
+  den Kern umgestellt wird bewusst nicht: der Server schaltet ihn je Konto über `ganzzahlPflicht`,
+  Entwürfe außerhalb des Ausstellens rechnet er teils weiter nach Weg 2, und
+  `fixtures/rechnung-summen.json` prüfen Backend und Dart-Zwilling. Der Kopfkommentar behauptete
+  noch, die Funktion rechne „genau so wie der Server“; das ist berichtigt, README ebenso.
+- **`HpsRefundOptions`, `HpsCancelOptions`, `HpsConnectRefundOptions` und
+  `HpsConnectCancelOptions` werden unter `…/payments` exportiert** (nur hinzugefügt). Die Aufrufe
+  `refund`/`cancel` gab es dort schon, ihre Optionstypen nicht. Der Kopfkommentar von
+  `src/payments/index.ts` sagte noch, Gutschrift und Storno gingen nur über die Flutter-App; das
+  gilt seit Connect `/v1/terminal/refund` bzw. `/cancel` nicht mehr.
+- § 131b Abs. 1 Z 3 steht in der **BAO**, nicht im UStG: an `INVOICE_PAYMENT_METHODS` und
+  `PaymentInput.onSite` berichtigt (Wortlaut gegen das RIS geprüft). Ein Test hält künftig jede
+  Zuordnung von § 131 ff. zum UStG in `src/` fest.
+
+## 0.27.2
+
+- **README auf Englisch** und jede Angabe gegen den Code geprüft. Anfragen kommen inzwischen auch
+  aus dem Ausland, und auf npm ist Englisch die Erwartung. RKSV-Begriffe bleiben deutsch und
+  werden beim ersten Vorkommen erklärt; ein Glossar am Ende nennt dieselben Begriffe wie der
+  Dart-Zwilling. Eine kurze deutsche Einstiegsseite liegt als `README.de.md` im Repo.
+- Dabei berichtigt: Beispiele, die nicht kompilierten (`business` statt `betrieb`, `automatic`
+  statt `automatisch`, Einheit `'Std'`, optionale `logoUrl`), die Option `regelwerk` statt
+  `layoutRegeln`, die Druckwege (WebUSB, ePOS, Druckaufträge gehören zum Paket), `refund` und
+  `cancel` am HPS-Terminal, sechs statt drei anmeldungsfreie Aufrufe und § 131b **BAO**.
+- `package.json`: Beschreibung englisch zuerst, weitere englische Schlagwörter.
+
 ## 0.27.1
 
 - Drei Beispiele zum Mikropreis in `fixtures/rechnung-api-beispiele/`: der Sub-Cent-Fall

package/README.de.md

@@ -0,0 +1,77 @@
+# @kreiseck/kasseneck-api (Deutsch)
+
+**Registrierkasse nach RKSV für JavaScript und TypeScript.** Kasseneck ist eine
+österreichische Registrierkasse; dieses Paket ist der Client dafür. Ihr Code
+stellt Belege aus, das Kasseneck-Backend signiert und verkettet sie, und das
+Paket liefert das Ergebnis als typisierte Objekte. Dazu kommen Storno,
+Kartenzahlung, Beleg-Layout und Bondruck (ESC/POS, Epson ePOS, WebUSB), die
+Partner-API und die Rechnungs-API.
+
+Die vollständige Dokumentation steht auf Englisch in der
+[README.md](https://github.com/kreiseck-at/kasseneck-api/blob/main/README.md).
+
+## Installation
+
+```bash
+npm install @kreiseck/kasseneck-api
+```
+
+Node ab 20.18, läuft auch im Browser; keine Laufzeitabhängigkeiten. React ist
+optional und nur für `@kreiseck/kasseneck-api/react` nötig.
+
+## Ein Beleg in wenigen Zeilen
+
+```ts
+import { createKasseneckApi, apiKeyAuth, KeckPaymentMethod, VatRate } from '@kreiseck/kasseneck-api';
+import { buildReceiptLayout, escPosLayoutBytes } from '@kreiseck/kasseneck-api/receipt';
+
+const api = createKasseneckApi({
+  auth: apiKeyAuth({ apiKey: 'kr_live_…', cashregisterToken: 'cb_live_…' }),
+});
+
+const { receipt, company, testKasse, testSignatur, pruefangaben } = await api.sellReceiptWithCompany({
+  paymentMethod: KeckPaymentMethod.cash,
+  items: [{ name: 'Café Latte', quantity: 2, vat: VatRate.vat20, priceCents: 390 }],
+});
+
+const layout = buildReceiptLayout(receipt, company, { paperSize: 'mm58', testKasse, testSignatur, pruefangaben });
+const bytes = escPosLayoutBytes(layout);   // für den Bondrucker
+```
+
+Beträge sind immer ganze Cent (`priceCents`), Mengen am Beleg ganze Zahlen.
+Fehler kommen als geworfene Ausnahme; fachliche Fehler tragen einen stabilen
+`code`, an dem man entscheidet, nicht am Text.
+
+## Welche RKSV-Pflichten die Software abdeckt
+
+| Aufgabe | Wo sie erledigt wird |
+| --- | --- |
+| [Signaturerstellungseinheit](https://kasseneck.at/wissen/signaturerstellungseinheit) | Kasseneck, nichts zu installieren |
+| [Verkettung und DEP](https://kasseneck.at/wissen/dep), Umsatzzähler | Kasseneck-Backend |
+| [Startbeleg, Monatsbeleg, Jahresbeleg](https://kasseneck.at/wissen/startbeleg-monatsbeleg-jahresbeleg) | Kasseneck, automatisch |
+| [Meldungen an FinanzOnline](https://kasseneck.at/wissen/finanzonline): Anmeldung, Ausfall, Außerbetriebnahme | Kasseneck-Backend übermittelt sie |
+| [Belegerteilungspflicht](https://kasseneck.at/wissen/belegerteilungspflicht) | **dieses Paket**: Bon, PDF, Bildschirm oder Link |
+| [Ausfall der Signatureinheit](https://kasseneck.at/wissen/ausfall) | Kasseneck, automatisch |
+| [Kassennachschau](https://kasseneck.at/wissen/kassennachschau): DEP-Export | Kasseneck |
+| Anmeldepflicht der Kasse, Aufbewahrung, steuerliche Würdigung | **beim Unternehmer** |
+
+> **Kein Rechts- oder Steuerrat.** Die Tabelle beschreibt, was die Software
+> tut. Sie ersetzt keine Beratung und sichert nicht zu, dass ein bestimmter
+> Betrieb damit alle Pflichten erfüllt. Verbindlich sind BAO, RKSV und die
+> Erlässe des BMF; Anmeldung, Betrieb und Aufbewahrung bleiben Sache des
+> Unternehmers, auch wo die Software die Meldungen übermittelt. Ausführlich
+> und mit Quellen: [kasseneck.at/wissen](https://kasseneck.at/wissen).
+> Stand: September 2026.
+
+## Weiter
+
+- Vollständige Dokumentation (Englisch):
+  [README.md](https://github.com/kreiseck-at/kasseneck-api/blob/main/README.md)
+- Schnittstelle: [kasseneck.at/api-doku](https://kasseneck.at/api-doku)
+- Fertige Registrierkasse ohne Programmieren: [kasseneck.at](https://kasseneck.at)
+- Kontakt für Integrationen und Partnerschaften:
+  [kasseneck.at/kontakt](https://kasseneck.at/kontakt)
+
+**Kasseneck** ist ein Produkt von
+[Kreiseck Software Solutions](https://kreiseck.com) aus Salzburg.
+Lizenz: Apache-2.0.