Duplikaty SKU: znajdź przyczynę i napraw CSV
Dwa kolory kubka mają ten sam kod. Wczytaj plik, zobacz błąd w wierszu 3 i sprawdź, co potwierdza dostawca. Potem popraw jedną komórkę, ponów walidację i porównaj wynik: jeden produkt, dwa warianty.
Najpierw ustal, co się powtórzyło
Zlecajto wymaga unikalnego SKU każdego wiersza w jednym wczytanym pliku. Powtórzenie blokuje eksport. To reguła tego narzędzia, a nie uniwersalny zakaz Shopify: jego dokumentacja opisuje ostrzeżenie oraz świadome użycie wspólnego SKU w określonych procesach, np. zestawach. Źródło: zasady SKU Shopify.
Omyłkowo powtórzony wiersz
Ten sam produkt, kod i wszystkie opcje występują dwa razy. Porównaj rekordy ze źródłem i potwierdź, czy drugi wiersz jest kopią. Usuń wyłącznie potwierdzoną kopię. Nadanie jej nowego SKU nie naprawi powtórzonej kombinacji wariantu.
Błędny kod innego wariantu
Opcje są różne, ale jeden kod został skopiowany lub źle przypisany. Sprawdź identyfikator konkretnego wariantu u dostawcy. Popraw błędny kod na potwierdzony; nie wymyślaj końcówki tylko po to, by przejść walidację. Taką sytuację pokazuje ćwiczenie z kubkiem.
Świadomie wspólny SKU
Jeżeli wspólny kod jest częścią uzgodnionego procesu, np. obsługi zestawów, potwierdź jego znaczenie z osobą odpowiedzialną za katalog i integracje. Obecny Zlecajto nie obsługuje takiego pliku. Zachowaj identyfikatory i wybierz proces przygotowania importu zgodny z tym założeniem; nie zmieniaj kodów dla samego odblokowania eksportu.
SKU, handle i opcje to trzy różne rzeczy. SKU identyfikuje wariant w Twoim katalogu. Wspólny URL handle grupuje warianty jednego produktu i w tym ćwiczeniu ma się powtarzać. Kombinacja wartości opcji odróżnia wariant w tej grupie — tutaj niebieski od zielonego kubka.
Zmiana SKU nie naprawia dwóch identycznych zestawów opcji pod jednym handle. Zlecajto sprawdza te problemy oddzielnie.
1. Porównaj plik z potwierdzonym źródłem
sku-duplikat.csv ma separator średnik, kodowanie UTF-8 i polski przecinek w cenie. Nagłówek to wiersz 1. Wiersze 2 i 3 opisują dwa kolory tego samego kubka, lecz oba zawierają KUB-01.
Na małym ekranie przewiń samą tabelę w poziomie. Pełne dane są w pliku do pobrania.
| Wiersz | grupa | kod | nazwa | opis | cena | kolor |
|---|---|---|---|---|---|---|
| 2 | kubek-pracownia | KUB-01 | Kubek Pracownia | Ceramiczny kubek 300 ml | 49,00 | Niebieski |
| 3 | kubek-pracownia | KUB-01 | Kubek Pracownia | Ceramiczny kubek 300 ml | 49,00 | Zielony |
Nie wiemy jeszcze, czy kod jest błędny. W naszym ćwiczeniu rozstrzyga to poniższa fikcyjna tabela dostawcy. W swoim katalogu użyj aktualnego źródła, które jednoznacznie przypisuje kod do wariantu, lub uzyskaj potwierdzenie dostawcy.
| Produkt | Kolor | Potwierdzony kod |
|---|---|---|
| Kubek Pracownia | Niebieski | KUB-01 |
| Kubek Pracownia | Zielony | KUB-02 |
2. Wczytaj CSV i potwierdź mapowanie
Otwórz narzędzie Zlecajto, wybierz Wczytaj CSV i wskaż pobrany sku-duplikat.csv. „Zobacz przykład” otwiera inne dane; w tym warsztacie korzystaj z pobranych plików.
| Źródło | Pole w Zlecajto → nagłówek eksportu | Ustawienie |
|---|---|---|
grupa | Identyfikator produktu / URL handle → URL handle | Jeden produkt: kubek-pracownia. |
kod | SKU wariantu → SKU | Kod z pliku, bez automatycznej poprawy. |
nazwa | Nazwa produktu → Title | Kubek Pracownia. |
opis | Opis (opcjonalnie) → Description | Ceramiczny kubek 300 ml. |
cena | Cena → Price | 49,00 dla każdego koloru. |
kolor | Wartość opcji 1 → Option1 value | Niebieski i Zielony. |
| Brak kolumny | Nazwa opcji 1 → Option1 name | Pozostaw „Wybierz / pomiń” i wpisz stałą nazwę Kolor niżej. |
W polu Stała nazwa opcji 1 wpisz Kolor. Pozostałe opcje i pola pomiń. Pozostaw zaznaczone Przygotuj produkty jako szkice, a następnie wybierz Sprawdź i przygotuj podgląd.
3. Napraw wyłącznie potwierdzony kod
Komunikat walidacji
Wiersz 3 · SKU: Powtórzone SKU: KUB-01
Przy podanym mapowaniu to jedyny problem w pliku. Eksport jest zablokowany. Wiersz 3 obejmuje zielony kubek; numeracja uwzględnia nagłówek.
Tabela dostawcy przypisuje zielonemu kubkowi KUB-02. W wierszu 3 zamień tylko wartość kolumny kod z KUB-01 na KUB-02. Zachowaj grupę, nazwę, opis, cenę i kolor.
| Wiersz / wariant | Przed | Po | Podstawa |
|---|---|---|---|
| 3 / Zielony | KUB-01 | KUB-02 | Fikcyjna tabela dostawcy |
Zapisz i wczytaj poprawiony plik
Zapisz CSV w UTF-8 i wczytaj go ponownie. Możesz też pobrać sku-poprawiony.csv, w którym zmieniono dokładnie tę jedną komórkę.
Ustaw ponownie reguły i uruchom kontrolę
Po ponownym wczytaniu sprawdź wszystkie przypisania z tabeli, szczególnie
grupa → URL handle. Ponownie wpisz stałą Kolor, pozostaw szkice i wybierz Sprawdź i przygotuj podgląd. Nowy plik wymaga nowej walidacji.Porównaj podgląd
Oczekiwany wynik to 1 produkt, 2 wiersze wariantów i brak problemów. Sprawdź kody
KUB-01/KUB-02oraz kolory Niebieski / Zielony.
4. Porównaj dokładny CSV i listę zmian
Poniższe pliki wygenerowano silnikiem Zlecajto dla poprawionego źródła, mapowania z tabeli, stałej Kolor i włączonych szkiców. To wzorce dla fikcyjnego ćwiczenia.
- Pobierz źródło z błędemDwa warianty z KUB-01; do odtworzenia komunikatu walidacji.
- Pobierz poprawione źródłoWiersz 3 ma KUB-02. Pozostałe komórki są identyczne.
- Pobierz oczekiwany CSV Shopify1 produkt, 2 warianty, przecinek między kolumnami, UTF-8.
- Pobierz oczekiwaną listę zmianNagłówki, jawne reguły i zmiany formatu poprawionego źródła.
W tabeli są wszystkie kolumny eksportu. Przewiń ją w poziomie. „—” oznacza pustą komórkę; ten znak nie trafia do CSV.
| URL handle | Title | SKU | Price | Description | Option1 name | Option1 value | Status | Published on online store |
|---|---|---|---|---|---|---|---|---|
| kubek-pracownia | Kubek Pracownia | KUB-01 | 49.00 | Ceramiczny kubek 300 ml | Kolor | Niebieski | draft | false |
| kubek-pracownia | — | KUB-02 | 49.00 | — | Kolor | Zielony | draft | false |
Kwoty pozostają po 49,00; zmienia się ich zapis na 49.00. Powtórzona nazwa i opis są zapisane tylko przy pierwszym wariancie. SKU, kolory i wspólny handle pozostają danymi poprawionego źródła. Stała dodaje nazwę opcji Kolor, a wybrane szkice dodają draft i false.
Lista zmian nie dokumentuje ręcznej naprawy KUB-01 → KUB-02. Opisuje przekształcenie już poprawionego pliku w eksport. Zachowaj obie wersje źródła i potwierdzenie kodu, jeśli potrzebujesz śladu naprawy. Lista nie porównuje wyniku z istniejącym sklepem.
W narzędziu przejrzyj podgląd i zaznacz potwierdzenie eksportu. Przy dostępie do wybranej paczki wybierz Pobierz CSV Shopify i Pobierz listę zmian. Porównaj pobrane pliki z wzorcami tego ćwiczenia. Pobranie CSV nie potwierdza importu do Shopify.
Przed użyciem we własnym sklepie
Zlecajto sprawdza jeden wczytany plik. Nie łączy się ze sklepem, nie wyszukuje SKU w jego katalogu i nie potwierdza przyjęcia importu. Nie potwierdziliśmy importu tych plików w autoryzowanym sklepie testowym Shopify.
Przed aktualizacją zachowaj pełny, świeży eksport sklepu i porównaj go samodzielnie. W Shopify nadpisanie dopasowuje produkty po handle; zmiana wartości opcji może zastąpić identyfikatory wariantów. Źródło: import i nadpisywanie produktów Shopify, sprawdzone 8 października 2026.
Szkice nie zabezpieczają istniejących wariantów przed zmianą. Przed właściwym importem sprawdź aktualne zasady Shopify i skutki dla swoich integracji.
Potrzebujesz podstaw albo przykładu pustej ceny? Przejdź pełny warsztat CSV dostawcy. Aby sprawdzić duplikat, wczytaj plik z tego poradnika.
Otwórz Zlecajto i wczytaj CSV