Shopify

Koppel een Shopify-winkel via een Dev Dashboard-app om bestellingen, terugbetalingen, kosten en abonnementscontracten te lezen.

RevGlance leest je winkel via de GraphQL Admin API van Shopify. Het logt in met de client-ID en het clientgeheim van je app (de client credentials grant), wat alleen werkt voor winkels in de eigen organisatie van de app.

Koppelen

Maak in het Shopify Dev Dashboard een app aan in dezelfde organisatie als je winkel.
Geef de app de scopes read_orders, read_all_orders, read_own_subscription_contracts en read_customers, publiceer een versie en installeer de app in je winkel.
Kopieer uit de Settings van de app de Client ID en het Client secret (dat begint met shpss_).
Vul het .myshopify.com-adres van je winkel en beide waarden in, en kies dan Shopify koppelen.

Wat het formulier vraagt

Veld	Ziet eruit als
Winkel	`acme.myshopify.com`
Client-ID	`1a2b3c4d5e6f…`
ClientgeheimVersleuteld opgeslagen	`shpss_…`

Voeg de webhook toe

Shopify ondertekent zijn webhooks met het clientgeheim van de app, dat de bron al heeft, dus er hoeft geen geheim geplakt te worden.

Open in RevGlance Instellingen › Bronnen, open het menu van de Shopify-bron en kies Webhook. Kopieer de URL.
Abonneer je in de configuratie van je app op de topics voor bestellingen, terugbetalingen en abonnementscontracten, met die URL als endpoint, en publiceer de wijziging.

Wat RevGlance synchroniseert

Betaalde bestellingen, exclusief btw, in de valuta van de winkel, met de kosten van Shopify Payments. Testbestellingen blijven buiten beschouwing. Met de scope read_all_orders kan de eerste synchronisatie verder teruggaan dan de standaard 60 dagen van Shopify.
Terugbetalingen, met btw eraf in dezelfde verhouding als op de bestelling.
Abonnementscontracten uit Shopify Subscriptions en apps die daarop gebouwd zijn, voor MRR. Bestellingen die een selling plan heeft aangemaakt, tellen als terugkerend.

Shopify geeft geen opzegdatum of -reden, dus een opgezegd contract eindigt op het moment dat het voor het laatst veranderde.

Hoe Shopify wordt geteld

Betaalde bestellingen tellen vóór belasting, in de valuta van de winkel, met de kosten van Shopify Payments als kosten. Testbestellingen worden weggelaten.
Terugbetalingen bevatten belasting, dus RevGlance haalt de belasting eraf in dezelfde verhouding als op de bestelling.
De MRR komt uit abonnementscontracten (Shopify Subscriptions en apps die daarop zijn gebouwd), na hun kortingen. Bestellingen die door een verkoopplan zijn gemaakt tellen als terugkerend.
Shopify geeft geen opzegdatum of reden: een opgezegd, verlopen, mislukt of gepauzeerd contract eindigt wanneer het voor het laatst is gewijzigd.
Een deels betaalde bestelling telt mee voor wat er tot nu toe is binnengekomen.
Waar prijzen belasting bevatten, telt de MRR vóór belasting, in het belastingaandeel van de eerste bestelling.
Abonnementscontracten bevatten geen proefperiodedatums, dus proefperiodes worden niet getoond.
Chargebacks worden niet gelezen, dus een verloren chargeback blijft als betaling meetellen, tenzij de provider die ook als terugbetaling meldt.
Mislukte betalingen worden niet gemeld, dus dat cijfer blijft op nul.