RevGlanceתיעוד

Shopify

לחבר חנות Shopify דרך אפליקציה ב-Dev Dashboard כדי לקרוא הזמנות, החזרים, עמלות וחוזי מנוי.

RevGlance קוראת את החנות שלך דרך GraphQL Admin API של Shopify. היא מתחברת עם ה-client ID וה-secret של האפליקציה (ה-client credentials grant), וזה עובד רק עבור חנויות בארגון של האפליקציה עצמה.

חיבור

  1. ב-Dev Dashboard של Shopify, ליצור אפליקציה באותו ארגון שבו נמצאת החנות.
  2. לתת לה את ההרשאות read_orders, read_all_orders, read_own_subscription_contracts ו-read_customers, לשחרר גרסה ולהתקין את האפליקציה בחנות.
  3. מתוך Settings של האפליקציה, להעתיק את ה-Client ID ואת ה-Client secret (הוא מתחיל ב-shpss_).
  4. למלא את כתובת ה-.myshopify.com של החנות ואת שני הערכים, ואז לבחור חיבור Shopify.

מה הטופס מבקש

שדהנראה כך
חנותacme.myshopify.com
Client ID1a2b3c4d5e6f…
Client secretנשמר מוצפןshpss_…

הוספת ה-webhook

Shopify חותמת על ה-webhooks שלה עם ה-client secret של האפליקציה, שכבר שמור במקור, כך שאין סוד להדביק.

  1. ב-RevGlance, לפתוח את הגדרות › מקורות, לפתוח את התפריט של מקור ה-Shopify ולבחור Webhook. להעתיק את ה-URL.
  2. בהגדרות התצורה של האפליקציה, להירשם ל-topics של הזמנות, החזרים וחוזי מנוי עם ה-URL הזה כנקודת הקצה, ולשחרר את השינוי.

מה RevGlance מסנכרנת

  • הזמנות ששולמו, לפני מס, במטבע של החנות, עם העמלות של Shopify Payments. הזמנות בדיקה נשארות בחוץ. ההרשאה read_all_orders מאפשרת לסנכרון הראשון להגיע רחוק יותר מברירת המחדל של Shopify, 60 יום.
  • החזרים, בניכוי מס באותו יחס כמו בהזמנה.
  • חוזי מנוי מ-Shopify Subscriptions ומאפליקציות שבנויות עליו, עבור MRR. הזמנות שנוצרו מ-selling plan נספרות כחוזרות.

Shopify לא מוסרת תאריך ביטול או סיבה, ולכן חוזה שבוטל מסתיים במועד שבו השתנה לאחרונה.

איך Shopify נספרת

  • הזמנות ששולמו נספרות לפני מס, במטבע של החנות, עם העמלות של Shopify Payments כעמלה. הזמנות בדיקה לא נכללות.
  • החזרים כוללים מס, ולכן RevGlance מוריד את המס באותו יחס כמו בהזמנה.
  • ה-MRR מגיע מחוזי מנוי (Shopify Subscriptions ואפליקציות שבנויות עליו), אחרי ההנחות שלהם. הזמנות שנוצרו מ-selling plan נספרות כחוזרות.
  • Shopify לא מספקת תאריך ביטול או סיבה: חוזה שבוטל, שפג תוקפו, שנכשל או שהושהה מסתיים במועד שבו השתנה לאחרונה.
  • הזמנה ששולמה בחלקה נספרת לפי מה שנכנס עד כה.
  • היכן שהמחירים כוללים מס, ה-MRR נספר לפני מס, לפי חלק המס בהזמנה הראשונה.
  • חוזי מנוי לא כוללים תאריכי תקופת ניסיון, ולכן תקופות ניסיון לא מוצגות.
  • ביטולי עסקה לא נקראים, ולכן ביטול עסקה שהפסדת נשאר ספור כחיוב, אלא אם הספק מדווח עליו גם כהחזר.
  • אין דיווח על חיובים שנכשלו, ולכן הנתון הזה נשאר אפס.