Dokumentacja CSV Shopify

Dokumentacja pliku CSV – format Shopify

Ważna informacja o strukturze:
Shopify wymaga specyficznej struktury pliku CSV. Produkty są grupowane na podstawie kolumny Handle. Każdy wariant rozmiarowy to osobny wiersz w pliku, ale wszystkie warianty tego samego modelu muszą mieć identyczny Handle.

Struktura wariantów produktów

Każdy wiersz w pliku opisuje pojedynczy wariant produktu (konkretny rozmiar) lub dodatkowe zdjęcie.

Główny opis produktu (Title, Body (HTML)) znajduje się tylko w pierwszym wierszu dla danego modelu. Kolejne wiersze (kolejne rozmiary) zawierają tylko dane specyficzne dla wariantu (np. SKU, rozmiar, stan magazynowy).

Przykład struktury pliku CSV

Poniżej znajduje się przykładowy fragment pliku CSV. Zwróć uwagę na powtarzający się identyfikator w kolumnie Handle.

Handle,Title,Option1 Name,Option1 Value,Variant SKU,Variant Price,Variant Inventory Qty,Image Src
555,"Sukienka z kołnierzykiem",Size,S,111-2-S,86.09,15,https://domena.pl/img/foto1.jpg
555,,Size,M,111-2-M,86.09,12,
555,,Size,L,111-2-L,86.09,5,
555,,,,,,,https://domena.pl/img/foto2.jpg

Grupowanie wariantów (Kluczowe kolumny)

Handle – unikalny identyfikator modelu (łączy warianty w jeden produkt)

Option1 Name – nazwa cechy wariantu (w tym pliku zawsze: "Size")

Option1 Value – wartość wariantu (konkretny rozmiar: XS, S, M, L)

Title – nazwa produktu (wypełniona tylko w pierwszym wierszu)

Aby Shopify poprawnie zgrupował rozmiary S, M i L jako jeden produkt, wiersze te muszą mieć identyczną wartość w kolumnie Handle.

Identyfikatory i Mapowanie

Do aktualizacji stanów magazynowych i cen w sklepie Shopify zalecamy opierać integrację na polach:

Variant SKU – unikalny kod produktu przypisany do konkretnego rozmiaru

Handle – stały identyfikator produktu głównego

W tym pliku Handle jest identyfikatorem numerycznym (np. 555), co zapewnia stabilność aktualizacji, nawet jeśli zmienisz nazwę produktu w swoim sklepie.

Aktualizacja danych a linki URL (SEO)

W pliku jako identyfikatorów URL (Handle) używamy stałych numerów ID produktów. Dzięki temu, nawet jeśli zmienisz nazwy produktów w swoim sklepie, my będziemy mogli w przyszłości aktualizować ich stany magazynowe i ceny bez błędów.

Zmiana linków (SEO): Jeśli chcesz zmienić adresy URL na przyjazne dla SEO (z nazwami), możesz to zrobić ręcznie w edycji produktu (na dole strony w sekcji SEO).

Ważne przy aktualizacji:
Przy kolejnym imporcie aktualizacyjnym musisz zaznaczyć opcję 'Overwrite any current products that have the same handle' (Nadpisz istniejące produkty). Dzięki temu system powiąże dane po SKU lub ID i zaktualizuje stany, zamiast tworzyć duplikaty produktów.

Ceny i dostępność

Variant Price – cena netto/brutto wariantu

Variant Inventory Qty – ilość sztuk dostępna na magazynie

Variant Inventory Policy – polityka magazynowa (np. "deny" - nie sprzedawaj poniżej 0)

Każdy wariant (rozmiar) posiada własny stan magazynowy i cenę zdefiniowaną w odpowiednim wierszu.

Zdjęcia produktów

Image Src – link URL do zdjęcia

Image Position – kolejność wyświetlania zdjęcia

Image Alt Text – tekst alternatywny dla zdjęcia (SEO)

Uwaga: Główne zdjęcie przypisane jest w pierwszym wierszu produktu. Dodatkowe zdjęcia (galeria) znajdują się w osobnych wierszach na końcu grupy produktu, gdzie wypełnione są tylko kolumny Handle oraz Image Src.