Developer API

Binden Sie Ihre Drittsysteme an FreeFinance an!

Einfach und bequem einen "Technical User" (pro Mandant) erstellen über Mein Profil > Benutzer & Berechtigung > Verbundene Apps und Ihre Systeme integrieren.

Disclaimer für API-Integrationen

Bitte beachten Sie, dass Sie bei der Anbindung von Drittsoftware, die außerhalb der EU gehostet werden oder unter Einfluss von Unternehmen mit Sitz außerhalb der EU stehen, den Datenschutz gemäß DSGVO wahren. So ist etwa der Consent der Lieferanten einzuholen, sofern bei der Verarbeitung von Eingangsrechnungen auf deren Rechnung personenbezogene Daten wie Namen/etc. von Ansprechpersonen angeführt sind. 

Zur Info: Deshalb verwendet die manubu gmbh eine eigene AI auf den eigenen Servern in Österreich (bzw. Deutschland), um DSGVO-konform zu sein.

Fehlangelegte Datensätze auf der Produktion können nicht gelöscht werden - das gilt gleichermaßen für manuell angelegte Eingaben, als auch per API. Bei der Funktion "Testdaten zurücksetzen" werden stets sämtliche Daten gelöscht, ein selektives Löschen ist nicht unterstützt.

Wir empfehlen daher, die Implementierung auf der Demoumgebung durchzuführen und gründlich zu testen.

Demo-Zugang

Gerne erstellen wir einen eigenen Zugang zu unserer Demo-Umgebung für Sie für Ihre API-Implementierung.

Demo-Zugang anfordern

How-To

API-Version 2.0.0 (Beta vom 2.12.2025)

Zur vollständigen API-Doku V2

Zur Legacy-API V1.18
(bis 30.11.2025, Unterstützung bestehender Implementationen läuft Ende 2026 aus)

Entwickeln

...und somit jedes beliebige Drittsystem anbinden

 

  • Authentifizierung
  • Finanzstammdaten
  • Stammdaten
  • Buchhaltung
  • Rechnungslegung
  • Registrierkassa
  • Kontoauszug
  • Doku-Archiv
  • Neue Benachrichtigungen abfragen
Testen

OpenAPI3.json herunterladen und zB: bei swagger.io Client-Implementation generieren

Zum Testen erhalten Sie einen kostenlosen Testzugang zu unserem Testsystem, die Info kommt mit Ihrem individuellen API-Key.

Welche Schnittstellen gibt es?

APIs stehen zu folgenden Bereichen zur Verfügung:

Authentifizierung mittels OAuth2 Standards:

  • Technical User (kostenlos beim Mandanten)
  • Authorization Code Flow (kostenpflichtig, extra anfragen)
  • Konten und Steuersätze
  • Länder und Regionen
  • Artikel
  • Pagination Abfrage von Artikeln
  • Kunden inkl. Forderungskonto
  • Lieferanten inkl. Verbindlichkeitskonto
  • Stammdaten abfragen
  • Eingangsrechnung inkl. Geldausgänge, Storno und Sonderbuchungen (seit V1.14 auch mit Teilzahlungen in der EA-Rechnung)
  • Ausgangsrechnung inkl. Geldeingänge und Storno seit V1.14 auch mit Teilzahlungen in der EA-Rechnung)
  • Buchungen
  • Saldenliste: Jahressaldenliste oder monatsweise Saldenliste mit extra Ausweisung von Anfangsbestand und Bilanz-Abschluss-Buchungen
  • Journaldatenabfragen
  • Rechnung erstellen, abschließen inkl. Geldeingänge
  • Gutschrift erstellen, abschließen inkl. Geldausgänge
  • Angebot
  • Auftragsbestätigung
  • Lieferschein
  • Einstellungen wie Zahlungsbedingungen, Belegkreise und Layoutsetup
  • Einmalige Empfängeranschrift
  • Stornieren (bei Rechnungen inkl. Möglichkeit der verschiedenen Stornierungsarten (mit eigener Rechnung, Gutschrift oder nur Storno)Rechnung erstellen, abschließen inkl. Geldeingänge
  • Gutschrift erstellen, abschließen inkl. Geldausgänge
  • Angebot
  • Auftragsbestätigung
  • Lieferschein
  • Einstellungen wie Zahlungsbedingungen, Belegkreise und Layoutsetup
  • Einmalige Empfängeranschrift
  • Stornieren (bei Rechnungen inkl. Möglichkeit der verschiedenen Stornierungsarten (mit eigener Rechnung, Gutschrift oder nur Storno)
  • Bons erstellen inkl. Artikel
  • Tagesabschluss
  • Entnahmen und Einlagen
  • Bonauswertungen und Bondaten abfragen
  • anlegen und abrufen
  • Zeilen anlegen und ergänzen
  • Kontoauszüge und Zeilen abrufen (API und PSD2)
  • Upload von Dateien/Dokumente ins Doku-Archiv für Buchen vom Foto inkl. Metadaten
  • Neue Benachrichtigungen abfragen

Zur Info: Wir bitten um Verständnis, dass nur die in der Doku angeführten Parameter und Endpoints verfügbar sind. Gerne nehmen wir weitere Wünsche in unsere Anforderungsdatenbank auf.

Non-Breaking-Changes, zB: Anpassungen, die bestehende APIs nicht invalidieren, werden in der bestehenden Version laufend integriert und erweitern diese!

Unterstützung benötigt?

Wir bieten unsere APIs kostenlos an und sind stets bemüht, die Dokumentation so aktuell und umfangreich auszugestalten, damit die Implementierung durch Sie ohne unsere Involvierung gelingt (Self-Service).

Für den Fall, dass Sie bei der Anbindung Unterstützung möchten, bieten wir einen kostenpflichtigen API-Support an. Nehmen Sie bei Bedarf gerne Kontakt mit uns auf.

Der API-Support wird von unserem Partner BüRomy GmbH durchgeführt. 

Das 15-minütige Erstgespräch ist kostenlos, dabei werden die Wünsche und Anforderungen, sowie die weiteren Kosten besprochen.