Import produktów i dopasowania z zamówień

Ta strona opisuje dwa narzędzia, które oszczędzają wpisywania:

• Import tworzy albo aktualizuje wiele produktów z jednego arkusza. Complaia sprawdza każdy wiersz, zanim cokolwiek zapisze.
• Dopasowania z zamówień mówią Complaia, o który z Twoich produktów chodzi sklepowi, gdy jego zamówienia przychodzą z nazwami i kodami sklepu.

Gdzie to znaleźć: Katalog → Produkty → Lista produktów, a potem Importuj produkty w nagłówku strony. Dopasowania z zamówień są w każdym produkcie: otwórz go, kliknij Edytuj i przejdź do kroku Logistyka.

Kiedy z tego korzystasz

• Przenosisz dane z arkusza, starego systemu albo cennika dostawcy.
• Dodajesz naraz całą serię nowych produktów zamiast zakładać karty pojedynczo.
• Zmieniasz ceny: plik z kodami i nowymi cenami, wgrany jako aktualizacja, która nie rusza reszty produktu.
• Wczytujesz produkty razem z ich wariantami, paczkami i dopasowaniami z zamówień.
• Ze sklepu wciąż przychodzą zamówienia z pozycjami, które nie są połączone z żadnym produktem, i chcesz, żeby kolejne zamówienia trafiały do właściwego produktu.

Najważniejsze pojęcia

• Cztery kroki — Plik, Mapowanie, Import, Wynik. Panel Przewodnik obok okna wyjaśnia bieżący krok.
• Jeden wiersz to jeden produkt. Wariant ma osobny wiersz.
• Dopasowanie do istniejącego produktu — zanim cokolwiek się zapisze, Complaia szuka istniejącego produktu po SKU (kodzie produktu) z wiersza. Jeśli go nie znajdzie, szuka po EAN-ie.
• Akcja — każdy wiersz dostaje w kolumnie Co zrobić jedną z akcji: Utwórz, Aktualizuj albo Pomiń. Complaia podpowiada akcję dla każdego wiersza, a Ty możesz ją zmienić.
• Aktualizacja zmienia tylko to, co jest w pliku. Wszystko inne w produkcie zostaje bez zmian.
• Nic się nie zapisuje, dopóki nie klikniesz Importuj na kroku 3. Między krokami od 1 do 3 możesz swobodnie przechodzić tam i z powrotem.
• Import działa w tle. Możesz zamknąć okno. W firmie może trwać tylko jeden import naraz.
• Dopasowanie z zamówień — zapisana reguła: „ten EAN, kod albo nazwa w zamówieniu oznacza ten produkt”.

Ekran

Krok 1: Plik.

• Przeciągnij plik na pole upuszczania albo kliknij je, żeby wybrać plik. Obsługiwane formaty to CSV, XLSX i XLS.
• Jeśli skoroszyt ma kilka arkuszy, wybierz Arkusz do zaimportowania.
• Jeśli arkusz zaczyna się od tytułu albo notatek, odpowiedz na pytanie Który wiersz zawiera nagłówki kolumn?, wskazując wiersz nagłówków.
• Panel Przewodnik ma przyciski Otwórz pełny przewodnik i Zbuduj przykładowy plik. Pełny przewodnik wymienia każde pole z dopuszczalnymi wartościami, nazwami kolumn w każdym języku aplikacji i przykładem. Stamtąd możesz też kliknąć Pobierz pełny poradnik (PDF).

Krok 2: Mapowanie. Po lewej jest pole produktu w Complaia, po prawej kolumna z Twojego pliku.

• Kolumny są przypisywane do pól automatycznie na podstawie nazw nagłówków, w dowolnym języku aplikacji.
• Pola są pogrupowane w sekcje: Podstawy, Cena, Atrybuty, Logistyka, Produkcja, Warianty. Każda sekcja pokazuje, ile jej pól przypisano.
• Nagłówki, których nie rozpoznano, są wymienione jako nierozpoznane kolumny. Przypisz je ręcznie albo zostaw. Wtedy zostaną pominięte.
• Kliknij pole, żeby zobaczyć w panelu Przewodnik jego opis, dopuszczalne wartości i przykład.

Krok 3: Import. Podgląd.

• Tabela ma kolumny Nazwa, Status i Co zrobić. W kolumnie Status jest Gotowe do utworzenia, informacja, że produkt już istnieje, albo znalezione problemy.
• Zastosuj dla wszystkich ustawia jedną akcję we wszystkich wierszach, w których się da.
• Pokaż zmiany rozwija wiersz, żeby było widać dokładnie, co zostanie zapisane, i żeby można było tam poprawić wartość.
• Jeśli plik wymienia kategorie, których nie masz, panel nad tabelą pokazuje je, każdą z polem wyboru. Każdy wiersz mówi, czy jego kategoria zostanie utworzona, czy produkt zostanie zaimportowany bez kategorii.
• Stopka pokazuje, ile wierszy zostanie zaimportowanych i ile mniej więcej to potrwa, obok przycisku Importuj.

Krok 4: Wynik.

• W trakcie importu widzisz Import w toku, pozostały czas, licznik zdjęć i przycisk Przerwij. Liczniki Utworzono, Zaktualizowano, Pominięto i Błędy rosną w miarę zapisywania wierszy.
• Po zakończeniu widzisz też tabelę Wiersze z problemami i przycisk Pobierz raport.

📷 Zrzut ekranu do dodania: krok 3 okna Importuj produkty z jednym wierszem rozwiniętym przez „Pokaż zmiany” i widocznym panelem brakujących kategorii.

Typowe zadania

Import produktów z pliku

1. Otwórz Katalog → Produkty → Lista produktów i kliknij Importuj produkty.
2. Wybierz plik. W razie potrzeby wybierz arkusz i wiersz nagłówków. Kliknij Dalej.
3. Sprawdź przypisanie kolumn. Popraw wszystko, co trafiło do złego pola. Kliknij Dalej.
4. Przeczytaj podgląd. Zmień akcję w kolumnie Co zrobić w wierszach, w których nie zgadzasz się z podpowiedzią, i zaznacz kategorie, które mają zostać utworzone.
5. Kliknij Importuj.
6. Poczekaj na wynik albo zamknij okno. Import dokończy się na serwerze.

Gdy import trwa, ponowne otwarcie Importuj produkty pokazuje jego postęp. Po zakończeniu wynik nie jest już pokazywany ponownie. Jeśli chcesz mieć tabelę Wiersze z problemami i raport, zostań w oknie.

Jeśli klikniesz Przerwij, import zatrzyma się na bieżącym wierszu. Produkty zapisane do tej pory zostają.

Wiersz z błędem jest zawsze pomijany, niezależnie od akcji. Reszta pliku i tak się zaimportuje.

Budowanie przykładowego pliku

1. Na kroku 1 kliknij Zbuduj przykładowy plik w panelu Przewodnik.
2. Wybierz gotowy zestaw pól (Prosty, Wszystkie pola, Z wariantami albo Aktualizacja cen) albo zaznacz potrzebne pola, sekcja po sekcji. Możesz dodać Ceny w dodatkowych walutach, Paczki, Dopasowania z zamówień i swoje atrybuty.
3. Kliknij Pobierz CSV. Dostaniesz plik z nagłówkami kolumn w Twoim języku i przykładowym wierszem.

Kolumny atrybutów w przykładowym pliku mają nagłówki, ale nie mają wartości, bo wartości zależą od Twoich produktów.

Decyzja dla każdego wiersza

Akcja	Co robi
Utwórz	Dodaje nowy produkt. Proponowana, gdy wiersz nie pasuje do żadnego istniejącego produktu.
Aktualizuj	Zapisuje kolumny z pliku w dopasowanym produkcie. Proponowana, gdy wiersz pasuje do istniejącego produktu.
Pomiń	Nic nie robi z wierszem.

Complaia podpowiada:

• Pomiń dla wiersza z błędami;
• Aktualizuj dla wiersza dopasowanego do istniejącego produktu;
• Utwórz dla każdego innego wiersza.

Aktualizacja istniejących produktów bez zmiany reszty

1. Przygotuj plik z kolumną SKU (albo EAN) i tylko tymi kolumnami, które chcesz zmienić. Do zmiany cen użyj kolumn SKU i Cena.
2. Zaimportuj go jak zwykle. Na kroku 2 Complaia informuje, że plik bez kolumny z nazwą może tylko aktualizować produkty. Wiersze, które nie pasują do istniejącego produktu po SKU ani po EAN-ie, zostaną pominięte.
3. Na kroku 3 dopasowane wiersze mają ustawioną akcję Aktualizuj. Rozwiń Pokaż zmiany w kilku wierszach, żeby je sprawdzić.
4. Kliknij Importuj.

Co aktualizacja robi z każdym rodzajem kolumny:

W pliku	Co dzieje się z produktem
Zwykła kolumna (nazwa, cena, kategoria…)	Wartość zostaje zastąpiona.
Pusta wartość	Nic. Pusta wartość nigdy nie czyści wartości w produkcie. Żeby wyczyścić pole, wpisz w nim pojedynczy myślnik (-).
Cena EUR i inne kolumny dodatkowych walut	Ta waluta zostaje dodana albo zaktualizowana; pozostałe waluty zostają.
Kolumny Atrybut: …	Zmieniają się tylko atrybuty, które są w pliku.
Zdjęcia (adresy URL)	Lista z pliku zastępuje zdjęcia produktu. Pomiń tę kolumnę, żeby zachować zdjęcia.
Kolumny Paczka 1: …	Paczki z pliku zastępują paczki produktu. Zostanie to odrzucone, dopóki produkt ma stan albo otwarte operacje magazynowe. W zestawie kolumny paczek są pomijane.
Kolumny Dopasowanie 1: …	Dopasowania są dodawane; istniejące zostają.

Import wariantów

1. Daj każdemu wariantowi osobny wiersz.
2. W kolumnie SKU produktu nadrzędnego każdego wiersza wariantu wpisz SKU produktu nadrzędnego.
3. Zaimportuj plik jak zwykle.

Produkt nadrzędny może być w dowolnym miejscu tego samego pliku albo już istnieć w katalogu. Automatycznie staje się produktem z wariantami.

Jeśli nie ma produktu o takim SKU, wiersz wariantu zostaje odrzucony. Nie powstaje jako osobny produkt. Co musi spełniać produkt, żeby dostać warianty, opisuje strona Warianty produktów.

Tworzenie kategorii, których potrzebuje plik

Kategorie podaje się nazwą. Każda nazwa, której nie ma w systemie, jest wymieniona na kroku 3 razem z wierszami, które jej używają.

1. Zaznacz kategorie, które mają zostać utworzone.
2. Kliknij Importuj.

Kategoria, której nie zaznaczysz, nie powstanie, a jej produkty zostaną zaimportowane bez kategorii. Każdy wiersz mówi, która z tych dwóch rzeczy nastąpi.

Import nigdy nie tworzy atrybutów. Kolumna atrybutu, którego nie masz, zostaje pominięta, a podgląd o tym informuje.

Informacje szczegółowe

Kolumny, które rozumie import

Nazwy kolumn nie muszą być dokładne. Rozpoznawane są typowe nazwy w każdym języku aplikacji, a wielkość liter nie ma znaczenia. Pełny przewodnik pokazuje dopuszczalne nazwy każdego pola. Poniżej nazwy z polskiego pliku przykładowego.

Sekcja	Kolumny
Podstawy	Nazwa · SKU · EAN · UPC (północnoamerykański numer kodu kreskowego) · Opis · Producent · Marka · Kategoria · Rodzaj produktu · Produkowany u nas · Aktywny · Zdjęcia (adresy URL)
Cena	Cena · Waluta · Cena netto czy brutto · Stawka VAT (%) · Cena z kodem waluty, na przykład Cena EUR
Atrybuty	Atrybut: i nazwa atrybutu, na przykład Atrybut: Kolor
Logistyka	Waga · Jednostka wagi · Szerokość · Wysokość · Głębokość · Jednostka wymiarów · Ilość w opakowaniu · Stan minimalny · Jednostka magazynowa · Paczka 1: długość / szerokość / wysokość / waga / nazwa · Dopasowanie 1: EAN / kod / nazwa
Produkcja	Czas produkcji (sekundy)
Warianty	Rola w rodzinie wariantów · SKU produktu nadrzędnego

Paczki i dopasowania z zamówień są numerowane: druga paczka ma kolumny Paczka 2: … i tak dalej.

Kolumny atrybutów. Po dwukropku wpisz nazwę atrybutu dokładnie tak, jak brzmi w Complaia. Jeśli dwa atrybuty mają tę samą nazwę, import nie wie, o który chodzi, i odrzuca wiersze z wartością w tej kolumnie. Nadaj atrybutom różne nazwy albo użyj Zbuduj przykładowy plik: wtedy w nagłówku zostanie wpisany wewnętrzny klucz atrybutu.

Limity

Limit	Wartość
Wiersze w jednym imporcie	5000
Kolumny w jednym imporcie	500
Rozmiar pliku	25 MB
Rozmiar jednego zdjęcia pobieranego z linku	10 MB
Nazwa produktu	300 znaków
Opis	5000 znaków

Jak odczytywane są wartości

• Liczby — jako separator dziesiętny działa zarówno przecinek, jak i kropka; spacje są ignorowane. 12,50 i 12.50 to ta sama kwota. Nie dopisuj symbolu waluty. Unikaj separatorów tysięcy: 1.234 można odczytać na dwa sposoby, a Complaia ostrzega, gdy na taki zapis trafi.
• Tak / nie — słowa w dowolnym języku aplikacji albo 1 i 0.
• Listy (zdjęcia) — oddzielaj adresy średnikiem. Każdy adres musi zaczynać się od http:// albo https:// i prowadzić bezpośrednio do pliku zdjęcia.
• Czas produkcji (sekundy) podaje się w sekundach: kwadrans to 900. Na karcie produktu wartość jest widoczna jako Czas produkcji. Formularz produktu nie ma na nią pola, więc plik to jedyny sposób, żeby ją ustawić.
• SKU z zerem na początku (na przykład 007) — sformatuj kolumnę w arkuszu jako tekst. Inaczej zera zginą, zanim plik dotrze do Complaia.
• Pliki CSV — zapisuj w kodowaniu UTF-8. Separator (przecinek, średnik albo tabulator) jest rozpoznawany automatycznie.

Dopasowania z zamówień

Gdy z podłączonego sklepu przychodzi zamówienie, jego pozycje opisują produkt sklepu: nazwę, czasem kod, czasem numer kodu kreskowego. Complaia musi ustalić, który to z Twoich produktów, żeby stan, produkcja i fakturowanie korzystały z właściwego produktu.

Jak działa dopasowanie

Complaia sprawdza wartości z przychodzącej pozycji w tej kolejności i zatrzymuje się na pierwszej, która znajdzie produkt:

1. EAN, jeśli to prawdziwy numer kodu kreskowego (od 8 do 14 cyfr, nie same zera);
2. UPC, jeśli pozycja go ma;
3. kod produktu;
4. nazwa.

Dla każdej wartości:

• Jeśli dla tej wartości istnieje zapisane dopasowanie, pozycja zostaje połączona z dopasowanym produktem.
• W przeciwnym razie Complaia szuka w katalogu. Numer kodu kreskowego porównuje z EAN i UPC produktów, a kod z SKU produktów. Jeśli znajdzie produkt, łączy z nim pozycję i zapisuje dopasowanie. Na liście dopasowanie ma wtedy znacznik automatycznie.
• Nazwy nigdy nie są dopasowywane automatycznie. Nazwa zostaje połączona z produktem tylko wtedy, gdy sam ją dopasujesz.
• Produkt z wariantami nigdy nie zostaje dopasowany. Zamówienie musi zawsze wskazywać konkretny wariant, więc pozycja czeka na dopasowanie do wariantu.

Pozycję z nieznanym EAN-em można więc wciąż dopasować po kodzie. Pozycja, która do niczego nie pasuje, przychodzi bez produktu i trzeba ją dopasować ręcznie.

Dodawanie dopasowania w produkcie

1. Otwórz produkt, kliknij Edytuj i przejdź do kroku Logistyka.
2. W sekcji Dopasowania z zamówień wypełnij pole EAN z zamówienia, Kod produktu z zamówienia albo Nazwa z zamówienia.
3. Kliknij Dodaj.

Wypełnij tylko jedno pole. Dopasowanie zapisuje się pod pierwszym wypełnionym polem: pod EAN-em, a jeśli go nie ma, pod kodem, a jeśli i jego nie ma, pod nazwą. Pozostałe pola tego samego dopasowania nie służą do szukania produktu. Jeśli sklep wysyła i EAN, i kod, dodaj dwa dopasowania.

Dopasowanie zapisuje się od razu. Pozycje zamówień, które czekały z tą wartością, zostają połączone z produktem, a Complaia informuje, ile zamówień zaktualizowano.

W nowym produkcie sekcja działa inaczej:

1. Kliknij Dodaj dopasowanie, żeby dodać wiersz.
2. Wypełnij go i kliknij Zatwierdź.
3. Dopasowanie zapisze się razem z produktem.

W produkcie z wariantami dodawaj dopasowania w oknie wariantu, na jego kroku Logistyka.

Dopasowanie pozycji w zamówieniu

1. Na karcie zamówienia kliknij Dopasuj produkt w pozycji, która nie ma produktu.
2. Wybierz produkt.

Complaia łączy pozycję, zapisuje dopasowanie i łączy każdą inną czekającą pozycję z tą samą wartością. Zobacz Dopasowanie pozycji do produktu.

Usuwanie dopasowania

1. Na kroku Logistyka produktu kliknij ikonę kosza obok dopasowania.
2. Potwierdź pytanie Usunąć dopasowanie? Zamówienia z tym kodem albo nazwą trzeba będzie wtedy dopasowywać ręcznie.

Pozycje, które już połączono, zachowują swój produkt. Zmiana dotyczy tylko przyszłych zamówień.

Przepinanie dopasowań z produktu na jego warianty

Jeśli produkt miał dopasowania, zanim dostał warianty, jego krok Logistyka pokazuje sekcję Dopasowania do przepięcia na wariant. Dopóki ich nie przepniesz, zamówienia z nimi czekają na ręczne dopasowanie.

1. Przy każdym dopasowaniu wybierz Wariant docelowy.
2. Kliknij Przepnij i potwierdź. Pozycje zamówień, które przez to dopasowanie były połączone z produktem, przechodzą razem z nim na wariant.

Przepięcia nie da się cofnąć jednym kliknięciem. Żeby je odwrócić, usuń dopasowanie z wariantu, dodaj je właściwemu produktowi i dopasuj przeniesione pozycje na nowo.

Gdy coś nie działa

Co widzisz	Dlaczego	Co zrobić
Plik ma … wierszy, a jeden import obsługuje najwyżej 5000. Podziel go na mniejsze części.	Plik przekracza limit wierszy.	Podziel plik. Produkty już utworzone zostaną następnym razem rozpoznane jako istniejące.
Plik ma … MB, a maksimum to 25 MB. Podziel go na mniejsze części.	Plik jest za duży.	Podziel go.
Komunikat na kroku 2, że trzeba przypisać kolumnę z nazwą albo kolumnę SKU lub EAN	Krok 2 nie pójdzie dalej bez jednej z tych kolumn. Bez nich nie da się zidentyfikować wiersza.	Przypisz kolumnę ręcznie.
Pole wymagane, brak wartości	Wiersz, który miałby utworzyć produkt, nie ma nazwy.	Uzupełnij nazwę albo pomiń wiersz.
Ten sam SKU występuje już w wierszu …	To samo SKU, EAN albo UPC występuje w pliku dwa razy.	Zdecyduj, który wiersz jest właściwy, i usuń drugi.
W systemie są 2 kategorie o nazwie „…”, więc nie wiadomo, którą wybrać	Dwie z Twoich kategorii mają tę nazwę.	Zmień nazwę jednej z nich na ekranie Kategorie.
Nazwę „…” ma kilka atrybutów (klucze: …), więc nie wiadomo, który wybrać.	Dwa z Twoich atrybutów mają tę nazwę.	Zmień nazwę jednego z nich albo podaj w nagłówku kolumny klucz atrybutu.
Atrybut …: wartość „…” spoza listy. Dopuszczalne: …	Atrybut ma stałą listę opcji, a wartości na niej nie ma.	Użyj jednej z wymienionych opcji albo dodaj opcję w atrybucie.
Komunikat, że wartość można odczytać na dwa sposoby	Jeden separator, po którym są trzy cyfry, można odczytać na dwa sposoby.	Rozwiń wiersz przez Pokaż zmiany i popraw wartość albo popraw plik.
Nie znaleziono produktu nadrzędnego o SKU „…”	Wiersz wariantu wskazuje produkt nadrzędny, którego nie ma ani w pliku, ani w katalogu.	Dodaj wiersz produktu nadrzędnego albo popraw SKU.
Produkt nadrzędny „…” nie może zostać rodzicem wariantów: …	Produkt nadrzędny ma stan, otwarte zlecenia produkcyjne albo jest używany w zestawie lub recepturze.	Usuń przeszkody wymienione w komunikacie. Zobacz Warianty produktów.
Nie można zmienić paczek tego produktu, bo ma zapas albo otwarte operacje magazynowe. Rozlicz je i zaimportuj wiersz ponownie.	Plik zmienia paczki produktu, który jest w magazynie.	Zobacz Paczki produktu.
Wiersz się nie zapisał, bo skład zestawu jest w obiegu	Plik zmienia zestaw, którego produkty są zarezerwowane, spakowane albo w produkcji dla otwartych dokumentów.	Zakończ te dokumenty, a potem zaimportuj wiersz ponownie.
Zdjęcie … jest niedostępne… albo Adres … nie prowadzi do pliku obrazu…	Link nie działa albo jest prywatny, albo prowadzi do strony internetowej. Produkt i tak zostaje zaimportowany, bez tego zdjęcia.	Popraw link i zaimportuj wiersz ponownie jako aktualizację.
Komunikat w wyniku, że części zdjęć nie udało się przenieść	Części zdjęć nie udało się skopiować do Complaia; te produkty wskazują pierwotny adres.	Sprawdź format (JPG, PNG, WEBP, AVIF) i linki, a potem zaimportuj te wiersze ponownie.
Komunikat, że nie możesz edytować produktów, więc import nie zmieni istniejących produktów	Wiersz ma akcję Aktualizuj, a Twoja rola może tylko tworzyć.	Ustaw w tych wierszach Pomiń albo poproś o uprawnienie Produkty: Edycja.
Komunikat, że nie możesz tworzyć kategorii	Zaznaczono kategorie do utworzenia.	Odznacz je albo poproś o uprawnienie Kategorie: Tworzenie.
Komunikat, że trwa już inny import	W firmie może trwać tylko jeden import naraz.	Poczekaj albo otwórz Importuj produkty i kliknij Przerwij.
Pozycja zamówienia wciąż nie ma produktu, choć produkt istnieje.	Pozycja przyszła tylko z nazwą, jej kod nie jest Twoim SKU albo produkt ma warianty.	Dodaj dopasowanie w produkcie (albo w wariancie) albo użyj Dopasuj produkt w zamówieniu.
Dopasowania mają warianty na kroku Logistyka	Produkt ma warianty.	Dodaj dopasowanie w oknie wariantu.

Uprawnienia

Aby…	Potrzebujesz
Otworzyć Importuj produkty i tworzyć nim produkty	Produkty: Tworzenie
Ustawić w wierszu akcję Aktualizuj	Dodatkowo Produkty: Edycja
Tworzyć kategorie z podglądu	Dodatkowo Kategorie: Tworzenie
Widzieć dopasowania z zamówień produktu	Produkty: Podgląd
Dodać, usunąć albo przepiąć dopasowanie z zamówień	Produkty: Edycja

Zobacz też

• Produkty — lista, z której uruchamiasz import
• Formularz produktu — formularz, który wypełnia importowany wiersz
• Warianty produktów · Paczki produktu · Ceny
• Atrybuty · Kategorie — muszą istnieć, zanim plik ich użyje, z wyjątkiem kategorii zaznaczonych w podglądzie
• Kody i etykiety — zasady dla SKU, EAN i UPC
• Integracje · Mapowania — sklepy, których pozycje zamówień są dopasowywane
• Karta zamówienia — gdzie trafia dopasowana pozycja
• Słownik pojęć — dopasowanie z zamówień