Gravity Forms SIRET-Feld – Validieren Sie französische Unternehmen anhand des INSEE-Sirene-Registers
Verifizieren Sie französische Unternehmen direkt in Ihren Gravity-Formularen – SIRET- und SIREN-Nummern werden mit dem offiziellen INSEE-Sirene-Register abgeglichen, wobei der Firmenname, die Rechtsform, der Aktivitätscode und die vollständige Adresse mit zurückkommen. Echte serverseitige Validierung, ein integrierter 35-Tage-Cache und eine wiederverwendbare Suchbibliothek für Entwickler. Kein Composer, keine externen Bibliotheken, keine monatlichen Gebühren.
Ganz gleich, ob Sie B2B-Onboarding, E-Rechnungseingang, Reseller-Registrierung oder ein beliebiges Formular zur Erfassung einer französischen Unternehmensnummer durchführen, dieses Add-on stellt sicher, dass der von Ihnen gespeicherte Wert ein Wert ist real, existierend Unternehmen – nicht nur vierzehn Ziffern, die plausibel erscheinen. Und anstatt nur „gültig“ zu sagen, werden Ihnen die Registerdaten des Unternehmens angezeigt.
Warum Sie es lieben werden
- ✅ Echte Validierung, nicht nur ein regulärer Ausdruck. Länge und die Luhn Prüfziffern werden auf dem Server verifiziert – inklusive Dokumentation La Poste Ausnahme – bevor ein Netzwerkanruf getätigt wird.
- Offizielle Registersuche. Bestätigt die Nummer anhand der
INSEE Sirene API v3.11das maßgebliche französische Unternehmensregister. - Sie bekommen die Gesellschaft, nicht nur ein Ja. Firmenname, Handelsname, Rechtsform, APE/NAF-Aktivitätscode, Unternehmenskategorie, Gründungsdatum, Flagge des Hauptsitzes, Verwaltungsstatus und die vollständige Adresse.
- ⚡ Integrierter 35-Tage-Cache. Wiederholte Übermittlungen derselben Nummer kosten nie einen API-Aufruf – und ein veralteter Cache-Eintrag dient sogar als Ausweichmöglichkeit, wenn INSEE nicht erreichbar ist.
- ️ Verliert nie eine Einreichung aufgrund eines Ausfalls. Nur eine definitive nicht im Register Blöcke. Ein fehlender Schlüssel, eine Ratenbegrenzung, eine Zeitüberschreitung oder ein Serverfehler können niemals dazu führen, dass ein legitimer Kunde abgelehnt wird.
- ⌨️ Input, der sich richtig anfühlt. Die Zahl wird in Blöcken genau so eingegeben, wie sie gedruckt wird – 123 456 789 00012 — mit automatischem Vorlauf und automatischer Pastenteilung.
- Entwicklerfreundlich. Bietet eine eigenständige, von Gravity-Forms unabhängige und wiederverwendbare Suchbibliothek Sirene Und Siret Einstellungs-API Feldtypen.
- Übersetzungsbereit. Englisch, Deutsch und Französisch enthalten, vollständig internationalisiert – so kann das Formular die Sprache der Unternehmen sprechen, die es validiert.
Hauptmerkmale
Ein spezielles SIRET/SIREN-Formularfeld
- Drag-and-Drop-Feld im Formulareditor, gruppiert unter Felder für die elektronische Rechnungsstellung.
- Ein feldspezifischer Selektor für den Bezeichnertyp: SIRET (14 Ziffern, Einrichtung) oder
SIRENE (9 Ziffern, gesetzliche Einheit) – das Eingabelayout folgt automatisch. - Gruppierter Blockeingang: 123 456 789 00012 (3·3·3·5) für ein SIRET, 123 456 789
(3·3·3) für eine SIRENE. Der Fokus rückt vor, wenn ein Block voll ist, die Rücktaste geht zurück und durch Einfügen einer vollständigen Zahl wird diese auf die Blöcke verteilt. - Nur gespeicherte Ziffern, in der Eintragsdetailansicht und in Exporten noch einmal gruppiert angezeigt.
Robuste, mehrschichtige Validierung (serverseitig)
- Lokale Prüfsumme — richtige Länge für den konfigurierten Typ plus
Luhn Prüfziffer, einschließlich der La Poste Ausnahme. Ein Tippfehler wird sofort erkannt, ohne dass eine einzige Netzwerkanfrage erforderlich ist. - Online-Suche — Die Nummer wird gegen die bestätigt
INSEE Sirene API Verwenden Sie Ihren aktuellen API-Schlüssel
portail-api.insee.fr Portal.
Robustheit zuerst: nur eine definitive nicht im Register (HTTP 404) blockiert jemals eine Übermittlung. Ein fehlender oder abgelehnter Schlüssel, eine Ratenbegrenzung, ein Timeout oder ein Serverfehler werden als gemeldet
nicht verfügbar – und der lokal durch die Prüfsumme validierte Wert wird akzeptiert.
Die Unternehmensdaten sind im Lieferumfang enthalten
Eine bestätigte Suche gibt einen vollständigen, normalisierten Datensatz zurück:
- Firmenname (oder der Name der Person bei einem Einzelunternehmer) und der Handelsname (enseigne).
- Rechtskategorie, APE / NAF Aktivitätscode und Unternehmenskategorie (PME / ETI / GE).
- Gründungsdatum, Flagge des Hauptsitzes und Verwaltungsstatus sowohl der rechtlichen Einheit als auch der Niederlassung.
- Die vollständige Adresse der Einrichtung – Hausnummer, Straßentyp, Straßenname, Postleitzahl, Stadt und INSEE-Gemeindecode.
- Die vollständige JSON-Rohantwort, die zum Debuggen und späteren erneuten Parsen aufbewahrt wird.
Optionale Regel „muss aktiv sein“.
Entscheiden Sie, ob ein Unternehmen existiert, aber administrativ ist aufgehört (rechtliche Einheit) oder
geschlossen (Einrichtung) als ungültig gilt, oder ob ein Registertreffer gut genug ist. Ein Kontrollkästchen in den Einstellungen.
Ein Cache, der sich bezahlt macht
- Jeder bestätigte Datensatz wird gespeichert 35 Tagesodass dieselbe Nummer nie zweimal nachgeschlagen wird – hilfreich bei INSEEs 30-Anfragen-pro-Minute-Limit.
- Die Tabelle wird automatisch erstellt und aktuell gehalten; Zur manuellen Einrichtung oder Überprüfung ist eine einfache SQL-Datei enthalten.
- Auswählbare Cache-Tabelle: Verwenden Sie die eigene Tabelle des Plugins, teilen Sie eine vorhandene schemakompatible Tabelle mit anderen Add-Ons oder schalten Sie den Datenbank-Cache vollständig aus.
Optionaler Gravity Forms-Spiegel
Schreiben Sie die Registerdaten über das in ein Gravity Forms-Formular GFAPI — ein Eintrag pro Unternehmen, der bei der Aktualisierung des Datensatzes an Ort und Stelle aktualisiert wird. Sie erhalten eine durchsuchbare, durchsuchbare und exportierbare Kopie von allem, was das Add-on jemals nachgeschlagen hat. A Formular zum Importieren bereit ist enthalten, aufgebaut mit dem Plugin-eigenen SIRET-Feld für die Identifikatoren, a Datum Feld für das Gründungsdatum und ein Adresse Feld für die Adresse.
Wiederverwendbare Suchbibliothek (für Entwickler)
Die gesamte Engine – Luhn-Prüfungen, der INSEE-Aufruf, der Cache, der GFAPI-Spiegel – lebt in einer eigenständigen Klasse mit Keine starke Abhängigkeit von Gravity Formssodass jedes Ihrer Plugins es verwenden kann:
$insee = ( new SP_INSEE_Validator() )
->set_api_key( 'YOUR-KEY' )
->set_require_active( false )
->set_db_table( $wpdb->prefix . 'sp_insee_cache' );
$result = $insee->check_siret( '67205008502051' );
// $result['status'] => 'valid' | 'invalid' | 'unavailable'
// $result['record'] => name, address, APE code, founding date, ...
Wiederverwendbare Einstellungs-API-Felder (Sirene/Siret)
Verwenden Sie im Inneren dieselbe Validierung beliebig Plugin- oder Feed-Einstellungen des Add-ons:
$fields[] = array(
'name' => 'company_siret',
'type' => 'siret', // or 'siren'
'label' => __( 'Company SIRET', 'your-textdomain' ),
'class' => 'medium',
);
Gut zu wissen: SIREN, SIRET und NIC
- SIRENE (9 Ziffern) identifiziert die rechtliche Einheit – das Unternehmen selbst.
- NIC (5 Ziffern) ist das Niederlassungssuffix innerhalb dieses Unternehmens.
- SIRET (14 Ziffern) identifiziert einen Gründung und ist immer
SIRENE + NIC.
Beide tragen eine Luhn-Prüfziffer – genau aus diesem Grund kann dieses Add-on einen Tippfehler abweisen, bevor er jemals das Netzwerk berührt.
Was ist enthalten
- Das Plugin: SIRET / SIREN-Formularfeld, wiederverwendbar Sirene / Siret Einstellungs-API-Felder und die Seite mit den freigegebenen Einstellungen.
- Der Standalone SP_INSEE_Validator Suchbibliothek (Luhn + INSEE + Cache + GFAPI).
- Ein importfertiges Gravity Forms Antwortformular für die Registerdaten.
- Eine Ebene SQL-Datei für die Cache-Tabelle.
- Englisch, Deutsch und Französisch Übersetzungen (.po / .Mo /
.Pot). - Vollständige Dokumentation in Englisch und Deutsch (README + Funktionsübersicht).
- Sauberer, stark kommentierter, objektorientierter Code – einfach zu lesen, zu erweitern und zu prüfen.
Anforderungen & Kompatibilität
- WordPress mit Schwerkraftformen ≥ 2,5
- PHP ≥ 7.4 (mit dem Standard json Verlängerung)
- Ein INSEE Sirene API-Schlüssel – frei, von portail-api.insee.fr. Ohne Schlüssel funktioniert die lokale Prüfsummenvalidierung weiterhin und blockiert niemals eine Übermittlung.
- Funktioniert neben dem Begleiter Gravity Forms-Feld für die Umsatzsteuer-ID Und
SEPA-Felder Add-ons – sie teilen sich ohne Konflikte die gleiche Gruppe „E-Invoicing-Felder“ und die gleiche Einstellungsseite. - Voll Protokollierung von Gravity Forms Unterstützung (Formulare → Einstellungen → Protokollierung), sodass jede fehlgeschlagene Suche leicht nachverfolgt werden kann.
Datenschutz / DSGVO
Wenn die Online-Suche aktiviert ist, wird die übermittelte SIREN/SIRET an die übermittelt Französisches Nationales Institut für Statistik und Wirtschaftsstudien (INSEE) zur Überprüfung. Bei den zurückgegebenen Registerdaten handelt es sich um öffentliche Registerinformationen, die lokal zwischengespeichert werden, sodass für wiederholte Suchvorgänge kein neuer API-Aufruf erforderlich ist. Beachten Sie, dass für a Einzelunternehmer Bei den Registerdaten handelt es sich um personenbezogene Daten (der Name ist der Name der Person und die registrierte Adresse kann eine Privatadresse sein). Erwähnen Sie die INSEE-Suche in der Datenschutzrichtlinie Ihrer Website, sofern erforderlich.
Support und Updates
Sauberer, gut dokumentierter Code, der leicht zu warten ist. Sofort einsatzbereit für die Lokalisierung. Entwickelt, um dem offiziellen Add-on-Framework und den Settings-API-Konventionen von Gravity Forms zu folgen, damit es kompatibel bleibt, während sich Ihr Stack weiterentwickelt.
Änderungsprotokoll
1.0.0
- Formularfeld SIRET / SIREN in der Gruppe „Felder für die elektronische Rechnungsstellung“, mit einem Identifikatortyp-Selektor pro Feld und gruppierter Blockeingabe einschließlich Einfügeaufteilung.
- Zweistufige Validierung: lokale Luhn-Prüfsumme (inkl. der La Poste Ausnahme) gefolgt von einer Online-Suche nach INSEE Sirene API v3.11.
- Wiederverwendbare, abhängigkeitsfreie Suchbibliothek mit einem 35-Tage-Cache in einer selbstverwalteten Datenbanktabelle und/oder einem Gravity Forms-Formular (geschrieben über die GFAPI).
- Zurückgegebene und zwischengespeicherte Registerdaten: Name, Handelsname, Rechtsform, APE/NAF-Code, Unternehmenskategorie, Gründungsdatum, Verwaltungsstatus, Flagge des Hauptsitzes und vollständige Adresse.
- Auswählbare Cache-Tabelle (eigene Tabelle, eine vorhandene schemakompatible Tabelle oder kein Datenbankcache).
- Importierbares Antwortformular Verwendung des Plugin-eigenen SIRET-Feldes, eines Datumsfeldes für das Gründungsdatum und eines Adressfeldes für die Adresse.
- Wiederverwendbar Sirene Und Siret Feldtypen der Einstellungs-API.
- Optional „muss aktiv sein“ Regel; Ein nicht verfügbarer Dienst blockiert niemals eine Übermittlung.
- Unterstützung für die Protokollierung von Gravity Forms; Englische, deutsche und französische Übersetzungen.
Bewertung: 0
Verkäufe bisher: 0
Be the first to leave a review.
