PC Kasse

Transaktion: CAS01 PC Kasse
UI-Pfad: cashRegisterSell (Kassen-Oberfläche)

Business-Zweck

Die PC Kasse ist die operative Verkaufsoberfläche in reybex. Sie erfasst Warenkörbe als Vertriebsbelege, bucht Lagerbestände ab, nimmt Zahlungen entgegen und erzeugt optional Rechnungen oder Kassenbons. Partner binden eigene POS-Frontends an, die dieselben Abläufe über die API auslösen.

Kernbegriffe

Begriff	Bedeutung
CashRegister	Konfigurierte Kasse (Stamm aus CAS02)
SalesHead	Auftrag oder Rechnung als Warenkorb
sell	Verkaufsabschluss – Zahlung, Buchung, Druck
CashClose	Kassenschluss-Session (Start/Ende)
FinOpenItem	Offener Posten für Rechnungszahlung
Split Order	Aufteilen eines Warenkorbs in mehrere Belege

Fachlicher Ablauf / Workflow

Verkauf (sell)

1. Kasse auswählen (select oder bekannte cashRegisterId)
2. Warenkorb laden: GET /api/cashRegister/sell/{id}/{refSalesHeadId} – bei refSalesHeadId=0 neuer Beleg
3. Positionen über SalesHead API pflegen
4. Zahlung abschließen (intern im sell-Flow oder über dedizierte Zahlungsendpoints)

Rechnungszahlung (payInvoice)

1. Offene Posten laden: GET /api/cashRegister/finOpenItemsToPay
2. Zahlung buchen: POST /api/cashRegister/payInvoice mit FinOpenItem-Referenzen

Kassenschluss

1. POST /api/cashRegister/startCashClose – Kassenschluss öffnen
2. Zwischenbuchungen: POST /api/cashRegister/bookCashMove (Ein-/Auszahlungen)
3. Abschlussdaten: GET /api/cashRegister/endCashCloseData/{id}
4. POST /api/cashRegister/endCashClose – FiBu-Buchung, optional Fiskaly-Abschluss

Split Order

Beim Aufteilen eines Warenkorbs: GET /api/cashRegister/endSplitOrder schließt den Split-Vorgang ab und liefert die resultierenden Belege.

Partner-Szenarien

Szenario	Vorgehen
Eigenes POS-Frontend	CAS02 konfigurieren, dann sell/payInvoice/cashClose per API
Filial-Kasse mit FiBu-Anbindung	Kassenschluss mit endCashClose; OP-Zahlungen über payInvoice
Rechnungszahlung an der Kasse	finOpenItemsToPay + payInvoice
Storno	POST /api/cashRegister/cancelSalesHead
TSE / Fiskaly	Kasse mit fiskalyTss / fiskalyAustriaCashRegister in CAS02

Voraussetzungen

• Kasse in Kassen Verwaltung angelegt und aktiv
• Belegarten (orderDocType, invoiceDocType, deliveryDocType, cancelDocType) korrekt gesetzt
• Standard-Lager und Standard-Kunde auf der Kasse
• Zahlungsarten der Kasse mit isCashRegister-Flag
• Transaktionsrecht CAS01 für API-Benutzer

Auswirkungen im ERP

Aktion	Auswirkung
Verkauf abschließen	SalesHead (Auftrag/Rechnung), Lagerabbuchung
payInvoice	FinOpenItem-Ausgleich, FinHead-Zahlungsbuchung
Kassenschluss	FinHead-Sammelbuchung, CashClose-Datensatz
cancelSalesHead	Storno-Beleg, ggf. Bestandskorrektur
bookCashMove	Kassenbewegung im Kassenschluss

Typische Fehlerquellen

Fehler	Ursache	Lösung
cashRegister.not.found	Ungültige Kassen-ID	Kasse in CAS02 prüfen
cashRegister.endCashClose.cashClose.empty.error	Kein offener Kassenschluss	Zuerst startCashClose
Belegart-Fehler	Falsche DocType-Zuordnung	invoiceDocType muss Rechnung, orderDocType Auftrag sein
Keine Bestandsbuchung	Lager nicht gesetzt	warehouse auf CashRegister prüfen
Fiskaly-Fehler	TSE nicht konfiguriert	Fiskaly-Felder in CAS02

Weiterlesen

• Kassen Verwaltung (CAS02)

• Vertrieb – Auftrag zu Rechnung

• Finanzen – Offene Posten