RevGlanceDocumentazione

Shopify

Collega un negozio Shopify tramite un'app della Dev Dashboard per leggere ordini, rimborsi, commissioni e contratti di abbonamento.

RevGlance legge il tuo negozio tramite la GraphQL Admin API di Shopify. Accede con il client ID e il secret della tua app (il client credentials grant), che funziona solo per i negozi nella stessa organizzazione dell'app.

Collegamento

  1. Nella Dev Dashboard di Shopify, crea un'app nella stessa organizzazione del tuo negozio.
  2. Assegnale gli scope read_orders, read_all_orders, read_own_subscription_contracts e read_customers, pubblica una versione e installa l'app sul tuo negozio.
  3. Dalle Settings dell'app, copia il Client ID e il Client secret (inizia con shpss_).
  4. Inserisci l'indirizzo .myshopify.com del tuo negozio e entrambi i valori, poi scegli Collega Shopify.

Cosa chiede il modulo

CampoEsempio
Storeacme.myshopify.com
Client ID1a2b3c4d5e6f…
Client secretSalvato cifratoshpss_…

Aggiungi il webhook

Shopify firma i suoi webhook con il client secret dell'app, che la fonte possiede già, quindi non c'è alcun segreto da incollare.

  1. In RevGlance, apri Impostazioni › Fonti, apri il menu della fonte Shopify e scegli Webhook. Copia l'URL.
  2. Nella configurazione della tua app, iscriviti ai topic di ordini, rimborsi e contratti di abbonamento con quell'URL come endpoint, e pubblica la modifica.

Cosa sincronizza RevGlance

  • Ordini pagati, al netto delle tasse, nella valuta del negozio, con le commissioni di Shopify Payments. Gli ordini di test vengono esclusi. Lo scope read_all_orders permette alla prima sincronizzazione di andare più indietro dei 60 giorni predefiniti di Shopify.
  • Rimborsi, con le tasse sottratte nella stessa proporzione dell'ordine.
  • Contratti di abbonamento da Shopify Subscriptions e dalle app basate su di esso, per l'MRR. Gli ordini creati da un selling plan contano come ricorrenti.

Shopify non fornisce data né motivo della disdetta, quindi un contratto disdetto termina alla sua ultima modifica.

Come viene calcolato Shopify

  • Gli ordini pagati contano al netto delle imposte, nella valuta dello store, con le commissioni di Shopify Payments come commissione. Gli ordini di prova sono esclusi.
  • I rimborsi includono le imposte, quindi RevGlance sottrae le imposte nella stessa proporzione dell'ordine.
  • L'MRR proviene dai contratti di abbonamento (Shopify Subscriptions e le app basate su di esso), al netto dei loro sconti. Gli ordini creati da un piano di vendita contano come ricorrenti.
  • Shopify non fornisce data né motivo della disdetta: un contratto disdetto, scaduto, non riuscito o in pausa termina alla sua ultima modifica.
  • Un ordine pagato in parte conta ciò che è entrato finora.
  • Dove i prezzi includono le imposte, l'MRR conta al netto delle imposte, nella quota di imposte del primo ordine.
  • I contratti di abbonamento non riportano date di prova, quindi le prove non vengono mostrate.
  • I chargeback non vengono letti, quindi uno perso resta conteggiato come addebito, a meno che il fornitore non lo comunichi anche come rimborso.
  • Gli addebiti non riusciti non vengono riportati, quindi quel valore resta a zero.