Überblick

Ordo ist ein ereignisbasiertes Kernsystem für Sparfinanzierungsgesellschaften. Dieses Portal richtet sich an Teams, die Integrationen gegen die Plattform bauen: Hier leben die REST-API-Referenz, die Kernkonzepte und die Umgebungsdetails. Der technische Codename der Plattform ist TFS — URLs, Paketnamen und Repository-Namen tragen ihn; das Produkt heißt Ordo.

Schnellstart

Umgebungen

Staging-Basis-URL, Versionierung und Request-Konventionen. Zu den Umgebungen

Authentifizierung

OIDC auf Keycloak: Authorization Code + PKCE und Berechtigungscodes. Authentifizierung lesen

Fehlervertrag

messageCode, severity, traceId und der dreisprachige Meldungskatalog. Fehlervertrag lesen

API-Referenz

Von Geschäftspartnern bis zur Verlosung, von Bereitstellungen bis zum Tagesabschluss. Zur Referenz

Designsystem

Token-Tabellen, Komponenteninventar, Layoutmuster, Marke und Wortmarke. Zum Designsystem

Technische Präsentation

Ein technisches Deck mit 33 Folien von der Architektur bis zur Installation; aus dem Browser präsentiert, Schlüssel erforderlich. Präsentation öffnen

Aufbau der API

• Basis-URL (Staging): https://tfs-api.karyabilisim.com
• Versionierung: Fachliche Endpunkte liegen unter /api/v1/..., öffentliche Endpunkte unter /api/public/....
• Format: JSON, UTF-8. Datumsangaben sind ISO 8601, Zeitstempel RFC 3339.
• Geldbeträge: Alle Beträge sind Ganzzahlen in Minor Units (Kuruş). 1250000 = 12.500,00 TRY.
• Kompatibilität: API-Verträge tragen eine N-5-Zusage zur Abwärtskompatibilität von Minor-Versionen.

Gestaltungsprinzipien

1. Abgeleitete Werte werden nie übermittelt. Finanzierungsbeträge, Zuteilungsscores und Poolsalden werden von der Plattform berechnet; die API weist sie als Eingabe zurück.
2. Jede Antwort ist nachvollziehbar. Alle Antworten tragen eine traceId — geben Sie sie in Support-Anfragen an.
3. Regeln sind versioniert. Die Mathematik eines Vertrags wird mit den bei Abschluss fixierten Regelwerksversionen berechnet.