RevGlanceDoku

Shopify

Verbinden Sie einen Shopify-Shop über eine Dev-Dashboard-App, um Bestellungen, Rückerstattungen, Gebühren und Abo-Verträge zu lesen.

RevGlance liest Ihren Shop über die GraphQL Admin API von Shopify. Es meldet sich mit der Client-ID und dem Secret Ihrer App an (dem Client-Credentials-Grant), was nur für Shops in der Organisation der App funktioniert.

Verbinden

  1. Erstellen Sie im Shopify Dev Dashboard eine App in derselben Organisation wie Ihr Shop.
  2. Geben Sie ihr die Scopes read_orders, read_all_orders, read_own_subscription_contracts und read_customers, veröffentlichen Sie eine Version und installieren Sie die App in Ihrem Shop.
  3. Kopieren Sie in den Settings der App die Client ID und das Client secret (es beginnt mit shpss_).
  4. Tragen Sie die .myshopify.com-Adresse Ihres Shops und beide Werte ein und wählen Sie dann Shopify verbinden.

Was das Formular abfragt

FeldSieht so aus
Shopacme.myshopify.com
Client-ID1a2b3c4d5e6f…
Client-SecretVerschlüsselt gespeichertshpss_…

Den Webhook hinzufügen

Shopify signiert seine Webhooks mit dem Client-Secret der App, das die Quelle bereits hat, daher gibt es kein Secret einzufügen.

  1. Öffnen Sie in RevGlance Einstellungen › Quellen, öffnen Sie das Menü der Shopify-Quelle und wählen Sie Webhook. Kopieren Sie die URL.
  2. Abonnieren Sie in der Konfiguration Ihrer App die Topics für Bestellungen, Rückerstattungen und Abo-Verträge mit dieser URL als Endpunkt und veröffentlichen Sie die Änderung.

Was RevGlance synchronisiert

  • Bezahlte Bestellungen, vor Steuern, in der Währung des Shops, mit den Gebühren von Shopify Payments. Testbestellungen bleiben außen vor. Mit dem Scope read_all_orders kann die erste Synchronisierung weiter zurückgehen als die standardmäßigen 60 Tage von Shopify.
  • Rückerstattungen, mit abgezogener Steuer im selben Anteil wie auf der Bestellung.
  • Abo-Verträge aus Shopify Subscriptions und darauf aufbauenden Apps, für die MRR. Bestellungen, die ein Selling Plan erzeugt hat, zählen als wiederkehrend.

Shopify liefert kein Kündigungsdatum und keinen Grund, daher endet ein gekündigter Vertrag mit seiner letzten Änderung.

Wie Shopify gezählt wird

  • Bezahlte Bestellungen zählen vor Steuern, in der Währung des Shops, mit den Gebühren von Shopify Payments als Gebühr. Testbestellungen werden nicht berücksichtigt.
  • Rückerstattungen enthalten Steuern, daher zieht RevGlance die Steuer im selben Anteil wie auf der Bestellung ab.
  • Der MRR stammt aus Abonnementverträgen (Shopify Subscriptions und darauf aufbauende Apps), nach deren Rabatten. Von einem Verkaufsplan erzeugte Bestellungen zählen als wiederkehrend.
  • Shopify liefert weder Kündigungsdatum noch Grund: Ein gekündigter, abgelaufener, fehlgeschlagener oder pausierter Vertrag endet mit seiner letzten Änderung.
  • Eine teilweise bezahlte Bestellung zählt mit dem, was bisher eingegangen ist.
  • Wo Preise Steuern enthalten, zählt der MRR vor Steuern, im Steueranteil der ersten Bestellung.
  • Abonnementverträge enthalten keine Testphasendaten, daher werden Testphasen nicht angezeigt.
  • Rückbuchungen werden nicht gelesen, daher bleibt eine verlorene als Zahlung gezählt, sofern der Anbieter sie nicht auch als Rückerstattung meldet.
  • Fehlgeschlagene Zahlungen werden nicht gemeldet, daher bleibt dieser Wert bei null.