Einleitung

Mit der App “Alexa Delivery Notifications” für Shopify können Sie Kunden, die mit Amazon Pay bezahlt haben, automatisch via Alexa über den Versand ihrer Ware informieren lassen.

Die App sendet automatisch die entsprechenden Meldungen an Amazon Pay, sobald Sie ein Fulfillment für eine mit Amazon Pay bezahlte Bestellung anlegen oder verändern und dieses Fulfillment eine Trackingnummer und einen Versanddienstleister enthält, der für die Versandbenachrichtungen gemappt werden kann.

Bei erfolgreicher Übergabe der Versandmeldung an Amazon Pay setzt die App ein Shopify Metafield an der Bestellung.

Installation / Update

Systemvoraussetzungen

Die App funktioniert unabhängig von Ihrem Shop-Frontend und integriert sich in Ihren Shopify-Adminbereich.

Sie benötigen nur:

• Einen Amazon Pay Account (denselben Account, mit dem Sie bereits Zahlungen mit Amazon Pay abwickeln)

• Einen handelsüblichen, ES6-fähigen Browser (zum Beispiel Chrome), um das Adminbackend zu bedienen.

Installation

Fügen Sie die App wie jede andere App einfach Ihrem Shopify-Shop hinzu.

Sie können die App dann in Ihrem Admin-Bereich unter “Apps” finden und aufrufen.

Benötigte API-Zugriffe

Die App benötigt Zugriffe auf die Resource “Bestellungen”, “Fulfillments” und “Transaktionen”.

Bestellungen

Die App setzt auf Bestellungen ein Metafield, um technisch zu signalisieren, dass hierzu eine Alexa Delivery Notification versendet wurde.

Fulfillments

Aus den Fulfillments bezieht die App die Informationen zu Trackingnummer und Versanddienstleister.
Die im Fulfillment enthaltene Order-ID wird genutzt, um die dazugehörigen Transaktionen zu laden.

Transaktionen

Aus der Transaktion ermittelt die App die zugehörige Referenznummer bei Amazon Pay, welche benötigt wird, um die Delivery Notification abzusetzen.

Datenverarbeitung

Die App speichert keine Daten von Shopkunden.

Konfiguration

Sie gelangen zur Konfiguration, indem Sie die App “Alexa Delivery Notifications” im Bereich “Apps” in Ihrem Shopify-Adminbereich aufrufen.

Beachten Sie, dass Ihre Änderungen erst gültig werden, wenn Sie diese auch über den Speichern-Button am Ende der Seite speichern.

Konto-Einstellungen

In den Konto-Einstellungen konfigurieren Sie, wie sich die App mit Ihrem Amazon Pay-Konto verbindet.

Region

Wählen Sie die Region Ihres Amazon Pay-Kontos aus.

Je nach ausgewählter Region können Sie dem darunter eingeblendeten Link folgen, in dem die Erstellung der in den folgenden Schritten benötigten Keys beschrieben ist.

Public Key ID

Tragen Sie hier Ihre Public Key ID ein, die Sie in der Seller Central von Amazon Pay finden.

Private Key

Tragen Sie hier den Private Key ein, den Sie in der Seller Central bei der Erstellung des Private/Public Key-Schlüsselpaares erhalten haben.

Sie erhalten den Key üblicherweise in Form einer herunterladbaren .pem-Datei. Kopieren Sie den gesamten Inhalt der Datei in dieses Textfeld.

Beachten Sie, dass die App Ihnen den Key bei einem erneuten Aufruf der App aus Sicherheitsgründen nicht mehr direkt anzeigt. Es wird Ihnen lediglich angezeigt, ob ein Private Key hinterlegt wurde, oder nicht.

Zugangsdaten testen

Sobald Sie einen Private Key eingegeben haben, können Sie die Zugangsdaten mit diesem Button testen.

Aktiviere Alexa Delivery Notifications

Wenn Sie alle Delivery Notifications für Ihren Store deaktivieren möchten, können Sie hier den Haken entfernen.

Eigene Versanddienstleister-Mappings

Die App kommt mit Standard-Mappings zwischen Shopify-Versanddienstleistern und den entsprechenden Alexa-Codes.

Wenn Sie diese aus irgendeinem Grund verändern oder ergänzen wollen, können Sie das in diesem Bereich tun.

Vorhandene Eigene Mappings

Hier können Sie sehen, welche eigenen Mappings Sie bereits angelegt haben.

Über den “-”-Button können Sie Ihre eigenen Mappings auch wieder entfernen.

Neues Mapping hinzufügen

Hier können Sie den Shopify-Code/-Namen des Versanddienstleisters eingeben und den dazugehörigen Alexa Code aus der Liste der vorhandenen Codes auswählen.

Betätigen Sie den “+”-Button, um das Mapping hinzuzufügen (oder ein bestehendes Mapping für denselben Shopify-Code zu überschreiben).

Alle Mappings anzeigen / ausblenden

Dieser Button blendet Ihnen zur Übersicht eine Liste aller im Standard definierten Shopify-Codes und zugeordnete Alexa-Codes an, sowie die durch Sie überschriebenen Standard-Mappings, insofern welche vorhanden sind.

Speichern

Über diesen Button speichern Sie die aktuellen Einstellungen. Bitte speichern Sie immer ab, wenn Sie Änderungen vorgenommen haben, damit diese auch wirksam werden.

Betrieb

Im normalen Betrieb des Shops brauchen Sie nach der Einrichtung nichts mehr beachten - die App funktioniert autonom und wird durch Shopify-Webhooks angesteuert.

Metafelder

Die App setzt an Bestellungen, für die erfolgreich eine Alexa Delivery Notification versendet wurde, ein Metafeld mit dem Namen “delivery_notification” im Namespace “alexa_delivery” mit dem Wert “success”.

Es ist in Shopify technisch nicht möglich, von der App aus dieses Feld an der jeweiligen Bestellung einzublenden.

Wenn Sie das Feld im Admin-Bereich einsehen wollen, können Sie eine entsprechende Browser-Erweiterung für Shopify, wie ShopifyFD, nutzen.

FAQ

Warum zeigt die App mir eine Warnmeldung zum Private Key-Format an?

Der Private Key muss genau so, wie er in der PEM-Datei enthalten ist, eingefügt werden. Insbesondere müssen auch die Teile ----BEGIN RSA PRIVATE KEY----- am Anfang der Datei und ----END RSA PRIVATE KEY----- am Ende ebenfalls mitkopiert werden.

Changelog

v1.0.0 (Juli 2020)

• Initiales Release

Support und Kontakt

siehe Support und Kontakt