Zum Inhalt springen

API

Alles, was der Webclient kann, geht über dieselbe REST-API unter /v1. Sie ist die einzige Zugriffsschicht auf die Daten; Datenbankdateien werden nie direkt gelesen.

  • Anmeldung: OAuth 2.0 / OpenID Connect. Für Dienste ein Dienstkonto je Mandant anlegen (Einstellungen → Verkaufskanäle → Dienstkonten für Bridges) und Tokens per Client-Credentials holen.
  • Schreibende Aufrufe sind idempotent: Jeder Befehl trägt eine commandId. Wird er wiederholt, etwa nach einem Netzfehler, führt Kassier ihn nicht doppelt aus, sondern liefert das erste Ergebnis.
  • Vertrag: Die OpenAPI-Beschreibung liefert jede Installation lokal unter /openapi.json und /docs auf dem Betriebsport (ERP_OPS_BIND, nur vom Server selbst erreichbar).