Instrukcja modułu subskrypcji w Odoo 18

📋 Opis modułu

Moduł Subscription Extensions umożliwia sprzedaż produktów w modelu subskrypcyjnym w Odoo 18 Community Edition. Rozszerzenie działa samodzielnie i nie posiada zależności od modułów Enterprise.

Główne funkcje:

• 📅 Cykle rozliczeniowe: Obsługa cykli Miesięcznych oraz Rocznych.
• 💰 Dynamiczne ceny: Zmiana ceny na stronie produktu w czasie rzeczywistym.
• 🎁 Rabaty roczne: Możliwość ustawienia rabatów procentowych, darmowych miesięcy lub stałej ceny.
• ⚡ Auto-fakturowanie: Wbudowany CRON generujący faktury cykliczne.

⚙️ Instalacja

1. Rozpakuj archiwum subscription_extensions.zip.
2. Skopiuj folder subscription_extensions do katalogu addons Odoo:
   • /mnt/extra-addons/ lub
   • /opt/odoo/addons/
3. Zrestartuj serwer Odoo.
4. Przejdź do Aplikacje → Aktualizuj listę aplikacji.
5. Wyszukaj "Subscription Extensions" i kliknij Instaluj.

⚠️ Wymagane moduły: sale_management, website_sale, account

🛍️ Konfiguracja

1. Konfiguracja produktu subskrypcyjnego

Aby uruchomić subskrypcję dla danego produktu:

1. Przejdź do Sprzedaż → Produkty → Produkty.
2. Otwórz produkt lub utwórz nowy.
3. Przejdź do zakładki "Subskrypcja".

2. Konfiguracja rabatów rocznych (🎁)

W zakładce "Subskrypcja" możesz skonfigurować zachęty dla klientów wybierających płatność roczną.

Dostępne typy rabatów:

Przykłady obliczeń:

Przykład 1: Rabat 15%

• Cena miesięczna: 49 zł
• Wynik: 49 × 12 × 0.85 = 499.80 zł/rok (zamiast 588 zł)

Przykład 2: 2 miesiące gratis

• Cena miesięczna: 99 zł
• Wynik: 99 × 10 = 990 zł/rok (zamiast 1188 zł)

Przykład 3: Okrągła cena roczna

• Cena miesięczna: 29 zł
• Ustawiona stała cena: 299 zł
• Wynik: 299 zł/rok (zamiast 348 zł, oszczędność ~14%)

🌐 Widok klienta (eCommerce)

Po włączeniu subskrypcji, klient na stronie produktu zobaczy:

• Selektor okresu: Estetyczne karty wyboru (Miesięczna / Roczna).
• Dynamiczna cena: Cena aktualizuje się natychmiast po zmianie wyboru (bez przeładowania strony).
• Badge z rabatem: Przy opcji rocznej wyświetla się informacja o zniżce.
• Info o oszczędności: Kalkulacja ile klient zaoszczędzi wybierając plan roczny.

📊 Zarządzanie subskrypcjami

Widok zamówienia sprzedaży

Po potwierdzeniu zamówienia, w zakładce "Subskrypcja" na zamówieniu sprzedaży pojawią się szczegóły:

• Cykl subskrypcji: Miesięczny lub Roczny.
• Data następnej faktury: Termin wygenerowania kolejnej faktury.
• Subskrypcja aktywna: Status logiczny subskrypcji.

✅ Tip: Filtruj zamówienia po polu "Subskrypcja aktywna = Tak", aby wylistować wszystkich aktywnych subskrybentów.

⏰ Automatyczne fakturowanie (CRON)

Moduł instaluje zaplanowane działanie (Scheduled Action), które uruchamia się codziennie.

Działanie skryptu:

1. Sprawdza wszystkie aktywne subskrypcje.
2. Generuje fakturę, jeśli nadeszła data następnej faktury.
3. Przesuwa datę następnej faktury o odpowiedni okres (miesiąc/rok).

Konfiguracja CRON:

• Ścieżka: Ustawienia → Techniczne → Automatyzacja → Zaplanowane działania
• Nazwa: Subskrypcje: Generuj faktury
• Domyślny interwał: 1 dzień

🔧 Rozwiązywanie problemów

Cena nie zmienia się dynamicznie na stronie

• Wyczyść cache przeglądarki (Ctrl+Shift+R).
• Sprawdź konsolę przeglądarki (F12) pod kątem błędów JavaScript.
• Upewnij się, że produkt ma zaznaczoną opcję "Dostępna jako subskrypcja".

Rabat nie wyświetla się

• Sprawdź, czy typ rabatu jest inny niż "Brak rabatu".
• Upewnij się, że wartość rabatu jest większa od 0.

Faktury nie są generowane automatycznie

• Sprawdź, czy zadanie CRON jest aktywne (Settings -> Technical -> Automation).
• Upewnij się, że zamówienie źródłowe ma status "Potwierdzone" (Sale Order).
• Zweryfikuj, czy na zamówieniu pole "Subskrypcja aktywna" jest zaznaczone.