Inhalt
| Table of Contents |
|---|
Voraussetzung für den Umstieg: Amazon im Programmbereich ist bereits aktiv
Voraussetzung für diesen Umstiegs-Leitfaden ist, dass Ihre Amazon-Plattform bereits den Programmbereich von büro+ nutzt und über die Middleware bereits mit Amazon kommuniziert (vgl. Amazon-Plattform in microtech büro+). Amazon muss bereits als Plattform in büro+ angelegt und aktiv sein.
| Warning | ||
|---|---|---|
| ||
ACHTUNG: Diese Umstellung ist NICHT FÜR die Selektionsfeldlösung geeignet. Bitte beachten Sie dies, da eine falsch eingerichtete Konfiguration zu doppelten Vorgängen/Bestellungen führen kann! |
Überprüfen Sie folgende Voraussetzungen in büro+:
- Im Bereich: E-COMMERCE - STAMMDATEN - PLATTFORMEN ist die Amazon-Plattform in büro+ aktiv
- Amazon besitzt im Bereich: E-COMMERCE einen eigenen Bereich
- Eine Verbindung zur Plattform über die Middleware ist eingerichtet und die Übertragung der Artikel, Lagerbestände, Preise von büro+ zu Amazon kann durchgeführt werden
Mindestversion büro+: Version 6549
Middleware-Mindestversion: 5.11.557
Ziel der Umstellung auf Hybrid-Betrieb: Vorgangsabruf nutzt neue integrierte Lösung
Die Umstellung auf den neuen Vorgangsabruf über unsere integrierte Lösung (microtech Cloud) wird durch technische Änderungen der Schnittstellen von Amazon notwendig, die mit Ende des Stichtag: 31.07.2022 in Kraft treten. Um Sie rechtzeitig zu informieren, halten wir bereits heute einige Tipps bereits, mit denen Sie diese Umstellung selbst vornehmen können. Bitte bedenken Sie, dass Sie zuvor eine Datensicherung von büro+ und der Middleware durchführen müssen und etwas Zeit mitbringen sollten, um sich zunächst in die Umstellung einzulesen und diese dann durchzuführen. Sollten Sie auf Fragen stoßen, sprechen Sie auch gerne mit unserem Support bzw. Consulting, die Sie auf weitere Angebote seitens microtech verweisen können. Wir werden diese Dokumentation von Zeit zu Zeit um weitere Hinweise erweitern
...
.
| Info | ||
|---|---|---|
| ||
OAuth (Open Authorization) ist der Name zweier verschiedener offener Protokolle, die eine standardisierte, sichere API-Autorisierung für Desktop-, Web- und Mobile-Anwendungen erlauben. Um eine Verbindung über OAuth mit Amazon einzurichten muss eine TAN über eine Software generiert werden oder eine SMS empfangen werden. |
Einrichten der Amazon-Plattform in microtech büro+
Erstellen Sie im Bereich: E-COMMERCE - PLATTFORMEN ein Neues Profil vom Typ "Amazon". Bestätigen Sie das Kennzeichen "microtech Cloud verwenden" und das Aktiv-Kennzeichen für die Plattform. Durch die Aktivierung des Cloud-Kennzeichens wird das Register: ZUGANGSDATEN eingeblendet.
Zugangsdaten - Region
Wählen Sie Ihre Amazon-Region, z. B.: "DE" für Deutschland. Der Status der Anmeldung sollte bei der Ersteinrichtung noch auf "Nicht authentifiziert" stehen.
Anmelden im Amazon-Konto und Authentifizierung der Cloud
Technischer Hintergrund:
Wir unterstützen die Amazon SP-API über die microtech-Cloud. Das bedeutet für Sie, dass in Ihrer büro+ bis zum 31.07.2022 der Abruf der Vorgänge umgestellt werden muss. Wie Ihre Amazon-Plattform im Programmbereich entsprechend konfiguriert wird, damit diese mit der microtech Cloud verbunden ist, um die Vorgänge abzuholen, wird in diesem Artikel erklärt. Definition des Hybridbetriebs: Beachten Sie:
Wir sprechen daher in dieser Dokumentation auch von einem sogenannten Hybrid-Betrieb, die Middleware für die Verwaltung der Artikel und Einstell-Optionen, Kategorien, etc. nutzen, der Vorgangsabruf und die Status-Übertragung an Amazon fortan über unsere integrierte Lösung (microtech Cloud) übertragen werden. |
Zunächst ist es wichtig, dass Sie diese Dokumentation zunächst Schritt für Schritt lesen. Folgende Schritte sind in dieser Reihenfolge durchzuführen:
- microtech Cloud bei microtech beantragen und die Zugangsdaten in büro+ eintragen: https://hilfe.microtech.de/x/BADlCw
- Cloud-Kennzeichen in der bestehenden büro+ Plattform "Amazon" aktivieren
- Neues Register: "Vorgangserzeugung" konfigurieren
- Auf neuem Register: "Zugangsdaten" die Verbindung zum Amazon Seller Central herstellen und microtech als zugreifende Applikation erlauben
- Beim Speichern & schließen des geänderten Plattform-Datensatzes den Abruf der Einstellungen verneinen
- Den Vorgangsabruf von Amazon konfigurieren und automatisieren
- Status-Upload an Amazon konfigurieren und automatisieren
| Info | ||
|---|---|---|
| ||
Weitere Informationen zu diesen Schritten erhalten Sie detailliert auf dieser Seite. |
1. Erster Schritt: microtech Cloud-Zugangsdaten in büro+ eintragen
Erfassen Sie, nach Beantragung und Einrichtung Ihrer persönlichen microtech Cloud Zugangsdaten https://hilfe.microtech.de/x/BADlCw, diese Zugangsdaten in den Parametern von microtech büro+. Wechseln Sie hierzu auf PARAMETER - SONSTIGE - ZUGANGSDATEN.
| Info | ||||||
|---|---|---|---|---|---|---|
| ||||||
Zusätzlich bieten wir Ihnen ein kurzes Video zu Punkt 1 an (das Video besitzt keine Tonspur)
|
Über die Schaltfläche: NEU erfassen Sie einen neuen Zugangsdaten-Datensatz der Art "microtech Cloud". Füllen Sie Ihre Client-ID und Ihr Client-Secret in die zugehörigen Feld. Testen Sie nun über die Schaltfläche: TESTEN Ihre Daten. Sollte der Test erfolgreich sein, speichern und schließen Sie alle Fenster und befolgen die Hinweise auf dem Bildschirm. Bei Problemen mit den Zugangsdaten, überprüfen Sie diese bitte auf Korrektheit und wiederholen den Test.
2. Cloud-Kennzeichen in der bestehenden büro+ Plattform "Amazon" aktivieren
| Info | ||||||
|---|---|---|---|---|---|---|
| ||||||
Zusätzlich bieten wir Ihnen ein kurzes Video zu Punkt 2-5 an (das Video besitzt keine Tonspur)
|
Wechseln Sie nun auf: E-COMMERCE - STAMMDATEN - PLATTFORMEN:
- Wählen Sie Ihre bestehende Amazon-Plattform
- Mit der Schaltfläche: BEARBEITEN rufen Sie diesen Datensatz zum ändern auf
- Aktivieren Sie nun das Kennzeichen: "microtech Cloud verwenden" - die Register: "Vorgangserzeugung" und "Zugangsdaten" werden durch diesen Schritt eingeblendet
3. Neues Register: "Vorgangserzeugung" konfigurieren
Im Bereich der Vorgangserzeugung wird eine Standardkonfiguration festgelegt, mit welcher Konfiguration ein Vorgang von Amazon in der Warenwirtschaft angelegt wird. Die Festlegung der verfügbaren Versandarten und Zahlungsoptionen wird jeweils in der Administration des jeweiligen Online-Shops getroffen.
| Feld | Mögliche Konfiguration | Weitere Hinweise |
|---|---|---|
| Vorgangsart | Die von Amazon abgerufenen Vorgänge werden in dieser Vorgangsart in büro+ angelegt und weiterverarbeitet | https://hilfe.microtech.de/pages/viewpage.action?pageId=11735587 |
| Versand-Zahlweise | Als Versand-Zahlweise wird in büro+ diese Einstellung im angelegten Vorgang hinterlegt, z. B.: "Auf Rechnung", "Überweisung", etc. | https://hilfe.microtech.de/pages/viewpage.action?pageId=11740255 |
| Zahlungsart (Warenwirtschaft) | Legen Sie fest, ob im Vorgang als Zahlungsart eine Überweisung, Kreditkartenzahlung oder ähnliches erwartet wird | |
| Versandart (Warenwirtschaft) | Wählen Sie eine Versandart (je nachdem, ob Sie unsere Logistik-Lösung im Einsatz haben, so können direkt über microtech büro+ die passenden Versand-Etiketten abgerufen werden | https://hilfe.microtech.de/pages/viewpage.action?pageId=155254785 |
| Fracht-Artikelnummer | Die Erfassung der Frachtkosten dient dazu, im Standard Portokosten auf der Rechnung ausweisen zu können. |
|
| Info | ||
|---|---|---|
| ||
Die Konfiguration auf dem Register: "Vorgangserzeugung" ist generisch bei allen Plattformen, d. h. der Aufbau der Konfiguration zur Vorgangserzeugung folgt der gleichen Logik, wie z. B. bei Shopware 6 (https://hilfe.microtech.de/x/MwCnDw). Es sind lediglich die jeweiligen Plattform-spezifischen Einstellungen zu beachten. |
4. Auf neuem Register: "Zugangsdaten" die Verbindung zum Amazon Seller Central herstellen und microtech als zugreifende Applikation erlauben
In diesem Schritt melden Sie sich über büro+ in Ihrem Amazon-Konto an und authentifizieren den Zugriff der microtech Cloud. Gehen Sie hierzu wie folgt vor:
- Wechseln Sie auf das Register: ZUGANGSDATEN in Ihrer Amazon-Plattform
- Wählen Sie Ihre Amazon-Region, z. B.: "DE" für Deutschland
- Betätigen Sie die Schaltfläche: ANMELDEN:
...
- Die Plattform wird nur zur microtech Cloud hinzugefügt und der Standard-Browser Ihres Computers geöffnet
...
| Info | ||
|---|---|---|
| ||
Soll ein bestehendes Konto aktualisiert werden, ist die Schaltfläche: AKTUALISIEREN zu drücken. |
Berechtigungen für "microtech" im Amazon Seller Central gewähren
Durch den Aufruf: ANMELDEN in büro+ wird in Ihrem Standard-Browser die Anmeldemaske des Amazon Seller Centrals aufgerufenIm Standard-Browser öffnet sich nun die Anmeldeseite des Amazon Seller-Central. Melden Sie sich mit Ihren Zugangsdaten bei Amazon an.
Ihrem Konto an und wählen Sie die Schaltfläche: "Sign-In".
| Note | ||
|---|---|---|
| ||
Gegebenenfalls: Zwei-Faktor-Authentifizierung im Amazon Seller Central |
...
Halten Sie Ihre aktuellen Kontaktdaten und Geräte bereit, die für eine Zwei-Faktor-Authentifizierung registriert wurdenGegebenenfalls werden Sie dazu aufgefordert, sich über ein Zwei-Faktor-Authentifizierungssystem auszuweisen. Dieser zweite Schritt ist für Ihre Sicherheit gedacht. Über eine spezielle Software oder eine SMS haben Sie von Amazon ein sogenanntes OTP (One-Time-Pad), ein Einmalkennwort erhalten, dass Sie zur Berechtigung eingeben müssen. |
...
microtech Cloud API authentifizieren
Bestätigen Sie nun, auf welche Inhalte der Amazon Programmierschnittstelle (Aplication Programming Interface) die integrierte Lösung von microtech zugreifen darf. Diese Authentifizierung muss erfolgen, damit die Verbindung zwischen Amazon und der microtech Cloud hergestellt werden kann.
Aktivieren Sie das Kennzeichen "Hiermit nehme ich zur Kenntnis (...)", bevor Sie auf die Schaltfläche: CONFIRM klicken.
Verbindung war erfolgreich
Beim Bestätigen der Schaltfläche erscheint eine Meldung im Browser bei erfolgreicher Verbindung:
Dieses Browserfenster können Sie schließen, die Prozesse zur Authentifizierung werden direkt über büro+ verarbeitet.
Nachdem Sie den Zugriff bestätigt haben, wird nun auch in der Amazon-Plattform bei büro+ als Status der Anmeldung "Authentifiziert" angezeigt.
| Info | ||
|---|---|---|
| ||
Im Anschluss können die Einstellungen zur Plattform importiert werden. |
Entfernen der Plattform in büro+
Beachten Sie deshalb bitte auch, dass die Person oder das Telefon, dass für diese Zwei-Faktor-Authentifizierung vorgesehen ist, bei der Einrichtung verfügbar ist! Die Anmeldung über OAuth (Open Authorization) stellt eine sichere API-Autorisierung zu microtech büro+ her. Um eine Verbindung über OAuth mit Amazon einzurichten muss ggf. eine TAN über eine Software generiert werden oder eine SMS empfangen werden.
|
Gewähren Sie microtech büro+ den Zugriff auf alle nun angezeigten Daten Ihres Verkäuferkontos, damit büro+ über die API mit Ihrem Amazon-Konto kommunizieren kann. Bestätigen Sie über das Kennzeichen Ihr Einverständnis und bestätigen Sie Ihre Auswahl mit der Schaltfläche: CONFIRM.
Nach der Bestätigung wird die Verbindung hergestellt.
Sie erhalten eine Meldung der microtech Cloud, sobald die Verbindung erfolgreich hergestellt werden konnte.
Schließen Sie nun das Fenster des Internetbrowsers und wechseln Sie zurück in den Programmbereich von büro+.
Drücken Sie in büro+ die Schaltfläche: AKTUALISIEREN. Nun sollte sich der Status der Anmeldung von "nicht authentifiziert" zu "authentifiziert" ändern.
5. Beim Speichern & schließen des geänderten Plattform-Datensatzes den Abruf der Einstellungen mit "NEIN" beantworten
Speichern und schließen Sie nun Ihre Angaben in büro+! Sie erhalten nun eine Abfrage zum Import der Einstellungen, den Sie mit "NEIN" abbrechen.
| Warning | ||
|---|---|---|
| ||
Damit die Einstellungen Ihrer bestehenden Plattform nicht überschrieben werden, ist an dieser Stelle zwingend: "NEIN" zu wählen, da ansonsten initial neue Werte eingeladen werten.
|
Plattformreferenz-ID kontrollieren
Nachdem Sie die Plattform angelegt, autorisiert und gespeichert und geschlossen haben, können Sie z. B. in der Übersicht des Registers: PLATTFORMEN prüfen, ob eine "Plattformreferenz in der Cloud" angelegt wurde.
| Tip | |||||
|---|---|---|---|---|---|
| |||||
Sollte die Tabellenansicht diese Spalte noch nicht anzeigen, kann diese über den Tabellengestalter eingefügt werden.
|
6. Den Vorgangsabruf von Amazon konfigurieren und automatisieren
6a) Festlegen eines Status für die Adress-Anlage über Amazon-Bestellungen
Für die automatische Adress-Anlage in den Stammdaten können Sie nun einen Status für die Kunden von Amazon-Bestellungen festlegen. Sie können dies dann z. B. so konfigurieren, wie dies bereits über die Middleware per Adressvorlage gesteuert wurde.
Im Bereich: PARAMETER - ADRESSEN - STATUS können Sie über die Schaltfläche: NEU / KOPIEREN z. B. einen bestehenden Status duplizieren, umbenennen und die automatische Nummernvergabe für die Anlage anpassen. Speichern und schließen Sie die Änderungen.
Navigieren Sie nun wieder in den Bereich: E-COMMERCE - STAMMDATEN - Register: PLATFORMEN und wählen Ihre angelegte Amazon-Plattform aus. Wechseln Sie nun auf das Register: VORGABEN. Wählen Sie hier den Status aus, der für Kunden bei Amazon-Bestellungen angelegt werden soll.
6B) Vorgangsabruf durchführen und in ein Automatisierungs-Schema speichern
Wechseln Sie in den Bereich: E-COMMERCE - STAMMDATEN - Register: PLATTFORMEN:
- Über die Schaltfläche: WEITERE - BEREICHS-AKTIONEN rufen Sie den Assistenten für Aktionen aus
- Wählen Sie "Bereich frei angeben" und grenzen Sie optional die Plattform auf die Nummer Ihrer Amazon-Plattform ein
- Wechseln Sie mit der Schaltfläche: WEITER in das nächste Fenster
- Wählen Sie das Kennzeichen der Systemvorgabe: "Belege aus der Plattform herunterladen"
Wählen Sie in der Zusammenfassung über die Split-Schaltfläche: ALS NEUES SCHEMA SPEICHERN und vergeben Sie einen leicht nachvollziehbaren Namen wie z. B. "Autom. Amazon Vorgangsabruf".
Führen Sie dieses Schema einmalig über "WEITER" aus. Alternativ wählen Sie "ABBRECHEN", um die Schema-Anlage zu verlassen. Die Änderungen sind bereits gespeichert.
6C) Automatisierung einrichten
Wechseln Sie in den Bereich: MEINE FIRMA - ÜBERBLICK - AUTOMATISIERUNGSAUFGABEN UND DIENSTE. Sollte Sie den Bereich zum ersten Mal aufrufen, ist zunächst der Bereich einzublenden und das Register für die Automatisierungsdienste einzublenden.
Legen Sie über den Einrichtungs-Assistenten einen Automatisierungsdienst nach folgender Beschreibung an: https://hilfe.microtech.de/x/GICkBw
Ist dies bereits geschehen, folgen Sie den weiteren Schritten auf dieser Seite. Wechseln Sie auf das Register: AUTOMATISIERUNGSAUFGABEN:
- Erstellen Sie eine neue Automatisierungsaufgabe mittels Schaltfläche: NEU
- Wählen Sie den zuvor angelegten Automatisierungs-Dienst und vergeben Sie eine Bezeichnung für die Automatisierungsaufgabe
- Konfigurieren Sie Ihre Zeiten für die Abruf-Häufigkeit
- Markieren Sie die Tabelle: "Aktionen"
- Wählen Sie über die Schaltfläche: NEU die Neuanlage einer Aktion
Erfassen Sie die zugehörige Aktion, welche das angelegte Schema automatisieren soll:
- Wählen Sie als Art: "Assistenten-Schemen" und wählen Sie eine passende Bezeichnung
- Als Bereich ist "Plattformen" zu wählen
- Als Funktion selektieren Sie "Bereichs-Aktionen"
- Wählen Sie das Schema, dass für den Vorgangsabruf bei Amazon von Ihnen angelegt wurde
- Speichern und schließen Sie Ihre Angaben
Speichern und schließen Sie im Anschluss Ihre Angaben. Überprüfen Sie den Status der Automatisierungsaufgabe und des Dienstes.
Bitte deaktivieren Sie nun den Abruf der Vorgänge über die Middleware und überprüfen Sie das Ergebnis Ihrer Konfiguration
Eine detaillierte Information zum Deaktivieren des Vorgangsabrufs durch die Middleware stellen wir an dieser Stelle Ende April 2022 zur Verfügung.
| Note | ||
|---|---|---|
| ||
Funktionsweise des Vorgangabrufs mittels der microtech CloudDirekt nach der Einrichtung des Vorgangsabrufs über die microtech Cloud kann es noch dauern, bis Vorgänge heruntergeladen werden können, da ggf. aktuell von Amazon keine neuen Vorgänge zum Download angeboten werden. Warten Sie deshalb zunächst einige Stunden, bis Amazon neue Vorgänge, die zu Ihrem Marktplatz gehören, zum Abruf anbietet. Erst wenn mehr als 4 bis 12 Stunden vergangen sind - ohne dass real existierende Vorgänge abgeholt werden können - sollten Sie Ihre Support-Möglichkeiten bei microtech in Anspruch nehmen. Die Technik der microtech Cloud prüft ungefähr stündlich die auf bereitgestellte Belege durch Amazon. Zusätzlich informiert Amazon auch die microtech Cloud, sofern neue Belege vorliegen. Mit der Abfrage von microtech büro+ kontaktieren Sie die microtech Cloud, um vorliegende Amazon Bestellungen aus der Cloud abzurufen.
Die Cloud ist der Mittler / Übersetzer zwischen Amazon und microtech büro+! Sowohl "Amazon" als auch "büro+" kommunizieren über Anfragen mit der microtech Cloud. Diese agiert als "Scharnier" und vermittelt in den komplexen Abläufen. Die Cloud handelt die Anfragen zwischen den beiden Parteien ("Amazon" und "büro+") aus und liefert die angefragten Daten. Das Ergebnis dieser Kommunikation ist, dass z. B. von Amazon abgerufene Vorgänge oder der durch büro+ gesetzte Status mittels der microtech Cloud (in der benötigten Datenstruktur) passend an die Gegenpartei der Kommunikation geliefert wird. |
7. Status-Upload an Amazon konfigurieren und automatisieren
Damit der Status der versendeten Ware korrekt und regelmäßig an Amazon gemeldet wird, sobald in eine Rechnung gewandelt (und verschickt) wird, ist dies einmalig korrekt in büro+ zu konfigurieren und zu automatisieren.
Für Amazon sind folgende Angaben wichtig:
- Der Versand findet rechtzeitig im gesetzten Rahmen statt
- Die Trackingnummer des Versands wird übermittelt (kommt direkt aus dem Versanddatensatz)
- Der Versender wird angegeben (hier ist ein besonderes Mapping, basierend auf dem Versender des Versanddatensatz, herangezogen)
Eine ausführliche Beschreibung zur Durchführung des Status-Upload an Amazon, erhalten Sie in nachfolgender Beschreibung:
- Amazon: Bestellabruf und Status an Amazon (Integrierte Lösung) https://hilfe.microtech.de/x/DQDgFg
...