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 voncloseMyShift. - 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 (
autoLogoutinlistMyCashregisters). 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 istnull, 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
- DepDownloadLink
-
Der Lese-Link einer grossen Datei (
getDepExportFilemitdownload). - DepExport
-
Ein Export, wie ihn
createDepExport(nur Kennung, Status, Zeitraum) undgetDepExportliefern. Felder, die der Server erst nach dem Lauf kennt, sind vorhernull. - DepExportFile
- Eine heruntergeladene Datei eines Exports.
- DepExportItems
- Die Positionsdatei eines Exports.
- DepFindings
-
Befund eines Exports (
findings): was an der Belegkette auffaellt. - DepHandoverLink
- 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
getDepExportaufzaehlt. Code und Adresse kennt nur die Antwort voncreateDepHandoverLink. - DepHandoverRevocation
-
Antwort von
revokeDepHandoverLink. - DepositAmount
-
Ein Pfandbetrag ab einem Tag (
from, Wiener TagYYYY-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
depositausgetKasseSettings; fehlt bei ausgeschaltetem Pfand. - 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
cashViewzeigt. - 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[]einervalidation-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
ReceiptPaymentin@kreiseck/kasseneck-api(models/receipt-payment.ts) und der Eintraege, diefunctions/gemeinsam/zahlungen-core.jsunterpaymentsablegt. - KeckPaymentInput
-
Eine Zahlung, wie der Aufrufer sie an
sellReceipt/sell/cancelschickt – Zwilling vonReceiptPaymentInput.idundchangeCentsvergibt 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 vonVoucherim 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 vonPosDiscountPreset. - 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
vouchersausgetKasseSettings). - 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 genauamount.cents); Art, Satz, Gueltigkeit und Auszahlung nimmt der Server aus der Sorte und friert sie am Gutschein ein. - PrinterCatalogApproval
-
Freigabe eines Eintrags. Nur
approved: truewirkt; 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
outputseinergetReceipt-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 (receiptOutputLabelgibt dannnull). - ReceiptOutputActor
-
Wer die Ausgabe ausloeste: der Kassen-Benutzer, beim Geraet mit api_key
das Konto (
namedannnull). - 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 alsHH:MMin 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
RegistrationInfoin@kreiseck/kasseneck-api1.0, DrahtfeldregistrationInfo(frueherpruefangaben). - 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[], npmReturnIssuedVoucher). Beim ersten Mal mit Klartext-Code code; bei einer Wiederholung mit demselbenidempotencyKeyohne 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“ sindnull, wenn der Server sie nicht sendet (kein Recht);nullheisst dort „nicht gesendet“ oder „es gibt (noch) keinen Wert“ – nie0. Ohne das Rechtshiftsendet der Server von einer offenen Schicht nur die Grunddaten (id, drawerId, cashregisterId, number, status, openedAt, openedBy); alles andere ist dannnull, 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 mitshiftReceiptLayout. 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.addressnull). - 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
listStocktakeCountsbzw.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 (
sellablebzw.defective). - StocktakeItemPage
-
Eine Seite von
listStocktakeItemsbzw.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: nullheisst „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 RechtstockCostsdes Kassenbenutzers, in der Lager-API mit dem Konto-Schalter „Einkaufswerte per API“ (Rechtcosts). - 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_persondie Summe ueber alle Laden, otherDrawers leer. Ohne Schichtbetrieb der Lade immer 0 (kein Anspruch). Zwilling vonTipBalance. - 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 vonVoucherArticleim npm-Paket. - VoucherCheck
-
Stand eines Gutscheins nach dem Code-Eingeben (
checkVoucher). Felder, die zur Art nicht passen oder die der Server nicht sendet, sindnull. - 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, istnull.
Enums
- ArticleExternalVoucher
-
Art des fremden Gutscheins am Artikel (
/v3externalVoucher, gespeichertfremdgutschein; Fremdgutscheine an der Kasse, 11.22.0). Die Regeln dazu stehen infremdgutschein_artikel.dart; die Art steht hier, weilinventory.dartdiese Datei ohne Flutter einbindet und die Regeln die Gutschein-Einstellung brauchen. - CancellationState
-
Storno-Stand eines Belegs in der Liste (Drahtfeld
cancellationStatus, KatalogSTORNO_STAND):none,partial,full. Ein unbekannter kuenftiger Wert kommt als CancellationState.unknown an und nie alsnone: die Kasse bietet dann keinen Storno an (siehecanCancel), der Server haelt ohnehin die Restmengen. - CreditCardProvider
- DiscountKind
- DiscountPresetReason
-
Warum eine Vorlage abgelehnt wird; je Grund ein Satz im Katalog
(discountPresetMessages).
valueist der Drahtname (unknown_field). - ErrorKind
-
Wie ein Fehler fuer die Einordnung heisst (
kindim 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
idempotencyKeynur mit demselben Schluessel erneut senden (wirkt genau einmal, ein neuer buchte doppelt); ohne Schluessel erst nachlesen. - ErrorRuleBehavior
-
Was eine Regel ohne eigenen Satz tut (
behaviorim 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 (gespeichertart: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 vonPosExternalVouchersim 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 (
onlyim 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 mittipKeptByDefault; 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 hatbusiness.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:
emptyunderrorsperren,warningzeigt 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 vonTipPaymentKind('cash' | 'card'). - TipStatusKind
-
Was mit dem Trinkgeld dieses Verkaufs geschieht (tipStatus): gleich
behalten oder offen. Zwilling von
TipStatusKind. - VatRate
- VoucherAction
-
Gutschein-Aktion. Zwilling von
VoucherActionim 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
VoucherTypeim 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
/v3gleich. -
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(KatalogSTORNO_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(Katalogdep_nachschau). Sie kommen alsKasseneckApiError.codean; der Code eines fehlgeschlagenen Exports steht ausserdem in DepExportFailedException.error. - depExportFailed → const String
-
depExportFiles
→ const Set<
String> -
Die Dateien eines Exports (
filevongetDepExportFile): das DEP (JSON), das Protokoll (PDF), die Positionen (CSV) und das ZIP mit allem. - depExportRunning → const String
-
Werte von
statuseines 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 voncreateReceipt). -
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:
interimje Zaehlung,closingder 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 inexternalVoucherTileMessages). -
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 mitrenames-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):
notebeiother_in/other_out,recipientIdbeitip_payout,targetDrawerIdbeitransfer_out.locationbeichange_in/cash_dropist freiwillig. -
manualOpeningReasons
→ const List<
String> -
Die Gruende des Knopfs „Lade“;
otherbraucht einen Text (note). -
manualReceiptErrorCodes
→ const List<
String> -
Fehlercodes von
createReceiptzur Nacherfassung (VertragerrorCodes.manualReceipt).manual_receipt_duplicatetraegt indetails.receiptIdden 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_differenceundinterim_difference(Differenz einer Zwischenzaehlung) vergibt nur der Server. -
openingReasons
→ const List<
String> -
Warum die Lade aufging (Katalog
LADE_OEFFNUNG_GRUND).sale,cash_movement,shift_openundshift_closemeldet die Kasse selbst beim jeweiligen Vorgang (voucher_payoutbei 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= Muster4-4-xmit echten Bindestrichen-(nie.,_,/), aber nicht 12 Zeichen;none= keine Aehnlichkeit. Zwilling vonOWN_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.tipKindsist eine Liste,tipStart,tipKeptModeundtipCardKeptModeje 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 odernull(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 odernull(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 nimmttrue,falseodernull(entfernen); fehltprinterHint, 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.posErrorCodesim 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 Paketcoderoute_missing.validationträgtdetails.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 vonPOS_SHORTCUT_ACTIONS. -
posShortcutDefaults
→ const Map<
String, List< String> > -
Tastenbelegung: Aktion -> Tasten (
Mod+F,Enter,Escape,F5...;Mod= Cmd auf dem Mac, Strg sonst). Zwilling vonPOS_SHORTCUT_DEFAULTS. -
Aktionen, die sich eine Taste teilen dürfen (Backend
TASTEN_PAARE), Zwilling vonPOS_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(KatalogDRUCK_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(KatalogMENGENREGEL). -
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[].codeeiner Antwort vonlogReceiptOutputs: der Eintrag ist dauerhaft abgelehnt (aus dem Puffer nehmen, nicht noch einmal senden).validationheisst hier: ein Druck ohne oder mit unbekanntem Ergebnis. -
receiptOutputKinds
→ const List<
String> -
Arten einer Ausgabe des Belegs (Katalog
AUSGABE_ART):printErstdruck,reprintDuplikat,emailBelegmail,link_sharedLink geteilt,pdf_sharedPDF geteilt,openedvom Kunden geoeffnet (Abrufe je Stunde). Zwilling vonRECEIPT_OUTPUT_KINDS. -
receiptOutputLogKinds
→ const List<
String> -
Die Arten, die eine Kasse selbst meldet (
RECEIPT_OUTPUT_LOG_KINDS).emailundopenedschreibt 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 immerok. Zwilling vonRECEIPT_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 incounting;reviewrechnet Soll und Differenz (erst ab hier sichtbar, blind);closingbucht den Abschluss in Teilen;closedundcancelledsind endgueltig.creatingsteht 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 vonTIP_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 anpaymentsstehen inpaymentErrorCodes).final -
externalVouchers
→ List<
String> -
Die Freigaben fuer Fremdgutscheine (Drahtwerte, wie
externalVouchersim Vertrag).final -
paymentErrorCodes
→ List<
String> -
Codes rund um
paymentsancreateReceiptundcancelReceipt.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
createReceiptundgetReceipt(ohne die Zahlungscodes, die stehen inpaymentErrorCodes).receipt_outcome_unknownheisst: der Beleg ist moeglicherweise signiert, nachlesen statt wiederholen (mitidempotencyKey: dieselbe Anfrage mit demselben Schluessel erneut senden).final -
receiptOutputErrorCodes
→ List<
String> -
Codes von
logReceiptOutputs, wenn die ganze Anfrage scheitert (VokabularerrorCodes.registerHandlersByEndpoint.logReceiptOutputs), dahinter Anmeldung und Rand, zuletztroute_missing. Zwilling vonRECEIPT_OUTPUT_ERROR_CODES.final -
voucherAmountModes
→ List<
String> -
Die Betragsarten einer Sorte (Drahtwerte, wie
voucherAmountModesim Vertrag).final -
voucherKinds
→ List<
String> -
Die Arten, die
checkVoucherliefert (Drahtwerte, wievoucherKindsim Vertragsurface.json).final -
voucherPayouts
→ List<
String> -
Die Auszahlungswerte (Drahtwerte, wie
voucherPayoutsim Vertrag).final -
voucherStatuses
→ List<
String> -
Die Staende, die
checkVoucherliefert (Drahtwerte, wievoucherStatusesim Vertrag).final -
voucherTypeKinds
→ List<
String> -
Die Arten einer Gutschein-Sorte (Drahtwerte, wie
voucherTypeKindsim Vertrag): nur Wertgutscheine, Leistung und Aktion sind keine Sorte.final -
voucherTypeValidityPatterns
→ List<
String> -
Die Gueltigkeitsmuster einer Sorte (Drahtwerte, wie
voucherTypeValidityPatternsim 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: falsemittip_keep_not_possible_with_voucherab), die Kasse zeigtcancellation.tip_refunded_with_voucherund sendetrefundTip: true. Die Frage nach der Quelle bleibt (asksTipRefundSource). Zwilling vonasksRefundTipim 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 fuerrefundTip: 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
assertCardRefundsim 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
codeeines Stornos: zuerst die Rueckgabe als Gutschein (refundAs: 'voucher'), dann eine Code-Regel mit Storno-Satz (Schluesselcancellation.*in errorCodeRules, seit npm 1.38.0 der Zahlungsbeleg), dann die Storno-Zahlungen, sonst der allgemeine Storno-Satz. Zwilling voncancellationErrorMessageim 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.
itemsnull= ganzer Beleg. Ja: zum Teilstorno kommt das offene Trinkgeld dazu, der ganze Beleg bleibtnull. 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
codedes 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 …):providerPaymentIdder ZahlungpaymentIddes 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, stattnullan ein Terminal weiterzugeben. Zwilling voncardRefundReferenceim 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-- mittenderedCents, 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/amountmit 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 voncheckDiscountPresets. -
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. OhneexternalVouchergilt 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) -- dannexternal_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 voncheckExternalVoucherNumberim npm-Paket. -
checkExternalVoucherValue(
Object? value) → String? -
Form des Werts beim Speichern:
nullheisst entfernen und ist gueltig. Zwilling voncheckExternalVoucherValue(BackendpruefeWert). -
checkoutTotals(
Cart cart, PosBusinessSettings business, CheckoutState state, {DepositPreviewContext? deposit}) → CheckoutTotals -
Die ganze Rechnung des Kassierens — Zwilling von
kassierenRechnungder 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>(TageYYYY-MM-DD, wie der Export sie nennt). Ohne AnfangDEP_<id>_bis_<to>, ohne EndeDEP_<id>_ab_<from>, ohne beidesDEP_<id>_alles; leer oder nur Leerraum zaehlt wie fehlend, eine leere Kassen-ID wirdKasse. 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 mitfrom <= day, sonstnull. -
depositErrorMessage(
String? code) → String? -
Der Satz zu einem Pfand-/Leergut-
codedes Backends (deposit_*,invalid_deposit*);nullfuer jeden anderen Code. Zwilling vondepositErrorMessageim npm-Paket. -
depositReturnLine(
DepositType type, int quantity, {required String day, required bool smallBusiness, Map< String, int> ? codes}) → KasseneckItem -
Die Leergutzeile zu
quantityStueck einer Pfandart, wie withDepositLines sie fuer einedeposit_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, ungueltigecodes, Steuersatz ausserhalb von VatRate); ob die Kasse Leergut annimmt, prueft der Aufrufer. Zwilling vondepositReturnLineim 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
falsesperrt. Ohne Rechte (permsnull): nein. Zwilling vondepositReturnOfim 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 zusaetzlichRabatte 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 vondiscountBlockLines. -
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
discountChipsspiegelt (fuer aeltere Kassen): Prozent-Vorlagen in ihrer Reihenfolge, gleiche Werte nur einmal, Betrag-Vorlagen fallen weg. Zwilling vondiscountChipsFromPresets. -
discountPresetChipText(
PosDiscountPreset preset) → String -
Text auf dem Chip:
Mitarbeiter-Rabatt 20 %,Stammkunde 5,00 €; ohne Namen nur der Wert (10 %). Zwilling vondiscountPresetChipText. -
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(sonstnull), jereason(data.grund); ein unbekannter oder fehlender Grund bekommt den allgemeinen Satz. Zwilling vonexternalVoucherArticleErrorMessageim 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): Aktionsell/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;taxedWithnur 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 vonexternalVoucherIsValidim 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 passendemoutcome, 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“ (
printedAtin Wiener Zeit). Keine Zeile ist laenger alswidth(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 Teilsignature(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 vonisBookableArticleinpos/artikel.ts. -
isCancellationErrorCode(
Object? value) → bool -
Stabile Fehlercodes von
cancelReceiptunter/v3– Zwilling vonCANCELLATION_ERROR_CODESin@kreiseck/kasseneck-api1.0, in derselben Reihenfolge (siehereceipt/codes.dart). Das Backend legt sie alscodeneben die Meldung; sie kommen alsKasseneckApiError.codean. Entscheide am Code, nie am Text. Formfehler anpaymentsselbst melden die Codes auspaymentErrorCodes.cancellation_outcome_unknownheisst: der Storno ist moeglicherweise gebucht; nie wiederholen, sondern das Original nachlesen. Istvalueein Code aus cancellationErrorCodes? Ein Anzeigetext ist keiner, ein alter deutscher oder grosser Code aus/v1auch nicht. -
isDigitsOnlyPattern(
String? pattern) → bool - Reines Ziffernmuster -> die Kasse zeigt die Zifferntastatur.
-
isLegacyValue0x(
String field, Object? value) → bool -
Ist
valueein 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
idempotencyKeynur 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. Istvalueein Code aus paymentErrorCodes? Exakt, wie unter/v3(klein); ein grosser Code aus/v1ist 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 dasoriginalvor und traegt es keine Auszahlung, bleibt es bei negativen Rueckzahlungen. Zwilling vonistStornoAuszahlungim 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
valueeine gueltige optionale Kennung (BackendladeKennung)? -
isPosSumupMerchantCode(
Object? value) → bool -
Ist
valueeine SumUp-Händlernummer (Backendsumup-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
sendReceiptEmailunter/v3– Zwilling vonRECEIPT_EMAIL_ERROR_CODES(siehereceipt/codes.dart). Sie kommen alsKasseneckApiError.codean – entscheide am Code, nie am Text, der deutsche Satz darf sich jederzeit aendern. -
isReceiptErrorCode(
Object? value) → bool -
Ist
valueein Code aus receiptErrorCodes? -
isReceiptOutputError(
Object? error, [String? code]) → bool -
Ohne
code: traegt der Fehler ueberhaupt einen Code aus receiptOutputErrorCodes? -
isReceiptOutputErrorCode(
Object? value) → bool -
Ist
valueein Code aus receiptOutputErrorCodes? -
isReceiptVisible(
ReceiptSummary receipt, RegisterScope scope, String ownUid) → bool - Sieht dieser Kassier den Beleg überhaupt?
-
isReturnDisposition(
Object? value) → bool -
Ist
valueeine 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
valueein Wert aus tipRefundSources? -
isUsableBrandColor(
PosColor color) → bool - Taugt diese Farbe als Betriebsfarbe?
-
isValidAddOnAt(
List< KasseneckItem> items, int index) → bool -
Ist Position
indexein 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)
gtineines Pfandeintrags an Artikel oder Gruppe -> 1 Stueck dieser Pfandart; (3) Artikel-EAN, -Nummer oder -Code mit wirksamer Pfandliste -> jeder Eintrag mit seinerquantity(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 (
toJsonmit 0.x- Namen:uid,taxnr,logo_skala,testCashregister,testSignatur,kopfId, Layout mitregelwerk/ton; an Storno-Zeilen und incancellations[]rueckgabestattreturnDisposition, dazulagerStandortId, 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.storedbleibt 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 ausA-Z a-z 0-9 - _ . /. Sonstnull(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:
validlaeuft als eigener Gutschein,checksum/lengthfragt die Kasse nach (external_voucher.looks_like_own_code, Knopfexternal_voucher.use_as_external),nonegeht bei Freigabe direkt in das Blatt „Fremder Gutschein“. Gelesen wie checkExternalVoucherNumber: Rand weg,.,_,/wie-, dann die Normalisierung vonVoucherCode(gross, ohne Leerraum und-, O -> 0, I/L -> 1);lengthnur mit echten Bindestrichen. Eine Nachfrage weist nichts ab: der Server prueft die Fremdnummer selbst (external_voucher_number_is_own_codenur beivalid). Zwilling vonownVoucherCodeShapeim 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;nullfuer leer, Vorzeichen, Tausendertrenner ('1.000','1 000'), drei Nachkommastellen, Euro-Zeichen und alles ueber einer sicheren Ganzzahl. Leerraum aussen faellt weg wie beiString.prototype.trimin JS. Gemeinsame Faelle mit dem JS-Zwilling:shift-cases.jsondes 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 vonparseQuantityMilliim JS-Paket; gemeinsame Prueffaelle instocktake-quantity-cases.jsondes 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), sonstnull. 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 vonpaymentsExpectedCentsim 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 (
toJsonvon Betrieb oder Gerät) geändert hat, als Nutzlast fürsaveBusinessbzw.saveDevice: nur geänderte Felder (der Server mischt; ein nicht geänderter, hier unbekannter Wert geht so nie verloren).vatRatesgeht bei einer Änderung als ganze Karte (Nachtrag §11.7.2),shortcutsebenfalls 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.tipStepsgeht nur mit den geänderten Einträgen. Zwilling vonposSettingsChanges. -
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 vonposShortcutConflict. -
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), odernullfuer ein unbekanntes Modell. Gross- und Kleinschreibung, ein vorangestelltesEPSONund die Art der Trenner zaehlen nicht. Zwilling vonprinterCatalogEntry. -
printerCatalogSettings(
PrinterCatalogEntry entry) → PrinterCatalogSettings -
Was ein Eintrag beim Einrichten vorschlaegt;
drawerKickwird zudrawerEnabled. Zwilling vonprinterCatalogSettings. -
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(
PrintLogo logo) → 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
codedes 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 vonlogReceiptOutputs; leer, wenn es keine sind. -
receiptOutputLabel(
ReceiptOutput output) → String? -
Die Beschriftung der Art einer Ausgabe (Belegdetail, Zeile „Ausgaben“), nie
eine Ausnahme:
nullbei einer Art, die dieses Paket nicht kennt (neuerer Server);openedohne gueltige Anzahl (ganze Zahl ab 1) zaehlt als ein Abruf. Nur die Art: „fehlgeschlagen“ (receipt.output_failed) setzt die Kasse selbst dazu, wennresultfailedist. Zwilling vonreceiptOutputLabelim 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.paperSizeist die Breite des Bauplans (Vorgabemm58); 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
stockViewals erteilt, nur ein ausdruecklichesfalsesperrt; alle anderen Lager-Rechte gelten ohne Schluessel als verweigert. Ohne Rechte (permsnull) nichts. -
storedLayoutJson(
Object? stored) → Map< String, dynamic> ? -
Ein gespeichertes Zeilenmodell (
layout) in der Form von/v3, wie ReceiptLayout.fromJson es liest. Zwilling vonfromStoredLayoutim npm-Paket: nimmt die Form von 0.x bzw. 9.x (regelwerk, Bannerzeilen mittonbelegart/warnung) und die Form 1.0 (ruleset,tonereceipt_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:denominationsist 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.jsondes 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
tilePromptsinpos/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 (tipKeptByDefaultbzw. bei KartetipCardKeptByDefault);alwaysbzw.neverzeigen keinen Schalter und behalten gleich bzw. lassen offen, eine Schalterwahl zaehlt dann nicht.keptgeht alsKeckTip.keptByEmployeean den Beleg (der Server erzwingt die Stufe dort nicht).methodwaehlt 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 vontipKeptFor. -
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 vontipStatus. -
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 vonunknownPosSettingValues. -
untangleShortcuts(
Map< String, Object?> mixed, Map<String, Object?> stored) → Map<String, Object?> -
Zwilling von
untangleShortcuts(Backend, npmstored): Aktionen ausstoredbehalten 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
nullbei 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-DDzum ZeitpunktnowMs(Millisekunden seit 1970 UTC; nie der UTC-Tag). -
voucherErrorMessage(
String? code) → String? -
Der Satz zu einem Gutschein-
codedes Backends (/v3);nullfuer 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
falsesperrt (beim Lesen wird jeder Wert aussertruezufalse). Zwilling vonvoucherPermsOfim npm-Paket; ohne Rechte (permsnull) 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 ausdruecklichedeposit-Zeilen unddeposit_return-Zeilen und rechnetaddOnOfunddepositForauf die neuen Positionen um. Ohne Pfand-/Leergutzeile und ohne Ableitung kommen die Positionen unveraendert zurueck. Die Fehlercodes sind die voncreateReceipt.
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;
keydie Zeile aus dem Katalog mit{amount}. Zwilling vonTipStatus.
Exceptions / Errors
- DepExportFailedException
-
Der Export ist fehlgeschlagen (error:
export_failed,export_stalledoder ein Code des Exports); ein neuer Export mit neuerrequestIdist 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.