Cena jednostkowa i sprzedaż na wagę: dokumentacja DataFirefly Unit Price

Instalacja

Zainstaluj moduł w Moduły > Menedżer modułów > Załaduj moduł z pliku ZIP albo skopiuj folder dfunitprice do katalogu /modules/ sklepu i kliknij Zainstaluj.

Podczas instalacji moduł tworzy trzy tabele (zawartości, tryby sprzedaży, ważenia zamówień) i rejestruje swoje hooki. Nie dodaje pozycji w menu: wszystko ustawiasz na stronie konfiguracji modułu, w zakładce Moduły karty produktu i na stronie zamówienia.

Ustawienia modułu

Strona konfiguracji zawiera, od góry, edytor masowy, ustawienia, listę sztuk do zważenia, narzędzia i raport zgodności.

Cena jednostkowa dla wag i objętości

Wybierz domyślny sposób podawania: za 1 kg lub za 100 g, za 1 litr lub za 100 ml. Długości są zawsze podawane za metr, powierzchnie za m², objętości sypkie za m³. Każdy produkt może zmienić ten wybór.

Kraje wymagające 1 kg i 1 litra

Kody ISO oddzielone przecinkami, domyślnie DE. Dla odwiedzających z tych krajów cena jednostkowa jest zawsze podawana za 1 kg, 1 l, 1 m, 1 m² lub 1 m³, jak wymaga niemiecka PAngV, nawet jeśli gdzie indziej wybrałeś 100 g.

Wyświetlanie i pozycje

• Pokaż na stronie produktu i Pozycja na stronie produktu: cena jednostkowa korzysta z natywnego hooka displayProductPriceBlock. Pozycja after_price (pod ceną) pasuje do Classic i motywów pochodnych. Zmień ją tylko, jeśli Twój motyw nie wywołuje tej pozycji.
• Pokaż na listach produktów i Pozycja na listach: kategorie, wyszukiwarka, marki, karuzele. Domyślnie pozycja unit_price.
• Pokaż w koszyku: pod ceną każdej pozycji.
• Format: „12,90 € / kg” lub w nawiasach.
• Tekst przed ceną jednostkową: opcjonalny i tłumaczony, na przykład „Cena za kilogram”.

Ukryj, gdy równa cenie sprzedaży

Opakowanie 1 kg sprzedawane za kilogram powtarza tę samą kwotę. Niektóre kraje pozwalają jej wtedy nie pokazywać: sprawdź przepisy swojego kraju przed włączeniem opcji.

Ukryj natywną cenę jednostkową motywu

Zapobiega podwójnemu wyświetlaniu na stronie produktu, gdy motyw pokazuje też natywne pole.

Zapisuj w natywnych polach PrestaShop

Moduł aktualizuje natywną cenę jednostkową, jej etykietę jednostki (na przykład „/ kg”) i wpływ kombinacji. Moduły feedów Google Shopping i marketplace, które czytają te pola, otrzymują poprawną wartość.

Minimalny zwrot za sztuki na rzeczywistą wagę

Poniżej tej różnicy brutto w zamówieniu korekta nie jest tworzona. Zostaw 0, aby zwracać każdą różnicę.

Kategorie, w których cena jednostkowa jest obowiązkowa

Używane tylko przez raport zgodności, który wymienia aktywne produkty tych kategorii bez zawartości.

Wprowadzanie zawartości produktu

Otwórz kartę produktu, zakładka Moduły, blok Cena jednostkowa i tryb sprzedaży. Blok zapisuje się własnym przyciskiem Zapisz cenę jednostkową, niezależnie od formularza produktu.

• Zawartość netto i Jednostka: 750 g, 1,5 l, 2,5 m, 12 m² lub sztuka. Pozostaw puste, aby nie wyświetlać ceny jednostkowej.
• Cena jednostkowa podawana za: dla wag i objętości zastępuje ustawienie modułu dla tego produktu.

Pod polami zielony wiersz pokazuje w trakcie wpisywania cenę jednostkową liczoną od aktualnej ceny. Po zapisaniu podgląd przypomina cenę brutto bez rabatu, zawartość i uzyskaną cenę jednostkową.

Kombinacje

Wypełnij tylko kombinacje, których zawartość różni się od produktu, na przykład 250 g, 500 g i 1 kg. Kombinacja bez wartości korzysta z wartości produktu. Jednostka „Jak w produkcie” przejmuje jednostkę produktu. Kombinacje utworzone po otwarciu strony pojawią się po jej odświeżeniu.

Obliczenie

Cena jednostkowa to cena pokazana klientowi podzielona przez zawartość i przeliczona na wybraną jednostkę odniesienia. Uwzględnia wyświetlanie brutto lub netto grupy klienta, ceny specjalne i promocje. W koszyku używa ceny pozycji.

Sprzedaż na wagę wybraną przez klienta

Wybierz tryb Klient wybiera ilość. Zawartość staje się wielkością jednego kroku, a cena produktu ceną jednego kroku. Przykład: krok 100 g za 2,50 €, klient wybierający 700 g dodaje do koszyka 7 kroków za 17,50 €.

• Minimum i Maksimum w jednostce bazowej (g, ml, cm, m², m³): każda wartość musi być wielokrotnością kroku. Maksimum jest opcjonalne.
• Przyciski ilości: wartości oddzielone średnikami, na przykład 250; 500; 1000, każda będąca wielokrotnością kroku i mieszcząca się między minimum a maksimum.
• Zezwól na dowolną ilość: pokazuje selektor +/- z bezpośrednim wpisem. Bez przycisków ilości dowolny wpis jest zawsze widoczny.

Na karcie produktu pole ilości motywu zastępuje ten selektor, z limitami i sumą na bieżąco. Selektor działa też w szybkim podglądzie list i zachowuje wybraną wagę, gdy klient zmienia kombinację.

Co moduł robi za Ciebie

• Natywna minimalna ilość produktu i jego kombinacji jest synchronizowana w liczbie kroków.
• Maksimum jest egzekwowane po stronie serwera: większa ilość dodana do koszyka jest zmniejszana do maksimum.
• Pozycja zamówienia brzmi „Kawa (700 g)” w panelu, na fakturze i w e-mailu potwierdzenia.

Sztuka na rzeczywistą wagę

Wybierz tryb Sztuka na rzeczywistą wagę dla produktów, których dokładna waga jest znana dopiero przy przygotowaniu: mięso, ser krojony, ryby.

• Średnia waga sztuki: to zawartość, na przykład 1,2 kg. Cena produktu to cena sztuki o tej wadze.
• Najlżejsza sztuka i Najcięższa sztuka: opcjonalne, pokazywane klientowi jako zakres. Zakres musi obejmować średnią wagę.

Na karcie produktu ramka „Sprzedawane na rzeczywistą wagę” wyjaśnia klientowi zasadę: lżejsza sztuka oznacza zwrot różnicy, cięższa nie kosztuje nic więcej. Pozycja zamówienia brzmi „Stek (około 1,2 kg)” lub „(2 × około 1,2 kg)”.

Ważenie zamówienia

Na stronie zamówienia panel Rzeczywiste wagi wymienia każdą pozycję z wagą szacowaną i zapłaconą kwotą.

1. Wpisz łączną rzeczywistą wagę każdej pozycji, wszystkie sztuki razem, w kg (w l dla objętości, w m dla długości).
2. Zwrot każdej pozycji i suma są liczone podczas wpisywania. Waga odbiegająca o ponad 50 % od szacunku wywołuje ostrzeżenie, często błąd jednostki (1200 zamiast 1,2).
3. Zaznacz lub odznacz e-mail do klienta i bon, kliknij Zatwierdź wagi i potwierdź.

Zwrot za lżejszą pozycję jest proporcjonalny: zapłacona kwota × (1 − waga rzeczywista / waga szacowana). Cięższa pozycja nie daje zwrotu i nigdy nie jest dopłacana.

Co zostaje utworzone

• Korekta PrestaShop na łączną różnicę, widoczna w dokumentach zamówienia. Jej PDF wymienia pozycje i tabelę „Korekta do rzeczywistej wagi”.
• Bon na tę samą kwotę, jeśli pole jest zaznaczone, tylko dla tego klienta i ważny rok.
• E-mail do klienta w jego języku z wagami szacowanymi, rzeczywistymi i kwotą zwrotu.

Faktura zamówienia zawiera informację o sprzedaży według szacowanej wagi i korekcie. Klient widzi też rzeczywiste wagi w szczegółach zamówienia na swoim koncie.

Zamówienia do zważenia

Strona konfiguracji wymienia zamówienia, które wciąż zawierają sztuki do zważenia, od najstarszych, z bezpośrednim linkiem do każdego zamówienia. Zamówienia anulowane, z błędem lub zwrócone nie są pokazywane.

Edytor masowy

Na górze strony konfiguracji edytor masowy pokazuje produkty po 50 na stronie, z filtrami według kategorii, nazwy, kodu lub ID, i domyślnie tylko te bez zawartości.

• Zawartości zapisane w nazwie lub kodzie są wykrywane i wpisywane, z oznaczeniem „Wykryto”. Opakowania są mnożone („6 x 33 cl” daje 198 cl), a wymiary typu „40×60 cm” pomijane.
• Zmiana wartości zaznacza wiersz. Cena jednostkowa liczona jest na bieżąco.
• Zaznacz wykryte wielkości zaznacza naraz wszystkie wypełnione wiersze strony.
• Uzupełnij też kombinacje, których nazwa zawiera wielkość: kombinacja „Waga – 500 g” otrzymuje 500 g, bez nadpisywania wpisanej już wartości.

Wyczyszczenie zawartości zaznaczonego wiersza usuwa zawartość produktu. Produkty sprzedawane na wagę lub na rzeczywistą wagę są w tabeli tylko do odczytu: edytuj je na ich karcie.

Import i eksport CSV

Blok Eksport CSV tworzy wiersz na produkt i na kombinację, dla całego katalogu lub kategorii. Kolumny: id_product, id_product_attribute, reference, name, net_quantity, unit, reference_unit.

Import przyjmuje separator ; lub ,. Kolumny net_quantity i unit są wymagane, razem z id_product lub reference (kod produktu lub kombinacji). Jednostki: g, kg, ml, cl, l, mm, cm, m, m2, m3, unit. reference_unit przyjmuje 1kg, 100g, 1l lub 100ml. Puste net_quantity usuwa wiersz. Błędy są wypisywane z numerem wiersza i nie blokują pozostałych.

Narzędzia i raport zgodności

Synchronizuj teraz przelicza natywne pola i minimalne ilości wszystkich skonfigurowanych produktów. Użyj po masowym imporcie cen lub gdy pracownicy bez dostępu do modułu edytują produkty: PrestaShop nie uruchamia hooków modułu dla profilu, który nie ma prawa go widzieć.

Raport zgodności pokazuje liczbę skonfigurowanych produktów i wymienia do 300 aktywnych produktów bez zawartości w kategoriach obowiązkowych, z linkiem do ich karty.

Rozwiązywanie problemów

Cena jednostkowa nie pojawia się na karcie produktu

Sprawdź, czy produkt ma zawartość i czy wyświetlanie na karcie jest włączone. Jeśli motyw nie wywołuje pozycji after_price, wybierz w ustawieniach price lub weight.

Cena jednostkowa pojawia się dwa razy

Włącz Ukryj natywną cenę jednostkową motywu. Jeśli duplikat pozostaje, motyw używa innej klasy CSS dla tego bloku: skontaktuj się z nami, podając nazwę motywu.

Pole ilości pozostaje widoczne przy produkcie na wagę

Motyw używa niestandardowego znacznika ilości. Wybrana waga jest i tak egzekwowana po stronie serwera (minimum i maksimum). Skontaktuj się z nami, podając nazwę motywu.

Natywna cena nie jest aktualna po imporcie cen

Kliknij Synchronizuj teraz.

Zgodność

• PrestaShop 8.0 do 9.x, ten sam ZIP obsługuje obie gałęzie.
• Wyświetlanie przez natywny hook displayProductPriceBlock, testowane z motywem Classic.
• Architektura ModuleAdminController, bez zależności Composer, PHP 7.2 i nowsze.
• Interfejs i e-maile po polsku, francusku, angielsku, hiszpańsku, niemiecku, włosku, niderlandzku i portugalsku.