@kreiseck/kasseneck-api 0.13.2 → 0.15.0

package/CHANGELOG.md

@@ -4,6 +4,104 @@ 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.15.0
+
+### Rechnungs-API: Rechnungen statt Belege, per `api_key`
+
+**Anlass:** Fremdsysteme (Shops, Buchhaltungssoftware) konnten Rechnungen nur
+über die Endpunkte des Panels anlegen — mit Anmeldung als Mensch, als Entwurf,
+ohne geprüfte Eingabe und ohne Schutz vor einer doppelt ausgestellten Rechnung
+nach einem Zeitlimit. Eine festgeschriebene Rechnung lässt sich aber nur per
+Gutschrift zurücknehmen; ein Doppel ist also teuer.
+
+- Neuer Unterpfad `@kreiseck/kasseneck-api/rechnung` mit `createRechnungApi`:
+  Kunden (`createCustomer`, `getCustomer`, `updateCustomer`, `searchCustomers`),
+  Rechnungen (`issueInvoice`, `cancelInvoice`, `createCreditNote`, `getInvoice`,
+  `listInvoices`) und Dateien (`getInvoicePdf`, `getInvoiceXml`).
+- Anmeldung `rechnungKeyAuth`: Kontoschlüssel als Bearer, **ohne**
+  Kassen-Token — eine Rechnung entsteht am Konto, nicht an einer Kasse. Ein
+  Partner-Schlüssel oder Kassen-Token wird ohne Netzaufruf abgewiesen.
+- Der Vertrag steht als Daten in `src/rechnung/vertrag.ts` und wird als
+  `fixtures/rechnung-api.schema.json` ausgeliefert (`npm run fixtures:rechnung`),
+  dazu Beispielanfragen unter `fixtures/rechnung-api-beispiele/`. Grund: das
+  Backend und der Dart-Zwilling prüfen gegen dieselbe Datei — die Feldliste
+  kann nicht an drei Stellen auseinanderlaufen.
+- `fixtures/oberflaeche.json` führt die elf Aufrufe und einen Abschnitt
+  `rechnung` (Fehlercodes, Gutschrift-Gründe, Steuerschemata).
+- `getInvoiceXml` liefert das XML als Text im gewohnten Umschlag statt als rohe
+  Datei: so bleibt `einvoice_incomplete` ein gewöhnlicher Fehler mit
+  `missing[]`, und der Transport braucht keinen dritten Leseweg.
+
+## 0.14.0
+
+### Das Beleg-Blatt: ein Beleg, der überall gleich aussieht
+
+**Anlass:** Derselbe Beleg sah in der App, am Bon, in der Web-Kasse, im Panel
+und im PDF verschieden aus. Das Raster war als einzige Wahrheit gedacht, aber
+jeder Zeichner setzte Rahmen, Logo und QR selbst: das Panel stellte das Logo
+über den Testkassen-Rahmen, das PDF legte es darauf, die App zeigte keins, der
+Bon druckte Warnungen invers und doppelt hoch.
+
+- `renderReceiptGrid` gibt Aufdrucke als drei Rasterzeilen aus (`====`, Text,
+  `====`). ESC/POS und ePOS drucken sie als normale fette Zeilen — keine doppelte
+  Höhe, kein Invertieren mehr. `grid32`/`grid48` der Belege mit Aufdruck ändern
+  sich, das Zeilenmodell nicht.
+- Bekannter Unterschied, bleibt so: ESC/POS druckt `EUR` statt `€` (die
+  Ein-Byte-Codepage des Bondruckers kennt das Zeichen nicht). Bildschirm, PDF
+  und ePOS zeigen `€`; die Zeilen sind dadurch am Bon an diesen Stellen anders
+  gefüllt, das Raster bleibt gleich breit.
+- Neu `belegBlatt(layout, { zeichen, logo, marke, qrGroesse })`: Reihenfolge
+  (Aufdrucke oben, Leerzeile, Logo, Leerzeile, Beleg, Marke), Logo-Maß je Stufe
+  S/M/L/XL (nie hochgerechnet), QR-Anteil wie am Drucker.
+- Ein QR-Inhalt, der in keine QR-Version passt (Korrektur M, mehr als 2331
+  Byte), bekommt im Blatt den Anteil 0, statt dass `belegBlatt` wirft. ESC/POS
+  und ePOS lassen den QR dann weg und melden es über `qrFehler`; der Beleg steht
+  ohne QR. Die Bildschirm-Ansicht ruft `renderQr` weiter mit der Nutzlast, damit
+  die Oberfläche den fehlenden QR anzeigen kann (Papierbeleg-Hinweis). **Grund:** Ein Wurf riss jeden Zeichner mit — die Bon-Ansicht der
+  Web-Kasse fiel ganz aus, Bon und PDF ebenso. Neu `qrPasstInVersion(nutzlast)`
+  (`./printing`); `qrModulAnzahl` wirft weiter.
+- Neu `logoRaster` (RGBA → einfarbiges Rasterbild), `escPosRasterBild`,
+  `eposBildXml`; `escPosLayoutBytes` und `eposPrintXml` nehmen `logo` und `marke`.
+- Neu `BelegBlattView` / `BelegBlattZeilen` (`./react`); `ReceiptLayoutView` ist
+  `@deprecated`. `BelegBlattView` zeigt ein Logo ueber 4096x4096px (oder 0)
+  ebenso wenig wie ein nicht geladenes -- neu `LOGO_PIXEL_MAX`,
+  `logoPixelZulaessig` (`./receipt`). **Grund:** Bildschirm und Bon zeigen
+  dasselbe Logo; das Druck-Kit lehnt ein zu grosses Logo beim Rastern fuer
+  den Bon schon ab (dieselbe Grenze), der Bildschirm bisher nicht -- ein
+  5000x1200px-Logo erschien am Bildschirm und im PDF, aber nie auf dem
+  gedruckten Beleg.
+- Neu `ReceiptWithCompany.logoStufe` (aus `logo_skala` der Beleg-Antwort,
+  Vorgabe `M`): Panel und App kannten die Logo-Stufe des Betriebs bisher nicht.
+- `createPrintJob` nimmt `logo` und `marke`: der Netzwerk-Drucker (Connect)
+  druckt dasselbe Blatt wie USB, Bluetooth und ePOS direkt. Neu
+  `rasterZeilenBase64` (gemeinsam für ePOS-`<image>` und den Druckjob).
+- Goldens `erwartet/<name>.blatt32.json`/`.blatt48.json`,
+  `erwartet/logo-probe.raster32.txt` (mit Teiltransparenz) und
+  `erwartet/logo-probe-hoch.raster32.txt` (höhenbegrenzt) für den Dart-Zwilling.
+- `escPosRasterBild` wirft bei einer Bildhöhe über 65535 Punkten (`GS v 0` trägt
+  die Höhe in zwei Bytes).
+
+### Achtung: Brüche
+
+- **Aufdrucke im Raster.** `renderReceiptGrid` gibt jeden Aufdruck als drei
+  Zeilen `kind:'banner'` aus (`====`, Text, `====`). *Umstellen:* eigene
+  Rahmen oder Sonderstile für Aufdrucke entfernen (sie stünden sonst doppelt)
+  und nicht annehmen, dass die erste `banner`-Zeile die einzige ist — der Text
+  steht in der mittleren.
+- **`ReceiptWithCompany.logoStufe` ist Pflicht.** `getReceiptWithCompany` füllt
+  es selbst. *Umstellen:* von Hand gebaute Objekte (Tests, Vorschauen) brauchen
+  `logoStufe: 'M'`.
+- **QR-Vorgabe `auto` deckelt bei 6 Punkten je Modul (vorher 4)** — in npm und
+  Dart dasselbe. Am ESC/POS-Bon wird der QR ohne ausdrückliche Wahl größer
+  (80 mm: rund 55 % statt 37 % der Breite). *Umstellen:* wer die alte Größe
+  will, stellt `qrGroesse: 'klein'`.
+- **Nativer ESC/POS-QR mit Fehlerkorrektur M (vorher L)**, wie ePOS, Bildweg
+  und Blatt — der Kasten am Bildschirm ist damit genau der gedruckte QR.
+  Manche Nutzlasten brauchen eine Version mehr. *Umstellen:* den alten
+  Bytestrom liefert `qrCorrection: 'L'` (zusammen mit `qrGroesse: 'klein'`).
+- **ePOS-Vorgabe `qrGroesse` ist `auto`** (vorher `mittel`). Derselbe Wert,
+  kein Byte anders; nur wer die Vorgabe ausliest oder dokumentiert, merkt es.
+
 ## 0.13.2
 
 ### Die Paketseite erklaert, wofuer das Paket da ist

package/README.md

@@ -426,6 +426,70 @@ app.post('/kasseneck-webhook', express.raw({ type: '*/*' }), async (req, res) =>
 });
 ```
 
+## Rechnungs-API (`./rechnung`)
+
+Für Shops, Buchhaltungs- und Branchensoftware: **Rechnungen** (§ 11 UStG) —
+keine Belege — mit dem `api_key` eines Kontos ausstellen. Eine Rechnung ist
+nach dem Aufruf **festgeschrieben**: sie trägt ihre fortlaufende Nummer, ist
+unveränderlich und lässt sich nur noch per Gutschrift korrigieren.
+
+**Was die Endpunkte tun, steht in der Referenz** — `docs/api/rechnungen.md`
+im Backend. Hier steht, wie man den Client benutzt. Der Schlüssel gehört auf
+einen **Server**.
+
+```ts
+import { createRechnungApi, istRechnungFehler } from '@kreiseck/kasseneck-api/rechnung';
+
+const rechnungen = createRechnungApi({ apiKey: process.env.KASSENECK_API_KEY! });
+
+// 1. Kunde einmal anlegen — externalId ist die eigene Kundennummer.
+let kunde;
+try {
+  kunde = await rechnungen.createCustomer({
+    type: 'company', name: 'Café Muster GmbH', country: 'AT',
+    street: 'Hauptplatz', houseNumber: '3', zip: '1010', city: 'Wien',
+    externalId: 'shop-4711',
+  });
+} catch (fehler) {
+  if (!istRechnungFehler(fehler, 'customer_exists')) throw fehler;
+  kunde = await rechnungen.getCustomer({ externalId: 'shop-4711' });
+}
+
+// 2. Ausstellen. Beträge in ganzen Cent; das Rechnungsdatum setzt der Server.
+const { invoice, replayed } = await rechnungen.issueInvoice({
+  idempotencyKey: `bestellung-${bestellnummer}`,   // gleiche Bestellung = gleiche Rechnung
+  customerId: kunde.id,
+  taxScheme: 'normal',
+  priceMode: 'net',
+  serviceStart: '2026-09-14',
+  items: [{ description: 'Beratung', quantity: 2, unit: 'Std', unitPriceCents: 5000, vatRate: 20 }],
+});
+// invoice.number, invoice.totals.grossCents (12000), invoice.statusUrl
+
+// 3. Dateien holen.
+const pdf = await rechnungen.getInvoicePdf(invoice.id);      // Uint8Array, mit Factur-X
+const xml = await rechnungen.getInvoiceXml(invoice.id, 'ubl'); // Peppol-UBL als Text
+
+// 4. Korrigieren — nur per Gutschrift.
+await rechnungen.createCreditNote({
+  idempotencyKey: `nachlass-${bestellnummer}`,
+  invoiceId: invoice.id,
+  reason: 'price_reduction',
+  items: [{ description: 'Nachlass Beratung', quantity: 1, unitPriceCents: 2000, vatRate: 20 }],
+});
+```
+
+**Nach einem Zeitlimit mit demselben `idempotencyKey` wiederholen**, nie mit
+einem neuen: dann kommt die schon ausgestellte Rechnung zurück
+(`replayed: true`). Derselbe Schlüssel mit anderen Daten ergibt
+`idempotency_conflict`.
+
+Formfehler kommen als `validation` mit Feldpfaden (`rechnungFeldFehler(fehler)`
+→ `[{ field: 'items[0].vatRate', message }]`). Der Vertrag selbst liegt als
+Daten im Paket (`RECHNUNG_ANFRAGEN`) und als JSON Schema unter
+`@kreiseck/kasseneck-api/fixtures/rechnung-api.schema.json`; das Backend prüft
+gegen genau diese Datei.
+
 ## Unterpfade
 
 | Unterpfad | Inhalt |
@@ -437,6 +501,7 @@ app.post('/kasseneck-webhook', express.raw({ type: '*/*' }), async (req, res) =>
 | `…/register` | Anmeldung der Browser-Kasse: Gerät koppeln und entkoppeln, Benutzer auflisten, per PIN anmelden, Sitzung erneuern und beenden. |
 | `…/kasse` | Kachel-Kasse: Kassen-Einstellungen (betriebsweit / je Gerät), Artikelgruppen und Artikel für Kacheln, Rabattverteilung je Steuersatz, Reichweiten der Kassen-Rechte |
 | `…/partner` | Partner-API: Betriebe anlegen, FinanzOnline-Link, Signatur, Kassen, Zugangsdaten, Webhooks samt Signaturprüfung. **Gehört auf einen Server.** |
+| `…/rechnung` | Rechnungs-API: Kunden anlegen und suchen, Rechnungen festgeschrieben ausstellen, Gutschrift und Storno, PDF und E-Rechnung-XML; der Vertrag als Daten. **Gehört auf einen Server.** |
 | `…/react` | Dünner React-Adapter, der ein Beleg-Layout zeichnet. Braucht React. |
 | `…/fixtures/*` | Golden-Belege (JSON): Eingaben `belege/<name>.json`, zugesagte Zeilenausgabe `erwartet/<name>.lines.json`, `manifest.json` mit Prüfsummen — dieselben Dateien prüfen Backend, Browser-Kasse und Flutter-Paket. |
 
@@ -460,8 +525,9 @@ const mass = qrGroesseFuer({ nutzlast: beleg.qr, papierbreitePunkte: QR_DRUCK_PU
 
 Am Belegweg passiert das von selbst. `qrGroesse` ist ein **Deckel**, keine
 Vorgabe: gedruckt wird die größte Größe, die noch passt, höchstens aber der
-Deckel. `auto` (Vorgabe) deckelt beim Bestandswert 4 — ohne ausdrückliche Wahl
-ändert sich also kein Byte.
+Deckel. `auto` (Vorgabe) deckelt bei 6 Punkten je Modul — wie im Dart-Zwilling
+und am Epson-Weg; `klein` deckelt bei 4. Alle Druckwege setzen den QR mit
+Fehlerkorrektur M.
 
 ```ts
 import { escPosLayoutErgebnis } from '@kreiseck/kasseneck-api/receipt';
@@ -474,8 +540,8 @@ const { bytes, qrFehler, qrAusweich } = escPosLayoutErgebnis(layout, {
 ```
 
 Der Epson-Weg (`eposPrintXml` / `eposDirectPrint`) rechnet genauso;
-`eposPrintXmlErgebnis` gibt dort `{ xml, qrFehler, qrAusweich }`. Sein
-Bestandswert ist 6, deshalb ist die Vorgabe dort der Deckel `mittel`.
+`eposPrintXmlErgebnis` gibt dort `{ xml, qrFehler, qrAusweich }`. Die Vorgabe
+ist auch dort `auto`.
 
 `qrFehler` heißt „Beleg ohne QR" — das gehört dem Kunden gesagt. `qrAusweich`
 heißt „gedruckt, aber der eingestellte Weg taugt für dieses Gerät nicht" — das
@@ -483,6 +549,30 @@ gehört dem Chef gesagt. Den Bildweg fährt das Paket nur mit einem `qrMatrix`,
 das die Nutzlast in ein fertiges Raster übersetzt: hier wird bewusst weder ein
 QR gerechnet noch ein Bild verarbeitet.
 
+## Das Beleg-Blatt: überall derselbe Beleg
+
+Bildschirm, Bon, ePOS und PDF setzen dasselbe **Blatt**: Rasterzeilen, Firmenlogo,
+QR und die Marke „erstellt mit Kasseneck", mit Größen als Anteil der Blattbreite
+und in Zeilen (eine Zeile = zwei Zeichenbreiten).
+
+```tsx
+import { BelegBlattView } from '@kreiseck/kasseneck-api/react';
+
+<BelegBlattView layout={layout} logo={{ url: company.logoUrl, stufe: 'M' }} marke={company.showKreiseckLogo} renderQr={(d) => <QrSvg data={d} />} />
+```
+
+```ts
+import { escPosLayoutBytes, logoMass, logoRaster } from '@kreiseck/kasseneck-api/receipt';
+
+const mass = logoMass({ stufe: 'M', pxBreite: bild.width, pxHoehe: bild.height }, 48);
+const raster = logoRaster(imageData.data, bild.width, bild.height, mass, 48);
+escPosLayoutBytes(layout, { paperSize: 'mm80', logo: { stufe: 'M', pxBreite: bild.width, pxHoehe: bild.height, raster }, marke: true });
+```
+
+Logo-Stufen: S 42 % × 5 Zeilen, M 62 % × 8, L 80 % × 12, XL 94 % × 16 — eingepasst,
+nie hochgerechnet. Der Aufdruck (TESTKASSE, STORNOBELEG …) ist ein Rahmen aus
+`=`-Zeilen, auf jedem Weg gleich.
+
 ## Hobex HPS über Kasseneck Connect
 
 Ein Browser hat weiterhin keine rohen TCP-Sockets — ein **direkter**
@@ -516,7 +606,8 @@ Android-SDKs ohne Entsprechung hier.
 ## Was hier grundsätzlich nicht dazugehört
 
 Die Druckeransteuerung selbst (dieses Paket erzeugt die Bytes, es verschickt
-sie nicht), Firmenlogos und Rasterbilder, und die PDF-Erzeugung.
+sie nicht) und die PDF-Erzeugung. Bilder dekodieren (PNG/JPEG): das Paket
+rastert fertige RGBA-Pixel, das Laden des Bilds bleibt bei der Anwendung.
 
 ## Entwicklung
 

package/dist/cjs/client/aufrufe.d.ts

@@ -13,7 +13,7 @@
  * umhuellt, muss ihn weiterhin absetzen koennen.
  */
 import type { TransportBodyFields } from './transport.js';
-export declare const AUFRUFE: readonly ["activateCashregister", "cancelReceipt", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "listCustomerCashregisters", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "requestCustomerSignature", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updatePartnerWebhook"];
+export declare const AUFRUFE: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "requestCustomerSignature", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook"];
 export type Aufruf = typeof AUFRUFE[number];
 /** Wie [KasseneckTransport], nur mit bekanntem Aufrufnamen. Nicht exportiert nach aussen. */
 export type InternerTransport = <T = unknown>(functionName: Aufruf, params?: Record<string, unknown>, extraBodyFields?: TransportBodyFields, secretParams?: readonly string[]) => Promise<T>;

package/dist/cjs/client/aufrufe.js

@@ -3,7 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AUFRUFE = void 0;
 exports.AUFRUFE = [
     'activateCashregister',
+    'cancelInvoice',
     'cancelReceipt',
+    'createCreditNote',
+    'createCustomer',
     'createCustomerCashregister',
     'createPartnerCustomer',
     'checkPartnerCustomerEmail',
@@ -17,9 +20,13 @@ exports.AUFRUFE = [
     'endRegisterSession',
     'financeWebService',
     'generateFullReceiptId',
+    'getCustomer',
     'getCustomerCredentials',
     'getCustomerSignatureStatus',
     'getFirstReceiptDate',
+    'getInvoice',
+    'getInvoicePdf',
+    'getInvoiceXml',
     'getKasseSettings',
     'getPartnerCustomer',
     'getPartnerInfo',
@@ -27,7 +34,9 @@ exports.AUFRUFE = [
     'getReceipt',
     'hobexPayApi',
     'hobexRefundApi',
+    'issueInvoice',
     'listCustomerCashregisters',
+    'listInvoices',
     'listMyArticleGroups',
     'listMyArticles',
     'listMyCashregisters',
@@ -44,6 +53,7 @@ exports.AUFRUFE = [
     'registerUserLogin',
     'renewRegisterSession',
     'requestCustomerSignature',
+    'searchCustomers',
     'sendPartnerCustomerFonLink',
     'sendPartnerWebhookTest',
     'sendReceiptEmail',
@@ -52,5 +62,6 @@ exports.AUFRUFE = [
     'stripeCaptureIntent',
     'unpairRegisterDevice',
     'rotatePartnerWebhookSecret',
+    'updateCustomer',
     'updatePartnerWebhook',
 ];

package/dist/cjs/client/receipts.d.ts

@@ -2,6 +2,7 @@ import { ReceiptType, type ReceiptTypeKey, KeckPaymentMethod, type KeckPaymentMe
 import { type Receipt, type ReceiptCompany, type ReceiptItem, type Voucher, type ReceiptSummary, type ReportMonth, type CancellationItem, type CancellationOf, type CancellationReason } from '../models/index.js';
 import type { InternerTransport } from './aufrufe.js';
 import type { Pruefangaben, ReceiptLayout } from '../receipt/layout.js';
+import type { LogoStufe } from '../receipt/blatt.js';
 /**
  * Beleg-Endpunkte — Zwilling der Beleg-Aufrufe in
  * kasseneck_api/lib/kasseneck_api.dart.
@@ -168,6 +169,12 @@ export interface ReceiptWithCompany {
      * fuer Clients, die das Layout selbst bauen; null bei altem Backend.
      */
     pruefangaben: Pruefangaben | null;
+    /**
+     * Groesse des Firmenlogos am Beleg (Kasse-Einstellung `logoSkala` des
+     * Betriebs). Bildschirm, Bon und PDF setzen das Logo in genau dieser Stufe;
+     * liefert das Backend sie nicht (alt), gilt `M` -- der Bestandswert.
+     */
+    logoStufe: LogoStufe;
 }
 /**
  * Gemeinsame Umsetzung aller Belegarten (Zwilling von `_createReceipt`).

package/dist/cjs/client/receipts.js

@@ -582,5 +582,6 @@ function belegMitFirmaAusHuelle(daten, functionName) {
         kopfId: typeof d.kopfId === 'string' ? d.kopfId : null,
         layout,
         pruefangaben: pa ? { karteRegistriertAm: text(pa.karteRegistriertAm), kasseRegistriertAm: text(pa.kasseRegistriertAm) } : null,
+        logoStufe: d.logo_skala === 'S' || d.logo_skala === 'M' || d.logo_skala === 'L' || d.logo_skala === 'XL' ? d.logo_skala : 'M',
     };
 }

package/dist/cjs/kasse/drucker.d.ts

@@ -1,5 +1,6 @@
 import type { InternerTransport } from '../client/aufrufe.js';
 import type { ReceiptLayout } from '../receipt/layout.js';
+import type { DruckLogo } from '../receipt/layout-escpos.js';
 /**
  * Netzwerk-Bondrucker ueber Epson "Server Direct Print": das Backend fuehrt
  * je Konto Drucker mit einer geheimen Abhol-URL; die Kasse legt Druckjobs
@@ -46,6 +47,10 @@ export interface CreatePrintJobOptions {
     receiptId?: string;
     titel?: string;
     quelle?: string;
+    /** Firmenlogo als fertiges Rasterbild (`logoRaster`); der Server dekodiert keine Bilder. */
+    logo?: DruckLogo | null;
+    /** "erstellt mit Kasseneck" am Ende (Konto-Flag `kreiseck_logo`). */
+    marke?: boolean;
 }
 export declare function createPrintJob(rufen: InternerTransport, o: CreatePrintJobOptions): Promise<DruckJob>;
 export declare function getPrintJob(rufen: InternerTransport, o: {

package/dist/cjs/kasse/drucker.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.listMyPrinters = listMyPrinters;
 exports.createPrintJob = createPrintJob;
 exports.getPrintJob = getPrintJob;
+const index_js_1 = require("../printing/index.js");
 const text = (v) => (typeof v === 'string' && v ? v : null);
 const zahl = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : null);
 async function listMyPrinters(rufen) {
@@ -27,6 +28,14 @@ async function createPrintJob(rufen, o) {
         params.titel = o.titel;
     if (o.quelle)
         params.quelle = o.quelle;
+    if (o.logo) {
+        params.logo = {
+            stufe: o.logo.stufe, pxBreite: o.logo.pxBreite, pxHoehe: o.logo.pxHoehe,
+            breite: o.logo.raster.breite, hoehe: o.logo.raster.hoehe, zeilen: (0, index_js_1.rasterZeilenBase64)(o.logo.raster),
+        };
+    }
+    if (o.marke === true)
+        params.marke = true;
     const daten = await rufen('createPrintJob', params);
     return { jobId: String(daten?.jobId ?? ''), status: text(daten?.status) ?? 'offen', ergebnis: null };
 }

package/dist/cjs/kasse/settings.js

@@ -116,8 +116,11 @@ exports.KASSE_TASTEN_STANDARD = Object.freeze({
     korbLeeren: ['Mod+C'],
 });
 exports.KASSE_BETRIEB_STANDARD = Object.freeze({
-    // Petrol aus der Markenpalette ("Ecke, Aktion") — nicht das alte Blau.
-    logoText: 'K', logoAn: true, logoGroesse: 'M', wasserzeichen: 'anmeldung', farbe: '#116B6B',
+    // Das Petrol der Marke: die Aktionsfarbe des Design-Systems (Rolle `brand`).
+    // Stand bis September 2026 auf dem Wert des alten Markenhandbuchs,
+    // der um 0,07 in OKLab danebenlag. Unsichtbar, aber es war die letzte Stelle
+    // im Haus, an der eine zweite Zahl fuer dieselbe Farbe stand.
+    logoText: 'K', logoAn: true, logoGroesse: 'M', wasserzeichen: 'anmeldung', farbe: '#136B6B',
     stil: 'klar', schrift: 'M', schriftEinst: 'S', kachelstil: 'streifen', uhr: true,
     sperrbild: true, foto: true, autoAbMin: 0, abNachVerkauf: false, schnellLogin: true,
     preisAnzeigen: true, ustAnzeigen: false, emoji: true, katFarben: true, freiErlaubt: true,

package/dist/cjs/printing/escpos.d.ts

@@ -24,8 +24,9 @@
  * CP437-Plaetze umkodiert (ä = 0x84, ü = 0x81, ß = 0xE1, ...). Zeichen ohne
  * CP437-Platz werden zu `?` — weiterhin ein Byte je Zeichen.
  *
- * Nicht enthalten (bewusst): Rasterbilder/Logos, Capability-Profile einzelner
- * Druckermodelle, Kassenlade, 1D-Barcodes.
+ * Nicht enthalten (bewusst): Bilddekodierung (PNG/JPEG liest die Huelle),
+ * Capability-Profile einzelner Druckermodelle, Kassenlade, 1D-Barcodes.
+ * Fertige einfarbige Rasterbilder (Logo) gehen ueber [escPosRasterBild].
  */
 import { type QrModulGroesse } from './qr-groesse.js';
 /** Papierbreite der Bonrolle. */
@@ -103,6 +104,7 @@ export interface EscPosQrOptions {
      * die Regel in `qr-groesse.ts`.
      */
     size?: QrSize;
+    /** Fehlerkorrektur; Vorgabe `M` wie auf allen Druckwegen (siehe `qrCodeBytes`). */
     correction?: QrCorrection;
     /** Deckel fuer die gerechnete Modulgroesse; wirkungslos neben `size`. */
     groesse?: QrModulGroesse;
@@ -255,6 +257,12 @@ export declare function escPosRow(doc: EscPosDocument, columns: readonly PosColu
  * es wird kein Bild uebertragen.
  *
  * Bei Kasseneck-Belegen steht hier der maschinenlesbare RKSV-Code.
+ *
+ * Fehlerkorrektur ohne Angabe: **M** (bis 0.13: L). Die Groessenrechnung
+ * (`qrModulAnzahl`), das Blatt (Anteil am Bildschirm und im PDF), der
+ * ePOS-Weg (`level_m`) und der Bildweg rechnen alle mit M — druckte der
+ * native Befehl mit L, kaeme fuer manche Nutzlasten ein kleineres Symbol
+ * heraus als der Bildschirm zeigt.
  */
 export declare function qrCodeBytes(text: string, options?: {
     size?: QrSize;
@@ -266,8 +274,8 @@ export declare function qrCodeBytes(text: string, options?: {
  * **gerechneter** Modulgroesse, sofern `options.size` sie nicht festlegt.
  *
  * Ohne `size` entscheidet die Regel aus `qr-groesse.ts`: so gross wie
- * moeglich, gedeckelt durch `options.groesse` (Vorgabe `auto` = der
- * Bestandswert 4 dieses Pakets). Passt das Symbol auch mit der
+ * moeglich, gedeckelt durch `options.groesse` (Vorgabe `auto` = hoechstens 6
+ * Punkte je Modul, wie im Flutter-Zwilling). Passt das Symbol auch mit der
  * Ausnahmegroesse nicht aufs Papier, geht **kein** QR-Befehl hinaus und
  * `doc.qrFehler` sagt warum: der Drucker schneidet ein zu breites Symbol
  * nicht ab, er laesst es weg — ein Befehl, von dem man weiss, dass er nichts
@@ -300,4 +308,30 @@ export declare function qrRasterPunkte(paperSize: PosPaperSize, moduleAnzahl: nu
     groesse?: QrModulGroesse;
     ruhezoneModule?: number;
 }): number;
+/**
+ * Einfarbiges Rasterbild in Druckpunkten, zeilenweise: `punkte[y * breite + x]`,
+ * 1 = schwarz. Entsteht fuer das Firmenlogo in `logoRaster` (receipt/bild.ts).
+ */
+export interface RasterBild {
+    readonly breite: number;
+    readonly hoehe: number;
+    readonly punkte: Uint8Array;
+}
+/** Die Rasterzeilen als Bytes: MSB zuerst, jede Zeile auf volle Bytes aufgefuellt. */
+export declare function rasterZeilenBytes(bild: RasterBild): Uint8Array;
+/**
+ * Die Rasterzeilen als Base64 -- ohne Buffer, laeuft im Browser und in Node.
+ * Eine Stelle fuer ePOS-`<image>` und den Druckjob an den Server.
+ */
+export declare function rasterZeilenBase64(bild: RasterBild): string;
+/**
+ * Ein Rasterbild (`GS v 0`) -- das Firmenlogo am Bon.
+ *
+ * Anders als `escPosQrRaster` folgt KEIN Zeilenvorschub: `GS v 0` schiebt das
+ * Papier um die Bildhoehe, ein LF danach waere eine zusaetzliche Leerzeile,
+ * die Bildschirm und PDF nicht haben. Die Luft um das Logo kommt aus dem Blatt.
+ */
+export declare function escPosRasterBild(doc: EscPosDocument, bild: RasterBild, options?: {
+    align?: PosAlign;
+}): void;
 export {};

package/dist/cjs/printing/escpos.js

@@ -25,8 +25,9 @@
  * CP437-Plaetze umkodiert (ä = 0x84, ü = 0x81, ß = 0xE1, ...). Zeichen ohne
  * CP437-Platz werden zu `?` — weiterhin ein Byte je Zeichen.
  *
- * Nicht enthalten (bewusst): Rasterbilder/Logos, Capability-Profile einzelner
- * Druckermodelle, Kassenlade, 1D-Barcodes.
+ * Nicht enthalten (bewusst): Bilddekodierung (PNG/JPEG liest die Huelle),
+ * Capability-Profile einzelner Druckermodelle, Kassenlade, 1D-Barcodes.
+ * Fertige einfarbige Rasterbilder (Logo) gehen ueber [escPosRasterBild].
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.encodeEscPosText = encodeEscPosText;
@@ -49,6 +50,9 @@ exports.qrCodeBytes = qrCodeBytes;
 exports.escPosQrCode = escPosQrCode;
 exports.escPosQrRaster = escPosQrRaster;
 exports.qrRasterPunkte = qrRasterPunkte;
+exports.rasterZeilenBytes = rasterZeilenBytes;
+exports.rasterZeilenBase64 = rasterZeilenBase64;
+exports.escPosRasterBild = escPosRasterBild;
 const qr_groesse_js_1 = require("./qr-groesse.js");
 // -------------------------------------------------------------- Befehlsbytes
 // Wortwoertlich aus commands.dart. Die Zahlen sind ASCII-Codes der dortigen
@@ -603,13 +607,19 @@ function escPosRow(doc, columns) {
  * es wird kein Bild uebertragen.
  *
  * Bei Kasseneck-Belegen steht hier der maschinenlesbare RKSV-Code.
+ *
+ * Fehlerkorrektur ohne Angabe: **M** (bis 0.13: L). Die Groessenrechnung
+ * (`qrModulAnzahl`), das Blatt (Anteil am Bildschirm und im PDF), der
+ * ePOS-Weg (`level_m`) und der Bildweg rechnen alle mit M — druckte der
+ * native Befehl mit L, kaeme fuer manche Nutzlasten ein kleineres Symbol
+ * heraus als der Bildschirm zeigt.
  */
 function qrCodeBytes(text, options = {}) {
     const size = options.size ?? 4;
     if (!istGanzzahl(size) || size < 1 || size > 8) {
         throw new Error('QR-Modulgroesse muss eine Ganzzahl im Bereich 1..8 sein');
     }
-    const correction = options.correction ?? 'L';
+    const correction = options.correction ?? 'M';
     const stufe = QR_KORREKTUR[correction];
     if (stufe === undefined) {
         throw new Error(`Unbekannte QR-Fehlerkorrektur: ${String(correction)}`);
@@ -650,8 +660,8 @@ function qrCodeBytes(text, options = {}) {
  * **gerechneter** Modulgroesse, sofern `options.size` sie nicht festlegt.
  *
  * Ohne `size` entscheidet die Regel aus `qr-groesse.ts`: so gross wie
- * moeglich, gedeckelt durch `options.groesse` (Vorgabe `auto` = der
- * Bestandswert 4 dieses Pakets). Passt das Symbol auch mit der
+ * moeglich, gedeckelt durch `options.groesse` (Vorgabe `auto` = hoechstens 6
+ * Punkte je Modul, wie im Flutter-Zwilling). Passt das Symbol auch mit der
  * Ausnahmegroesse nicht aufs Papier, geht **kein** QR-Befehl hinaus und
  * `doc.qrFehler` sagt warum: der Drucker schneidet ein zu breites Symbol
  * nicht ab, er laesst es weg — ein Befehl, von dem man weiss, dass er nichts
@@ -736,9 +746,10 @@ function escPosQrRaster(doc, matrix, options = {}) {
     if (!istGanzzahl(punkte) || punkte < 1) {
         throw new Error('punkteJeModul muss eine Ganzzahl >= 1 sein');
     }
+    // Modulraster (samt Ruhezone) auf Druckpunkte skaliert -- dieselbe Bitquelle
+    // wie das Logo, nur aus einem QR-Modul-Bool statt aus Graustufen gewonnen.
     const breite = gesamtModule * punkte;
-    const byteJeZeile = Math.ceil(breite / 8);
-    const daten = new Uint8Array(byteJeZeile * breite);
+    const bildpunkte = new Uint8Array(breite * breite);
     for (let y = 0; y < breite; y++) {
         const modulY = Math.floor(y / punkte) - ruhezone;
         if (modulY < 0 || modulY >= module)
@@ -750,18 +761,14 @@ function escPosQrRaster(doc, matrix, options = {}) {
                 continue;
             if (zeile[modulX] !== true)
                 continue;
-            const i = y * byteJeZeile + (x >> 3);
-            daten[i] = daten[i] | (0x80 >> (x & 7));
+            bildpunkte[y * breite + x] = 1;
         }
     }
+    const daten = rasterZeilenBytes({ breite, hoehe: breite, punkte: bildpunkte });
     escPosSetStyles(doc, { align: options.align ?? 'center' });
     // GS v 0 m xL xH yL yH d1...dk — m = 0: normale Dichte, 1:1.
-    anhaengen(doc, [
-        GS, 0x76, 0x30, 0x00,
-        byteJeZeile & 0xff, (byteJeZeile >> 8) & 0xff,
-        breite & 0xff, (breite >> 8) & 0xff,
-        ...daten,
-    ]);
+    anhaengen(doc, rasterBildKopf(breite, breite));
+    anhaengen(doc, daten);
     anhaengen(doc, [ZEILENUMBRUCH]);
     if ((options.align ?? 'center') !== 'left') {
         escPosSetStyles(doc, { align: 'left' });
@@ -777,3 +784,68 @@ function qrRasterPunkte(paperSize, moduleAnzahl, options = {}) {
     const deckel = qr_groesse_js_1.QR_MODUL_DECKEL[options.groesse ?? 'auto'];
     return Math.max(1, Math.min(deckel, Math.floor(qr_groesse_js_1.QR_DRUCK_PUNKTE[paperSize] / (moduleAnzahl + 2 * ruhezone))));
 }
+/** Die Rasterzeilen als Bytes: MSB zuerst, jede Zeile auf volle Bytes aufgefuellt. */
+function rasterZeilenBytes(bild) {
+    if (!istGanzzahl(bild.breite) || bild.breite < 1 || !istGanzzahl(bild.hoehe) || bild.hoehe < 1) {
+        throw new Error('Rasterbild ohne gueltiges Mass');
+    }
+    if (bild.punkte.length !== bild.breite * bild.hoehe)
+        throw new Error('Rasterbild: Punkte passen nicht zum Mass');
+    const byteJeZeile = Math.ceil(bild.breite / 8);
+    const daten = new Uint8Array(byteJeZeile * bild.hoehe);
+    for (let y = 0; y < bild.hoehe; y++) {
+        for (let x = 0; x < bild.breite; x++) {
+            if (bild.punkte[y * bild.breite + x] !== 1)
+                continue;
+            const i = y * byteJeZeile + (x >> 3);
+            daten[i] = daten[i] | (0x80 >> (x & 7));
+        }
+    }
+    return daten;
+}
+/**
+ * Die Rasterzeilen als Base64 -- ohne Buffer, laeuft im Browser und in Node.
+ * Eine Stelle fuer ePOS-`<image>` und den Druckjob an den Server.
+ */
+function rasterZeilenBase64(bild) {
+    const bytes = rasterZeilenBytes(bild);
+    let binaer = '';
+    for (let i = 0; i < bytes.length; i += 0x8000) {
+        binaer += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
+    }
+    return btoa(binaer);
+}
+/**
+ * Der `GS v 0`-Kopf (Byte-Breite, Zeilenhoehe) -- die Rasterzeilen selbst
+ * haengt der Aufrufer an. Gemeinsame Rahmung fuer das Logo (`escPosRasterBild`)
+ * und den QR-Bildweg (`escPosQrRaster`): beide drucken dasselbe Bildkommando,
+ * nur mit unterschiedlichem Nachlauf (Zeilenvorschub ja/nein).
+ */
+function rasterBildKopf(breite, hoehe) {
+    const byteJeZeile = Math.ceil(breite / 8);
+    return [GS, 0x76, 0x30, 0x00, byteJeZeile & 0xff, (byteJeZeile >> 8) & 0xff, hoehe & 0xff, (hoehe >> 8) & 0xff];
+}
+/**
+ * Ein Rasterbild (`GS v 0`) -- das Firmenlogo am Bon.
+ *
+ * Anders als `escPosQrRaster` folgt KEIN Zeilenvorschub: `GS v 0` schiebt das
+ * Papier um die Bildhoehe, ein LF danach waere eine zusaetzliche Leerzeile,
+ * die Bildschirm und PDF nicht haben. Die Luft um das Logo kommt aus dem Blatt.
+ */
+function escPosRasterBild(doc, bild, options = {}) {
+    // Masse pruefen, BEVOR gepackt wird: ein zu breites Bild soll nicht erst
+    // Speicher fuer seine Rasterzeilen belegen. `GS v 0` traegt die Hoehe in zwei
+    // Bytes (yL yH) -- ueber 65535 Punkte liefe sie still ueber und der Drucker
+    // laese den Rest des Bilds als Befehle.
+    if (bild.breite > qr_groesse_js_1.QR_DRUCK_PUNKTE[doc.paperSize])
+        throw new Error('Rasterbild breiter als der Druckkopf');
+    if (bild.hoehe > 0xffff)
+        throw new Error('Rasterbild hoeher als 65535 Punkte');
+    const daten = rasterZeilenBytes(bild);
+    escPosSetStyles(doc, { align: options.align ?? 'center' });
+    anhaengen(doc, rasterBildKopf(bild.breite, bild.hoehe));
+    anhaengen(doc, daten);
+    if ((options.align ?? 'center') !== 'left') {
+        escPosSetStyles(doc, { align: 'left' });
+    }
+}

package/dist/cjs/printing/index.d.ts

@@ -1,4 +1,4 @@
-export { type PosPaperSize, type PosAlign, type PosFont, type PosCutMode, type PosCodeTable, type PosTextSize, type QrSize, type QrCorrection, type QrMatrix, type PosStyles, type PosColumn, type EscPosOptions, type EscPosTextOptions, type EscPosHrOptions, type EscPosQrOptions, type EscPosQrRasterOptions, type EscPosDocument, createEscPosDocument, escPosBytes, escPosReset, escPosSetGlobalCodeTable, escPosSetGlobalFont, escPosSetStyles, escPosText, escPosEmptyLines, escPosFeed, escPosCut, escPosHr, escPosRow, escPosQrCode, escPosQrRaster, qrRasterPunkte, encodeEscPosText, qrCodeBytes, escPosMaxCharsPerLine, escPosWortzeilen, wortzeilenText, } from './escpos.js';
-export { type QrModulGroesse, type QrGroesse, QR_MODUL_DECKEL, QR_RUHEZONE_MODULE, QR_MINDEST_PUNKTE, QR_AUSNAHME_PUNKTE, QR_HOECHST_PUNKTE, QR_DRUCK_PUNKTE, qrModulAnzahl, qrGroesseBerechnen, qrGroesseFuer, } from './qr-groesse.js';
+export { type PosPaperSize, type PosAlign, type PosFont, type PosCutMode, type PosCodeTable, type PosTextSize, type QrSize, type QrCorrection, type QrMatrix, type PosStyles, type PosColumn, type EscPosOptions, type EscPosTextOptions, type EscPosHrOptions, type EscPosQrOptions, type EscPosQrRasterOptions, type EscPosDocument, createEscPosDocument, escPosBytes, escPosReset, escPosSetGlobalCodeTable, escPosSetGlobalFont, escPosSetStyles, escPosText, escPosEmptyLines, escPosFeed, escPosCut, escPosHr, escPosRow, escPosQrCode, escPosQrRaster, qrRasterPunkte, type RasterBild, rasterZeilenBytes, rasterZeilenBase64, escPosRasterBild, encodeEscPosText, qrCodeBytes, escPosMaxCharsPerLine, escPosWortzeilen, wortzeilenText, } from './escpos.js';
+export { type QrModulGroesse, type QrGroesse, QR_MODUL_DECKEL, QR_RUHEZONE_MODULE, QR_MINDEST_PUNKTE, QR_AUSNAHME_PUNKTE, QR_HOECHST_PUNKTE, QR_DRUCK_PUNKTE, qrModulAnzahl, qrPasstInVersion, qrGroesseBerechnen, qrGroesseFuer, } from './qr-groesse.js';
 export { escPosPrintableText } from './printable.js';
 export { type UsbEndpointLike, type UsbAlternateLike, type UsbInterfaceLike, type UsbConfigurationLike, type UsbTransferOutResultLike, type UsbWriterLike, type UsbIdentityLike, type UsbDeviceLike, type UsbPrinterEndpoint, type UsbPrinterConnection, USB_VENDOR_EPSON, USB_CLASS_PRINTER, UsbTimeoutError, usbDeviceKey, usbFindPrinterEndpoint, usbWriteAll, usbConnectPrinter, usbPrint, usbDisconnect, } from './webusb.js';