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“.
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.
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.
Cookies
KSIDol verwendet notwendige Cookies für Warenkorb, Anmeldung und Zahlung. Nicht notwendige Cookies bleiben deaktiviert, bis Sie zustimmen.
Guten Tag, ich bin KSIAssistantIA, der in Ihre Verwaltungssoftware integrierte Assistent. Ich kann Ihnen zum Beispiel eine Zusammenfassung der Lage Ihres Unternehmens geben. Möchten Sie sehen, was ich kann?