BaseLinker – import z hurtowni CSV pozwala szybko zasilić sklep ofertą dostawcy bez ręcznego przepisywania danych. W Serwisie Wiatraczna (Aleja Stanów Zjednoczonych 72) konfigurujemy import plików CSV z hurtowni, mapujemy kolumny na pola produktu i ustawiamy cykliczną aktualizację cen oraz stanów magazynowych.
Dlaczego import CSV jest trudniejszy niż wygląda
Plik CSV wydaje się prostszym formatem niż XML, ale w praktyce generuje własną kategorię problemów. Separatory kolumn różnią się między dostawcami – przecinek, średnik, tabulator – podobnie jak kodowanie znaków, przez co polskie litery po imporcie zamieniają się w nieczytelne symbole. Kolejność kolumn potrafi się zmienić z dnia na dzień bez informowania odbiorcy, co przy sztywnym mapowaniu pozycyjnym prowadzi do podstawienia ceny w miejsce nazwy produktu albo odwrotnie.
Problemem bywa też brak nagłówków w pliku, niespójne formaty liczb (przecinek zamiast kropki dziesiętnej), puste wartości interpretowane jako zera oraz duplikaty indeksów, które przy nieprawidłowej konfiguracji nadpisują istniejące oferty zamiast je aktualizować. Bez wcześniejszej walidacji pliku import CSV potrafi po cichu zepsuć całą ofertę sklepu.
Co dokładnie robimy
- Analizujemy strukturę pliku CSV, kodowanie znaków i separator, dobierając prawidłowe ustawienia parsera.
- Mapujemy kolumny pliku na pola BaseLinker – nazwa, SKU, EAN, cena netto/brutto, VAT, stan magazynowy, kategoria, opis, zdjęcia.
- Konfigurujemy reguły cenowe – narzuty procentowe i kwotowe, zaokrąglenia, minimalne marże.
- Ustawiamy harmonogram cyklicznego pobierania i przetwarzania pliku z serwera FTP, adresu URL lub innego źródła dostawcy.
- Wdrażamy walidację danych wejściowych, aby błędny wiersz nie zatrzymywał całego importu ani nie nadpisywał poprawnych danych zerami.
- Konfigurujemy mapowanie kategorii i atrybutów zgodnie ze strukturą sklepu docelowego.
- Testujemy import na próbce danych, sprawdzając poprawność cen, stanów i kompletności opisów.
- Uruchamiamy import produkcyjny i monitorujemy pierwsze cykle synchronizacji.
Najczęstsze problemy przy imporcie CSV
Najczęstszym źródłem awarii jest cicha zmiana struktury pliku przez dostawcę – dodanie nowej kolumny przesuwa wszystkie kolejne pola, co przy mapowaniu pozycyjnym prowadzi do wpisania ceny w pole nazwy lub odwrotnie. W Serwisie Wiatraczna konfigurujemy mapowanie w oparciu o nagłówki kolumn tam, gdzie to możliwe, oraz wdrażamy alerty przy nietypowej liczbie kolumn lub wierszy w nowym pliku.
Częstym problemem są też błędy kodowania – plik zapisany w Windows-1250 zaimportowany jako UTF-8 zamienia polskie znaki w bezsensowne ciągi. Ustawiamy parser tak, aby automatycznie wykrywał lub poprawnie interpretował kodowanie źródłowe pliku dostawcy.
Dla kogo jest ta usługa
Rozwiązanie kierujemy do sklepów i hurtowników korzystających z dostawców publikujących ofertę w plikach CSV – zarówno przy jednorazowym imporcie startowym, jak i przy stałej, automatycznej synchronizacji cen i stanów.
Jak przebiega współpraca z Serwisem Wiatraczna
Rozpoczynamy od przeglądu przykładowego pliku CSV i ustalenia zasad przeliczania cen. Przygotowujemy konfigurację testową, weryfikujemy wynik razem z klientem, a po akceptacji wdrażamy harmonogram automatycznego importu wraz z opieką nad jego stabilnym działaniem.
