Cornvilla
Baza wiedzy

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

  1. Dodaj połączenie → wybierz system.
  2. Podaj nazwę (np. „Sklep główny”, „Allegro Firma”). Ta nazwa będzie widoczna przy każdym zamówieniu i produkcie.
  3. Wpisz dane dostępowe. Pod polami jest tabela uprawnień, które trzeba włączyć po stronie sklepu — osobno dla produktów i zamówień.
  4. 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:

  1. 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.
  2. Mapowanie — które pole sklepu trafia do którego pola produktu. Podpowiedzi są gotowe; zwykle nie trzeba nic zmieniać.
  3. 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:

  1. 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).
  2. Mapowanie — gotowe.
  3. 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.