Integracje
Podłączenie sklepu — IdoSell, Shoper, Shopify, SOTE, PrestaShop, WooCommerce, Allegro
Jak dodać połączenie ze sklepem, jakich uprawnień potrzebuje klucz API i jak skonfigurować import produktów i zamówień.
4 min czytania
Jeden sklep = jedno połączenie w Kanały sprzedaży → Import danych. Pod połączeniem włączasz osobno rodzaje danych: Produkty i Zamówienia.
Krok 1. Dodaj połączenie
- Dodaj połączenie → wybierz system.
- Podaj nazwę (np. „Sklep główny”, „Allegro Firma”). Ta nazwa będzie widoczna przy każdym zamówieniu i produkcie.
- Wpisz dane dostępowe. Pod polami jest tabela uprawnień, które trzeba włączyć po stronie sklepu — osobno dla produktów i zamówień.
- Testuj połączenie. Wynik widać w kolumnie Test; błąd jest opisany w podpowiedzi.
Skąd wziąć dane dostępowe
| System | Co podać | Gdzie to jest w sklepie |
|---|---|---|
| IdoSell | adres sklepu (np. https://client123.idosell.com), klucz Admin API |
Administracja → Admin API → Klucze API: nowy klucz z dostępem do bram products (produkty, stany) i orders (zamówienia, paczki). W połączeniu podaj też ID magazynu IdoSell (zwykle 1), jeśli Cornvilla ma wysyłać stany |
| Shopify | adres nazwa.myshopify.com, Client ID i Client secret aplikacji |
aplikacja w Dev Dashboard Shopify (zakresy, dostęp do danych klientów, instalacja) — instrukcja krok po kroku: Podłączenie Shopify |
| Shoper | adres sklepu, login i hasło konta API albo token | Konfiguracja → Administracja → Grupy administratorów: grupa z uprawnieniami do produktów, zamówień, stanów (i „Czasy dostawy”, jeśli chcesz zmieniać czas wysyłki) |
| SOTE | adres sklepu, login i hasło konta administratora | Aplikacje → API → Konfiguracja: włącz WebAPI (wersja PRO lub VIP). Kontu, którym łączy się Cornvilla, zaznacz uprawnienia WebAPI „dostęp” i „modyfikacja” — także jeśli to administrator główny, bez nich test pokaże „brak praw odczytu” |
| PrestaShop | adres sklepu, klucz webservice | Parametry zaawansowane → Webservice: włącz usługę, nowy klucz z odczytem products, combinations, orders, customers, addresses i odczytem/zapisem stock_availables, order_histories |
| WooCommerce | adres sklepu, klucz i sekret REST API | WooCommerce → Ustawienia → Zaawansowane → REST API: klucz z uprawnieniem Odczyt i zapis |
| Allegro | logowanie kontem Allegro (OAuth) | kliknij Połącz z Allegro, zaloguj się i zatwierdź dostęp; token odświeża się sam |
Krok 2. Produkty
Kliknij szary przycisk Produkty (z plusem) przy połączeniu. Kreator ma trzy kroki:
- Ustawienia — m.in. kto prowadzi stan: sklep (Cornvilla tylko porównuje) albo Cornvilla WMS (Cornvilla wysyła stany do sklepu). Przy pierwszym imporcie zostaw sklep; wysyłkę stanów włączysz świadomie później — zobacz Stany w sklepach.
- Mapowanie — które pole sklepu trafia do którego pola produktu. Podpowiedzi są gotowe; zwykle nie trzeba nic zmieniać.
- Podgląd i zapis — próba na sucho: ile produktów powstanie, ile się zmieni, co jest błędne. Wybierz harmonogram (np. co godzinę) i zapisz.
Masz kilka sklepów? Ten sam produkt z różnych sklepów łączymy w jeden — po SKU albo po EAN, gdy w sklepach ma inne SKU. Zanim połączymy, sprawdzamy, czy to na pewno ten sam towar (EAN i nazwa). Jeśli w dwóch sklepach ten sam numer oznacza różne produkty, podgląd importu pokaże to jako błąd i niczego nie połączy. Wtedy w mapowaniu wybierz jako SKU kod produktu, a nie numer produktu w sklepie.
Produkty z wariantami (rozmiar, kolor; w IdoSell — rozmiary produktu) trafiają do WMS jako osobne produkty z własnym EAN, zgrupowane w rodzinę. W IdoSell kodem produktu jest kod zewnętrzny rozmiaru, a EAN bierzemy z kodu producenta, gdy ma format EAN.
Krok 3. Zamówienia
Kliknij szary przycisk Zamówienia (z plusem) przy połączeniu. Kreator:
- Ustawienia — z ilu ostatnich dni pobrać zamówienia przy pierwszym imporcie, które statusy sklepu oznaczają „do realizacji”, kod źródła (krótki prefiks numerów zamówień w magazynie, np.
SKLEP). - Mapowanie — gotowe.
- Podgląd i zapis — harmonogram, zwykle co 5 minut.
Po zapisie Cornvilla pobiera zamówienia automatycznie. Nowe zamówienia pojawiają się w Wydania → Zamówienia z nazwą połączenia jako źródłem; adresy odbiorców są szyfrowane i usuwane 30 dni po wysyłce.
Co wraca do sklepu
- Status zamówienia (po pobraniu, po spakowaniu, po przekazaniu kurierowi) — które statusy sklepu ustawić, wybierasz w kreatorze zamówień, krok Opcje → Statusy w źródle.
- Numer przesyłki po wydruku etykiety.
- Stany magazynowe, gdy włączysz „stan prowadzi Cornvilla WMS”.
Importuj teraz
Przyciski Importuj produkty / Importuj zamówienia na końcu wiersza uruchamiają import od ręki. W trakcie widać preloader, a zakładka Historia pokazuje raport każdego uruchomienia.