Integracja z Shopify

SynclyLink łączy się ze sklepem Shopify przez API. Możesz podłączyć wiele sklepów Shopify.

Co umożliwia integracja?

• Import zamówień z Shopify
• Automatyczna rejestracja płatności dla zamówień opłaconych
• Synchronizacja klientów (Shopify → SynclyLink)
• Synchronizacja produktów
• Aktualizacja statusów zamówień (SynclyLink → Shopify)

Podłączanie sklepu Shopify

Integracje → Shopify → Dodaj sklep

Potrzebujesz:

1. Nazwy sklepu Shopify (np. moj-sklep.myshopify.com)
2. API Key i API Secret z panelu Shopify
3. Access Token — wygenerowany w Shopify Admin API

Jak uzyskać dane API w Shopify?

1. Zaloguj się do panelu Shopify
2. Przejdź do Settings → Apps and sales channels → Develop apps
3. Utwórz nową aplikację (Custom App)
4. W zakładce Configuration zaznacz uprawnienia:
   • read_orders, write_orders
   • read_customers
   • read_products, write_products
   • read_inventory, write_inventory
5. Zainstaluj aplikację i skopiuj Admin API access token

Konfiguracja integracji

Po dodaniu sklepu skonfiguruj:

Mapowanie statusów

Określa, jaki status SynclyLink ma zostać nadany zamówieniu w zależności od statusu płatności i realizacji po stronie Shopify.

Mapowanie jest dwuetapowe:

1. Dokładne — dopasowanie po statusie płatności (financial status) i statusie realizacji (fulfillment status)
2. Fallback — dopasowanie tylko po statusie płatności (gdy pole fulfillment jest puste)

Przykładowe mapowanie:

Financial status	Fulfillment status	Status SynclyLink
paid	(dowolny)	W realizacji
paid	fulfilled	Wysłane
pending	(dowolny)	Nowe
refunded	(dowolny)	Anulowane

Mapowanie metod wysyłki

Powiąż nazwy metod wysyłki ze Shopify z kodami metod wysyłki SynclyLink.

Nazwa w Shopify	Kod w SynclyLink
InPost Paczkomat	INPOST
DPD	DPD

Jeśli nazwa z Shopify nie ma mapowania, system użyje jej znormalizowanej formy (wielkie litery, spacje zamienione na _, max 10 znaków).

Mapowanie metod płatności

Powiąż identyfikatory bramek płatniczych z Shopify z kodami metod płatności SynclyLink.

Bramka w Shopify	Kod w SynclyLink
stripe	STRIPE
paypal	PAYPAL
cash_on_delivery	COD

Mapowanie produktów

Powiąż produkty SynclyLink z produktami Shopify po SKU. System będzie aktualizował stany produktów w Shopify.

Automatyczna rejestracja płatności

Przy imporcie zamówienia system sprawdza jego status płatności (financial_status) w Shopify:

• Jeśli zamówienie ma status paid — płatność jest automatycznie rejestrowana w SynclyLink z kwotą brutto, datą zapłaty ze Shopify oraz zmapowaną metodą płatności.
• Pozostałe statusy (pending, partially_paid, refunded itp.) — płatność nie jest rejestrowana automatycznie.

notatka

Automatycznie zarejestrowane płatności są oznaczone notatką „Auto-zarejestrowano z Shopify". Możesz je przejrzeć w zakładce Płatności przy danym zamówieniu.

Synchronizacja

Synchronizacja działa automatycznie co kilka minut (przez Integration Hub). Możesz wymusić ją ręcznie przyciskiem Synchronizuj teraz.

notatka

Zamówienia zaimportowane z Shopify mają prefiks shopify: w identyfikatorze zewnętrznym.