# Amazon Bestellimport ## Installation und Deinstallation ### Installation {% hint style="warning" %} Wichtig: Bitte beachten Sie, dass für die Verwendung dieses Plugin folgendes Plugins einmalig installiert und aktiviert sein muss: "[Marktplatz Bestellverwaltung - z.B. für Amazon, eBay usw. | Pro](https://store.shopware.com/cbax895325672158/marktplatz-bestellverwaltung-z.b.-fuer-amazon-ebay-usw.-pro.html)". {% endhint %} Sie können das Plugin [hier über den Shopware Community Store erwerben](https://store.shopware.com/cbax983725345931/marktplatz-amazon-bestellimport-sw6.html). Das Plugin wird wie ein ganz gewöhnliches Plugin installiert. Sollten Sie zum ersten Mal ein Plugin installieren, finden Sie unter dem folgenden Link eine Anleitung zur Installation von Plugins: {% embed url="" %} Shopware Handbuch zur Installation von Apps & Plugins {% endembed %} Nach der Installation des Plugins schalten Sie das Plugin aktiv. ### Deaktivierung / Deinstallation Die Marktplatz Bestellverwaltung, der Bestellimport und der Lagerbestandsabgleich bauen aufeinander auf und müssen in umgedrehter Reihenfolge deaktiviert bzw. deinstalliert werden. Nach folgender Reihenfolge deaktivieren bzw. deinstallieren Sie die Plugins: 1. Lagerbestandsabgleich deinstallieren (wenn vorhanden) 2. Bestellimport deinstallieren 3. Bestellverwaltung deinstallieren {% hint style="info" %} Wenn Sie die Plugins nur vorübergehend deinstallieren möchten, empfehlen wir, die gespeicherten App-Daten beizubehalten. Dadurch bleiben alle Einstellungen bei einer späteren Neuinstallation erhalten. {% endhint %} {% hint style="info" %} Bei einem Shopware Update muss der Lagerbestandsabgleich (wenn vorhanden) und der Bestellimport deinstalliert werden, um die Bestellverwaltung deaktivieren zu können {% endhint %} ## Plugin Einstellungen Um in die Konfigurationsmaske zu gelangen, gehen Sie ins Hauptmenü auf: *Einstellungen > Erweiterungen > Marktplatz Konfigurationen > Amazon Bestellimport*. ### Zugangsdaten {% tabs %} {% tab title="Zugangsdaten erstellen" %} Für die Zugangsdaten müssen Sie sich bei uns registrieren und die Autorisierung durchlaufen. Am Ende der Autorisierung erhalten Sie das Passwort für Ihre Plugin Einstellungen. * [Zur Registrierung und Autorisierung](https://www.coolbax.de/ExternalConnectionAmazon) * [Schritt-für-Schritt Anleitung](/coolbax-docs/handbuecher/marktplaetze/amazon-bestellimport/zugangsdaten-amazon.md) {% hint style="info" %} **INFO:** Bitte beachten Sie, dass die Autorisierung bis 100 Bestellungen am Tag kostenlos ist. Kunden mit höheren Bestellimport fallen monatliche Gebühren an. [Alle weiteren Informationen und Tarife finden Sie hier.](https://www.coolbax.de/tarife-fuer-amazon-autorisierung) {% endhint %} {% endtab %} {% tab title="Zugangsdaten erneuern/verlängern" %} {% hint style="warning" %} Der Zugang gilt für ein Jahr und muss danach erneuert werden! {% endhint %} Die Verlängerung kann nur über unsere Seite: [Autorisierung für die Amazon Plugins](https://www.coolbax.de/ExternalConnectionAmazon) durchgeführt werden. Eine Verlängerung über das Seller Central von Amazon genügt nicht. Melden Sie sich mit Ihren Daten (Verkäufer-ID und E-Mail-Adresse) an, welche Sie bei der Registrierung hinterlegt haben und führen den Prozess erneut durch. Speichern Sie am Ende das angezeigte Passwort ab. Der Zugang ist danach erneut 1 Jahr gültig. [Schritt-für-Schritt Anleitung](/coolbax-docs/handbuecher/marktplaetze/amazon-bestellimport/zugangsdaten-amazon.md) {% endtab %} {% tab title="Zugangsdaten deaktivieren" %} Die Schnittstelle zu Amazon führt über eine Autorisierung von uns. Diese Autorisierung kann Ihrerseits beendet werden. \ Um die Autorisierung zu beenden gehen Sie in Ihr Amazon Seller Central auf: *Menü > Apps und Dienste > Meine Apps verwalten.* In der darauf folgenden Seite können Sie die Autorisierung deaktivieren.

Autorisierung deaktivieren

{% hint style="warning" %} **INFO:** Sollten Sie die Autorisierung vor Ablauf der Gültigkeit nicht verlängern, wird die Schnittstelle seitens Amazon deaktiviert, bis die Autorisierung wieder verlängert wird. {% endhint %} {% endtab %} {% endtabs %} | Einstellung | Bedeutung | | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Verkäufer-ID | Verkäufer-ID zur API von Amazon | | Passwort | Dieses Passwort erhalten Sie nach der erfolgreichen Registrierung und Autorisierung bei Coolbax. Alle Informationen hierzu finden Sie unter: [Zugangsdaten](#zugangsdaten) | | Marktplatz | Wählen Sie die Marktplätze aus, auf denen Sie Bestellungen abholen möchten (Mehrfachauswahl möglich). Für Bestellungen aus UK gibt es gesonderte Regeln. Mehr Informationen finden Sie unter: [Bestellungen aus den Ländern ohne Euro](#uk_marktplaetze) | ### Import | Einstellung | Bedeutung | | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nur Bestellungen mit diesem Status importieren | Bestellung ist zur Bearbeitung freigegeben (empfohlen) | | Datum des letzten automatischen Import | An welchem Tag wurde der letzte automatische Import durchgeführt | | Uhrzeit des letzten automatischen Import | Zu welcher Uhrzeit wurde der letzte automatische Import durchgeführt | | Bestellstatus nach Import | Welchen Bestellstatus sollen die Bestellungen nach dem Import haben | | Lieferstatus nach Import | Welcher Lieferstatus sollen die Bestellungen nach dem Import haben | | Zahlstatus nach Import | Welchen Zahlstatus sollen die Bestellungen nach dem Import haben | | Personalisierte Artikeldaten importieren |

Wenn aktiv, werden Daten von personalisierte Produkte importieren und ein zusätzliches Dokument erstellen
Weiter Informationen finden Sie unter: Personalisierte Bestellungen

| | E-Mail Adresse ersetzen | Wenn aktiv, wird die E-Mail-Adresse vom Kunden verändert. Hiermit stellen Sie die Nutzungsbedingungen von Amazon sicher. Sie besagen, dass vom System des Händlers keine Kommunikation mit dem Kunden stattfinden darf. Automatisch versendete Mail vom System werden somit ins Nirvana geleitet. | ### Amazon Prime {% hint style="info" %} Die Einstellungen für Amazon Prime Bestellungen sind ab Version 3.0.6 über ein extra Button ein- und ausblendbar. {% endhint %} | Einstellung | Bedeutung | | -------------------------- | -------------------------------------------------------------------------------- | | Bestellstatus Amazon Prime | Welchen Bestellstatus sollen die Amazon Prime Bestellungen nach dem Import haben | | Lieferstatus Amazon Prime | Welchen Lieferstatus sollen die Amazon Prime Bestellungen nach dem Import haben | | Zahlstatus Amazon Prime | Welchen Zahlstatus sollen die Amazon Prime Bestellungen nach dem Import haben | ### Amazon FBA {% hint style="info" %} Die Einstellungen für Amazon FBA Bestellungen sind ab Version 3.0.6 über ein extra Button ein- und ausblendbar. {% endhint %} | Einstellung | Bedeutung | | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | FBA Bestellungen importieren | Wenn aktiv, dann werden die Bestellungen (welche durch Amazon versendet werden) auch ins System importiert | | Bestellstatus Versand durch Amazon (FBA) | Welchen Bestellstatus sollen die Amazon (FBA) Bestellungen nach dem Import haben | | Lieferstatus Amazon FBA | Welchen Lieferstatus sollen die Amazon (FBA) Bestellungen nach dem Import haben | | Zahlstatus Amazon FBA | Welchen Zahlstatus sollen die Amazon (FBA) Bestellungen nach dem Import haben | ### Zuordnung Allgemein | Einstellung | Bedeutung | | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Verkaufskanal | Welchen Shop sollen die Bestellungen zugeordnet werden. Die Auswahl der Kanäle ist auf Storefronts beschränkt ist, da für die Generierung einer Bestellung ein gültiger Verkaufskanal mit Domain benötigt wird. | | Verkaufskanal Url | Eine gültige Verkaufskanal Url ist zwingend notwendig. | | Steuersatz | Welchen Steuersatz sollen die Produkte bekommen, welche nicht im Shop angelegt sind | | Kundengruppe | Wählen Sie eine Kundengruppe (unabhängig vom Verkaufskanal). | | MwSt. von Amazon benutzen bei B2B Bestellungen | Bei Business-Bestellungen werden die Werte von Amazon importiert. (0 % möglich, Standardeinstellung ist nein) | | Bestellnummer für Shopware Bestellverwaltung auswählen | Soll die Marktplatz- oder eine Shopware Bestellnummer zum Generieren der Bestellung verwendet werden. | ### Zuordnung Versandarten
Einstellung Bedeutung
Standard VersandartWelcher Versandart sollen die Bestellungen standartmäßig zugewiesen werden.
Standard Versand DienstleisterÜber welchen Versand Dienstleister werden die Waren standartmäßig versendet? Ist Ihr Versand Dienstleister nicht dabei, wählen Sie "Other" und füllen das eingeblendete Feld "Eigener Versand Dienstleister" aus.
Eigener Versand DienstleisterHaben Sie im Feld "Standard Versand Dienstleister" die Auswahl "Other" gewählt, können Sie hier einen eigenen Versand Dienstleister eintragen.
LieferserviceÜber welchen Lieferservice werden die Waren versendet (z.B. Warensendung oder Paket) ?
{% hint style="info" %} Einzelne Abweichungen bei den Versand Dienstleister und Lieferservice können nochmals in der Bestellung eingestellt werden. [Für weitere Informationen klicken Sie hier.](/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs.md#bestell_shopwaredetail) {% endhint %} ### Länderabhängige Versanddienstleister {% hint style="info" %} Mit den nachfolgenden Einstellungen können Sie von den Standardeinstellungen abweichen, wenn Sie länderabhängig unterschiedliche Versandarten oder Versand Dienstleister nutzen. {% endhint %} | Einstellung | Bedeutung | | -------------------- | ------------------------------------------------------------------------------------------ | | Land | Wählen Sie das Land aus, für welches Sie eine andere Versandeinstellung hinterlegen wollen | | Versanddienstleister | Wer soll der Versanddienstleister für das gewählte Land sein? | | Lieferservice | Über welchen Lieferservice werden die Waren versendet (z.B. Warensendung oder Paket) ? | | Versandart | Welche Versandart soll genutzt werden? | ### Zuordnung Zahlungsarten | Einstellung | Bedeutung | | ------------------------------------------ | ----------------------------------------------------------------------------- | | Standard Zahlungsart | Welche Zahlungsart soll als Standard verwendet werden? | | Zahlung bei Lieferung(COD) Zahlungsart | Welche Zahlungsart soll bei Lieferung(COD) verwendet werden? | | Gemischtwarenladenzahlung(CVS) Zahlungsart | Welche Zahlungsart soll bei Gemischtwarenladenzahlung(CVS) verwendet werden? | ### Rechnungs-Upload | Einstellung | Bedeutung | | --------------------------------------------------- | ------------------------------------------------------------------------------- | | Rechnungs-Upload\* aktivieren | Mit Aktivierung werden Rechnungen an Amazon gesendet. | | Rechnungs-Upload\* auch für FBA aktivieren | Mit Aktivierung werden auch Rechnungen für FBA Bestellungen an Amazon gesendet. | | Rechnungsdokument für Upload | Auswahl des hochzuladenden Dokuments. | | Rechnungs-Upload für Bestellungen mit diesem Status | Bei welchem Bestellstatus soll die Rechnung zu Amazon gesendet werden? | {% hint style="warning" %} \* Bitte beachten Sie, dass die Rechnung bereits erstellt sein muss, bevor der entsprechende Bestellstatus gesetzt wird. Ein automatische nachträgliche Übermittlung der Rechnungen ist nicht möglich. {% endhint %} ## Bestellungen aus Ländern ohne Euro Nicht auf allen Amazon Marktplätzen wird in Euro bezahlt. Sollten Sie ihre Waren in einem der Länder anbieten, müssen Sie die Währung entsprechend anlegen. Nachfolgend wird Ihnen am Beispiel von Pfund erklärt, wie Sie die Währung anlegen und auf was Sie achten müssen. Der Marktplatz "Vereinigtes Königreich (UK)" kann nur ausgewählt werden, wenn die Währung "Pfund" angelegt ist. Hierfür gehen Sie bitte in: *Einstellungen > Shop > Währungen* und legen die neuen Währung an (sollte diese noch nicht im System sein). Übernehmen Sie hierfür bitte die Einstellungen aus der nachfolgenden Abbildung. | Land | ISO Wert | | --------------------------- | -------- | | Schweden | SEK | | Vereinigtes Königreich (UK) | GBP |

Beispiel für die Anlage von Pfund als Währung

{% hint style="warning" %} Wichtig ist, dass im Feld "ISO" der Wert eingetragen sein muss und nicht verändert werden darf {% endhint %} ## Lagerbestand im Shop abgleichen Um den Lagerbestand im Shop abzugleichen, müssen die Artikelnummern aus dem Shop auch auf Amazon hinterlegt werden. Wenn die Artikelnummern nicht identisch sind, dann werden die Bestellungen zwar importiert, aber kein Lagerbestand abgeglichen. ## Bestellungen importieren Sie haben zwei Möglichkeiten die Bestellungen von Amazon in Ihr Shopware Backend zu holen. ### Manueller Import Für das manuelle Abholen einer Amazon Bestellung benötigen Sie die Bestellnummer von der Amazon Bestellung. Um diese zu erhalten gehen Sie in Ihren Amazon Account auf "Bestellungen". Dort finden Sie die benötigte Bestellnummer.
Gehen Sie nun ins Backend von Shopware: *Bestellungen > Marktplatz*. Klicken Sie auf den Button "Neue Bestellung importieren". Wählen Sie den Marktplatz "Amazon" aus und fügen Ihre Bestellnummer ein. Mehrere Bestellnummern einfach untereinander einfügen. Klicken Sie anschließend auf den Button "Importieren". Sie haben nun die Bestellung erfolgreich in Shopware importiert. Möchten Sie diese anschließend noch in eine Shopware Bestellung umwandeln, gehen Sie zum Ende der Spalte Ihrer Bestellung, öffnen das Menü und klicken auf "Shopware Bestellung erzeugen" ### Automatischer Import (Cronjob) Für den automatischen Import benötigen Sie zwei aktive Cronjobs. Bei der Installation werden diese angelegt. Sie sind für die Abarbeitung der Aufträge verantwortlich. * **Amazon Bestellungen importieren** - Holt die Bestellungen von Amazon ab und importiert diese in den Shop. * **Amazon Versandstatus setzen** - Informiert Amazon das die Bestellung versendet wurde und sendet den Tracking Code. Wenn das Bestellaufkommen zu groß ist, dann führen Sie den Cronjob lieber per Shell aus. Richten Sie die Cronjobs auf Ihren Webserver ein und rufen Sie folgende URL auf: {% hint style="danger" %} Stellen Sie das **Intervall des Cronjob NICHT unter 30 Minuten**! Sie laufen ansonsten Gefahr, von uns gesperrt zu werden. {% endhint %} {% tabs %} {% tab title="Ab Shopware 6.5.x" %} * **Amazon Bestellungen importieren** - /api/cbax/amazon/importOrder?key=123 * **Amazon Versandstatus setzen** - /api/cbax/amazon/shippingConfirmationSend?key=123 * **Rechnungen vorbereiten** - /api/cbax/amazon/refreshInvoiceUploadStatus?key=123 * **Upload der Rechnungen** - /api/cbax/amazon/invoiceSend?key=123 {% endtab %} {% tab title="Shopware 6.4.x " %} * **Amazon Bestellungen importieren** - /api/cbax/amazon/importOrder?key=123 * **Amazon Versandstatus setzen** - /api/cbax/amazon/dispatchStatusSend?key=123 {% endtab %} {% tab title="Vor Shopware 6.4.x (alte Version)" %} * **Amazon Bestellungen importieren** - /api/v{version}/cbax/amazon/importOrder?key=123 * **Amazon Versandstatus setzen** - /api/v{version}/cbax/amazon/dispatchStatusSend?key=123 {% endtab %} {% endtabs %} {% hint style="info" %} Ersetzen Sie "123" durch den Eintrag, den Sie im Feld **"Gültiger Schlüssel"** in der [Marktplatz Bestellverwaltung](/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs.md#cronjob_einrichten) vergeben haben. {% endhint %} ## Versandinformationen hinterlegen Wie Sie eine Trackingnummern und den Versanddienstleister hinterlegen finden Sie im Handbuch der [Bestellverwaltung + GPSR](/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs.md) unter: [*Bestelldetails Shopware Bestellverwaltung*](/coolbax-docs/handbuecher/marktplaetze/bestellverwaltung-+-gprs.md#bestell_marktplatzdetail-2) ## Personalisierte Bestellungen Ab der Plugin Version 3.0.3 (Shopware 6.5) können Sie Bestellungen mit personalisierten Produktdaten einfach ins System importieren. Hierfür müssen Sie in [Einstellungen des Plugin](#plugin_einstellungen-1): *Personalisierte Artikeldaten importieren* aktive schalten. Bestellungen mit personalisierten Artikeldaten werden wie gewohnt importiert und eine Shopware Bestellung generiert. Öffnen Sie die Bestellung in der Shopware Bestellverwaltung und gehen auf den Reiter "Dokumente". Anschließend gehen Sie auf: *Neues Dokument erstellen > Amazon Personalisierung.* Sie erhalten ein Dokument mit personalisierten Daten.

Beispiel: Dokument für personalisierte Bestellungen

## Weiterführende Links {% content-ref url="/pages/SqFT1mVFHdANuLmZ4hPy" %} [Zugangsdaten Amazon](/coolbax-docs/handbuecher/marktplaetze/amazon-bestellimport/zugangsdaten-amazon.md) {% endcontent-ref %} ## Fragen und Antworten
Was versteht man unter einen Lieferservice Eine Lieferservice ist das Produkt oder die Dienstleistung, die Sie von dem Versanddienstleister nutzen. Nachfolgend finden Sie einige Beispiele für häufig verwendete Kombinationen von Versanddienstleister und Lieferservice. * **Deutsche Post:** Warenpost, Warenpost International, Großbrief, Päckchen, usw. * **DHL:** Paket, Prio, EuroPaket, Paket International, Express, usw. * **DPD:** Classic, Prio, Express, usw. * **Hermes:** Standard, Päckchen, S-Paket, M-Paket, usw.
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://coolbax.gitbook.io/coolbax-docs/handbuecher/marktplaetze/amazon-bestellimport.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.