Organisation, Standorte, Team
Wie Freika dein Unternehmen abbildet.
Organisation
Die Organisation ist die oberste Einheit: ein Unternehmen mit einer Auszahlung und einem Vertrag. Sie enthält Standorte, Terminals, Zahlungen, Zahlungslinks, Auszahlungen, API-Schlüssel und Webhooks. Eine Person kann Mitglied mehrerer Organisationen sein.
Standorte
Ein Standort ist ein Ort, an dem du kassierst: ein Laden, ein Restaurant, ein Marktstand, ein Automat. Standorte tragen den Belegkopf (Name, Adresse, MWST-Nummer) und gruppieren Terminals und Mitarbeitende. In Berichten filterst du nach Standort.
curl https://api.freika.com/v1/locations \
-H "Authorization: Bearer $FREIKA_API_KEY" \
-d name="Filiale Wattwil" \
-d street="Bahnhofstrasse 1" -d zip=9630 -d city=WattwilRollen im Team
| Rolle | Darf |
|---|---|
| Inhaberin, Inhaber | Alles, auch Auszahlungskonto ändern und Organisation löschen |
| Admin | Alles ausser Auszahlungskonto und Löschung |
| Entwicklerin, Entwickler | API-Schlüssel, Webhooks, Sandbox; Zahlungen lesen |
| Buchhaltung | Zahlungen, Auszahlungen und Exporte lesen |
| Mitarbeitende | Zahlungen am eigenen Standort sehen, Rückerstattungen bis zu einem Limit |
Rollen und Einladungen verwaltest du unter Einstellungen → Team.
Umgebungen
Jede Organisation hat eine Sandbox und eine Live-Umgebung. Alle Objekte tragen das Feld environment. Live-Schlüssel funktionieren erst nach der Freischaltung durch unseren Partner wallee, die du im Dashboard anstösst.