Daten von Abonnement-Abrechnungsversuchen abrufen
In Workflows, die Daten zu Abonnement-Abrechnungsversuchen erfordern, kannst du die Aktion Daten von Abonnement-Abrechnungsversuchen abrufen verwenden, um Bestellinformationen aus deinem Shop abzurufen.
Auf dieser Seite
Konfiguration
Felder
Die Aktion Daten von Abonnement-Abrechnungsversuchen abrufen enthält die folgenden Felder, die zur Erstellung der Abfrage verwendet werden:
| Feld | Beschreibung |
|---|---|
| Daten sortieren nach | Erforderlich. Die Parameter, nach denen die von der Suchanfrage zurückgegebenen Daten sortiert werden. |
| Maximale Anzahl an Ergebnissen | Erforderlich. Die maximale Anzahl von Ergebnissen, die von deiner ausgewählten Suchanfrage zurückgegeben werden können. Es können bis zu 100 Ergebnisse auf einmal zurückgegeben werden. |
| Abfrage | Erforderlich. Wähle aus allgemeinen Abfragen oder wähle Erweitert aus, um eine eigene zu erstellen. |
Abfrage-String
Dies ist eine Beispielabfrage zum Abrufen von Abonnement-Abrechnungsversuchen, die in den letzten drei Tagen erstellt wurden:
created_at:>'{{ createdAt | date_minus: "3 day" }}'Die Variable created_at ist ein Filter, der für die Abfrage von Abonnement-Abrechnungsversuchen verfügbar ist und verwendet werden kann, um bestimmte Fehlermeldungen für Abonnement-Abrechnungsversuche auszuwählen.
Beim Abfragen von Daten ist es hilfreich, Folgendes zu wissen:
- Liste der verfügbaren Filter für Abonnement-Abrechnungsversuche
- Suchanfragen müssen einer bestimmten Syntax folgen
- Werte für Abfragefelder sind nicht immer dokumentiert. In einigen Fällen findest du die Werte in der API-Dokumentation. Alternativ findest du die Feldwerte oft in den URLs im Adminbereich, wenn du filterst. Um beispielsweise einige Werte für Bestellungs-Suchanfragen zu finden, filtere die Seite „Bestellungen“ im Adminbereich und überprüfe dann die URL.
- Du kannst eine Suchanfrage in deinem Shop mit der Shopify-GraphiQL-App ausführen oder testen.
- Sei dir bewusst, was passiert, wenn deine Suchanfrage fehlschlägt. Oft gibt die API alle Ergebnisse zurück (anstatt gar keine).
Zurückgegebene Daten
Alle Aktionen vom Typ Daten abrufen geben eine Liste mit 0 bis 100 Ressourcen zurück. Je nach Anwendungsfall kannst du diese Daten auf unterschiedliche Weise verwenden:
- Wenn du jedes Listenelement einzeln verarbeiten musst, z. B. um für jedes Element einen Tag hinzuzufügen, kannst du die Aktion Für jedes verwenden.
- Wenn du Daten aggregieren musst, z. B. um die Anzahl der zurückgegebenen Ergebnisse zu zählen, kannst du die Aktionen Zählen oder Summe verwenden.
- Wenn du die Liste ausgeben musst, z. B. um eine E-Mail mit allen Artikeln zu senden, kannst du die zurückgegebenen Daten direkt in nachfolgenden Aktionen verwenden.
Um in den Schritten, die auf diese Aktion folgen, auf die zurückgegebenen Daten zuzugreifen, verwende die Variable Daten zu Abrechnungsversuchen für Abonnements abrufen. Dies ist eine Liste von Abrechnungsversuchen für Abonnements. Du kannst diese Variable sowohl in Bedingungen als auch in Aktionen verwenden. Du kannst die Liste der Abrechnungsversuche für Abonnements beispielsweise wie folgt in einer Aktion vom Typ Interne E-Mail senden versenden:
{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
{{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}Beispiel
Ein Workflow ist beispielsweise so geplant, dass er jeden Sonntag um 9:00 Uhr ausgeführt wird. Die Aktion Daten zu Abrechnungsversuchen für Abonnements abrufen wird verwendet, um Daten für die in der letzten Woche erstellten Abrechnungsversuche für Abonnements zu erfassen. Wenn sie eine Fehlermeldung enthalten, werden die Abrechnungsversuche per E-Mail gesendet.