Elbuz importuje Twoje produkty do katalogu bazowego z pliku, ze strony przez Elbuz Tunnel albo z marketplace’u przez API, a potem aktualizuje te same karty — bez ręcznego przenoszenia i bez duplikatów.
Kiedy to się przyda:
- Przechodzisz do Elbuz z innego systemu — katalog przenosi się z kategoriami, markami i zdjęciami.
- Dostawca regularnie przysyła plik — szablon według harmonogramu aktualizuje istniejące karty, zamiast tworzyć kopie.
- Cenę niektórych produktów ustalasz sam — „Stała cena” w karcie nie pozwala importowi jej zmienić.
- Przebieg się przerwał albo zaimportował nie to — zapisane zostaje, ponowne uruchomienie nie tworzy duplikatów.
Od czego zacząć: wybierz sposób według tego, co masz, a pierwszy przebieg zrób na małym pliku.
Co potrafi import do katalogu
- Cztery sposoby — gotowe szablony formatów plików, import uniwersalny, Elbuz Tunnel i marketplace’ów.
- Szablon konfiguruje się raz, potem uruchamia się go ręcznie lub według harmonogramu.
- Ponowny import rozpoznaje produkt po identyfikatorze i aktualizuje kartę, zamiast tworzyć kopię.
- Ochrona karty — „Nie aktualizuj” i „Stała cena” zachowują Twoje zmiany.
- Usuwanie brakujących w pliku — po zaznaczeniu opcji katalog odzwierciedla źródło.
- Historia uruchomień pokazuje, co dodano i zaktualizowano oraz gdzie były błędy.
- Naprawa błędnego przebiegu — filtr po źródle i działania zbiorcze w katalogu.
Który sposób importu wybrać
Zacznij od tego, co już masz:
| Co masz | Co wybrać |
|---|---|
| Działający sklep na OpenCart, WooCommerce, PrestaShop lub innym popularnym | Elbuz Tunnel — prosto z bazy strony, najpełniejsze przeniesienie |
| Plik eksportu w znanym formacie (feed XML, 1C, tabela z Prom) | Gotowy szablon formatu — XML, CommerceML, XLSX (EVO) |
| Plik w dowolnej postaci: własna tabela, eksport z obcego systemu | Import uniwersalny — kolumny mapujesz sam |
| Już sprzedajesz na marketplace lub prowadzisz ewidencję w zewnętrznym systemie | Import katalogu przez API — kluczami dostępu, bez plików |
| Potrzebujesz nie produktów, tylko zamówień z platform | Import zamówień przez API |
| Zamówienia z własnej strony na OpenCart 3 | Gotowy moduł Elbuz API Sync — zamówienia przychodzą od razu po złożeniu |
Cztery sposoby importu danych
1. Z plików według gotowych szablonów
Najczęstsza droga: masz plik eksportu z innego systemu. Dla popularnych formatów są gotowe szablony z już zmapowanymi kolumnami:
- Feed XML — uniwersalny feed produktów w XML;
- CommerceML 2 (1C) — wymiana z 1C: plik produktów i plik ofert;
- XLSX (prom.ua, satu.kz) — tabela eksportu z platform EVO;
- Elbuz Tunnel — bezpośrednie połączenie z bazą Twojego istniejącego sklepu na OpenCart, WooCommerce, PrestaShop i innych CMS, w ogóle bez plików.
2. Import uniwersalny
Gdy pod Twój plik nie ma gotowego szablonu, użyj importu uniwersalnego. Czyta dowolny plik , , XLS lub , a Ty sam wskazujesz, która kolumna lub węzeł pliku odpowiada któremu polu katalogu.
Na starcie to trochę więcej ręcznej pracy, ale pasuje do każdego źródła — nawet do samodzielnie zrobionego eksportu z obcego systemu ewidencji. Mapowanie robi się raz: kolejne pliki w tym samym formacie importują się tym szablonem bez nowego mapowania.
3. Przez API — katalog
Jeśli już sprzedajesz na platformie lub prowadzisz ewidencję w zewnętrznym systemie, katalog pobiera się bezpośrednio przez API — bez plików, kluczami dostępu. Tak podłącza się Rozetka, Shopify, WooCommerce, Amazon, eBay, Allegro, eMAG, Kaufland, OLX, Etsy, TikTok Shop, Wix, a także Horoshop i SalesDrive.
Klucze bierzesz w panelu platformy lub systemu — zwykle w sekcji dla deweloperów lub integracji — i wklejasz do formularza szablonu. Dalej Elbuz pobiera produkty, kategorie i zdjęcia tak samo jak z pliku. Każda integracja ma własny formularz i własne klucze — artykuły zebrano w przeglądzie importu katalogu przez API.
4. Przez API — tylko zamówienia
Część integracji importuje nie produkty, tylko zamówienia — z marketplace’ów, kas i banków: Kaspi.kz, EVO/Prom (prom.ua, satu.kz), Epicentr, Forte Market, ceneo.pl, kasa dotykačka, wyciągi PrivatBank. Katalogu nie wypełniają — to przegląd importu zamówień przez API.
Katalog czy zamówienia
Jedne źródła przynoszą katalog, inne — zamówienia, a niektóre API potrafią jedno i drugie. W szablonie włączasz, co dokładnie pobierać: produkty, zamówienia lub oba. Szablony plików i import uniwersalny zawsze dotyczą katalogu; część API — tylko zamówień.
Jak przebiega import: od szablonu do katalogu
Kolejność jest taka sama dla każdego źródła:
- Utwórz szablon i wybierz typ źródła.
- Dla pliku wskaż plik lub link i sprawdź mapowanie kolumn; dla API — wpisz klucze dostępu.
- Włącz, co importować: produkty, kategorie, producentów.
- Uruchom szablon. Pierwsze uruchomienie tworzy produkty, kolejne — aktualizują.
- Gdy wszystko działa, ustaw szablon w harmonogramie.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Jeden szablon — jedno źródło. Dla każdego dostawcy lub marketplace’u zakłada się osobny szablon, a każdy ma własny harmonogram: jeden aktualizuje się co godzinę, inny — raz na dobę. Dane natomiast dzielą: jeśli dwa szablony przynoszą ten sam kod produktu, zapisują do jednej karty (dwa szablony dla tego samego produktu).
Co trafia do katalogu
W zależności od źródła i szablonu do katalogu trafiają kategorie (drzewo działów), producenci (marki), zdjęcia, cechy i atrybuty, ceny i stany. Co dokładnie pobierać, ustawia się różnie:
- w Elbuz Tunnel i w integracjach z platformami zdjęcia, atrybuty, opcje, producentów, opinie i zamówienia włącza się osobnymi opcjami w formularzu szablonu;
- w szablonach formatów plików zestaw jest stały;
- najdokładniej — do pojedynczego pola — ustawia to import uniwersalny mapowaniem kolumn.
Co stanie się z polami poprawionymi ręcznie — sekcja co nadpisze ponowny przebieg.
Kategorie i marki techniczne, które tworzy import
Produkt, który w źródle nie ma kategorii, różne szablony obsługują różnie:
- Import uniwersalny i integracje z platformami takiego produktu nie gubią: kładą go do kategorii technicznej z kodem źródła w nazwie. Tworzy się ona wyłączona i bez eksportu — jej zawartość nie trafi na witrynę, dopóki nie rozłożysz produktów do swoich działów.
- Szablony formatów plików (XML, CommerceML, XLSX) nie dodają produktu bez rozpoznanej kategorii — po cichu, bez wiersza w dzienniku. Stąd najczęstsza rozbieżność „w pliku jest więcej pozycji, niż dodało się do katalogu”.
Rozłożyć można zbiorczo: zaznacz produkty, potem „Dodatkowe operacje” → „Zmień kategorię produktu” → wybierz kategorię główną (główna może być tylko jedna). Potem kategoria techniczna zostanie pusta i można ją usunąć.
Nie usuwaj kategorii, dopóki są w niej produkty. Usunięcie kategorii zabiera ze sobą wszystkie produkty, dla których jest główna — razem z opisami, zdjęciami i atrybutami. Program pokazuje komunikat „Proszę czekać, trwa usuwanie kategorii i znajdujących się w niej produktów...”, ale osobno nie pyta o potwierdzenie. Najpierw przenieś produkty, potem usuwaj.
Usunięcie marki nie rusza produktów — pustoszeje w nich pole producenta. Razem z marką usuwane są reguły narzutu powiązane właśnie z nią. Jeśli marka dalej przychodzi w pliku, następny przebieg doda ją ponownie.
Kiedy zaimportowane trafi dalej
Na końcu przebiegu program sam doprowadza dane do postaci roboczej — w dzienniku to wiersze „Aktualizacja wartości na podstawie formuł”, „Sprawdzanie integralności danych”, „Indeksowanie produktów”. Po nich produkt widać na liście katalogu bazowego. Inteligentna wyszukiwarka jest tylko oznaczana do ponownego indeksowania osobnym zadaniem, więc w wyszukiwaniu nowy produkt pojawia się nie w tej samej chwili.
Na stronę i na marketplace’y import niczego nie wysyła. Robi to eksport — osobne szablony z własnym harmonogramem. Dopóki eksport nie zostanie uruchomiony, na witrynie jest stara wersja. Produkty nie pojawiły się na platformie po imporcie — sprawdź dziennik eksportu.
Jak uruchamiać szablon i sprawdzać, czy import się udał
Jednorazowe uruchomienie — przycisk „Importuj” w karcie szablonu. Automatyczne — przycisk „Ustawienia harmonogramu” w karcie szablonu, a szablon musi mieć stan „Aktywny”. Według harmonogramu program pobiera dane z linku lub kluczami, więc plik z komputera nadaje się tylko do ręcznego uruchomienia. Import uniwersalny nie ma harmonogramu: uruchamia się go ręcznie.
Każde uruchomienie zostawia ślad. Przycisk „Historia uruchomień” jest w formularzu szablonu, a także na pasku nad listą szablonów, gdy zaznaczono w niej wiersz. Widać tam, kiedy szedł import, ile produktów lub zamówień przetworzono, ile dodano i zaktualizowano i czy były błędy. Wiersze z problemami są oznaczone kolorem, obok — tekst przyczyny od źródła.
Przez kilka pierwszych uruchomień otwieraj dziennik za każdym razem, nawet gdy wszystko wydaje się w porządku. Od razu wychwytuje zmienione hasło lub token w zewnętrznym systemie, źródło, które oddało mniej produktów, niż oczekiwano, pusty lub nieaktualny plik.
Granice jednego przebiegu
Nie ma limitu liczby produktów. Plik nie jest wczytywany do pamięci w całości, tylko czytany po kolei. Import uniwersalny zapisuje przeczytane do bazy partiami po 2000 wierszy, szablony formatów plików najpierw składają wszystko w tabelach pośrednich i przenoszą do katalogu za jednym razem. Rozmiar katalogu ogranicza nie limit, tylko czas.
Na przebieg eksportu XLSX z platform EVO i importu uniwersalnego przewidziano dwie godziny. Import uniwersalny, któremu czasu zabrakło, zostawia katalog zaimportowany częściowo — zapisane partie są już w katalogu. XLSX najpierw czyta się do tabel pośrednich, więc przebieg zatrzymany limitem podczas czytania nie zmienia katalogu.
Ile trwa właśnie Twój przebieg, pokazuje „Historia uruchomień”: za ostatnie 30 dni — liczba uruchomień, „Średni czas trwania”, „Najdłuższe” i ile przebiegów było „Z błędami”. Po tygodniu pracy będziesz mieć własne liczby do wyboru harmonogramu.
Okno nie blokuje się na czas importu: dziennik przebiegu jest w panelu „Operacje”, a kartę szablonu można zamknąć. Przebiegi według harmonogramu idą na serwerze i nie potrzebują przeglądarki.
Nad listą szablonów jest pasek z podsumowaniem: „Szablonów”, „Aktywnych”, „W toku”, „Ostatni import” i „Dawno nieimportowane”. Ostatnie liczy aktywne szablony, które nie były uruchamiane ponad 7 dni, — tak widać, że źródło milczy.
Wyłączyć szablon czy usunąć
W karcie szablonu u góry jest plakietka stanu — „Aktywny” / „Wyłączony”; to samo przełącza kolumna „Stan” na liście szablonów.
Wyłączony szablon pomija harmonogram i nie bierze go polecenie „Importuj wszystkie szablony”. Ustawienia, klucze, mapowanie, harmonogram i już zaimportowane produkty zostają. Po ponownym włączeniu harmonogram działa dalej. Przycisk „Importuj” w karcie działa także w wyłączonym szablonie: wyłączenie zatrzymuje tylko automatyczne przebiegi.
Razem z usuniętym szablonem znika jego harmonogram, a w Elbuz Tunnel — także dostępy do bazy strony, reguły wyboru i dopasowania. Zaimportowane produkty, kategorie i producenci zostają w katalogu.
Usuniętego szablonu nie da się przywrócić z poziomu interfejsu — trzeba go zakładać od nowa. Na przerwę szablon się wyłącza, a nie usuwa.
Ponowny import: aktualizacja bez duplikatów
Produkty nie dublują się przy każdym imporcie. Elbuz rozpoznaje pozycję po identyfikatorze — kodzie produktu, kodzie lub zewnętrznym id ze źródła — i aktualizuje właśnie ją. Dlatego szablon można uruchamiać codziennie: istniejące się zaktualizuje, nowe się doda. Jeśli identyfikatory w źródle zmieniają się z eksportu na eksport, program uzna stare produkty za nowe i narobi duplikatów.
Co nadpisze ponowny przebieg
Główne pytanie przed drugim importem — czy nie zetrze ręcznych poprawek. Odpowiedź zależy od pola:
| Pola | Jak zachowują się przy ponownym przebiegu |
|---|---|
| Dostępność i ilość, cena i stara cena, nazwa i opis | Zawsze brane ze źródła. Brak wartości w pliku — do karty trafia pusta: produkt bez ceny dostanie zero, bez dostępności — domyślny status (pierwszy oznaczony jako „dostępny”) i ilość z niego |
| Kod produktu, model, , ISBN, gwarancja, tagi, kategoria, producent, link do produktu w źródle | W szablonie XML — tylko jeśli w pliku nie jest pusto. W CommerceML i XLSX (EVO) zapisują się jak są: pusta wartość zetrze Twoją |
| Zdjęcia, atrybuty, opcje, producenci, opinie, zamówienia | W Elbuz Tunnel i integracjach z platformami — według opcji szablonu. W szablonach formatów plików zdjęcia, atrybuty i producenci są brani zawsze |
| Pola dodatkowe założone przez Ciebie | Aktualizują się tylko z zaznaczonym „Aktualizuj pola dodatkowe” (jest w szablonie XML) |
Dlatego niepełny plik — same nazwy albo same zdjęcia — nie nadaje się do ponownego przebiegu. Wyjątek — wymiana CommerceML jednym plikiem: plik ofert (offers.xml) bez pliku produktów aktualizuje tylko cenę, stan i status dostępności, a plik produktów (import.xml) bez ofert — tylko pola katalogowe.
Jak zablokować swoją wartość
Gdzie: karta produktu → sekcja „Statusy i flagi” → grupa „Ochrona podczas importu”.
- „Nie aktualizuj” — import nie zmienia już tej karty: ani ceny, ani dostępności, ani kodu, ani kategorii, ani producenta, ani nazwy z opisem. Tak działają szablony formatów plików, Elbuz Tunnel, import uniwersalny i API.
- „Stała cena” — ceny i starej ceny nie rusza żaden import: szablony formatów plików (XML, CommerceML, XLSX), Elbuz Tunnel, import uniwersalny i API. Pozostałe pola karty aktualizują się jak zwykle.
1
Nie aktualizuj2
Stała cena- Nie aktualizuj — import całkowicie pomija ten produkt.
- Stała cena — import zostawia cenę produktu bez zmian.
Zdjęcia w istniejących kartach różne szablony obsługują różnie:
- import uniwersalny i API dodają zdjęcia tylko nowym produktom — w istniejącej karcie zostają Twoje zdjęcia;
- szablony XML i CommerceML dokładają zdjęcia, których w karcie jeszcze nie było, i nie ruszają starych;
- szablon XLSX dla platform EVO zastępuje zdjęcia w całości: zostają tylko te, które są w eksporcie.
Aktualizować tylko ceny i dostępność, nie ruszając reszty, można mapowaniem importu uniwersalnego — scenariusz niżej.
Dwa szablony dla tego samego produktu
Program rozpoznaje produkt po identyfikatorze ze źródła, a nie po szablonie, który go dodał. Jeśli dwa szablony przynoszą ten sam kod produktu, pracują na jednej karcie i zostaje wartość z przebiegu, który był ostatni. Ustawienia „priorytet źródeł” nie ma.
Rozdzielić je można opcją „Sprawdzaj unikalność rekordów z uwzględnieniem tego źródła importu” w karcie szablonu. Z nią przebieg szuka istniejącego produktu tylko wśród swoich, a jednakowe identyfikatory z różnych źródeł stają się osobnymi kartami. Opcja jest w szablonach XML i Elbuz Tunnel; w CommerceML, XLSX (EVO) i formularzach integracji API jej nie ma.
W szablonach XML pole puste w drugim źródle nie ściera wartości z pierwszego. Nie dotyczy to ceny, dostępności, nazwy i opisu: dwa pełne pliki na jeden asortyment w jednej karcie ciągle nadpisują się nawzajem.
Produkt zniknął ze źródła
Przebieg porównuje źródło z katalogiem tylko w jedną stronę: co jest w pliku, zaktualizuje się lub doda. Produkt, którego w pliku już nie ma, domyślnie zostaje bez zmian — ze swoją ceną, dostępnością i zdjęciami. Karta się nie wyłącza i sama nie znika.
Zmienia to opcja szablonu „Usuwaj z katalogu bazowego rekordy, których nie ma w przesłanym pliku” (w szablonie Elbuz Tunnel — „…których nie ma na stronie”). Z nią przebieg usuwa z katalogu bazowego wszystko, czego nie było w pliku, razem z opisem, zdjęciami, atrybutami, powiązaniami z kategoriami i pytaniami o produkt. Dopasowanie takich produktów do cenników przepada: wiersz cennika zostaje bez produktu.
Opcja działa na całym katalogu bazowym, a nie tylko na produktach tego szablonu. „Sprawdzaj unikalność rekordów z uwzględnieniem tego źródła importu” zawęża zakres: produkty innych szablonów zostają. Karty utworzone ręcznie, z cennika lub parserem trafiają do usunięcia w każdym przypadku. Usunięte nie wraca.
Ochrona przed pustym plikiem jest w szablonach XML, XLSX (EVO) i CommerceML: jeśli w pliku nie znalazł się żaden produkt, produkty nie są usuwane. W CommerceML tak samo z kategoriami: bez klasyfikatora w pliku (wymiana jednym plikiem ofert) żadna kategoria nie jest usuwana. W szablonie Elbuz Tunnel takiego sprawdzenia nie ma.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
W integracjach przez API opcja usuwania brakujących jest tylko w formularzach Horoshop i SalesDrive:
- SalesDrive — usuwa: jego eksport (eksport XML z linku w szablonie) importuje się tak samo jak plik XML. Opcji „Sprawdzaj unikalność rekordów…” tu nie ma — do usunięcia idzie cały katalog bazowy. Bez linku do eksportu XML SalesDrive pobiera tylko zamówienia i niczego nie usuwa.
- Horoshop — opcja niczego nie usuwa.
- Pozostałe platformy tej opcji nie mają: produkt zdjęty ze sprzedaży zostaje w katalogu, dopóki go sam nie usuniesz.
Jeśli przebieg się przerwał lub go zatrzymano
Przebieg zapisuje do katalogu na bieżąco, a nie według zasady „wszystko albo nic”. Zerwało się połączenie, skończył się czas, kliknięto „Zatrzymaj” — zapisane zostaje zapisane, a do czego nie doszło, tego nie zrobiono.
Ponowne uruchomienie po przerwaniu jest bezpieczne: produkty, które już się dodały, znajdą się po identyfikatorze i zaktualizują, reszta się doda. Duplikatów to nie tworzy.
Przycisk „Zatrzymaj” w panelu „Operacje” ustawia znacznik, a praca kończy się w najbliższym punkcie kontrolnym. W dzienniku pojawia się „Operacja przerwana przez użytkownika!”, a operacja w panelu „Operacje” robi się żółta. Formuły, sprawdzanie integralności i indeksowanie po zatrzymaniu się nie uruchamiają, wiersza „Import danych zakończony!” nie będzie, data ostatniego importu w szablonie się nie zmieni.
Jeśli w szablonie włączono usuwanie brakujących w pliku, odbywa się ono przed zapisem nowych danych. Przebieg przerwany zaraz po tym etapie zostawi katalog już bez usuniętych produktów, ale jeszcze bez aktualizacji.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Nie uruchamiaj dwóch przebiegów naraz: szablony plików pracują przez wspólny obszar pośredni i drugi przebieg nadpisze dane robocze pierwszego. Harmonogram pilnuje tego sam — zajęty moment da w dzienniku „Anulowano import według harmonogramu, przyczyna - trwa import innego szablonu (konflikt przetwarzania danych).”, a zadanie poczeka do następnego razu. Ręczne uruchomienie takiego sprawdzenia nie robi.
Przebieg według harmonogramu, który padł po cichu, nie trzyma blokady: po 15 minutach ciszy zadanie zostaje zwolnione i następnym razem harmonogram zadziała jak zwykle.
Jeśli zaimportowano nie to
Najpierw oceń skalę. Na liście katalogu bazowego służą do tego kolumny:
- „Źródło: nazwa” i „Źródło: ID” — którym szablonem kartę dodano. Filtr po tej kolumnie daje pełną listę produktów utworzonych przez błędny przebieg.
- „Data aktualizacji” — kiedy kartę ostatnio zmieniano: import, działania zbiorcze, zapis karty. Wyłapuje też karty, których przebieg nie utworzył, tylko zaktualizował: źródło zostaje w nich stare.
Dalej — działania zbiorcze z menu „Dodatkowe operacje” (przycisk z trzema kropkami w wierszu lub prawy przycisk myszy na liście):
- „Usuń produkt” — dla zbędnych; przy zaznaczonych wierszach zapyta „Usunąć wybrane produkty?”;
- „Zmień kategorię produktu” — przenieść do właściwego działu;
- „Masowo ustaw wartość” i „Znajdź i zamień” — poprawić lub wyczyścić konkretne pole.
1
Usuń produkt2
Zmień kategorię produktu3
Masowo ustaw wartość- Usuń produkt — usuwa produkt (trafia do kosza).
- Zmień kategorię produktu — przenosi zaznaczone produkty do innej kategorii.
- Masowo ustaw wartość — wpisuje jedną wartość w pole wielu produktów naraz.
Nadpisane ceny, dostępność, nazwy i opisy przywraca ponowny przebieg właściwego pliku — te pola zawsze bierze się ze źródła. Pola, które błędny plik wypełnił, a właściwy zostawia puste (kod produktu, model, gwarancja, tagi), w szablonie XML same się nie wyczyszczą: usuwa się je przez „Masowo ustaw wartość” z pustą wartością.
Usunięte nie wraca. Jeśli przebieg szedł z opcją usuwania brakujących, produkty zniknęły z bazy na stałe. Ponowny przebieg doda je jako nowe karty: z nowymi wewnętrznymi identyfikatorami, bez ręcznych zmian i bez dopasowania do cenników.
Scenariusze
Pierwszy import: najpierw mały plik
Co zrobić. Wybierz sposób według tabeli. Zrób szablon na małym pliku lub na jednej kategorii, uruchom i sprawdź karty oraz historię uruchomień.
Efekt. Błąd mapowania lub kategorii widać na kilkunastu produktach, a nie na całym katalogu. Gdy karty są poprawne, importuj wszystko i ustaw szablon w harmonogramie.
Asortyment wyznacza feed: zdjęte z feedu ma zniknąć z katalogu
Co włączyć. W szablonie XML — opcje „Usuwaj z katalogu bazowego rekordy, których nie ma w przesłanym pliku” i „Sprawdzaj unikalność rekordów z uwzględnieniem tego źródła importu”.
Efekt. Każdy przebieg usuwa z katalogu bazowego produkty, których nie ma w pliku, razem z opisem, zdjęciami i atrybutami. Produkty innych szablonów zostają. Pusty plik nie wyczyści katalogu: etap usuwania jest pomijany.
Zwróć uwagę. Kart utworzonych ręcznie, z cennika lub parserem druga opcja nie chroni. Jeśli pierwsza opcja jest szara i nie da się jej zaznaczyć, Twoja grupa nie ma uprawnienia do usuwania produktów podczas importu.
Dwóch dostawców z jednakowymi kodami, a potrzebne są osobne karty
Co włączyć. W szablonie każdego dostawcy (XML lub Elbuz Tunnel) — opcję „Sprawdzaj unikalność rekordów z uwzględnieniem tego źródła importu”.
Efekt. Przebieg szuka istniejącej karty tylko wśród dodanych tym szablonem, a także utworzonych ręcznie, z cennika lub parserem. Jednakowy identyfikator od dwóch dostawców daje dwie karty.
Zwróć uwagę. Kartę utworzoną ręcznie z tym samym identyfikatorem będą aktualizować oba szablony — dla każdego jest „swoja”.
Aktualizować tylko ceny i dostępność, nie ruszając opisów, zdjęć i reszty pól
Co włączyć. Import uniwersalny → karta „Mapowanie pól” → blok „Pola produktu”: zostaw w mapowaniu cenę i ilość, a także kod producenta, nazwę i link do produktu w źródle.
Efekt. W istniejących kartach zmieniają się tylko pola z mapowania. Pusta komórka ceny lub kodu w pliku nie ściera wartości, a pusta ilość — ściera: zero w ilości oznacza „Brak w magazynie”.
Zwróć uwagę. Po połączeniu kodu producenta, nazwy i linku program znajduje istniejącą kartę. Usuniesz je z mapowania — każdy przebieg będzie dodawał nowe karty.
Dostawca na przerwie: zatrzymać automatyczny import bez utraty ustawień
Co włączyć. W karcie szablonu przełącz plakietkę stanu na „Wyłączony” (lub to samo w kolumnie „Stan” na liście szablonów).
Efekt. Szablon pomija harmonogram i polecenie „Importuj wszystkie szablony”. Ustawienia, harmonogram i produkty zostają. Po przywróceniu „Aktywny” szablon znów działa według harmonogramu. Więcej: wyłączyć szablon czy usunąć.
Co zrobić, gdy import działa nie tak
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| W pliku jest więcej pozycji, niż dodało się do katalogu | Szablony formatów plików nie dodają produktu bez rozpoznanej kategorii | Sprawdź kategorie w pliku (kategorie techniczne) |
| „Anulowano import według harmonogramu, przyczyna - trwa import innego szablonu (konflikt przetwarzania danych).” | W tym momencie trwał inny przebieg | Rozsuń harmonogramy szablonów w czasie (przerwanie przebiegu) |
| „Operacja przerwana przez użytkownika!” | Przebieg zatrzymano przyciskiem „Zatrzymaj” | Uruchom szablon jeszcze raz — duplikatów nie będzie (przerwanie przebiegu) |
| Po ponownym przebiegu produkty się zdublowały | Identyfikatory w źródle się zmieniły albo dwa szablony rozdzielono opcją unikalności | Znajdź kopie filtrem „Źródło: nazwa” (zaimportowano nie to) |
| Ręczna cena zmieniła się po przebiegu | Cena jest zawsze brana ze źródła | Włącz w karcie „Stała cena” (zablokować swoją wartość) |
| Opcja „Usuwaj z katalogu bazowego rekordy…” jest szara i nie da się jej zaznaczyć | Grupa nie ma uprawnienia do usuwania podczas importu | Nadaj grupie uprawnienie w „Uprawnieniach grup” (kto ma dostęp) |
| W katalogu jest nowe, a na stronie stare | Import nie eksportuje na stronę | Uruchom szablon eksportu (kiedy zaimportowane trafi dalej) |
Najczęstsze pytania
Czym to się różni od importu cennika dostawcy?
Cennik dostawcy importuje się do porównywania cen i dropshippingu — to sekcja „Dostawcy”. Tutaj wypełniasz własny katalog bazowy: swoimi produktami z pliku, z platformy lub z systemu ewidencji.
Czy mogę zaimportować katalog z mojego sklepu na marketplace bez pliku?
Tak, jeśli dla platformy jest integracja API (Rozetka, Shopify, WooCommerce i inne). Elbuz pobiera produkty kluczami dostępu, bez plików — import katalogu przez API.
API jest podłączone, a zamiast produktów przychodzą zamówienia — dlaczego?
Część integracji przynosi tylko zamówienia (kasy, banki, niektóre marketplace’y). W integracjach, które obsługują i katalog, i zamówienia, sprawdź opcje szablonu: import produktów musi być włączony.
Czy trzeba za każdym razem importować ręcznie?
Nie. Sprawdzony szablon z linkiem lub kluczami ustawia się w harmonogramie i import idzie sam. Wyjątek — import uniwersalny: uruchamia się go ręcznie (uruchamianie i harmonogram).
Cena poprawiona ręcznie — czy ponowny przebieg ją zetrze?
Tak, cena i dostępność są brane ze źródła za każdym razem. Żeby zachować swoją, włącz w karcie „Stała cena” lub „Nie aktualizuj” (jak zablokować swoją wartość).
Dwa źródła przysyłają jednakowe ID i nadpisują się nawzajem. Czy można importować je jako różne produkty?
Tak: w szablonie każdego źródła włącz „Sprawdzaj unikalność rekordów z uwzględnieniem tego źródła importu”. Opcja jest w szablonach XML i Elbuz Tunnel (dwa szablony dla tego samego produktu).
Czy można podłączyć Arkusz Google bezpośrednio jako źródło importu do katalogu?
Nie. Arkusz Google bezpośrednio czytają cenniki: źródło ze sposobem „Link” (import cennika), dalej dopasowanie do katalogu. Inna droga — wyeksportować arkusz do pliku i zaimportować go szablonem katalogu.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych
- Uprawnienia
- okno „Import danych” w „Uprawnieniach grup”
- Opcja usuwania
- osobne uprawnienie „Flaga: usuwać kategorie i produkty w katalogu bazowym, których nie ma w importowanym pliku”
- Przygotuj
- plik lub link do niego, dostęp do strony albo klucze API platformy
Okno „Import kategorii, produktów i producentów do katalogu bazowego” działa przez szablony. Szablon to zapisane ustawienia jednego importu: skąd brać dane, w jakim formacie, według jakich reguł i co dokładnie pobierać.
Szablon konfiguruje się raz, potem uruchamia ręcznie lub ustawia w harmonogramie. Ponowne uruchomienie aktualizuje katalog według tych samych reguł.
1
Nazwa szablonu2
Typ źródła- Nazwa szablonu — każdy wiersz to jeden zapisany sposób importu danych do katalogu bazowego.
- Typ źródła — wiersz pod nazwą pokazuje, jak przychodzą dane (XML, Elbuz Tunnel, uniwersalny import pliku); jedna lista mieści wszystkie.
Powiązane tematy
- Jeśli nie masz ani pliku, ani platformy, a produkty trzeba zebrać ze stron internetowych — parser stron.
- Jeśli katalog jest wypełniony i czas podłączać dostawców — Cenniki: od czego zacząć i dokąd iść dalej.
- Jeśli format Twojego pliku jest nietypowy — import uniwersalny z ręcznym mapowaniem.
- Jeśli sprzedajesz na marketplace i chcesz pobierać produkty bez plików — import katalogu przez API.
