Elbuz pobiera produkty bezpośrednio z marketplace’u, sklepu internetowego lub systemu księgowego za pomocą kluczy dostępu i aktualizuje nimi katalog bazowy według harmonogramu — bez eksportowania i importowania plików.
Kiedy to się przyda:
- Produkty są już na Rozetce, Shopify lub innej platformie — jeden przebieg przenosi je do katalogu Elbuz z kategoriami, zdjęciami i cechami.
- Ceny i stany na platformie zmieniają się codziennie — szablon w harmonogramie sam je aktualizuje.
- Sprzedajesz na kilku platformach — produkty ze wszystkich trafiają do jednego katalogu.
- Część kart prowadzisz ręcznie — przełącznik „Nie aktualizuj” chroni je przed przebiegiem.
Od czego zacząć: znajdź swoją platformę na liście i weź klucze dostępu z jej panelu.
Co potrafi import katalogu przez API
- Przeniesienie katalogu — nazwy, ceny, stany, kategorie, zdjęcia i cechy przychodzą bezpośrednio, w stanie aktualnym na moment zapytania.
- Kategorie i producenci — są odnajdywani wśród Twoich po nazwie, a brakujący są tworzeni.
- Ochrona Twoich zmian — przełączniki „Nie aktualizuj” i „Stała cena” w karcie produktu.
- Zamówienia tym samym połączeniem — na większości platform włączane osobnym przełącznikiem.
- Aktualizacja według harmonogramu — katalog aktualizuje się sam, każde zapytanie zostawia ślad w dzienniku.
wybiera się wtedy, gdy druga strona to system z własnym interfejsem programistycznym, a Ty masz do niego dostęp (klucze, token lub login integracji). Największe platformy mają osobne artykuły z ich kluczami i specyfiką:
| Źródło | Co importuje |
|---|---|
| Rozetka.UA | katalog + zamówienia |
| Shopify | katalog + zamówienia |
| WooCommerce (WordPress) | katalog + zamówienia |
| Amazon | katalog + zamówienia |
| eBay | katalog + zamówienia |
| Allegro.pl | katalog + zamówienia |
| eMAG (RO/BG/HU) | katalog + zamówienia |
| Kaufland (DE/EU) | katalog + zamówienia |
| Wix.com | katalog + zamówienia |
| Etsy | katalog + zamówienia |
| TikTok Shop | katalog + zamówienia |
| OLX | tylko katalog |
| Horoshop | katalog + zamówienia |
| SalesDrive (CRM) | katalog + zamówienia |
Lista w oknie importu jest szersza i stale się powiększa. Integracje, które przynoszą tylko zamówienia (kasy, część marketplace’ów), zebrano w przeglądzie importu zamówień przez API.
1
Dostępne typy połączeń- Dostępne typy połączeń — wszystkie źródła API są zebrane na tej jednej liście.
Czego potrzeba od platformy: klucze dostępu
Klucze wydaje sam system źródłowy: prawie każdy marketplace czy platforma ma sekcję dla deweloperów lub integracji, w której tworzy się klucz, token albo parę „login i hasło aplikacji”. Dla jednych serwisów wystarczy jeden token, dla innych potrzeba kilku wartości — dokładną listę znajdziesz w artykule każdej platformy z listy.
Przechowuj klucze jak hasło i nie przekazuj ich osobom trzecim. Skompromitowany klucz odwołaj w panelu źródła, wygeneruj nowy i zaktualizuj go w szablonie.
Jak połączyć
- Utwórz szablon i wybierz potrzebną integrację z listy.
- Wpisz klucze dostępu i kliknij „Sprawdź połączenie” (jest w większości połączeń, w szablonie Rozetka go nie ma). Przycisk łączy się z platformą tymi samymi kluczami co przebieg i odpowiada nazwą sklepu lub treścią odmowy — tak szybciej znajdziesz zbędną spację w tokenie.
- W sekcji „Wybór danych do importu” włącz zestawy danych (jakie są). Produkty i zamówienia to osobne przełączniki: jeśli włączysz tylko zamówienia, produkty nie przyjdą, i odwrotnie.
- Kliknij „Importuj” wtedy, gdy możesz od razu obejrzeć wynik. Sprawdź na kilku produktach nazwy, ceny, zdjęcia i kategorie, a także co stało się z kartami, które już miałeś (jak je znaleźć).
- Gdy wszystko działa, ustaw szablon w harmonogramie.
Jeden szablon — jedno połączenie z jednym kontem. Dla każdej platformy czy konta tworzy się osobny szablon z własnymi kluczami i harmonogramem.
Co trafia do katalogu
Przez API do katalogu trafia to samo co z pliku: nazwy, ceny, stany, kategorie, zdjęcia i cechy — dokładnie to, co system źródłowy udostępnia w swoim interfejsie. Różnica polega na tym, że dane są zawsze świeże: nie migawka z chwili eksportu, a stan na moment zapytania.
W szablonie włącza się zestawy danych: „Produkty”, „Kategorie”, „Zdjęcia”, „Atrybuty”, „Opcje”, „Producenci”, „Zamówienia”. Wyboru pojedynczych pól nie ma: przy włączonych „Produktach” nazwa, opis, cena i stan przychodzą jednym pakietem.
Produkty się nie dublują: program szuka założonej karty po parze „kod producenta + nazwa” (marketplace’y zwykle nie udostępniają kodu producenta, więc w praktyce — po nazwie). Znalezioną kartę przebieg nadpisuje, zamiast dodawać drugą.
Kategorie i producenci tworzeni przez przebieg
Kategoria przychodzi ze źródła jako nazwa lub pełna ścieżka. Program najpierw szuka Twojej kategorii o tej samej nazwie i umieszcza w niej produkt, a dopiero gdy jej nie znajdzie — tworzy nową gałąź. Dlatego duplikaty w rodzaju „Laptopy (2)” się nie pojawiają, dopóki nazwy się zgadzają.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
- Produkty bez kategorii trafiają do kategorii technicznej „Produkty - kod źródła”, tworzonej jako wyłączona i pominięta w eksportach. Swobodnie rozkładaj z niej karty: kolejny przebieg nie zmienia miejsca w drzewie. Usunięta kategoria pojawi się znowu, pusta, gdy tylko w źródle znajdą się produkty bez kategorii. Kolejność rozkładania — w przeglądzie importu danych.
- Producenci są zakładani tak samo: nowa marka ze źródła trafia do słownika ze znacznikiem połączenia. Nie zmieniaj nazw takich marek: następny przebieg nie znajdzie marki pod nową nazwą, założy ją ponownie pod starą i przepnie do niej produkty. Nazwę marki zmieniaj po stronie platformy.
Jakim dokumentem trafia zamówienie
Jeśli przełącznik „Zamówienia” jest włączony, każde zamówienie z platformy jest zakładane jako dokument „Zamówienie klienta” — niezatwierdzony. Sam typ dokumentu nie zdejmuje towaru ze stanu, a rezerwacja pojawia się dopiero po zatwierdzeniu: import zamówień nie ruszy dostępności w katalogu.
Status dokumentu pochodzi z dopasowania statusów platformy do Twoich — przyciskami „Statusy zamówienia”, „Statusy dostawy” i „Statusy płatności” w sekcji „Powiązane ustawienia” karty szablonu. Niedopasowany status daje pierwszy status ze słownika — „jak nowe”.
Ponowny import nie tworzy duplikatu: dokument jest wyszukiwany po numerze zamówienia w źródle razem z kodem źródła. Jak zamówienie przechodzi wyszukiwanie klienta i produktów — w przeglądzie importu zamówień.
Co kolejny przebieg robi z Twoimi zmianami
Kolejna aktualizacja nadpisuje wszystko, co platforma zwróciła w tym przebiegu: nazwę, opis, cenę, starą cenę, liczbę sztuk, dostępność, markę, kod produktu, tagi i znacznik „włączony/wyłączony”. Jeśli poprawisz nazwę albo dopiszesz opis w Elbuz, następny przebieg bez ostrzeżenia przywróci tekst z platformy.
Czego kolejny przebieg w założonych już produktach nie rusza:
- Zdjęcia. Zdjęcia są dodawane tylko nowym kartom: podmienione przez Ciebie zdjęcie nie zostanie nadpisane, ale też nowe zdjęcia z platformy do starej karty nie dotrą.
- Cechy. Istniejące wartości zostają. Wyjątek — Rozetka: dopisuje te, których w karcie jeszcze nie ma, nie ruszając istniejących.
- Miejsce w drzewie kategorii. Jeśli przeniesiesz kartę do własnej kategorii — tam zostanie. Wyjątek — Horoshop: karcie bez „Nie aktualizuj” ustawia kategorię, którą produkt ma na stronie.
- Adres strony (przyjazny URL). Ustawiany jest tylko w chwili tworzenia karty.
Aby zablokować całą kartę, otwórz ją, sekcja „Ochrona podczas importu”, przełącznik „Nie aktualizuj”. W takiej karcie przebieg nie zmienia ani ceny, ani stanu, ani dostępności, ani marki.
W bezpośrednich połączeniach z platformami flaga chroni też nazwę i opis; w imporcie z SalesDrive nazwę i opis feed nadpisze mimo niej. Ta sama flaga jest kolumną „Nie aktualizować (flaga)” w oknie „Produkty” — wygodnie po niej filtrować i ustawiać flagę bezpośrednio w tabeli.
1
Nie aktualizuj2
Stała cena- Nie aktualizuj — import nie rusza tego produktu.
- Stała cena — import nie zmienia ceny produktu.
Sąsiedni przełącznik „Stała cena” chroni tylko ceny. W bezpośrednich połączeniach — Rozetka, Horoshop, Shopify, eBay, Wix, Amazon, Allegro, eMAG, WooCommerce, Kaufland, OLX, Etsy, TikTok Shop — przebieg nie nadpisuje cen takiego produktu, a nazwę, opis, stan i dostępność aktualizuje jak zwykle.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Dwie platformy zapisują do jednej karty
Jeśli dwa połączenia pobierają ten sam produkt, trafiają do jednej karty: jest ona wyszukiwana po nazwie (i po kodzie producenta, gdy źródło go podaje), a nie po platformie. W polu zostaje wartość z przebiegu, który zakończył się ostatni; priorytetu źródeł w szablonach nie ma.
Znacznik „Źródło: nazwa” w karcie się przy tym nie przełącza — zostaje w nim szablon, który utworzył kartę, więc nie da się po nim sprawdzić, kto ostatni zapisał cenę. Rozdzielić dwa źródła można tylko przełącznikiem „Nie aktualizuj” na karcie. Ogólne zasady — w przeglądzie importu danych.
Co się stanie z produktem, który zniknął ze źródła
Bezpośrednie połączenia z platformami działają według zasady „co przyszło, to zaktualizowano”. Produkt, którego nie było w tym przebiegu, zostaje w katalogu z ostatnią ceną i stanem: nie jest dezaktywowany, stan nie jest zerowany, w dzienniku nie ma o nim nic. Wycofane ze sprzedaży pozycje usuwaj ręcznie, inaczej trafiają do eksportu ze starymi danymi.
Inaczej jest, gdy produkt zmienił status na samej platformie. Znacznik „włączony” przychodzi ze źródła: w Shopify produkt o statusie innym niż Active przyjdzie do Elbuz wyłączony. Rozetka osobnym przebiegiem pobiera status kart w panelu — z błędami, nieprawidłowe, w moderacji, ukryte przez moderatora, poza dopuszczalnym zakresem ceny — i zapisuje w dzienniku liczbę dla każdej grupy.
Pole „Usuwaj z katalogu bazowego rekordy, których nie ma w przesłanym pliku” w sekcji „Co importować” realnie działa tylko tam, gdzie katalog przychodzi feedem — w SalesDrive.
Produkty są usuwane fizycznie, razem z opisami, cechami, zdjęciami, pytaniami i opiniami; kategorie, których nie ma w feedzie, — tak samo. Formularz SalesDrive nie ma ograniczenia według źródła, więc usunięte zostanie też to, co założyłeś ręcznie lub zaimportowałeś innym połączeniem. Włączaj je tylko wtedy, gdy to źródło jest jedynym, które zapełnia katalog. Więcej — w przeglądzie importu danych.
Aktualizacja według harmonogramu
Szablon ustawia się w harmonogramie, a Elbuz sam łączy się ze źródłem: nowe produkty są dodawane, ceny i stany aktualizowane. Częstotliwość — od kilku razy dziennie do raz na dobę; duże marketplace’y ograniczają częstotliwość zapytań, więc zbyt gęsty harmonogram trafia na ich limity.
Harmonogram działa, dopóki połączenie ze źródłem jest sprawne. Marketplace jest niedostępny, klucze wygasły lub zostały odwołane — kolejna aktualizacja się nie odbędzie i będzie to widać w dzienniku. Dlatego przez pierwsze tygodnie przeglądaj dziennik.
Dwa importy według harmonogramu nie idą jednocześnie: drugi zostawia w dzienniku „Anulowano import według harmonogramu, przyczyna - trwa import innego szablonu” i czeka na następne uruchomienie. Blokada przebiegu, który przerwał się bez wpisu w dzienniku, zdejmuje się sama (jak).
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Na końcu przebiegu program sam przelicza pola według Twoich formuł, stosuje reguły narzutu do nowych produktów i aktualizuje ich dane wyszukiwania. Na witrynę i platformy katalog sam nie trafi: to zadanie osobnego „Eksportu danych” z własnym szablonem i harmonogramem (kiedy zaimportowane trafi dalej).
Wyłączyć szablon czy usunąć
Plakietka „Aktywny” / „Wyłączony” w nagłówku karty zdejmuje szablon z harmonogramu; klucze, ustawienia i zaimportowane produkty zostają. Przycisk „Importuj” działa też na wyłączonym szablonie: aby połączenie na pewno niczego nie zmieniło, usuń klucze albo zabezpiecz karty produktów.
1
Plakietka stanu („Aktywny”)2
Przycisk „Importuj”3
Ikona historii uruchomień- Plakietka stanu pokazuje, czy szablon jest „Aktywny”, czy „Wyłączony”; kliknięcie przełącza szablon.
- Przycisk „Importuj” uruchamia import dla tego szablonu.
- Ikona historii uruchomień otwiera listę poprzednich przebiegów.
Usuniętego szablonu nie da się przywrócić, klucze trzeba będzie wpisać od nowa; razem z nim usuwane są zadania harmonogramu. Produkty, kategorie, producenci i znacznik źródła w kartach zostają. Szablonów systemowych nie można usunąć. Więcej — w przeglądzie importu danych.
Jak sprawdzić przebieg i naprawić błąd
Dziennik przebiegu otwiera się w Centrum operacji — prawym panelu, który nie blokuje pracy: kartę szablonu możesz zamknąć.
- Katalog przychodzi stronami, każda ma swój wiersz: „Shopify: strona katalogu 3, pobrano produktów: 75”.
- Na końcu — podsumowanie: „katalog zaimportowany, produktów: 240”.
- Dalej „Aktualizacja wartości na podstawie formuł”, w części połączeń — „Sprawdzanie integralności danych” i „Indeksowanie produktów”, a ostatni wiersz to „Import danych zakończony!” z dopiskiem „Czas trwania”.
- Błąd platformy jest zapisywany na czerwono, z treścią przyczyny od platformy; karta operacji w Centrum zamyka się jako błędna, jeśli jest choć jeden taki wiersz.
W tabeli „Produkty” aktualizację potwierdzają kolumny „Data aktualizacji” (ustawiana każdej zmienionej karcie), „Źródło: nazwa” (szablon, którym kartę założono) i „Źródło: kod” (kod platformy).
Kolumny „Data importu” i „Czas trwania” na liście szablonów aktualizują się nawet wtedy, gdy platforma zwróciła błąd, więc o sukcesie świadczy dziennik. Dłuższą historię pokazuje przycisk „Historia uruchomień” w nagłówku karty szablonu: „Uruchomień w okresie”, „Średni czas trwania”, „Najdłuższe”, „Z błędami”.
Jeśli połączenie przerwało się w trakcie przebiegu
- Produkty są zapisywane do katalogu paczkami po 500, gdy tylko zbierze się paczka. Przerwanie dzieli wynik na dwie części: to, co doszło, jest zaktualizowane, reszta — ze starymi danymi.
- Natychmiastowa powtórka jest bezpieczna: przebieg nadpisze te same pozycje i pobierze resztę, duplikatów nie będzie ani w katalogu, ani w zamówieniach.
- Przy przekroczeniu limitu zapytań lub błędzie serwera zapytanie jest powtarzane trzy-cztery razy, zależnie od platformy, z rosnącą przerwą; dopiero potem przebieg zatrzymuje się z błędem. Na jedno zapytanie program czeka od 60 do 300 sekund.
- Limitu liczby pozycji nie ma. Dane są pobierane stronami po 25–1000 pozycji, w części połączeń — z przerwą między stronami, żeby nie trafić na limity.
Jeśli połączono nie to
Produkty utworzone przez połączenie wybiera filtr w oknie „Produkty” po kolumnie „Źródło: nazwa” lub „Źródło: kod”; dalej zaznacz wiersze i usuń je zbiorczo — program zapyta „Usunąć wybrane produkty?”. Filtr działa także po usunięciu szablonu.
Kart, które już miałeś, a połączenie je tylko nadpisało, ten filtr nie pokaże — zostało w nich stare źródło. Zbierze je filtr po kolumnie „Data aktualizacji”.
Przywrócić starych wartości zbiorczo nie ma czym — dziennika zmian produktu w programie nie ma. Osobno zapisywana jest tylko cena: jeśli prowadzenie historii cen jest włączone, poprzednią widać w karcie produktu, blok „Historia cen produktu”. Działania zbiorcze do naprawy — w przeglądzie importu danych.
Scenariusze
Pierwszy raz przenieść katalog z platformy do Elbuz
Zadanie: produkty są już na Shopify, Rozetce lub innej platformie, a katalog chcesz prowadzić w Elbuz.
Co włączyć: szablon odpowiedniego typu, klucze w formularzu i przycisk „Sprawdź połączenie”; w sekcji „Wybór danych do importu” — „Produkty” i, jeśli potrzebne są zdjęcia, „Zdjęcia”; dalej „Importuj”.
Efekt: każdy produkt staje się kartą katalogu bazowego ze znacznikiem źródła. Produkt, którego nazwa zgadza się z założoną już kartą, nie dostanie nowej karty — przebieg nadpisze istniejącą. Jeśli zmienisz nazwę produktu na platformie, następny przebieg założy nową kartę, a stara zostanie z ostatnimi danymi. Na witrynę nic nie trafi, dopóki nie zadziała „Eksport danych”.
Cenę ustawiam sam, stan — z platformy
Zadanie: liczba sztuk i dostępność mają przychodzić z platformy, a cenę liczysz w Elbuz.
Co włączyć: w karcie produktu, sekcja „Ochrona podczas importu”, przełącznik „Stała cena”.
Efekt: przebieg bezpośredniego połączenia zaktualizuje stan, dostępność, nazwę i opis, a ceny zostawi Twoje. „Nie aktualizuj” do tego zadania się nie nadaje: zamrozi także stan.
Kilka kart prowadzę ręcznie
Zadanie: część produktów przepisałeś pod siebie — nazwę, opis, cechy — i nie chcesz, żeby przebieg przywracał tekst z platformy.
Co włączyć: przełącznik „Nie aktualizuj” w sekcji „Ochrona podczas importu” karty; dla wielu kart naraz — kolumna „Nie aktualizować (flaga)” w tabeli „Produkty”.
Efekt: bezpośrednie połączenie całkowicie pomija taką kartę. Stan z platformy już do niej nie dotrze — trzeba będzie prowadzić go samodzielnie.
Ten sam produkt sprzedaję na dwóch platformach
Zadanie: jeden asortyment jest wystawiony na dwóch platformach lub na dwóch kontach i oba trzeba połączyć w jednym katalogu.
Co włączyć: osobny szablon dla każdego połączenia z własnymi kluczami i własnym harmonogramem.
Efekt: produkty o tej samej nazwie trafiają do jednej karty z wartościami z przebiegu, który zakończył się ostatni (dlaczego). „Nie aktualizuj” zamyka kartę dla obu połączeń naraz — wybrać, które z nich zapisuje, nie można.
Co zrobić, gdy katalog się nie importuje
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Czerwony wiersz błędu platformy lub odmowa przy „Sprawdź połączenie” | Klucz wpisano ze zbędną spacją, wygasł lub został odwołany albo nie ma uprawnień do odczytu produktów | Sprawdź klucz i jego uprawnienia w panelu źródła (klucze) |
| Przychodzą zamówienia, a produktów nie ma | Włączono tylko zestaw „Zamówienia” | Włącz „Produkty” (jak połączyć) |
| „Anulowano import według harmonogramu, przyczyna - trwa import innego szablonu” | W tym momencie działał inny szablon | Nic: import ruszy przy następnym uruchomieniu z harmonogramu (harmonogram) |
| Błędy o przekroczeniu limitu zapytań | Harmonogram jest zbyt gęsty dla limitów platformy | Uruchamiaj szablon rzadziej |
| Twoja nazwa lub opis wróciły do tekstu z platformy | Kolejny przebieg nadpisuje wszystko, co zwróciła platforma | Ustaw karcie „Nie aktualizuj” (ochrona zmian) |
| Produkt wycofany ze sprzedaży wisi ze starymi danymi | Bezpośrednie połączenia nie ruszają produktów, których nie było w przebiegu | Usuń lub wyłącz kartę ręcznie (zniknięty produkt) |
| W katalogu są nowe dane, a na stronie stare | Import nie przenosi danych na witrynę | Sprawdź szablon „Eksportu danych” i jego dziennik (co dalej) |
Najczęstsze pytania
Czym API jest lepsze od pliku?
Nie trzeba niczego ręcznie eksportować i importować: łączysz się kluczami raz, ustawiasz harmonogram — i katalog aktualizuje się sam, bezpośrednio ze źródła.
Czy jedno połączenie może pobierać i produkty, i zamówienia?
Tak, jeśli integracja to potrafi: w szablonie są osobne przełączniki „Produkty” i „Zamówienia” (co kto potrafi).
Co stanie się z produktami po usunięciu szablonu?
Zostaną w katalogu razem ze znacznikiem źródła. Niepotrzebne odfiltruj w oknie „Produkty” po kolumnie „Źródło: nazwa” i usuń zbiorczo.
Mojej platformy nie ma na liście?
Sprawdź listę bezpośrednio w oknie importu — jest szersza i stale się powiększa. Jeśli nie ma integracji API, zaimportuj katalog z pliku: gotowym formatem lub importem uniwersalnym.
Ile platform można podłączyć jednocześnie?
Dowolnie wiele: dla każdego konta osobny szablon z własnymi kluczami i harmonogramem, a wszystkie zapełniają jeden katalog bazowy.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych
- Ochrona karty
- karta produktu → sekcja „Ochrona podczas importu”
- Uprawnienia
- okno „Import danych” w „Uprawnieniach grup”
- Przygotuj
- klucze dostępu z panelu platformy z prawem odczytu produktów
Powiązane tematy
- Jeśli chcesz pobierać także zamówienia — Import zamówień przez API.
- Jeśli chcesz zrozumieć ogólną mechanikę importu, przerwania i cofania — Przegląd importu danych.
- Jeśli źródło nie ma API, a jest plik — Import uniwersalny.
