Przewodnik po modułach Shoplex

Shoplex organizuje unijne wymogi prawne dla e-commerce w 20 niezależnych modułach. Każdy moduł odpowiada za konkretną dyrektywę, rozporządzenie unijne lub przepis prawa krajowego. Moduły włącza się i wyłącza indywidualnie w panelu WooCommerce > Shoplex.

Dziesięć modułów jest aktywnych domyślnie. Dziesięć jest wyłączonych, ponieważ ich stosowanie zależy od asortymentu lub procesów operacyjnych sklepu.

┌────────────────────────────────────────────────────────────────────────┐
│                        Architektura modułów Shoplex                    │
├───────────────────────────────┬────────────────────────────────────────┤
│ Blok cenowy produktu          │ Kasa (Checkout) i zamówienia           │
│ • unit_price (98/6/WE)        │ • legal_checkboxes (2011/83/UE, RODO)  │
│ • omnibus (2019/2161)         │ • country_compliance (Button-Lösung)   │
│ • tax_display (98/6/WE)       │ • vies (2006/112/WE B2B VAT)           │
│ • shipping_notice (PAngV)     │ • withdrawal (14-dniowe odstąpienie)   │
│ • from_price (98/6/WE)        ├────────────────────────────────────────┤
├───────────────────────────────┤ Punkty końcowe i formularze prawne     │
│ Szczegóły produktu i GPSR     │ • complaint_template (wzór reklamacji) │
│ • delivery_time (2011/83/UE)  │ • cra_readiness (RFC 9116 security.txt)│
│ • consumer_information (771)  │ • dsa_toolkit (Art. 16 DSA zgłoszenia) │
│ • gpsr (2023/988 safety)      │ • business_info & dispute_resolution   │
└───────────────────────────────┴────────────────────────────────────────┘

---

Przegląd modułów

Identyfikator	Nazwa modułu	Stan domyślny	Podstawa prawna	Zakładka ustawień
unit_price	Cena jednostkowa	Włączony	Dyrektywa 98/6/WE	Ceny (shoplex_prices)
omnibus	Najniższa cena z 30 dni	Włączony	Dyrektywa (UE) 2019/2161	Najniższa cena (shoplex_omnibus)
tax_display	Informacja o VAT	Włączony	Dyrektywa 98/6/WE, 2011/83/UE art. 6	VAT (shoplex_taxes)
shipping_notice	Koszt wysyłki	Włączony	Dyrektywa 2011/83/UE art. 6 ust. 1 lit. e	Ceny (shoplex_prices)
from_price	Cena “od” na wariantach	Wyłączony	Dyrektywa 98/6/WE	Ceny (shoplex_prices)
delivery_time	Czas dostawy	Wyłączony	Dyrektywa 2011/83/UE art. 6 ust. 1 lit. g	Czas dostawy (shoplex_delivery)
consumer_information	Gwarancja zgodności i trwałość	Włączony	Dyrektywy (UE) 2019/771 i 2019/770	Gwarancje (shoplex_consumer_info)
country_compliance	Lokalne przepisy krajowe	Włączony	§ 312j BGB, Art. L. 221-14, RDL 7/2021	Zgodność krajowa (shoplex_country_compliance)
withdrawal	14-dniowe prawo do odstąpienia	Wyłączony	Dyrektywa 2011/83/UE Załącznik I(B)	Zgody w checkoucie (shoplex_checkout)
gpsr	Bezpieczeństwo produktów (GPSR)	Wyłączony	Rozporządzenie (UE) 2023/988	Bezpieczeństwo (shoplex_gpsr)
legal_checkboxes	Zgody w checkoucie	Włączony	Dyrektywa 2011/83/UE art. 8, RODO art. 7	Zgody w checkoucie (shoplex_checkout)
business_info	Dane sprzedawcy	Włączony	Dyrektywa 2000/31/WE art. 5	Sprzedawca (shoplex_general)
dispute_resolution	Informacja o rozwiązywaniu sporów	Włączony	Dyrektywa 2013/11/UE zmieniona dyrektywą (UE) 2025/2647	Sprzedawca (shoplex_general)
vies	Weryfikacja VAT UE (VIES)	Wyłączony	Dyrektywa 2006/112/WE art. 138	VIES VAT (shoplex_vies)
complaint_template	Wzór formularza reklamacji	Wyłączony	Dyrektywa (UE) 2019/771	Wbudowany ekran szablonu
cra_readiness	Cyber Resilience Act	Wyłączony	Rozporządzenie (UE) 2024/2847 / RFC 9116	CRA security.txt (shoplex_cra)
dsa_toolkit	Zgłaszanie treści DSA	Wyłączony	Rozporządzenie (UE) 2022/2065 art. 16	Shortcode formularza
deposit	Kaucje za opakowania (Pfand)	Wyłączony	VerpackG § 31; unijne PPWR	Kaucje (shoplex_deposit)
food_information	Informacje o żywności i wartości odżywcze	Wyłączony	Rozporządzenie (UE) 1169/2011	Żywność (shoplex_food)
consent_manager	Zgoda na cookies i blokowanie treści	Włączony	RODO art. 7; ePrivacy; TDDDG § 25	Zgoda (shoplex_consent)

---

1. Cena jednostkowa (unit_price)

Podstawa prawna

Dyrektywa 98/6/WE w sprawie ochrony konsumenta przez podawanie cen produktów oferowanych konsumentom. Sprzedaż towarów sypkich, płynnych lub na wagę wymaga jednoczesnego podania ceny sprzedaży i ceny za standardową jednostkę miary (np. za 1 kg lub 1 litr).

Działanie

Wylicza cenę bazową i wyświetla ją bezpośrednio obok ceny sprzedaży produktu na karcie produktu oraz w widokach kategorii. Jeżeli produkt nie ma zdefiniowanej wagi lub objętości, moduł nie renderuje żadnego pustego elementu.

Opcje konfiguracyjne (shoplex_prices)

• unit_price_enabled (bool, domyślnie: true): Włącza wyświetlanie ceny jednostkowej.
• unit_price_text (string, domyślnie: "{price} / {unit}"): Szablon tekstu. Zastępuje {price} przeliczoną kwotą, a {unit} przetłumaczoną jednostką miary.
• unit_price_show_loop (bool, domyślnie: true): Steruje wyświetlaniem ceny jednostkowej na listach produktów w sklepie.

Pola w edycji produktu

Dostępne w Dane produktu > Shoplex:

• _shoplex_unit_price_product_amount (float): Zawartość netto opakowania (np. 500 dla torebki 500 g kawy).
• _shoplex_unit_price_base (float, domyślnie: 1 lub 1000): Jednostka odniesienia (np. 1000 dla przeliczenia na 1 kg, lub 100 dla 100 ml).
• _shoplex_unit_price_unit (lista wyboru): Jednostka miary. Obsługiwane wartości: kg, g, l, ml, m, cm, m2, m3, piece (szt.).

Wzór obliczeniowy

$$\text{Cena jednostkowa} = \frac{\text{Cena produktu}}{\text{Ilość produktu}} \times \text{Wartość bazowa}$$

Przykład: słoik miodu 400 g w cenie 24,00 zł przeliczany do 1000 g: $$\frac{24,00\text{ zł}}{400} \times 1000 = 60,00\text{ zł/kg}$$

---

2. Najniższa cena z 30 dni (omnibus)

Podstawa prawna

Dyrektywa (UE) 2019/2161 (Dyrektywa Omnibus) zmieniająca art. 6a Dyrektywy 98/6/WE. W każdym przypadku ogłoszenia o obniżeniu ceny sprzedawca musi podać najniższą cenę, która obowiązywała w okresie nie krótszym niż 30 dni przed wprowadzeniem obniżki.

Działanie

Nasłuchuje zmian cen produktów i zapisuje każde zdarzenie do dedykowanej tabeli bazy danych. Gdy produkt trafia na promocję, wtyczka odczytuje najniższą historyczną cenę regularną z wyznaczonego okna czasowego i drukuje komunikat w bloku cenowym.

[!NOTE] Informacja o najniższej cenie nie działa wstecz. Rejestracja historii rozpoczyna się od momentu włączenia modułu w sklepie. Wcześniejsze zmiany sprzed instalacji wtyczki nie są znane.

Struktura bazy danych

Tabela: {wp_prefix}shoplex_price_history

CREATE TABLE wp_shoplex_price_history (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    product_id BIGINT UNSIGNED NOT NULL,
    price DECIMAL(19,4) NOT NULL,
    sale_price DECIMAL(19,4) DEFAULT NULL,
    price_type VARCHAR(20) NOT NULL DEFAULT 'regular',
    currency VARCHAR(3) NOT NULL,
    recorded_at DATETIME NOT NULL,
    INDEX product_recorded (product_id, recorded_at)
);

Opcje konfiguracyjne (shoplex_omnibus)

• enabled (bool, domyślnie: true): Aktywuje rejestrowanie cen i wyświetlanie komunikatu.
• days (int, domyślnie: 30): Długość sprawdzanego okna (minimum 30 dni według prawa UE).
• display_text (string, domyślnie: "Lowest price in the last {days} days: {price}"): Szablon powiadomienia. Obsługuje tagi {days} i {price}.
• display_on_sale_only (bool, domyślnie: true): Ogranicza komunikat wyłącznie do produktów w cenie promocyjnej.
• prune_after_days (int, domyślnie: 90): Czyści wpisy starsze niż $N$ dni w celu optymalizacji bazy.
• show_regular_price (bool, domyślnie: false): Pokazuje cenę regularną, gdy produkt nie jest przeceniony.
• no_history_text (wybór: hide | current | custom, domyślnie: hide): Zachowanie w przypadku braku pełnej 30-dniowej historii (np. nowy produkt na promocji).
• no_history_custom_text (string): Treść komunikatu, gdy wybrano opcję custom.
• price_count_from (wybór: sale_start | today, domyślnie: sale_start):
  • sale_start: Liczy 30 dni wstecz od momentu rozpoczęcia danej promocji (zapobiega manipulacjom przy promocjach kroczących).
  • today: Liczy ruchome okno 30 dni wstecz od bieżącego dnia.
• include_tax (bool, domyślnie: true): Czy historyczna cena uwzględnia podatek VAT zgodnie z ustawieniami sklepu.

---

3. Informacja o VAT (tax_display)

Podstawa prawna

Dyrektywa 98/6/WE, Dyrektywa 2011/83/UE art. 6 oraz Dyrektywa 2006/112/WE art. 284 (Zwolnienie podmiotowe dla małych przedsiębiorstw / art. 113 ustawy o VAT). Ceny prezentowane konsumentom muszą jednoznacznie wskazywać, czy zawierają należny podatek od towarów i usług.

Działanie

Dołącza informację o podatku VAT bezpośrednio obok ceny sprzedaży w oparciu o stawkę przypisaną do produktu w WooCommerce.

Opcje konfiguracyjne (shoplex_taxes oraz shoplex_prices)

• tax_display_mode (wybór: gross | net, domyślnie: gross): Prezentacja cen brutto lub netto.
• vat_notice_text (string, domyślnie: "zawiera {rate}% VAT"): Tekst dla cen brutto. Zmienna {rate} jest automatycznie uzupełniana stawką podatku.
• vat_notice_net_text (string, domyślnie: "nie zawiera {rate}% VAT"): Tekst dla cen netto.
• vat_exempt_notice (string, domyślnie: "Zwolniony z VAT na podstawie procedury dla małych przedsiębiorstw"): Wyświetlany, gdy w zakładce Sprzedawca zaznaczono opcję small_business (np. art. 113 ust. 1 ustawy o VAT).

---

4. Koszt wysyłki (shipping_notice)

Podstawa prawna

Dyrektywa 2011/83/UE art. 6 ust. 1 lit. e oraz niemiecki § 6 PAngV. W przypadku gdy koszty dostawy nie mogą zostać obliczone z góry lub są doliczane osobno, informacja o doliczanej opłacie musi znajdować się bezpośrednio przy cenie.

Działanie

Dołącza dopisek “plus wysyłka” do ceny produktu i linkuje go do strony z tabelą kosztów dostawy.

Opcje konfiguracyjne (shoplex_prices)

• shipping_costs_notice_enabled (bool, domyślnie: true): Włącza wyświetlanie dopisku.
• shipping_costs_text (string, domyślnie: "plus wysyłka"): Treść dopisku.

---

5. Cena “od” na wariantach (from_price)

Podstawa prawna

Dyrektywa 98/6/WE. Zasada przejrzystości cen nakazuje jasne wskazywanie rzeczywistej ceny bazowej, eliminując mylące widełki cenowe.

Działanie

Zastępuje domyślny format widełek WooCommerce (np. 50,00 zł - 120,00 zł) czytelnym wskazaniem najniższej dostępnej ceny (np. od 50,00 zł).

Opcje konfiguracyjne (shoplex_prices)

• from_price_enabled (bool, domyślnie: false): Włącza format ceny początkowej.
• from_price_text (string, domyślnie: "od {price}"): Szablon tekstu.

---

6. Czas dostawy (delivery_time)

Podstawa prawna

Dyrektywa 2011/83/UE art. 6 ust. 1 lit. g. Przed zawarciem umowy sprzedawca musi podać termin i sposób spełnienia świadczenia przez przedsiębiorcę.

Działanie

Wyświetla przewidywany czas dostawy na karcie produktu i opcjonalnie na listach produktów, korzystając z taksonomii shoplex_delivery_time.

Kolejność sprawdzania

1. Nadpisanie w produkcie: Pole _shoplex_delivery_time_id na karcie produktu w zakładce Shoplex.
2. Przypisanie taksonomii: Termin przypisany do produktu z taksonomii shoplex_delivery_time.
3. Domyślna wartość sklepu: Wartość ustawiona w shoplex_delivery.default_delivery_time.

Opcje konfiguracyjne (shoplex_delivery)

• default_delivery_time (ID terminu, domyślnie: 0): Domyślny czas dostawy dla produktów bez własnych ustawień.
• display_format (string, domyślnie: "Czas dostawy: {time}"): Szablon wyświetlania.
• show_in_loop (bool, domyślnie: false): Pokazuje czas dostawy także na listach produktów.

---

7. Gwarancja zgodności i trwałość (consumer_information)

Podstawa prawna

Dyrektywa (UE) 2019/771 (Dyrektywa towarowa), Dyrektywa (UE) 2019/770 (Dyrektywa cyfrowa) oraz Dyrektywa (UE) 2024/825 (Wzmocnienie pozycji konsumentów w procesie transformacji ekologicznej).

Działanie

Wyświetla przypomnienie o ustawowej gwarancji zgodności towaru z umową (w Polsce minimum 2 lata rękojmi konsumenckiej na podstawie ustawy o prawach konsumenta), a także informacje o komercyjnej gwarancji trwałości, okresie bezpłatnych aktualizacji oprogramowania oraz dostępności części zamiennych i naprawy.

Opcje konfiguracyjne (shoplex_consumer_info)

• show_legal_guarantee (bool, domyślnie: true): Włącza informację o ustawowej zgodności.
• legal_guarantee_text (textarea, domyślnie: "Wszystkie towary objęte są ustawową gwarancją zgodności sprzedawcy przez minimum dwa lata od momentu dostarczenia.").

[!NOTE] Gdy Shoplex wykryje klienta z Hiszpanii, automatycznie zmienia treść tej informacji na 3-letni okres ochrony zgodnie z hiszpańskim dekretem RDL 7/2021.

Pola w produkcie

• _shoplex_durability_guarantee_months (int): Okres komercyjnej gwarancji trwałości producenta (w miesiącach).
• _shoplex_update_period_months (int): Okres dostarczania bezpłatnych aktualizacji oprogramowania dla towarów z elementami cyfrowymi.
• _shoplex_repair_info (textarea): Informacje o naprawie i dostępności części zamiennych.

---

8. Lokalne przepisy krajowe (country_compliance)

Podstawa prawna

Niemiecki § 312j BGB, francuski Art. L. 221-14, włoski Art. 51 Codice del Consumo, hiszpański RDL 7/2021, polski Art. 17 Ustawy o prawach konsumenta, niemiecki VerpackG, francuski AGEC i polski rejestr BDO.

Działanie

Dostosowuje treść przycisku złożenia zamówienia na checkoucie klasycznym i blokowym do kraju kupującego (tzw. reguła Button-Lösung), wydłuża okres gwarancji dla Hiszpanii oraz dodaje numery rejestrów środowiskowych do stopki i danych sprzedawcy.

Szczegółowe omówienie przepisów poszczególnych państw znajduje się w Przewodniku zgodności krajowej.

Opcje konfiguracyjne (shoplex_country_compliance)

• lucid_number (string): Numer w niemieckim rejestrze opakowań LUCID (ZSVR).
• epr_number (string): Francuski unikalny numer identyfikacyjny REP/EPR (ADEME IDU).
• bdo_number (string): Polski numer rejestrowy BDO.
• order_button_text_pl (string, domyślnie: "Zamówienie z obowiązkiem zapłaty").
• order_button_text_de (string, domyślnie: "Zahlungspflichtig bestellen").
• order_button_text_fr (string, domyślnie: "Commande avec obligation de paiement").
• order_button_text_it (string, domyślnie: "Ordina e paga").
• order_button_text_es (string, domyślnie: "Pedido con obligation de pago").

---

9. 14-dniowe prawo do odstąpienia (withdrawal)

Podstawa prawna

Dyrektywa 2011/83/UE Załącznik I(B), Dyrektywa (UE) 2023/2673 oraz art. 27 i nast. Ustawy o prawach konsumenta. Konsument ma prawo odstąpić od umowy zawartej na odległość w terminie 14 dni bez podawania przyczyny.

Działanie

Moduł realizuje kompletny cyfrowy proces obsługi zwrotów:

1. Publiczny shortcode [shoplex_withdrawal_form] do osadzenia formularza odstąpienia na dowolnej podstronie.
2. Integracja z Moim Kontem: dodaje przycisk “Odstąp od umowy” w Moje konto > Zamówienia dla zamówień spełniających kryteria terminu.
3. Weryfikacja zamówień gości: formularz wyszukiwania na podstawie numeru zamówienia i adresu e-mail płatnika.
4. Bezpieczny magic-link: wysyła jednorazowy link weryfikacyjny z 30-minutowym czasem ważności (TOKEN_TTL_SECONDS = 1800).
5. Zabezpieczenia: maskowanie obecności zamówienia (ochrona przed enumeracją) oraz limit żądań (maksymalnie 5 prób na 15 minut).
6. Częściowe odstąpienie: śledzenie pozostałych ilości w poszczególnych pozycjach zamówienia.
7. Kompatybilność z HPOS: start biegu terminu 14 dni zapisywany w _shoplex_withdrawal_clock_start po zmianie statusu zamówienia na completed.
8. E-maile potwierdzające: natychmiastowa wysyłka potwierdzenia przyjęcia oświadczenia do konsumenta i administratora.

Użycie shortcode’a

[shoplex_withdrawal_form]

---

10. Bezpieczeństwo produktów - GPSR (gpsr)

Podstawa prawna

Rozporządzenie (UE) 2023/988 w sprawie ogólnego bezpieczeństwa produktów (GPSR). Obowiązuje od 13 grudnia 2024 r. Każdy produkt niespożywczy oferowany online w UE musi zawierać dane producenta, osoby odpowiedzialnej w UE (w przypadku producentów spoza UE), identyfikatory produktu oraz ostrzeżenia bezpieczeństwa.

Działanie

Generuje sekcję informacji o bezpieczeństwie produktu na pojedynczej stronie produktu. W przypadku braku danych dla danego produktu sekcja nie jest renderowana.

Opcje konfiguracyjne (shoplex_gpsr)

• show_on_product (bool, domyślnie: true): Włącza prezentację sekcji bezpieczeństwa.

Pola w produkcie

Dostępne w Dane produktu > Shoplex:

• _shoplex_gpsr_manufacturer_name (string): Nazwa producenta.
• _shoplex_gpsr_manufacturer_address (textarea): Adres pocztowy producenta.
• _shoplex_gpsr_manufacturer_contact (string): Kontakt elektroniczny (e-mail lub formularz www).
• _shoplex_gpsr_responsible_person (string): Nazwa unijnej osoby odpowiedzialnej (wymagane, gdy producent pochodzi spoza UE).
• _shoplex_gpsr_responsible_address (textarea): Adres pocztowy osoby odpowiedzialnej w UE.
• _shoplex_gpsr_responsible_contact (string): Kontakt elektroniczny do osoby odpowiedzialnej.
• _shoplex_gpsr_importer_name (string): Nazwa importera.
• _shoplex_gpsr_importer_address (textarea): Adres importera.
• _shoplex_gpsr_importer_contact (string): Kontakt elektroniczny importera.
• _shoplex_gpsr_product_identifier (string): Numer partii, serii, modelu lub kod kreskowy.
• _shoplex_gpsr_safety_warnings (textarea): Ostrzeżenia i informacje o zagrożeniach.
• _shoplex_gpsr_instructions (textarea): Instrukcje bezpiecznego montażu i użytkowania.

---

11. Zgody w checkoucie (legal_checkboxes)

Podstawa prawna

Dyrektywa 2011/83/UE art. 8, RODO (Rozporządzenie UE 2016/679) art. 7 oraz Dyrektywa 2011/83/UE art. 16 lit. m (utrata prawa do odstąpienia przy natychmiastowym dostarczaniu treści cyfrowych).

Działanie

Wyświetla checkboxy prawne w procesie kasy i utrwala stan oświadczeń kupującego w metadanych zamówienia oraz notatkach do zamówienia. Działa na checkoucie klasycznym oraz blokowym (WooCommerce Additional Fields API).

Typy checkboxów

1. Regulamin sklepu: Wymagana akceptacja warunków sprzedaży.
2. Polityka prywatności: Wymagane potwierdzenie zapoznania się z przetwarzaniem danych.
3. Pouczenie o odstąpieniu: Potwierdzenie zapoznania się z zasadami zwrotów.
4. Zrzeczenie przy treściach cyfrowych: Zgoda na rozpoczęcie świadczenia przed upływem terminu 14 dni i utratę prawa do odstąpienia.
5. Newsletter / Marketing: Dobrowolna zgoda na komunikację marketingową.
6. Udostępnienie danych kurierowi: Zgoda na przekazanie numeru telefonu i e-maila do powiadomień doręczenia.
7. Prośba o opinię: Dobrowolna zgoda na kontakt w celu wystawienia opinii po zakupie.

Zapis audytowy

Dane zgód zapisywane są w metadanych zamówienia _shoplex_consents:

{
  "terms": { "agreed": true, "timestamp": 1775577600 },
  "privacy": { "agreed": true, "timestamp": 1775577600 },
  "digital_waiver": { "agreed": true, "timestamp": 1775577600 }
}

---

12. Dane sprzedawcy (business_info)

Podstawa prawna

Dyrektywa 2000/31/WE art. 5 (o handlu elektronicznym) oraz art. 12 Ustawy o prawach konsumenta. Przedsiębiorca musi zapewnić łatwy, bezpośredni i stały dostęp do swoich podstawowych danych identyfikacyjnych.

Opcje konfiguracyjne (shoplex_general)

• company_name (string): Pełna nazwa firmy lub imię i nazwisko przedsiębiorcy.
• company_address (textarea): Siedziba i adres prowadzenia działalności.
• company_email (string): Adres poczty elektronicznej.
• company_phone (string): Numer telefonu.
• company_vat_id (string): NIP / VAT ID (np. PL1234567890).
• company_registration_number (string): Oznaczenie rejestru (KRS, CEIDG, HRB).
• small_business (bool, domyślnie: false): Oznaczenie zwolnienia podmiotowego z VAT.

---

13. Rozstrzyganie sporów (dispute_resolution)

Podstawa prawna

Unijna platforma internetowego rozstrzygania sporów została zamknięta. Rozporządzenie (UE) 524/2013 uchylono ze skutkiem od 20 lipca 2025 r. rozporządzeniem 2024/3228. Dyrektywa 2013/11/UE, zmieniona dyrektywą (UE) 2025/2647, określa unijne ramy pozasądowego rozwiązywania sporów. Moduł udostępnia tylko edytowalną informację. Dostosuj jej treść do przepisów krajowych właściwych dla sklepu i dodaj link do odpowiedniej jednostki ADR, jeśli jest wymagany.

Opcje konfiguracyjne (shoplex_general)

• dispute_resolution_enabled (bool, domyślnie: true): Włącza informację o pozasądowym rozwiązywaniu sporów.
• dispute_resolution_text (textarea): Treść pouczenia z informacją o kontakcie z obsługą klienta oraz możliwości skorzystania z podmiotów ADR.

---

14. Weryfikacja VAT UE w VIES (vies)

Podstawa prawna

Dyrektywa 2006/112/WE art. 138 (Zastosowanie stawki 0% przy wewnątrzwspólnotowej dostawie towarów - WDT).

Działanie

Weryfikuje unijne numery NIP (VAT ID) kontrahentów B2B w czasie rzeczywistym za pośrednictwem oficjalnego API Komisji Europejskiej: https://ec.europa.eu/taxation_customs/vies/rest-api/ms/{CC}/vat/{NUMBER}

• Bada poprawność formatu i składni (regex) dla wszystkich 27 państw członkowskich oraz Irlandii Północnej (XI).
• Kwalifikowany dowód zapytania: po podaniu własnego numeru NIP w ustawieniach (requester_vat), system VIES zwraca unikalny numer zapytania (requestIdentifier), stanowiący dowód należytej staranności dla organów podatkowych.
• Wyświetla panel weryfikacji w edycji zamówienia WooCommerce z nazwą firmy, adresem i statusem.

Opcje konfiguracyjne (shoplex_vies)

• requester_vat (string): Własny numer VAT UE sprzedawcy potrzebny do generowania numeru zapytania.
• cache_hours (int, domyślnie: 24): Czas buforowania weryfikacji.

---

15. Wzór formularza reklamacji (complaint_template)

Podstawa prawna

Dyrektywa (UE) 2019/771 oraz art. 43a i nast. Ustawy o prawach konsumenta. Procedury dochodzenia roszczeń konsumenckich z tytułu braku zgodności towaru z umową: naprawa, wymiana, obniżenie ceny, odstąpienie od umowy.

Działanie

Generuje czytelny, zgodny z prawem szablon formularza reklamacji konsumenckiej zawierający dane sprzedawcy oraz pola na opis wady i żądania konsumenta.

Użycie shortcode’a

[shoplex_complaint_template]

Pobieranie szablonu HTML

Administrator może pobrać gotowy plik HTML do wydruku z panelu WooCommerce > Shoplex > Wzór reklamacji klikając Pobierz jako samodzielny plik HTML.

---

16. Cyber Resilience Act (cra_readiness)

Podstawa prawna

Rozporządzenie (UE) 2024/2847 (Cyber Resilience Act - CRA) oraz RFC 9116 (Format pliku ułatwiający zgłaszanie podatności bezpieczeństwa).

Działanie

Automatycznie udostępnia plik security.txt pod adresem: /.well-known/security.txt

Żądanie jest przechwytywane na haku parse_request i zwraca nagłówki oraz treść w formacie text/plain.

Opcje konfiguracyjne (shoplex_cra)

• security_contact (string e-mail): Dedykowany adres do zgłaszania incydentów i luk bezpieczeństwa.
• security_policy_url (string URL): Opcjonalny adres strony z polityką disclosure.

Przykład generowanego pliku

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8

Contact: mailto:[email protected]
Policy: https://twojadomena.pl/polityka-bezpieczenstwa/
Preferred-Languages: pl, en, de
Expires: 2027-10-07T12:00:00Z

---

17. Zgłaszanie nielegalnych treści DSA (dsa_toolkit)

Podstawa prawna

Rozporządzenie (UE) 2022/2065 (Akt o usługach cyfrowych - DSA), w szczególności art. 16 (Mechanizmy powiadamiania i działania dotyczące nielegalnych treści i produktów) oraz art. 11-12 (Punkty kontaktowe).

Działanie

Udostępnia publiczny formularz zgłoszeniowy dla użytkowników i organów państwowych umożliwiający zgłoszenie nielegalnych produktów lub naruszeń prawa.

Użycie shortcode’a

[shoplex_dsa_report]

Pola formularza

• Imię i nazwisko / Nazwa organizacji zgłaszającego
• Adres poczty elektronicznej
• Dokładny adres URL produktu lub treści
• Powód zgłoszenia:
  • illegal_product (Nielegalny / niezgodny z przepisami produkt)
  • ip_infringement (Naruszenie własności intelektualnej / znaku towarowego)
  • misleading_ad (Wprowadzająca w błąd reklama / nieuczciwa praktyka)
  • other (Inne naruszenie prawa)
• Szczegółowe wyjaśnienie podstawy prawnej i okoliczności

---

18. Kaucje za opakowania (deposit)

Moduł dodaje do koszyka konfigurowalną, nieopodatkowaną opłatę kaucyjną i wyświetla informację o kaucji na karcie produktu. Jest domyślnie wyłączony. Pola produktu _shoplex_deposit_type i _shoplex_deposit_units określają rodzaj kaucji i liczbę opakowań. Warianty mogą dziedziczyć te wartości po produkcie nadrzędnym.

Domyślne stawki to 0,25 EUR dla opakowań jednorazowych, 0,08 EUR dla zwrotnych butelek po piwie, 0,15 EUR dla zwrotnych butelek po wodzie mineralnej i 0,25 EUR dla puszek. Stawki można zmienić w ustawieniach shoplex_deposit. Moduł nalicza opłatę i wyświetla informację, ale nie rejestruje fizycznych zwrotów ani nie wypłaca kaucji.

---

19. Informacje o żywności (food_information)

Wyświetla dane produktu wprowadzone w Dane produktu > Shoplex: skład, alergeny, wartości odżywcze, Nutri-Score, zawartość alkoholu, ilość netto, kraj pochodzenia i dane podmiotu działającego na rynku spożywczym. Moduł jest domyślnie wyłączony i dotyczy informacji o żywności określonych w rozporządzeniu (UE) 1169/2011.

Wartości odżywcze podaje się jako elementy klucz:wartość rozdzielone pionową kreską, na przykład energy_kcal:250|fat:12|salt:0.9. Obsługiwane klucze to między innymi energy_kj, energy_kcal, fat, saturated_fat, carbohydrates, sugars, fibre, protein i salt. Wyświetlane są tylko uzupełnione informacje.

---

20. Zgoda na cookies i blokowanie treści (consent_manager)

Wyświetla baner zgody z kategoriami: Niezbędne, Analityczne, Marketingowe i Preferencje. Integruje Google Consent Mode v2 i może wstrzymać osadzone treści z YouTube, Vimeo, Google Maps, OpenStreetMap i SoundCloud do czasu uzyskania zgody. Użytkownik może ponownie otworzyć ustawienia zgody. Moduł jest domyślnie włączony, a jego ustawienia znajdują się w shoplex_consent.

Blokowanie obejmuje obsługiwane osadzone multimedia w treści i krótkich opisach. Moduł nie blokuje dowolnych skryptów zewnętrznych.