Import i eksport danych produktowych w BaseLinkerze

Wprowadzanie setek czy tysięcy produktów ręcznie do systemu sprzedażowego jest praktycznie niewykonalne przy większej skali działalności. BaseLinker udostępnia narzędzia importu i eksportu danych produktowych, które pozwalają masowo zarządzać kartotekami z plików, hurtowni i systemów zewnętrznych.

Import i eksport danych produktowych to fundament sprawnego zarządzania asortymentem w sprzedaży wielokanałowej. BaseLinker obsługuje różne formaty wymiany danych, od plików CSV i XML, przez integracje z hurtowniami, po bezpośrednie połączenia API z systemami dostawców. Prawidłowo skonfigurowany przepływ danych pozwala utrzymywać spójne informacje o produktach w sklepie internetowym, na marketplace’ach, w systemie magazynowym i w narzędziach reklamowych.

W praktyce nie chodzi wyłącznie o jednorazowe wgranie listy produktów. Równie ważne jest późniejsze aktualizowanie cen, stanów magazynowych, opisów, zdjęć, parametrów oraz dostępności. Dzięki automatyzacji zmiany wprowadzone przez dostawcę mogą być przekazywane do kolejnych kanałów sprzedaży według ustalonych reguł, bez konieczności ręcznego edytowania każdej karty produktu.

Metody importu danych produktowych

W zależności od źródła danych i skali asortymentu, dobieramy odpowiednią metodę importu, która zapewni aktualność i spójność kartotek produktowych. Inaczej konfiguruje się import jednorazowy z arkusza, a inaczej stałą synchronizację z hurtownią udostępniającą dane przez API. Znaczenie ma także to, czy BaseLinker ma utworzyć nowe produkty, czy tylko zaktualizować rekordy już znajdujące się w katalogu.

Import danych z plików CSV, XML i XLS od dostawców i hurtowni
Automatyczne pobieranie danych z API hurtowni dropshippingowych
Masowa aktualizacja cen, opisów i zdjęć produktów
Import kategorii i atrybutów zgodnych ze strukturą sklepu
Harmonogramowanie cyklicznych importów danych od dostawców

Import z plików CSV, XML i XLS

Pliki produktowe często różnią się układem kolumn, nazwami pól oraz sposobem zapisu wartości. Jeden dostawca może używać pola „SKU”, inny „Kod produktu”, a jeszcze inny „Indeks”. Podobne rozbieżności dotyczą cen, stanów magazynowych, kategorii i wariantów. Przed właściwym importem należy więc przypisać kolumny pliku do odpowiednich pól w BaseLinkerze.

Ważne jest również sprawdzenie kodowania znaków, separatorów, formatu cen oraz sposobu zapisu zdjęć. Błędne kodowanie może powodować pojawienie się nieczytelnych znaków w nazwach i opisach, a nieprawidłowy separator może przesunąć dane do niewłaściwych kolumn. W przypadku XML trzeba dodatkowo zweryfikować strukturę znaczników oraz to, czy wszystkie produkty są opisane w jednakowy sposób.

Dobrym rozwiązaniem jest rozpoczęcie od importu niewielkiej próbki. Pozwala to sprawdzić, jak system interpretuje pola, czy zdjęcia są prawidłowo pobierane oraz czy produkty trafiają do właściwych kategorii. Dopiero po potwierdzeniu poprawności można uruchomić import całego pliku.

Integracja przez API

API umożliwia automatyczną wymianę danych między BaseLinkerem a zewnętrznym systemem. W zależności od konfiguracji można pobierać między innymi nazwy, kody, ceny, stany, opisy, zdjęcia, warianty i parametry. Dane są przekazywane według ustalonego harmonogramu albo zgodnie z mechanizmem udostępnionym przez dostawcę.

Integracja API ogranicza liczbę ręcznych operacji, ale wymaga dokładnego określenia, które źródło jest nadrzędne dla poszczególnych informacji. Przykładowo stany magazynowe mogą pochodzić z hurtowni, ceny mogą być korygowane przez własne reguły, a opisy i zdjęcia mogą być zarządzane lokalnie. Bez takiego podziału automatyczna synchronizacja może nadpisywać dane przygotowane wcześniej dla konkretnego kanału sprzedaży.

Import produktów z wariantami

Niektóre produkty występują w wielu odmianach, takich jak rozmiar, kolor, pojemność lub wersja wyposażenia. W takim przypadku dane powinny zawierać zarówno identyfikator produktu głównego, jak i informacje pozwalające powiązać z nim poszczególne warianty. Istotne jest również zachowanie unikalnych kodów SKU, ponieważ to one często służą do aktualizacji stanów i cen.

Niepoprawne powiązanie wariantów może prowadzić do utworzenia wielu niezależnych produktów zamiast jednej karty z opcjami wyboru. Może też powodować błędne przypisanie zdjęć, cen albo stanów magazynowych. Dlatego przed uruchomieniem importu warto określić, czy warianty mają być widoczne jako osobne pozycje, czy jako elementy jednego produktu.

Mapowanie pól i reguły przekształcania danych

Samo wskazanie źródła danych nie wystarcza do poprawnego importu. Konieczne jest mapowanie pól, czyli określenie, do którego miejsca w BaseLinkerze trafi każda informacja z pliku lub API. Dotyczy to nie tylko podstawowych danych, ale również parametrów technicznych, producenta, kodów EAN, wymiarów, wagi i informacji o dostępności.

W trakcie mapowania można stosować reguły przekształcania. Przykładowo cena pobrana z hurtowni może zostać powiększona o ustaloną marżę, a opis może zostać uzupełniony o stały fragment. Można także zmieniać nazwy kategorii, usuwać niepotrzebne fragmenty tekstu, porządkować jednostki miary albo tworzyć wartości wymagane przez konkretny kanał sprzedaży.

Przypisanie kodów produktów do właściwego pola identyfikacyjnego
Ujednolicenie formatu cen, wag i wymiarów
Rozdzielenie danych ogólnych od informacji przeznaczonych dla konkretnego kanału
Tworzenie reguł dla marży, rabatów i zaokrągleń
Usuwanie pustych wartości oraz niepotrzebnych fragmentów opisów
Powiązanie nazw kategorii dostawcy ze strukturą katalogu w BaseLinkerze

Eksport danych na potrzeby raportowania i integracji

Poza importem, równie istotny jest eksport danych produktowych do innych systemów wykorzystywanych w firmie. Eksport może mieć formę pliku przekazywanego innemu narzędziu albo danych pobieranych cyklicznie przez zewnętrzną integrację. Zakres eksportu powinien być dopasowany do celu, ponieważ system księgowy, porównywarka cen i kopia zapasowa mogą wymagać zupełnie innych pól.

Eksport kartotek produktowych do systemów ERP i księgowych
Generowanie plików produktowych dla porównywarek cenowych
Eksport danych na potrzeby kampanii reklamowych (Google Shopping, Facebook)
Tworzenie kopii zapasowych kartotek produktowych

Eksport do systemów ERP i magazynowych

Wymiana danych z systemem ERP pomaga połączyć informacje o produktach ze stanami magazynowymi, zakupami i dokumentami sprzedażowymi. Trzeba jednak ustalić, który system odpowiada za konkretne dane. W wielu konfiguracjach BaseLinker przekazuje zamówienia i informacje sprzedażowe, natomiast ERP pozostaje głównym źródłem danych o stanach, dostawach i indeksach magazynowych.

Przy eksporcie należy zwrócić uwagę na identyfikatory produktów. Jeżeli BaseLinker i system zewnętrzny posługują się innymi kodami, potrzebna jest tabela powiązań. Bez niej aktualizacja może trafić do niewłaściwego produktu albo zakończyć się utworzeniem duplikatu.

Pliki dla porównywarek i kampanii reklamowych

Pliki produktowe wykorzystywane w reklamie powinny zawierać kompletne i aktualne informacje, między innymi nazwę, opis, cenę, dostępność, zdjęcie, adres produktu oraz dane identyfikacyjne. Każdy kanał może mieć własne wymagania dotyczące nazw pól, formatów i obowiązkowych atrybutów. Dlatego jeden uniwersalny eksport nie zawsze będzie odpowiedni dla wszystkich odbiorców.

Przed publikacją warto sprawdzić, czy ceny i stany są zgodne z ofertą widoczną w sklepie oraz czy adresy zdjęć i produktów działają poprawnie. Szczególnej uwagi wymagają produkty niedostępne, wycofane albo pozbawione wymaganych parametrów. Można je wykluczyć z eksportu lub oznaczyć zgodnie z zasadami danego kanału.

Zapewnienie jakości danych

Masowy import danych niesie ryzyko błędów — duplikatów, nieprawidłowych kategorii czy niespójnych jednostek miary — dlatego każde wdrożenie importu poprzedzamy testami na próbce danych. Konfigurujemy reguły walidacji i mapowania pól tak, aby import przebiegał bezbłędnie nawet przy dużej liczbie produktów, a harmonogram automatycznych aktualizacji zapewniał stałą aktualność oferty bez konieczności ręcznej pracy zespołu.

Kontrola jakości powinna obejmować zarówno dane techniczne, jak i ich prezentację. Produkt może zostać zaimportowany bez błędu systemowego, ale nadal mieć pusty opis, niewłaściwe zdjęcie albo kategorię niezgodną z ofertą. Po każdym większym imporcie warto więc sprawdzić losową grupę kart produktowych oraz porównać ją ze źródłem danych.

Sprawdzenie liczby zaimportowanych produktów
Wykrycie powtarzających się kodów SKU i EAN
Kontrola pustych nazw, opisów, cen i stanów
Weryfikacja kategorii, parametrów oraz wariantów
Sprawdzenie poprawności adresów zdjęć
Porównanie wybranych produktów z danymi źródłowymi

Najczęstsze problemy podczas importu

Jednym z częstszych problemów jest brak jednoznacznego identyfikatora produktu. Jeżeli aktualizacja opiera się tylko na nazwie, zmiana nazwy u dostawcy może spowodować utworzenie nowej pozycji zamiast aktualizacji istniejącej. Stabilny kod SKU lub inny stały identyfikator ułatwia bezpieczne łączenie danych.

Problemy mogą wynikać także z różnic w strukturze kategorii. Dostawca może używać szerokiej kategorii, podczas gdy sklep ma rozbudowany podział na konkretne grupy. W takim przypadku potrzebna jest tabela mapowania oraz reguły przypisujące produkty do właściwych miejsc.

Osobnej kontroli wymagają zdjęcia. Część dostawców przekazuje jeden adres, inni listę adresów oddzielonych określonym znakiem. Zdarza się również, że grafiki są dostępne tylko czasowo albo wymagają dodatkowych uprawnień. Nieudany import zdjęć obniża jakość oferty, nawet jeśli pozostałe pola zostały zapisane prawidłowo.

Automatyczne aktualizacje i harmonogramy

Cykliczny import powinien być zaplanowany zgodnie z częstotliwością zmian po stronie źródła. Aktualizowanie danych zbyt rzadko może powodować sprzedaż produktów niedostępnych, natomiast zbyt częste pobieranie danych może niepotrzebnie obciążać integrację. Harmonogram warto ustalić osobno dla stanów, cen oraz pozostałych informacji, jeżeli źródło na to pozwala.

Ważne jest także określenie zachowania dla produktów, których nie ma już w kolejnym pliku. Nie zawsze oznacza to, że produkt należy usunąć. Może być chwilowo niedostępny, ukryty przez dostawcę albo pominięty z powodu błędu generowania pliku. Bezpieczniej jest ustalić, czy taka pozycja ma zostać wyłączona ze sprzedaży, oznaczona jako niedostępna czy pozostawiona bez zmian.

Praktyczny przebieg konfiguracji importu

Prawidłowe wdrożenie importu można podzielić na kilka etapów. Najpierw należy ustalić źródło danych i zakres informacji, które mają być synchronizowane. Następnie trzeba przygotować mapowanie pól, reguły przekształcania oraz sposób rozpoznawania istniejących produktów.

Określenie źródła danych i częstotliwości aktualizacji
Analiza struktury pliku lub dokumentacji API
Przypisanie pól źródłowych do pól w BaseLinkerze
Utworzenie reguł kategorii, cen, stanów i opisów
Test na ograniczonej próbce produktów
Kontrola kart produktowych po imporcie
Uruchomienie pełnej synchronizacji i monitorowanie wyników

Taki etapowy sposób pracy ułatwia znalezienie błędów, zanim wpłyną one na całą ofertę. Po uruchomieniu automatyzacji warto regularnie analizować komunikaty integracji i sprawdzać, czy liczba aktualizowanych produktów odpowiada oczekiwaniom.

Kopia zapasowa i bezpieczeństwo danych

Przed większą zmianą konfiguracji lub pierwszym pełnym importem warto zachować kopię aktualnych danych produktowych. Eksport umożliwia odtworzenie wcześniejszego stanu albo porównanie zmian wprowadzonych przez automatyczną synchronizację. Kopia powinna obejmować nie tylko nazwy i ceny, ale również kody, kategorie, opisy, parametry i informacje o zdjęciach.

Bezpieczeństwo dotyczy także danych dostępowych do API i plików źródłowych. Uprawnienia powinny być ograniczone do niezbędnego zakresu, a dostęp do konfiguracji integracji powinny mieć wyłącznie osoby odpowiedzialne za dane produktowe. Warto również ustalić, kto zatwierdza zmiany reguł importu i kto analizuje błędy pojawiające się podczas synchronizacji.

Częste pytania dotyczące importu i eksportu

Czy można zaimportować tylko wybrane pola?

Tak. Import można skonfigurować tak, aby aktualizował wyłącznie określone informacje, na przykład ceny i stany magazynowe. Pozostałe pola, takie jak opis lub zdjęcia, mogą pozostać bez zmian. Jest to przydatne wtedy, gdy część danych pochodzi od dostawcy, a część została przygotowana indywidualnie dla sklepu.

Co zrobić, gdy dostawca zmieni strukturę pliku?

Zmiana nazw kolumn, kolejności pól albo formatu wartości może zakłócić import. W takiej sytuacji należy porównać nowy plik z dotychczasową konfiguracją i ponownie sprawdzić mapowanie. Przed przywróceniem automatycznego harmonogramu najlepiej wykonać test na niewielkiej próbce.

Czy eksport może zawierać tylko produkty dostępne?

Tak. Zakres eksportu można ograniczyć według stanu magazynowego, kategorii, statusu lub innych warunków. Dzięki temu do konkretnego kanału trafiają wyłącznie produkty spełniające określone wymagania, a oferta reklamowa lub katalogowa pozostaje bardziej aktualna.

Podsumowanie

Import i eksport danych produktowych w BaseLinkerze pozwalają uporządkować pracę z dużym asortymentem oraz ograniczyć ręczne przepisywanie informacji. Najważniejsze elementy poprawnego wdrożenia to stabilne identyfikatory produktów, przemyślane mapowanie pól, reguły walidacji, testy na próbce i bezpiecznie ustawione harmonogramy.

Automatyzacja przynosi najlepsze rezultaty wtedy, gdy każdy system ma jasno określoną rolę, a dane są regularnie kontrolowane. Dzięki temu zmiany cen, stanów, opisów i zdjęć mogą być przekazywane do odpowiednich kanałów sprzedaży w sposób przewidywalny, uporządkowany i odporny na typowe błędy występujące przy masowej wymianie danych.

Zgłoszenie naprawy: 22 390 56 49 — telefon czynny całą dobę, siedem dni w tygodniu. Sprzęt odbieramy spod wskazanego adresu w Grodzisku Mazowieckim i okolicy.