Plattform anlegen & authentifizieren

Im Bereich E-COMMERCE - ÜBERBLICK / STAMMDATEN - Register: PLATTFORMEN werden Shops und Marktplätze in der Software angelegt.

Die Plattform bietet zahlreiche Register für die Konfiguration. Nach dem Vergeben der Infos im Kopf der Maske sollten Sie zunächst die Authentifizierung vornehmen bzw. die Zugangsdaten eintragen (wird von Shop bzw. Marktplatz vorgegeben). Diesen ersten Schritt beschreiben wir direkt auf dieser Seite.

Neue Plattform anlegen

Klicken Sie auf NEU, um einen neuen Plattform-Datensatz zu erstellen.
Wählen Sie im Feld Plattform-Typ den gewünschten Shop oder Marktplatz (z. B. Shopware, eBay, Amazon).
Die Felder Nummer und Bezeichnung werden automatisch befüllt, lassen sich aber anpassen.

Ablauf im Überblick

Plattform anlegen: Neue Plattform in der Software erstellen und den passenden Plattformtyp wählen
Zugangsdaten eintragen: Auf dem Register „Zugangsdaten" die erforderlichen Daten aus dem Shop- oder Marktplatz-Backend eingeben
Authentifizierung durchführen: Je nach Plattform per Schaltfläche „Anmelden" oder durch direktes Eintragen der Credentials
Plattform aktivieren: Setzen Sie nach erfolgreicher Verbindung das Aktiv-Kennzeichen in der Plattform
Speichern & schließen: Nach erfolgreicher Verbindung speichern Sie bitte. Im Anschluss nehmen Sie die Konfiguration der weiteren Register vor.

Plattform authentifizieren

Bevor die microtech Software mit einem Shop oder Marktplatz kommunizieren kann, muss die Verbindung einmalig hergestellt werden. Dies geschieht auf dem Register Zugangsdaten der jeweiligen Plattform.

Je nach Plattform unterscheidet sich das Verfahren. Es wird grundsätzlich unterschieden zwischen folgenden Anmeldemöglichkeiten (von der Plattform vorgegeben):

Client Credentials: Zugangsdaten (Client-ID + Secret) werden im Plattform-Backend generiert und in den Zugangsdaten der microtech Software eingetragen.
OAuth: Anmeldung über Browser direkt beim Anbieter; Berechtigungen werden dort bestätigt.
Custom App: Eigene App im Shop-Backend anlegen, API-Berechtigungen konfigurieren und Token übernehmen.

Beachten Sie

Führen Sie die Authentifizierung vollständig durch, bevor Sie weitere Konfigurationen vornehmen
Bei OAuth-Verfahren werden Sie auf eine externe Anmeldeseite weitergeleitet – halten Sie Ihre Zugangsdaten bereit
Einige Plattformen erfordern eine Zwei-Faktor-Authentifizierung (2FA)
Nach dem Anbinden der Plattform setzen Sie das Kennzeichen „Aktiv", speichern und schließen. Im Anschluss kann die weitere Konfiguration erfolgen.

Wählen Sie Ihre Plattform per Hilfe-Register auf dieser Seite aus, um die jeweilige Schritt-für-Schritt-Anleitung zu sehen:

ShopwareeBayAmazonKauflandShopifyOTTO Market

Woher erhalte ich die Zugangsdaten für meine Shopware-Instanz?

Client ID und Client Secret werden in der Shopware 6 Administration unter Einstellungen → System → Integrationen erstellt, um externen Anwendungen wie der microtech Software einen API-Zugriff zu gewähren.

Der Schlüssel wird aus Sicherheitsgründen nur einmalig bei Erstellung angezeigt und kann bei Bedarf an dieser Stelle auch neu generiert werden.

Zugangsdaten für Shopware einpflegen

Navigieren Sie in den Bereich: E-COMMERCE - ÜBERBLICK / STAMMDATEN - Register: PLATTFORMEN. Rufen Sie Ihre Shopware-Plattform zum ÄNDERN auf bzw. legen Sie diese über NEU an, sofern noch nicht geschehen.

Wechseln Sie auf das Register Zugangsdaten und tragen Sie Client-ID, Client Secret sowie die Shop-URL in die entsprechenden Felder ein.

Wichtig zur URL: Ergänzen Sie Ihre Shop-Adresse um /api am Ende.
Beispiel: Aus https://meinshop.de/ wird https://meinshop.de/api

Shopware-Begriff	Feld in microtech ERP
Client-ID	Zugangs-ID
Client-Secret	Sicherheitsschlüssel (aus Shopware)
Shop-URL	URL (mit Zusatz `/api`)

Beachten Sie

Nachdem die Zugangsdaten erfolgreich eingetragen und die Plattform angebunden wurde, schalten Sie die Plattform durch das Aktiv-Kennzeichen im Kopf der Maske ein.

Speichern & schließen Sie die Plattform, bevor Sie weitere Konfigurationen vornehmen.

Info

Nach dem Speichern fragt Sie die microtech Software, ob Eigenschaften und Kategorien aus dem Shop importiert werden sollen – wir empfehlen, dies mit Ja zu bestätigen.

Die Authentifizierung erfolgt über OAuth direkt mit Ihrem eBay-Konto.

Schritt 1 – Anmeldung starten

Wechseln Sie auf das Register Zugangsdaten und klicken Sie auf Anmelden. Ihr Standard-Browser öffnet die eBay-Anmeldeseite.

Wichtig bei mehreren eBay-Konten

Melden Sie sich vorher von anderen eBay-Accounts ab oder leeren Sie die Browser-Cookies, um Vermischungen bei der Authentifizierung zu vermeiden.

Schritt 2 – Im eBay-Konto anmelden

Melden Sie sich mit Ihren eBay-Zugangsdaten an. Möglicherweise fordert eBay eine Zwei-Faktor-Authentifizierung an.

Schritt 3 – Zugriff für microtech Cloud gewähren

Bestätigen Sie die angezeigten API-Berechtigungen, damit die microtech Cloud mit Ihrem eBay-Konto kommunizieren kann.

Schritt 4 – Verbindung prüfen

Nach erfolgreicher Autorisierung erscheint eine Bestätigung im Browser – dieses Fenster können Sie schließen. Prüfen Sie in der microtech Software, ob der Status auf authentifiziert steht.

Aktivieren Sie abschließend die Plattform über das Kennzeichen Aktiv.

Beachten Sie

Speichern & schließen Sie die Plattform, bevor Sie weitere Konfigurationen vornehmen.

Tipp

Die Authentifizierung hat ein Ablaufdatum. Sofern Sie die Authentifizierung erneuern müssen, weist Sie die Software darauf hin.

Um ein bestehendes Konto zu aktualisieren, verwenden Sie auf dem Register ZUGANGSDATEN die Schaltfläche AKTUALISIEREN statt ANMELDEN.

Die Authentifizierung erfolgt über OAuth direkt mit dem Amazon Seller Central.

Schritt 1 – Marktplatz wählen und Anmeldung starten

Navigieren Sie in den Bereich: E-COMMERCE - ÜBERBLICK / STAMMDATEN - Register: PLATTFORMEN. Rufen Sie Ihre Amazon-Plattform zum ÄNDERN auf bzw. legen Sie diese über NEU an, sofern noch nicht geschehen.

Wechseln Sie auf das Register Zugangsdaten und wählen Sie Ihre Amazon-Marktplatz-Region (z. B. „DE" für Deutschland). Klicken Sie anschließend auf Anmelden.

Tipp

Sie können mehrere Marktplätze angeben, z. B. de,fr,be,nl,it (Semikolon- oder Komma-getrennt).

Folgende Marktplätze werden durch microtech ERP unterstützt:

EU-Marktplatz	Website (Externer Link)	Einzutragen in microtech ERP
Deutschland	Amazon.de	de
Vereinigtes Königreich	Amazon.co.uk	uk
Italien	Amazon.it	it
Frankreich	Amazon.fr	fr
Spanien	Amazon.es	es
Niederlande	Amazon.nl	nl
Schweden	Amazon.se	se
Polen	Amazon.pl	pl
Türkei	Amazon.com.tr	tr
Belgien	Amazon.com.be	be

Schritt 2 – Im Amazon Seller Central anmelden

Ihr Browser öffnet die Anmeldemaske des Amazon Seller Central. Melden Sie sich mit Ihren Zugangsdaten an.

Hinweis zur Zwei-Faktor-Authentifizierung

Halten Sie Ihr registriertes Gerät oder Telefon bereit – Amazon fordert möglicherweise ein Einmalkennwort (OTP) per App oder SMS an.

Schritt 3 – Zugriff für microtech gewähren

Bestätigen Sie die angezeigten Berechtigungen für Ihr Verkäuferkonto und wählen Sie die Schaltfläche Confirm. Die microtech Cloud benötigt diese Rechte, um über die API mit Amazon zu kommunizieren.

Schritt 4 – Verbindung prüfen

Nach erfolgreicher Verbindung erscheint eine Bestätigung der microtech Cloud. Schließen Sie den Browser und wechseln Sie zurück in Ihre microtech Software. Klicken Sie auf Aktualisieren – der Status sollte nun authentifiziert lauten.

Aktivieren Sie abschließend die Plattform über das Kennzeichen Aktiv.

Beachten Sie

Speichern & schließen Sie die Plattform, bevor Sie weitere Konfigurationen vornehmen.

Die Authentifizierung erfolgt über Client-Zugangsdaten aus dem Kaufland Seller Portal.

Schritt 1 – API-Zugang im Kaufland Seller Portal generieren

Die Client-Zugangsdaten (Client Key und Secret Key) finden Sie im Händlerbereich unter den API-Einstellungen. Wechseln Sie im Kaufland-Hauptmenü links auf Einstellungen bzw. Settings. Wählen Sie im API-Bereich den Unterpunkt „Shop-Einstellungen" / „Shop Settings" und klicken Sie auf die Registerkarte „API". Generieren Sie dort einen neuen API-Zugang und kopieren Sie den generierten Client Key und Secret Key.

Schritt 2 – Zugangsdaten in Software eintragen

Navigieren Sie in den Bereich: E-COMMERCE - ÜBERBLICK / STAMMDATEN - Register: PLATTFORMEN. Rufen Sie Ihre Kaufland-Plattform zum ÄNDERN auf bzw. legen Sie diese über NEU an, sofern noch nicht geschehen.

Wechseln Sie auf das Register Zugangsdaten und geben Sie die Daten ein, die Sie im Kaufland Seller Portal generiert haben:

Feld	Eingabe
Client-ID	Ihre Client-ID aus dem Seller Portal
Client Secret	Ihr Client Secret aus dem Seller Portal
Marktplätze	`de` (bzw. kommasepariert, z. B. `de,cz,sk`)

Info

An erster Stelle muss Ihr Haupt-Marktplatz stehen (in der Regel de) – über diesen laufen die generellen Aktualisierungen. Weitere Marktplätze wie Tschechien (cz) oder Slowakei (sk) können Sie nach Freischaltung durch Kaufland ergänzen.

Neben dem deutschen Marktplatz baut Kaufland nach und nach über eine Multi-Marktplatz-Technologie einen „Global Marketplace" auf. Das Freischalten der Marktplätze erfolgt im Kaufland Seller Portal. Weitere Informationen: kaufland.de/i/haendler-infobereich

Schritt 3 – Plattform aktivieren

Aktivieren Sie das Kennzeichen Aktiv.

Beachten Sie

Speichern & schließen Sie die Plattform, bevor Sie weitere Konfigurationen vornehmen.

Seit 2026 erfolgt die Anbindung von Shopify an microtech ERP über das Shopify Dev Dashboard.

Die Anbindung über das neue Verfahren steht ab Build 7195 zur Verfügung und ist bei neu anzubindenden Shops zu benutzen.

Info

Sofern Sie bereits in der Vergangenheit eine funktionierende Verbindung zwischen Shopify und microtech ERP eingerichtet haben, ist aktuell nichts zu unternehmen.

Wie funktioniert die Einrichtung?

Die Einrichtung umfasst drei Phasen:

App im Dev Dashboard erstellen und konfigurieren
App über das Partner Dashboard an Ihren Shop verteilen und installieren
Zugangsdaten in microtech ERP hinterlegen

Info

Die Bilder und Pfade der Schritt-für-Schritt-Anleitung wurden Mitte Mai 2026 erstellt.

Phase 1: App im Shopify Dev Dashboard erstellen

Schritt 1: Zum Bereich „Apps entwickeln" navigieren

Melden Sie sich unter admin.shopify.com in Ihrem Shop an.

Öffnen Sie unten links Einstellungen und wählen Sie anschließend Apps.

Im Bereich Apps klicken Sie oben rechts auf Apps entwickeln.

Schritt 2: Zum Dev Dashboard wechseln

Sie sehen nun den Hinweis, dass Apps künftig über das Dev Dashboard verwaltet werden. Klicken Sie auf die Schaltfläche Apps im Dev Dashboard erstellen.

Sie werden automatisch zu dev.shopify.com weitergeleitet.

Schritt 3: Neue App anlegen

Im Dev Dashboard klicken Sie oben rechts auf App erstellen.

Es öffnet sich ein Dialog. Wählen Sie die Option Im Dev Dashboard starten (rechte Seite). Tragen Sie als App-Name z. B. microtech ERP ein und klicken Sie auf Erstellen.

Schritt 4: Zugriffsrechte und API-Version festlegen

Nach dem Erstellen gelangen Sie in die Konfiguration der App. Legen Sie hier folgende Einstellungen fest:

Webhooks-API-Version Wählen Sie die aktuell von microtech unterstützte Version: 2026-04.

Beachten Sie:

Sofern von microtech die API-Version aktualisiert wird, ist ggf. diese Einstellung entsprechend anzupassen. Änderungen an der Software werden in unseren Programmänderungen dokumentiert.

Scrollen Sie nun auf dieser Seite etwas tiefer. Die Einstellungen können beinahe grundlegend so übernommen werden. Zuvor müssen Sie aber den Zugriff konfigurieren.

Zugriff (Bereiche)

Im Bereich: "Zugriff" konfigurieren Sie, auf welche "Bereiche" Ihre für die microtech ERP angelegte App zugreifen darf.

Beispiel-Berechtigung

An dieser Stelle möchten wir Ihnen eine Beispiel-Konfiguration für die Berechtigungen zeigen, welche wir für unsere Tests genutzt haben.

Tragen Sie im Feld Bereiche die folgenden Zugriffsrechte ein – entweder manuell als kommagetrennte Liste oder über Bereiche auswählen:

Bereich	Bedeutung
`read_orders`	Bestellungen lesen
`write_merchant_managed_fulfillment_orders`	Fulfillment-Aufträge schreiben
`read_merchant_managed_fulfillment_orders`	Fulfillment-Aufträge lesen
`read_products`	Produkte lesen
`read_locations`	Standorte lesen
`read_shipping`	Versandinformationen lesen

Schritt 5: App veröffentlichen

Scrollen Sie nach unten und klicken Sie auf Veröffentlichen.

Es öffnet sich ein Dialog, in dem Sie optional einen Versionsnamen und eine Nachricht eingeben können. Beide Felder sind nicht verpflichtend. Klicken Sie auf Veröffentlichen.

Schritt 6: Anmeldedaten notieren

Wechseln Sie in der linken Navigation unter dem App-Namen microtech ERP zu Einstellungen.

Sie sehen dort Ihre Client-ID und Ihren Schlüssel.

Kopieren Sie beide Werte und legen Sie diese sicher ab – Sie benötigen sie in Phase 3 für die Eingabe in microtech ERP.

Tipp

Den Schlüssel können Sie über das Augen-Symbol einblenden. Sollten Sie die Daten später erneut benötigen, finden Sie sie jederzeit unter dev.shopify.com - App auswählen - Einstellungen.

Phase 2: App über das Partner Dashboard verteilen und installieren

Schritt 7: Zum Shopify Partner Dashboard wechseln

Öffnen Sie partners.shopify.com und melden Sie sich an. Wählen Sie in der linken Navigation App-Verteilung und dann Alle Apps.

Sie sehen dort Ihre neu erstellte App microtech ERP.

Schritt 8: App öffnen und Verteilung konfigurieren

Klicken Sie auf microtech ERP. Es öffnet sich die App-Übersicht.

Wählen Sie in der linken Navigation Verteilung. Wählen Sie anschließend die Option Benutzerdefinierte Verteilung aus und klicken Sie auf Auswählen.

Es erscheint ein Bestätigungsdialog. Klicken Sie auf Benutzerdefinierte Verteilung auswählen.

Schritt 9: Installationslink generieren

Tragen Sie im Feld Shop-Domain die URL Ihres Shops ein (z. B. admin.shopify.com/store/mein-shop oder mein-shop.myshopify.com).

Lassen Sie das Kennzeichen Installation in mehreren Shops einer Plus-Organisation zulassen aktiviert.

Klicken Sie auf Link generieren.

Es erscheint ein Bestätigungsdialog. Klicken Sie erneut auf Link generieren.

Schritt 10: Installationslink kopieren und App installieren

Der generierte Installationslink wird nun angezeigt. Kopieren Sie diesen über die Schaltfläche Kopieren.

Öffnen Sie den Link in einem Browser. Sie werden aufgefordert, sich bei Shopify anzumelden bzw. Ihren Shop auszuwählen.

Nach der Anmeldung öffnet sich die Installationsseite für microtech ERP. Sie sehen den Hinweis, dass diese App exklusiv für Ihren Shop erstellt wurde. Klicken Sie auf Installieren.

Phase 3: Zugangsdaten in microtech ERP hinterlegen

Navigieren Sie in microtech ERP zum Bereich: E-COMMERCE – ÜBERBLICK / STAMMDATEN, Register: PLATTFORMEN.

Legen Sie über die Schaltfläche NEU eine neue Plattform vom Typ SHOPIFY an. Die Plattform-Bezeichnung muss in Ihrer microtech Cloud einmalig sein (z. B. „Shopify-Shop gefolgt von Ihrer microtech Kundennummer).

Wechseln Sie auf das Register ZUGANGSDATEN und hinterlegen Sie die Daten aus Phase 1, Schritt 6:

Feld in Software	Wert aus dem Dev Dashboard
Client-ID	Client-ID
Schlüssel	Schlüssel
Shopname	Nur die Subdomain Ihrer Shop-URL (ohne `https://` oder `www.`)

Tipp

Den Shopnamen finden Sie im Shopify-Backend unter Einstellungen → Domänen. Tragen Sie nur die Subdomain ein – z. B. mein-shop statt https://mein-shop.myshopify.com.

Aktivieren Sie abschließend das Kennzeichen AKTIV.

Beachten Sie

Speichern und schließen Sie die Plattform, bevor Sie weitere Konfigurationen vornehmen.

Vorab: DHL-Nummernkreis muss beantragt werden

Für OTTO Market müssen Sie zusätzlich eine Retouren Tracking-ID (DHL-Retouren-Paketnummer) eintragen. Diese wird für alle Sendungen benötigt, die nicht per Spedition versendet werden – ohne diese ID akzeptiert OTTO den Versand nicht und die Auszahlung kann nicht erfolgen.

Beachten Sie

Für die Retouren-Tracking-ID bei OTTO muss ein zusammenhängender Nummernkreis verwendet werden.
Reservieren Sie entsprechend einen fest abgesteckten Nummernkreis bei DHL, den Sie nur für OTTO nutzen werden.
Dies ist essenziell, um Überschneidungen mit anderen Shops und Märkten zu vermeiden.
Im Feld „Retouren-Paketnummer" wird die Startnummer des Nummernkreises eingegeben. Die Software zählt diese Nummer daraufhin entsprechend hoch.

Nutzen Sie bei Fragen zu diesem Thema bitte Ihre microtech Support-Optionen. Eine korrekte Konfiguration von Beginn an ist hier besonders wichtig.

Wie ist die Retouren-Paketnummer in das Feld einzutragen?

Format	Eingabe in microtech ERP	Hinweis zur Prüfziffernberechnung
12-stellige DHL-Nummer	Die ersten 11 Ziffern (ohne Prüfziffer am Ende)	Modulo 10, Gewichtung 4-9
20-stellige DHL-Nummer	Die ersten 19 Ziffern (ohne Prüfziffer am Ende)	Modulo 10, Gewichtung 3-1 (2/5 interleaved)

💡 Praktische Beispiele:

DHL-Nummer 123456780012 → Eingabe in das Feld: 12345678001
DHL-Nummer mit Platzhaltern 987654321234567XXXX2 → Eingabe in das Feld: 9876543212345670001 (Die X-Platzhalter werden durch die Startnummer des Nummernkreises ersetzt, also 0001)

Authentifizierung starten

Nachdem Sie alle Fragen zum DHL-Nummerkreis geklärt haben und die einzutragende Nummer feststeht, können Sie mit der Authentifizierung beginnen.

Die Anbindung an OTTO erfolgt über eine Authentifizierung direkt in der microtech ERP Software.

Navigieren Sie in den Bereich: E-COMMERCE - STAMMDATEN - Register: PLATTFORMEN. Erstellen Sie über Schaltfläche: NEU einen Plattform-Datensatz und wählen Sie als Plattform-Typ: OTTO.

Wechseln Sie nun auf das Register: ZUGANGSDATEN.

Tragen Sie die erste Retouren-Paketnummer für den DHL-Nummernkreis ein, den Sie für OTTO reserviert haben. Von der ersten Retouren-Paketnummer wird fortan hochgezählt.
Klicken Sie nun auf Schaltfläche: ANMELDEN, um den Authentifizierungsprozess über OTTO durchzuführen. Es öffnet sich der auf Ihrem System eingestellte Standard-Internetbrowser.

In dem sich öffnenden Fenster von "OTTO PARTNER CONNECT" melden Sie sich bitte mit Ihrer E-Mail-Adresse und Ihrem Passwort an.

Nach der Anmeldung erhalten Sie im Fenster die Info, dass ein Zugriff auf die Versand- und Vorgangskomponente angefordert wurde. Drücken Sie auf die Schaltfläche: CONFIRM.

Im Anschluss ist aus Sicherheitsgründen ein weiterer Login erforderlich.

Sobald Sie diese Zugriffsanforderung sehen, drücken Sie auf die Schaltfläche: ZULASSEN.

Nachdem die Verbindung hergestellt wurde, erhalten Sie im Browser die Info, dass die Verbindung zwischen der Plattform und der microtech ERP hergestellt werden konnte. Schließen Sie nun das Browser-Fenster.

In der Software prüfen Sie nun auf dem Register: ZUGANGSDATEN die Gruppe "Status der Anmeldung" – an dieser Stelle sollte als aktueller Status "authentifiziert" stehen.

Ist dies nicht der Fall, drücken Sie die Schaltfläche: AKTUALISIEREN, um den Status zu laden.

Wenn der Status der Anmeldung auf "authentifiziert" steht, schalten Sie die Plattform über das Kennzeichen "Aktiv" und über Registerkarte: ERFASSUNG klicken Sie auf die Schaltfläche: SPEICHERN & SCHLIESSEN.

Dies ist wichtig, damit die Authentifizierung nicht verloren geht.

Anschließend können Sie die Plattform wieder zum Bearbeiten öffnen und die weiteren Register konfigurieren.

Wo finde ich die Plattform nach dem Speichern?

Die angelegte Plattform wird nach dem Speichern in der Tabelle sowie im Menü angezeigt und trägt den Namen der Plattform, z. B. Shopware, eBay, Amazon, etc.

Weiterführende Konfiguration

Nach der Authentifizierung konfigurieren Sie die Plattform über die relevanten Register:

Register	Funktion	Weitere Infos
Vorgaben	HTML-Vorlagen, Artikelbilder, Preisgruppen, Währung	Vorgaben, HTML-Vorlagen
Vorgangserzeugung	Zuordnung von Zahlungs- und Versandarten	Vorgangserzeugung
Status-Versandarten	Mapping für Versandmeldungen (Amazon, eBay, OTTO, Kaufland)	Status-Versandarten

Weitere Register der Plattform:

Register	Funktion
Einstellungen	Links zur Plattform-Website und Admin-Bereich
Spezifikationen	Plattform-Vorgaben (nur lesbar)
Zugangsdaten	An dieser Stelle wird die Plattform authentifiziert
Memo	Freitextfeld für Notizen
Selektionen	Individuelle Kennzeichen (über DB-Manager freizuschalten)
Gesperrt	Plattform in der Software deaktivieren
Info	Allgemeine Informationen und Datensatz-Historie