Eine KYB API ist eine technische Schnittstelle, mit der Unternehmen Geschäftspartnerdaten, Bonitätsbewertung, Risikosignale, Monitoring und Dokumentation direkt in ERP, CRM, B2B-Shop oder interne Freigabeprozesse integrieren können. Sie ersetzt keine allgemeine KYB-Erklärung und keine Rechtsberatung, sondern macht strukturierte Prüfungen maschinenlesbar und entscheidungsfähig.
Die Seite /kyb-api/ beschreibt die technische Schnittstelle: Anfrage, Unternehmensidentifikation, Bonitätsbewertung, Risikosignale, Entscheidung, Monitoring und Dokumentation. Eine spätere allgemeine KYB-Erklärseite kann das Thema Know Your Business fachlich breiter erklären; diese API-Seite bleibt auf Integration, Datenfluss und Prozessentscheidung fokussiert.
- Eine KYB API sollte nicht nur Daten liefern, sondern Freigaben, Limits, Rechnungskauf und manuelle Prüfungen im Prozess unterstützen.
- Typische Systeme sind ERP, CRM, B2B-Shop, Pipedrive, HubSpot, SAP, Microsoft Dynamics, Shopware, Shopify B2B und WooCommerce.
- Wenn ein Ergebnis eindeutig ist, kann eine Regelentscheidung erfolgen. Wenn Daten fehlen oder Risikosignale auftreten, sollte manuell geprüft werden.
- Boniforce kann technische Entscheidungsunterstützung leisten, ohne vollständige AML-Compliance oder Rechtsberatung zu versprechen.
Was leistet eine KYB API im B2B-Prozess?
Eine KYB API verbindet die Prüfung eines Unternehmens mit den Systemen, in denen operative Entscheidungen entstehen. Vertrieb arbeitet im CRM, Finance prüft Kreditlimit und Zahlungsziel, E-Commerce steuert Rechnungskauf im Checkout, IT verantwortet die Integration und Geschäftsführung braucht nachvollziehbare Regeln.
Wenn ein neuer Geschäftskunde angelegt wird, kann die API Stammdaten und Bonitätsinformationen anfordern. Wenn ein B2B-Shop Rechnungskauf anbietet, kann die Schnittstelle vor Freigabe ein Risikosignal liefern. Wenn ein Bestandskunde ein höheres Limit benötigt, kann die API einen Re-Check oder Monitoring-Status einbeziehen.
Für den übergeordneten Prozess ist die Seite Geschäftspartner prüfen relevant. Welche Daten und Nachweise in der Prüfung eine Rolle spielen, erklärt die Boniforce Datenübersicht.
Technische Prozesslogik: Von der Anfrage zur Entscheidung
Der technische Wert einer KYB API liegt in der wiederholbaren Prozesslogik. Sie sollte klar definieren, welche Anfrage gestellt wird, welche Daten zurückkommen und welche Entscheidung daraus folgt.
- Anfrage: System übermittelt Firmenname, Adresse, Registerdaten oder andere Identifikatoren.
- Unternehmensidentifikation: Passende Gesellschaft wird zugeordnet; Dubletten oder unklare Treffer werden markiert.
- Bonitätsbewertung: Score, Ampel, Negativsignale oder Limit-Orientierung werden bereitgestellt.
- Risikosignale: Relevante Auffälligkeiten, Datenlücken oder Statussignale werden sichtbar.
- Entscheidung: Freigabe, Limit, Vorkasse, manuelle Prüfung oder Ablehnung wird regelbasiert unterstützt.
- Monitoring: Bei Bestandskunden können Veränderungen nach der Erstprüfung relevant werden.
- Dokumentation: Ergebnis, Zeitpunkt und Datenbasis werden nachvollziehbar abgelegt.
Eine API-Integration sollte immer mit Entscheidungsregeln geplant werden. Ohne klare Schwellenwerte entsteht nur ein Datenabruf; mit klaren Regeln entsteht ein nutzbarer Freigabeprozess.
API-Datenfeld, Bedeutung und mögliche Entscheidung
Die konkreten Felder hängen von Produktumfang, Datenquelle und Integration ab. Die folgende Tabelle beschreibt deshalb bewusst typische Datenlogik, nicht eine garantierte vollständige Feldliste.
| API-Datenfeld | Bedeutung | Mögliche Entscheidung |
|---|---|---|
| company_match | Eindeutigkeit der Unternehmenszuordnung | Freigabe nur bei eindeutiger Identifikation |
| company_status | Aktiver, auffälliger oder unklarer Unternehmensstatus | Manuelle Prüfung bei unklarem Status |
| credit_score | Bonitätsbewertung oder Risikoklasse | Kreditlimit, Zahlungsziel oder Vorkasse ableiten |
| risk_signal | Warnhinweis, Datenlücke oder auffällige Veränderung | Eskalation an Finance oder Compliance |
| recommended_limit | Orientierung für vertretbares Exposure | Limit setzen, erhöhen, reduzieren oder blockieren |
| monitoring_status | Information, ob laufende Überwachung aktiv oder relevant ist | Re-Check oder automatische Benachrichtigung auslösen |
| checked_at | Prüfdatum und Zeitstempel | Nachvollziehbarkeit und Audit-Trail sichern |
Wann manuell prüfen, wann API nutzen?
Eine API ist besonders stark bei wiederkehrenden, regelbaren Entscheidungen. Manuelle Prüfung bleibt wichtig, wenn Daten widersprüchlich, rechtlich sensibel oder wirtschaftlich ungewöhnlich sind.
| Situation | API geeignet? | Manuelle Prüfung? | Begründung |
|---|---|---|---|
| Standard-Neukunde mit kleinem Limit | Ja | Nur bei Warnsignal | Regelbare Freigabe mit dokumentiertem Ergebnis |
| B2B-Shop Checkout mit Rechnungskauf | Ja | Bei gelbem oder rotem Signal | Schnelle Zahlungsartensteuerung nötig |
| Hohes Kreditlimit oder strategischer Partner | Als Vorprüfung | Ja | Entscheidung hat hohe wirtschaftliche Wirkung |
| Komplexe Eigentümerstruktur oder Auslandsbezug | Als Datenbasis | Ja | KYB-, UBO- oder Compliance-Fragen brauchen Kontext |
| Bestandskunde mit Risikoveränderung | Ja, mit Monitoring | Bei relevanter Verschlechterung | Limit, Zahlungsziel oder Lieferfreigabe können betroffen sein |
Integration in ERP, CRM und B2B-Shop
Eine KYB API sollte dort wirken, wo Teams Entscheidungen treffen. Im CRM geht es um Lead- und Kundenfreigabe, etwa in Pipedrive oder HubSpot. Im ERP geht es um Debitorenanlage, Kreditlimit und Zahlungsbedingungen, etwa in SAP oder Microsoft Dynamics. Im B2B-Shop geht es um Checkout-Regeln, Rechnungskauf und Bestellfreigabe, etwa in Shopware, Shopify B2B oder WooCommerce.
Vertrieb und CRM
Sales sieht schneller, ob ein neuer Geschäftskunde grundsätzlich freigegeben werden kann oder Finance prüfen muss.
Finance und ERP
Finance kann Zahlungsziel, Kreditlimit und Debitorenfreigabe stärker an Bonitäts- und Risikosignale koppeln.
E-Commerce und Checkout
Der B2B-Shop kann Rechnungskauf, Vorkasse oder manuelle Prüfung risikobasiert steuern.
Monitoring und Dokumentation per API
Eine technische KYB-Prüfung ist nicht abgeschlossen, sobald ein Datensatz zurückkommt. Für wiederkehrende Geschäftspartner sind Monitoring und Dokumentation entscheidend. Das Bonitätsmonitoring hilft, Veränderungen im Bestand zu erkennen. Die Dokumentation zeigt später, welche Daten zum Entscheidungszeitpunkt vorlagen.
Wenn Monitoring eine Verschlechterung zeigt, kann die API einen Re-Check oder eine manuelle Eskalation unterstützen. Wenn die Entscheidung automatisiert erfolgt, sollte der Zeitpunkt der Prüfung dokumentiert werden. Wenn ein Prüfbericht intern benötigt wird, muss er die Entscheidungsgrundlage nachvollziehbar machen.
Boniforce-Einordnung: API heißt Entscheidungsunterstützung, nicht nur Datenabruf
Eine gute KYB API sollte nicht nur Unternehmensdaten ausgeben. Sie sollte Teams helfen, aus Daten eine Entscheidung zu machen: freigeben, Kreditlimit setzen, Rechnungskauf erlauben, manuell prüfen, überwachen oder ablehnen.
Boniforce ist besonders sinnvoll, wenn Vertrieb, Finance, E-Commerce, IT und Geschäftsführung wiederkehrende B2B-Prüfungen einheitlich abbilden wollen. Eine manuelle Prüfung kann ausreichen, wenn nur wenige Fälle auftreten. Eine API wird wertvoll, wenn Prüfungen häufig, zeitkritisch oder systemübergreifend sind.
Für die Entscheidungslogik passen die Vertiefungen Kreditentscheidung automatisieren, Kreditlimit automatisieren und Rechnungskauf absichern.
KYB-, UBO-, Sanktions- oder AML-nahe Signale sollten immer kontextabhängig bewertet werden. Boniforce kann strukturierte Prüfung und Dokumentation unterstützen, ersetzt aber keine Rechtsberatung und keine finale Compliance-Entscheidung.
Häufige Fragen zur KYB API
Ist eine KYB API dasselbe wie eine allgemeine KYB-Erklärung?
Nein. Eine KYB API ist die technische Schnittstelle für Daten, Prüfung und Prozessentscheidung. Eine allgemeine KYB-Erklärung behandelt das Konzept fachlich breiter.
Welche Systeme können eine KYB API nutzen?
Typisch sind ERP, CRM, B2B-Shops, Pipedrive, HubSpot, SAP, Microsoft Dynamics, Shopware, Shopify B2B und WooCommerce.
Kann eine API automatisch entscheiden?
Sie kann Regelentscheidungen unterstützen. Bei unklaren Daten, hohem Risiko oder Compliance-Fragen sollte manuell geprüft werden.
Welche Rolle spielt Monitoring?
Monitoring hilft, nach der Erstprüfung relevante Veränderungen zu erkennen und daraus Re-Checks, Limitänderungen oder Eskalationen abzuleiten.
Garantiert eine KYB API AML-Compliance?
Nein. Eine API kann Daten und Prozesse unterstützen, garantiert aber keine vollständige AML-Compliance und ersetzt keine Rechtsberatung.
Eine KYB API ist dann wertvoll, wenn sie Unternehmensdaten nicht nur liefert, sondern in Freigabe, Kreditlimit, Monitoring und Dokumentation übersetzt.
KYB-Prüfung technisch in B2B-Prozesse integrieren
Boniforce unterstützt Teams dabei, Geschäftspartnerdaten, Bonität und Risikosignale in CRM, ERP und B2B-Shop nutzbar zu machen.

