Integracje: BaseLinker, Allegro, Empik

Skuvero łączy się z systemami, które już masz, i wykorzystuje dane z nich do automatyzacji. Tutaj znajdziesz kompletną instrukcję podpięcia każdego źródła.

Hierarchia integracji

BaseLinker  ← magazyn produktów (źródło wszystkich SKU)
   │
   ├─→ Allegro    (oferty, zamówienia, wiadomości, treści)
   ├─→ Empik      (oferty, zamówienia)
   ├─→ Erli       (oferty, zamówienia)
   ├─→ InPost Buy (zamówienia)
   ├─→ Temu       (zamówienia)
   └─→ Super Merchant (zamówienia)

BaseLinker jest wymagany — bez niego Skuvero nie ma katalogu. Inne integracje są opcjonalne, włącz te które używasz.

1. BaseLinker (wymagane)

Co Skuvero pobiera z BaseLinkera

• Pełna lista produktów (EAN, SKU, nazwa, opis, magazyn, cena bazowa, kategoria)
• Ceny w grupach cenowych (osobne dla Allegro, Empik, Erli…)
• Atrybuty (waga, wymiary, daty ważności)
• Zdjęcia

Co Skuvero wysyła do BaseLinkera

• Zaktualizowane ceny po policzeniu kosztów lub eksperymencie
• Nowe tytuły i opisy z AI (po Twojej akceptacji)
• Zdjęcia AI (po akceptacji)
• Atrybuty produktu (waga, wymiary, daty)
• Statusy zamówień (jeśli chcesz auto-aktualizować)

Konfiguracja

1. Ustawienia → BaseLinker.

2. Token API — wklej tu. Token znajdziesz w panelu BaseLinker:

   • Zaloguj się do BaseLinker.
   • Twoje konto → API → Wygeneruj nowy token.
   • Skopiuj i wklej do Skuvero.

3. Inventory — wybierz magazyn. Większość firm ma jeden — wybierz go. Jeśli masz kilka (np. „Magazyn główny” i „Magazyn rezerw”), wybierz ten z produktami które chcesz sprzedawać.

4. Grupy cenowe — to klucz do działania kosztów. W BaseLinkerze masz grupy cenowe (np. „Allegro”, „Empik”, „Erli”). Skuvero musi wiedzieć, która grupa odpowiada któremu marketplace.

   • Grupa Allegro → wybierz tę z BaseLinkera która zawiera ceny dla Allegro
   • Grupa Empik → analogicznie
   • Grupa Erli → analogicznie
   • Grupa Super Merchant → analogicznie
   • Grupa InPost Buy → analogicznie
   • Grupa Temu → analogicznie

   Jeśli nie używasz danego marketplace — zostaw puste.

5. Auto-sync — opcjonalnie włącz. Wtedy Skuvero co X godzin pobiera świeże ceny i atrybuty z BaseLinkera. Bez tego Skuvero pracuje na stanie z ostatniego ręcznego importu.

6. Sprawdź połączenie — Skuvero próbuje pobrać 1 produkt testowo. Zielony → wszystko OK. Czerwony → sprawdź token.

Pierwsze ściągnięcie produktów

Po podaniu poprawnego tokenu Skuvero w tle ściąga pełen katalog. Małe katalogi (do 1000 SKU) — 1–2 min. Większe (>10000) — do pół godziny.

Postęp widzisz w Ustawienia → BaseLinker → Logi synchronizacji.

Jeśli się zatrzymało — kliknij Pobierz ponownie.

Tokeny — bezpieczeństwo

• Tokeny BaseLinkera są szyfrowane przed zapisem do bazy.
• Nikt z zespołu Skuvero ani inni klienci nie mają dostępu do Twojego tokenu.
• Jeśli token wyciekł — wygeneruj nowy w BaseLinkerze i podmień w Skuvero.

2. Allegro

Co Skuvero pobiera

• Listę aktywnych ofert (do mapowania EAN → numer oferty)
• Zamówienia (dla Optymalizatora cen i statystyk)
• Wiadomości od kupujących (dla modułu Wiadomości AI)
• Kategorie + parametry kategorii (dla Treści AI)
• Prowizje (dla policzenia kosztów)

Co Skuvero wysyła

• Tytuły i opisy (po akceptacji w Treści AI)
• Zdjęcia (po akceptacji w Zdjęciach AI)
• Odpowiedzi na wiadomości od klientów (w Wiadomości AI)
• Ceny (przez BaseLinker — Skuvero nigdy nie wysyła ceny bezpośrednio do Allegro, tylko przez BL)

Konfiguracja

1. Ustawienia → Allegro → Połącz z Allegro.
2. Otworzy się okno Allegro — zaloguj się jeśli trzeba, Zezwól na dostęp.
3. Wracasz do Skuvero. Widzisz zielony status + login Allegro którym połączono.

Uwaga do zaakceptowania uprawnień: Skuvero prosi o szerokie uprawnienia (dostęp do ofert, zamówień, wiadomości). To wymagane żeby moduły działały:

• Bez dostępu do ofert → Treści AI nie pobierze kategorii.
• Bez dostępu do zamówień → Optymalizator cen nie zliczy sprzedaży.
• Bez dostępu do wiadomości → Wiadomości AI nie pobierze wątków.

Jeśli odznaczysz jakieś — odpowiedni moduł nie zadziała, ale reszta tak.

Wiele kont Allegro

W wyższych pakietach możesz podpiąć kilka kont Allegro do jednej organizacji. Przydatne jeśli prowadzisz wiele sklepów (B2C + B2B osobno, multi-niche).

• Ustawienia → Allegro → Dodaj kolejne konto.
• Każde konto ma osobny token, osobne logi, osobne statystyki.

Odnowienie tokenu

Tokeny Allegro tracą ważność co jakiś czas. Skuvero automatycznie odświeża refresh tokenem. Jeśli kompletnie token wygasł (np. konto zostało zablokowane lub zmieniłeś hasło Allegro):

1. Ustawienia → Allegro → Połącz ponownie.
2. Tę samą procedurę co przy pierwszym połączeniu.

3. Empik

Co Skuvero pobiera

• Listę aktywnych ofert (po EAN)
• Kategorie produktu (dla policzenia prowizji)
• Zamówienia (dla Optymalizatora cen)
• Wiadomości od klientów (dla Wiadomości AI — wkrótce)

Konfiguracja

1. Ustawienia → Empik.
2. Token API — wklej. Token z Empika dostajesz mailowo po kontakcie z Empik Marketplace (marketplace@empik.com).
3. URL API — domyślnie https://marketplace.empik.com. Nie zmieniaj jeśli Empik nie powiedział inaczej.
4. Sprawdź połączenie.

Pobranie kategorii

Po skonfigurowaniu Skuvero → Koszty → tab Empik → Sync kategorii. To jednorazowa operacja — pobiera kategorię (category_code) dla każdego produktu który masz na Empiku. Bez tego prowizje liczą się błędnie.

Pierwsze ściągnięcie trwa kilka minut (Empik ma rate limit ~50 req/min).

4. Erli

Erli to nowsza polska platforma podobna do Allegro. Skuvero pobiera oferty i zamówienia, liczy koszty per marketplace.

Konfiguracja

1. Ustawienia → Erli.
2. Klucz API — z panelu Erli (Sprzedawca → Integracje → API).
3. Sprawdź połączenie.

5. InPost Buy

InPost Buy to nowy marketplace InPostu. Skuvero traktuje go jako pełnoprawny tab z własnymi marżami (domyślnie 0% prowizja jako promocja).

Konfiguracja przebiega przez BaseLinkera — jeśli używasz integracji InPost Buy w BL, to wystarczy że w Skuvero Ustawienia → BaseLinker → grupa InPost Buy wybierzesz właściwą grupę cenową. Resztę Skuvero pobiera z BL.

6. Super Merchant

Super Merchant (SM) to platforma B2B. Stała prowizja 3% (lub 0% w promocji).

Konfiguracja jak InPost Buy — przez BaseLinkera.

7. Temu

Temu to chiński marketplace globalny. Prowizja 11% (do ceny kupującego, nie sprzedawcy).

Konfiguracja przez BaseLinkera.

8. E-mail (Wiadomości AI)

Jeśli chcesz odbierać wiadomości klientów z e-maila (np. kontakt@firma.pl, reklamacje@firma.pl) w module Wiadomości AI:

1. Wiadomości AI → Kanały → Dodaj nową skrzynkę.
2. Wypełnij:
   • IMAP host — np. imap.gmail.com, imap.poczta.pl
   • IMAP port — najczęściej 993
   • Login — pełny e-mail
   • Hasło — hasło aplikacji (Gmail wymaga osobnego, nie głównego hasła)
   • SMTP host/port — analogicznie, port 465
   • Folder — zwykle INBOX
3. Sprawdź połączenie.

Skuvero co 10 minut sprawdza skrzynkę i wciąga nowe wiadomości jako wątki. Możesz dodać kilka skrzynek (kontakt@, reklamacje@, zwroty@) — każda jako osobny „kanał” w module Wiadomości.

Co jeśli integracja przestała działać?

1. Ustawienia → [Integracja] → Status. Skuvero pokazuje ostatni czas synchronizacji + ewentualny błąd.
2. Najczęstsze: token wygasł — wygeneruj nowy w panelu integracji, wklej do Skuvero.
3. Rate limit — Skuvero pokaże komunikat. Poczekaj 5 minut, spróbuj ponownie.
4. Brak uprawnień (403) — w Allegro/Empiku sprawdź czy nie odebrano dostępu API. W Allegro przejdź Połącz ponownie.
5. Nadal nie działa? — Pomoc → Kontakt ze wsparciem.

Czego Skuvero nie wysyła automatycznie

Dla Twojego bezpieczeństwa:

• Nie wysyłamy żadnych zmian do BaseLinkera ani Allegro bez Twojego kliknięcia „Wyślij” lub „Akceptuj” (poza synchronizacją cen po Twoim „Przelicz”).
• Auto-actions w Wiadomościach AI są domyślnie wyłączone — AI tylko proponuje, Ty decydujesz.
• Optymalizator cen testuje ceny tylko w wybranych przez Ciebie produktach — i nigdy nie schodzi poniżej Twojego progu marży.

Co dalej?

• Quick Start — pełna ścieżka pierwszego dnia
• Moduły — opis każdego modułu Skuvero