Dla dużych katalogów

Generowanie GARAN-Label dla dużego katalogu: CSV czy API

Chcesz masowo wygenerować GARAN-Label dla kilkuset lub kilku tysięcy produktów i potrzebujesz najpierw trzech odpowiedzi: czy narzędzie poradzi sobie z moim katalogiem, ile to będzie kosztować i ile zajmie czasu. Ta strona odpowiada na wszystkie trzy pytania konkretnymi liczbami.

Która metoda pasuje do Twojego katalogu?

Właściwa metoda zależy od dwóch rzeczy: ile produktów potrzebuje labela i jak często te dane się zmieniają.

Metoda	Wielkość katalogu	Częstotliwość zmian	Najlepsza dla
Wprowadzanie ręczne	Mniej niż 10 labeli	Rzadko	Małych sklepów, kilku produktów z gwarancją, jednorazowych uzupełnień.
Import CSV	Od 10 do 10 000 labeli	Głównie stały, odświeżenie co kilka miesięcy	Sprzedawców i marek z dużym, ale stabilnym katalogiem. Bez programowania.
API	Dowolna	Częste zmiany, nowe produkty co tydzień	Sklepów sterowanych przez PIM lub ERP, agencji, każdego, kto chce, aby label powstawał automatycznie przy zakładaniu produktu.

Możesz je łączyć: większość dużych katalogów zaczyna od jednego importu CSV dla istniejącego asortymentu i przechodzi na API dla nowych produktów. Szczegóły techniczne obu metod znajdziesz na stronie dokumentacji API i CSV.

Najpierw filtruj, potem generuj: które SKU w ogóle potrzebują labela

Najskuteczniejszy sposób na obniżenie kosztu masowego generowania zaczyna się przed przesłaniem pliku. GARAN-Label jest wymagany tylko dla produktów, dla których producent oferuje darmową gwarancję handlową trwałości obejmującą cały produkt na okres dłuższy niż dwa lata. Każdy inny produkt potrzebuje darmowej informacji o gwarancji ustawowej, ale nie GARAN-Label.

Przepuść eksport produktów przez trzy pytania:

Czy to towar fizyczny? Treści cyfrowe i usługi są poza zakresem.
Czy istnieje gwarancja producenta dłuższa niż dwa lata? Gwarancja dokładnie dwuletnia lub krótsza nie wymaga labela.
Czy jest darmowa i obejmuje cały produkt? Płatne rozszerzenia gwarancji i gwarancje na pojedyncze podzespoły się nie liczą.

W praktyce katalog z 5 000 SKU często kurczy się do kilkuset produktów, które faktycznie się kwalifikują. Całą resztę możesz usunąć z pliku CSV przed przesłaniem. Szczegóły, kogo dotyczy obowiązek →

Czego potrzebujesz dla każdego SKU: marka, model, okres gwarancji

Sam label jest prosty. Zawiera trzy wartości, a plik CSV potrzebuje dokładnie tych trzech kolumn:

brand

Marka lub znak towarowy w takiej formie, w jakiej widnieje na produkcie.

model

Identyfikator modelu. Warianty, które go współdzielą, współdzielą też label.

duration

Okres gwarancji w latach, pełnych lub połówkach, na przykład 3 lub 2.5.

Szczerze o najtrudniejszej części: okres gwarancji

Marka i model są w każdym systemie sklepowym. Okresu gwarancji producenta zwykle nie ma. Większość baz produktowych ma co najwyżej pole „gwarancja", a w nim często są warunki sprzedawcy, a nie gwarancja producenta. Gdzie te dane zwykle się ukrywają:

Cenniki dostawców i karty produktów, często jako uwaga w polu tekstowym.
Warunki gwarancji na stronie producenta lub w ulotce w opakowaniu.
Atrybut w PIM lub ERP, który kiedyś wypełniono dla kilku marek i nigdy nie aktualizowano.

Praktyczny skrót: producenci rzadko ustalają okres gwarancji per SKU. Zwykle jest stały dla marki lub serii produktów. Zbierz okres gwarancji raz dla każdej marki i serii, a potem dołącz go do eksportu SKU. Zamienia to research nad tysiącami wierszy w listę kilkudziesięciu pozycji.

Przykład obliczeń: katalog z 1 000 SKU

Poniższe liczby to ilustracja na zaokrąglonych wartościach, a nie pomiar u konkretnego klienta. Pokazują, jak działa arytmetyka, abyś mógł podstawić własny katalog.

SKU w sklepie	1 000	Pełny eksport, wszystkie kategorie.
SKU z gwarancją producenta dłuższą niż dwa lata	380	Po trzech pytaniach filtrujących powyżej. Pozostałe 620 potrzebuje tylko darmowej informacji.
Unikalne kombinacje marka + model + okres gwarancji	240	Rozmiary i kolory współdzielą identyfikator modelu, a więc i label.
Zużyte kredyty	240	Jeden kredyt za każdy wyrenderowany label. Wiersze z powtórzoną kombinacją wykorzystują istniejący label.
Pakiet kredytów	500 kredytów za 49 €	Zostaje 260 kredytów na nowe produkty. Alternatywnie dwa pakiety po 100 kredytów za 38 €, jeśli wiesz, że asortyment nie urośnie.
Twój czas	Pół dnia	Niemal cały idzie na zebranie okresów gwarancji. Przesłanie pliku zajmuje minuty, generowanie działa bez nadzoru.

Wynikiem jest plik z jednym wierszem na każdy wiersz wejściowy i adresem URL pasującego labela. Następnie pobierasz obrazy i umieszczasz je w sklepie, patrz poniżej.

Przygotowanie pliku CSV

Plik przygotujesz w dowolnym arkuszu kalkulacyjnym. Co ma znaczenie:

Kolumny: brand, model, duration oraz opcjonalnie force_regeneration (1 wymusza nowe renderowanie, puste lub 0 wykorzystuje istniejący label).
Separator: przecinek lub średnik. Import rozpoznaje użyty separator po wierszu nagłówka, więc plik ze średnikami, jaki domyślnie zapisuje polski Excel, działa bez zmian.
Kodowanie: UTF-8, aby polskie znaki, umlauty i akcenty w nazwach marek i modeli przeszły bez zniekształceń.
Limit wierszy i rozmiaru pliku: brak. Plik jest odczytywany wiersz po wierszu, niezależnie od rozmiaru.
Format: przed przesłaniem wybierasz PNG, EPS lub PDF dla całego pliku. PNG to to, czego potrzebujesz do sklepu, EPS i PDF są do druku.
Przetwarzanie: działa w tle ze wskaźnikiem postępu. Możesz zamknąć kartę, wylogować się i wrócić; zadanie działa dalej.

brand;model;duration;force_regeneration
Bosch;GSR 18V-55;3;
Bosch;GSR 18V-55;3;
Makita;DHP486;3;
Miele;W1 WCD 120;5;

Dwa wiersze Bosch są celowe: pokazują, co robi deduplikacja. Oba wiersze dostają ten sam adres URL labela, zużywany jest tylko jeden kredyt.

Wejście: jeden wiersz na produkt lub na model.

Plik wynikowy masowego generowania GARAN-Label z dodatkową kolumną Label-URL w każdym wierszu

Wyjście: te same wiersze plus adres URL labela dla każdego z nich.

Deduplikacja: dźwignia kosztowa przy generowaniu masowym

Kredyt płaci za wyrenderowany label, a nie za wiersz w Twoim pliku. Zasada jest prosta: identyczna kombinacja marka + model + okres gwarancji oznacza jeden label, niezależnie od tego, ile wierszy lub wariantów produktu na niego wskazuje. Trzy konsekwencje dla dużego katalogu:

Warianty są darmowe. Dziesięć wersji kolorystycznych jednego modelu zużywa jeden kredyt.
Ponowne przesłanie tego samego pliku nic nie kosztuje, dopóki labele istnieją na naszym serwerze. Otrzymujesz z powrotem istniejące adresy URL.
Tylko rzeczywiste zmiany kosztują kredyty. Zmieniony okres gwarancji to nowa kombinacja, a więc nowy label. Ustawienie force_regeneration na 1 również renderuje ponownie i zużywa kredyt, więc zostaw to pole puste, chyba że potrzebujesz świeżego pliku.

Arytmetyka z przykładu powyżej: 1 000 wierszy, 240 unikalnych kombinacji, 240 kredytów. Płacisz za wyrenderowany label, nie miesięcznie i nie za stanowisko użytkownika, więc katalog, który się nie zmienia, nie generuje dalszych kosztów.

Pakiety kredytów

Kredyty	Cena	Cena za label
100	19,00 €	0,19 €
500	49,00 €	0,10 €
2000	144,00 €	0,07 €
10 000	569,00 €	0,06 €

Wszystkie ceny nie zawierają ustawowego podatku VAT. 1 kredyt odpowiada 1 nowo wygenerowanemu labelowi. Identyczne powtórzenia (ta sama marka, ten sam model, ten sam okres gwarancji) nie zużywają dodatkowego kredytu. Bez subskrypcji, bez minimalnego zamówienia.

Przeniesienie plików do sklepu: hostowane adresy URL czy własny hosting

Każdy wygenerowany label jest dostępny pod adresem URL z Twojego pliku wynikowego. Przy dużym katalogu masz dwa sposoby, aby go użyć:

Hostowany adres URL (krótkoterminowo)

Linkujesz obraz bezpośrednio. Dobre do testów i szybkiego zapełnienia sklepu, ale labele są archiwizowane 30 dni po wygenerowaniu. Potem link przestaje działać, a nowe żądanie renderuje label ponownie, zużywając kredyt.

Własny hosting (zalecane)

Pobierz obrazy w ciągu 30 dni, prześlij je do własnej biblioteki mediów lub CDN i przypisz do produktów po SKU lub modelu. To zadanie jednorazowe, a label pozostaje online tak długo, jak potrzebujesz.

Sposób przypisania zależy od platformy: metapole w Shopify, atrybut produktu w Magento 2, pole niestandardowe w WooCommerce. Każdy przewodnik opisuje ścieżkę masową. Przewodniki według kanału sprzedaży →

Błędy i przypadki brzegowe w dużych plikach

Sytuacja	Co się dzieje	Co zrobić
Wiersz nie ma modelu (albo marki lub okresu gwarancji)	Tylko ten wiersz jest oznaczony jako błąd w pliku wynikowym. Wszystkie pozostałe wiersze są przetwarzane.	Popraw wiersz i prześlij go ponownie w małym pliku uzupełniającym.
W nagłówku brakuje wymaganej kolumny	Całe zadanie zatrzymuje się z komunikatem „Missing required column".	Sprawdź nazwy w nagłówku: dokładnie `brand`, `model`, `duration`.
Nagłówek wygląda poprawnie, ale zadanie nadal zgłasza brak kolumny `brand`	Plik najprawdopodobniej zaczyna się od niewidocznego znacznika BOM. Excel dodaje go przy zapisie jako „CSV UTF-8".	Zapisz jako zwykły CSV lub usuń znacznik w edytorze tekstu. Nazwy kolumn muszą zaczynać się od pierwszego bajtu pliku.
Wiersze z okresem gwarancji dwa lata lub krótszym	Są generowane jak każdy inny wiersz i zużywają kredyt. Narzędzie nie decyduje za Ciebie, czy label jest wymagany.	Odfiltruj je przed przesłaniem; te produkty nie potrzebują GARAN-Label.
Rozmiary i kolory jako osobne wiersze	Wiersze z tą samą marką, modelem i okresem gwarancji współdzielą jeden label i jeden kredyt.	Nic. Zostaw wiersze, jeśli ułatwia to późniejsze przypisanie wyniku do Twoich SKU.
Przecinki lub średniki w nazwie modelu	Obowiązuje standardowe cytowanie CSV.	Ujmij wartość w cudzysłów, tak jak każdy arkusz kalkulacyjny robi to automatycznie.
Polskie znaki lub akcenty wyglądają źle na labelu	Plik został zapisany w starszym kodowaniu (np. Windows-1250).	Zapisz go jako UTF-8 i prześlij ponownie z `force_regeneration` ustawionym na `1` dla dotkniętych wierszy.

Najpierw przetestuj strukturę pliku: tryb sandbox działa również dla importu CSV i renderuje próbki PNG ze znakiem wodnym bez zużywania kredytów.

Gotowy, aby oznakować cały katalog?

Zarejestruj się za darmo, prześlij plik testowy w trybie sandbox i sprawdź wynik, zanim kupisz choć jeden kredyt.

Wypróbuj za darmo

Potrzebujesz parametrów technicznych i przykładowego kodu? Dokumentacja API i CSV →

Kto w ogóle potrzebuje GARAN-Label →
Przewodniki osadzania według kanału sprzedaży →

FAQ

Pytania dotyczące masowego generowania GARAN-Label

Ile trwa wygenerowanie 1 000 GARAN-Label?

Około dwóch do czterech minut. Przesyłasz plik raz, a generowanie działa w tle na naszych serwerach, partiami, nawet jeśli zamkniesz przeglądarkę. Potem pobierasz plik wynikowy. Przy katalogu tej wielkości zaplanuj popołudnie na przygotowanie danych, nie na samo generowanie.

Czy import CSV ma limit liczby wierszy lub rozmiaru pliku?

Nie, ani liczby wierszy, ani rozmiaru pliku. Plik jest odczytywany wiersz po wierszu i przetwarzany w tle, więc bardzo duże katalogi działają bez dzielenia pliku. Jeśli wolisz, możesz przesłać osobny plik dla każdej marki lub dostawcy, aby pliki wynikowe były łatwiejsze w obsłudze.

Czy płacę za każdy wiersz w pliku CSV?

Nie. Kredyt jest zużywany tylko wtedy, gdy label jest faktycznie renderowany. Wiersze z identyczną kombinacją marki, modelu i okresu gwarancji współdzielą jeden label, a wiersz, który jedynie ponownie żąda istniejącego labela w jego 30-dniowym oknie, nic nie kosztuje.

Czy warianty produktu, np. rozmiary lub kolory, potrzebują osobnych labeli?

Zazwyczaj nie. Label pokazuje markę, model i okres gwarancji. Jeśli Twoje warianty mają ten sam identyfikator modelu i tę samą gwarancję, jeden label obejmuje je wszystkie. Właśnie tu deduplikacja oszczędza Twoje kredyty.

Czym ta strona różni się od strony API?

Ta strona pomaga zdecydować, jak oznakować duży katalog i ile to kosztuje. Strona API to dokumentacja techniczna z parametrami i przykładowym kodem dla cURL, PHP, Pythona i Node.js. Dokumentacja API i CSV →

Masz więcej pytań? Zobacz wszystkie FAQ →