Import danych z Excel i CSV

QuoteNode udostępnia prowadzony kreator importu do ładowania danych katalogu produktów z plików Excel (.xlsx) i CSV (.csv). System zawiera gotowe szablony z przykładowymi danymi i instrukcjami.

Pobierz szablon importu

Zanim przygotujesz własne dane, pobierz oficjalny szablon:

1. Przejdź do Products > Import
2. Kliknij Download Template
3. Wybierz Template with examples albo Empty template

Szablon zawiera:

• wiersz nagłówków ze wspieranymi kolumnami,
• arkusz instrukcji opisujący każde pole,
• przykładowe rekordy pokazujące poprawny format,
• oznaczenie pól wymaganych gwiazdką (*).

Kolumny w szablonie

Kolumna	Wymagana	Opis
SKU		Identyfikator produktu. Jeśli pozostawisz puste, system może wygenerować go automatycznie.
NAME	*	Nazwa produktu widoczna w ofertach i PDF.
UNIT_PRICE	*	Cena netto. Używaj kropki jako separatora dziesiętnego, np. 149.99.
UNIT_PRICE_GROSS		Cena brutto. Jeśli podana, ma pierwszeństwo przy wyliczeniach brutto-first.
VAT_RATE		Stawka VAT, np. 0, 5, 8, 23. Domyślnie używana jest stawka bazowa workspace’u.
UNIT		Jednostka miary, np. szt., kg, h, m, m2, m3, l, set. Domyślnie pcs.
GROUP_NAME		Nazwa grupy produktu. Grupy są tworzone automatycznie, jeśli nie istnieją.
DESCRIPTION_SHORT		Krótki opis widoczny w pozycjach oferty.
DESCRIPTION_LONG		Dłuższy opis do widoków szczegółowych produktu.
WEIGHT_KG		Waga produktu w kilogramach, używana przy kalkulacjach dostawy.
MIN_QUANTITY		Minimalna ilość zamówienia.
QUANTITY_STEP		Krok ilości, np. 0.5 dla zamówień po pół jednostki.
STATUS		active albo inactive, akceptowane są też wartości typu 1/0, yes/no.
REFERENCE_URL		Zewnętrzny link do specyfikacji produktu.
IMAGE_URL		URL zdjęcia produktu. Wspierane formaty: jpg, png, webp, gif, svg.
NOTES		Notatki wewnętrzne niewidoczne dla klienta.

Dodatkowe kolumny w Twoim pliku są ignorowane. Nie musisz ich usuwać.

Workflow importu

Krok 1 - Wgraj plik

Przeciągnij plik Excel lub CSV albo wskaż go z dysku. Dla CSV system automatycznie rozpoznaje separator i kodowanie.

Krok 2 - Mapowanie kolumn

System analizuje nagłówki i próbuje automatycznie dopasować kolumny do pól QuoteNode. W razie potrzeby popraw mapowanie ręcznie:

• każda kolumna źródłowa może wskazywać jedno pole docelowe,
• niezamapowane kolumny są pomijane,
• pola wymagane muszą być zmapowane przed przejściem dalej.

Jeśli importujesz dane regularnie z tego samego źródła, możesz zapisać mapowanie jako nazwany szablon.

Krok 3 - Dry run

Przed właściwym importem system wykonuje walidację:

• sprawdza pola wymagane,
• waliduje format cen, URL i jednostek,
• wykrywa duplikaty po SKU,
• pokazuje podgląd pierwszych rekordów i błędów.

Dry run nie zapisuje nic do bazy. To moment na poprawę pliku źródłowego przed faktycznym importem.

Krok 4 - Wykonaj import

Po zatwierdzeniu QuoteNode:

• utworzy nowe produkty dla nieznanych SKU,
• zaktualizuje istniejące produkty dopasowane po SKU,
• utworzy grupy produktów odwołane w GROUP_NAME,
• pobierze obrazy z URL i zapisze je lokalnie.

Po zakończeniu zobaczysz podsumowanie: ile rekordów zaimportowano, zaktualizowano, pominięto i które zakończyły się błędem.

Import zdjęć produktów

Zdjęcia można zaimportować na dwa sposoby.

Przez URL w szablonie

Dodaj kolumnę IMAGE_URL z linkiem HTTP lub HTTPS do obrazu produktu. System pobierze plik podczas importu.

Przez ZIP z mediami

Dla większych katalogów możesz użyć osobnego importu ZIP:

1. Przejdź do Products > Import > Media Import
2. Wgraj archiwum ZIP
3. Nazwij pliki zgodnie z SKU, np. PRD-001.jpg
4. System dopasuje je do produktów po SKU

Podgląd dry-run pokaże, które pliki zostały przypięte poprawnie, a które pominięto.

Szablony mapowania

Jeśli regularnie importujesz z tego samego ERP lub formatu dostawcy:

1. W kroku mapowania kliknij Save Mapping Template
2. Nadaj nazwę szablonowi
3. Przy kolejnym imporcie wybierz go, aby automatycznie odtworzyć mapowanie

Szablony mapowania są przechowywane per tenant i mogą być oznaczone jako domyślne.

Wskazówki

• Zaczynaj od oficjalnego szablonu, bo upraszcza nazewnictwo kolumn.
• Zawsze używaj dry run przy większych importach.
• Utrzymuj konsekwentne SKU, bo to klucz do aktualizacji bez duplikacji.
• Zachowuj spójne nazwy grup produktów, aby uniknąć bałaganu w kategoriach.
• Dla CSV z polskimi znakami upewnij się, że plik ma kodowanie UTF-8.