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
- W BaseLinkerze: Moje konto → API → Wygeneruj token.
- 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
- Kanały sprzedaży → Import danych → Dodaj połączenie → BaseLinker.
- Nazwa (np. „BaseLinker”), token.
- 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.
- 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:
- 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. - 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” zostajeA-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.