Cornvilla
Baza wiedzy

Integracje

Podłączenie BaseLinkera

Jak połączyć Cornvilla z BaseLinkerem: token API, katalog produktów z wariantami, zamówienia ze wszystkich kanałów, statusy, numery przesyłek i stany.

4 min czytania

Z BaseLinkerem Cornvilla rozmawia przez jedno połączenie. BaseLinker zostaje centrum sprzedaży (sklepy, Allegro, Amazon, Empik…), a Cornvilla prowadzi magazyn. Nic nie trzeba przepinać w sklepach.

Co przepływa

Kierunek Dane
BaseLinker → Cornvilla produkty z katalogu (z wariantami, EAN, wagą, zdjęciami), zamówienia ze wszystkich kanałów (także paczkomat, pobranie, informacja o opłaceniu i anulowaniu)
Cornvilla → BaseLinker status zamówienia, numer przesyłki i przewoźnik, stan magazynowy w katalogu

Krok 1. Token API w BaseLinkerze

  1. W BaseLinkerze: Moje konto → API → Wygeneruj token.
  2. Skopiuj token. Jest widoczny tylko raz; w razie czego wygenerujesz nowy.

Limit BaseLinkera (100 zapytań na minutę) Cornvilla pilnuje sama — nie trzeba niczego ustawiać.

Krok 2. Połączenie w Cornvilla

  1. Kanały sprzedaży → Import danych → Dodaj połączenie → BaseLinker.
  2. Nazwa (np. „BaseLinker”), token.
  3. Katalog — jeśli masz kilka katalogów (inventory), wybierz ten, z którego mają iść produkty i do którego mają wracać stany. Przy jednym katalogu wybiera się sam.
  4. Testuj połączenie → Zapisz.

Krok 3. Produkty i zamówienia

  • Przycisk Produkty: produkty z wariantami stają się osobnymi produktami WMS z EAN wariantu, zgrupowanymi w rodzinę. Stan prowadzi na razie BaseLinker; wysyłkę stanów włączysz później.
  • Przycisk Zamówienia: wybierz statusy BaseLinkera, które oznaczają zamówienie do realizacji (np. „Nowe – opłacone”), i kod źródła. Zamówienia pobierają się co 5 minut, ze wszystkimi kanałami naraz.

Zamówienie w Cornvilla pamięta kanał z BaseLinkera (np. „Allegro”, „Sklep Shoper”), więc filtr źródeł w zamówieniach działa jak zwykle.

Statusy i numery przesyłek z powrotem

W kreatorze zamówień, krok Opcje → Statusy w źródle, przypisz zdarzeniom w Cornvilla (po pobraniu, po spakowaniu, po przekazaniu kurierowi) statusy BaseLinkera i zaznacz Wysyłaj numer przesyłki. Po wydruku etykiety Cornvilla dopisuje do zamówienia paczkę z numerem i przewoźnikiem — BaseLinker rozsyła to dalej do sklepów i marketplace'ów tak, jak ma skonfigurowane.

Jeśli etykiety generujesz w BaseLinkerze, a nie w Cornvilla, nie zaznaczaj wysyłki numeru przesyłki — statusy i tak wrócą.

Lokalizacje i stany z BaseLinkera (przesiadka)

Jeśli w BaseLinkerze masz wpisane lokalizacje produktów (karta produktu → Sprzedaż i magazyn → Lokalizacja w magazynie), Cornvilla może je pobrać razem z produktami, zamiast rozkładać towar od nowa:

  1. Import danych → połączenie BaseLinker → Produkty → ustawienia importu → Lokalizacje z BaseLinkera: Lokalizacje (bez stanów) albo Lokalizacje i stany. Opcjonalnie wskaż magazyn BaseLinkera (np. bl_123); puste = domyślny magazyn katalogu.
  2. Testuj (podgląd) — zobaczysz, ile produktów dostanie miejsce i jakie lokacje powstaną. Potem Importuj.

Co się dzieje:

  • Każda lokalizacja z BaseLinkera staje się lokacją luźną w Cornvilla: miejscem składowania bez regału, z kodem z nazwy (np. „pod stołem” → POD-STOLEM, „A-5-2” zostaje A-5-2) i nazwą w opisie. Towar kompletuje się z niej jak z regału. Gdy kiedyś narysujesz regały, przeniesiesz towar terminalem.
  • Produkt z kilkoma lokalizacjami: pierwsza to główne miejsce kompletacji, pozostałe zapas.
  • Lokalizacje i stany dociąga dodatkowo łączny stan produktu w Cornvilla do stanu z BaseLinkera: różnica trafia na pierwszą lokalizację, to, co już leży w pozostałych, zostaje. Jeśli wolisz policzyć towar sam, wybierz Lokalizacje (bez stanów).
  • Pole Lokalizacje z BaseLinkera dotyczą: domyślnie tylko produktów bez miejsca w Cornvilla. Lokalizacje i stany wchodzą raz, przy pierwszym imporcie; produkt, który ma już miejsce w Cornvilla, jest pomijany, więc to, co potem poukładasz i policzysz w magazynie, zostaje, a stan dalej prowadzi Cornvilla i wysyła go do BaseLinkera. Wszystkich produktów, przy każdym imporcie wybierz tylko wtedy, gdy to BaseLinker ma prowadzić lokalizacje i stany (wtedy nie włączaj wysyłki stanów z Cornvilla do BaseLinkera).
  • Import możesz powtórzyć: nowe produkty dostaną lokalizacje, nic się nie dubluje. Po przesiadce możesz odpiąć BaseLinkera — stany i lokacje zostają.

Wynik lokalizacji widać w historii importu obok wyniku produktów („lokacje +nowe ~zmienione”).

Stany do katalogu

Kanały sprzedaży → Stany w sklepach → karta BaseLinker → Stan prowadzi WMS → bufor, limit → podgląd → Włącz wysyłkę. Cornvilla ustawia stan w domyślnym magazynie katalogu, a BaseLinker rozsyła go do kanałów. Szczegóły zasad: Stany w sklepach.

Najczęstsze pytania

Czy mogę mieć jednocześnie BaseLinkera i bezpośrednie połączenie z Allegro? Nie dla tego samego konta — zamówienia przyszłyby dwa razy. Wybierz jedną drogę.

Zamówienie zostało anulowane w BaseLinkerze po imporcie. Cornvilla przy kolejnym imporcie oznacza je jako „Anulowane w sklepie”; jeśli jest już w kompletacji, zamówienie dostaje widoczny znacznik, a towar wraca na półkę po decyzji kierownika.