Dinero-Schnittstelle und API-Integration
Dinero ist eine Cloud-Buchhaltungsplattform für kleine Unternehmen in Dänemark, die zu Visma gehört und von mehr als 80.000 dänischen Firmen genutzt wird. Sie deckt Rechnungsstellung, Buchführung, Ausgaben, Mehrwertsteuer und die dänische E-Rechnung ab. Binden Sie sie über Maesn an, und Sie erreichen sie mit derselben REST API und demselben Datenmodell wie jedes andere unterstützte System.
Eine Dinero-Anbindung in Tagen
Dinero läuft auf einer einfachen REST API. Die Anfragen sind also nicht die Arbeit. Die Arbeit liegt darum herum: gegen welche der zwei Autorisierungswelten von Dinero Sie bauen, zu welcher Firma ein Aufruf gehört, und ob der Kunde vor Ihnen auf einem Tarif ist, bei dem die API überhaupt antwortet. Alle drei sind geklärt, bevor Sie eine Zeile schreiben.
Ihr Kunde wählt die Firma beim Verbinden
Visma Connect autorisiert den Nutzer und nicht die Firma. Ein dänischer Buchhalter erreicht über eine Anmeldung also jede Mandantenorganisation. Jede Anfrage trägt die Organisation im Pfad, und die falsche zu wählen liefert einen 403 statt eines leeren Ergebnisses. Dinero ist eines der Systeme auf dem interaktiven Authentifizierungsablauf von Maesn: Ihr Kunde wählt die Firma beim Verbinden, die Wahl wird verwahrt, und nichts in Ihrem Code muss sie erneut senden.
Sie wählen nie zwischen den zwei Wegen von Dinero
Der Einstieg von Dinero beschreibt zwei verschiedene und getrennte Autorisierungssysteme. Visma Connect OAuth ist der Weg für ein Produkt, das die Konten anderer Unternehmen anbindet, und ein persönlicher API-Schlüssel der Weg für ein Unternehmen, das die eigenen Bücher automatisiert. Beide erreichen dieselbe REST-Oberfläche, jeder braucht eigene Zugangsdaten, und nur der Weg über Visma Connect kann das Event von Dinero empfangen. Maesn fährt diesen Weg. Die Wahl ist für Ihr Produkt also einmal entschieden und kommt nicht mit jedem neuen Kunden zurück.
Eine Testumgebung, bevor Dinero eine stellt
Dinero hat keine eigene Entwickler-Sandbox. Sie bauen gegen eine echte Organisation, die API antwortet nur für eine mit aktiver Pro- oder Total-Lizenz, und ein Dinero-Testkonto anzulegen setzt in der Regel eine Registrierung in Dänemark voraus. Auch das Team hinter Ihrem Visma-Connect-Antrag muss Dänemark als Land führen, wofür es in der Praxis eine dänische CVR-Nummer braucht, sonst erscheinen die Dinero-Scopes nie in der Liste, aus der man sie beantragt. Maesn stellt für jedes unterstützte System eine Sandbox bereit. Ihr Team fängt also an zu bauen, während der dänische Papierkram noch läuft.
Es bleibt der Teil, den Sie wollten: den Kontenrahmen und die Steuerschlüssel lesen, eine Buchung erfassen und zurücklesen, und denselben Code auf das nächste System richten.
Ein kurzes Gespräch genügt meist, um zu klären, ob Maesn zu Ihrem Anwendungsfall passt.
Die Kunden von Findity binden jeweils ihr eigenes Buchhaltungssystem an
Findity ist eine Plattform für die Ausgabenverwaltung, die White-Label und über eine API ausliefert. Ihre Kunden erreichen Buchhaltungssysteme also über Findity statt direkt. Genau für diese Form gibt es den Verbindungsschritt von Dinero: nicht eine Firma, die ein Hauptbuch anschließt, sondern viele Endkunden, die jeweils die Organisation wählen, für die die Verbindung gilt.
“Maesn hat uns geholfen, Integrationen zu Buchhaltungssystemen zu bauen, und wir können uns dadurch auf andere Prioritäten in unserer Roadmap konzentrieren. Besonders schätzen wir die Unterstützung, die wir jedes Mal bekommen haben, wenn wir erweiterte Funktionen in einer Integration brauchten, die Maesn für uns eingerichtet hat.”
Drei Gründe, die Dinero-Schnittstelle über Maesn anzubinden
Direkt gegen Dinero zu bauen ist für ein System eine vertretbare Wahl. Die Frage ist, was davon auf das zweite übergeht, und hier fast nichts.
Die dänischen Eigenheiten bleiben auf dieser Seite
Einkaufsbelege, die Kassekladde, Kontakte, die erst nach einem Verkauf zu Debitoren werden, Umsatzsteuerschlüssel statt Prozentsätzen, EAN-Nummern und MitID für die elektronische Rechnungsstellung. Nichts davon ist schwierig, wenn man es kennt, und alles davon hat die Form von Dinero und die Form Dänemarks. Über Maesn kommt es in demselben Modell an wie jedes andere System, das Sie anbinden. Es bleibt also Wissen, das Sie einmal erwerben, und wird nie zu Vokabular, das Ihre Codebasis tragen muss.
Drei Visma-Produkte, drei Wege
Dinero steht im selben Portfolio wie Visma e-conomic und Visma eAccounting, und beide sind hier bereits angebunden. Derselbe Eigentümer macht sie nicht gleich: e-conomic verbindet über ein Modell mit zwei Tokens, eAccounting über OAuth und Dinero über Visma Connect mit einer Firma, die unterwegs gewählt wird. Diese drei Unterschiede bleiben auf dieser Schicht, statt zu drei Umsetzungen in Ihrem Produkt zu werden.
Eine Integration, jedes System danach
Sobald Dinero angebunden ist, sind die Systeme, nach denen Ihre dänischen Kunden als Nächstes fragen, über dieselbe Schnittstelle erreichbar, mit demselben Account-Key-Mechanismus und denselben Objekten. Ein Kunde, der von Dinero auf ein größeres Hauptbuchsystem wechselt, wird dadurch kein zweites Integrationsprojekt, und der erste Kunde aus Schweden oder Deutschland ebenso wenig.
Dinero ist das dritte Produkt aus demselben Portfolio auf dieser Schnittstelle, nachdem die Visma-Systeme hier bereits angebunden sind. Varianten voneinander sind sie nicht: Die beiden darunterliegenden Produkte authentifizieren und paginieren anders als Dinero und anders als untereinander, und genau diese Arbeit nimmt diese Schicht ab. Was zurückkommt, kommt im gemeinsamen Common Data Model an, eine Buchung in einem dänischen Hauptbuch hat also dieselbe Form wie eine Buchung irgendwo sonst.
Ein Dinero-Eintrag, der mit echtem Traffic startet
Dinero listet Integrationen in einem öffentlichen Verzeichnis, und verlangt wird ein Produkt, das bereits läuft, und kein Plan und keine Gebühr. Maesn übernimmt die technische Seite und geht den Eintrag mit Ihnen durch.
Maesn baut und betreibt die Verbindung
Der Visma-Connect-Antrag, die Scopes, die Auflösung der Firma und der Lebenszyklus der Tokens gehören uns. Was Sie integrieren, ist eine REST-API, die sich bei Dinero so verhält wie überall sonst.
Die Kundenbeziehung bleibt bei Ihnen
Der Eintrag trägt Ihr Produkt, Ihr Logo und Ihre Beschreibung. Maesn erscheint nicht an Ihrer Stelle im Verzeichnis, und die Pro- oder Total-Lizenz, die die API braucht, bleibt eine Sache zwischen Ihrem Kunden und Dinero.
Echten Verkehr fahren
Dinero prüft die tatsächliche Nutzung der API und keine Einreichung. Das heißt, die Fehlerfälle sauber zu behandeln, und insbesondere eine Integration anzuhalten, die dauernd fehlschlägt, statt sie gegen eine Wand weiterlaufen zu lassen.
Die Prüfung anfragen
Sie schicken Dinero Ihre Client-ID und das Zeitfenster, in dem der Verkehr lief, und man sieht sich an, was Ihre Integration tatsächlich getan hat. Das Ergebnis ist ein Ja oder ein Nein und keine Punktzahl.
Den Eintrag einreichen
Nach dem Bestehen trägt ein kurzes Formular Logo, Website, Beschreibung und eine Kontaktadresse, und die Integration erscheint im öffentlichen Verzeichnis von Dinero, in dem dänische Unternehmen suchen.
Es gibt hier keine Stufenleiter und keine Partnergebühr: Die Pro- oder Total-Lizenz, die die API braucht, gehört dem Kunden, und Dinero berechnet dem Integrator nichts für den Eintrag. Die Bedingung, die wirklich greift, ist die erste, denn Dinero beschränkt den Zugang für Integrationen, die die API verschwenderisch nutzen. Geprüft wird, wie sich die Integration verhält.
Wir bereiten die technische Seite vor und gehen die Prüfung mit Ihnen durch.
Dinero autorisiert eine Person, die Firma ist damit eine Wahl
Dinero authentifiziert über Visma Connect, denselben Autorisierungsdienst, den andere Visma-Produkte nutzen, und das Interessante ist nicht der OAuth-Tanz. Es ist, dass die Autorisierung einer Person gehört, die mehrere Firmen halten kann, und dass jede einzelne Anfrage sagen muss, welche sie meint.
- Visma Connect OAuth 2.0
- Produkte, die Dinero-Konten anderer Unternehmen anbinden. Authorization Code mit PKCE, Lese- und Schreib-Scopes plus Offline-Zugriff für das Refresh.
- Dinero-API-Schlüssel
- Der eigene Weg von Dinero für ein Unternehmen, das seine eigenen Bücher automatisiert, mit Client-ID, Client-Secret und einem organisationsspezifischen Schlüssel auf einmal. Der Einrichtungsleitfaden von Maesn dokumentiert den Weg über Visma Connect.
Wie ein System auch authentifiziert, in Ihrem Code kommt ein Maesn-API-Schlüssel plus ein Account-Key an. Die Organisation von Dinero, seine Token-Laufzeit und sein Refresh-Verhalten liegen alle hinter diesem Paar.
- Zugriffstokens leben 60 Minuten
- Auf beiden Wegen gleich. Die Einrichtungsanleitung von Maesn setzt die Lebensdauer ausdrücklich, statt eine Voreinstellung zu erben. Der Takt der Erneuerung ist also von Anfang an eine bekannte Größe.
- Refresh-Tokens sind auf Wiederverwendung eingestellt, nicht auf einmalig
- Visma Connect bietet beides an. Bei einmaligen Tokens macht das Einlösen eines bereits benutzten Tokens die ganze Autorisierung ungültig, und der Kunde muss erneut freigeben. Die Einrichtungsanleitung von Maesn wählt die Wiederverwendung mit 365 Tagen Lebensdauer. Dieser Fehlerfall wird also bei der Registrierung ausgeschlossen statt zur Laufzeit abgefangen.
- Eine erneute Autorisierung einmal im Jahr
- Die andere Seite eines Refresh-Tokens mit 365 Tagen: Nach einem Jahr sieht der Kunde den Zustimmungsbildschirm erneut. Still geht dabei nichts kaputt, die Aufrufe sind nur so lange nicht mehr autorisiert, bis er klickt, und damit ist es ein Termin für den Kundenbetreuer und kein Vorfall.
Die Firmenwahl ist der Schritt, um den herum Sie Ihr Verbindungserlebnis entwerfen sollten. Eine falsch zugeordnete Organisation ist der häufigste Fehlschlag auf dieser API, und er zeigt sich zur Anfragezeit statt zur Verbindungszeit, was die übliche Reihenfolge umkehrt: Die Verbindung sieht erfolgreich aus, und der erste echte Aufruf nicht.
- 1
Er gibt bei Visma Connect frei
Ihr Kunde meldet sich mit seinem Visma-Konto an und erteilt die Lese- und Schreib-Scopes, die Ihre Anwendung angefordert hat. Der Zustimmungsbildschirm zeigt den Namen Ihrer Anwendung, was Sie registriert haben, ist also das, was ein dänischer Unternehmer liest, bevor er zustimmt.
- 2
Er wählt die Firma
Weil die Autorisierung eine Person und keine Firma umfasst, werden die erreichbaren Organisationen danach ermittelt und zur Auswahl gestellt. Ihr Kunde wählt die, für die diese Verbindung gilt, auf einer Seite, die Sie als Ihre eigene gestalten können.
- 3
Sie erhalten einen Account-Key
Maesn speichert die Verbindung und gibt einen Account-Key zurück. Von da an läuft die Organisation mit diesem Schlüssel mit, und die Anfragen sehen aus wie bei jedem anderen System, das Sie angebunden haben.
Die meisten Authentifizierungsprobleme drehen sich darum, Zugangsdaten zu bekommen. Bei Dinero geht es darum, worauf die Zugangsdaten zeigen, und das ist eine andere Frage, die auch dann noch offen ist, wenn der OAuth-Ablauf fertig ist. Unified Authentication trägt die Firmenauswahl: ein dokumentierter Ablauf für die Systeme, die eine brauchen, die Auswahlseite kann Ihre eigene Marke tragen, und der Account-Key, den Sie zurückbekommen, verhält sich gleich, ob das System dahinter Ihren Kunden eine Firma wählen ließ oder gar nichts.
Die Änderungserkennung läuft nach Ihrem Zeitplan
Dinero veröffentlicht genau ein natives Event, und über diese Anbindung trägt heute kein Objekt einen freigeschalteten Webhook. Das sind zwei Aussagen über zwei verschiedene Dinge: was der Hersteller ausliefert, und was hier ankommt.
Ein Event, auf Buchungen. Dinero hat es im August 2024 eingeführt, beschreibt es weiterhin als in einer Testphase und bietet es nur Integrationen an, die sich über Visma Connect authentifizieren. Alles andere im Konto eines Kunden ändert sich, ohne es zu melden.
Ein geplanter Lesezugriff, mit demselben Filter und derselben Paginierung, die Sie für jedes andere System benutzen. Die eigene Antwort von Dinero für Integrationen ohne das Event hat dieselbe Form: die Listen-Endpunkte fragen, was sich seit einem bestimmten Zeitpunkt geändert hat. Der Unterschied ist, dass Sie es hier einmal schreiben.
Erkennung über Lesen statt über Push macht die Aktualität zur Frage des Intervalls, und das ist ein Tausch, den man bewusst eingehen sollte. Er hat außerdem einen Vorteil, den ein Push nicht hat: Ein geplanter Lesezugriff holt nach einem Ausfall sauber nach, wo ein verpasstes Event schlicht weg ist. Dinero setzt seit April 2026 100 Anfragen pro Minute je Organisation durch. Das Intervall ist also ein echtes Budget und kein freier Regler.
Ein System, das Sie abfragen müssen, macht aus der Änderungserkennung Code, der Ihnen gehört, und bei Dinero hat dieser Code ein Budget: Sie schreiben die Schleife, dann noch eine für das nächste System, mit eigener Filtersyntax, eigener Seitengröße und einer eigenen Vorstellung davon, was ein Zeitstempel bedeutet. Ein Weg, zu filtern und zu paginieren nimmt diese Wiederholung weg, und das zählt hier mehr als sonst, weil Dinero Anfragen zählt: hundert pro Minute je Organisation, durchgesetzt seit April 2026. Was Sie über das Event-Modell verarbeiten und was Sie nach Zeitplan abholen, bleiben zwei Wege, und bei Dinero läuft heute nur der zweite.
Was eine Dinero-Verbindung vorab verlangt
Vier Bedingungen entscheiden, ob eine Dinero-Verbindung überhaupt zustande kommt. Zwei erledigen Sie einmal, und zwei liegen bei jedem Kunden.
- Ein Visma-Connect-Antrag, für Dinero freigegeben
- Sie registrieren den Antrag in Visma Connect und beantragen die Lese- und Schreib-Scopes von Dinero. Der interne Scope wird grundsätzlich abgelehnt, ihn zu beantragen lohnt sich also nicht. Freigabe oder Ablehnung sind ein Schritt von Hand bei Dinero und kein Schalter, den Sie umlegen.
- Ein in Dänemark registriertes Team
- Die Einrichtungsanleitung von Maesn sagt es ausdrücklich: Ist das Land des Visma-Connect-Teams nicht Dänemark, erscheinen die Scopes von Dinero überhaupt nicht in der Liste. Das ist das Erste, was Sie prüfen, wenn die Scopes zu fehlen scheinen.
- Eine Client-ID, die Ihr Unternehmen ausweist
- Dinero gibt Anträge frei, deren Client-ID das Unternehmen hinter der Integration benennt. Ein Platzhalter ist im Test in Ordnung und wird für die Produktion abgelehnt. Die ID sollte man also gleich zu Beginn richtig wählen.
- Jeder Kunde auf einer Pro- oder Total-Lizenz
- Die API antwortet nur für Organisationen mit aktiver Pro- oder Total-Lizenz. Ohne eine ist die Organisationsliste der einzige Endpunkt, der noch antwortet, und sie trägt den Abonnementstatus. Die Bedingung lässt sich also prüfen, bevor eine Verbindung versucht wird. Sie liegt bei Ihrem Kunden und nicht bei Ihnen, und damit ist sie eine Frage des Onboardings.
Wir gehen den Antrag und die Scopes mit Ihnen durch.
Eine Kontaktliste, und zwei Wege, eine Änderung abzusichern
Zwei Entscheidungen von Dinero reichen bis in Ihren Code, bevor Sie etwas abbilden: wie es Käufer und Verkäufer auseinanderhält, und über welches Feld es verhindert, dass zwei Schreibzugriffe sich gegenseitig überschreiben.
Kunden und Lieferanten sind nicht zwei Listen
Dinero führt eine Kontaktliste und kennzeichnet Einträge als Debitor oder Kreditor, und diese Kennzeichen werden erst wahr, wenn ein Verkauf oder ein Einkauf stattgefunden hat. Vorgelagert gibt es kein eigenes Kundenobjekt, das sich bereitstellen ließe. Planen Sie Ihre Zuordnung also um die Kontakte herum und nicht um zwei Verzeichnisse.
Die Nebenläufigkeit kommt als Timestamp oder als Version
Dinero sichert Aktualisierungen über optimistische Nebenläufigkeit ab, und das Feld ist nicht überall dasselbe. Rechnungen, Belege, Gutschriften, Mahnungen, Angebote und Zahlungen nehmen den Timestamp zurück, den Sie zuletzt gelesen haben, und ein veralteter wird abgelehnt, statt still jemanden zu überschreiben. Hauptbuchposten erledigen dieselbe Aufgabe mit einem Feld Version, und sie müssen für eine Organisation außerdem der Reihe nach gebucht werden. Beides ist die Art Regel, die im Produktivbetrieb auffällt und nicht im ersten Test.
Beides ist die Art Sache, die offensichtlich ist, sobald man sie kennt, und teuer an dem Tag, an dem man sie nicht kennt. Die Kontaktliste entscheidet, wo die Unterscheidung zwischen Kunde und Lieferant liegt, und bei Dinero ist diese Antwort Ihre Seite, denn die Kennzeichen weiter oben werden erst wahr, nachdem ein Verkauf oder ein Einkauf gebucht wurde. Das Nebenläufigkeitsfeld entscheidet, was ein Schreibzugriff mitbringen muss, und es ist nicht ein Feld: Ein Beleg sendet den Timestamp zurück, mit dem er gelesen wurde, eine Hauptbuchposition sendet eine Version.
Beim Buchen treffen sich die beiden. Eine Buchung, die hineingeht, muss Konten aus dem Kontenrahmen nennen, den Sie gelesen haben, den Steuerschlüssel tragen, den Dinero erwartet, statt eines Prozentsatzes, und für eine einzelne Organisation in der richtigen Reihenfolge ankommen. Über Maesn ist jedes davon derselbe Aufruf wie auf jedem anderen angebundenen System, das dänische Besondere bleibt also Wissen, das Sie sich einmal aneignen.
Sagen Sie uns, welche Objekte Ihr Anwendungsfall braucht, und wir bestätigen, was möglich ist.