# Több előfizetés egy vásárlásban

> Hogyan csoportosítja a bővítmény az egy tranzakcióban vásárolt előfizetéses termékeket: a döntések háttere és a műszaki megvalósítás.

A vásárló egyetlen tranzakcióban több, különböző előfizetéses terméket is megvehet. Ez a fejezet azt írja le, hogyan működik ez az áruházkezelő és a fejlesztő szemszögéből.

## Miért így készült

Az áruházkezelők három okból kérték, hogy egy vásárlásban több előfizetéses termék is szerepelhessen:

- a vásárlónak ne kelljen minden előfizetéshez újra végigmennie a pénztáron;
- kevesebb legyen a fizetési átjáró díja, mert a feliratkozás és a megújítás egy tranzakcióban fut le (a legtöbb átjáró tranzakciónként fix díjat számol);
- összevonva jöjjenek a megújítások, így kevesebb megújítási rendelést kell feldolgozni, és egy szállítmányhoz nem kell több rendelést kezelni.

A tervezés kihívásai ezek voltak:

- a szállítási költség számítása, amely lehet rendelésenként, tételenként, szállítási osztályonként vagy ezek bármilyen keveréke;
- a vásárlónak minden vállalt fizetésről (az ismétlődő adót és szállítást is beleértve) tájékoztatást kell kapnia úgy, hogy a pénztár ne legyen átláthatatlan;
- az áruházkezelőnek ne jelentsen túl sok terhet az előfizetések és megújítási rendelések kezelése.

## A választott megoldás: csoportosítás számlázási ütemezés szerint

Az azonos számlázási ütemezésű előfizetéses termékek egyetlen előfizetésbe kerülnek. Ha a vásárló például 2 havi és 3 éves előfizetéses terméket vesz egy tranzakcióban, két előfizetés jön létre: egy a havi termékek tételeivel, egy az éves termékek tételeivel. Így a szállítás már a feliratkozáskor pontosan kiszámolható és megjeleníthető, a megújítások összevonódnak, és csökken az átjárók díja.

A bővítmény a lehető legkevesebb előfizetést hozza létre. Ehhez a termékeket ezek alapján csoportosítja:

- **számlázási időköz és időszak**, hogy minden termék ütemezése érvényesüljön;
- **az előfizetés hossza**, hogy a záródátum minden termékre helyes legyen;
- **az első megújítás dátuma**, hogy a próbaidős és a [számlázási naphoz igazított](https://hub.hellowp.io/hu/plugins/woocommerce-subscriptions/webaruhaz-kezeles-szamlazasi-nap-igazitas/) termékek is helyesen csoportosuljanak.

Ugyanabba az előfizetésbe kerülnek például:

- 10 Ft kéthavonta;
- 25 Ft kéthavonta 2 hónap ingyenes próbaidővel (mert a próbaidő utáni első megújítás ugyanarra a napra esik, mint próbaidő nélkül);
- 30 Ft kéthavonta, a mai napra igazítva.

Külön előfizetésbe kerülnek például:

- 10 Ft havonta;
- 10 Ft havonta 12 hónapon át;
- 10 Ft havonta, a holnapi napra igazítva;
- 10 Ft havonta 2 hét ingyenes próbaidővel.

Az előfizetéses termék útja: termék, kosár, pénztár, rendelés, előfizetés. A kosárnak ezért többféle előfizetéses terméket kell tudnia kezelni, és a termékek már a kosárban is számlázási ütemezés szerint csoportosulnak. Így az ismétlődő összesítés a csoportok szerint jeleníthető meg, kevesebb sorral.

### Az „Ismétlődő összesen” rész

A kosárban és a pénztárban a szokásos összesítés alatt külön **Ismétlődő összesen** rész jelenik meg. Minden csoportnak (azonos számlázási ütemezésű termékeknek) ebben saját sorai vannak:

- részösszeg,
- szállítás,
- adók,
- kedvezmények,
- végösszeg.

A rendelés után az azonos ütemezésű termékek egyetlen előfizetésen belül külön tételként szerepelnek. Ha például egy rendelésen 4 előfizetéses termék van (4 tétel), két előfizetés jön létre, mindkettőn 2 tétellel.

## Az új megoldás mellékhatásai és kezelésük

- A vásárló egyetlen tétel előfizetését korábban nem tudta lemondani. Ezt az előfizetés megtekintése oldalon megjelenő tétel eltávolítása gomb oldja meg: a vásárló egyes tételeket külön eltávolíthat.
- A csere (váltás) eredetileg előfizetésenként működött, ami több tételes előfizetésnél nem jó. Ezért a csere tételenként történik.
- A külön vásárolt előfizetéses termékek nem csoportosulnak, ami többlet-megújítási rendeléseket és átjárói díjat jelent. Erre való a beépített **Hozzáadás az előfizetéshez** beállítás: a vásárló a termékoldalról vagy a kosárból hozzáadhatja a terméket egy meglévő előfizetéshez ahelyett, hogy újat hozna létre, és közben látja és elfogadja az előfizetés szállítási költségét.

## Elvetett megoldások

Egy korábbi elképzelés minden előfizetéses termékhez külön előfizetést hozott volna létre (5 termék, 5 előfizetés). Ez hasonlított volna a régi felépítésre, de nem használta ki az új architektúra rugalmasságát. A megújítások összevonásához kötegelt feldolgozás kellett volna, és ez megoldhatatlan hibát okozna: mivel egyes szállítási módok rendelésenként számolnak, a megújításkor a szállítási díj eltérhetett volna a feliratkozáskor elfogadottól, ha a vásárló közben új előfizetést vett vagy lemondott egyet. Ezért ezt a megoldást elvetették.

Az ismétlődő összegek megjelenítésére négy lehetőséget vizsgáltak:

1. az összegek nem jelennek meg;
2. az ismétlődő összegek a rendelés összesítésén belül jelennek meg;
3. új, külön **Ismétlődő összesen** rész az összesítés alatt (ez lett a választott megoldás);
4. minden előfizetéshez teljes rendelési táblázat a vásárlás gomb alatt.

Az elsőt sok országban jogszabály tiltja. A második túlzsúfolná az összesítést, a negyedik sok ismétlődő adatot mutatna. A harmadik a legtömörebb, és minden ismétlődő összeget pontosan megjelenít.

## Fejlesztői megvalósítás

Az előfizetéses termékek egy tranzakcióban történő vásárlásához a kosár (`WC_Cart`) az egyes előfizetések ismétlődő összegeit `WC_Cart` objektumok tömbjében tárolja, az új `WC_Cart::$recurring_carts` tulajdonságban. Ebben minden különböző számlázási ütemezéshez külön `WC_Cart` példány tartozik. Ha a kosárban például 2 évente megújuló és 3 havonta megújuló termék van, a tömbben két `WC_Cart` objektum lesz: egy az éves, egy a havi termékek tételeivel és összegeivel.

### Az ismétlődő kosár kulcsa

A csoportosítás úgy megy, hogy minden előfizetéses termékhez kulcs készül, amely ezeken alapul:

- **az első fizetés dátuma**: ebbe beleszámít a próbaidő, a szinkronizált megújítási dátum és az előfizetéscsere miatti időarányos időtartam;
- **a számlázási időszak és időköz** (például hónap vagy hét, illetve minden 2.);
- **a hossz**: ha az előfizetés a jövőben lejár, ez megakadályozza, hogy a nem lejáró előfizetések ugyanabba a csoportba kerüljenek a lejáró előfizetésekkel.

A kulcsot a `WC_Subscriptions_Cart::get_recurring_cart_key()` metódus állítja elő, és a `woocommerce_subscriptions_recurring_cart_key` szűrővel módosítható.

Példák a kulcsra:

- 2024. december 18-án vásárolt előfizetés, amely 1 hónap ingyenes próbaidő után havi 50 Ft, 12 hónapon át: a kulcs `2024_01_18_monthly_for_12_months`.
- 2024. december 21-én vásárolt előfizetés, amely 4 hét ingyenes próbaidő után kéthetente 50 Ft: a kulcs `2024_01_18_every_2nd_week`.
