Shopify

Połącz sklep Shopify przez aplikację z Dev Dashboard, aby odczytywać zamówienia, zwroty, prowizje i umowy subskrypcyjne.

RevGlance odczytuje twój sklep przez GraphQL Admin API Shopify. Loguje się identyfikatorem klienta i sekretem twojej aplikacji (client credentials grant), co działa tylko dla sklepów w organizacji tej aplikacji.

Połączenie

W Shopify Dev Dashboard utwórz aplikację w tej samej organizacji co twój sklep.
Nadaj jej zakresy read_orders, read_all_orders, read_own_subscription_contracts i read_customers, wydaj wersję i zainstaluj aplikację w sklepie.
W Settings aplikacji skopiuj Client ID i Client secret (zaczyna się od shpss_).
Wypełnij adres sklepu .myshopify.com i obie wartości, a potem wybierz Połącz Shopify.

O co pyta formularz

Pole	Wygląda tak
Sklep	`acme.myshopify.com`
Client ID	`1a2b3c4d5e6f…`
Client secretPrzechowywane w postaci zaszyfrowanej	`shpss_…`

Dodawanie webhooka

Shopify podpisuje swoje webhooki sekretem klienta aplikacji, który źródło już ma, więc nie trzeba wklejać sekretu.

W RevGlance otwórz Ustawienia › Źródła, otwórz menu źródła Shopify i wybierz Webhook. Skopiuj adres URL.
W konfiguracji aplikacji zasubskrybuj tematy zamówień, zwrotów i umów subskrypcyjnych z tym adresem URL jako punktem końcowym i wydaj zmianę.

Co synchronizuje RevGlance

Opłacone zamówienia, przed podatkiem, w walucie sklepu, z prowizjami Shopify Payments. Zamówienia testowe są pomijane. Zakres read_all_orders pozwala pierwszej synchronizacji sięgnąć dalej niż domyślne 60 dni Shopify.
Zwroty, z podatkiem odjętym w tej samej proporcji co w zamówieniu.
Umowy subskrypcyjne z Shopify Subscriptions i zbudowanych na nim aplikacji, na potrzeby MRR. Zamówienia utworzone przez plan sprzedaży (selling plan) liczą się jako cykliczne.

Shopify nie podaje daty ani powodu anulowania, więc anulowana umowa kończy się w chwili swojej ostatniej zmiany.

Jak liczony jest Shopify

Opłacone zamówienia liczą się przed podatkiem, w walucie sklepu, z opłatami Shopify Payments jako prowizją. Zamówienia testowe są pomijane.
Zwroty zawierają podatek, więc RevGlance odejmuje podatek w tej samej proporcji co w zamówieniu.
MRR pochodzi z umów subskrypcyjnych (Shopify Subscriptions i aplikacje na nim zbudowane), po rabatach. Zamówienia utworzone przez plan sprzedaży liczą się jako cykliczne.
Shopify nie podaje daty ani powodu anulowania: anulowana, wygasła, nieudana lub wstrzymana umowa kończy się w dniu swojej ostatniej zmiany.
Częściowo opłacone zamówienie liczy się w kwocie, która dotąd wpłynęła.
Tam, gdzie ceny zawierają podatek, MRR liczy się przed podatkiem, w proporcji podatku z pierwszego zamówienia.
Umowy subskrypcyjne nie zawierają dat okresów próbnych, więc okresy próbne nie są pokazywane.
Obciążenia zwrotne nie są odczytywane, więc przegrane nadal liczy się jako płatność, chyba że dostawca zgłosi je też jako zwrot.
Nieudane płatności nie są zgłaszane, więc ta wartość pozostaje na zerze.