Anbindung an öffentliche Referenzdaten — Basismodul (kostenlos)

Verbindungen zu öffentlichen Referenzverzeichnissen — die Basis

Ein Modul, das den Benutzer eine USt-IdNr., einen NAF-Code und den Zustand eines Unternehmens von Hand erfassen lässt, lässt ihn abschreiben, was vier kostenlose öffentliche Dienste in einer Sekunde liefern. Dieses Modul legt die Infrastruktur einmal an und prüft selbst nichts: Es ist die Basis, an die sich die Prüfmodule anschließen.

Auch gesucht unter: Prüfung der innergemeinschaftlichen USt-IdNr. Odoo, INSEE-Sirene-Konnektor Odoo, API entreprise Odoo, SIRET-Prüfung Odoo, Normalisierung französischer Adressen Odoo, BODACC-Konnektor, Sirene-API ohne Schlüssel, Fallback API entreprise.

Vier Referenzverzeichnisse, sechs Dienste und eine Rückfallkette je Referenzverzeichnis. Ein Referenzverzeichnis ist eine Frage – die Gültigkeit einer Umsatzsteuer-Identifikationsnummer, die Identität und die Geschäftsführer eines Unternehmens, eine französische Adresse, die Insolvenzverfahren. Ein Dienst ist ein Anbieter, der sie ganz oder teilweise beantworten kann. Wenn mehrere dieselbe Frage beantworten, werden sie in der Reihenfolge der Präferenz probiert, und der erste, der antwortet, gewinnt.

Ein Schlüssel macht das Modul besser; sein Fehlen macht es nicht stumm. Die Sirene-API des INSEE ist maßgeblich, verlangt aber einen Schlüssel, den man durch kostenlose Registrierung erhält. Ohne ihn antwortet die Unternehmenssuche an seiner Stelle, und alles funktioniert: Die Antwort ist nur weniger maßgeblich und trägt den Namen des anderen Dienstes. Das ist der Unterschied zwischen einem Modul, das ein Konto verlangt, und einem Modul, das eines nutzt, wenn es eines gibt.

Eine Stufe tiefer zu gehen verarmt nie. Die Sirene-API verbreitet die Geschäftsführer nicht. Ohne Vorsichtsmaßnahme würde die Eingabe eines INSEE-Schlüssels eine Information verlieren, die man ohne ihn hatte — eine Verbesserung, die verarmt. Die Kette ergänzt daher, was die bevorzugte Quelle nicht abdeckt: Mit einem Schlüssel stammt die Identität vom INSEE und die Geschäftsführer aus der Unternehmenssuche, und jedes Stück der Antwort behält den Namen des Dienstes, der es geliefert hat.

Ein Fallback verbirgt nie eine Störung. Der ausgefallene Dienst bleibt als gestört markiert, mit dem Datum seines ersten Fehlschlags – nie dem des letzten, sonst läse man eine Woche lang „seit einer Minute gestört“. Das Protokoll trägt beide Versuche untereinander. Ein Fallback, der die Spur des Fehlschlags löschte, würde das Modul über seine eigene Verfügbarkeit lügen lassen.

Ein Bildschirm, der einen Zustand nennt, keinen Fehler. Eine Zeile je Dienst, mit ihrem Zustand im Klartext: „aktiv, ohne erforderlichen Schlüssel“, „Schlüssel fehlt, Quelle ignoriert“, „gestört seit 13.09. 22:25 – HTTP-Code 503“. Der Benutzer, der keinen Schlüssel erfasst hat, sieht auf einen Blick, dass trotzdem alles funktioniert. Und eine Schaltfläche Testen in jeder Zeile ruft den Dienst tatsächlich auf und zeigt, was zurückkommt – so validiert man einen frisch erhaltenen Schlüssel.

Ein datierter Cache, je Frage. Das INSEE wird nicht dreimal für dieselbe SIRET am selben Tag abgefragt. Jede Antwort wird mit ihrem Datum gespeichert, und die Gültigkeitsdauer wird je Dienst eingestellt: vierundzwanzig Stunden für eine Umsatzsteuer-Identifikationsnummer, die morgen gelöscht sein kann, einen Monat für eine Adresse, die sich nicht ändern wird.

Ein Ausfallmodus, der nicht lügt. Wenn ein Dienst nicht antwortet, schlecht antwortet oder sein Kontingent überschreitet, meldet das Modul es, behält die letzte bekannte Antwort mit ihrem wahren Datum und blockiert nie eine Erfassung. Das Datum des letzten Versuchs und das des letzten Erfolgs sind zwei getrennte Felder: Der Benutzer sieht „aktiv am 12. September, Dienst seither nicht erreichbar“ und keine veraltete Angabe, die als frisch dargestellt wird.

Ein ausdrücklicher Offline-Modus. Dienst für Dienst aktivierbar. Es wird dann kein Aufruf versucht, bereits bekannte Antworten bleiben lesbar, nichts bricht ab. Das ist der Modus einer Demonstration, eines Abnahmetests oder eines Servers ohne ausgehenden Zugang.

Kein Netzwerkaufruf in einem Prozess, der eine Seite ausliefert. Die Aufrufe laufen über eine von Odoo geführte Warteschlange, die vom Cron oder auf ausdrücklichen Wunsch des Benutzers geleert wird. Ein aus einem berechneten Feld versuchter Aufruf wird abgelehnt — das ist eine durch einen Test geprüfte Schutzvorrichtung, keine Anweisung. Eine übernommene Aufgabe trägt ihren Zeitstempel; eine über die Frist hinaus laufende Aufgabe wird gemeldet und nie von selbst neu gestartet, weil man nicht weiß, ob der Aufruf bereits abgegangen ist.

Ein Protokoll. Jeder Aufruf hinterlässt seine Dauer, seinen Rückgabecode und seine zusammengefasste Antwort – auch die erfolgreichen. Der Vergleich der Dauern, vorher und währenddessen, ermöglicht es, eine Störung an dem Tag zu erkennen, an dem sie eintritt.