Zum Inhalt springen

Für Entwickler

Eine API für Transaktions­kontext.

Senden Sie eine Transaktion an die REST-API und erhalten Sie Händler, Kategorie, Labels und Konfidenz als strukturiertes JSON zurück. Endpunkt, Felder und Einbindung zeigt diese Seite an einem vereinfachten Beispiel.

Testzugang anfragenZur Feldreferenz

Auf einen Blick

POST /v1/transactions/classify

Request

  • transaction_id
  • amount
  • currency
  • booking_date
  • counterparty
  • purpose

Response

  • transaction_id
  • merchant.name
  • category.id
  • category.name
  • labels
  • confidence

Vereinfachtes Beispiel der TXNORA-API.

API im Überblick

Einfache REST-API, schlichtes JSON.

Eine Transaktion geht als Request hinein, strukturierter Kontext kommt als Response zurück. So lässt sich die API schnell in bestehende Backends einbinden.

  • REST-Endpunkt

    Ihr Backend sendet die Transaktion als JSON per POST-Request und erhält das Ergebnis als JSON-Response.

    POST /v1/transactions/classify

  • Eindeutige Zuordnung

    Die transaction_id aus Ihrem Request steht unverändert in der Response. So ordnen Sie jedes Ergebnis seiner Buchung zu.

    "transaction_id":"txn_demo_001"

  • Konfidenz je Ergebnis

    Ein Wert zwischen 0 und 1 gibt an, wie sicher die Zuordnung ist. Ihr Produkt entscheidet, was geprüft wird.

    "confidence":0.984

  • Custom Endpoints

    Für eigene Datenstrukturen, Prompts und Regeln: Custom Endpoints verarbeiten Daten nach Ihren Vorgaben, auch bei großen Datenvolumen.

    DatenstrukturenPromptsRegeln

Feldreferenz

Jedes Feld, direkt im Beispiel.

Typ und Bedeutung aller Felder aus dem Beispiel. Die Werte stammen aus derselben Beispiel­transaktion wie der Code.

Request-Felder

Was Ihr System im Beispiel sendet.

  • transaction_idTyp: stringIhre eigene Kennung der Buchung. Sie kommt in der Response unverändert zurück.Beispiel"txn_demo_001"
  • amountTyp: stringBetrag mit Vorzeichen als Dezimalwert, im Beispiel als String. Ausgaben sind negativ.Beispiel"-59.49"
  • currencyTyp: stringDreistelliger Währungscode, zum Beispiel EUR.Beispiel"EUR"
  • booking_dateTyp: stringBuchungsdatum im Format JJJJ-MM-TT.Beispiel"2026-10-05"
  • counterpartyTyp: stringGegenpartei, wie sie im Kontoauszug steht: oft gekürzt oder uneinheitlich geschrieben.Beispiel"PAYPAL *ADOBE"
  • purposeTyp: stringVerwendungszweck der Buchung als zusätzlicher Kontext.Beispiel"ADOBE SOFTWARE"

Response-Felder

Was die API zurückgibt.

  • transaction_idTyp: stringDieselbe Kennung wie im Request, damit Sie das Ergebnis zuordnen können.Beispiel"txn_demo_001"
  • merchant.nameTyp: stringNormalisierter, erkennbarer Händlername.Beispiel"Adobe"
  • category.idTyp: stringMaschinenlesbarer Schlüssel der Kategorie, etwa für Regeln in Ihrem Code.Beispiel"software"
  • category.nameTyp: stringLesbarer Name der Kategorie für die Anzeige.Beispiel"Software"
  • labelsTyp: string[]Kontextbezogene Labels über die Kategorie hinaus.Beispiel["SOFTWARE", "DIGITAL_SERVICE"]
  • confidenceTyp: numberWert zwischen 0 und 1, der angibt, wie sicher die Zuordnung ist. Der gezeigte Wert stammt aus den Beispieldaten und ist keine Messung.Beispiel0.984

POST /v1/transactions/classify

{
  "transaction_id": "txn_demo_001",
  "amount": "-59.49",
  "currency": "EUR",
  "booking_date": "2026-10-05",
  "counterparty": "PAYPAL *ADOBE",
  "purpose": "ADOBE SOFTWARE"
}

Vereinfachtes Beispiel für Request und Response der TXNORA-API.

Einbindung

Integration in drei Schritten.

Schnell eingebunden: Ihr Backend sendet, TXNORA strukturiert, Ihr Produkt entscheidet.

  1. Transaktion senden

    Ihr Backend sendet eine Buchung mit Betrag, Währung, Buchungsdatum, Gegenpartei und Verwendungszweck als Request an den Endpunkt.

    POST /v1/transactions/classify

    "counterparty":"PAYPAL *ADOBE""amount":"-59.49""currency":"EUR"

  2. Strukturierten Kontext erhalten

    Die Response liefert Händler, Kategorie, Labels und einen Konfidenzwert als JSON, bereit für Ihre Logik.

    AdobeSoftwareKonfidenz98,4 %
    SOFTWAREDIGITAL_SERVICE

  3. Im Produkt entscheiden

    Sie legen fest, was mit dem Ergebnis passiert. Zum Beispiel gehen Ergebnisse mit niedriger Konfidenz in eine manuelle Prüfung.

    Ihre Beispielregel: Prüfung unter 97,0 %

    • AdobeKonfidenz 98,4 %Ergebnis: Übernehmen
    • REWEKonfidenz 99,1 %Ergebnis: Übernehmen
    • AmazonKonfidenz 96,2 %Ergebnis: Prüfen

Beispiel aus drei typischen Buchungen. Die Prüfschwelle ist eine Beispielregel, die Sie in Ihrem Produkt selbst festlegen.

Betrieb & Datenschutz

DSGVO-konform verarbeitet.

TXNORA verarbeitet Ihre Daten auf lokal bzw. in der EU gehosteten LLM-Endpunkten.

  • Keine öffentlichen KI-Dienste

    Sensible Unternehmensdaten werden nicht an klassische öffentliche KI-Dienste weitergegeben.

  • Keine eigene LLM-Infrastruktur

    Sie binden die REST-API an und senden Daten. Modelle und Endpunkte müssen Sie nicht selbst betreiben.

  • Skalierbare Verarbeitung

    Die Verarbeitung wächst mit Ihrem Datenvolumen. Für große Datenmengen und eigene Datenmodelle gibt es Custom Endpoints.

Zugang

Testzugang und Dokumentation auf Anfrage.

Senden Sie uns eine kurze Anfrage über das Kontaktformular. Innerhalb von 24 Stunden erhalten Sie einen kostenlosen, zeitlich begrenzten Testzugang zur API, die Entwicklerdokumentation und unsere Preise.

Zugang
Kostenloser Testzugang, zeitlich begrenzt
Dokumentation
Zusammen mit dem Testzugang
Schnittstelle
REST-API mit JSON
Preise
Nutzungsbasiert und transparent
Testzugang anfragenHäufige Fragen