Microtech-Onboarding

Microtech Die allgemeine Microtech-Basis vorbereiten und OAuth, GraphQL sowie aktuelle Modul-Zusatzprüfungen live prüfen.

Diese Seite verbindet Anleitung und Live-Test: Zuerst bereiten Sie die allgemeine Einrichtung in Microtech vor, anschließend prüfen Sie die Verbindung und die wichtigsten Konfigurationswerte direkt im System.

Zum Testformular Einrichtung ansehen

Echter OAuth- und GraphQL-Test

Der Test holt ein echtes Microtech-OAuth-Token und prüft anschließend die GraphQL-API direkt im Zielsystem.

Basischecks plus Fachprüfung

Der Live-Test prüft die technische Verbindung sowie wichtige Fachangaben wie Selektionsfeld, Vorgangsarten und Standardkreditor.

JSON für die Übergabe an uns

Nach einem erfolgreichen Test können Sie die Konfiguration als JSON herunterladen und sicher an MBCOM senden.

Einrichtung

So bereiten Sie die allgemeine Microtech-Anbindung vor

1. Versionsstand und Lizenzgrundlage prüfen

Die allgemeine ConnectCloud-Anbindung setzt eine aktuelle Microtech-Installation voraus und benötigt eine passende Partner-App oder einen geeigneten Enterprise-Schlüssel.

Schritt für Schritt

Nur Gen. 24 Core oder Gen. 24 Enterprise verwenden.

Möglichst die aktuellste stabile Microtech-Version einsetzen.

Keine veralteten Versionen oder Express-Updates für diese Anbindung einplanen.

Partner-App-Schlüssel oder passenden Enterprise-Schlüssel hinterlegen, damit später in Anwendungen verwalten die richtige Anwendungsart verfügbar ist.

Alternativ kann eine eigene App angelegt werden, wenn das im Projekt so abgestimmt ist.

Hinweise

Die GraphQL-Anbindung ist die gemeinsame Grundlage für ConnectInvoice und ConnectELO. Der Live-Test auf dieser Seite prüft die Verbindung und die wichtigsten fachlichen Angaben.

2. HTTP/2 und externe Erreichbarkeit vorbereiten

Microtech GraphQL benötigt einen sauber erreichbaren HTTPS-Endpunkt. Dazu müssen HTTP/2, Port, Zertifikat und externe Erreichbarkeit zusammenpassen.

Schritt für Schritt

BpConfig.exe auf dem Server öffnen.

HTTP/2 aktivieren.

Den HTTP/2-Port im Standard auf 443 setzen oder den abweichenden Port dokumentieren.

Firewall, Portfreigabe und Reverse Proxy auf diesen Port abstimmen.

Ein gültiges Zertifikat hinterlegen.

Sicherstellen, dass die Domain extern per HTTPS erreichbar ist und zum Zertifikat passt.

Hinweise

Wenn nicht Port 443 verwendet wird, diesen Wert später bei der Übergabe an MBCOM unbedingt mit angeben.

3. GraphQL im Mandanten aktivieren

Im betroffenen Mandanten muss GraphQL explizit aktiviert sein, sonst kann die Anwendung zwar existieren, aber die API bleibt unbrauchbar.

Pfad

Mandant bearbeiten -> Weitere Angaben

Schritt für Schritt

In den gewünschten Mandanten wechseln.

Mandant bearbeiten öffnen.

Zum Register Weitere Angaben wechseln.

Prüfen, ob GraphQL aktiviert bereits gesetzt ist.

Falls nicht, GraphQL aktiviert einschalten.

4. Benutzer und Anwendung anlegen

Für ConnectCloud wird ein Benutzer mit passenden Rechten und eine vertrauliche Anwendung mit GraphQL-API-Zugriff benötigt.

Pfad

Informationen -> Benutzer -> Benutzer verwalten

Meine Firma -> Überblick -> Systemeinstellungen -> Anwendungen verwalten

Schritt für Schritt

Einen bestehenden Benutzer öffnen oder einen neuen Benutzer anlegen.

Der Benutzer benötigt Supervisor-Rechte.

In den Firmenvorgaben das Kennzeichen Zugriff über GraphQL erlaubt aktivieren.

In Anwendungen verwalten eine neue Anwendung anlegen.

Als Anwendungsart unsere Partner-App oder eigene App auswählen.

Den Client-Typ auf Vertraulicher Client setzen.

Den passenden Benutzer zuordnen.

GraphQL-API Zugriff aktivieren.

Client ID und Client Secret sofort sichern.

Hinweise

Ein Benutzer wie ConnectCloud mit der Benutzernummer 301 ist sinnvoll, damit spätere Änderungen leichter zugeordnet werden können.

5. Base URL und abgeleitete Endpunkte festlegen

Aus der Base URL ergeben sich Token-URL und GraphQL-URL. Genau diese Werte prüft der Live-Test unten gegen die echte Schnittstelle.

Schritt für Schritt

Im Standard lautet die Base URL https://<server.domain>/microtech/erp/mand/<MandNr>/

Die Token URL ergibt sich zu .../token

Die GraphQL URL ergibt sich zu .../graphql/v1

Falls bereits ein manueller GraphQL-Endpunkt vorhanden ist, kann auch dieser weiterverwendet werden, dann weicht nur die URL-Struktur ab.

Hinweise

Im Testformular reicht die Base URL. Token- und GraphQL-Endpunkt werden daraus automatisch abgeleitet und direkt geprüft.

6. DMS und Zusatzmodule vorbereiten

Das Microtech DMS ist allgemein Voraussetzung für ConnectInvoice und ConnectELO. Zusätzlich gibt es modulspezifische Konfigurationen, die je nach Einsatzfall vorzubereiten sind.

Schritt für Schritt

Sicherstellen, dass das Microtech DMS vorhanden ist.

Für ConnectInvoice das Selektionsfeld Sel30310 in Vorgängen anlegen und die benötigten Vorgangsarten sowie eine Standard-Adressnummer vorbereiten.

Für ConnectELO die DMS-Parameter der betroffenen Vorgangsarten pflegen.

Für ConnectELO zusätzlich die Regel Für das Vorbelegen von Dokumenten-Datensätzen anlegen.

Für ConnectELO außerdem das Selektionsfeld Sel30311 in Artikeln vorbereiten.

ConnectELO Regel für das Vorbelegen von Dokumenten-Datensätzen

Bezeichnung: Für das Vorbelegen von Dokumenten-Datensätzen | MBCOM | Dok.Vog.BelegNr
Auswertungsposition: Für das Vorbelegen von Dokumenten-Datensätzen
Bedingung: Immer ausführen
Anweisungsart: Feldzuweisungen
Feld: Belegnummer (des zugeordneten Vorgangs) [Vog.BelegNr]
Art der Feldzuweisung: Feldwert über Formel füllen
Vorgabewert: <<Vog.BelegNr>>

Hinweise

Beim DMS prüft der Live-Test bewusst nur, ob es technisch über GraphQL erreichbar ist.

Die übrigen Angaben wie Selektionsfeld, Vorgangsarten und Standardkreditor werden weiterhin gezielt geprüft.

Übergabe an MBCOM

Diese Daten sollten am Ende vorliegen

baseUrl

clientId

clientSecret

abweichender HTTP/2 Port falls nicht 443

DMS vorhanden

selectionFieldName

Sel30311 für ConnectELO in Artikeln

invoiceTransactionTypeNo

correctionTransactionTypeNo

creditTransactionTypeNo

standardCreditorNo

Microtech-Onboarding

Verbindung und Konfiguration prüfen

Die Eingaben sind in drei Bereiche gegliedert: Zugangsdaten, automatisch abgeleitete Endpunkte und zusätzliche Konfigurationswerte.

1. Zugangsdaten

Diese Werte werden für den OAuth-Token-Abruf und die anschließenden Prüfungen verwendet.

Anzeigename

Kontakt-E-Mail

Base URL

Beispiel: https://server.domain/microtech/erp/mand/1/

Client-ID

Client-Secret

2. Abgeleitete Endpunkte

Aus der Base URL prüft der Test automatisch den OAuth-Token-Endpunkt und die GraphQL-URL.

Token URL

https://server.domain/microtech/erp/mand/1/token

GraphQL URL

https://server.domain/microtech/erp/mand/1/graphql/v1

3. Zusatzwerte für die Fachprüfung

Diese Werte werden direkt geprüft. Beim DMS selbst prüfen wir nur allgemein, ob es technisch erreichbar ist.

Selektionsfeld

Erlaubte Eingaben: 30310, Sel30310 oder fldSel30310

Standardkreditor

Standard-Adressnummer für die ConnectInvoice-Prüfung

Vorgangsart Eingangsrechnung

E-Rechnungscode 380

Vorgangsart Rechnungskorrektur

E-Rechnungscode 384

Vorgangsart Gutschrift Lieferant

E-Rechnungscode 381

Microtech Live-Test starten

Es werden nur lesende Anfragen gegen OAuth und GraphQL ausgeführt. In Microtech werden dabei keine Daten angelegt oder geändert.

Letzte Antwort

Ergebnis des Microtech-Onboardings

Starten Sie einen Live-Test, um hier die Ergebnisse für Verbindung, DMS und die weiteren Prüfungen anzuzeigen.