Használati útmutató – Számlák (részletes)¶

Ez a fejezet a Számlák modul minden képernyőjét, mezőjét, gombját és folyamatát részletesen leírja: lista, létrehozás, részletek, fejléc, kedvezmény, tételek, kibocsátás, fizetések, törlés, sztornó, export.

1. Számlák listája¶

Elérés: Felső menü → Számlák (ikon: bizonylat).

Szűrők / bemenetek: - Ügyfél (selectedClientId) – legördülő vagy kereshető lista. Ha kiválasztasz egy ügyfélt, csak az ő számlái jelennek meg. - Keresés (search) – szövegmező; a lista szűrése (pl. számlaszám, vevő neve alapján).

Lista oszlopok (típusos): - Számlaszám, Ügyfél, Kiállítás dátuma, Esedékesség, Összeg (bruttó / nettó), Fizetve, Státusz (Piszkozat / Kiállítva / Lejárt / Részben fizetve stb.), esetleg Műveletek (Részletek, Letöltés). - Sorra kattintva → Számla részletek (Details) oldal.

Gombok a listán: - Új számla – ügyfél kiválasztásával indul a számla létrehozása (Create). Átirányíthat a Create oldalra vagy modálra. - Számla létrehozása árajánlatból – árajánlat részleteinél elérhető. Az árajánlat tételei és vevő adatai átmásolódnak. - Számla létrehozása projektből – projekt alapján. - Piszkozat létrehozása projekthez – CreateDraftForProject (projektből üres piszkozat).

Export gombok (listán vagy fejlécben): - Export CSV – összes (szűrt) számla alap adatai CSV-be. - Részletes CSV – részletes adatok CSV-be. - Kiválasztottak részletes CSV – a kiválasztott számlák részletes adatai CSV-be. - Kiválasztottak ZIP – a kiválasztott számlák PDF-jei egy zip fájlban. - Kiválasztott fizetések CSV – a kiválasztott számlák fizetései CSV-be. - Tömeges emlékeztető – kiválasztott számlákra emlékeztető e-mail.

A Számlák oldal jobb felső sarkában (vagy a fejlécben) van egy Számlázási beállítások gomb (fogaskerék ikon) – a számlázási beállítások és a Számlázz.hu összekapcsolás részletei a 2. Számlázási beállítások és Számlázz.hu fejezetben olvashatók.

2. Számlázási beállítások és Számlázz.hu¶

Hol nyitható: A Számlák listoldal jobb felső sarkában (vagy a fejlécben) van egy Számlázási beállítások gomb (fogaskerék ikon). Kattintásra megnyílik a Számlázási beállítások modál. Admin jogosultság szükséges.

Mit tartalmaz: Számlázó szolgáltató (Számlázz.hu), Számlázz.hu Agent kulcs, tesztüzemmód (sandbox), alapértelmezett ÁFA, EU VAT szám, kerekítési stratégia. Az alapértelmezett ÁFA itt beállított érték új számlatételnél, árajánlat tételnél és projekt tételnél alapértelmezettként jelenik meg.

2.1 Számlázási beállítások mezői¶

Számlázó szolgáltató: Legördülő – jelenleg Számlázz.hu.

Számlázz.hu Agent kulcs: Szövegmező. A Számlázz.hu szolgáltatónál kapott Agent kulcs (api key). Ezt kötelező megadni, ha a számlákat a Számlázz.hu-n keresztül szeretnéd kiállítani (nem sandbox). Az agent kulcs beszerzése: belépsz a Számlázz.hu fiókodba, és az Agent / API beállításoknál megtekintheted vagy generálhatod az agent kulcsot. A CégemOne ezt a kulcsot használja a számla kiállítás, fizetés rögzítés és sztornó API hívásokhoz.

Tesztüzemmód (sandbox): Kapcsoló. Ha be van kapcsolva, a számlák nem mennek ki a Számlázz.hu szerverre (nincs NAV beküldés). Teszt számlaszám (pl. TEST-…) jön létre, és ilyen számla kiállítás után is törölhető. Éles használat előtt kapcsold ki a sandboxot.

Alapértelmezett ÁFA: Egyetlen legördülő: 27%, 18%, 5%, 0%, vagy speciális kódok: Tárgyi adómentes (TAM), Alanyi adómentes (AAM), Fordított áfa (F.AFA), Különbözeti áfa (K.AFA), ÁFA tárgyi hatályán kívül (TAHK), EU-n belüli (EUT), EU-n kívüli (EUKT). A kiválasztott érték lesz az alapértelmezett minden új számlatételnél, árajánlat tételnél és projekt tételnél – a felületen a tétel ÁFA mezője ezzel töltődik elő. Egyedi tételnél továbbra is változtatható.

EU VAT szám: Opcionális – ha van EU VAT számod (pl. HU12345678).

Kerekítési stratégia: Legördülő: Nettó-alapú (B2B) – Alapértelmezett (nettó egységár × mennyiség → kerekített nettó → ÁFA → bruttó), vagy Bruttó-alapú (B2C) (bruttó egységár × mennyiség → kerekített bruttó → ÁFA visszaszámolás → nettó).

Gombok: Mégse – modál bezárása. Mentés – a beállítások mentésre kerülnek.

2.2 Számlázz.hu összekapcsolás – lépésről lépésre¶

Számlázz.hu fiók: Regisztrálj a szamlazz.hu oldalon (ha még nincs fiókod), és add meg a céged adatait a Számlázz.hu-ban.
Agent kulcs: A Számlázz.hu felületen (beállítások / Agent / API rész) nézd meg vagy generáld az Agent kulcsot. Másold ki.
CégemOne – Beállítások: Először a Vezérlőpult → Beállítások-ban töltsd ki az Ügyféladatok blokkot (kibocsátói adatok), és mentsd.
CégemOne – Számlázási beállítások: A Számlák oldalon kattints a Számlázási beállítások gombra. A modálban válaszd a Számlázz.hu szolgáltatót, illeszd be a Számlázz.hu Agent kulcs mezőbe a kulcsot. Ha még tesztelsz, hagyd bekapcsolva a Tesztüzemmód (sandbox)-ot; élesben kapcsold ki. Állítsd be az Alapértelmezett ÁFA-t és a Kerekítési stratégia-t, majd Mentés.
Teszt: Hozz létre egy teszt számlát (sandbox módban), állítsd ki, majd kapcsold ki a sandboxot és kiállítasz egy valódi számlát – a Számlázz.hu-n és a NAV-on meg kell jelennie.

2.3 CégemOne → Számlázz.hu: mi kerül át¶

A CégemOne a Számlázz.hu Agent API-t használja. Összefoglalva, mi kerül a Számlázz.hu-ba:

Számla kiállítás: Fejléc (teljesítés dátuma, fizetési határidő, fizetési mód, pénznem, számla nyelve, számla megjegyzés), vevő (név, cím, e-mail, adószám). Ha a CégemOne-ben be van pipálva az „Email küldése vevőnek (kibocsátáskor)” és van vevő e-mail, a Számlázz.hu is elküldi a számlát (vagy a vevői fiók linkjét) a vevőnek. Tételek: megnevezés, mennyiség, egység, nettó egységár, ÁFA kulcs; a tétel megjegyzés és az ÁFA záradék / jogcím (VatClause) a Számlázz.hu tétel megjegyzés mezőjébe kerül (ha mindkettő kitöltött, összefűzve). Kedvezmény: ha a számlán van kedvezmény (százalék vagy fix), az kedvezmény tételként kerül a Számlázz.hu-ba.

Fizetés rögzítés – szinkron: Ha egy kiállított számlára a CégemOne-ben fizetést rögzítesz (összeg, dátum, fizetési mód, megjegyzés), és a számla Számlázz.hu providerrel van kiállítva (nem sandbox), a CégemOne automatikusan szinkronizálja a fizetést a Számlázz.hu kifizetés API-jára. Fizetés törlése a CégemOne-ben esetén a Számlázz.hu-n is felülíródik a kifizetési lista (a törlés tükröződik). Fizetési mód megfeleltetés: készpénz, bankkártya, átutalás, egyéb.

Sztornó: A CégemOne Sztornó gomb (kiállított számlán) a Számlázz.hu sztornó API-jára elküldi az eredeti számlaszámot; a Számlázz.hu visszaadja a sztornó számla számát, a CégemOne „Sztornózva” állapotúra állítja a számlát. Sandbox módban a sztornó nem támogatott.

Összefoglalva – első bejelentkezés után: (1) Vezérlőpult → Beállítások → Ügyféladatok kitöltése, Mentés. (2) Beállítások → Google csatlakoztatás (e-mail a számla/emlékeztető küldéséhez). (3) Számlák → Számlázási beállítások → Számlázz.hu, Agent kulcs, Alapértelmezett ÁFA, kerekítés, Mentés. Ezek után a számla kiállítás, a vevői e-mail, a fizetés szinkron és a sztornó a Számlázz.hu-val összehangoltan működik.

3. Számla létrehozása (Create – ügyfélből)¶

Elérés: Számlák → Új számla. Általában megjelenik egy űrlap (modál vagy oldal), ahol Ügyfél kötelező; opcionálisan Kibocsátás dátuma, Esedékesség, Státusz (Piszkozat). Mentés – létrejön a számla (piszkozat), majd átirányít a Számla részletek oldalra, ahol a fejlécet, vevőt, tételekét és kedvezményt tudod kitölteni.

4. Számla részletek (Details) – teljes képernyő¶

Elérés: Számlák listában kattints egy számla sorára. A Details oldal a számla központi helye: itt szerkeszted a fejlécet, vevőt, kedvezményt, tételekét, rögzíted a fizetéseket, kiállítod vagy törlöd a számlát.

4.1 Eszköztár gombok (fejlécben)¶

Számlaszám másolása – a számlaszám vágólapra másolása (data-copy).
Számla PDF letöltése – link: Invoice/Download/id. Csak kiállított számlánál értelmes; megnyitja vagy letölti a PDF-et.
Vissza a listához – returnUrl-re navigál.
Mentés (btnSaveAllInvoice) – „Fejléc, vevő és kedvezmény mentése”. Egy kattintással menti: (1) a fejléc űrlapot (InvoiceHeaderForm), (2) a kedvezmény űrlapot (DiscountForm), (3) ha van tételek űrlap (InvoiceItemsForm), először a tételek mentése, majd a fejléc. Tehát egy gombbal minden szerkeszthető adat mentésre kerül.

4.2 Fejléc adatok (csak piszkozatnál szerkeszthető)¶

Ha a számla még nincs kiállítva (IsIssued = false), a Fejléc adatok és Vevő adatok kártyák szerkeszthetők. Kiállítás után ezek csak olvashatóak.

Fejléc adatok kártya – mezők:

Mező (label)	Típus	Kötelező	Leírás / értékek
Teljesítés dátuma (IssueDate)	date	Igen	A teljesítés napja.
Fizetési határidő (DueDate)	date	Igen	Meddig kell fizetni.
Számla nyelve (Language)	select	Igen	hu (Magyar), en (Angol), de (Német).
Pénznem (Currency)	select	Igen	HUF, EUR, USD.
Fizetési mód (PaymentMethod)	text	Igen	Pl. „Átutalás”, „Készpénz”. Placeholder: „pl. Átutalás”.
Számlaszám előtag (InvoiceNumberPrefix)	text	Nem	Opcionális előtag. Placeholder: „Opcionális”.
Számla megjegyzés (Comment)	textarea	Nem	Szabad szöveg. Placeholder: „Opcionális megjegyzés”.

4.3 Vevő adatok (csak piszkozatnál)¶

Mező (label)	Típus	Kötelező	Leírás
Ügyfél (ClientId)	kereshető legördülő	Igen	„– válassz ügyfelet –”. A kiválasztott ügyfél adatai (cím, adószám stb.) a számlán megjelennek.
Vevő email (BuyerEmail)	email	Nem	Placeholder: „vevo@example.com”. Ügyfél kiválasztásakor automatikusan fel töltődhet az ügyfél e-mailjéből.
Email küldése vevőnek (kibocsátáskor) (SendEmailToBuyer)	checkbox	Nem	Ha be van pipálva, kiállításkor a rendszer e-mailt küld a vevőnek (BuyerEmail).
Projekt (opcionális) (ProjectId)	kereshető legördülő	Nem	„– nincs projekt –”. A számla kapcsolható egy projekthez.

4.4 Kedvezmény panel (csak piszkozatnál)¶

A Kedvezmény kártya a számlatételek fölött van. Három mód:

Nincs – nincs kedvezmény (gomb: „Nincs”).
Százalék – kedvezmény százalékban (bruttó alapú):
Kedvezmény (%) – szám (pl. 10).
Kedvezmény csak a munkadíj részre vonatkozzon (DiscountLaborOnly) – checkbox. Ha be van pipálva, a százalékos kedvezmény csak a munkadíj tételre (IsLabor) vonatkozik.
Fix összeg – kedvezmény bruttó Ft-ban:
Kedvezmény (fix összeg, bruttó Ft) (DiscountGrossAmount) – szám.
Megjegyzés: „Fix kedvezménynél a csak munkadíjra opció nem értelmezett.”

A kedvezmény értékek a Mentés (btnSaveAllInvoice) gombbal együtt kerülnek mentésre (hidden mezőkben a fejléc űrlapban: DiscountMode, DiscountPercent, DiscountGrossAmount, DiscountLaborOnly).

4.5 Számlatételek (Invoice items)¶

Fejléc a kártyán: „Számlatételek”. Gombok (csak piszkozatnál):

Mentés (tételek űrlap, form="InvoiceItemsForm") – a tételek változásainak mentése.
Törlés – megnyitja a Számla törlése megerősítő modált (Invoice/Delete).
Kibocsátás – a számla kiállítása (Issue). Csak akkor aktív, ha van legalább egy tétel. Kiállítás után a tételek és a fejléc általában nem szerkeszthetők (csak olvasható nézet).
Kiállított (nem sandbox) számlánál: Sztornó gomb – Storno action.

Üres állapot: „Még nincs tétel” + Új számla tétel gomb (addInvoiceItemBtnEmpty / addInvoiceItemBtn).

Tételek táblázat (asztali) – oszlopok és mezők:

Minden tétel sorában (és opcionálisan Tétel megjegyzés külön sor):

Mező	Típus	Kötelező	Leírás
Megnevezés (Description)	text	Igen	Max. 200 karakter. Alapértelmezett szöveg: „(nincs megadva)” vagy „Új tétel”.
Mennyiség (Quantity)	number	Igen	0.0001–1 000 000.
Egység (Unit)	text	Igen	Alapértelmezett: „db”. Max. 20 karakter.
Egységár (nettó) (UnitNetPrice)	number	Igen	Tizedes.
ÁFA	egyesített választó (VatRate / VatMode / VatCode)	Igen	Elsődleges opciók: pl. 0%, 5%, 18%, 27% (százalék), vagy speciális kódok (ATK, EAM, EUE, stb.). További… → másodlagos opciók + Egyedi (egyéni százalék vagy egyéni kód).
Nettó (számolt)	number, read-only	–	UnitNetPrice × Quantity.
ÁFA összeg (számolt)	number	–	Nettó × ÁFA kulcs (százalékos módnál).
Bruttó (számolt)	number	–	Nettó + ÁFA.
Törlés sor	gomb (ikon)	–	ii-remove – a tétel sor törlése (visszaigazolás vagy azonnali eltávolítás a űrlapból; tényleges törlés mentéskor).
Tétel megjegyzés (Comment)	textarea	Nem	Max. 500 karakter. Placeholder: „Tétel megjegyzés…”.
Munkadíj (IsLabor)	checkbox	Nem	Ha be van pipálva, a tétel „munkadíj”; a százalékos kedvezmény „csak munkadíjra” opció erre a tételre vonatkozik.

Mobil: A tételek kártyás (lenyíló) nézetben jelennek meg; ugyanazok a mezők (Megnevezés, Mennyiség, Egység, egységár, ÁFA, Törlés, megjegyzés, munkadíj).

Új tétel hozzáadása: Új számla tétel gomb – új üres sor vagy kártya jelenik meg; kitöltöd a mezőket, majd Mentés (tételek űrlap).

4.6 Fizetések¶

A számla részletek oldalon van egy Fizetések szekció (általában a tételek mellett vagy alatt). Itt láthatók a már rögzített fizetések (összeg, dátum, mód, megjegyzés).

Fizetés rögzítése: - Fizetés hozzáadása / Fizetés rögzítése gomb vagy űrlap. Mezők: - Összeg (amount) – kötelező, tizedes (Ft). - Dátum (date) – mikor érkezett a fizetés. - Mód (method) – pl. Átutalás, Készpénz, Kártya. - Megjegyzés (note) – opcionális. - Mentés – a Payment mentésre kerül a számlához. A Fizetett összeg és a Hátralék frissül.

Fizetés törlése: Egy fizetés során Törlés gomb → megerősítő (DeletePayment) → a fizetés törlődik.

4.7 Kiállítás (Issue)¶

Feltételek: A számla piszkozat (IsIssued = false), és van legalább egy tétel. Ha nincs tétel, a Kibocsátás gomb disabled.

Művelet: Kattintás a Kibocsátás gombra. POST → Invoice/Issue/id. A rendszer: - Beállítja az Invoice IsIssued = true. - Számlaszámot generál (ha még nincs). - Opcionálisan küld e-mailt a vevőnek (SendEmailToBuyer = true). - Opcionálisan integrál a Számlázz.hu-val vagy más szolgáltatóval (PDF, NAV).

Utána a fejléc, vevő és tételek általában nem szerkeszthetők (csak olvasható). A Számla PDF letöltése gomb aktív.

4.8 Számla törlése¶

Piszkozat: Törlés gomb → Delete modál → Törlés / Igen → a számla törlődik (vagy logikai törlés). Kiállított számla: Általában nem törölhető (jogi okok). Kivétel: Sandbox számla (IsSandbox = true), ami nem ment a NAV-hoz – ilyen kiállítás után is törölhető.

4.9 Sztornó (Storno)¶

Elérés: Számla részletek, kiállított és nem sztornózott számlánál → Sztornó gomb. POST → Invoice/Storno/id. A rendszer sztornó számlát hoz létre (StornoInvoiceNumber, IsCancelled), a számla „Sztornózva” státuszú lesz. Utána a sztornó gomb már nem elérhető.

4.10 Számla létrehozása árajánlatból / projektből¶

Árajánlatból: Árajánlat részleteinél Számla létrehozása – az árajánlat tételei és vevő adatai átmásolódnak az új számlába. Részletek oldalon tovább szerkesztheted a fejlécet és tételekét, majd Kibocsátás.
Projektből: Projekt és ügyfél alapján; opcionálisan projekt tételek másolása.
Piszkozat projekthez: Üres piszkozat a projekthez kötve.

Naptár, Felhasználók, Dokumentumok: 04e-naptár-felhasználók-dokumentumok.md
Gyakori feladatok receptek: 04f-gyakori-feladatok.md