Zefix & Handelsregister

buzzle Commerce Core bindet das Zentrale Firmenindex Zefix als amtliche Quelle für Schweizer Unternehmensdaten an. Beim Erfassen oder Prüfen einer Company können Unternehmen direkt im Handelsregister gesucht, eindeutig identifiziert und mit verlässlichen Registerdaten in die Plattform übernommen werden.

Die kurze Antwort

Die Zefix-Integration unterstützt Company-Onboarding und Stammdatenqualität: Statt Firmenname, Rechtsform, UID und Adresse vollständig von Hand zu erfassen, sucht ein Benutzer das Unternehmen im Handelsregister und übernimmt den passenden Eintrag als Grundlage der Company.

Typischer Ablauf

1. Ein Benutzer erfasst den Namen eines Schweizer Unternehmens.
2. buzzle sucht passende Unternehmen über die Zefix-Schnittstelle.
3. Standardmässig werden aktive Unternehmen angezeigt; inaktive Einträge können bei Bedarf einbezogen werden.
4. Der Benutzer wählt den eindeutigen Registereintrag aus.
5. Die Plattform lädt die vollständigen Firmendetails über die UID.
6. Relevante Angaben werden auf das Company-Modell abgebildet.
7. Die zugrunde liegenden Registerdaten können zusammen mit Abrufzeitpunkt und Quelle nachvollziehbar zur Company gespeichert werden.

Bewusste Auswahl statt unsichtbarer Überschreibung

Die Integration liefert amtliche Daten als Grundlage für Erfassung und Abgleich. Welche Felder übernommen oder aktualisiert werden, wird über den Company-Konverter und den jeweiligen Prozess festgelegt. Projektspezifische Geschäftsdaten werden nicht ungeprüft durch Registerwerte ersetzt.

Suche nach Firmenname

Die Registry-of-Commerce-Schnittstelle unterstützt eine Namenssuche. Die Treffer liefern eine kompakte, einheitliche Sicht auf die gefundenen Unternehmen, unter anderem:

• Firmenname,
• UID,
• Firmensitz,
• Unternehmensstatus,
• Rechtsform,
• Link zum offiziellen Registereintrag.

Falls eine Suche zu viele Resultate liefert, gibt die Plattform einen strukturierten Validierungshinweis zurück. Benutzer können den Suchbegriff anschliessend präzisieren, statt mit einer unübersichtlichen Trefferliste weiterzuarbeiten.

Eindeutiger Abruf über UID

Nach der Auswahl wird das Unternehmen über seine Unternehmens-Identifikationsnummer (UID) eindeutig abgerufen. Dieser Detailabruf liefert sowohl ein für buzzle aufbereitetes Company-Modell als auch die Registerdetails und – wo erforderlich – die ursprüngliche Antwort des Registers.

Damit bleiben zwei Perspektiven verfügbar:

• eine stabile, anwendungsfreundliche Sicht für das Commerce-Domänenmodell,
• die vollständige registerbezogene Sicht für Anzeige, Prüfung oder spätere Erweiterungen.

Übernehmbare Company-Daten

Der mitgelieferte Zefix-Konverter kann unter anderem folgende Angaben in eine Company überführen:

Zefix-Angabe	Verwendung in buzzle Commerce Core
Firmenname	Name und rechtlicher Name der Company
UID	Eindeutige Schweizer Unternehmensidentifikation
CH-ID	Handelsregisteridentifikation und Registernummer
EHRA-ID	Technischer Schlüssel des Eidgenössischen Amts für das Handelsregister
Rechtsform	Normalisierte Rechtsform der Company
Firmensitz	Ort und Land des Unternehmens
Adresse	Strasse, Hausnummer, Postleitzahl und Ort
UID-Zusatz	Ableitung einer Schweizer Mehrwertsteuernummer, wo anwendbar
Registerlink	Direkter, sprachabhängiger Verweis auf den offiziellen Zefix-Eintrag

Der Konverter ist erweiterbar. Eine Lösung kann zusätzliche Zefix-Angaben übernehmen oder die Zuordnung an ihr eigenes Company-Modell anpassen.

Registerdetails und Historie

Über die reinen Stammdaten hinaus kann Zefix weitere Informationen bereitstellen:

• aktueller Unternehmensstatus,
• frühere Firmennamen,
• Hauptsitze und weitere Hauptsitze,
• Zweigniederlassungen,
• übernommene Unternehmen und Nachfolgebeziehungen,
• Revisionsstellen,
• SHAB-Publikationen,
• normalisierte Mutationstypen,
• Links zu Register- und Publikationsdetails.

Die Plattform normalisiert diese Angaben in ein registerunabhängiges Detailmodell. Dadurch kann eine Benutzeroberfläche Handelsregisterinformationen darstellen, ohne das rohe Zefix-Datenformat selbst interpretieren zu müssen.

CompanyRegistryEntry: Quelle und Zeitpunkt festhalten

Eine Company kann mit einem CompanyRegistryEntry verbunden werden. Dieser Eintrag hält fest:

• zu welcher Company die Registerinformation gehört,
• aus welchem Register sie stammt,
• welche externe Register-ID verwendet wurde,
• wann die Daten abgerufen wurden,
• welche Registerdaten beim Abruf vorlagen.

Damit ist nicht nur der aktuelle Company-Datensatz sichtbar, sondern auch seine amtliche Quelle und der Zeitpunkt des Abgleichs.

Geschäftlicher Nutzen

• Schnelleres Onboarding: Weniger manuelle Eingabe beim Erfassen von Geschäftskunden.
• Weniger Dubletten: UID und Registeridentifikatoren helfen, Firmen eindeutig zu erkennen.
• Bessere Stammdaten: Rechtlicher Name, Sitz, Rechtsform und Adresse stammen aus einer amtlichen Quelle.
• Sicherere B2B-Prozesse: Status und Registerinformationen können in Prüfung und Freigabe einfliessen.
• Nachvollziehbare Herkunft: Quelle, externe ID und Abrufzeitpunkt bleiben mit der Company verbunden.
• Schweizer Differenzierung: Die Integration ist auf das Schweizer Firmen- und Handelsregister ausgerichtet.

Zusammenspiel der Module

Die Funktion verbindet mehrere Plattformbereiche:

• Unternehmen & Personen liefert das fachliche Company-Modell.
• Das Business-Modul verwaltet Company und CompanyRegistryEntry.
• Das DataBridge-Modul stellt die Registry-of-Commerce-Abstraktion, Zefix-Anbindung und Konvertierung bereit.
• Workflows und Hintergrundjobs können weitergehende Prüf- oder Aktualisierungsprozesse orchestrieren, wenn eine Lösung dies vorsieht.

Zefix ist der mitgelieferte Schweizer Provider. Die Registry-of-Commerce-Abstraktion ist so aufgebaut, dass weitere Unternehmensregister über denselben Vertrag angebunden werden können.