Otwórz narzędzie

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.

Wersja treści 1.0. Publikacja: . Aktualizacja: .

Wszystkie produkty, kody i dane dostawcy w tym ćwiczeniu są fikcyjne. Pliki służą nauce, nie importowi do żywego sklepu.

Pobierz CSV z duplikatemWczytaj plik w Zlecajto

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.

  1. 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.

  2. 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.

  3. Ś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.

Fikcyjny katalog: dwa kolory, jeden powtórzony kod
Wierszgrupakodnazwaopiscenakolor
2kubek-pracowniaKUB-01Kubek PracowniaCeramiczny kubek 300 ml49,00Niebieski
3kubek-pracowniaKUB-01Kubek PracowniaCeramiczny kubek 300 ml49,00Zielony

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.

Źródło poprawki w tym ćwiczeniu
ProduktKolorPotwierdzony kod
Kubek PracowniaNiebieskiKUB-01
Kubek PracowniaZielonyKUB-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.

Mapowanie dla obu plików źródłowych
ŹródłoPole w Zlecajto → nagłówek eksportuUstawienie
grupaIdentyfikator produktu / URL handle → URL handleJeden produkt: kubek-pracownia.
kodSKU wariantu → SKUKod z pliku, bez automatycznej poprawy.
nazwaNazwa produktu → TitleKubek Pracownia.
opisOpis (opcjonalnie) → DescriptionCeramiczny kubek 300 ml.
cenaCena → Price49,00 dla każdego koloru.
kolorWartość opcji 1 → Option1 valueNiebieski i Zielony.
Brak kolumnyNazwa opcji 1 → Option1 namePozostaw „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.

Przed i po naprawie źródła
Wiersz / wariantPrzedPoPodstawa
3 / ZielonyKUB-01KUB-02Fikcyjna tabela dostawcy
  1. 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ę.

  2. 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.

  3. Porównaj podgląd

    Oczekiwany wynik to 1 produkt, 2 wiersze wariantów i brak problemów. Sprawdź kody KUB-01 / KUB-02 oraz 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.

W tabeli są wszystkie kolumny eksportu. Przewiń ją w poziomie. „—” oznacza pustą komórkę; ten znak nie trafia do CSV.

Wynik: jeden handle, dwa różne SKU i kolory
URL handleTitleSKUPriceDescriptionOption1 nameOption1 valueStatusPublished on online store
kubek-pracowniaKubek PracowniaKUB-0149.00Ceramiczny kubek 300 mlKolorNiebieskidraftfalse
kubek-pracownia—KUB-0249.00—KolorZielonydraftfalse

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