Tripletex anbinden: Drei Tokens, und eine Zeilennummer, die Sie nie senden

Tripletex arbeitet nicht mit einem einzigen Zugang. Bevor irgendetwas läuft, brauchen Sie zwei, und sie kommen von zwei verschiedenen Stellen: eines wird Ihnen als Entwickler ausgestellt, das andere erzeugt der Kunde, dessen Daten Sie lesen.

Ihres ist das Consumer-Token. Tripletex stellt es aus, sobald Ihre Registrierung für Version 2 der Schnittstelle abgeschlossen ist, und es weist Ihre Integration über jeden Kunden hinweg aus, den Sie je anbinden. Ein Token deckt sie alle ab. Behandeln Sie es wie jedes andere Anwendungsgeheimnis.

Das andere gehört dem Kunden: das Employee-Token, erzeugt in dessen eigenem Tripletex unter den Benutzereinstellungen und dem API-Zugang. Dafür braucht es auf seiner Seite einen Administrator, und das ist gut zu wissen, bevor Sie den Onboarding-Text schreiben, der ihn auffordert, eines anzulegen.

Es gibt eine eigene Testumgebung mit eigenen Consumer- und Employee-Tokens, und sie verhält sich wie der Produktivbetrieb gegen Tripletex' Testbestand und nicht wie ein Mock. Unsere kam schnell zurück, und das ist gut zu wissen, wenn Sie die erste Woche des Baus planen.

Das Consumer-Token und das Employee-Token sind keine Zugangsdaten, die Sie senden. Sie sind Eingaben. Sie tauschen sie gegen ein Session-Token, und das Session-Token ist das, was jede spätere Anfrage tatsächlich trägt.

Der Tausch ist ein einzelner Aufruf mit drei Pflichtwerten: Ihr Consumer-Token, ein Employee-Token, das gegen dasselbe Consumer-Token erzeugt wurde, und ein Ablaufdatum. Alle drei sind verpflichtend, und das dritte verlangt eine Entscheidung von Ihnen: Das Ablaufdatum ist ein Wert, den Sie selbst setzen.

Von da an ist die Authentifizierung schlichte Basic Access Authentication mit dem Session-Token als Passwort. Wenn Sie den Header selbst zusammenbauen, ist es die Firmenkennung, ein Doppelpunkt und das Session-Token, Base64-kodiert. Es gibt außerdem einen Aufruf, der eine Session ausdrücklich löscht, und das ist der saubere Weg, einen Zugang zu beenden, statt auf das Datum zu warten.

Über maesn erreicht Sie davon nichts. Ihr Consumer-Token wird einmal auf Ihrem Mandanten eingerichtet, Ihr Kunde gibt sein Employee-Token ein, wenn er sich verbindet, und die Session wird hier abgeleitet und erneut abgeleitet, wenn sie abläuft. Unified Authentication ist der Grund, warum das genauso aussieht wie bei einem System mit einfachem Redirect: Was Sie danach halten, ist ein Account-Key, und Account-Keys verhalten sich über den ganzen Katalog hinweg gleich.

Tripletex kennt zwei Arten der Anmeldung, und der Unterschied zwischen ihnen entscheidet, wie viele Firmen überhaupt erreichbar sind.

Melden Sie sich als Mitarbeiter an, sind Sie immer innerhalb einer bestimmten Firma. Das ist der Fall mit einer Gesellschaft, und es gibt nichts zu wählen. Melden Sie sich als Buchhalter an, erreichen Sie viele, das ist der Fall mit mehreren Gesellschaften, und jetzt muss etwas sagen, welche Sie meinen.

Tripletex legt das an eine Stelle, an der es die meisten Systeme nicht haben: in die Benutzernamen-Hälfte des Authentifizierungs-Headers. Null oder leer bedeutet die Firma des Mitarbeiters, dessen Token Sie verwenden. Jeder andere Wert bedeutet eine der Mandantenfirmen einer Kanzlei, und es gibt einen eigenen Aufruf, der die Firmen auflistet, die eine bestimmte Anmeldung erreichen darf.

Über maesn fällt die Wahl, wenn die Verbindung entsteht, und die aufgelöste Firma reist mit dem Account-Key statt mit Ihren Anfragen. Das ist auf Ihrer Seite alles, und es ist dieselbe Form der Antwort, die Sie bei jedem System im Katalog bekommen, das einen Mandantenbegriff kennt.

Eine Buchungszeile hinzuzufügen ist der Vorgang, der beim ersten Mal lautlos fehlschlägt, und nichts an der Form des Objekts warnt Sie davor.

Ein Buchungssatz in Tripletex trägt seine Zeilen als Array am Satz selbst. Eine Zeile zu aktualisieren, die es schon gibt, läuft so, wie Sie es erwarten: Sie geben ihre ID an und die Felder, die Sie ändern. Eine neue Zeile hinzuzufügen läuft anders, denn eine Zeile, die es noch nicht gibt, hat keine ID, die Sie angeben könnten. Was Tripletex stattdessen will, ist ihre Position. Hält der Satz bereits drei Zeilen, kündigt die, die Sie hinzufügen, an, dass sie Zeile vier ist.

Das heißt, Sie können die Aktualisierung nicht aus den Daten bauen, die Sie schreiben. Sie müssen wissen, was schon da ist, und damit wird ein Lesezugriff zur unvermeidlichen ersten Hälfte jedes Schreibzugriffs.

Über maesn gibt es kein Zeilenfeld in der Form, die Sie senden. Der Lesezugriff passiert, bevor Ihr Schreibzugriff hinausgeht, die belegten Zeilen werden gezählt und die neue Zeile wird hier nummeriert. Das ist ein kleines Stück Maschinerie, und es ist die Sorte, die man leicht fast richtig hinbekommt: Von der Anzahl aus zu nummerieren statt von der höchsten belegten Zeile ist so lange korrekt, bis jemand eine Zeile löscht.

Tripletex paginiert von Haus aus und macht es gut. Ein Listenaufruf nimmt einen Startindex und eine Anzahl, und die Antwort kommt als Umschlag mit den Werten darin zurück. Er nimmt außerdem ein Sortiermuster und einen Feldparameter, der auswählt, welche Attribute zurückkommen sollen, einschließlich der Attribute verschachtelter Ressourcen.

Das Filtern ist typisiert und gehört zum jeweiligen Endpunkt statt allgemein zu sein. Allein der Konten-Endpunkt nimmt Filter auf Kennung, Nummer, ob das Konto ein Bankkonto ist, ob es inaktiv ist, ob es für Eingangsrechnungen infrage kommt, seine Hauptbuchart, ob es ein Bestandskonto ist, und seinen SAF-T-Code.

Worauf Sie nicht bauen sollten, ist die Gesamtzahl. Der Umschlag trägt ein Feld für die Größe des vollständigen Ergebnisses, und Tripletex kündigt dieses Feld in seiner eigenen Dokumentation ab. Am Konten-Endpunkt haben unsere Entwickler überhaupt keine Gesamtzahl zurückbekommen, und deshalb ist die Paginierung über diesen Lesezugriff unsere und nicht ihre.

Diese Schleife einmal je System zu schreiben ist genau die Arbeit, die ein Weg, zu filtern und zu paginieren abnimmt. Die Schleife, die Sie auf Tripletex richten, ist die Schleife, die Sie auf das nächste System richten, und eine abgekündigte Zählung an einem Endpunkt eines Systems hört auf, etwas zu sein, das Ihr Code wissen muss.

Tripletex veröffentlicht ein eigenes Abonnement-Modell. Ein Event benennt ein Objekt und ein Verb zusammen, Anlegen, Aktualisieren und Löschen desselben Objekts sind also drei getrennte Abonnements statt eines Stroms, den Sie filtern.

Die Zustellung trägt das Abonnement, zu dem sie gehört, den Namen des Events, die Kennung des betroffenen Objekts und das Objekt selbst. Mit einer Ausnahme: Beim Löschen ist das Objekt null. Sie erfahren, was weg ist, nicht, was darin stand, und alles, was Ihr Produkt über einen gelöschten Datensatz wissen muss, muss also vorher gespeichert worden sein.

Diese Events sind über maesn heute nicht freigeschaltet, die Änderungserkennung an dieser Verbindung ist also ein Lesezugriff auf einem Zeitplan, den Sie wählen. Sie sind auf Anfrage verfügbar, und der Zeitplan, den Sie jetzt schreiben, funktioniert so oder so weiter, denn das Event-Modell ist ein eigener Weg und kein Ersatz für das Abfragen.

Alles oben ist echte Arbeit, und das meiste davon ist dieselbe Arbeit für jeden Kunden, den Sie anbinden. Das ist der Teil, den man einmal macht.

Die heute erreichbaren Objekte sind eine kleinere Menge als Tripletex insgesamt. Konten, Buchungssätze und Steuersätze sind lesbar, und Buchungssätze lassen sich außerdem anlegen und aktualisieren, das ist ein tragfähiger Buchungsweg und keine reine Leseansicht. Der Rest des Katalogs ist auf Anfrage verfügbar, und welche Teile Sie brauchen, klärt man besser, bevor man darum herum entwirft. Der Umfang, und was es braucht, ihn zu erweitern, steht auf der Seite zur Tripletex-Schnittstelle.

Eines bleibt wirklich Ihres, welchen Weg Sie auch wählen. Tripletex drückt jeden Buchungssatz unter der von Ihnen gebuchten Währung zusätzlich in norwegischen Kronen aus und zeigt beide. In Euro oder Dollar zu buchen heißt deshalb, einen Wechselkurs mit dem Buchungssatz zu senden. Keine Integrationsschicht kann entscheiden, welchen Kurs Ihr Geschäft verwenden soll, das ist also eine Entscheidung über Ihre eigenen Daten und kein Abbildungsproblem.