Prüfen Sie ein Schweizer Unternehmen beim Onboarding in einem Aufruf: Existenz, Rechtsform, Status und Insolvenzmeldungen aus Zefix und dem SHAB, danach als Webhook-Monitoring.
Wer in der Schweiz Geschäftsbeziehungen mit juristischen Personen eingeht, wird früher oder später prüfen müssen, mit wem er es zu tun hat. Für Finanzintermediäre, die dem Geldwäschereigesetz (GwG) unterstehen, gehört dazu die Identifizierung der Vertragspartei und die Einhaltung der Sorgfaltspflichten; in Deutschland sieht das dortige Geldwäschegesetz für Verpflichtete vergleichbare Pflichten vor. Aber auch Fintechs, Marktplätze und Zahlungsanbieter ohne gesetzliche Pflicht wollen vor der Freischaltung wissen, ob die Firma existiert, wie sie heisst, welche Rechtsform sie hat und ob sie noch im Handelsregister steht.
Von Hand heisst das: Zefix öffnen, Firma suchen, Auszug lesen, Ergebnis in das Onboarding-System übertragen, und das für jeden Kunden und später für jede Änderung. Das skaliert nicht, und es fehlt der Nachweis, wann welcher Stand geprüft wurde.
Vier Endpunkte decken den Ablauf ab. Alle Aufrufe tragen den Header Authorization: Bearer rk_live_... (alternativ x-api-key).
GET /companies/search?country=CH&company_number=CHE103867266 findet das Unternehmen anhand der UID. Mit name= suchen Sie nach dem Firmennamen, mit vat= nach der MWST-Nummer.GET /companies/{id} liefert das vollständige Unternehmensobjekt; verwenden Sie die id aus der Suche.GET /company-events/search?country=CH&company_number=CHE103867266 zeigt Registeränderungen.POST /monitor mit {"company_id": ..., "country": "CH"} meldet Änderungen per Webhook.curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=CH&company_number=CHE103867266' \ -H 'Authorization: Bearer rk_live_...'
Die UID dürfen Sie mit oder ohne Punkte und Bindestriche übergeben; die Prüfziffer wird kontrolliert, ein Tippfehler wird mit dem Fehler 400 validation_error abgewiesen. Dasselbe können Sie vorab von Hand in der UID-Suche ausprobieren.
| Feld | Bedeutung |
|---|---|
company_name | Firma, wie im Register eingetragen |
company_number, identifiers | die UID |
status, local_status | standardisierter Status und die Angabe des Registers im Wortlaut |
legal_form, local_legal_form | Rechtsform (z. B. AG, GmbH), standardisiert und im Wortlaut des Registers |
founding_date | Gründungsdatum |
| Adressfelder | Sitzadresse mit Kanton |
vat_number | UID mit dem Zusatz MWST, TVA oder IVA |
Die zugehörigen SHAB-Insolvenzmeldungen holen Sie mit GET /insolvency/search?country=CH&company_number=CHE103867266. Sie sind über die UID verknüpft, sofern die Meldung die UID des Schuldners nennt; eine Meldung ohne UID bleibt unverknüpft. Für die Beurteilung des Kunden können Sie zusätzlich GET /sanctions/screen?name=... aufrufen; das Sanktionsscreening befindet sich in der Beta-Phase.
dissolved). Konkurse sehen Sie in den SHAB-Meldungen.Ein Zahlungsanbieter schaltet Geschäftskunden erst frei, wenn das Unternehmen im Handelsregister steht und aktiv ist. Das Onboarding-System ruft beim Eingang des Antrags die Suche mit der angegebenen UID auf. Stimmt die Firma nicht mit dem Antrag überein oder meldet das Register Liquidation, geht der Fall an die manuelle Prüfung; andernfalls wird der Stand mit Datum im Kundendossier abgelegt. Dieses Dossier belegt später, was zum Zeitpunkt der Aufnahme der Geschäftsbeziehung bekannt war. Das ist keine Rechtsberatung: Welche Pflichten für Sie gelten, klären Sie mit Ihrer Compliance-Stelle oder Ihrer Selbstregulierungsorganisation.
Die Angaben des Antragstellers gleichen Sie mit dem Register ab, sie ersetzen aber nicht die übrigen Schritte Ihres Verfahrens: die Identifizierung der handelnden Personen, die Feststellung der wirtschaftlich berechtigten Person und die Dokumentation Ihrer Risikobeurteilung.
Mit POST /monitor legen Sie ein Unternehmen auf die Beobachtungsliste. Sie erhalten einen Webhook bei Statusänderung, Auflösung, Sanktionstreffer (Beta) und bei Registeränderungs-Ereignissen für die Schweiz, also Änderungen von Firma, Rechtsform und Sitzadresse. So bleibt die Prüfung aktuell, ohne dass Sie den Bestand täglich neu abfragen. Die Schweizer Daten werden an jedem Arbeitstag aktualisiert.
Für Entwicklung und kleine Bestände genügt Starter (9,99 EUR pro Monat, 1 000 Credits). Sobald Sie Webhooks und das Sanktionsscreening (Beta) im Betrieb brauchen, ist Professional (29,99 EUR, 10 000 Credits) der passende Tarif. Die Preise sind öffentlich, bei Jahreszahlung sind zwei Monate gratis: Preise.
Quelle: Zefix, Federal Office of Justice, Federal Commercial Registry Office (open use, source required); restructured by Prometiam, not a certified register extract
14 Tage kostenlos testen · API-Dokumentation
Die Testphase dauert 14 Tage und umfasst 500 Credits. Eine Karte ist erforderlich, während der Testphase wird nichts belastet; danach läuft das Starter-Abo (9,99 EUR pro Monat), sofern Sie nicht kündigen.