Geschäftspartner-API für Anreicherung und ERP-Kundenanlage
Verbinde eigene Anwendungen mit der Firmendaten-Anreicherung. Eine Firmen-E-Mail, Domain oder Website genügt als Startpunkt. Dieselbe API liefert wahlweise JSON oder übernimmt die direkte ERP-Kundenanlage.
Was kann die Geschäftspartner-API?
Die Geschäftspartner-API reichert Firmendaten anhand veröffentlichter Website-Inhalte an und prüft eine vorhandene USt-ID. Ein synchroner Endpunkt bietet zwei Modi: enrich liefert die Firma als JSON; create legt den Datensatz zusätzlich in allen aktiven ERP-Verbindungen der Firma an. Eine erfolglose USt-Prüfung setzt ein Flag und stoppt den Prozess nicht.
Zwei Ergebnisse über eine API-Schnittstelle
Anreichern oder anlegen
Mit enrich kannst du Firmendaten anreichern und in der eigenen Anwendung nutzen. create übernimmt die ERP-Kundenanlage, auch als Interessent oder Lieferant, sofern der Anbieter dies unterstützt. Nach der Anreicherung müssen Firmenname, Domain und eine nicht leere VAT-ID vorhanden sein.
Firmenschlüssel und Nutzerzuordnung
Company- und System-Admins verwalten firmeneigene Schlüssel mit Berechtigung für reine Anreicherung oder zusätzlich ERP-Anlage. Jede echte Anfrage enthält die E-Mail eines bestehenden Firmenbenutzers zur Zuordnung und nutzt das normale Firmenkontingent.
Verbindungsvorgaben und eigene Werte
Die konfigurierten ERP-Payload-Standards bleiben erhalten und werden durch unterstützte Anfragefelder oder verbindungsspezifische Payload-Werte ergänzt. Mitgelieferte Werte bleiben im Anfrageentwurf und überschreiben nicht den gemeinsamen Firmenkatalog.
So funktioniert es
- 1
Schlüssel erstellen
Ein Company- oder System-Admin öffnet API-Schlüssel im Profilmenü und wählt reine Anreicherung oder Zugriff mit ERP-Anlage.
- 2
Demodaten testen
Die API-Dokumentation ist über dasselbe Profilmenü erreichbar. Gültige Demoanfragen liefern ein festes Beispiel ohne Kontingentverbrauch und ohne Website-, USt- oder ERP-Aufrufe.
- 3
Modus wählen
Die eigene Serveranwendung sendet E-Mail, Domain oder Website zusammen mit Firmenschlüssel und zugeordneter Benutzer-E-Mail. Wähle enrich oder create. Die Anlage nutzt alle aktiven Verbindungen und benötigt die ERP-Schreibfreigabe.
- 4
Ergebnis auswerten
Die Antwort enthält die angereicherte Firma, ein USt-Prüfflag und nach erfolgreicher Anlage ERP-Referenzen. Bei Wiederholung einer Anlageanfrage denselben Idempotency-Key beibehalten.
Beispiel: vom Vertriebsformular zum ERP-Interessenten
Eine interne Vertriebsanwendung erhält eine Firmen-E-Mail. Mit enrich zeigt sie die Firmendaten als JSON an. Benötigt der freigegebene Ablauf einen Interessenten im ERP, nutzt sie create mit passendem Datensatztyp und den Payload-Werten der Verbindungen. Bereits zugeordnete Datensätze werden unverändert zurückgegeben und nicht aktualisiert.
Website-Anreicherung ist keine Handelsregisterprüfung. Fehlende Mindestdaten oder mögliche ERP-Dubletten verhindern die Anlage. Verbindungen können teilweise erfolgreich sein; fehlgeschlagene Anfragen liefern sichere Fehlerinformationen. Erfolgte ERP-Schreibzugriffe lassen sich hier nicht zurücknehmen. Diese API bietet keinen allgemeinen Webhook oder Stapelendpunkt.
Häufig gestellte Fragen
Nutzen Anreicherung und ERP-Anlage unterschiedliche Endpunkte?
Welche ERP-Systeme können das API-Ergebnis übernehmen?
Wer verwaltet API-Schlüssel und testet echte Anfragen?
Blockiert eine erfolglose USt-Prüfung die ERP-Anlage?
Welchen Datensatz oder welches System möchten Sie angehen?
Richten Sie den Firmenbereich ein oder beschreiben Sie über Kontakt Ihr ERP und die Aufgabe bei den Stammdaten.