Verbindung einrichten

Damit TOPIX ERP mit nexcore verbunden werden kann, muss die Verbindung einmalig über die vorhandene REST-API eingerichtet werden.

Die Integration ermöglicht einen automatisierten Datenaustausch zwischen beiden Systemen.

---

Voraussetzungen

System	Beschreibung
TOPIX (API)	Aktiver TOPIX-Client (Cloud oder On-Premise) und Nutzerzugriff auf die Einstellungen.
TOPIX (Webhooks)	TOPIX-Client (Cloud): Erfrage die valide Webhook-URL bei Deinem TOPIX-Berater. TOPIX-Client (On-Premise): Erstellung einer validen Webhook-URL von Deinem Administrator zusammen mit Deinem TOPIX-Berater. Wichtig: die URL muss über das Internet erreichbar sein und über ein gültiges SSL-Zertifikat verfügen.
nexcore	Aktive nexcore Tenant und Nutzerzugriff mit Rechten für den Developer Bereich.

---

API-Einrichtung

1

API-Key erstellen (nexcore)

Navigiere zuerst in nexcore über Einstellungen zum Bereich Developer, um dort einen API-Key für die Verbindung mit TOPIX zu erstellen.

Mit einem Klick auf den Button "+ API-Key erstellen" öffnet sich ein Dialog in welchem Du einen Kommentar zur späteren Zuordnung der Verwendung des Keys eingeben musst.

Der API-Key wird nur einmal angezeigt! Kopiere und notiere Dir die API Key-ID und den API Key für die weitere Verwendung (beide Elemente werden für die Installation von nexcore.CONNECT oder die Einrichtung einer API-Verbindung benötigt)

Der nun erstellte, individuelle API-Key wird Dir sofort in der API-Key-Liste angezeigt und kann ab sofort verwendet werden.

Wenn Du mehrere Integrationen nutzt (z. B. ERP-System, BI-Tool, Webservice), empfiehlt es sich, für jede Anwendung einen separaten API-Key mit individuellem Kommentar zu erstellen. So kannst Du die Nutzung besser nachvollziehen.

2

Schnittstelleneinstellungen (TOPIX)

Öffne in Deinem TOPIX-Client die Einstellungen und suche unter Schnittstellen nach dem Eintrag "Nexato nexcore".

Die Felder API-Schlüssel, API-Key ID und ggf. Webhook URL sind bei der Ersteinrichtung leer.

3

API-Informationen eintragen (TOPIX)

Befülle die Felder in den TOPIX Einstellungen mit den zuvor generierten Informationen zum API-Key aus nexcore:

• API-Schlüssel: Füge hier den API-Key von Schritt 1 ein.

• API-Key ID: Füge hier die API-Key ID von Schritt 1 ein.

4

Verbindung testen (TOPIX)

Klicke nachdem Du die API-Key Informationen eingefügt hast auf den Button "Verbindung testen".

Wenn alles korrekt eingetragen wurde, erscheint eine Meldung mit der Information "Verbindung erfolgreich".

Sollte die Verbindung nicht erfolgreich sein, überprüfe zunächst die eingetragenen Werte für API-Key und API-Key ID – wurden diese ggf. vertauscht?

5

Verbindung testen (nexcore)

Wechsle in nexcore vom Tab "API" zum Tab "Logs" unter den Developer Einstellungen.

Wenn die Verbindung zu TOPIX erfolgreich hergestellt wurde, solltest Du hier einen Eintrag mit dem Status 200 OK und einem aktuellen Zeitstempel angezeigt bekommen.

Sollte es zu Problemen mit der Einrichtung Deiner Verbindung kommen, wende Dich zunächst an Deinen TOPIX-Berater. Wir stehen in engem Austausch mit diesem und können uns bei Bedarf direkt bzgl. eventueller Probleme austauschen.

---

Webhooks in TOPIX einrichten

1

Schnittstelleneinstellungen

Öffne in Deinem TOPIX-Client die Einstellungen und suche unter Schnittstellen nach dem Eintrag "Nexato nexcore".

2

Webhook URL eingeben

Trage die Dir von Deinem TOPIX-Berater oder IT-Administrator bereitgestellte Webhook URL in das Feld "Webhook URL" ein.

3

Events abonnieren

Klicke dann auf den Button "Events abonnieren" und bestätige im daraufhin erscheinenden Dialog "Events neu generieren" mit "OK".

Nach wenigen Sekunden sollte Dir eine Meldung mit der Information "Events erfolgreich erstellt" angezeigt werden

4

Webhook testen

Wenn die vorhergehende Rückmeldung positiv war, klicke nun auf den Button "Webhook testen" und bestätige im daraufhin erscheinenden Dialog "Möchten sie den Webhook testen?" mit "OK".

Nach wenigen Sekunden sollte Dir eine Meldung mit der Information "Nexcore Webhook erfolgreich" angezeigt werden

5

Geschafft!

Damit hast Du die Einrichtung der Webhooks in TOPIX abgeschlossen und kannst die Einstellungen schließen.