RevGlanceDocumentation

Shopify

Connectez une boutique Shopify via une app du Dev Dashboard pour lire les commandes, remboursements, commissions et contrats d’abonnement.

RevGlance lit votre boutique via la GraphQL Admin API de Shopify. Il se connecte avec le client ID et le secret de votre app (le flux client credentials), ce qui ne fonctionne que pour les boutiques de l’organisation de l’app.

Connexion

  1. Dans le Dev Dashboard de Shopify, créez une app dans la même organisation que votre boutique.
  2. Donnez-lui les scopes read_orders, read_all_orders, read_own_subscription_contracts et read_customers, publiez une version et installez l’app sur votre boutique.
  3. Dans les Settings de l’app, copiez le Client ID et le Client secret (il commence par shpss_).
  4. Saisissez l’adresse .myshopify.com de votre boutique et ces deux valeurs, puis choisissez Connecter Shopify.

Ce que demande le formulaire

ChampRessemble à
Boutiqueacme.myshopify.com
Client ID1a2b3c4d5e6f…
Client secretStocké chiffréshpss_…

Ajouter le webhook

Shopify signe ses webhooks avec le client secret de l’app, que la source possède déjà : il n’y a donc aucun secret à coller.

  1. Dans RevGlance, ouvrez Paramètres › Sources, ouvrez le menu de la source Shopify et choisissez Webhook. Copiez l’URL.
  2. Dans la configuration de votre app, abonnez-vous aux topics de commande, de remboursement et de contrat d’abonnement avec cette URL comme endpoint, puis publiez la modification.

Ce que RevGlance synchronise

  • Commandes payées, hors taxes, dans la devise de la boutique, avec les commissions de Shopify Payments. Les commandes de test sont exclues. Le scope read_all_orders permet à la première synchronisation de remonter au-delà des 60 jours par défaut de Shopify.
  • Remboursements, diminués des taxes dans la même proportion que sur la commande.
  • Contrats d’abonnement de Shopify Subscriptions et des apps qui s’appuient dessus, pour le MRR. Les commandes créées par un selling plan comptent comme récurrentes.

Shopify ne fournit ni date ni motif d’annulation : un contrat annulé prend donc fin à sa dernière modification.

Comment Shopify est calculé

  • Les commandes payées comptent hors taxes, dans la devise de la boutique, avec les commissions de Shopify Payments comme commission. Les commandes de test sont exclues.
  • Les remboursements incluent la taxe : RevGlance la déduit donc dans la même proportion que sur la commande.
  • Le MRR provient des contrats d’abonnement (Shopify Subscriptions et apps basées dessus), après leurs remises. Les commandes créées par un plan de vente comptent comme récurrentes.
  • Shopify ne fournit ni date ni motif de annulation : un contrat annulé, expiré, échoué ou suspendu prend fin à sa dernière modification.
  • Une commande partiellement payée compte ce qui a été encaissé jusque-là.
  • Là où les prix incluent la taxe, le MRR compte hors taxes, selon la part de taxe de la première commande.
  • Les contrats d’abonnement ne comportent pas de dates d’essai : les essais ne sont donc pas affichés.
  • Les rétrofacturations ne sont pas lues : une rétrofacturation perdue reste donc comptée comme un paiement, sauf si le fournisseur la signale aussi comme remboursement.
  • Les paiements échoués ne sont pas signalés : ce chiffre reste donc à zéro.