Verwenden Sie diesen Artikel, um die vier vorgefertigten Shopify-Datenconnector-Vorlagen von Fin einzurichten – damit Fin Rückerstattungen berechnen, Guthaben ausstellen und Geschenkkarten während eines Supportgesprächs prüfen oder widerrufen kann, ohne dass ein Teammitglied eingreifen muss.
Datenconnectoren ermöglichen es Fin, während eines Gesprächs externe APIs (application programming interfaces) aufzurufen, um Live-Daten abzurufen oder zu aktualisieren. Die Shopify-Vorlagen sind vorkonfigurierte Connectoren, die im Auftrag von Ihnen die Shopify Admin REST API aufrufen. API scopes sind die spezifischen Berechtigungen, die Ihr Shopify-Shop erteilen muss, bevor ein Connector diese Daten lesen oder schreiben kann.
Was jede Shopify-Vorlage für Kompensation macht
Die vier Shopify-Datenconnector-Vorlagen für Fin sind unten aufgeführt – jede deckt einen anderen Teil des Kompensationsablaufs ab.
Calculate Shopify Refund
Berechnet ein Rückerstattungsangebot – einschließlich erstattungsfähiger Versandkosten, Steuern und des maximal erstattungsfähigen Betrags pro Zahlungstransaktion – ohne Geld zu bewegen. Dies ist eine Trockenübung: Es wird berechnet, wie hoch eine Rückerstattung wäre, bevor etwas ausgezahlt wird. Kombinieren Sie es mit der Aktion Create Shopify Refund, wenn Fin den Betrag vor der Bearbeitung mit dem Kunden bestätigen soll. Schreibt nicht in Shopify.
Issue Shopify Gift Card
Stellt Guthaben als Shopify-Geschenkkarte aus. Shopify sendet den Code direkt per E-Mail an den Kunden – der einlösbare Code wird nie an Fin zurückgegeben oder im Gespräch sichtbar. Fin sieht nur die ID der Karte, das Guthaben, die Währung, das Ablaufdatum und die letzten 4 Zeichen. Diese Vorlage schreibt in Shopify.
Get Shopify Gift Card Balance
Prüft das verbleibende Guthaben, den Anfangswert und das Ablaufdatum einer Shopify-Geschenkkarte eines Kunden. Verwenden Sie dies, wenn ein Kunde fragt, wie viel Guthaben noch vorhanden ist oder ob eine Karte bereits verwendet wurde. Schreibt nicht in Shopify.
Disable Shopify Gift Card
Widerruft eine falsch ausgestellte Geschenkkarte – zum Beispiel, wenn sie für den falschen Betrag, an den falschen Kunden oder irrtümlich ausgestellt wurde. Die Karte funktioniert sofort nicht mehr.
Wichtig: Diese Aktion kann nicht rückgängig gemacht werden – Shopify hat keine Möglichkeit, eine deaktivierte Geschenkkarte wieder zu aktivieren. Wenn eine Karte irrtümlich widerrufen wurde, stellen Sie mit der Vorlage Issue Shopify Gift Card eine Ersatzkarte aus.
Wie man eine Vorlage hinzufügt
Gehen Sie zu Settings > Integrationen > Datenconnectoren > Neu.
Finden Sie die Vorlage, die Sie hinzufügen möchten, im Abschnitt Shopify.
Verbinden (oder wiederverwenden) Sie Ihre Shopify-Shop-Verbindung – die URL der Aktion zielt automatisch auf den Shop, mit dem Ihr Workspace verbunden ist. Es ist keine domänenspezifische Konfiguration pro Aktion erforderlich.
Überprüfen Sie die vorausgefüllten Parameter, die Beschreibung und die Fin-Nutzungshinweise. Klicken Sie auf Live schalten, um die Vorlage zu aktivieren. Sie sehen den Connector als aktiv unter Einstellungen > Integrationen > Datenconnectoren aufgelistet.
Hinweis: Jede Vorlage wird pro Workspace aktiviert. Testen Sie den Connector nach der Aktivierung in einem echten Gespräch – der Vorschau-Modus von Fin führt keine Live-Datenconnector-Aufrufe aus.
Erforderliche Shopify-Berechtigungen
Bevor Sie die Geschenkkartenvorlagen hinzufügen, muss Ihr Shopify-Shop die read_gift_cards- und write_gift_cards-Scopes haben. Shopify gewährt diese nicht standardmäßig – ein Händleradministrator muss sie beim Shopify-Support anfordern.
Wichtig: Alle drei Geschenkkartenvorlagen (Issue Shopify Gift Card, Get Shopify Gift Card Balance, Disable Shopify Gift Card) geben eine Autorisierungsfehlermeldung zurück, bis diese Scopes erteilt sind. Dies ist die wahrscheinlichste Ursache für einen Fehler beim ersten Ausführen. Sobald der Shopify-Support die Scopes erteilt hat, kehren Sie zu Einstellungen > Integrationen > Datenconnectoren zurück, um Ihre Geschenkkartenvorlagen hinzuzufügen oder erneut zu testen – eine Neuinstallation der Shopify-App ist nicht erforderlich.
Die Vorlage Calculate Shopify Refund hat eine separate Anforderung: Sie benötigt den Scope orders oder marketplace_orders, den Shopify standardmäßig gewährt.
Bekannte Einschränkungen
Die folgenden Einschränkungen gelten für die vier Shopify-Datenconnector-Vorlagen für Fin. Jede Einschränkung nennt die betroffene Vorlage oder Vorlagen.
Calculate Shopify Refund – nur Angebote auf Bestell- und Versandebene. Angebote pro Einzelposten werden von dieser Vorlage nicht unterstützt. Der Währungsparameter muss auch genau mit der Währung der Bestellung übereinstimmen, sonst lehnt Shopify die Anfrage ab.
Disable Shopify Gift Card – diese Aktion ist unwiderruflich. Shopify hat keinen API-Endpunkt zum Reaktivieren (die Möglichkeit, eine deaktivierte Karte wiederherzustellen). Wenn eine Karte irrtümlich widerrufen wurde, stellen Sie mit der Vorlage Issue Shopify Gift Card eine Ersatzkarte aus.
Issue Shopify Gift Card – der Geschenkkartencode ist im Gespräch nie sichtbar. Wenn Fin diese Vorlage verwendet, sendet Shopify den Code direkt per E-Mail an den Kunden. Wenn ein Kunde angibt, ihn nicht erhalten zu haben, überprüfen Sie die E-Mail-Adresse im Kundenkonto in Shopify Admin und das Benachrichtigungsprotokoll von Shopify.
Alle vier Vorlagen – Antwortfelder sind auf die in der jeweiligen Vorlage konfigurierten Attribute beschränkt. Nur die explizit in einer Vorlage aufgeführten Antwortattribute sind für Fin lesbar – alle anderen Shopify-Felder werden ausgeblendet und sind nicht verfügbar.
FAQs
Wird Fin den Geschenkkartencode dem Kunden im Gespräch anzeigen?
Wird Fin den Geschenkkartencode dem Kunden im Gespräch anzeigen?
Nein – Fin zeigt den Geschenkkartencode dem Kunden im Gespräch nicht an. Wenn Fin eine Geschenkkarte mit der Vorlage Issue Shopify Gift Card ausstellt, sendet Shopify den Code direkt per E-Mail an den Kunden. Der einlösbare Code wird nie an Fin zurückgegeben oder im Gespräch sichtbar. Fin sieht nur die ID der Karte, das Guthaben, die Währung, das Ablaufdatum und die letzten 4 Zeichen.
Kann Fin eine Rückerstattung berechnen, bevor sie tatsächlich ausgezahlt wird?
Kann Fin eine Rückerstattung berechnen, bevor sie tatsächlich ausgezahlt wird?
Ja – Fin kann eine Rückerstattung berechnen, bevor sie tatsächlich ausgezahlt wird. Die Vorlage Calculate Shopify Refund gibt ein Rückerstattungsangebot zurück – erstattungsfähige Versandkosten, Steuern und den maximal erstattungsfähigen Betrag – ohne Geld zu bewegen. Verwenden Sie sie zusammen mit der bestehenden Aktion Create Shopify Refund, wenn Fin zuerst ein Angebot machen und dann vor der Auszahlung bestätigen soll.
Was passiert, wenn eine Geschenkkarte widerrufen wird?
Was passiert, wenn eine Geschenkkarte widerrufen wird?
Wenn eine Geschenkkarte mit der Vorlage Disable Shopify Gift Card widerrufen wird, funktioniert die Karte sofort nicht mehr und kann nicht wiederhergestellt werden. Shopify hat keinen Endpunkt zum Reaktivieren (die Möglichkeit, eine deaktivierte Karte wiederherzustellen). Wenn eine Karte irrtümlich widerrufen wurde, stellen Sie mit der Vorlage Issue Shopify Gift Card eine Ersatzkarte aus.
Welche Shopify-API-Version verwenden diese Vorlagen?
Welche Shopify-API-Version verwenden diese Vorlagen?
Alle vier Shopify-Kompensations-Datenconnector-Vorlagen laufen gegen die Shopify Admin REST API (application programming interface) Version 2025-04.