KS SOR - Środki Ochrony Roślin

1. O ustawie

KS SOR to profesjonalny moduł dla PrestaShop 8.x i 9.x, który zapewnia zgodność sklepów internetowych z ustawą o środkach ochrony roślin (Dz.U.2024.630 z nowelizacją Dz.U.2025.1709).

Co wymaga ustawa?

• Weryfikacja zaświadczeń Każdy nabywca ŚOR dla profesjonalistów musi posiadać ważne zaświadczenie
• Ewidencja sprzedaży Obowiązek prowadzenia rejestru wszystkich transakcji przez 5 lat
• Zakaz wysyłki do paczkomatów ŚOR nie mogą być dostarczane do automatów paczkowych
• Raporty dla PIORiN Na żądanie inspekcji — eksport danych w wymaganym formacie

2. Funkcjonalności

Weryfikacja certyfikatów

• Formularz w procesie zamówienia Klient wprowadza dane certyfikatu podczas checkout
• Pełna walidacja Sprawdzenie numeru, wydawcy i daty ważności certyfikatu
• Automatyczne sprawdzanie wygaśnięcia Blokada zamówienia gdy certyfikat jest przeterminowany
• Zapis na koncie klienta Certyfikat zapisany — nie trzeba wpisywać przy każdym zamówieniu
• Nieusuwalna historia Pełna historia wszystkich zmian certyfikatów klienta

Blokady bezpieczeństwa

• Blokada zakupu bez certyfikatu Automatyczne zatrzymanie zamówienia przy braku ważnego certyfikatu
• Całkowita blokada fumigantów Wymóg prawny — fumiganty nie mogą być sprzedawane przez internet
• Blokada paczkomatów i punktów odbioru Ukrycie niedozwolonych metod dostawy dla produktów SOR
• Ostrzeżenia w koszyku Informacja o wymaganiach gdy koszyk zawiera produkty SOR

Zarządzanie produktami SOR

• Oznaczanie pojedynczych produktów Każdy produkt można oznaczyć jako środek ochrony roślin
• Oznaczanie całych kategorii Wszystkie produkty w kategorii automatycznie jako SOR
• Fumiganty (całkowity zakaz) Osobne oznaczenie produktów zabronionych do sprzedaży online
• Informacja na karcie produktu Widoczna informacja o wymaganiu certyfikatu

Panel administracyjny

Powiadomienia e-mail

• Alert o wygasającym certyfikacie Automatyczne powiadomienie gdy certyfikat wkrótce wygaśnie
• Konfigurowalna liczba dni Np. 30 dni przed wygaśnięciem — do ustawienia w konfiguracji
• Szablony po polsku Gotowe szablony e-mail w języku polskim

Zgodność prawna

Szczegóły techniczne

• Responsywne szablony Pełna obsługa desktop + mobile, zoptymalizowane formularze
• AJAX walidacja formularzy Błyskawiczna walidacja bez przeładowania strony
• Wielojęzyczność Polski w zestawie, łatwe dodawanie nowych tłumaczeń
• Pliki bezpieczeństwa Pliki index.php we wszystkich katalogach, zabezpieczenie przed listowaniem

Kompatybilność

3. Wymagania systemowe

4. Instalacja

# Przez SCP
scp -r ks_sor/ user@server:/var/www/prestashop/modules/

# Lub przez FTP - prześlij folder ks_sor do /modules/

5. Konfiguracja

Ustawienia podstawowe

Blokowane przewoźniki

Ustawa zabrania wysyłki ŚOR do automatów paczkowych. W konfiguracji wybierz przewoźników, którzy mają być zablokowani dla zamówień zawierających produkty SOR:

• InPost Paczkomaty
• DPD Pickup
• Allegro Automaty
• Orlen Paczka

6. Produkty SOR

Oznaczanie produktów

Istnieją dwa sposoby oznaczenia produktów jako ŚOR:

Metoda 1: Pojedynczy produkt

1. Edytuj produkt w panelu admina
2. Przejdź do zakładki "SOR"
3. Zaznacz "Produkt jest środkiem ochrony roślin"
4. Zapisz

Metoda 2: Cała kategoria

1. Przejdź do KamikStudio → KS SOR → Konfiguracja
2. W sekcji "Kategorie SOR" wybierz kategorie
3. Wszystkie produkty z wybranych kategorii będą traktowane jako ŚOR

Metoda 3: Cecha produktu

1. Utwórz cechę "Produkt SOR" (tak/nie)
2. W konfiguracji modułu wybierz ID tej cechy
3. Produkty z tą cechą będą automatycznie oznaczone

Fumiganty — całkowity zakaz

Oznaczanie fumigantów

1. Edytuj produkt w panelu admina
2. Przejdź do zakładki "SOR"
3. Zaznacz "Produkt jest środkiem ochrony roślin"
4. Dodatkowo zaznacz "Fumigant (zakaz sprzedaży online)"
5. Zapisz

Produkt oznaczony jako fumigant:

• Nie może być dodany do koszyka
• Wyświetla komunikat o zakazie sprzedaży online
• Może być widoczny na stronie (do celów informacyjnych) lub ukryty

Oznaczenie na karcie produktu

Produkty SOR wyświetlają specjalny komunikat informujący klienta o wymaganiach:

⚠️ Ten produkt jest środkiem ochrony roślin.
Zakup wymaga ważnego zaświadczenia o ukończeniu szkolenia
w zakresie stosowania środków ochrony roślin.

7. Klienci i zaświadczenia

Formularz zaświadczenia

Klient wprowadza dane zaświadczenia podczas checkout lub w panelu "Moje konto":

Weryfikacja przez admina

W panelu "Klienci SOR" administrator może:

• Przeglądać zaświadczenia klientów
• Ręcznie zweryfikować zaświadczenie
• Dodać notatki
• Zablokować klienta
• Przeglądać historię zmian certyfikatów

8. Proces zakupowy

Jak działa blokada?

Integracja z TheCheckout

Moduł automatycznie wykrywa TheCheckout i wyświetla formularz weryfikacji w odpowiednim miejscu. Nie wymaga dodatkowej konfiguracji.

9. Scenariusze UX

Moduł obsługuje różne scenariusze zakupowe, zapewniając intuicyjny proces dla klienta końcowego.

Flow zakupowy

Koszyk z SOR → Checkout (adres) → Metoda dostawy*
        ↓
★ WERYFIKACJA SOR (formularz/modal)
        ↓
   ┌────┴────┐
   ▼         ▼
Ma zaświad.  Brak zaświadczenia
   ↓              ↓
Walidacja    Usuń produkty SOR
   ↓              ↓
   └──────┬───────┘
          ▼
   Płatność → Potwierdzenie

* Blokada paczkomatów dla produktów SOR

Stany formularza weryfikacji

Komunikaty błędów

Blokady systemowe

Elementy UI

• Badge na karcie produktu Zielona etykieta "SOR" + info "Wymaga zaświadczenia o ukończeniu szkolenia"
• Alert w koszyku Żółte ostrzeżenie z informacją o wymaganych dokumentach
• Potwierdzenie zamówienia Sekcja z danymi zaświadczenia i listą produktów SOR

10. Ewidencja

Każde zamówienie zawierające produkty SOR jest automatycznie zapisywane w ewidencji:

11. Raporty PIORiN

Na żądanie Państwowej Inspekcji Ochrony Roślin i Nasiennictwa możesz wygenerować raport:

1. Przejdź do KamikStudio → KS SOR → Raporty PIORiN
2. Wybierz zakres dat
3. Kliknij "Generuj raport"
4. Pobierz plik CSV lub PDF

Format raportu

Raport zawiera wszystkie wymagane przez ustawę dane:

• Dane nabywcy
• Numer i data ważności zaświadczenia
• Nazwa i ilość produktów
• Data transakcji

12. Baza danych

Tabele modułu

ps_ks_sor_customers        # Klienci z zaświadczeniami
ps_ks_sor_certificate_history  # Historia zmian certyfikatów
ps_ks_sor_orders           # Ewidencja zamówień SOR
ps_ks_sor_products         # Produkty oznaczone jako SOR
ps_ks_sor_audit_log        # Log audytowy zmian

Szczegółowa struktura dostępna w pliku /sql/install.sql.

13. Hooki i API dla deweloperów

Hooki PrestaShop

Moduł wykorzystuje następujące hooki:

Własne hooki modułu

Moduł udostępnia własne hooki do integracji:

// Przed walidacją certyfikatu
Hook::exec('actionKsSorBeforeCertificateValidation', [
    'customer_id' => $customerId,
    'certificate_data' => $data
]);

// Po zapisie certyfikatu
Hook::exec('actionKsSorAfterCertificateSave', [
    'customer_id' => $customerId,
    'certificate' => $certificate
]);

// Przed blokadą zamówienia
Hook::exec('actionKsSorBeforeOrderBlock', [
    'cart' => $cart,
    'reason' => $blockReason
]);

Metody publiczne

// Sprawdź czy klient ma ważny certyfikat
$ksSor = Module::getInstanceByName('ks_sor');
$isValid = $ksSor->isCustomerCertificateValid($customerId);

// Pobierz dane certyfikatu klienta
$certificate = $ksSor->getCustomerCertificate($customerId);

// Sprawdź czy produkt jest SOR
$isSor = $ksSor->isProductSor($productId);

// Sprawdź czy koszyk zawiera produkty SOR
$hasSor = $ksSor->cartHasSorProducts($cartId);

// Pobierz listę zablokowanych przewoźników
$blocked = $ksSor->getBlockedCarriers();

Overridowanie szablonów

Szablony modułu można nadpisać w motywie:

themes/twoj_motyw/modules/ks_sor/views/templates/hook/
├── displayCustomerAccount.tpl      # Panel klienta
├── displayPaymentTop.tpl           # Formularz checkout
├── displayProductAdditionalInfo.tpl # Info na karcie produktu
└── displayShoppingCartFooter.tpl   # Alert w koszyku

14. Rozwiązywanie problemów

rm -f var/cache/prod/class_index.php
rm -f var/cache/dev/class_index.php

rm -rf var/cache/*
php bin/console cache:clear

15. FAQ

16. Licencja i ceny

17. Wsparcie