KSIDol-Dokumentation > KSIDol-Module > Partnerkarte per SIREN

Modulanleitung: Partnerkarte per SIREN

Nicht-technische Anleitung: wozu das Modul dient, wie man es benutzt und wie es sich in Dolibarr einfügt.

Eine Eingabe, eine KarteDie SIREN genügt: Firmenname, Adresse, SIRET, APE, Rechtsform, USt-IdNr.

E-RechnungVerzeichnis-Verdikt bei jeder Suche (Peppol und zugelassene Plattform)

Karten unter BeobachtungAbweichungen zum Sirene-Register beim Öffnen der Karte gemeldet

Kontingent geschontINSEE-Antworten 30 Tage lokal gecacht

1. Moduluberblick

SirenCreatTiers beseitigt die manuelle Erfassung französischer Geschäftspartner: 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, um das Formular für Sie auszufüllen. Dabei prüft es, ob das Unternehmen elektronische Rechnungen empfangen kann (zentrales Peppol-Verzeichnis, plus Verzeichnis der zugelassenen Plattform, wenn das EInvoicing-Modul verbunden ist), und überwacht Ihre Karten anschließend dauerhaft: Beim Öffnen einer Karte werden Abweichungen zum Sirene-Register in einem Banner aufgelistet, mit Aktualisierung per Klick.

Automatisches Ausfüllen aus der SIREN: Firmenname (und Kürzel als Alias), Sitzadresse, PLZ, Ort, SIRET des Sitzes, APE-Code, Rechtsform, berechnete innergemeinschaftliche USt-IdNr.
Lupen-Button neben dem SIREN-Feld und automatische Suche, sobald eine gültige SIREN eingegeben ist (abschaltbar).
E-Invoicing-Verzeichnis-Verdikt: Unternehmen erreichbar oder nicht, Empfangsplattform, Factur-X-Akzeptanz.
Regelmäßige Kartenkontrolle: ein Banner listet die Abweichungen, mit den Buttons „Karte aktualisieren“ und „So bestätigen“.
Nützliche Warnungen: erloschenes Unternehmen, eingeschränkte Veröffentlichung, ungewöhnliche SIREN-Prüfziffer.
30 Tage lokaler Cache; Zugriff nur für angemeldete Benutzer mit Leserecht auf Partner.

2. Erste Schritte: der INSEE-API-Schlüssel

Das Modul nutzt die offizielle INSEE-Sirene-API — kostenlos, aber schlüsselgeschützt.

Erstellen Sie einen kostenlosen Schlüssel im INSEE-API-Portal (portail-api.insee.fr): die Konfigurationsseite des Moduls enthält die vollständige Schritt-für-Schritt-Anleitung (Konto, Anwendung, Sirene-API-Abonnement, Schlüsselabruf).
Fügen Sie den Schlüssel in der Modulkonfiguration ein und validieren Sie mit „Verbindung testen“.
Der öffentliche INSEE-Tarif (30 Anfragen/Minute, 2 000 Anfragen/Stunde) reicht völlig: das Modul cacht Antworten 30 Tage lokal.
Modul aktivieren, ein Partner-Erstellungsformular öffnen, eine SIREN eingeben: einsatzbereit.

3. Eine Partnerkarte aus der SIREN erstellen

Im Erstellungsformular beginnt alles beim Feld „Gew. ID 1 (SIREN)“.

SIREN eingeben — Leerzeichen und Formatierung werden toleriert: „938 582 186“ wird akzeptiert und automatisch bereinigt.
Die Suche startet von selbst, sobald 9 gültige Ziffern eingegeben sind (einstellbar), oder manuell über den Lupen-Button.
Das Modul füllt: Firmenname, Kürzel als Alias, Sitzadresse, PLZ, Ort, SIRET des Sitzes (Gew. ID 2), APE-Code (Gew. ID 3), Rechtsform und die berechnete innergemeinschaftliche USt-IdNr.
Bei Einzelunternehmern, deren Firmierung der bürgerliche Name ist, speist der INSEE-Handelsname den Alternativnamen der Karte.
Eine Meldung unter dem Feld bestätigt den Abruf und zeigt das E-Invoicing-Verzeichnis-Verdikt.

4. Eine bestehende Karte vervollständigen

Das Modul arbeitet auch im Bearbeitungsformular, ohne Ihre Arbeit zu überschreiben.

Bei der Bearbeitung werden nur leere Felder ergänzt: bereits Eingegebenes bleibt erhalten.
Eine Einstellung („Felder beim Bearbeiten überschreiben“) lässt die INSEE-Daten stattdessen bestehende Werte ersetzen.
Der Lupen-Button bleibt jederzeit verfügbar, um die Suche erneut zu starten.

5. Das E-Invoicing-Verzeichnis-Verdikt

Bei jeder Suche prüft das Modul, ob das Unternehmen für elektronische Rechnungen erreichbar ist — die Frage, die sich mit der französischen Reform alle stellen werden.

Native Prüfung des zentralen Peppol-Verzeichnisses (SML/SMP), des offiziellen Maschinenkanals der Reform, der alle zugelassenen Plattformen abdeckt: registriert oder nicht, deklarierte Empfangsplattform, Factur-X-Akzeptanz.
Ist das EInvoicing-Modul aktiv und mit einer zugelassenen Plattform verbunden, wird auch dessen normierter Verzeichnisdienst (AFNOR XP Z12-013) abgefragt und die Routing-Adresse des Partners im Erstellungsformular vorausgefüllt.
Es wird ein einziges Verdikt angezeigt: widersprechen sich die Quellen, zählt die positive Antwort (eine Plattform kann ein tatsächlich registriertes Unternehmen übersehen).
Ist das Unternehmen nicht erreichbar, fragt das Speichern der Karte nach einer Bestätigung — eine einfache Leitplanke, in der Konfiguration abschaltbar.

6. Die regelmäßige Kartenkontrolle

Eine bei der Erstellung korrekte Karte kann still veralten: Umzug, Rechtsformwechsel, Geschäftsaufgabe. Das Modul beobachtet, ohne etwas zu erzwingen.

Beim Öffnen einer Partnerkarte werden ihre Daten mit dem Sirene-Register und dem E-Invoicing-Verzeichnis verglichen.
Bei Abweichungen listet ein Banner sie präzise auf, Feld für Feld (Kartenwert gegen INSEE-Wert).
„Karte mit den INSEE-Daten aktualisieren“ übernimmt die Korrekturen per Klick; „Karte so bestätigen“ behält Ihre Werte.
Eine konforme oder bestätigte Karte wird 90 Tage nicht mehr geprüft (einstellbar); die Kontrolle lässt sich ganz abschalten.

7. Warnungen und Sonderfälle

Das Modul meldet, ohne zu blockieren: Sie entscheiden immer.

Verwaltungsseitig erloschenes Unternehmen: eine Warnung erscheint, die Karte bleibt erstellbar (nützlich für Historie oder Streitfälle).
Unternehmen mit eingeschränkter Veröffentlichung im Sirene-Register: das Modul informiert Sie; manche Daten können fehlen.
Ungewöhnliche SIREN-Prüfziffer: nur eine Warnung, die Eingabe wird nie blockiert (völlig legitime Nummern verletzen die Regel — etwa La Poste).
Dem Register unbekannte SIREN: klare Meldung, nichts wird ausgefüllt.

8. Die Moduleinstellungen

Alles wird über die Konfigurationsseite gesteuert, ohne Code anzufassen.

INSEE-API-Schlüssel, mit „Verbindung testen“ und integrierter Erstellungsanleitung.
Automatische Suche bei der Eingabe: standardmäßig aktiv, abschaltbar (der Lupen-Button bleibt).
Felder beim Bearbeiten überschreiben: standardmäßig aus.
E-Invoicing-Verzeichnisprüfung: standardmäßig aktiv.
Bestätigung beim Speichern, wenn das Unternehmen nicht erreichbar ist: standardmäßig aktiv.
Regelmäßige Kartenkontrolle und Gültigkeitsdauer (standardmäßig 90 Tage).
Prüfungen auf französische Partner beschränken: standardmäßig aktiv — für ausländische Unternehmen bleibt die native VIES-USt-Prüfung von Dolibarr das richtige Werkzeug.

9. Verknupfungen mit Dolibarr

Das Modul arbeitet nicht isoliert: Es ist mit den nativen Bausteinen von Dolibarr verzahnt.

Geschäftspartner : Das Modul arbeitet direkt im nativen Erstellungs- und Bearbeitungsformular der Partner: kein Parallelbildschirm, die ausgefüllten Daten sind die der Standard-Dolibarr-Karte.
Gewerbliche Kennungen : Die nativen Felder Gew. ID 1 (SIREN), Gew. ID 2 (SIRET) und Gew. ID 3 (APE) werden unverändert genutzt, ebenso Rechtsform und innergemeinschaftliche USt-IdNr. der Karte.
Modul EInvoicing (elektronische Rechnung) : Ist EInvoicing aktiv und mit einer zugelassenen Plattform verbunden, wird dessen normiertes Verzeichnis zusätzlich zum zentralen Peppol-Verzeichnis abgefragt und die E-Invoicing-Routing-Adresse des Partners vorausgefüllt. Ohne EInvoicing arbeitet das Modul vollständig über den nativen Peppol-Kanal.
Native VIES-USt-Prüfung : Für nicht-französische Unternehmen bleibt der native VIES-Prüfbutton von Dolibarr neben dem USt-IdNr.-Feld das Referenzwerkzeug — das Modul ersetzt ihn nicht.
Benutzerrechte : Die Suche ist angemeldeten Benutzern mit Leserecht auf Partner vorbehalten; ohne Anmeldung sind keine Daten erreichbar.