pos library

Die Kasse am Tresen: Einstellungen, Warenkorb, Kassieren und Belege — gemeinsam von Browser-Kasse und App.

Zwilling von kasse/settings.ts bzw. client/receipts.ts im JS-Paket und von functions/kasse-settings-core.js im Backend. Die Golden-Datei fixtures/pos-settings-defaults.json hält die Standardwerte deckungsgleich.

Classes

AfterCount
Entnehmen oder Einlegen nach dem Zaehlen: amountCents immer positiv, die Richtung sagt type (aus afterCountTypes). Gezaehlt wird immer die ganze Lade; was danach bleibt, steht in leftInDrawerCents (Schicht, Z-Bon). Dient auch als Parameter von closeMyShift.
ArticleGroup
Kategorie der Kachel-Kasse.
CancellationOf
Bezug eines Storno-Belegs auf sein Original (cancellationOf).
CancelReceiptResult
Ergebnis eines Stornos: der neue, signierte Storno-Beleg, der Bezug zum Original und die verbliebenen Restmengen je Position.
Cart
CartDeposits
Die abgeleiteten Pfandzeilen des Korbs: je Position (Kennung) ihre Zeilen, oder der Fehlercode der Vorschau (depositPreviewErrorCodes).
CartItemDraft
Was der Kassier eingegeben hat, bevor daraus eine Position wird.
CartLine
Eine Anzeigezeile des Korbs: gebuendelt (Menge × Preis) oder je Stueck einzeln.
CashMovement
CashMovementReceipt
Bon-Daten einer Kassenbewegung; Druck mit cashMovementLayout.
CashMovementResult
Antwort von recordMyCashMovement.
CashregisterAutoLogout
Automatisches Abmelden an der Kasse (autoLogout in listMyCashregisters). Beide Werte sind einzeln optional: der Server sendet nur, was die Kasse selbst gesetzt hat.
CashRegisterDeposit
Pfand-Angaben des Kassenobjekts aus listRegisterUsersForDevice; fehlt bei ausgeschaltetem Pfand.
CashregisterEntry
Eine Kasse aus listMyCashregisters (Draht /v3). Zeitpunkte bleiben Text (ISO, UTC); ein fehlender ist null, nie ein erfundenes Datum.
CashregisterOnboarding
Stand der Inbetriebnahme (RKSV): bei FinanzOnline registriert, Startbeleg erzeugt und übermittelt.
CashregisterStockLocation
Antwort von setMyCashregisterStockLocation.
CheckoutState
Was der Kassier am Kassieren-Bildschirm eingestellt hat.
CheckoutTotals
Alle Beträge des Kassiervorgangs auf einen Blick.
CompletionCheck
ConnectStateReport
DepChainBreak
DepCounterRange
Der Lese-Link einer grossen Datei (getDepExportFile mit download).
DepExport
Ein Export, wie ihn createDepExport (nur Kennung, Status, Zeitraum) und getDepExport liefern. Felder, die der Server erst nach dem Lauf kennt, sind vorher null.
DepExportFile
Eine heruntergeladene Datei eines Exports.
DepExportItems
Die Positionsdatei eines Exports.
DepFindings
Befund eines Exports (findings): was an der Belegkette auffaellt.
Ein neuer Pruefer-Link: Adresse (das Geheimnis steht im Fragment), der 6-stellige Code und der Ablauf (14 Tage). Den Code zeigt die Kasse dem Pruefer; beides ist nur in dieser Antwort zu haben und gehoert weder in ein Protokoll noch in eine Mail.
DepHandoverLinkInfo
Ein Pruefer-Link, wie ihn getDepExport aufzaehlt. Code und Adresse kennt nur die Antwort von createDepHandoverLink.
DepHandoverRevocation
Antwort von revokeDepHandoverLink.
DepositAmount
Ein Pfandbetrag ab einem Tag (from, Wiener Tag YYYY-MM-DD), in Cent je Stueck.
DepositEntry
Eine Pfandangabe an Artikel oder Gruppe (deposits[]).
DepositPreviewContext
Alles, was die Pfand-Vorschau des Korbs braucht: was der Server aus Konto, Kasse und Beleg wuesste. Ohne dieses Objekt zeigt der Korb kein Pfand und rechnet wie bisher (Cart.lines, checkoutTotals).
DepositPreviewInput
Eingabe der Vorschau (ohne die Positionen): was der Server aus Konto, Kasse und Beleg wuesste.
DepositPreviewResult
Ergebnis der Vorschau: die Positionen oder ein Fehlercode.
DepositSettings
Block deposit aus getKasseSettings; fehlt bei ausgeschaltetem Pfand.
DepositSharedReturnPoint
Gemeinsame Rueckgabestelle (Kassen-Pfandangaben).
DepositType
Eine Pfandart des Betriebs.
DiscountBlockLine
Eine Zeile des Rabatte-Blocks auf Z- und X-Bon: label und der Betrag als Abzug (negativ).
DiscountPresetError
Ein Fehler der Pruefung: index die Vorlage (null = die Liste), field das Feld (null = die ganze Vorlage).
DiscountPresetsCheck
Ergebnis von checkDiscountPresets: bei ok die normalisierte Liste (value, Name getrimmt), sonst code (invalidDiscountPreset) und errors.
DrawerInfo
DrawerOpening
Eine gemeldete Oeffnung der Lade (nur mit cashView).
DrawerOpeningEntry
Eine Oeffnung der Lade, wie die Kasse sie puffert und meldet.
DrawerOpeningOperator
Wer die Lade oeffnete (gepufferte Oeffnung): der damals angemeldete Mitarbeiter. Der Server nimmt ihn nur, wenn er zum Betrieb gehoert und der Kasse zugewiesen ist, den Namen aus dem Konto; sonst gilt der sendende Benutzer.
DrawerOpeningsResult
Antwort von logMyDrawerOpenings.
DrawerRights
Die vier Rechte des angemeldeten Benutzers an der Lade.
DrawerState
Stand der Lade fuer die Kasse: Lade, Rechte, Schicht und was das Recht cashView zeigt.
ErrorRule
Eine Regel: fuer eine Art (und optional bestimmte Codes oder einen Ausgang) entweder ein Satz des Katalogs (key) oder ein Verhalten (behavior).
ExternalVoucherNumberCheck
Ergebnis von checkExternalVoucherNumber: die Nummer wie gespeichert (ok true, number) oder der Fehlercode des Servers (code).
FieldError
Ein Feldfehler aus details.errors[] einer validation-Antwort.
InspectionInfoRow
Eine Zeile der Kasseninfo am Bildschirm: Bezeichnung und eine oder mehrere Wertzeilen (die Seriennummer hat zwei).
KasseneckItem
KasseneckReceipt
KeckPayment
Eine Zahlung am Beleg — Zwilling von ReceiptPayment in @kreiseck/kasseneck-api (models/receipt-payment.ts) und der Eintraege, die functions/gemeinsam/zahlungen-core.js unter payments ablegt.
KeckPaymentInput
Eine Zahlung, wie der Aufrufer sie an sellReceipt/sell/ cancel schickt – Zwilling von ReceiptPaymentInput. id und changeCents vergibt der Server.
KeckTip
Trinkgeld auf einem Beleg.
KeckTipPerson
Eine Person, der sich Trinkgeld zuweisen lässt.
KeckTipRecipient
Ein Trinkgeld-Empfänger: ein Kassen-Benutzer und sein Anteil.
KeckVoucher
Gutschein am Beleg bzw. Gutscheinwunsch an createReceipt. Zwilling von Voucher im npm-Paket.
LastShift
Die zuletzt geschlossene Schicht einer Lade (Karte „Letzte Schicht“).
LogReceiptOutputsResult
Antwort von logReceiptOutputs.
ManualReceipt
NetworkPrinter
Ein Netzwerk-Drucker des Kontos (listMyPrinters).
NonCashAmount
OpenShiftResult
Antwort von openMyShift.
PosArticle
Artikel, wie ihn die Kasse für Kacheln und Belegpositionen braucht.
PosBusinessSettings
Was für den ganzen Betrieb gilt (im Panel eingestellt).
PosCardTerminal
Zugang zu einem angebundenen Kartenterminal (Spec 2026-11-14-sumup-kasse).
PosColor
PosDeviceSettings
Was nur für dieses Gerät gilt (in der Kasse selbst eingestellt).
PosDiscountPreset
Benannte Rabatt-Chips der Kasse: PosDiscountPresetKind.percent traegt percentBp (Basispunkte, 10 % = 1000), PosDiscountPresetKind.amount traegt amountCents (Cent). Der Name steht auf dem Chip und als Text der Rabattzeile am Beleg; ohne Namen ('') bleibt die Zeile „Rabatt“. Pruefen vor dem Schreiben: checkDiscountPresets. Zwilling von PosDiscountPreset.
Position
Eine Position des laufenden Verkaufs.
PosPrinterClient
Drucker und Druckjobs über die laufende Kassen-Sitzung.
PosReference
Einstellung am Artikel (Draht reference).
PosSettings
PosSettingsClient
PosSettingValue
Gemeinsame Sicht auf die Aufzählungen der Einstellungen: value ist der Wert am Draht.
PosText
Ein Eintrag des Katalogs.
PosThemeData
PosVoucherReturnType
Gutschein-Einstellung der Kasse (Block vouchers aus getKasseSettings).
PosVoucherSettings
PosVoucherType
Gutschein-Sorte (Gutscheine Stufe 4b): eine Kachel im Reiter „Gutscheine“. Die Kasse bekommt nur verkaufbare Sorten (aktiv und gueltig), in Kachelfolge. Verkauft wird ein Wertgutschein nur ueber eine Sorte: KeckVoucher(action: sell, type: kind, typeId: id, amountCents: …) (bei VoucherAmountMode.fixed genau amount.cents); Art, Satz, Gueltigkeit und Auszahlung nimmt der Server aus der Sorte und friert sie am Gutschein ein.
PrinterCatalogApproval
Freigabe eines Eintrags. Nur approved: true wirkt; ohne vollstaendigen Geraetetest gibt es keine Freigabe.
PrinterCatalogDeviceSettings
Der Teil der Geraete-Einstellungen, den ein bekanntes Modell beim ersten Einrichten vorschlaegt.
PrinterCatalogEntry
PrinterCatalogSettings
Was ein Eintrag beim Einrichten vorschlaegt.
PrinterCatalogValues
Druck-Werte eines Modells mit den Namen und Werten der Geraete-Einstellungen unter /v3.
PrinterDeviceTest
Protokoll des Geraetetests, der einen Eintrag freigibt.
PrintJob
PrintResult
Ergebnis eines Drucks, wie der Drucker es meldet.
QuantityDefaults
ReceiptDayGroup
ReceiptFilter
ReceiptOperator
Bediener an einem Beleg.
ReceiptOutput
Ein Eintrag aus outputs einer getReceipt-Antwort (/v3), gelesen am Beleg (KasseneckReceipt.outputs). Eine Art oder ein Ergebnis, das dieses Paket noch nicht kennt (neuerer Server), bleibt lesbar stehen; die Kasse zeigt es ohne Beschriftung (receiptOutputLabel gibt dann null).
ReceiptOutputActor
Wer die Ausgabe ausloeste: der Kassen-Benutzer, beim Geraet mit api_key das Konto (name dann null).
ReceiptOutputEntry
Eine Ausgabe, wie die Kasse sie puffert und meldet: ein Druck oder ein Teilen des Belegs. Siehe RegisterReceiptClient.logReceiptOutputs.
ReceiptSummary
Ein Beleg in der Liste — eine Zusammenfassung, kein vollstaendiger Beleg. Fuer Nachdruck oder Storno gehoert der Beleg ueber RegisterReceiptClient.get einzeln geholt.
RegisterInspectionClosings
Zeitplan des Monatsbelegs (closings); monthlyTime als HH:MM in timeZone.
RegisterInspectionInfo
Antwort von getRegisterInspectionInfo. Jedes Feld kann fehlen.
RegisterInspectionManufacturer
Hersteller der Kasse (manufacturer).
RegisterInspectionProduct
Produkt der Kasse (product).
RegisterInspectionSignature
Signatureinheit der Kasse, wie das Zertifikat sie nennt. Zeitpunkte als ISO-8601 in UTC; die Seriennummer dezimal als Text (sie kann groesser als 2^53 sein). Was der Server nicht sicher weiss, ist null.
RegisterReceiptClient
RegistrationInfo
Registrierdaten fuer den Block „Prüfangaben“ am Nullbeleg (Regelwerk 2): wann die Signaturkarte und wann die Kasse bei FinanzOnline registriert wurden. Zwilling von RegistrationInfo in @kreiseck/kasseneck-api 1.0, Drahtfeld registrationInfo (frueher pruefangaben).
RejectedReceiptOutput
Ein abgelehnter Eintrag: dauerhaft, aus dem Puffer nehmen und nicht noch einmal senden.
ReturnCode
Ein gelernter Leergut-Code: die GTIN und die Pfandart, der sie zugeordnet ist.
ReturnCodeEntry
Eine Zeile der Zuordnung: Pfandart und Stueckzahl, die ein Scan ins Leergut-Blatt bringt.
ReturnCodeMatch
Ergebnis von matchReturnCode: die Eintraege oder unknown (der Code ist keiner Pfandart zuzuordnen).
ReturnIssuedVoucher
Gutschein aus einer Rueckgabe in der Antwort von cancelReceipt (data.issuedVouchers[], npm ReturnIssuedVoucher). Beim ersten Mal mit Klartext-Code code; bei einer Wiederholung mit demselben idempotencyKey ohne Code, dafuer reprintRequired (der Zettel kommt dann ueber den Nachdruck). Nachsichtig gelesen: der Storno ist schon signiert, ein schiefes Feld darf ihn nie kosten.
SendReceiptEmailResult
Was das Backend ueber einen erfolgten Versand sagt.
Shift
Eine Schicht. Die Felder nach „Nur mit cashView“ sind null, wenn der Server sie nicht sendet (kein Recht); null heisst dort „nicht gesendet“ oder „es gibt (noch) keinen Wert“ – nie 0. Ohne das Recht shift sendet der Server von einer offenen Schicht nur die Grunddaten (id, drawerId, cashregisterId, number, status, openedAt, openedBy); alles andere ist dann null, auch openingFloatTakenOver.
ShiftActor
Wer gehandelt hat: Kassen-Benutzer (register_user), Inhaber (owner, Panel) oder Admin.
ShiftCloseResult
Ergebnis von closeMyShift: recount = bitte noch einmal zaehlen (kein Fehler), ready = nur geprueft (checkOnly), Schliessen mit diesem Betrag ginge, sonst geschlossen mit Z-Bon in receipt.
ShiftCountResult
Antwort von recordMyShiftCount: Soll, Zaehlung und Differenz dieser Zwischenzaehlung (Cent).
ShiftDifferencePart
ShiftDiscount
Ein Eintrag von ShiftRunningTotals.discounts bzw. ShiftSummaryReceipt.discounts.
ShiftExpectedPart
Ein Teil des Solls in Cent (Vorzeichen wie gebucht, Ausgaben negativ).
ShiftOwnerTip
Ein Eintrag von ShiftRunningTotals.ownerTips: Trinkgeld, das als Umsatz erfasst ist.
ShiftReceiptHeader
Kopf der Bon-Daten der Schicht (gemeinsam fuer Z-, X-Bon und Kassenbewegung).
ShiftReceiptMovement
Eine Kassenbewegung auf dem Z- oder X-Bon.
ShiftReconciliation
Nachrechnung des Laufstands beim Abschluss: stimmt er, oder welche Felder weichen ab.
ShiftReport
Antwort von getMyShiftReport.
ShiftRunningTotals
Laufstand der Schicht (nur mit cashView).
ShiftSummaryReceipt
Bon-Daten des Z-Bons (shift_close) bzw. X-Bons (shift_interim); Druck mit shiftReceiptLayout. Kein Registrierkassenbeleg.
ShiftTip
Trinkgeld eines Mitarbeiters mit seinem offenen Anspruch an die Lade (openCents, „offen“): im Kassenstand (DrawerState.tips) und auf dem Z- und X-Bon. Was davon gezeigt wird, sagt shiftTipLines.
ShiftTipLine
Eine Zeile des Trinkgelds eines Mitarbeiters (siehe shiftTipLines).
ShiftTipTotals
StockLevel
Bestand eines Artikels an einem Standort, in Tausendstel der Basiseinheit.
StockList
Antwort von listMyStock.
StockLocation
Ein Standort des Betriebs (Lager, Geschaeft, Fahrzeug).
StockLocationAddress
Anschrift eines Standorts. Jeder Teil ist null, wenn er fehlt oder leer ist; eine Anschrift ohne einen einzigen Teil gibt es nicht (dann ist StockLocation.address null).
Stocktake
Eine Inventur (Kopf), wie jeder Inventur-Aufruf ausser den Listen der Positionen und Zaehlungen sie sendet.
StocktakeActor
Wer etwas tat: Inhaber, Kasseneck-Admin, Kassen-Benutzer oder ein API-Schluessel.
StocktakeCancellation
Der Abbruch einer Inventur.
StocktakeClosing
Der Abschluss: er bucht in Teilen und laesst sich wieder aufnehmen.
StocktakeCount
Eine Zaehlung.
StocktakeCountPage
Eine Seite von listStocktakeCounts bzw. listMyStocktakeCounts, neueste zuerst.
StocktakeCountResult
Antwort von Zaehlen und Stornieren: die Zaehlung und ihre Position danach (Summe der Runde in StocktakeItem.quantity, kein Soll).
StocktakeCountVoided
Das Storno einer Zaehlung.
StocktakeInventoryLine
Eine Zeile des Inventars (nach dem Abschluss).
StocktakeItem
Eine Position: ein Artikel in einem Zustand (sellable bzw. defective).
StocktakeItemPage
Eine Seite von listStocktakeItems bzw. listMyStocktakeItems, nach Kennung.
StocktakeNotBooked
Was von einer Position nicht gebucht wurde, und warum.
StocktakePdfInfo
Das Inventurprotokoll: ob es da ist, und die Pruefsummen der Fassungen, die der Aufrufer sehen darf.
StocktakeProgress
Fortschritt: Zahl der Positionen und ob Positionen zum Nachzaehlen offen sind.
StocktakeRecount
Ein Nachzaehlen-Auftrag an einer Position.
StocktakeReview
Die Pruefung: wann und von wem angestossen, ob Soll und Differenz schon gerechnet sind.
StocktakeScope
Umfang einer Inventur, bei der Anlage eingefroren.
StocktakeSeal
Siegelstand des Lagerprotokolls beim Abschluss: Wiener Tage YYYY-MM-DD. verified: null heisst „nicht fertig geprueft“, nie Bruch.
StocktakeTotals
Summen des Abschlusses (Anzahlen von Positionen; Werte nur mit dem Recht costs).
StocktakeWarning
Ein Hinweis zur Inventur, mit der Zahl der betroffenen Positionen. Er ist kein Fehler: der Vorgang hat gewirkt.
StockValue
Lagerwert eines Artikels. Derselbe Typ an der Kasse (pos.dart) und in der Lager-API (inventory.dart); er kommt nur, wenn Werte freigegeben sind: an der Kasse mit dem Recht stockCosts des Kassenbenutzers, in der Lager-API mit dem Konto-Schalter „Einkaufswerte per API“ (Recht costs).
SumupTerminalAccess
SumUp-Zugang eines Geräts.
TileBooking
Ergebnis eines Kachelgriffs: der neue Korb und die betroffene Zeile.
TileCategory
TipBalance
„Mein Trinkgeld“ (RegisterReceiptClient.getMyTipBalance): der Stand der angemeldeten Person. openCents kann negativ sein (zu viel ausgezahlt, wird mit dem naechsten Trinkgeld verrechnet); keptTodayCents = heute genommen (ausgezahlt, bar gleich behalten, Kartentrinkgeld bar). Bei per_person die Summe ueber alle Laden, otherDrawers leer. Ohne Schichtbetrieb der Lade immer 0 (kein Anspruch). Zwilling von TipBalance.
TipBalanceOtherDrawer
Eine andere Lade des Kontos mit offenem Betrag der Person (nur bei per_drawer).
TipClaim
Offener Trinkgeld-Anspruch eines Mitarbeiters (auszahlbar beim Abschluss oder per tip_payout).
TipPayout
Trinkgeld-Auszahlung beim Abschluss: hoechstens der offene Anspruch (DrawerState.tipClaims).
VoucherArticle
Artikel eines Leistungsgutscheins, wie der Server ihn festhaelt (am Beleg und in checkVoucher). Zwilling von VoucherArticle im npm-Paket.
VoucherCheck
Stand eines Gutscheins nach dem Code-Eingeben (checkVoucher). Felder, die zur Art nicht passen oder die der Server nicht sendet, sind null.
VoucherLabelTemplate
Etikett-Vorlage in der /v3-Form (Groesse, Layout, Drehung, Felder, Freitext). Das Paket zeichnet keine Etiketten: es reicht die Vorlage als Kopie durch, gezeichnet wird in der Kasse. Weitere Schluessel eines neueren Servers bleiben erhalten (toJson).
VoucherPerms
Die drei Gutschein-Rechte, aufgeloest (kein Schluessel fehlt mehr).
VoucherTypeAmount
Betrag einer Gutschein-Sorte: frei (Zahlenfeld an der Kasse) oder fest (sofort in den Korb), Cent ganzzahlig.
VoucherTypeValidity
Gueltigkeit einer Gutschein-Sorte: unbefristet oder N Jahre einloesbar, danach 3 Jahre Rueckzahlung.
VoucherValidity
Gueltigkeit eines Gutscheins; Daten als YYYY-MM-DD (Wiener Tag). Was der Server nicht nennt, ist null.

Enums

ArticleExternalVoucher
Art des fremden Gutscheins am Artikel (/v3 externalVoucher, gespeichert fremdgutschein; Fremdgutscheine an der Kasse, 11.22.0). Die Regeln dazu stehen in fremdgutschein_artikel.dart; die Art steht hier, weil inventory.dart diese Datei ohne Flutter einbindet und die Regeln die Gutschein-Einstellung brauchen.
CancellationState
Storno-Stand eines Belegs in der Liste (Drahtfeld cancellationStatus, Katalog STORNO_STAND): none, partial, full. Ein unbekannter kuenftiger Wert kommt als CancellationState.unknown an und nie als none: die Kasse bietet dann keinen Storno an (siehe canCancel), der Server haelt ohnehin die Restmengen.
CreditCardProvider
DiscountKind
DiscountPresetReason
Warum eine Vorlage abgelehnt wird; je Grund ein Satz im Katalog (discountPresetMessages). value ist der Drahtname (unknown_field).
ErrorKind
Wie ein Fehler fuer die Einordnung heisst (kind im Vertrag):
ErrorOutcome
Ausgang eines gescheiterten Aufrufs. rejected: nichts geschehen. unknown: der Vorgang kann ausgefuehrt sein (ein Beleg signiert, ein Storno gebucht, Ware gebucht, eine Rechnung ausgestellt); nie blind wiederholen. Belege, Stornos und Zahlungen nachlesen; ein Aufruf mit idempotencyKey nur mit demselben Schluessel erneut senden (wirkt genau einmal, ein neuer buchte doppelt); ohne Schluessel erst nachlesen.
ErrorRuleBehavior
Was eine Regel ohne eigenen Satz tut (behavior im Vertrag).
KeckPaymentMethod
PaymentFilter
PosCardProvider
Karte gibt es erst mit eingerichtetem Anbieter.
PosCartWidth
Breite der rechten Spalte (Korb) an diesem Geraet (device.cartWidth); in der schmalen Ansicht ohne Wirkung.
PosCategoryPosition
PosCheckoutMode
PosCodePage
PosCut
PosDiscount
PosDiscountPresetKind
Art einer Rabatt-Vorlage (business.discountPresets[].kind): Prozent oder fester Betrag (gespeichert art: prozent | betrag).
PosDrawerAutoOpen
PosExternalVouchers
Freigabe fuer Fremdgutscheine des Kontos (vouchers.externalVouchers, Server 2026-11): off keine, multiPurpose nur Wertgutscheine (Mehrzweck) eines anderen Systems, all dazu Einzweckgutscheine. Die Kasse zeigt den Weg „Fremdgutschein“ nur ab multiPurpose, die Art Einzweck nur bei all; der Server prueft dieselbe Freigabe (external_voucher_not_enabled, external_voucher_type_not_enabled). Die Test-Umgebung ist immer all. Zwilling von PosExternalVouchers im npm-Paket.
PosFontSize
PosLayout
PosLogoScale
Größe des Bild-Logos am Beleg (logoScale).
PosLogoSize
Größe des Kürzel-Logos in der Kopfzeile der Kasse (logoSize).
PosPaperSize
PosPrinterType
sdp = Netzwerk über Epson Server Direct Print (der Drucker holt die Jobs vom Backend), network = direkt per IP (ePOS), bluetooth, usb = Kabel, connect = Kasseneck Connect (lokaler Agent auf dem Kassen-Rechner).
PosQrMode
Mit welchem Befehl der Signatur-QR auf den Bon kommt.
PosQuantity
PosReceiptOutput
PosSettingsFontSize
PosSurface
Die Seite, auf der ein Satz gilt (only im Vertrag).
PosTerminalType
Art des Kartenterminals an dieser Kasse: keines oder Hobex HPS.
PosTerminalVia
Terminal-Ansprache: direkt per IP oder über Kasseneck Connect.
PosTheme
PosTileHeight
PosTileStyle
PosTipKeptMode
Bar-Trinkgeld gleich behalten (business.tipKeptMode, 11.22.0): ask = Schalter an der Kasse, vorbelegt mit tipKeptByDefault; always/never = kein Schalter, die Kasse setzt die Wahl selbst. Entscheidung ueber tipKeptFor.
PosTipKind
Trinkgeld-Arten, die die Kasse anbietet (business.tipKinds): Prozent, Aufrunden (der Gast zahlt auf einen runden Betrag) und Gesamt (der Gast nennt den Betrag, den er insgesamt zahlt). Dieselben Werte hat business.tipStart, die zuerst offene Art.
PosTipMode
PosWatermark
PosWatermarkScale
Größe des Wasserzeichens (watermarkScale), getrennt vom Beleg-Logo.
PosWatermarkSide
Seite des Wasserzeichens; alt, abgelöst von watermarkX, bleibt fürs Mischen alter Stände.
PrinterCatalogValueField
Ein Wertfeld eines Eintrags (PrinterCatalogValues); der Geraetetest nennt, welche am Geraet geprueft sind. value ist der Name im Vertrag, ein Test haelt die Liste vollstaendig.
QuantityRule
Mengenregel eines Artikels.
ReceiptPeriod
ReceiptTypeFilter
ReferenceCheckResult
Ergebnis der Pruefung: empty und error sperren, warning zeigt den Hinweis.
ReferenceMode
optional = darf leer bleiben, required = Pflicht.
RegisterScope
Reichweite eines Rechts.
ReturnDisposition
Rueckgabe-Wahl als Typ; der Name ist der Wert am Draht (ReturnDisposition.defective.name = 'defective').
StockLocationType
Typ eines Standorts; der Name ist der Wert am Draht.
TipPaymentKind
Zahlart des Trinkgelds, nach der die Stufe gilt: bar (tipKeptMode) oder Karte (tipCardKeptMode). Zwilling von TipPaymentKind ('cash' | 'card').
TipStatusKind
Was mit dem Trinkgeld dieses Verkaufs geschieht (tipStatus): gleich behalten oder offen. Zwilling von TipStatusKind.
VatRate
VoucherAction
Gutschein-Aktion. Zwilling von VoucherAction im npm-Paket; der Name ist zugleich der Drahtwert.
VoucherAmountMode
Betrag einer Gutschein-Sorte: frei an der Kasse eingegeben oder fest.
VoucherPayout
Auszahlung eines Gutscheins bzw. einer Sorte: erlaubt oder nie (nur bei unbefristeter Gueltigkeit). Bei never lehnt der Server jede Auszahlung ab (voucher_payout_not_allowed); Einloesen geht unveraendert.
VoucherStatus
Stand eines Gutscheins nach dem Code-Eingeben.
VoucherType
Gutscheinart. Zwilling von VoucherType im npm-Paket; am Draht steht wire (multi_purpose …), in Dart heisst der Wert in Dart-Schreibweise.
VoucherTypeValidityPattern
Gueltigkeit einer Gutschein-Sorte: unbefristet oder N Jahre (das Muster der Sorte, nicht das eines Gutscheins, siehe voucherValidityPatterns).

Constants

addOnBlockReasons → const List<String>
Warum ein Artikel kein Zusatz sein kann (Panel zeigt den Grund an).
addOnsMax → const int
Hoechstens so viele Zusaetze je Liste (der Server weist mehr ab).
afterCountTypes → const List<String>
Was nach dem Zaehlen beim Schicht-Abschluss mit dem Geld geschieht (Katalog NACH_ZAEHLUNG_ART): cash_drop = entnehmen (gebucht als Abschoepfung), change_in = einlegen (gebucht als Wechselgeld). Beides Geldtransit, kein Umsatz.
articleExternalVoucherInvalid → const String
Fehlercode beim Speichern eines Artikels, intern und unter /v3 gleich.
articleExternalVoucherVatRates → const List<num>
Saetze, mit denen ein Einzweckgutschein verkauft werden kann (Prozent wie PosArticle.vatRate; 0 = befreit verkauft): die Saetze der Kasse, dieselben wie externalVoucherVatRatesBp / 100.
callsWithEffect → const List<String>
Kassen-Aufrufe mit Wirkung: nach Frist oder Netzfehler nie „erneut versuchen“; siehe messageOutcome.
cancellationPaymentErrorMessages → const Map<String, String>
Storno mit mehreren Zahlungen: Code des Backends -> Schluessel des Satzes.
cancellationReasons → const Map<String, String>
Die Gründe, die das Backend annimmt – Codes wie unter /v3 (Katalog STORNO_GRUND), Beschriftung für den Bildschirm und den Bon (bleibt deutsch, sie steht so am Beleg). Reihenfolge wie im Katalog des Backends.
cancellationReservationMs → const int
Ab wann eine liegengebliebene Reservierung nicht mehr zählt (wie im Backend). Ohne diese Grenze bliebe eine Position für immer gesperrt, weil ein Abbruch irgendwann einmal eine Reservierung stehen ließ.
cancellationStatuses → const List<String>
Stornostand eines Belegs in der Belegliste (Katalog STORNO_STAND).
cancellationVoucherErrorMessages → const Map<String, String>
Storno mit Rueckgabe als Gutschein: Code des Backends -> Schluessel des Satzes; siehe cancellationErrorMessage.
cardBlockHeadings → const Map<CreditCardProvider, String>
Die Überschrift des Kartenzahlungsblocks je Anbieter.
cashLocations → const List<String>
Woher Wechselgeld kommt bzw. wohin abgeschoepft wird (Katalog KASSEN_ORT).
defaultVatRate → const VatRate
Der uebliche Fall am Tresen.
depExportDone → const String
depExportErrorCodes → const Set<String>
Stabile Fehlercodes der fuenf Endpunkte unter /v3 (Katalog dep_nachschau). Sie kommen als KasseneckApiError.code an; der Code eines fehlgeschlagenen Exports steht ausserdem in DepExportFailedException.error.
depExportFailed → const String
depExportFiles → const Set<String>
Die Dateien eines Exports (file von getDepExportFile): das DEP (JSON), das Protokoll (PDF), die Positionen (CSV) und das ZIP mit allem.
depExportRunning → const String
Werte von status eines Exports.
depositContainerTypes → const List<String>
Gebindetyp einer Pfandart (frei, nur zur Anzeige).
depositErrorMessages → const Map<String, String>
Pfand und Leergut: Code des Backends -> Schluessel des Satzes; siehe depositErrorMessage.
depositKinds → const List<String>
Art einer Pfandart: Einweg oder Mehrweg.
depositOnPremisesDefaults → const List<String>
Vorbelegung, ob Getraenke vor Ort getrunken oder mitgenommen werden.
depositPreviewErrorCodes → const List<String>
Fehlercodes der Vorschau (die /v3-Codes von createReceipt).
depositReturnModes → const List<String>
Wer nimmt Leergut an der Kasse zurueck: diese Kasse, eine gemeinsame Stelle oder niemand.
differencePartTypes → const List<String>
Teile der Gesamtdifferenz einer geschlossenen Schicht mit Zwischenzaehlung: interim je Zaehlung, closing der Abschluss.
discountPresetAmountCents → const ({int max, int min})
Betrag in Cent: 0,01 € bis 1.000.000,00 €.
discountPresetMessages → const Map<DiscountPresetReason, String>
Grund -> Satz (Katalog discount_preset.*).
discountPresetNameMax → const int
Laenge des Namens in Zeichen (nach dem Trimmen).
discountPresetPercentBp → const ({int max, int min, int step})
Prozent in Basispunkten: 0,1 % bis 100 % in Schritten von 0,1 %.
discountPresetsMax → const int
Hoechstzahl der Vorlagen.
errorCodeRules → const List<ErrorRule>
Regeln je Code, vor der Regel der Art; siehe findErrorRule.
errorOutcomeRules → const List<ErrorRule>
Regeln je Ausgang, nach den Code-Regeln; siehe findErrorRule und messageOutcome.
errorRules → const List<ErrorRule>
Genau eine Regel je Art, der Stand von 1.0.0-rc.4; siehe findErrorRule.
eurDenominations → const List<int>
Scheine und Muenzen in Euro-Cent, vom groessten Schein abwaerts (Backend EUR_STUECKELUNG).
expectedPartKeys → const List<String>
Teile des Solls in der Lade (Shift.expectedParts, Karte „So setzt sich das zusammen“): bekannt sind expectedPartKeys; die Summe der Teile ist das Soll.
externalVoucherArticleMessages → const Map<String, String>
Artikel als fremder Gutschein: Grund (data.grund) -> Schluessel des Satzes; siehe externalVoucherArticleErrorMessage.
externalVoucherArticleReasons → const List<String>
Welche Regel verletzt ist (Antwortfeld data.grund), in der Reihenfolge, in der der Server prueft.
externalVoucherKindLabels → const Map<String, String>
Art eines fremden Gutscheins (multi_purpose, single_purpose) -> Schluessel der Beschriftung.
externalVoucherNumberMax → const int
Hoechstlaenge der Nummer eines Fremdgutscheins (nach dem Abschneiden des Rands).
externalVouchersLabels → const Map<String, String>
Freigabe der Fremdgutscheine (off, multi_purpose, all) -> Schluessel der Beschriftung.
externalVoucherTaxedWithMax → const int
Hoechstlaenge von KeckVoucher.taxedWith am Fremdgutschein (Beleg im fremden System, mit dem der Einzweckgutschein versteuert ist).
externalVoucherTileBlocks → const List<String>
Warum die Kachel eines fremden Gutscheins gesperrt ist (not_enabled, type_not_enabled; Saetze in externalVoucherTileMessages).
externalVoucherTileMessages → const Map<String, String>
Fremdgutscheine (1.31.0): Sperrgrund der Kachel (externalVoucherTileBlock) -> Schluessel des Satzes.
externalVoucherVatRatesBp → const List<int>
Saetze, mit denen ein fremder Einzweckgutschein verkauft sein kann (Basispunkte): die Saetze der Kasse (20, 10, 13, 19, 4,9 %) und 0 = befreit verkauft (Kleinunternehmer).
fontScales → const Map<PosFontSize, double>
Schriftfaktoren. Auch XL bleibt bedienbar — ein Faktor, der die Kasse sprengt, hilft niemandem, der schlecht sieht.
inspectionSignatureActive → const String
Stand der Signatureinheit: in Betrieb.
inspectionSignatureOutage → const String
Stand der Signatureinheit: offener Ausfall der Kasse.
invalidDiscountPreset → const String
Fehlercode, den der Server bei einer ungueltigen Vorlage sendet.
legacyBusinessKeys → const Map<String, String>
Schlüssel der inneren Form (0.x, Zwischenspeicher bis Dart 9.x) -> Draht, Betriebsteil. Ein Test hält die Tabelle deckungsgleich mit renames-1.0.json (structure.pos-settings-defaults.json.business).
legacyDeviceKeys → const Map<String, String>
Wie legacyBusinessKeys für den Geräteteil.
legacyShortcutActions → const Map<String, String>
Tasten-Aktionen der inneren Form -> Draht.
legacyValues → const Map<String, Map<String, String>>
Werte der inneren Form -> Draht, je Drahtfeld; gleichlautende Werte (gptom, S) stehen nicht darin. Ein Test hält die Tabelle deckungsgleich mit renames-1.0.json (values.pos-settings-defaults.json).
manualMovementTypes → const List<String>
Was die Kasse von Hand buchen darf. Pflichtangaben je Art (sonst lehnt der Server ab): note bei other_in/other_out, recipientId bei tip_payout, targetDrawerId bei transfer_out. location bei change_in/cash_drop ist freiwillig.
manualOpeningReasons → const List<String>
Die Gruende des Knopfs „Lade“; other braucht einen Text (note).
manualReceiptErrorCodes → const List<String>
Fehlercodes von createReceipt zur Nacherfassung (Vertrag errorCodes.manualReceipt). manual_receipt_duplicate traegt in details.receiptId den Beleg, der den Handbeleg schon nacherfasst hat: nicht erneut senden, sondern diesen nehmen.
manualReceiptReasons → const List<String>
Gruende einer Nacherfassung: fuenf Ausfall-Gruende und die Leistung ausser Haus.
maxAmountCents → const int
Obergrenze je Position: 100.000,00 €.
maxPayments → const int
Hoechstzahl der Zahlungen je Beleg (Backend: MAX_ZAHLUNGEN).
movementTypes → const List<String>
Alle Arten einer Kassenbewegung (Katalog KASSEN_BEWEGUNG_ART). Die ersten acht sendet die Kasse (manualMovementTypes); transfer_in (Gegenseite einer Umbuchung), expense, count_difference, handover_difference und interim_difference (Differenz einer Zwischenzaehlung) vergibt nur der Server.
openingReasons → const List<String>
Warum die Lade aufging (Katalog LADE_OEFFNUNG_GRUND). sale, cash_movement, shift_open und shift_close meldet die Kasse selbst beim jeweiligen Vorgang (voucher_payout bei der Gutschein-Auszahlung); von Hand waehlt der Kassier aus manualOpeningReasons.
ownVoucherCodeShapes → const List<String>
Wie sehr eine Eingabe einem eigenen Gutscheincode gleicht (ownVoucherCodeShape): valid = gueltiger eigener Code; checksum = 12 Zeichen des Code-Alphabets mit falschem Pruefzeichen (etwa eine zwoelfstellige Webshop-Nummer); length = Muster 4-4-x mit echten Bindestrichen - (nie ., _, /), aber nicht 12 Zeichen; none = keine Aehnlichkeit. Zwilling von OWN_VOUCHER_CODE_SHAPES.
posAutoLogoutMinutes → const List<int>
Automatisches Abmelden nach Minuten Ruhe; 0 = nie.
posBusinessOptionalChoices → const List<String>
Optionale Betriebs-Einstellungen mit Wertemenge (Zwilling von POS_BUSINESS_OPTIONAL_CHOICES): ohne Standardwert, der Server sendet sie nur, wenn sie gespeichert sind. tipKinds ist eine Liste, tipStart, tipKeptMode und tipCardKeptMode je ein Wert.
posBusinessOptionalFields → const List<String>
Optionale Betriebs-Schalter: ohne Standardwert, der Server sendet sie nur, wenn sie gespeichert sind (Zwilling von POS_BUSINESS_OPTIONAL_FIELDS). Gelesen nur als Wahrheitswert; fehlt einer, gilt sein wirksamer Standard (posTipKeptByDefault: aus, posCustomDiscountAllowed: an, posTipCardKeptByDefault: aus, posTipSelfPayout: an).
posBusinessOptionalIds → const List<String>
Optionale Betriebs-Kennungen (Zwilling von POS_BUSINESS_OPTIONAL_IDS): ohne Standardwert, der Server sendet sie nur, wenn sie gesetzt sind. Gelesen nur als gültige Nummer (isPosSumupMerchantCode); der Schreibweg nimmt die Nummer oder null (Bindung lösen).
posBusinessOptionalLists → const List<String>
Optionale Betriebs-Listen aus Objekten (Zwilling von POS_BUSINESS_OPTIONAL_LISTS): ohne Standardwert, der Server sendet sie nur, wenn sie gespeichert sind (auch als leere Liste). Der Leser uebernimmt die Eintraege mit der Form einer Vorlage; eine mit unbekannter Art faellt weg.
posDeviceOptionalChoices → const List<String>
Optionale Geraete-Einstellungen mit Wertemenge (POS_DEVICE_OPTIONAL_CHOICES).
posDeviceOptionalFields → const List<String>
Optionale Geraete-Einstellungen: ohne Standardwert, der Server sendet sie nur, wenn sie gesetzt sind (Zwilling von POS_DEVICE_OPTIONAL_FIELDS). Sie fehlen darum in den Standardwerten; gelesen werden sie nur als gueltige Kennung, der Schreibweg nimmt Kennung oder null (Zuordnung entfernen).
posDeviceOptionalSwitches → const List<String>
Optionale Geraete-Schalter: ohne Standardwert, der Server sendet sie nur, wenn sie gespeichert sind (Zwilling von POS_DEVICE_OPTIONAL_SWITCHES). Gelesen werden sie nur als Wahrheitswert, der Schreibweg nimmt true, false oder null (entfernen); fehlt printerHint, gilt an.
posDoneScreenSeconds → const List<int>
Wie lange die Fertig-Seite stehen bleibt, in Sekunden; 0 = bis zum Tippen.
posErrorCodes → const List<String>
Gleich pos.posErrorCodes im Vertrag (surface.json): Fehlerfälle der Endpunkte (seit 10.7 auch die fuenf der Inventur, seit 11.1 die sechs der Schicht) und ihre Handler-Codes, dazu Anmelde- und Randcodes (ohne den Partner-Zugang) und der Paketcode route_missing. validation trägt details.errors[] mit dem äußeren Feldpfad (posFieldErrors).
posLabels → const Map<String, PosText>
Beschriftungen: Knoepfe, Ueberschriften, Zeilennamen, was kein Satz ist.
posMessages → const Map<String, PosText>
Was die Kasse selbst sagt: ein Satz je Schluessel (bereich.name), gleich wie im Web.
posShortcutActions → const List<String>
Aktionen der Kasse, die eine Taste bekommen können (Schlüssel von device.shortcuts), Zwilling von POS_SHORTCUT_ACTIONS.
posShortcutDefaults → const Map<String, List<String>>
Tastenbelegung: Aktion -> Tasten (Mod+F, Enter, Escape, F5 ...; Mod = Cmd auf dem Mac, Strg sonst). Zwilling von POS_SHORTCUT_DEFAULTS.
posShortcutSharedPairs → const List<(String, String)>
Aktionen, die sich eine Taste teilen dürfen (Backend TASTEN_PAARE), Zwilling von POS_SHORTCUT_SHARED_PAIRS. Jede andere Doppelbelegung weist der Server ab, und dieses Paket schon vor dem Senden.
posTextsVersion → const String
Version des Vertrags, aus dem dieser Katalog erzeugt ist.
posVatRateOrder → const List<double>
Steuersätze in der Reihenfolge, in der die Kasse sie zeigt.
posWatermarkStrengths → const List<int>
Deckkraft des Wasserzeichens in Prozent, bewusst Stufen.
printJobSources → const List<String>
Bekannte Werte für source (Katalog DRUCK_QUELLE): die Kasse oder das Panel. Der Server nimmt Freitext bis 40 Zeichen an und übersetzt nur diese beiden.
printJobStatuses → const List<String>
Stände eines Druckjobs (Katalog DRUCKJOB).
printJobStatusUnknown → const String
Stand, wenn der Server einen nennt, den dieses Paket nicht kennt (oder keinen). Er beendet die Abfrage, gilt aber nie als gedruckt.
quantityRules → const List<String>
Die Werte von quantityRule (Katalog MENGENREGEL).
receiptEmailErrorMessages → const Map<String, String>
Beleg per E-Mail: Code des Backends -> Schluessel des Satzes.
receiptEmailSendErrorCodes → const List<String>
Die fachlichen Codes von sendReceiptEmail (ohne Anmeldung und Rand).
receiptEmailVias → const List<String>
Versandwege einer Belegmail (Katalog MAILWEG): Postfach des Betriebs, Plattform, Plattform nach gescheitertem eigenen Postfach.
receiptNumberMaxDigits → const int
Höchstzahl der Stellen, die eine Belegnummer hat.
receiptOutputEntriesMax → const int
Hoechstens so viele Eintraege je Aufruf von logReceiptOutputs.
receiptOutputEntryErrorCodes → const List<String>
Codes je Eintrag in rejected[].code einer Antwort von logReceiptOutputs: der Eintrag ist dauerhaft abgelehnt (aus dem Puffer nehmen, nicht noch einmal senden). validation heisst hier: ein Druck ohne oder mit unbekanntem Ergebnis.
receiptOutputKinds → const List<String>
Arten einer Ausgabe des Belegs (Katalog AUSGABE_ART): print Erstdruck, reprint Duplikat, email Belegmail, link_shared Link geteilt, pdf_shared PDF geteilt, opened vom Kunden geoeffnet (Abrufe je Stunde). Zwilling von RECEIPT_OUTPUT_KINDS.
receiptOutputLogKinds → const List<String>
Die Arten, die eine Kasse selbst meldet (RECEIPT_OUTPUT_LOG_KINDS). email und opened schreibt das Backend selbst; meldet eine Kasse sie, lehnt der Server genau diesen Eintrag ab (invalid_output_kind).
receiptOutputResults → const List<String>
Ergebnis einer Ausgabe (Katalog AUSGABE_ERGEBNIS); Mail und Abruf sind immer ok. Zwilling von RECEIPT_OUTPUT_RESULTS.
referenceHintMax → const int
referenceInputMax → const int
Hoechstlaenge der Eingabe an der Kasse.
referenceLabelMax → const int
referencePatternMax → const int
referencePatternTemplates → const Map<String, String>
Vorlagen fuer das Musterfeld (Panel).
returnDispositionLabels → const Map<String, String>
Rueckgabe beim Storno: Wahl (restock, defective, disposed) -> Schluessel der Beschriftung.
returnDispositions → const List<String>
Die Werte der Rueckgabe-Wahl, englisch wie am Draht, in der Reihenfolge des Vertrags.
shiftReceiptKinds → const List<String>
Arten der Bon-Daten (Katalog SCHICHT_BON_ART): Z-Bon, X-Bon, Kassenbewegung.
stockLocationTypes → const List<String>
Standort-Typen (Katalog STANDORT_TYP), englisch wie am Draht.
stocktakeStatuses → const List<String>
Stand einer Inventur (Katalog INVENTUR_STATUS). Gezaehlt wird in counting; review rechnet Soll und Differenz (erst ab hier sichtbar, blind); closing bucht den Abschluss in Teilen; closed und cancelled sind endgueltig. creating steht nur, solange eine grosse Anlage ihre Positionen schreibt.
tileHeights → const Map<PosTileHeight, double>
Kachelhöhen in dp. Auch die flachste bleibt ein Fingerziel: unter 48 dp trifft ein Finger nicht mehr verlässlich.
tipClaimScopeLabels → const Map<String, String>
Offenes Trinkgeld zaehlt (per_drawer, per_person) -> Schluessel der Beschriftung.
tipClaimScopes → const List<String>
Wo der offene Trinkgeld-Anspruch gefuehrt wird (Spec 2026-11-11-kartentrinkgeld, F2; Katalog TRINKGELD_ANSPRUCH): per_drawer = je Lade (Vorgabe), per_person = ein Stand je Person ueber alle Laden. Beschriftung ueber tipClaimScopeLabels. Zwilling von TIP_CLAIM_SCOPES.
tipKeptModeLabels → const Map<String, String>
Trinkgeld gleich behalten (ask, always, never) -> Schluessel der Beschriftung.
tipRefundSources → const List<String>
Woher das Trinkgeld beim Storno zurueckkommt: drawer – die Lade zahlt es aus; employee – die Mitarbeiterin gibt es selbst. Nur bei Barrueckgabe.
ungroupedColor → const String
ungroupedId → const String
vatRateChoices → const List<VatRate>
Die Steuersaetze zur Wahl — haeufige zuerst.
voucherErrorMessages → const Map<String, String>
Gutschein-Fehler (/v3): Code des Backends -> Schluessel des Satzes; siehe voucherErrorMessage.
voucherSourceExternal → const String
Herkunft eines Fremdgutscheins (KeckVoucher.source, Katalog GUTSCHEIN_QUELLE).
voucherSources → const List<String>
Alle Herkuenfte eines Gutscheins (Zwilling von VOUCHER_SOURCES).
voucherValidityPatterns → const List<String>
Die Gueltigkeitsmuster (unlimited, 1+3 = ein Jahr einloesbar, drei rueckzahlbar, custom).

Properties

articleExternalVoucherTypes → List<String>
Die Arten am Draht (Zwilling von ARTICLE_EXTERNAL_VOUCHER_TYPES).
final
cancellationErrorCodes → List<String>
Codes von cancelReceipt (Formfehler an payments stehen in paymentErrorCodes).
final
externalVouchers → List<String>
Die Freigaben fuer Fremdgutscheine (Drahtwerte, wie externalVouchers im Vertrag).
final
paymentErrorCodes → List<String>
Codes rund um payments an createReceipt und cancelReceipt.
final
posBusinessValues → Map<String, List<Object>>
Die Wertemenge je Betriebsfeld, soweit das Feld eine hat (Zwilling von POS_BUSINESS_VALUES); dagegen prüft der Schreibweg vor dem Senden.
final
posDeviceValues → Map<String, List<Object>>
Wie posBusinessValues für die Geräte-Einstellungen (POS_DEVICE_VALUES).
final
receiptEmailErrorCodes → List<String>
Codes von sendReceiptEmail.
final
receiptErrorCodes → List<String>
Codes von createReceipt und getReceipt (ohne die Zahlungscodes, die stehen in paymentErrorCodes). receipt_outcome_unknown heisst: der Beleg ist moeglicherweise signiert, nachlesen statt wiederholen (mit idempotencyKey: dieselbe Anfrage mit demselben Schluessel erneut senden).
final
receiptOutputErrorCodes → List<String>
Codes von logReceiptOutputs, wenn die ganze Anfrage scheitert (Vokabular errorCodes.registerHandlersByEndpoint.logReceiptOutputs), dahinter Anmeldung und Rand, zuletzt route_missing. Zwilling von RECEIPT_OUTPUT_ERROR_CODES.
final
voucherAmountModes → List<String>
Die Betragsarten einer Sorte (Drahtwerte, wie voucherAmountModes im Vertrag).
final
voucherKinds → List<String>
Die Arten, die checkVoucher liefert (Drahtwerte, wie voucherKinds im Vertrag surface.json).
final
voucherPayouts → List<String>
Die Auszahlungswerte (Drahtwerte, wie voucherPayouts im Vertrag).
final
voucherStatuses → List<String>
Die Staende, die checkVoucher liefert (Drahtwerte, wie voucherStatuses im Vertrag).
final
voucherTypeKinds → List<String>
Die Arten einer Gutschein-Sorte (Drahtwerte, wie voucherTypeKinds im Vertrag): nur Wertgutscheine, Leistung und Aktion sind keine Sorte.
final
voucherTypeValidityPatterns → List<String>
Die Gueltigkeitsmuster einer Sorte (Drahtwerte, wie voucherTypeValidityPatterns im Vertrag).
final

Functions

addOnDisplayOrder(List<KasseneckItem> items) → List<int>
Bon-Reihenfolge: jede Hauptposition, direkt gefolgt von ihren Zusaetzen (stabil). Positionen mit ungueltigem Verweis bleiben an ihrem Platz.
addOnReferencesValid(List<KasseneckItem> items) → bool
Halten die Verweise den Server-Regeln stand? Ganze Zahl, zeigt nach vorne auf eine Warenposition, die selbst kein Zusatz ist (sonst antwortet createReceipt mit invalid_add_on_reference).
addOnRemap(List<KasseneckItem> items, List<num> quantities) → List<int?>
Storno: Verweis je Storno-Position (in der Reihenfolge der stornierten Positionen, Menge > 0). Ein Zusatz behaelt ihn nur, wenn seine Hauptposition mit storniert wird, umgerechnet auf den neuen Index; sonst null.
addOnsFor(PosArticle article, ArticleGroup? group, Map<String, PosArticle> articleById) → List<String>
Wirksame Zusatzliste eines Artikels: eigene Liste (auch leer) vor der der Gruppe; still heraus fallen der Artikel selbst, Unbekanntes, Dubletten und alles, was nicht als Zusatz taugt. Leer = kein Fenster.
addOnsOfItem(List<KasseneckItem> items, int index) → List<int>
Indizes der Zusaetze einer Hauptposition (Storno: mit vormerken, abwaehlbar).
allowedQuantity(PosArticle a, num wanted) → num
Deckelt eine gewünschte Menge an der Höchstmenge des Artikels.
amountDue(Cart cart, int discount) → int
Zu zahlen nach Rabatt — nie unter null, außer mit Leergut im Korb: dann ist ein negativer Betrag die Auszahlung an den Gast (Ware und Leergut verrechnet; der Rabatt trifft das Leergut nicht).
asksRefundTip(KasseneckReceipt receipt, {int? nowMs}) → bool
Fragt das Storno „Trinkgeld auch zurueckgeben?" – nur bei offenem Mitarbeiter-Trinkgeld und ohne Wertgutschein am Beleg (Ruling R59). Einen Wertgutschein spiegelt nur ein Storno, der alles nimmt; dort geht das Trinkgeld immer mit (der Server weist refundTip: false mit tip_keep_not_possible_with_voucher ab), die Kasse zeigt cancellation.tip_refunded_with_voucher und sendet refundTip: true. Die Frage nach der Quelle bleibt (asksTipRefundSource). Zwilling von asksRefundTip im npm-Paket.
asksTipRefundSource(KasseneckReceipt receipt, int cashRefundCents, {int? nowMs}) → bool
Fragt das Storno nach „Ja" auch „Woher kommt das Trinkgeld zurueck?" – nur, wenn das Bargeld des Stornos (cashRefundCents, siehe cancellationCashRefundCents) das offene Mitarbeiter-Trinkgeld deckt und die Mitarbeiterin wenigstens eines davon schon hatte. Bei Kartenrueckgabe geht es auf die Karte zurueck; ueber Lohn behaltenes Trinkgeld kommt immer aus der Lade. Ohne diese Frage gilt beim Server fuer refundTip: true: aus der Lade, kein „gibt die Mitarbeiterin direkt".
assertCardRefunds(List<KeckPaymentInput> payments, KasseneckReceipt? original) → void
Karten-Rueckbuchung am Storno, geprueft bevor etwas hinausgeht (Zwilling von assertCardRefunds im npm-Paket):
bookTile(Cart cart, CartItemDraft draft, {required bool bundle}) → TileBooking
Kachel in den Korb.
canCancel(ReceiptSummary receipt, RegisterScope scope, String ownUid) → bool
Darf dieser Beleg storniert werden?
cancellationCashRefundCents(KasseneckReceipt receipt, List<KeckPaymentInput>? payments, int dueCents) → int
Was dieses Storno bar zurueckgibt (positiv, Cent): mit Rueckzahlungen deren Barteil; ohne (der Server spiegelt die eine Zahlung des Originals) alles, wenn das Original bar bezahlt war. Bei mehr als einer Zahlung ohne Angabe 0: welcher Teil bar zurueckgeht, ist dann offen (ein Teilstorno verlangt ohnehin payments). Beide Kassen schicken bei mehr als einer Zahlung darum immer die Rueckzahlungen mit und rechnen hier mit ihnen.
cancellationErrorMessage(String? code) → String
Der Satz zu einem code eines Stornos: zuerst die Rueckgabe als Gutschein (refundAs: 'voucher'), dann eine Code-Regel mit Storno-Satz (Schluessel cancellation.* in errorCodeRules, seit npm 1.38.0 der Zahlungsbeleg), dann die Storno-Zahlungen, sonst der allgemeine Storno-Satz. Zwilling von cancellationErrorMessage im npm-Paket.
cancellationItemsForTip(KasseneckReceipt receipt, List<CancellationItem>? items, {required bool refundTip, int? nowMs}) → List<CancellationItem>?
Die Positionen, die nach der Antwort auf „Trinkgeld auch zurueckgeben?" hinausgehen – dieselbe Regel wie im Backend. items null = ganzer Beleg. Ja: zum Teilstorno kommt das offene Trinkgeld dazu, der ganze Beleg bleibt null. Nein: ohne das Mitarbeiter-Trinkgeld; der ganze Beleg wird zur Liste aller Restmengen ausser dem Trinkgeld (leer = nichts mehr zu stornieren). Ist kein Mitarbeiter-Trinkgeld mehr offen (keines oder schon storniert), bleibt der Wunsch, wie er ist – „Nein" wirkt dann wie keine Wahl (R61).
cancellationPaymentErrorMessage(String? code) → String
Der Satz zu einem code des Backends beim Storno mit mehreren Zahlungen. Einen unbekannten Code faengt der allgemeine Storno-Satz auf.
cardRefundReference(KasseneckReceipt receipt, String paymentId) → String
Kennung der Originalzahlung fuer die Rueckbuchung am Terminal (Hobex originalTransactionId, SumUp-Transaktion …): providerPaymentId der Zahlung paymentId des Originals. Die bekommt nur der Betrieb selbst (API-Schluessel oder Kassen-Anmeldung, beide Kanaele, seit dem Backend vom 30.10.2026), nie ein Partner-Zugang; fehlt sie, wirft dieser Aufruf, statt null an ein Terminal weiterzugeben. Zwilling von cardRefundReference im npm-Paket.
cashMovementLayout(CashMovementReceipt receipt, {PosPaperSize paperSize = PosPaperSize.mm58}) → ReceiptLayout
Bon einer Kassenbewegung (Einzahlung, Auszahlung, Umbuchung). Wirft (KasseneckValidationError, kind: request), wenn die Bon-Daten keine Kassenbewegung sind.
cashPayment(CheckoutTotals invoice, {int? amountCents}) → KeckPaymentInput
Die Barzahlung aus der Kassierrechnung als Eintrag fuer payments -- mit tenderedCents, damit das Backend Gegeben und Rueckgeld am Beleg fuehrt und der Bon sie zeigt.
checkDiscountPresets(Object? list) → DiscountPresetsCheck
Prueft die Liste der Vorlagen vor dem Schreiben, mit denselben Regeln wie der Server: hoechstens 5, Name 1 bis 24 Zeichen nach dem Trimmen ohne Steuerzeichen, eindeutig ohne Ruecksicht auf Gross und Klein, Art percent/amount mit genau dem passenden Wertfeld (Prozent 0,1 bis 100 in Schritten von 0,1, Betrag 0,01 bis 1.000.000 €). Der Server antwortet bei einem Fehler mit invalidDiscountPreset. Zwilling von checkDiscountPresets.
checkExternalVoucherArticle(Map<String, Object?> article) → String?
Regeln am wirksamen Artikelstand (Bestand + Aenderung) in /v3-Form (externalVoucher, unitPriceCents, vatRate, askPrice, serviceVoucher, addOns, stockTracked, reference, askQuantity, deposits; PosArticle.toJson liefert diese Form). null = passt, sonst ein Wert aus externalVoucherArticleReasons. Ohne externalVoucher gilt keine Regel.
checkExternalVoucherNumber(Object? text) → ExternalVoucherNumberCheck
Prueft eine Fremdnummer in der Reihenfolge des Servers (gutschein-beleg.pruefeFremd): zuerst, ob sie ein gueltiger eigener Gutscheincode ist (12 Zeichen mit Pruefzeichen, in jeder Schreibweise der Kasse, auch mit ., _ oder / als Trenner) -- dann external_voucher_number_is_own_code, der Gutschein gehoert als eigener eingeloest --, danach die Form (external_voucher_number_invalid). Die Trenner liest nur die Pruefung als -; die Nummer behaelt ihre Schreibweise. Zwilling von checkExternalVoucherNumber im npm-Paket.
checkExternalVoucherValue(Object? value) → String?
Form des Werts beim Speichern: null heisst entfernen und ist gueltig. Zwilling von checkExternalVoucherValue (Backend pruefeWert).
checkoutTotals(Cart cart, PosBusinessSettings business, CheckoutState state, {DepositPreviewContext? deposit}) → CheckoutTotals
Die ganze Rechnung des Kassierens — Zwilling von kassierenRechnung der Browser-Kasse.
checkReference(String? input, PosReference? reference) → ReferenceCheck
Prueft die Eingabe an der Kasse. Ein ungueltiges Muster gilt wie keines.
checkVoucher(RegisterTransport transport, String code) → Future<VoucherCheck>
Gutschein am Code pruefen (Gutschein-Recht voucherRedeem). Der Code wird tolerant eingelesen (Gross/klein, Bindestriche, Leerzeichen, O/0, I/L/1) und vor dem Senden auf sein Pruefzeichen geprueft: ein Tippfehler geht nie ueber das Netz, sondern endet mit KasseneckValidationError. Fachliche Fehler kommen als KasseneckApiError mit dem Code des Servers (voucher_not_found, too_many_voucher_checks, not_permitted …). Gesendet wird die Normalform; kein Text dieses Aufrufs nennt den Code.
cleanReferenceText(String text) → String
Eingabe an der Kasse: ohne Steuer- und Formatzeichen, Leerraum zusammengezogen und getrimmt (ohne NFC, wie im JS-Zwilling).
colorFromHsv(double hue, double saturation, double value) → PosColor
Aus Farbton, Sättigung und Helligkeit (HSV) eine Farbe.
completionCheck({required KeckPaymentMethod paymentMethod, required int dueCents, required int? tenderedCents, required bool changeEnabled, required bool cartEmpty}) → CompletionCheck
Darf abgeschlossen werden? Bar mit Rückgeld-Rechnung braucht genug Gegebenes.
computeChange(int dueCents, int tenderedCents) → int
contrastRatio(PosColor a, PosColor b) → double
Kontrastverhältnis nach WCAG: 1 (gleich) bis 21 (Schwarz auf Weiß).
depFolderName(String cashregisterId, {String? from, String? to}) → String
Der Ordner auf dem Stick: DEP_<Kassen-ID>_<from>_<to> (Tage YYYY-MM-DD, wie der Export sie nennt). Ohne Anfang DEP_<id>_bis_<to>, ohne Ende DEP_<id>_ab_<from>, ohne beides DEP_<id>_alles; leer oder nur Leerraum zaehlt wie fehlend, eine leere Kassen-ID wird Kasse. Was ein Stick nicht als Namen nimmt, wird _.
depositAmountOn(DepositType type, String day) → int?
Pfandbetrag in Cent am Wiener Tag day (YYYY-MM-DD): letzter Eintrag mit from <= day, sonst null.
depositErrorMessage(String? code) → String?
Der Satz zu einem Pfand-/Leergut-code des Backends (deposit_*, invalid_deposit*); null fuer jeden anderen Code. Zwilling von depositErrorMessage im npm-Paket.
depositReturnLine(DepositType type, int quantity, {required String day, required bool smallBusiness, Map<String, int>? codes}) → KasseneckItem
Die Leergutzeile zu quantity Stueck einer Pfandart, wie withDepositLines sie fuer eine deposit_return-Eingabe baut (fuer die Korb-Vorschau). Wirft einen StateError, wenn sich keine Zeile ergibt (Menge ausserhalb 1 bis 1000, Mehrweg ohne Rueckgabesatz, Pfandart ohne Betrag am Tag, ungueltige codes, Steuersatz ausserhalb von VatRate); ob die Kasse Leergut annimmt, prueft der Aufrufer. Zwilling von depositReturnLine im npm-Paket.
depositReturnOf(RegisterUserPerms? perms) → bool
Darf der Benutzer Leergut annehmen? Ohne Schluessel gilt das Recht als erteilt (Rollenvorgabe: Kassier und Chef; ein alter Server kennt es nicht); nur ein ausdrueckliches false sperrt. Ohne Rechte (perms null): nein. Zwilling von depositReturnOf im npm-Paket.
depositsFor(PosArticle? article, ArticleGroup? group) → List<DepositEntry>
Pfandangaben, wirksam fuer einen Artikel: Artikel vor Gruppe, [] = kein Pfand, null/fehlend = wie die Gruppe. Ein Fremdgutschein-Artikel traegt nie Pfand, auch nicht von der Gruppe.
discountBlockLines(Iterable<ShiftDiscount>? discounts) → List<DiscountBlockLine>
Zeilen des Rabatte-Blocks auf Z-Bon und Zwischenbericht: je Name <Name> (n×) mit dem Abzug, ab zwei Eintraegen zusaetzlich Rabatte gesamt. Ein leerer Name heisst „Rabatt“. Ein voll stornierter Name (Betrag 0) entfaellt wie in der Liste des Servers. Ohne Rabatte leer (kein Block). Zwilling von discountBlockLines.
discountCentsFor(DiscountKind kind, num value, int total) → int?
Rabatt in Cent aus der Eingabe; außerhalb von 0 … Summe gibt es keinen.
discountChipsFromPresets(Iterable<PosDiscountPreset>? presets) → List<double>
Die Prozent-Chips, die der Server aus den Vorlagen nach discountChips spiegelt (fuer aeltere Kassen): Prozent-Vorlagen in ihrer Reihenfolge, gleiche Werte nur einmal, Betrag-Vorlagen fallen weg. Zwilling von discountChipsFromPresets.
discountPresetChipText(PosDiscountPreset preset) → String
Text auf dem Chip: Mitarbeiter-Rabatt 20 %, Stammkunde 5,00 €; ohne Namen nur der Wert (10 %). Zwilling von discountPresetChipText.
distributeDiscount(List<KasseneckItem> items, int discountCents, {String name = 'Rabatt'}) → List<KasseneckItem>
Rabatt als negative Position(en) — eine je Steuersatz, anteilig zum Bruttoumsatz dieses Satzes.
draftFromArticle(PosArticle a) → CartItemDraft?
Was aus einer Kachel im Korb wird; null, wenn die Kachel nicht buchbar ist.
durationText(num minutes) → String
Dauer für Menschen aus ganzen Minuten: unter 1 Std. „45 Min.“, unter 1 Tag „8 Std. 32 Min.“ (bei 0 Minuten nur „8 Std.“), ab 1 Tag „1 Tag 3 Std.“ bzw. „2 Tage“ (bei 0 Stunden ohne Stunden). Negatives und Unsinn zählt als 0; Bruchteile werden abgeschnitten. Gemeinsame Fälle mit dem JS-Zwilling: shift-cases.json (durationText).
externalVoucherArticleErrorMessage(String? code, [String? reason]) → String?
Der Satz zu einer Absage beim Speichern eines Artikels als fremder Gutschein: nur fuer article_external_voucher_invalid (sonst null), je reason (data.grund); ein unbekannter oder fehlender Grund bekommt den allgemeinen Satz. Zwilling von externalVoucherArticleErrorMessage im npm-Paket.
externalVoucherIsValid(KeckVoucher voucher) → bool
Ist der Fremdgutschein sendbar? Die Form wie gutschein-beleg.pruefeFremd (ohne die Freigabe des Kontos, die kennt nur der Server bzw. PosVoucherSettings.externalVouchers): Aktion sell/redeem/payout, Art VoucherType.multiPurpose/VoucherType.singlePurpose, gueltige Nummer (kein eigener Code), Betrag 1 bis 1.000.000 Cent; Einzweck mit einem Satz aus externalVoucherVatRatesBp, Mehrzweck ohne; taxedWith nur bei Einzweck-Einloesung bzw. -Auszahlung (1 bis 40 Zeichen ohne Steuerzeichen); Auszahlung mit Grund (1 bis 200 Zeichen). Felder eigener Gutscheine (Code, Sorte, Artikel, Menge, Positionen), ein Wert der Altform und Serverfelder nie. Zwilling von externalVoucherIsValid im npm-Paket.
externalVoucherTileBlock(PosArticle article, PosExternalVouchers? externalVouchers) → String?
Darf die Kachel verkaufen? null = ja (auch fuer jeden Artikel ohne PosArticle.externalVoucher), sonst ein Wert aus externalVoucherTileBlocks. Gesperrt bei Freigabe PosExternalVouchers.off (oder ohne Angabe, etwa solange die Einstellungen nicht geladen sind) und bei Einzweck ohne PosExternalVouchers.all -- dieselbe Regel, mit der der Server den Beleg abweist (external_voucher_not_enabled, external_voucher_type_not_enabled).
filterReceipts(List<ReceiptSummary> receipts, ReceiptFilter f) → List<ReceiptSummary>
findErrorRule(ErrorKind kind, {String? code, ErrorOutcome? outcome}) → ErrorRule
Die Regel fuer einen Fehler, in derselben Reihenfolge wie im Web: zuerst eine Regel aus errorCodeRules mit passender Art und passendem code, dann eine aus errorOutcomeRules mit passender Art und passendem outcome, sonst die eine Regel der Art aus errorRules.
formatEuro(int cents) → String
Betrag fuer den Schirm: „2,50 €".
formatVatRate(VatRate rate) → String
Beschriftung eines Steuersatzes, wie sie am Tresen gelesen wird.
fullReceiptIdFromNumber(String cashregisterId, String number) → String?
Aus der getippten Nummer die volle Kennung; null, wenn keine Ziffer dabei ist. Der Kassier tippt nur die Nummer — das Kassenkürzel steht ohnehin fest.
groupByDay(List<ReceiptSummary> receipts) → List<ReceiptDayGroup>
Nach Wiener Kalendertag gruppiert, neueste zuerst.
inspectionInfoLines(RegisterInspectionInfo info, {required int width, required DateTime printedAt}) → List<String>
Die Kasseninfo als Textzeilen fuer den Bondrucker: kein Belegkopf, keine Belegnummer, nicht signiert (kein Beleg). Ueberschriften in Grossschrift, Bezeichnungen in einer Spalte von 13 Zeichen, lange Werte brechen wortweise in der Wertspalte um. Zwischen den Bloecken eine Leerzeile, am Ende „Gedruckt TT.MM.JJJJ, HH:MM“ (printedAt in Wiener Zeit). Keine Zeile ist laenger als width (Zeichen je Zeile, meist 32, 42 oder 48, mindestens 24; sonst KasseneckValidationError vor dem Rechnen).
inspectionInfoRows(RegisterInspectionInfo info) → List<InspectionInfoRow>
Die Zeilen der Kasseninfo fuer den Bildschirm, in der Reihenfolge des Ausdrucks. Ueberschrift (inspection.title), die Ueberschrift vor dem Teil signature (inspection.signature) und der Absatz „So arbeitet die Kasse:“ (inspection.how_it_works, inspection.how_it_works_text) kommen aus dem Katalog.
isBookableArticle(PosArticle a) → bool
Kann die Kachel gebucht werden? Mit festem Preis immer, ohne Preis nur mit askPrice (der Betrag kommt aus dem Eingabeblatt). Zwilling von isBookableArticle in pos/artikel.ts.
isCancellationErrorCode(Object? value) → bool
Stabile Fehlercodes von cancelReceipt unter /v3 – Zwilling von CANCELLATION_ERROR_CODES in @kreiseck/kasseneck-api 1.0, in derselben Reihenfolge (siehe receipt/codes.dart). Das Backend legt sie als code neben die Meldung; sie kommen als KasseneckApiError.code an. Entscheide am Code, nie am Text. Formfehler an payments selbst melden die Codes aus paymentErrorCodes. cancellation_outcome_unknown heisst: der Storno ist moeglicherweise gebucht; nie wiederholen, sondern das Original nachlesen. Ist value ein Code aus cancellationErrorCodes? Ein Anzeigetext ist keiner, ein alter deutscher oder grosser Code aus /v1 auch nicht.
isDigitsOnlyPattern(String? pattern) → bool
Reines Ziffernmuster -> die Kasse zeigt die Zifferntastatur.
isLegacyValue0x(String field, Object? value) → bool
Ist value ein Wert der inneren Form 0.x für dieses Drahtfeld?
isManualReceiptErrorCode(Object? value) → bool
isOutcomeUnknown(Object? error) → bool
Ist der Ausgang dieses Fehlers unklar? Dann den Aufruf nicht blind wiederholen: Belege, Stornos und Zahlungen nachlesen; einen Aufruf mit idempotencyKey nur mit demselben Schluessel erneut senden; ohne Schluessel erst nachlesen (siehe ErrorOutcome). Gilt fuer jede Fehlerart; nur KasseneckApiError und KasseneckHttpError koennen unklar sein.
isPaymentErrorCode(Object? value) → bool
Die Codes, gleiche Reihenfolge wie PAYMENT_ERROR_CODES. Ist value ein Code aus paymentErrorCodes? Exakt, wie unter /v3 (klein); ein grosser Code aus /v1 ist keiner. Ein Anzeigetext auch nicht.
isPayoutCancellation(List<KeckPaymentInput> payments, KasseneckReceipt? original) → bool
Storno einer Gutschein-Auszahlung: genau eine positive Barzahlung ohne refundOf (das Geld kommt in die Lade zurueck). Alles andere bleibt Rueckzahlung mit negativem Betrag; ob der Beleg eine Auszahlung war, entscheidet der Server. Liegt das original vor und traegt es keine Auszahlung, bleibt es bei negativen Rueckzahlungen. Zwilling von istStornoAuszahlung im npm-Paket.
isPosError(Object? error, [String? code]) → bool
Kurzform für catch (e) { if (isPosError(e, 'logo_too_large')) … }.
isPosErrorCode(Object? value) → bool
isPosOptionalId(Object? value) → bool
Ist value eine gueltige optionale Kennung (Backend ladeKennung)?
isPosSumupMerchantCode(Object? value) → bool
Ist value eine SumUp-Händlernummer (Backend sumup-kasse-core.HAENDLER_MUSTER)?
isPrintJobFinished(String status) → bool
Endet die Abfrage bei diesem Stand? printed, failed, expired, unknown.
isReceiptEmailErrorCode(Object? value) → bool
Stabile Fehlercodes von sendReceiptEmail unter /v3 – Zwilling von RECEIPT_EMAIL_ERROR_CODES (siehe receipt/codes.dart). Sie kommen als KasseneckApiError.code an – entscheide am Code, nie am Text, der deutsche Satz darf sich jederzeit aendern.
isReceiptErrorCode(Object? value) → bool
Ist value ein Code aus receiptErrorCodes?
isReceiptOutputError(Object? error, [String? code]) → bool
Ohne code: traegt der Fehler ueberhaupt einen Code aus receiptOutputErrorCodes?
isReceiptOutputErrorCode(Object? value) → bool
Ist value ein Code aus receiptOutputErrorCodes?
isReceiptVisible(ReceiptSummary receipt, RegisterScope scope, String ownUid) → bool
Sieht dieser Kassier den Beleg überhaupt?
isReturnDisposition(Object? value) → bool
Ist value eine Rueckgabe-Wahl aus returnDispositions? Der innere deutsche Wert (lager, defekt, entsorgt) ist keine.
isSelectableAddOn(PosArticle a) → String?
Taugt der Artikel als Zusatz? null = ja, sonst ein Wert aus addOnBlockReasons. Im Fenster wird ohne Abfrage gebucht: Betrag, Referenz oder Menge fragen geht nicht, ein Preis muss feststehen (0 erlaubt), ein Leistungsgutschein oder fremder Gutschein liefe am Gutschein-Weg vorbei, und ein Artikel mit eigener Liste oeffnete selbst ein Fenster (eine Ebene).
isTipRefundSource(Object? value) → bool
Ist value ein Wert aus tipRefundSources?
isUsableBrandColor(PosColor color) → bool
Taugt diese Farbe als Betriebsfarbe?
isValidAddOnAt(List<KasseneckItem> items, int index) → bool
Ist Position index ein gueltiger Zusatz (Verweis nach vorne auf eine Hauptposition)? Fuer Layout und Druck-Rueckfall.
isValidReferencePattern(String? pattern) → bool
Ist das Muster erlaubt (kompilierbar, ohne gesperrte Konstrukte)?
labelText(String key, [Map<String, Object> values = const {}]) → String
Die Beschriftung zum Schluessel, Platzhalter ersetzt; wirft wie messageText.
matchReturnCode(String code, {required List<PosArticle> articles, required List<ArticleGroup> groups, required List<ReturnCode> learned, required List<DepositType> depositTypes}) → ReturnCodeMatch
Ordnet einen Scan im Leergut-Blatt einer Pfandart zu. Reihenfolge: (1) gelernter Code -> 1 Stueck; (2) gtin eines Pfandeintrags an Artikel oder Gruppe -> 1 Stueck dieser Pfandart; (3) Artikel-EAN, -Nummer oder -Code mit wirksamer Pfandliste -> jeder Eintrag mit seiner quantity (Kiste: 1 Kiste
messageAppliesTo(String key, PosSurface surface) → bool
Gilt der Satz auf dieser Seite?
messageOutcome(Object? error) → ErrorOutcome?
Der Ausgang, nach dem der Satz gewaehlt wird:
messageText(String key, [Map<String, Object> values = const {}]) → String
Der Satz zum Schluessel, Platzhalter ersetzt. Fehlt ein Wert oder ist der Schluessel unbekannt, wirft es: ein {status} am Tresen waere schlimmer.
migrateStoredReceiptJson(Map<String, dynamic> stored) → Map<String, dynamic>
Bringt einen Beleg in der gespeicherten Form von 9.x (toJson mit 0.x- Namen: uid, taxnr, logo_skala, testCashregister, testSignatur, kopfId, Layout mit regelwerk/ton; an Storno-Zeilen und in cancellations[] rueckgabe statt returnDisposition, dazu lagerStandortId, das wegfaellt) in die Form von /v3, die KasseneckReceipt.fromJson liest. Fuer lokale Ablagen, die das Update ueberleben muessen: gelesen wird migriert, verworfen wird nichts. Schon englische Schluessel bleiben, wie sie sind; ein englischer Schluessel gewinnt immer gegen seinen deutschen Vorgaenger. stored bleibt unberuehrt.
modeFor(PosTheme style) → KdMode
Welcher Modus des Design-Systems hinter einem Stil steht.
netCentsFromGross(int grossCents, num rate) → int
Netto aus Brutto, in ganzen Cent.
newIdempotencyKey() → String
Ein frischer Idempotenzschluessel fuer einen neuen Vorgang: kasse- und 32 Hex-Zeichen aus dem sicheren Zufall, dieselbe Form wie beim Zaehlen der Inventur. Fuer „Erneut senden“ nie einen neuen ziehen, sondern den alten behalten.
normalizeExternalVoucherNumber(Object? text) → String?
Nummer eines Fremdgutscheins in der Form, mit der der Server sie speichert und druckt (gutschein-core.normiereFremdnummer): Rand weg, keine Unicode-Normalisierung, Gross-/Kleinschreibung bleibt; dann 1 bis 40 Zeichen aus A-Z a-z 0-9 - _ . /. Sonst null (external_voucher_number_invalid). Einen eigenen Gutscheincode erkennt erst checkExternalVoucherNumber.
offeredPaymentMethods(PosBusinessSettings business) → List<KeckPaymentMethod>
Welche Zahlungsarten der Betrieb anbietet — nie keine (dann Bar).
openStaffTipCents(KasseneckReceipt receipt, {int? nowMs}) → int
Noch nicht storniertes Mitarbeiter-Trinkgeld in Cent. Groesser 0 heisst: das Storno fragt „Trinkgeld auch zurueckgeben?" (auch beim Teilstorno). Inhaber-Trinkgeld ist Umsatz und folgt der Ware.
operatorNames(List<ReceiptSummary> receipts) → List<String>
Bediener-Namen in der Liste, für den Filter — sortiert, ohne Doppelte.
orderAddOnLines<T>(List<T> lines, {required String idOf(T), required String? parentOf(T)}) → List<OrderedAddOnLine<T>>
Warenkorb -> Belegpositionen: Zeilen tragen die Zeilen-Id ihrer Hauptzeile (parentOf). Sortiert jeden Zusatz hinter seine Hauptzeile (stabil) und rechnet den Verweis in den Index um. Fehlt die Hauptzeile (geloescht oder vorher herausgefiltert, etwa ein Gutschein-Verkauf), bleibt die Zeile ohne Verweis an ihrem Platz.
ownVoucherCodeShape(Object? text) → String
Form-Erkennung eigener Codes fuer das Feld „Code eingeben oder scannen“ (Web-Kasse und Kassen-App gleich), ein Wert aus ownVoucherCodeShapes: valid laeuft als eigener Gutschein, checksum/length fragt die Kasse nach (external_voucher.looks_like_own_code, Knopf external_voucher.use_as_external), none geht bei Freigabe direkt in das Blatt „Fremder Gutschein“. Gelesen wie checkExternalVoucherNumber: Rand weg, ., _, / wie -, dann die Normalisierung von VoucherCode (gross, ohne Leerraum und -, O -> 0, I/L -> 1); length nur mit echten Bindestrichen. Eine Nachfrage weist nichts ab: der Server prueft die Fremdnummer selbst (external_voucher_number_is_own_code nur bei valid). Zwilling von ownVoucherCodeShape im npm-Paket.
parseAmountCents(String text) → int?
Betrag aus dem Eingabefeld in ganzen Cent — oder null.
parseCentsAllowZero(String text) → int?
Ein eingetippter Betrag in Cent, ohne Gleitkomma: '12,5' -> 1250, '0' -> 0 (anders als beim Kassieren ist 0 hier gueltig: eine leere Lade, kein Startgeld). Dezimaltrenner Komma oder Punkt mit einer oder zwei Nachkommastellen; null fuer leer, Vorzeichen, Tausendertrenner ('1.000', '1 000'), drei Nachkommastellen, Euro-Zeichen und alles ueber einer sicheren Ganzzahl. Leerraum aussen faellt weg wie bei String.prototype.trim in JS. Gemeinsame Faelle mit dem JS-Zwilling: shift-cases.json des Vertrags.
parseQuantityMilli(String text, String? unit, {QuantityRule? rule}) → int?
Eine eingetippte Menge in Tausendstel der Basiseinheit, ohne Gleitkomma: '12' → 12000, '0,25' → 250, '1.5' → 1500. Zwilling von parseQuantityMilli im JS-Paket; gemeinsame Prueffaelle in stocktake-quantity-cases.json des Vertrags.
paymentsError(List<KeckPaymentInput> payments, {required bool cancellation, bool payout = false, bool payoutCancellation = false, int? depositReturnCents}) → String?
Was an der Zahlungsliste nicht stimmt -- null, wenn die Form passt.
paymentsExpectedCents(Object? error) → int?
Der Zahlbetrag des Servers aus einem payments_sum_mismatch (details.expectedCents), sonst null. Das Paket wiederholt nie selbst mit diesem Betrag: eine Kartenzahlung ist schon belastet. Die Kasse entscheidet (Differenz nachkassieren oder erstatten) und schickt dann einen neuen Verkauf. Zwilling von paymentsExpectedCents im npm-Paket.
periodRange(ReceiptPeriod period, [DateTime? now]) → ({String from, String to})
from/to (Wiener Wanduhr, YYYY-MM-DD) für den Zeitraum.
posCartWidth(PosDeviceSettings? device) → PosCartWidth
Wirksame Breite der rechten Spalte; ohne Angabe schmal (posCartWidth).
posCustomDiscountAllowed(PosBusinessSettings? business) → bool
Darf an der Kasse ein eigener Rabatt (Betrag oder Prozent) eingetippt werden? Fehlt die Einstellung, gilt ja (Zwilling von posCustomDiscountAllowed).
posDiscountPresets(PosBusinessSettings? business) → List<PosDiscountPreset>
Wirksame Vorlagen: die gespeicherten (auch leer), sonst die Prozent-Chips als namenlose Prozent-Vorlagen. Zwilling von posDiscountPresets.
posErrorCode(Object? error) → String?
Der Code eines geworfenen Fehlers, wenn er in posErrorCodes steht; sonst null.
posFieldErrors(Object? error) → List<FieldError>
Die Feldfehler einer validation-Antwort (business.vatRates, device.shortcuts.cash); leer, wenn es keine sind.
posPrinterHint(PosDeviceSettings? device) → bool
Hinweis „Drucker antwortet nicht“ an den Druckknoepfen an? Fehlt die Einstellung, gilt ja (Zwilling von posPrinterHint).
posSettingsChanges(Map<String, dynamic> before, Map<String, dynamic> after) → Map<String, dynamic>
Was sich zwischen zwei Ständen eines Teils (toJson von Betrieb oder Gerät) geändert hat, als Nutzlast für saveBusiness bzw. saveDevice: nur geänderte Felder (der Server mischt; ein nicht geänderter, hier unbekannter Wert geht so nie verloren). vatRates geht bei einer Änderung als ganze Karte (Nachtrag §11.7.2), shortcuts ebenfalls ganz, aber nur mit den Aktionen, die dieses Paket kennt: so sieht die Doppelbelegungsprüfung die ganze Belegung, und eine unbekannte Aktion bleibt am Server stehen. tipSteps geht nur mit den geänderten Einträgen. Zwilling von posSettingsChanges.
posShortcutConflict(Map<String, Object?> shortcuts) → ({String action, String heldBy, String key})?
Die erste Doppelbelegung einer Tastenkarte oder null. Geprüft wird die ganze Karte, so wie der Server sie nach dem Speichern hält. Zwilling von posShortcutConflict.
posTipCardKeptByDefault(PosBusinessSettings? business) → bool
Kartentrinkgeld „gleich behalten“ (bar aus der Lade) vorbelegt? Fehlt die Einstellung, gilt aus (Zwilling von posTipCardKeptByDefault).
posTipCardKeptMode(PosBusinessSettings? business) → PosTipKeptMode
Wirksame Stufe fuer Kartentrinkgeld: die gespeicherte, sonst PosTipKeptMode.ask (fehlt, unbekannt, Altwert); Zwilling von posTipCardKeptMode.
posTipKeptByDefault(PosBusinessSettings? business) → bool
Bar-Trinkgeld „gleich behalten“ vorbelegt? Fehlt die Einstellung, gilt aus (Zwilling von posTipKeptByDefault).
posTipKeptMode(PosBusinessSettings? business) → PosTipKeptMode
Wirksame Stufe „Trinkgeld gleich behalten“: die gespeicherte, sonst PosTipKeptMode.ask (fehlt, unbekannt, Altwert); Zwilling von posTipKeptMode.
posTipKinds(PosBusinessSettings? business) → List<PosTipKind>
Wirksame Trinkgeld-Arten: die gespeicherten, sonst alle drei (Zwilling von posTipKinds).
posTipSelfPayout(PosBusinessSettings? business) → bool
Zahlen sich Mitarbeiter ihr Trinkgeld selbst aus (Not-Aus)? Fehlt die Einstellung, gilt ja (Zwilling von posTipSelfPayout).
posTipStart(PosBusinessSettings? business) → PosTipKind
Wirksame Start-Art: die gespeicherte, wenn sie angeboten wird, sonst Prozent (oder die erste angebotene Art); Zwilling von posTipStart.
printerCatalogEntry(String? model) → PrinterCatalogEntry?
Der freigegebene Katalogeintrag zu einem Modellnamen, wie Connect ihn meldet (mDNS, GS I), oder null fuer ein unbekanntes Modell. Gross- und Kleinschreibung, ein vorangestelltes EPSON und die Art der Trenner zaehlen nicht. Zwilling von printerCatalogEntry.
printerCatalogSettings(PrinterCatalogEntry entry) → PrinterCatalogSettings
Was ein Eintrag beim Einrichten vorschlaegt; drawerKick wird zu drawerEnabled. Zwilling von printerCatalogSettings.
quantityDefaults(PosArticle a) → QuantityDefaults
Wirksame Regel eines Artikels: die gespeicherte Angabe schlägt die Vorgabe der Einheit.
quantityRuleForUnit(String? unit) → QuantityDefaults
Vorgabe je Einheit — was der Betrieb bei einem neuen Artikel bekommt und ändern darf.
quickAmounts(int dueCents) → List<int>
Schnellwahl für „Gegeben": passend, der nächste runde Euro, dann Scheine.
rasterRowsBase64() → String
Die Rasterzeilen eines Logos als Base64 (1 Bit je Punkt, links das höchste Bit, Zeilen auf ganze Bytes aufgefüllt), Zwilling von rasterRowsBase64.
readableOn(PosColor background, {PosColor light = const PosColor(0xFF, 0xFF, 0xFF), PosColor dark = const PosColor(0x0F, 0x17, 0x2A)}) → PosColor
Die besser lesbare von zwei Farben auf background.
receiptEmailErrorMessage(String? code) → String
Der Satz zu einem code des Backends beim Senden eines Belegs per E-Mail. Einen unbekannten Code faengt der allgemeine Satz auf.
receiptIsTest({required bool testCashregister, String? qr}) → bool
Beides zusammen — so entscheidet die Anzeige.
receiptItems(Cart cart, int discount) → List<KasseneckItem>
Positionen für den Beleg: Korb plus Rabattzeilen (eine je Steuersatz).
receiptNumber(String receiptId) → String
Die Nummer aus einer vollen Beleg-Kennung — für die Anzeige „ID 809". Passt sie nicht auf das Muster, steht die Kennung selbst da; eine erfundene Nummer wäre schlimmer als eine lange.
receiptOutputErrorCode(Object? error) → String?
Der Code eines geworfenen Fehlers, wenn er in receiptOutputErrorCodes steht; sonst null.
receiptOutputFieldErrors(Object? error) → List<FieldError>
Die Feldfehler einer validation-Antwort von logReceiptOutputs; leer, wenn es keine sind.
receiptOutputLabel(ReceiptOutput output) → String?
Die Beschriftung der Art einer Ausgabe (Belegdetail, Zeile „Ausgaben“), nie eine Ausnahme: null bei einer Art, die dieses Paket nicht kennt (neuerer Server); opened ohne gueltige Anzahl (ganze Zahl ab 1) zaehlt als ein Abruf. Nur die Art: „fehlgeschlagen“ (receipt.output_failed) setzt die Kasse selbst dazu, wenn result failed ist. Zwilling von receiptOutputLabel im npm-Paket.
receiptTime(String timestamp) → String
Uhrzeit eines Belegs in Wiener Wanduhrzeit (HH:MM).
receiptTypeLabel(ReceiptSummary receipt) → String
Lesbarer Name der Belegart — nie ein Rohwert.
referenceLineName(String articleName, String? value) → String
Positionsname am Beleg: Artikelname + Leerzeichen + Referenz (leer = nur der Name).
remainingQuantities(KasseneckReceipt receipt, {int? nowMs}) → List<int>
Restmenge je Position: Belegmenge minus alles, was storniert oder frisch reserviert ist; nie unter null.
reprintVoucherLabel(RegisterTransport transport, String id) → Future<String>
Etikett eines Gutscheins noch einmal drucken (Gutschein-Recht voucherManage). Liefert den Klartext-Code zum Drucken; er gehoert nur in den Speicher bis zum Druck. Aufrufer duerfen ihn nicht protokollieren, speichern oder in Meldungen nennen; Lesefehler dieser Antwort nennen ihn nie.
roundUpSuggestions(int amountCents) → List<int>
Drei Gesamtbetraege (Cent) zum Aufrunden von amountCents; bei einem Betrag <= 0 keine.
searchTiles(List<TileCategory> categories, String text) → List<PosArticle>
Suche über alle sichtbaren Kacheln (Name, ohne Groß/Klein, Teilwort).
shiftReceiptLayout(ShiftSummaryReceipt receipt, {PosPaperSize paperSize = PosPaperSize.mm58}) → ReceiptLayout
Z-Bon bzw. X-Bon der Schicht. Titel nach kind: „Schichtabschluss“ oder „Zwischenbericht“. Wirft (KasseneckValidationError, kind: request), wenn die Bon-Daten keine Z- oder X-Bon-Daten sind. paperSize ist die Breite des Bauplans (Vorgabe mm58); die Druckbreite waehlt der Druckweg.
shiftTipLines(ShiftTipTotals tip) → List<ShiftTipLine>
Was vom Trinkgeld eines Mitarbeiters dasteht, auf dem Bon, im Kassenstand und beim Abschluss gleich (Rulings R50/R51): „verdient“ (sofort + ueber Lohn) immer, „über Lohn“, „genommen“, „selbst zurückgegeben“ (R62) und „offen“ nur, wenn nicht 0. Davor „aus früheren Schichten“ (R64, nur wenn nicht 0). Hinter „genommen“ steht „davon Kartentrinkgeld“ (bar aus der Lade genommen; Spec 2026-11-11-kartentrinkgeld, nur wenn nicht 0, Teil von „genommen“, kein eigener Summand). Ist alles 0, gibt es keine Zeile, und der Mitarbeiter entfaellt ganz. Ohne openCents (Laufstand, ShiftTipTotals) zaehlt offen als 0. Gemeinsame Faelle mit dem JS-Zwilling: shift-cases.json.
signatureIsTest(String? qr) → bool
Trägt der Beleg eine Test-Signatur? Erkannt am ZDA-Kennzeichen AT100.
stockViewOf(RegisterUserPerms? perms) → bool
Darf der Benutzer Standorte und Mengen sehen? Wie im Backend (lager-core): ohne Schluessel gilt stockView als erteilt, nur ein ausdrueckliches false sperrt; alle anderen Lager-Rechte gelten ohne Schluessel als verweigert. Ohne Rechte (perms null) nichts.
storedLayoutJson(Object? stored) → Map<String, dynamic>?
Ein gespeichertes Zeilenmodell (layout) in der Form von /v3, wie ReceiptLayout.fromJson es liest. Zwilling von fromStoredLayout im npm-Paket: nimmt die Form von 0.x bzw. 9.x (regelwerk, Bannerzeilen mit ton belegart/warnung) und die Form 1.0 (ruleset, tone receipt_type/warning); ein unbekannter Ton geht woertlich durch. Die Schluessel werden an ihrer Stelle umbenannt, die Reihenfolge bleibt; traegt ein Objekt beide Namen, gewinnt der englische.
sumDenominations(Object? denominations) → int?
Summe einer Stueckelung in Cent, oder null, wenn sie keine ist: denominations ist keine Abbildung, ein Schluessel ist kein Euro-Wert (eurDenominations, genau so geschrieben, "500", nicht "0500"), eine Anzahl ist keine ganze Zahl von 0 bis 100 000. Dieselbe Regel wie am Server (invalid_denominations). Schluessel duerfen Text oder Zahl sein. Gemeinsame Faelle mit dem JS-Zwilling: shift-cases.json des Vertrags.
textColorOn(String hex) → String
Kontrastfarbe für Text auf voller Kachelfläche. Eine kaputte Farbe bekommt hellen Text statt eines Absturzes.
tileCategories(List<ArticleGroup> groups, List<PosArticle> articles) → List<TileCategory>
tilePrompts(PosArticle a) → TilePrompts
Zwilling von tilePrompts in pos/artikel.ts.
tipKeptFor(PosBusinessSettings? business, [bool? wanted, TipPaymentKind method = TipPaymentKind.cash]) → TipKeptDecision
Die eine Regel fuer Web-Kasse und Kassen-App beim Trinkgeld: PosTipKeptMode.ask zeigt den Schalter, gewaehlt ist wanted (die Wahl am Schalter), sonst die Vorbelegung (tipKeptByDefault bzw. bei Karte tipCardKeptByDefault); always bzw. never zeigen keinen Schalter und behalten gleich bzw. lassen offen, eine Schalterwahl zaehlt dann nicht. kept geht als KeckTip.keptByEmployee an den Beleg (der Server erzwingt die Stufe dort nicht). method waehlt die Stufe der Zahlart: ohne Angabe bar wie bisher, TipPaymentKind.card die Karten-Stufe (Spec 2026-11-11-kartentrinkgeld, § 4.1) -- „gleich behalten“ heisst bei Karte: bar aus der Lade nehmen. Zwilling von tipKeptFor.
tipStatus(TipPaymentKind method, bool kept) → TipStatus
Die eine Zeile beim Kassieren und auf der Fertig-Seite (Spec 2026-11-11-kartentrinkgeld, § 4.4): sie sagt, was mit dem Mitarbeiter-Trinkgeld wirklich geschieht -- nicht die Stufe, sondern das Ergebnis von tipKeptFor (und bei Karte der Deckung durch das Soll, F1). Bar: „{amount} gleich einstecken“ / „{amount} in der Lade lassen“, Karte: „{amount} aus der Lade nehmen“ / „{amount} später auszahlen“. Den Text liefert labelText(key, {'amount': …}). Zwilling von tipStatus.
unknownPosSettingValues(PosSettings settings) → List<String>
Die Felder, deren Wert dieses Paket nicht kennt, als Pfade (business.theme, device.shortcuts.<aktion>). Die Oberfläche zeigt sie als „vom Server, hier nicht einstellbar"; sie bleiben erhalten, solange nur geänderte Felder geschrieben werden (posSettingsChanges). Zwilling von unknownPosSettingValues.
untangleShortcuts(Map<String, Object?> mixed, Map<String, Object?> stored) → Map<String, Object?>
Zwilling von untangleShortcuts (Backend, npm stored): Aktionen aus stored behalten ihre Tasten; jede andere Aktion verliert eine Taste, die eine gespeicherte Aktion beansprucht, außer die beiden dürfen sie teilen (posShortcutSharedPairs).
vatCentsFromGross(int grossCents, num rate) → int
Enthaltene MwSt aus Brutto, in ganzen Cent — die Differenz zum Netto.
vatRateFor(num rate) → VatRate?
Der RKSV-Steuersatz zu einer Prozentzahl — oder null bei Unbekanntem.
vatTotalCents(Cart cart, {int discountCents = 0}) → int
Enthaltene MwSt des Warenkorbs — wie sie auf dem Beleg stehen wird.
vatTotalCentsOfItems(List<KasseneckItem> items) → int
Enthaltene MwSt einer Belegpositionsliste — je Steuersatz gruppiert, dann einmal zerlegt. Fuer Aufrufer, die die Positionen schon haben (Storno, Nachdruck), und die gemeinsame Rechnung hinter vatTotalCents.
viennaDate(DateTime instant) → String
Der Wiener Kalendertag eines Zeitpunkts als YYYY-MM-DD.
viennaDay(int nowMs) → String
Wiener Kalendertag YYYY-MM-DD zum Zeitpunkt nowMs (Millisekunden seit 1970 UTC; nie der UTC-Tag).
voucherErrorMessage(String? code) → String?
Der Satz zu einem Gutschein-code des Backends (/v3); null fuer jeden anderen Code, der dann den allgemeinen Weg des Aufrufs geht. Wie beim E-Mail-Versand entscheiden beide Kassen am Code, nie am Wortlaut.
voucherPermsOf(RegisterUserPerms? perms) → VoucherPerms
Gutschein-Rechte lesen. Das Backend loest sie bei der Anmeldung auf; ein alter Server kennt sie nicht. Dann gilt je fehlendem Schluessel die Vorgabe des Kassiers: verkaufen und einloesen ja, verwalten nein. Ein ausdrueckliches false sperrt (beim Lesen wird jeder Wert ausser true zu false). Zwilling von voucherPermsOf im npm-Paket; ohne Rechte (perms null) gilt wie dort die Vorgabe.
withDepositLines(List<Object?> items, DepositPreviewInput input) → DepositPreviewResult
Pfand- und Leergutzeilen eines Belegs wie der Server: leitet Pfand zu Artikeln ab (auto), prueft ausdrueckliche deposit-Zeilen und deposit_return-Zeilen und rechnet addOnOf und depositFor auf die neuen Positionen um. Ohne Pfand-/Leergutzeile und ohne Ableitung kommen die Positionen unveraendert zurueck. Die Fehlercodes sind die von createReceipt.

Typedefs

CancellationItem = ({int index, int quantity})
Eine Position, die storniert werden soll.
OrderedAddOnLine<T> = ({int? addOnOf, T line})
Eine Zeile nach orderAddOnLines: die Zeile und der Index ihrer Hauptzeile.
ReferenceCheck = ({ReferenceCheckResult result, String value})
Pruefung einer Eingabe mit dem gesaeuberten Wert.
ShiftReceiptData = ShiftSummaryReceipt
Bon-Daten des Z- oder X-Bons unter dem Namen der Aufgabe (Zwilling: ShiftSummaryReceipt).
ShiftReceiptTip = ShiftTip
Trinkgeld auf dem Z- und X-Bon: offen = Anspruch beim Abschluss bzw. jetzt.
TilePrompts = ({bool amount, bool quantity, bool reference})
Was die Kachel beim Antippen abfragt (Betrag, Referenz, Menge).
TipKeptDecision = ({bool kept, bool showSwitch})
Ergebnis von tipKeptFor: zeigt die Kasse den Schalter, und wird das Trinkgeld gleich behalten?
TipStatus = ({String key, TipStatusKind status})
Ergebnis von tipStatus: TipStatusKind.kept = gleich behalten, TipStatusKind.open = offen; key die Zeile aus dem Katalog mit {amount}. Zwilling von TipStatus.

Exceptions / Errors

DepExportFailedException
Der Export ist fehlgeschlagen (error: export_failed, export_stalled oder ein Code des Exports); ein neuer Export mit neuer requestId ist moeglich.
DepExportTimeoutException
KasseneckApi.waitForDepExport gab auf, bevor der Export fertig war. Der Export laeuft serverseitig weiter; getDepExport(exportId) fragt ihn spaeter noch einmal ab.
KasseneckReceiptFormatError
Ein Beleg kam an, liess sich aber nicht lesen — ein Pflichtfeld fehlt oder hat den falschen Typ.