Amazon Selling Partner API: Unterschied zwischen den Versionen
Aus mention Software GmbH WIKI
Mirko (Diskussion | Beiträge) |
|||
| (41 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| − | + | ==Allgemeines== | |
| − | Beginnend mit dem 1.8.2022 schaltet Amazon einige Funktionen ihres Merchant Webservice (MWS) ab. | + | Beginnend mit dem 1.8.2022 schaltet Amazon einige Funktionen ihres Merchant Webservice (MWS) ab. Danach erfolgt eine weitere Funktionsdeaktivierung per 30.9.2022, bis schließlich MWS komplett zum 31.12.2022 abgeschaltet und nicht mehr nutzbar ist. |
https://docs.developer.amazonservices.com/en_US/dev_guide/index.html | https://docs.developer.amazonservices.com/en_US/dev_guide/index.html | ||
| Zeile 7: | Zeile 7: | ||
Benutzer von mention Amazon MarketplaceConnector mentionKonnekt - nachfolgend einfach nur Konnekt genannt - müssen daher auf die Version 10 zwingend aktualisieren, um den Betrieb bzw. Datenaustausch mit Amazon weiterhin gewährleisten zu können. | Benutzer von mention Amazon MarketplaceConnector mentionKonnekt - nachfolgend einfach nur Konnekt genannt - müssen daher auf die Version 10 zwingend aktualisieren, um den Betrieb bzw. Datenaustausch mit Amazon weiterhin gewährleisten zu können. | ||
| − | Nachfolgend einige notwendige Schritte, die - neben der Aktualisierung - durch den Benutzer/Händler durchzuführen sind: | + | ==Voraussetzungen== |
| + | |||
| + | Aufgrund der Verwendung von aktuellen, sicherheitsrelevanten Implementierungen, die u.A. den Datenverkehr über das Internet betreffen, werden ältere Windows-Betriebssysteme wie z.B. Windows 7 oder Windows Server 2008 nicht unterstützt und auch künftig nicht unterstützt werden. Es wird daher der Betrieb mit Windows 10, Windows Server 2012 oder höher vorausgesetzt. | ||
| + | |||
| + | Auf dem Zielrechner muss ferner das Microsoft .NET Framework 4.8 vorhanden bzw. installiert sein. Ein entsprechender Offline-Installer hierfür ist unter folgender Adresse verfügbar: | ||
| + | |||
| + | https://support.microsoft.com/de-de/topic/microsoft-net-framework-4-8-offline-installer-für-windows-9d23f658-3b97-68ab-d013-aa3c3e7495e0 | ||
| + | |||
| + | ==Maßnahmen== | ||
| + | |||
| + | Nachfolgend einige notwendige Schritte, die - neben der Aktualisierung von Konnekt - durch den Benutzer/Händler durchzuführen sind: | ||
* Stoppen des Windows-Dienstes | * Stoppen des Windows-Dienstes | ||
| − | * Erstellen einer Sicherheitskopie des bisherigen | + | * Erstellen einer Sicherheitskopie des bisherigen Programmverzeichnis von Konnekt |
| − | * Aktualisierung wie gewohnt durchführen | + | * Aktualisierung wie gewohnt durchführen (Ausführen der Installationsdatei auf dem Zielrechner) |
* Starten der Benutzeroberfläche (GUI) MentionKonnekt.exe mit anschließender Benutzeranmeldung, damit eine Aktualisierung der Datenbank durchgeführt wird. | * Starten der Benutzeroberfläche (GUI) MentionKonnekt.exe mit anschließender Benutzeranmeldung, damit eine Aktualisierung der Datenbank durchgeführt wird. | ||
| − | Die nächsten Schritte müssen für jedes Amazon Händler-Konto in Konnekt separat durchgeführt werden. Es erscheint anfangs ein Hinweis, dass ein sog. RefreshToken nicht vorhanden ist und erzeugt werden muss | + | Die nächsten Schritte müssen für jedes Amazon Händler-Konto in Konnekt separat durchgeführt werden. Es erscheint anfangs dabei ein Hinweis, dass ein sog. RefreshToken nicht vorhanden ist und erzeugt werden muss. |
[[File: Konnekt RefreshToken Message.png]] | [[File: Konnekt RefreshToken Message.png]] | ||
| + | |||
| + | Den Dialog mit Klick auf 'OK' bestätigen, um fortzufahren. | ||
* Token erzeugen | * Token erzeugen | ||
* Teilnahmen abrufen | * Teilnahmen abrufen | ||
| − | * Abrufintervall setzen (FBM) | + | * Abrufintervall für den Bestelldownload setzen (FBM) |
| + | * Windows-Dienst starten | ||
| − | Ein Händler-Konto unterscheidet sich durch die Verkäufernummer (Merchant ID), die | + | Ein Händler-Konto unterscheidet sich durch die Verkäufernummer (Merchant ID), die man von Amazon erhalten hat und in den Einstellungen in Konnekt schon enthalten ist. |
Sollten zwei Accounts in Konnekt eingerichtet sein, die die gleiche Verkäufernummer verwenden (z.B. FBM und FBA), müssen die Schritte nur für einen Account durchgeführt werden. | Sollten zwei Accounts in Konnekt eingerichtet sein, die die gleiche Verkäufernummer verwenden (z.B. FBM und FBA), müssen die Schritte nur für einen Account durchgeführt werden. | ||
| Zeile 28: | Zeile 41: | ||
[[File:Konnekt Settings MerchantID.png]] | [[File:Konnekt Settings MerchantID.png]] | ||
| − | |||
| − | Es muss ein sog. Refresh-Token von Amazon für den API-Zugriff angefordert werden. Betätigen Sie hierfür den Link "Token erzeugen" in Konnekt. Nachdem der Token bei Amazon erzeugt und abgerufen wurde, wird dieser in der Datenbank gespeichert und zusätzlich in der Konfigurationsdatei | + | ===Schritt 1: Token erzeugen=== |
| + | |||
| + | Es muss ein sog. Refresh-Token von Amazon für den API-Zugriff angefordert werden. Betätigen Sie hierfür den Link "Token erzeugen" in Konnekt. Nachdem der Token bei Amazon erzeugt und abgerufen wurde, wird dieser in der Datenbank gespeichert und zusätzlich in der Konfigurationsdatei AmazonConnector.ini hinzugefügt. | ||
Der RefreshToken hat eine Gültigkeitsdauer von einen Jahr. Das Ablaufdatum wird in den Einstellungen angezeigt, wenn vorhanden. | Der RefreshToken hat eine Gültigkeitsdauer von einen Jahr. Das Ablaufdatum wird in den Einstellungen angezeigt, wenn vorhanden. | ||
| Zeile 36: | Zeile 50: | ||
[[File: Konnekt Link generate Token.png]] | [[File: Konnekt Link generate Token.png]] | ||
| − | + | ||
| + | ===Schritt 2: Teilnahmen abrufen=== | ||
| + | |||
| + | Nachdem der Token erzeugt, abgerufen und gespeichert ist, müssen die Amazon Marktplatzteilnahmen des Händlers hinterlegt werden. Das Auswahlfeld Marketplace gibt zwar schon einen (Heimat-)Marktplatz an, jedoch deckt dieser nicht alle Amazon Marktplätze ab, auf denen der Verkäufer tätig ist bzw. Artikel gelistet hat. Die Marktplatzteilnahmen sind jedoch u.a. für das zeitgesteuerte Abrufen der Bestellungen erforderlich. | ||
| + | |||
| + | [[File: Konnekt Link Marketplaces.png]] | ||
| + | |||
| + | [[File: Konnekt Link Marketplaces Success.png]] | ||
| + | |||
| + | |||
| + | ===Schritt 3: Abrufintervall für den Bestelldownload setzen (FBM)=== | ||
| + | |||
| + | Dieser Schritt ist nur auszuführen, wenn Sie Bestellungen selbst versenden (FBM Fulfillment By Merchant). | ||
| + | |||
| + | Damit FBM Bestelldaten automatisch von Amazon erstellt werden, muss hierzu ein Intervall für die Bereitstellung der Berichte gesetzt werden. Um den Intervall festzulegen, wird der Link "Abrufintervall setzen" angeklickt (Bestellabruf FBM). War die Anfrage erfolgreich, wird dies im grün hinterlegten, unteren Infobereich entsprechend angezeigt. Anschließend die Einstellungen speichern. | ||
| + | |||
| + | [[File: Konnekt Link Order Schedule.png]] | ||
| + | |||
| + | [[File:Konnekt Link Order Schedule Success.png]] | ||
| + | |||
| + | |||
| + | ===Tax Service (Belegkorrektur)=== | ||
| + | |||
| + | Amazon hat den MWS Report _SC_VAT_TAX_REPORT_ in SC_VAT_TAX_REPORT umbenannt. Dieser Eintrag muss in den Einstellungen für den Tax-Service angepasst werden, da hier womöglich noch der alte Reportname gespeichert ist und die Automatik dann den abgerufenen Report zum Verarbeiten nicht finden kann. | ||
| + | |||
| + | [[File: Konnekt TaxService ReportPrefix.png]] | ||
| + | |||
| + | |||
| + | ===Windows-Dienst starten=== | ||
| + | |||
| + | Beim Windows-Dienst ist ggf. der Dienstbenutzer anzupassen, da das standardmäßige lokale Systemkonto nicht über netzwerkübergreifende Zugriffsberechtigungen auf Verzeichnisse und/oder Ordner beinhaltet. | ||
| + | |||
| + | [[File: Windows Service User.png]] | ||
Version vom 15. August 2022, 10:14 Uhr
Inhaltsverzeichnis
Allgemeines
Beginnend mit dem 1.8.2022 schaltet Amazon einige Funktionen ihres Merchant Webservice (MWS) ab. Danach erfolgt eine weitere Funktionsdeaktivierung per 30.9.2022, bis schließlich MWS komplett zum 31.12.2022 abgeschaltet und nicht mehr nutzbar ist.
https://docs.developer.amazonservices.com/en_US/dev_guide/index.html
Benutzer von mention Amazon MarketplaceConnector mentionKonnekt - nachfolgend einfach nur Konnekt genannt - müssen daher auf die Version 10 zwingend aktualisieren, um den Betrieb bzw. Datenaustausch mit Amazon weiterhin gewährleisten zu können.
Voraussetzungen
Aufgrund der Verwendung von aktuellen, sicherheitsrelevanten Implementierungen, die u.A. den Datenverkehr über das Internet betreffen, werden ältere Windows-Betriebssysteme wie z.B. Windows 7 oder Windows Server 2008 nicht unterstützt und auch künftig nicht unterstützt werden. Es wird daher der Betrieb mit Windows 10, Windows Server 2012 oder höher vorausgesetzt.
Auf dem Zielrechner muss ferner das Microsoft .NET Framework 4.8 vorhanden bzw. installiert sein. Ein entsprechender Offline-Installer hierfür ist unter folgender Adresse verfügbar:
Maßnahmen
Nachfolgend einige notwendige Schritte, die - neben der Aktualisierung von Konnekt - durch den Benutzer/Händler durchzuführen sind:
- Stoppen des Windows-Dienstes
- Erstellen einer Sicherheitskopie des bisherigen Programmverzeichnis von Konnekt
- Aktualisierung wie gewohnt durchführen (Ausführen der Installationsdatei auf dem Zielrechner)
- Starten der Benutzeroberfläche (GUI) MentionKonnekt.exe mit anschließender Benutzeranmeldung, damit eine Aktualisierung der Datenbank durchgeführt wird.
Die nächsten Schritte müssen für jedes Amazon Händler-Konto in Konnekt separat durchgeführt werden. Es erscheint anfangs dabei ein Hinweis, dass ein sog. RefreshToken nicht vorhanden ist und erzeugt werden muss.
Den Dialog mit Klick auf 'OK' bestätigen, um fortzufahren.
- Token erzeugen
- Teilnahmen abrufen
- Abrufintervall für den Bestelldownload setzen (FBM)
- Windows-Dienst starten
Ein Händler-Konto unterscheidet sich durch die Verkäufernummer (Merchant ID), die man von Amazon erhalten hat und in den Einstellungen in Konnekt schon enthalten ist.
Sollten zwei Accounts in Konnekt eingerichtet sein, die die gleiche Verkäufernummer verwenden (z.B. FBM und FBA), müssen die Schritte nur für einen Account durchgeführt werden.
Schritt 1: Token erzeugen
Es muss ein sog. Refresh-Token von Amazon für den API-Zugriff angefordert werden. Betätigen Sie hierfür den Link "Token erzeugen" in Konnekt. Nachdem der Token bei Amazon erzeugt und abgerufen wurde, wird dieser in der Datenbank gespeichert und zusätzlich in der Konfigurationsdatei AmazonConnector.ini hinzugefügt.
Der RefreshToken hat eine Gültigkeitsdauer von einen Jahr. Das Ablaufdatum wird in den Einstellungen angezeigt, wenn vorhanden.
Schritt 2: Teilnahmen abrufen
Nachdem der Token erzeugt, abgerufen und gespeichert ist, müssen die Amazon Marktplatzteilnahmen des Händlers hinterlegt werden. Das Auswahlfeld Marketplace gibt zwar schon einen (Heimat-)Marktplatz an, jedoch deckt dieser nicht alle Amazon Marktplätze ab, auf denen der Verkäufer tätig ist bzw. Artikel gelistet hat. Die Marktplatzteilnahmen sind jedoch u.a. für das zeitgesteuerte Abrufen der Bestellungen erforderlich.
Schritt 3: Abrufintervall für den Bestelldownload setzen (FBM)
Dieser Schritt ist nur auszuführen, wenn Sie Bestellungen selbst versenden (FBM Fulfillment By Merchant).
Damit FBM Bestelldaten automatisch von Amazon erstellt werden, muss hierzu ein Intervall für die Bereitstellung der Berichte gesetzt werden. Um den Intervall festzulegen, wird der Link "Abrufintervall setzen" angeklickt (Bestellabruf FBM). War die Anfrage erfolgreich, wird dies im grün hinterlegten, unteren Infobereich entsprechend angezeigt. Anschließend die Einstellungen speichern.
Tax Service (Belegkorrektur)
Amazon hat den MWS Report _SC_VAT_TAX_REPORT_ in SC_VAT_TAX_REPORT umbenannt. Dieser Eintrag muss in den Einstellungen für den Tax-Service angepasst werden, da hier womöglich noch der alte Reportname gespeichert ist und die Automatik dann den abgerufenen Report zum Verarbeiten nicht finden kann.
Windows-Dienst starten
Beim Windows-Dienst ist ggf. der Dienstbenutzer anzupassen, da das standardmäßige lokale Systemkonto nicht über netzwerkübergreifende Zugriffsberechtigungen auf Verzeichnisse und/oder Ordner beinhaltet.
