RevGlanceالمستندات

Shopify

اربط متجر Shopify عبر تطبيق في Dev Dashboard لقراءة الطلبات والمبالغ المستردة والرسوم وعقود الاشتراك.

يقرأ RevGlance متجرك عبر GraphQL Admin API من Shopify. يسجّل الدخول بمعرّف العميل وسرّه الخاصين بتطبيقك (منح client credentials)، وهذا لا يعمل إلا مع المتاجر التابعة لمؤسسة التطبيق نفسها.

الربط

  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
معرّف العميل1a2b3c4d5e6f…
سرّ العميلمخزّن بتشفيرshpss_…

إضافة Webhook

توقّع Shopify رسائل Webhook بسرّ العميل الخاص بالتطبيق، الذي يحمله المصدر أصلًا، فلا يوجد سرّ للصقه.

  1. في RevGlance، افتح الإعدادات › المصادر، وافتح قائمة مصدر Shopify واختر Webhook. انسخ العنوان.
  2. في إعدادات تطبيقك، اشترك في موضوعات الطلبات والمبالغ المستردة وعقود الاشتراك مع ذلك العنوان كنقطة نهاية، وأصدر التغيير.

ما يزامنه RevGlance

  • الطلبات المدفوعة، قبل الضريبة، بعملة المتجر، مع رسوم Shopify Payments. تُستبعد الطلبات التجريبية. يتيح النطاق read_all_orders للمزامنة الأولى الرجوع إلى ما قبل الأيام الستين الافتراضية في Shopify.
  • المبالغ المستردة، مع طرح الضريبة بالنسبة نفسها التي في الطلب.
  • عقود الاشتراك من Shopify Subscriptions والتطبيقات المبنية عليها، من أجل MRR. تُحتسب الطلبات التي أنشأتها خطة بيع على أنها متكررة.

لا تقدّم Shopify تاريخ الإلغاء ولا سببه، لذا ينتهي العقد المُلغى عند آخر تغيير طرأ عليه.

كيف يُحسب Shopify

  • تُحتسب الطلبات المدفوعة قبل الضريبة، بعملة المتجر، مع رسوم Shopify Payments كرسوم. وتُستبعد الطلبات التجريبية.
  • تشمل المبالغ المستردة الضريبة، لذا يطرح RevGlance الضريبة بالنسبة نفسها كما في الطلب.
  • يأتي MRR من عقود الاشتراك (Shopify Subscriptions والتطبيقات المبنية عليها)، بعد خصوماتها. وتُحتسب الطلبات التي أنشأتها خطة بيع كطلبات متكررة.
  • لا يوفّر Shopify تاريخ الإلغاء ولا سببه: ينتهي العقد الملغى أو المنتهي أو الفاشل أو الموقوف مؤقتًا عند آخر تغيير له.
  • يُحتسب الطلب المدفوع جزئيًا بما وصل منه حتى الآن.
  • حيث تشمل الأسعار الضريبة، يُحتسب MRR قبل الضريبة، بحصة الضريبة في أول طلب.
  • لا تتضمن عقود الاشتراك تواريخ الفترات التجريبية، لذا لا تظهر الفترات التجريبية.
  • لا تُقرأ عمليات ردّ المبلغ، لذا يبقى الردّ الخاسر محتسبًا دفعةً ما لم يُبلغ عنه المزوّد أيضًا كاسترداد.
  • لا يُبلَّغ عن الدفعات الفاشلة، لذا يبقى هذا الرقم صفرًا.