Partner-Apps

Gen. 24 Core & Enterprise

Was sind Partner-Apps?

Mit Partner-Apps binden Sie zertifizierte Lösungen von microtech-Partnern direkt an Ihre microtech ERP an. Die Kommunikation erfolgt sicher über die GraphQL-Schnittstelle und OAuth 2.0. Sie profitieren von zusätzlichen Funktionen, die von Partnern für individuelle Anforderungen und Spezialgebiete entwickelt wurden.

Partner-Apps sind ab Build 7120 in Gen. 24 Core und Gen. 24 Enterprise verfügbar.

Verfügbare Partner-Apps

Partner-App	Partner	Beschreibung
MBCOM ConnectELO	MBCOM IT-Systemhaus GmbH	Anbindung der microtech ERP an das ELO Dokumentenmanagement-System Externer Link: https://www.mbcom.de/business-solutions/connectsuite/connectelo

Info

Weitere Partner-Apps werden sukzessive verfügbar gemacht. Informationen zu neuen Partner-Apps erhalten Sie über Ihren microtech-Vertriebskontakt.

Voraussetzungen für Partner-Apps

microtech Gen. 24 Core oder Enterprise (ab Build 7120)
Gültiger Aktivierungsschlüssel für die jeweilige Partner-App
Aktivierter GraphQL-Zugriff für den Mandanten (fester GraphQL-Endpunkt)
HTTPS-fähiger Server mit gültigem SSL-Zertifikat
Gültiger Domain-Name (keine IP-Adressen)

Beachten Sie

In der Gen. 24 Core lassen sich ausschließlich Partner-Apps (vertrauliche Clients) anbinden.

Einrichtung einer Partner-App

Schritt 1: Aktivierungsschlüssel eintragen

Nach dem Erwerb einer Partner-App erhalten Sie einen Aktivierungsschlüssel. Diesen tragen Sie zunächst in der Software ein, wie in der Hilfe beschrieben:

Aktivierung der Programmsoftware

Wechseln Sie zu Registerkarte: HILFE → LIZENZ → AKTIVIERUNGEN.

Klicken Sie auf die Schaltfläche: HINZUFÜGEN.

Aktivieren Sie das Kennzeichen: „Aktivierungsschlüssel manuell erfassen"
Tragen Sie den Aktivierungsschlüssel für die Partner-App ein
Bestätigen Sie mit WEITER

Nach erfolgreicher Aktivierung steht Ihnen die entsprechende Partner-App im Bereich "Anwendungen verwalten" als Anwendungsart zur Verfügung. Wie Sie dies dort auswählen, zeigen wir Ihnen in den nächsten Schritten.

Schritt 2: GraphQL-Zugriff aktivieren (falls noch nicht aktiviert)

Partner-Apps sollten den festen, automatisch bereitgestellten GraphQL-Endpunkt des Mandanten verwenden. Ein manueller Automatisierungsdienst ist dafür nicht erforderlich.

Wie Sie den GraphQL-Zugriff aktivieren und die URL des Endpunkts ermitteln, ist beschrieben unter: GraphQL-Endpunkt - Einrichtung und Betrieb

Tipp

Verwenden Sie für Partner-Apps immer den festen GraphQL-Endpunkt anstelle eines manuell eingerichteten Automatisierungsdienstes.

Alternative: Automatisierungsdienst (nicht empfohlen für Partner-Apps)

Falls bereits ein Automatisierungsdienst vom Typ „GraphQL-Server" eingerichtet ist, kann dieser weiterhin genutzt werden. Für neue Partner-App-Anbindungen wird jedoch der feste GraphQL-Endpunkt empfohlen.

Navigieren Sie zu MEINE FIRMA → ÜBERBLICK → Register: AUTOMATISIERUNGS-DIENSTE.
Legen Sie einen neuen Dienst an mit der Art: „GraphQL-Server".
Konfigurieren Sie die erforderlichen Einstellungen (HTTPS, Domain, SSL-Zertifikat).
Starten Sie den Dienst.

Detaillierte Informationen finden Sie in der GraphQL Entwickler Dokumentation - Abfragen (Queries).

Schritt 3: Benutzer für GraphQL berechtigen

Damit ein Benutzer über die Partner-App auf Daten zugreifen kann, muss die GraphQL-Berechtigung aktiviert sein:

Wechseln Sie zu Registerkarte: INFORMATIONEN → BENUTZER → BENUTZER VERWALTEN.
Öffnen Sie den gewünschten Benutzer-Datensatz.
Wechseln Sie auf das Register: FIRMENVORGABEN und aktivieren Sie das Kennzeichen: „Zugriff über GraphQL erlaubt".

Info

Mit dem Setzen des Kennzeichens „Zugriff über GraphQL erlaubt" wird automatisch auch das Kennzeichen „Benutzer kann sich immer anmelden" aktiviert.

Schritt 4: Anwendung anlegen

Nun legen Sie die Anwendung für die Partner-App an:

Navigieren Sie zu MEINE FIRMA → ÜBERBLICK → Register: ÜBERBLICK → Gruppe: SYSTEMEINSTELLUNGEN → ANWENDUNGEN VERWALTEN

Klicken Sie auf Neu im Menüband.

Konfigurieren Sie nun die Anwendung wie folgt:

Feld	Eingabe
Bezeichnung	Aussagekräftiger Name (z. B. „MBCOM ConnectELO")
Anwendungsart	Wählen Sie die entsprechende Partner-App aus der Liste, z. B. „MBCOM IT-Systemhaus GmbH - MBCOM ConnectELO (Partner-App)". (Durch Eintragen des Aktivierungsschlüssels freigeschaltet).
Client-Typ	Vertraulich (wird automatisch gesetzt)
Benutzer	Wählen Sie den microtech-Benutzer für die Verbindung

Konfigurieren Sie die Redirect URI entsprechend den Vorgaben des Partner-App-Anbieters. Aktivieren Sie die erforderlichen Scopes (mindestens: GraphQL-API Zugriff).

Achtung

Client-ID und Client-Secret werden automatisch generiert.

Kopieren Sie beide Werte mit den Kopier-Buttons vor dem Speichern! Das Secret wird danach nur als Hash gespeichert und kann nicht wiederhergestellt werden.

Klicken Sie nun auf Speichern & schließen

Schritt 5: Zugangsdaten an die Partner-App übermitteln

Die Partner-App benötigt drei Informationen, um sich mit Ihrem microtech ERP-System zu verbinden:

URL des GraphQL-Endpunkts (siehe GraphQL-Endpunkt - URL-Struktur; bei Nutzung eines Automatisierungsdienstes aus dessen Ereignisprotokoll)
Client-ID (aus der Anwendungskonfiguration)
Client-Secret (aus der Anwendungskonfiguration – nur beim Erstellen sichtbar!)

Diese Daten geben Sie in der Partner-App ein, wenn diese Sie zur Eingabe auffordert.

Beachten Sie

Die URL muss ein gültiger Domain-Name mit HTTPS sein (z. B. https://erp.ihrefirma.de). IP-Adressen funktionieren nicht.

Unterschiede zwischen Core und Enterprise

Funktion	Gen. 24 Core	Gen. 24 Enterprise
Partner-Apps (vertrauliche Clients)	✓	✓
Eigene Anwendungen erstellen	✗	✓
Öffentliche Clients	✗	✓
Interaktive Web-Oberfläche (Playground)	✗	✓

Fehlerbehebung

Aktivierungsschlüssel wird nicht akzeptiert:

Prüfen Sie, ob Sie mindestens Build 7120 installiert haben
Stellen Sie sicher, dass Sie eine Gen. 24 Core- oder Enterprise-Version nutzen
Kontaktieren Sie den microtech-Support

Verbindung zur Partner-App schlägt fehl:

Prüfen Sie, ob der GraphQL-Server läuft
Stellen Sie sicher, dass HTTPS und ein gültiger Domain-Name verwendet werden
Überprüfen Sie, ob Client-ID und Client-Secret korrekt übertragen wurden
Prüfen Sie, ob der zugewiesene Benutzer die GraphQL-Berechtigung hat

Partner-App erscheint nicht in der Auswahl:

Stellen Sie sicher, dass der Aktivierungsschlüssel erfolgreich eingetragen wurde
Starten Sie die Software neu