Podłączenie Shopify

Shopify od 2026 roku nie pozwala tworzyć prostych „aplikacji” w panelu sklepu. Dostęp dla Cornvilla zakładasz raz, w Dev Dashboard Shopify (darmowym panelu dla aplikacji), a do Cornvilla wpisujesz dwa klucze: Client ID i Client secret. Zajmuje to około 10 minut.

Co przepływa

Kierunek	Dane
Shopify → Cornvilla	produkty z wariantami (SKU, kod kreskowy, waga, zdjęcie), zamówienia z adresem dostawy, płatnością (także pobranie), punktem odbioru i informacją o anulowaniu
Cornvilla → Shopify	tag zamówienia (np. „spakowane”), realizacja z numerem przesyłki i linkiem śledzenia, stan magazynowy

Krok 1. Aplikacja w Dev Dashboard

1. Wejdź na dev.shopify.com i zaloguj się tym samym kontem, którym logujesz się do sklepu.
2. Apps (Aplikacje) → Create app (Utwórz aplikację) → nazwa, np. „Cornvilla WMS”.
3. Otwórz Versions (Wersje) → Create version (Utwórz wersję):
   • App URL — wpisz https://cornvilla.com (pole jest wymagane, ale nie ma znaczenia dla połączenia); jeśli jest opcja „Embed app in Shopify admin”, odznacz ją;
   • Scopes (Zakresy) — wklej:

     read_products,read_inventory,write_inventory,read_locations,read_orders,write_orders,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders
     

   • zapisz i kliknij Release (Wydaj).

Krok 2. Dostęp do danych klientów

Shopify traktuje całe zamówienie (imię, adres, telefon, e-mail) jako chronione dane klienta. Bez tej zgody Cornvilla nie pobierze żadnego zamówienia — nawet z uprawnieniem do zamówień.

1. W ustawieniach aplikacji znajdź API access (Dostęp do API) → Protected customer data access (Dostęp do chronionych danych klienta). Jeśli w Dev Dashboard nie ma tej sekcji, wejdź na partners.shopify.com → Apps → Twoja aplikacja → API access.
2. Request access (Poproś o dostęp):
   • Protected customer data — powód: „Realizacja zamówień w systemie magazynowym”;
   • pola Name, Email, Phone, Address — powód: „Etykiety wysyłkowe dla kuriera”.
3. Przy pytaniach o ochronę danych możesz zaznaczyć, że dane są szyfrowane i usuwane 30 dni po wysyłce — tak działa Cornvilla.

Krok 3. Instalacja w sklepie

Na stronie głównej aplikacji kliknij Install app (Zainstaluj aplikację), wybierz swój sklep i zatwierdź uprawnienia.

Po każdej zmianie zakresów trzeba wydać nową wersję (Release) i ponownie zatwierdzić uprawnienia w sklepie.

Krok 4. Połączenie w Cornvilla

1. W ustawieniach aplikacji (Settings) skopiuj Client ID i Client secret (sekret odsłaniasz ikonką oka).
2. W Cornvilla: Kanały sprzedaży → Import danych → Dodaj połączenie → Shopify:
   • Adres sklepu — nazwa-sklepu.myshopify.com (także gdy sklep ma własną domenę; adres *.myshopify.com znajdziesz w Shopify → Ustawienia → Domeny),
   • Client ID i Client secret,
   • Lokalizacja magazynu — zostaw puste albo wpisz nazwę lokalizacji Shopify, z której wysyłasz (patrz „Stany” niżej).
3. Pole Token Admin API zostaw puste. Służy tylko starym aplikacjom z panelu sklepu (token shpat_…). Nie wpisuj tam „tokenu automatyzacji aplikacji” (atkn_…) z ustawień aplikacji — to nie jest dostęp do sklepu.
4. Testuj połączenie → Zapisz. Po zapisaniu sekret wyświetla się jako kilka gwiazdek — to maska, nic nie zostało ucięte.

Krok 5. Produkty i zamówienia

• Przycisk Produkty: produkt z jednym wariantem staje się jednym produktem WMS, produkt z wariantami (rozmiar, kolor) — osobnymi produktami w rodzinie. Kod kreskowy wariantu trafia jako EAN. Produkty bez SKU dostają kod techniczny SH… — warto uzupełnić SKU w Shopify.
• Przycisk Zamówienia: z ilu dni pobrać zamówienia i kod źródła (prefiks numerów w magazynie, np. SHOP). Numer zamówienia to numer z Shopify bez „#” (np. 1001). Pobierane są tylko pozycje wymagające wysyłki.

Punkt odbioru (paczkomat) Cornvilla odczytuje z atrybutu zamówienia, który zapisuje aplikacja przewoźnika, albo z kodu w nazwie dostawy, np. „InPost Paczkomat (LOD62M)”.

Statusy i numery przesyłek

Shopify nie ma własnych statusów zamówień, więc w kreatorze zamówień (Opcje → Statusy w źródle) do wyboru są:

• Dodaj tag „w realizacji”, „spakowane” albo „wysłane” — widoczny na liście zamówień w Shopify,
• Oznacz jako zrealizowane — bez numeru przesyłki.

Po zaznaczeniu Wysyłaj numer przesyłki Cornvilla po wydruku etykiety oznacza zamówienie jako zrealizowane z numerem i przewoźnikiem. Shopify sam dodaje link śledzenia (InPost, DPD…) i wysyła klientowi e-mail o wysyłce. Gdy zamówienie zrealizowano wcześniej ręcznie w Shopify, Cornvilla tylko dopisuje numer.

Stany

Kanały sprzedaży → Stany w sklepach → karta Shopify → Stan prowadzi WMS → bufor, limit → podgląd → Włącz wysyłkę.

Shopify trzyma stany osobno dla każdej lokalizacji (magazyn, sklep stacjonarny). Cornvilla wysyła stan do jednej:

• wskazanej w połączeniu (pole „Lokalizacja magazynu”), albo
• gdy pole jest puste — do tej, w której prowadzonych jest najwięcej produktów.

Główna lokalizacja sklepu nie zawsze jest magazynem, dlatego przy kilku lokalizacjach najlepiej wpisać nazwę wprost. Produkt z wyłączonym Śledź ilość ma w podglądzie status „dostępność ręczna” i nie dostaje stanu. Szczegóły zasad: Stany w sklepach.

Najczęstsze problemy

„Shopify odmówił dostępu (401)”. Najczęściej w polu „Token Admin API” jest coś wpisane (np. token atkn_…). Wyczyść to pole — Cornvilla użyje Client ID i secret. Sprawdź też, czy aplikacja jest zainstalowana w sklepie.

„This app is not approved to access the Order object”. Brak zgody na chronione dane klienta — wróć do kroku 2.

Stany się nie zmieniają. Sprawdź, czy produkty są prowadzone w lokalizacji, do której Cornvilla wysyła stan (Shopify → produkt → Stany magazynowe), albo wpisz właściwą lokalizację w połączeniu.