# Produkty Odnowione PrestaShop: instalacja i konfiguracja > Przegląd Moduł dodaje do PrestaShop 8 i 9 obsługę produktów odnowionych i egzemplarzy unikatowych. Każda klasa stanu (A, B, C i kolejne, które dodasz) jest natywną wartością atrybutu: produkt odnowiony… - Strona: - Język: pl - Zaktualizowano: 2026-10-07 - Inne języki: [fr](https://www.datafirefly.com/documentation/dfrefurbished/index.md), [en](https://www.datafirefly.com/en/documentation/dfrefurbished/index.md), [es](https://www.datafirefly.com/es/documentation/dfrefurbished/index.md), [de](https://www.datafirefly.com/de/documentation/dfrefurbished/index.md), [it](https://www.datafirefly.com/it/documentation/dfrefurbished/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfrefurbished/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfrefurbished/index.md) - Indeks: ## Przegląd Moduł dodaje do PrestaShop 8 i 9 obsługę produktów odnowionych i egzemplarzy unikatowych. Każda klasa stanu (A, B, C i kolejne, które dodasz) jest natywną wartością atrybutu: produkt odnowiony ma więc kombinacje typu „128 GB Czarny, klasa A”. Każde urządzenie jest egzemplarzem z numerem seryjnym, zdjęciami i testami, a stan każdej kombinacji klasy jest równy liczbie dostępnych egzemplarzy. ## Instalacja 1. W **Moduły > Menedżer modułów** kliknij **Prześlij moduł** i wyślij plik `dfrefurbished-1.2.1.zip`. 2. Instalacja tworzy grupę atrybutów **Grade (DataFirefly)**, wyświetlaną w sklepie jako „Stan”, z klasami A, B i C. 3. Pojawia się menu **Katalog > Egzemplarze odnowione**. Przycisk Konfiguruj modułu prowadzi do klas i ustawień. Aby zaktualizować wcześniejszą wersję, wystarczy przesłać nowy plik ZIP: skrypt aktualizacji dodaje potrzebne kolumny i tabele. ## Konfiguracja klas W konfiguracji modułu blok **Klasy stanu** zawiera klasy z polami: - **Kod** (A, B, C…) i **kolor**, używane na kartach, odznakach i etykietach; - **Nazwa i opis** w każdym języku (link „Pokaż wszystkie języki”); - **Domyślny wpływ na cenę** w procentach (0, -10 i -20% przy instalacji); - **Pozycja**: pierwsza klasa jest najlepsza, jej wskaźnik jest pełny; - **Aktywna**. Ostatni wiersz pozwala dodać klasę (zaznacz **Dodaj**). Klasy nie można usunąć, ponieważ używają jej kombinacje i zamówienia: zamiast tego ją dezaktywuj. ## Ustawienia modułu - **Pokaż karty klas** na stronie produktu, ze wskaźnikiem, ceną, oszczędnością i stanem. - **Ukryj natywny wybór klasy**, gdy karty są wyświetlane. - **Tryb egzemplarza: ukryj natywny przycisk dodawania do koszyka**; klient dodaje wtedy egzemplarz jego własnym przyciskiem. - **Maskuj numery seryjne** na stronach publicznych (widoczne 4 ostatnie znaki). - **Porównanie nowy/odnowiony** i jego pozycja: pod produktem lub obok przycisku koszyka. - **Oferta odnowiona na stronie nowego produktu**. - **Domyślne gwarancje** dla odnowionych i nowych, w miesiącach. - **Rezerwacja egzemplarza w koszyku**, domyślnie 30 minut. - **Numery seryjne w pozycji zamówienia**, a więc na fakturze i korekcie. - **Statusy zamówień przywracające egzemplarze do magazynu** (domyślnie anulowane i błąd płatności) oraz status zwolnionych egzemplarzy: dostępne lub zwrócone (do sprawdzenia). - **Lista testów**: jeden punkt w każdej linii, w każdym języku. Zachowaj tę samą kolejność we wszystkich językach, punkty są dopasowywane według numeru linii. Blok **Narzędzia** prowadzi do egzemplarzy i synchronizuje ponownie wszystkie stany. ## Przygotowanie produktu odnowionego Otwórz produkt, zakładka **Moduły**, następnie **DataFirefly Refurbished & Unique Items**. 1. Zaznacz **Ten produkt jest sprzedawany jako odnowiony**. Natywny stan produktu zmienia się na „Odnowiony”. 2. Wybierz **tryb sprzedaży**: według klasy (egzemplarz jest przypisywany przy zamówieniu) lub według egzemplarza (klient wybiera dokładne urządzenie). 3. Wskaż **odpowiadający nowy produkt** do porównania i wyświetlanej oszczędności. Kombinacje są dopasowywane według tych samych atrybutów (pojemność, kolor). 4. W razie potrzeby ustaw gwarancje i **wpływ na cenę** każdej klasy dla tego produktu, w procentach lub kwotą netto. Puste pole oznacza procent klasy. 5. Kliknij **Zapisz ustawienia odnowionego**. 6. Kliknij **Utwórz kombinacje klas**: jedna kombinacja dla każdej opcji bazowej (pojemność, kolor…) i aktywnej klasy. Opcja usuwania kasuje potem kombinacje bez klasy; wcześniejsze zamówienia zachowują swoje pozycje. 7. Kliknij **Zastosuj ceny klas**. Tabela klas pokazuje dla każdej klasy liczbę egzemplarzy dostępnych, sprzedanych, zwróconych i ukrytych. ## Dodawanie egzemplarzy W **Katalog > Egzemplarze odnowione** kliknij **Dodaj egzemplarz**. - **Produkt** (wyszukiwanie po nazwie, referencji lub ID), **kombinacja bazowa** i **klasa**. Kombinacja klasy jest tworzona automatycznie, jeśli nie istnieje. - **Numer seryjny**: unikalny w sklepie. Pole obsługuje czytnik kodów kreskowych. - **Status**: dostępny, sprzedany, zwrócony, ukryty. - **Kondycja baterii**, **gwarancja** (puste = wartość produktu lub modułu) i **data odnowienia**. - **Własna cena sprzedaży (netto)**: używana tylko w trybie egzemplarza. Puste = cena kombinacji klasy. - **Uwagi publiczne** w każdym języku i **lista testów** (OK, usterka, N/D, nie testowano). - **Zdjęcia**: JPG, PNG, WebP lub GIF, maks. 10 MB każde, automatycznie skalowane. - Panel **Wewnętrzne**: SKU, cena zakupu, pochodzenie i uwagi wewnętrzne, nigdy niewidoczne dla klientów. **Zapisz i dodaj kolejny** zachowuje produkt, kombinację i klasę dla kolejnych wpisów. Karta egzemplarza pokazuje jego historię, link do karty publicznej i przycisk drukowania etykiety. ## Import egzemplarzy z CSV Przycisk **Importuj CSV** na liście egzemplarzy. Plik UTF-8, separator `;` lub `,` wykrywany z wiersza nagłówka. Dostępny jest przykładowy plik. - Wymagane: `serial`, `grade` (kod klasy) oraz `product_id` lub `product_reference`. - `base_reference`: referencja kombinacji bez klasy, puste dla produktu bez innych atrybutów. - Opcjonalne: `status` (available, hidden, returned), `battery`, `warranty_months`, `date_refurbished` (RRRR-MM-DD), `price`, `cost_price`, `origin`, `sku`, `notes`, `internal_notes`. Zaznacz **Aktualizuj znane już egzemplarze**, aby zmienić istniejące numery, w przeciwnym razie są pomijane. Sprzedany egzemplarz nigdy nie jest zmieniany przez import. ## W sklepie ### Strona produktu Karty klas pokazują wskaźnik stanu, cenę („Od”, gdy egzemplarze mają różne ceny), oszczędność względem nowego i stan magazynowy. Link **Jak określamy klasy?** otwiera okno z opisem każdej klasy, listą testów i gwarancją. ### Tryb egzemplarza Pod kartami lista **Wybierz swój egzemplarz** pokazuje każdy dostępny egzemplarz wybranej klasy: zdjęcie (przeglądarka pełnoekranowa po kliknięciu), zamaskowany numer, bateria, testy, gwarancja i cena. Przycisk **Dodaj ten egzemplarz** rezerwuje go w koszyku na ustawiony czas; egzemplarz zarezerwowany już przez innego klienta pokazuje „Zarezerwowany”. ### Porównanie i nowy produkt Tabela porównuje nowy produkt i każdą klasę: cenę, oszczędność, stan wizualny, gwarancję, dostępność. Na stronie nowego produktu ramka proponuje ofertę odnowioną od najtańszej klasy. ### Karta egzemplarza i certyfikat Dostępny egzemplarz ma publiczną kartę (nieindeksowaną) ze zdjęciami, baterią, listą testów i uwagami technika. Po sprzedaży kupujący znajduje w szczegółach zamówienia link do **certyfikatu stanu** z pełnym numerem, datą końca gwarancji i przyciskiem drukowania. ## Zamówienia - Przy zatwierdzeniu najpierw przypisywane są egzemplarze zarezerwowane przez koszyk, potem najstarsze wolne egzemplarze. Egzemplarze z własną ceną są zachowywane do sprzedaży według egzemplarza. - Numer seryjny jest dodawany do nazwy pozycji zamówienia, jeśli ustawienie jest włączone. - Zamówienie w panelu pokazuje blok **Egzemplarze odnowione** z linkiem do każdego egzemplarza. - Przy wybranych statusach egzemplarze wracają jako dostępne lub zwrócone, a zdarzenie jest zapisywane w ich historii. ## Panel i etykiety Nad listą egzemplarzy: egzemplarze w sprzedaży, do sprawdzenia i ukryte, wartość stanów po cenie zakupu, średni wiek stanów i liczba egzemplarzy w sprzedaży od ponad 60 dni, sprzedane egzemplarze, przychód netto i marża brutto z 30 dni. Akcja zbiorcza **Drukuj etykiety** otwiera arkusz A4 z 24 etykietami 63,5 x 33,9 mm (typ L7159): produkt, klasa, bateria, numer seryjny i kod QR do karty egzemplarza. Pole **Zacznij od etykiety nr** pozwala wykorzystać częściowo zużyty arkusz. Drukuj w skali 100%, bez marginesów i nagłówków. ## Znane ograniczenia - Własna cena egzemplarza działa tylko w trybie egzemplarza, a reguły cenowe katalogu nie dotyczą egzemplarzy z własną ceną. - W produkcie odnowionym stan wpisany ręcznie na kombinacji klasy jest zastępowany liczbą dostępnych egzemplarzy. - Jeśli pracownik bez uprawnień do modułu edytuje produkt, PrestaShop nie uruchamia hooków modułu: użyj ponownej synchronizacji stanów. - Ukrywanie natywnego wyboru klasy opiera się na HTML natywnej strony produktu. Przy mocno zmodyfikowanym motywie natywny wybór może pozostać widoczny obok kart. - Jeśli rezerwacja egzemplarza wygaśnie, gdy jest on jeszcze w koszyku, inny klient może go zarezerwować; zamówienie pierwszego klienta otrzyma wtedy inny egzemplarz tej samej klasy, jeśli istnieje.