# PDF-nyugták és számlasablonok

> A Fluent PDF kiegészítő telepítése, a betűtípusok beállítása és a PDF-sablonok szerkesztése a blokkszerkesztőben.

A **Fluent PDF** funkcióval az áruház e-mailjeihez automatikusan saját tervezésű PDF-dokumentumokat csatolhatsz. A sablonokat a megszokott WordPress blokkszerkesztőben (Gutenberg) húzással és ejtéssel alakíthatod, kódolni nem kell.

A PDF-dokumentumok (**Order Receipt**, **Renewal Receipt**, **Refund Notice** és **Invoice**) kizárólag e-mailben jutnak el a vásárlókhoz.

## 1. lépés: a Fluent PDF kiegészítő telepítése

A Fluent PDF licencelt kiegészítő, és a FluentCart Pro egykattintásos telepítőjével érhető el: nincs zip-fájl, amit le kellene tölteni vagy fel kellene tölteni.

1. Győződj meg róla, hogy a FluentCart Pro licenced érvényesítve van a webhelyen (lásd a [Licencelés](https://hub.hellowp.io/hu/plugins/fluent-cart-pro/licenceles/) fejezetet).
2. Nyisd meg a **FluentCart Pro → Beállítások** oldalt.
3. A bal oldali menüben kattints a **Funkciók és kiegészítők** pontra.
4. Görgess az oldal aljára a **Bővítmény-kiegészítők** részhez.
5. Keresd meg a **Fluent PDF** kártyát, és kattints a **Telepítés és aktiválás** gombra.

A FluentCart letölti a kiegészítőt a licencelt frissítési szerverről, telepíti és aktiválja egy lépésben. A kártya **Active** állapotra vált, amint kész.

## 2. lépés: a betűtípusok telepítése

Hogy a PDF-ek minden eszközön (iPhone-on és Windowsos gépen is) hibátlanul készüljenek el és szépek legyenek, a rendszernek le kell töltenie néhány betűtípus-fájlt. Ez egyszeri művelet.

1. A kiegészítő aktiválása után nyisd meg a Fluent PDF beállításait.
2. Kattints a beállítások ikonra.
3. Ha megjelenik a „Font Setup Required” értesítés, kattints a narancssárga **Setup Fluent PDF** gombra.
4. A beállítóoldalon kattints a kék **Install Fonts** gombra.

## 3. lépés: sablon kiválasztása

A betűtípusok telepítése után lépj vissza a **Beállítások → E-mail-konfiguráció → PDF Templates** oldalra. Négy beépített sablont találsz, amelyeket átalakíthatsz:

- **Order Receipt**: a klasszikus nyugta, amelyet a vásárló új vásárlás befejezésekor kap.
- **Renewal Receipt**: akkor megy ki automatikusan, ha a vásárló előfizetése sikeresen megújul.
- **Refund Notice**: a visszatérítés igazolása, ha egy rendelést visszaküldenek vagy lemondanak.
- **Invoice**: egy szabványos, hivatalos számla üzleti tranzakciókhoz.

Vidd az egeret a szerkeszteni kívánt sablonra (például **Order Receipt**), és kattints a megjelenő kék **Edit Template** gombra.

## 4. lépés: a PDF megtervezése

A szerkesztés megnyitja a sablont a szokásos WordPress blokkszerkesztőben. Aki írt már bejegyzést WordPressben, ismeri a felületet.

### Blokkok húzása

A bal felső sarokban a **+** (blokk hozzáadása) ikonnal új vizuális elemeket adhatsz a nyugtához:

- **Képek**: húzz be egy Kép blokkot, hogy a bolt logója legyen legfelül.
- **Címsorok és bekezdések**: írj egy kedves „Köszönjük a vásárlást!” üzenetet az aljára.
- **Elválasztók**: vonalakkal tagold a nyugta szakaszait.

### Okos címkék (dinamikus adatok)

Az alapsablonban kapcsos zárójelbe tett szövegeket látsz, például `{{order.invoice_no}}`. Ezek az okos címkék (shortcode-ok), amelyeket a `{{:}}` gombra kattintva kérhetsz le. Egy mindenkinek kimenő sablonba nem írhatod bele egy adott vásárló nevét, ezért helyőrzőket használsz. A PDF elkészítésekor a FluentCart ezeket azonnal a vásárló valós adataira cseréli.

Néhány példa:

| Amit beírsz | Amit a vásárló lát |
|---|---|
| `{{settings.store_logo}}` | a feltöltött bolti logó képe |
| `Számlaszám: {{order.invoice_no}}` | Számlaszám: #INV-0042 |
| `Összesen {{order.total_amount_formatted}} fizettél.` | Összesen 45 000 Ft fizettél. |
| `{{order.items_table}}` | a megvásárolt termékek táblázata a mennyiséggel és az egyedi árakkal |

A címkéket szabadon mozgathatod, a betűméretüket módosíthatod, vagy félkövérré teheted őket, mint a normál szöveget.

#### Adó és EU-s áfa címkék

Ha az áruházad adót szed, különösen EU-s áfát vagy más fordított adózású rendszerben, ezek a címkék a megfelelő értékeket a megfelelő helyre teszik a PDF-nyugtákon:

- `{{order.tax_breakdown}}`: táblázat a rendelés minden adósoráról (például „Áfa 19%”, „Szállítási adó”). Fordított adózású rendelésnél az összeg oszlopban a „Charge reversed” felirat áll, a táblázat alá pedig automatikusan bekerül a „* Tax to be paid on reverse charge basis” lábjegyzet.
- `{{order.store_vat_display}}`: az áruház áfaszáma, amelyet a nyugta fejlécébe vagy láblécébe tehetsz.
- `{{order.buyer_vat_display}}`: a vásárló pénztárnál megadott áfaszáma. Olyan B2B-nyugtákhoz hasznos, amelyeken mindkét fél adóazonosítója szerepel.
- `{{order.buyer_company_name}}`: a vásárló cégneve a pénztári űrlapról.
- `{{order.buyer_legal_registration_id}}`: a vásárló jogi regisztrációs azonosítója (például cégjegyzékszám).
- `{{order.buyer_reverse_charge_declaration}}`: kész fordított adózási nyilatkozat, amely csak azoknál a B2B EU-s rendeléseknél jelenik meg, ahol a fordított adózás érvényes. A sablon bárhová beteheted, minden más rendelésnél üres marad.

Ezek a címkék együtt működnek az alábbi, automatikus áfaszám-megjelenítéssel, nem zavarják egymást. Egy teljes B2B-nyugtán így szerepelhet a vásárló áfaszáma a címben, az áruházé a fejlécben, és az adóbontás táblázata az összesítőnél.

#### A vásárló áfaszáma a nyugtákon

Ha a vásárló megad egy áfaszámot a pénztárnál, a FluentCart azt automatikusan a számlázási cím blokkjába teszi minden generált PDF-en (**Order Receipt**, **Renewal Receipt**, **Refund Notice** és **Invoice**), a vásárló címsora alá. Nem kell külön címkét hozzáadnod vagy a sablont módosítanod. Ha a vásárló nem adott meg áfaszámot, a sor kimarad, így a magánvásárlók nyugtái változatlanul néznek ki.

Az áfaszámokat a pénztáron az EU-s áfa mező gyűjti. Hogy ezt hogyan kapcsolhatod be, azt az [EU-s áfa](https://hub.hellowp.io/hu/plugins/fluent-cart-pro/ado-eu-afa/) fejezet írja le.

## 5. lépés: kipróbálás és mentés

Mielőtt a sablon élesben megy ki a vásárlóknak, mindig ellenőrizd.

1. Nézd meg a szerkesztő jobb alsó sarkát.
2. Kattints a fehér **Test Download** gombra.
3. A FluentCart azonnal elkészít egy mintát, és letölti a gépedre. Nyisd meg, és nézd meg, hogyan néz ki a logó, a szöveg és az okos címkék.
4. Ha minden megfelelő, kattints a mellette lévő sötét **Save Template** gombra.

Ezzel a sablon élesedett: amikor legközelebb vásárol valaki, a FluentCart az új terv szerint készíti el a PDF-et, és csatolja a rendelés e-mailjéhez.