Automatische Kundenkarte per SIREN - Dolibarr-Modul | KSIDol

Automatische Partnerkarte per SIREN - Dolibarr-Modul (INSEE-Sirene-API)

SirenCreatTiers beseitigt die manuelle Erfassung französischer Geschäftspartner in Dolibarr: Sie tippen die SIREN-Nummer in das Feld „Gew. ID 1" des Erstellungs- oder Bearbeitungsformulars, und das Modul fragt die offizielle INSEE-Sirene-API ab und füllt das Formular für Sie aus. Schluss mit ungefähren Firmennamen, falsch abgetippten Adressen und von Hand berechneten USt-IdNrn.: Die Daten kommen aktuell und tippfehlerfrei aus dem nationalen Register.

Das ganze Formular in einer Sekunde gefüllt

Allein aus der SIREN füllt das Modul den Firmennamen (und das Kürzel als Alias, wenn vorhanden), die Sitzadresse mit PLZ und Ort, die SIRET des Sitzes, den APE-Code, die Rechtsform und die automatisch berechnete innergemeinschaftliche USt-IdNr. Ein Lupen-Button startet die Suche bei Bedarf; die automatische Suche bei der Eingabe lässt sich in der Konfiguration abschalten. Die Eingabe toleriert Leerzeichen und Formatierung. Bei der Erstellung wird alles gefüllt; bei der Bearbeitung nur leere Felder (eine Einstellung erlaubt das Überschreiben). Bei Einzelunternehmern speist der INSEE-Handelsname den Alternativnamen der Karte.

Bereit für die französische E-Rechnung: Verzeichnis an der Quelle geprüft

Bei jeder Suche prüft das Modul nativ, ob das Unternehmen für elektronische Rechnungen erreichbar ist, über das zentrale Peppol-Verzeichnis (SML/SMP), den offiziellen Maschinenkanal der französischen E-Invoicing-Reform, der alle zugelassenen Plattformen abdeckt: registriert oder nicht, deklarierte Empfangsplattform, Factur-X-Akzeptanz. Ist das Modul EInvoicing aktiv und mit einer zugelassenen Plattform verbunden, wird auch dessen normierter Verzeichnisdienst (AFNOR XP Z12-013) abgefragt und die Routing-Adresse des Partners vorausgefüllt. Widersprechen sich beide Quellen, wird ein einziges Urteil angezeigt — die positive Antwort zählt. Ist das Unternehmen nicht erreichbar, fragt das Speichern der Karte nach einer Bestätigung (abschaltbar).

Ihre Karten bleiben mit der Zeit korrekt

Eine bei der Erstellung korrekte Karte kann still veralten: Sitzverlegung, Rechtsformwechsel, Geschäftsaufgabe, Austrag aus dem E-Invoicing-Verzeichnis. Das Modul führt eine regelmäßige Kontrolle durch: Beim Öffnen einer Karte werden ihre Daten mit dem Sirene-Register und dem Verzeichnis verglichen. Bei Abweichungen listet ein Banner sie präzise auf, mit zwei Buttons: „Karte aktualisieren" mit den INSEE-Daten oder „So bestätigen". Eine konforme oder bestätigte Karte wird 90 Tage lang nicht mehr geprüft (einstellbar).

Nützliche Warnungen, geschontes Kontingent

Das Modul warnt, wenn das Unternehmen verwaltungsseitig erloschen ist oder unter eingeschränkter Veröffentlichung steht, und meldet eine ungewöhnliche SIREN-Prüfziffer, ohne die Eingabe zu blockieren. Antworten werden 30 Tage lokal gecacht, und der Suchendpunkt ist authentifizierten Benutzern mit Leserecht auf Partner vorbehalten. Für ausländische Unternehmen bleibt die native VIES-USt-Prüfung von Dolibarr verfügbar; eine Einstellung beschränkt alle Prüfungen auf französische Partner (standardmäßig aktiv).

In wenigen Minuten einsatzbereit

Sie brauchen einen kostenlosen API-Schlüssel des INSEE-Portals (30 Anfragen/Minute, 2 000/Stunde — mit dem Cache mehr als genug). Die Konfigurationsseite des Moduls enthält eine vollständige Schritt-für-Schritt-Anleitung zur Erstellung dieses Schlüssels, mit „Verbindung testen". Modul aktivieren, Schlüssel einfügen, SIREN eingeben: fertig.

Kompatibilität

Dolibarr v18.0 bis v24, PHP 7.1+. Real getestet auf Dolibarr 18 (PHP 8.1) und Dolibarr 24 (PHP 8.3). Oberfläche und Dokumentation in 5 Sprachen. Lizenz GPL v3.