#255

Sekcja w panelu administracyjnym: Katalog → Import towarów.

Co to jest

Kreator masowego dodawania i aktualizacji towarów z pliku Excel. Zastępuje ręczne wprowadzanie po jednym w Katalog → Towary, gdy firma zakłada nową kolekcję płyt, aktualizuje cennik producenta lub podłącza sobie setki nowych pozycji od razu. Plik może zawierać setki i tysiące wierszy.

Dostęp: otwarty dla administratora firmy głównej (z prawem importu „w imieniu" dowolnej wybranej firmy) i dla zwykłych firm z wypełnionymi kontaktami (telefon + e-mail) — bez kontaktów import jest zablokowany, aby było do kogo zadzwonić przy problemach z dużym ładunkiem.

Obsługiwane formaty

Tylko Excel: .xlsx lub .xls. Jeden plik na import. Kodowanie — standardowe Excel, separatory kolumn system określa sam.

Kroki kreatora

Krok 1. Wczytanie pliku

  • Wybór firmy (tylko administrator firmy głównej; zwykła firma importuje tylko do siebie). Importowane towary zostaną przypisane do wybranej firmy.
  • Pobierz przykładowy plik — przycisk generowania wzorcowego Excel ze wszystkimi prawidłowymi kolumnami. Każdy nagłówek zawiera komentarz z opisem pola — korzystaj, aby zrozumieć co gdzie. W samym pliku przykładowym jest drugi arkusz „Opis pól" — szczegółowy słownik każdego pola; podczas wczytywania przetwarzany jest tylko pierwszy arkusz, pozostałe (w tym ten) są ignorowane i nie przeszkadzają w imporcie.
  • Wczytaj plik — wybierasz swój .xlsx i klikasz „Wczytaj".

Również na tym kroku widoczna jest formuła tworzenia nazwy towaru:

[kod dekoru] [struktura] [typ zaokrąglenia] [promień] [wodoodporny] [nazwa dekoru] [nazwa producenta] [X] [Y] [Z]

Typ zaokrąglenia blatu przyjmuje wartości 1U, 2U, 1L, 2L (warianty profilu krawędzi), 1ABS (krawędź z jednej dłuższej strony zamknięta obrzeżem ABS), 2ABS (krawędź z dwóch stron zamknięta obrzeżem ABS) lub XX (bez zaokrąglenia). Promień zaokrąglenia to jeden z: R1, R1.5, R3, R3.3, R5.5, R6, R9, R13 (w mm).

Nazwa składana jest automatycznie z odpowiednich kolumn Excel — nie trzeba ręcznie układać każdej nazwy. Daje to jednolitość: towary jednej kolekcji otrzymują jednolity format nazwy, różnią się tylko wymiarami i cechami. Jeśli typ i promień zaokrąglenia są już zawarte w kodzie lub nazwie dekoru, system sam je wycina — aby nazwa się nie powielała — i tworzy ostateczną nazwę od razu we wszystkich językach katalogu.

Typ i promień zaokrąglenia trzeba podawać tylko dla prawdziwych blatów — materiał jest uznawany za blat na podstawie zestawu cech, w tym charakterystycznej grubości. Panele ścienne, choć dostarczane w formacie arkusza, nie mają zaokrągleń, więc system nie wymaga podawania tych pól dla nich.

Krok 2. Dopasowanie kolumn (mapping)

Excel rzadko wygląda dokładnie tak, jak wymaga system: u różnych producentów kolumny są inaczej nazwane i ułożone w innej kolejności. Na tym kroku mówisz systemowi, gdzie w pliku jakie pole.

  • Podgląd pliku — rozwijana tabela z zawartością: pierwsze wiersze widoczne od razu, można zobaczyć, która kolumna co zawiera.
  • Wiersz nagłówków — numer wiersza, w którym znajdują się nazwy kolumn (często 1, ale nie zawsze — u niektórych producentów są kilka wierszy nagłówka).
  • Zakres importu — od którego wiersza zacząć („Dane od wiersza") i do którego zakończyć („Do wiersza"). Pozwala to pominąć wiersze podsumowujące na końcu lub komentarze służbowe na początku.
  • Dopasowanie pól — dla każdego pola systemu wybierz odpowiednią kolumnę Excel (lub „nie używaj", jeśli takiego w pliku nie ma).
  • Wodoodporność — pole nieobowiązkowe, wartość puste lub 1. Jeśli podano 1, do nazwy towaru we wszystkich językach katalogu automatycznie dodawany jest dopisek „Wodoodporny", a przy dopasowywaniu duplikatów (krok 3) materiał wodoodporny i zwykły są traktowane jako różne pozycje. Kolumnę system potrafi rozpoznać po słowach kluczowych (wodoodporność, wilgoć, waterproof, moisture i podobnych).
  • Wygodne skróty klawiszowe w podglądzie: kliknięcie w wiersz = wiersz początkowy importu, Shift+klik = końcowy, Ctrl+klik = wiersz nagłówków. Pomaga nie wpisywać numerów ręcznie przy dużych plikach.
  • Jednostka sprzedaży — pole akceptuje kilka formatów zapisu: wg powierzchni (м2, m2 lub odpowiedni kod cyfrowy) — materiał jest liczony i sprzedawany w metrach kwadratowych, albo w arkuszach (sheet lub odpowiedni kod cyfrowy) — materiał sprzedawany jest całymi arkuszami. Wielkość liter i dokładna pisownia nie mają znaczenia. W formularzu edycji towaru jednostkę można też wybrać z listy rozwijanej.
  • Pola obowiązkowe są podświetlane — jeśli nie są dopasowane, przycisk „Kontynuuj" jest zablokowany.
  • Sprawdzanie wymiarów według typu materiału — dla każdego typu materiału określone są dopuszczalne granice szerokości, długości i grubości; jeśli wymiary pozycji wykraczają poza granice, wiersz jest podświetlany ostrzeżeniem z podaniem dopuszczalnego zakresu. W tabeli wyników importu widoczna jest kolumna „Typ materiału" — widać, do jakiego typu przypisano każdą pozycję.
  • Walidacja w locie — jeśli w danych są oczywiste błędy (puste pola obowiązkowe, błędne liczby w wymiarach), pokazywane są ze wskazaniem numerów wierszy.
  • Sprawdzanie nazw i kodów — niedozwolone znaki (cudzysłowy, nawiasy, znaki specjalne) w kodzie dekoru, nazwie dekoru, strukturze lub nazwie dodatkowej pokazywane są jako osobny błąd z listą znalezionych znaków. W nazwie dekoru nie wolno mieszać cyrylicy i łaciny — na przykład łacińskie C zamiast cyrylickiego С system rozpoznaje i podpowiada, jakim znakiem je zastąpić, wskazując pozycję i kod znaku.

Krok 3. Dopasowanie duplikatów (matching)

Najmądrzejszy krok. System porównuje każdy wiersz z Excel z już istniejącymi towarami wybranej firmy i proponuje trzy scenariusze na każdy wiersz:

Porównanie uwzględnia nie tylko kod dekoru, ale też typ materiału i strukturę: jeśli w Excelu podano typ materiału, który nie zgadza się z typem już istniejącego towaru, uznaje się to za różne pozycje i obca karta nie zostaje podstawiona. Podobnie ze strukturą — jeśli u istniejącego towaru jest ona określona, a w cenniku nie, to również różne towary.

  • Nowy towar — takiego artykułu jeszcze nie ma, utworzyć od zera.
  • Aktualizuj istniejący — artykuł już jest, zaktualizuj cechy/ceny/obrazy. Widoczne, jakie pola zostaną zmienione. Właściwości towaru (kod dekoru, nazwa, struktura, parametry zaokrąglenia) są nadpisywane tylko wtedy, gdy zaznaczona jest opcja „aktualizuj dane" — bez niej ponowne wczytanie cennika nie nadpisuje ręcznie zweryfikowanych kart, a aktualizacja jest po prostu odnotowywana jako pominięta.
  • Pomiń — nie ruszać istniejącego towaru, nie tworzyć nowego.

Dla każdego wiersza widoczny jest preview porównania: bieżąca wartość w systemie ↔ nowa wartość z Excel. Można zmienić decyzję „nowy/aktualizuj/pomiń" po wierszach przed uruchomieniem importu.

Jeśli towar ma ustawione pseudonimy (wewnętrzne oznaczenia Twojej firmy), są one widoczne wprost w procesie importu — na tym kroku dopasowania, podczas edycji wiersza i w wynikach końcowych. Wyświetlane są tylko pseudonimy Twojej firmy — oznaczenia innych firm nie są domieszywane.

Krok 4. Obróbka obrazów

Jeśli w Excel jest kolumna z URL obrazów (Google Drive, bezpośrednie linki), system osobno przetwarza obrazy:

  • Pobieranie po URL — system pobiera obraz i zapisuje w katalogu.
  • Porównanie rozmiarów — jeśli towar już ma obraz, nowy jest ładowany tylko jeśli jest większy (wyższa rozdzielczość). Obraz niskiej jakości nie zastąpi dobrego.
  • Podgląd przed zamianą — widoczne oba obrazy obok siebie, oznaczone co się stanie: „zostanie zamieniony (nowy jest większy)" lub „nie zostanie zaktualizowany (bieżący jest większy)".
  • Częste problemy:
    • Google Drive: plik musi być publiczny, inaczej link nie działa.
    • Lokalne ścieżki (C:\photos\...) — nie działają, potrzebne są pełnoprawne URL.
    • Linki wymagające autoryzacji — są pomijane z oznaczeniem.

Krok 5. Wynik

Podsumowanie: ile wierszy utworzono, ile zaktualizowano, ile pominięto, ile z błędami. Błędy są pokazywane wierszowo — można poprawić Excel i zaimportować ponownie tylko problematyczne wiersze.

Historia importów

Wszystkie uruchomione importy są zapisywane z datą, firmą, nazwą pliku i użytkownikiem, który uruchomił. Administrator firmy głównej widzi wszystkie importy wszystkich firm; zwykła firma — tylko swoje. Można otworzyć kartę poprzedniego importu, aby zobaczyć, co i kiedy było wgrywane — przydatne przy analizach „skąd nagle wzięły się te 200 towarów".

Co jest ważne

  • Pobierz przykład przed pierwszym importem. W nim komentarze w nagłówkach wyjaśniają każde pole — to wielokrotnie szybsze niż zgadywanie.
  • Nazwa towaru nie jest podawana ręcznie. Wypełnij osobne pola (kod dekoru, nazwa dekoru, nazwa producenta, wymiary) — system złoży nazwę według formuły sam. Gwarantuje to jednolitość.
  • Producent musi istnieć przed importem (zob. Producenci). Jeśli w Excel jest podany producent, którego nie ma w słowniku, wiersz trafi do błędów.
  • Najpierw spróbuj na 10 wierszach, potem na pełnym pliku. Mapowanie kolumn i sprawdzanie duplikatów często wymaga 2–3 iteracji, aby wychwycić wszystkie niuanse Twojego konkretnego cennika.
  • Obrazy lepiej przygotować wcześniej: umieścić na Google Drive z dostępem publicznym, postawić linki w odpowiedniej kolumnie Excel. Po imporcie zostaną zaciągnięte.
  • Rodzaj towaru (obrzeże czy płyta) system określa na podstawie typu materiału w słowniku, a nie tekstu nazwy — obrzeże jest rozpoznawane jako obrzeże niezależnie od języka nazwy. Jeśli typ jest oznaczony jako płytowy, ale wymiary są wyraźnie typowe dla obrzeża (mała szerokość i grubość), pozycja jest automatycznie przeklasyfikowywana na obrzeże; przy obrzeżach literowy sufiks kodu dekoru jest wtedy przenoszony do pola „Struktura", ale tylko jeśli nie jest ono jeszcze wypełnione.
  • Jeśli wynik kroku 3 (matching) pokazał wiele „aktualizacji" tam, gdzie powinny być „nowe" — prawdopodobnie niewłaściwie dopasowany kod producenta. Wróć do kroku 2 i sprawdź mapowanie kolumny „kod".
  • Jeśli kontakty Twojej firmy są puste (telefon lub e-mail) — import jest zablokowany. Wypełnij je najpierw w karcie firmy.