# Értékesítési ügynök

> Ügynökök felvétele, jutalékkategóriák, ügyfelek hozzárendelése, rendelés az ügyfél nevében, jutalék és kifizetés.

Az értékesítési ügynök modul a bővítmény része, külön telepíteni nem kell. Alapértelmezetten ki van kapcsolva: amíg nem kapcsolod be, a menüi, mezői és a **Fiókom** fülei sem jelennek meg. Az ügynökök jutalékot kapnak az ügyfeleik rendeléseiért.

## Bekapcsolás

1. Nyisd meg a **Nagykereskedelem → Beállítások → General** fület, és válaszd a **Sales Agent** al-fület.
2. Jelöld be az **Enable Sales Agent** opciót.
3. Ha az ügynökök jutalékkifizetést kérhetnek, kapcsold be az **Enable PayPal for Payouts** és/vagy az **Enable Bank Transfer for Payouts** opciót. A kettő egymástól független: bármelyik, mindkettő vagy egyik sem bekapcsolható.
4. Opcionálisan válaszd ki az alapértelmezett ügynököt (**Default Sales Agent**). A lista a már létező ügynökökből áll, ezért előbb vegyél fel egyet, és utána térj vissza ehhez a beállításhoz.
5. Kattints a **Módosítások mentése** gombra.

A bekapcsolás után a **Nagykereskedelem** menüben három új pont jelenik meg:

- **Agents**: az ügynökök listája, új ügynök felvétele. Látszik a jutalékkategóriájuk, a rendeléseik és az ügyfeleik száma.
- **Commission Category**: a jutalékszabályok (típus, érték, hatókör).
- **Payout**: a jutalékkifizetések áttekintése és kezelése.

## Jutalékkategória létrehozása

Ügynököt csak akkor vehetsz fel, ha már van jutalékkategória, mert minden ügynökhöz kötelező egyet rendelni.

1. Nyisd meg a **Nagykereskedelem → Commission Category** oldalt.
2. Add meg a kategória **Name** nevét (például „Arany szint 10%”).
3. A **Slug** üresen hagyható, automatikusan generálódik. Opcionálisan írj leírást.
4. A **Commission Type** lehet **Percentage** (az összeg százaléka) vagy **Fixed** (fix összeg rendelésenként vagy termékenként).
5. Add meg a **Commission Value** értéket.
6. A **Commission Basis** résznél válaszd ki, hogy a jutalék **Commission On Products** (kiválasztott termékekre; üresen az összesre) vagy **Commission On Category** (kiválasztott termékkategóriákra) vonatkozzon.
7. Opcionálisan kapcsold be a **Per product commission** opciót (az egyes termékek felülírhatják a kategória értékét), és/vagy a **Calculate commission on product subtotal** opciót (a jutalék a sor részösszegéből számolódik, nem a rendelés végösszegéből).
8. Kattints az **Add New Commission Category** gombra.

## Ügynök felvétele

Az ügynököt az admin közvetlenül felveheti, vagy a regisztrációs űrlapon beküldött kérés jóváhagyásával jön létre.

1. A **Nagykereskedelem → Agents** oldalon kattints az **Add New** gombra.
2. Add meg az ügynök **First Name** és **Last Name** adatait. Az **Assign/Select User as Agent** mezőben keresd ki és válaszd ki azt a WordPress-felhasználót, akihez az ügynök tartozik. A bővítmény automatikusan megadja a felhasználónak az ügynök (Sales Agent) szerepkört.
3. Opcionálisan írj **Agent Bio** szöveget.
4. Válaszd ki a **Commission Category** kategóriát. Ez határozza meg, hogyan keres az ügynök.
5. A **Customer Registration** mezőt állítsd **Yes** értékre, ha az ügynök a saját **Fiókom** oldaláról is létrehozhat új ügyfélfiókot, vagy **No** értékre, ha csak a hozzárendelt ügyfeleket kezelheti.
6. Kattints a **Publish** gombra.

Az ügynöknek van **Customer List** (ügyféllistája) is: a hozzárendelt ügyfelek automatikusan megjelennek benne.

## Ügyfél hozzárendelése ügynökhöz

Minden nagykereskedelmi vevő egy ügynökhöz tartozhat. Azok az ügyfelek, akik nem választanak ügynököt, az alapértelmezett ügynököt kapják. Ezt bármikor módosíthatod.

1. Nyisd meg a **Felhasználók → Összes felhasználó** oldalon az ügyfél profilját (vagy a **Felhasználók → Új hozzáadása** oldalt új ügyfélhez). Görgess az **Assign Agent** részhez.
2. Válaszd ki az ügynököt az **Agent** listából, vagy hagyd a **No Agent** értéken.
3. Kattints a **Felhasználó frissítése** (új felhasználónál **Új felhasználó hozzáadása**) gombra.

Az ügyfél ezután az ügynök **Agent Customers** listájában jelenik meg, és az általa leadott minden további, jogosult rendelés után jutalék keletkezik az ügynöknek.

## Termék szintű jutalék

Ha a jutalékkategóriában be van kapcsolva a termék szintű jutalék, az egyes termékeknek (és variációknak) saját jutalékértéke lehet.

1. Szerkeszd a terméket, és nyisd meg a **Termék adatok** panel **Sales Agent Commission** fülét.
2. Jelöld be az **Add Commission Amount** opciót.
3. Válaszd ki a **Commission Type** típust (**Percentage** vagy **Fixed**), és add meg a **Commission Value** értéket.
4. Frissítsd a terméket.

Változós termékeknél a jutalék variációnként a **Variációk** fülön adható meg.

## Jelentkezés ügynöknek (regisztrációs űrlap)

Az új ügynökök egy nyilvános űrlapon is jelentkezhetnek, a kérést az admin hagyja jóvá.

1. A **Nagykereskedelem → Form Builder → Sales Agent Registration Form** oldalon állítsd össze az űrlapot. Elérhető mezők: keresztnév, vezetéknév, e-mail, jelszó, telefonszám, jutalékkategória, szövegterület, jelölőnégyzet és rádiógomb. Minden mezőnek külön beállításai vannak (felirat, felirat helye, helykitöltő, leírás, súgó, bemeneti maszk, alapérték, érvényesítési szabály, feltételes logika).
2. Másold ki az űrlap tetején látható rövidkódot (`[sales_agent_registeration_form]`).
3. Illeszd be egy új oldalra (**Oldalak → Új oldal**), és tedd közzé.

Amikor valaki beküldi az űrlapot, új bejegyzés jön létre a **Nagykereskedelem → Requests → Sales Agent Registration Request** listában. A **View** gombbal megnézheted a beküldött adatokat, majd **Approve** (jóváhagyás) vagy **Reject** (elutasítás). Jóváhagyáskor a jelentkező felhasználói fiókja megkapja az ügynök szerepkört és a választott jutalékkategóriát, elutasításnál inaktív marad. Mindkét esetben automatikus e-mail megy a jelentkezőnek.

## Az ügynök felülete a Fiókom oldalon

Az ügynök szerepkörű felhasználó a **Fiókom** oldalon a következő füleket kapja:

- **Agent Customers**: a hozzárendelt ügyfelek listája. Ha a **Customer Registration** be van kapcsolva, a **Create Customer** gombbal új ügyfelet vehet fel.
- **Agent Orders**: az ügyfelei összes rendelése állapottal és összeggel.
- **Agent Commissions**: az egyes jogosult rendeléseken keletkezett jutalék, dátum szerint szűrhetően.
- **Payout**: itt adja meg a kifizetési adatait, és látja a kifizetések előzményét és állapotát.

## Rendelés az ügyfél nevében

1. Az ügynök belépés után a **Fiókom → Agent Customers** listában az ügyfél neve mellett a **Make Order** gombra kattint.
2. Az ügynök azonnal az ügyfél munkamenetébe lép. Minden előoldal tetején fekete sáv jelenik meg: „Agent Logged-In as: [ügyfél neve]”, jobbra a **Switch back to Agent** gombbal.
3. Az ügynök úgy vásárol, mint az ügyfél: az ügyfél nagykereskedelmi árai, mentett címei és fizetési módjai érvényesek. Tegyen termékeket a kosárba, és menjen a pénztárhoz.
4. A rendelés leadása után az ügyfél fiókjához jön létre, és a bővítmény automatikusan megjelöli a hozzá tartozó ügynökkel.
5. A **Switch back to Agent** gombbal visszatér a saját fiókjához.

## Jutalék keletkezése

Amikor a rendelés állapota megváltozik (például teljesítve lesz), a bővítmény automatikusan kiszámolja a jutalékot az ügynök jutalékkategóriája szerint (vagy a termék, illetve kategória szintű felülírás szerint), és új jutalékbejegyzést ment. A jutalék azonnal megjelenik az ügynök **Fiókom → Agent Commissions** fülén **Pending** (függőben) állapotban, és a **Nagykereskedelem → Payout** oldalon az ügynök kifizetetlen egyenlegében. Ha a rendelést később törlik, sikertelenné teszik vagy visszatérítik, a jutalékbejegyzés automatikusan törlődik.

## Kifizetés

1. Az ügynök a **Fiókom → Payout → Configure** oldalon megadja a PayPal-e-mail-címét vagy a bankszámla-adatait (amelyik mód be van kapcsolva).
2. Az admin a **Nagykereskedelem → Payout** oldalon megkeresi az ügynököt, és a **View Payout** gombbal megnyitja a részleteit: a mentett kifizetési adatokat és a teljes jutaléklistát (**Commissions List**).
3. Az **Edit** gombbal megnyitja a kifizetendő jutalékot.
4. A **Commission Status** értékét **Pending**-ről **Paid**-re (kifizetve) állítja, ha a kifizetést PayPalon vagy átutalással a bővítményen kívül már teljesítette. **Cancelled** (törölve) érték is választható. Végül **Save Changes**.
5. Az ügynök a saját **Payout** fülén látja az új állapotot.

## E-mail értesítések

A modul több e-mailt küld, amelyeket a **WooCommerce → Beállítások → E-mailek** oldalon kezelhetsz. Mindegyik külön ki- és bekapcsolható, a tárgya, címsora, címzettje és tartalma testre szabható, és a **Manage** gombbal nyíló beállításoknál az e-mail típusa (HTML vagy egyszerű szöveg) is megadható.

- Ügynökhöz tartozó rendelés leadása: az érintett címzettet értesíti a rendelés részleteiről.
- Ügynöki jelentkezés jóváhagyása: a jelentkezőt értesíti, hogy ügynök lett.
- Jutalékkategória hozzárendelése vagy módosítása: az ügynököt értesíti az új jutalékszerkezetről.
- Kifizetés állapotának változása: például amikor a kifizetési kérés jóváhagyásra került, teljesült vagy módosult.