10. Faktura — editor a výkaz víceprací

Editor faktury slouží k tvorbě nového konceptu nebo úpravě existujícího. Otevře se přes + Nová faktura (z dashboardu), Faktury → Nová faktura, nebo z detailu klienta / zakázky.

10.1 Editor — celkový přehled

Editor je rozdělený na tři bloky:

1. Hlavička (vlevo nahoře) — typ, klient, zakázka, data
2. Položky (střed) — řádky faktury
3. Sumář a akce (vpravo nahoře + dole) — částky, sleva, tlačítka

10.2 Hlavička

10.2.1 Typ dokladu

10.2.2 Klient + Zakázka

• Klient (povinný) — vyber z dropdownu, vyhledávání podle jména / IČ.
• Zakázka (volitelná) — pokud klient má zakázky, dropdown nabídne jen jeho vlastní. Po výběru zakázky se předvyplní hodinová sazba a splatnost.

⚠️ Pokud změníš klienta uprostřed editace, zakázka se vyresetuje (původní patřila jinému klientovi).

10.2.3 Data

10.2.4 Měna a DPH

• Měna — předvyplní se z klienta (nebo zakázky), lze přepsat.
• Reverse charge — checkbox; pokud zatržené, faktura bude bez DPH s textem „Daň přiznává odběratel". Předvyplní se z klienta.

10.2.5 Číslo dokladu — ruční override (volitelné)

V hlavičce konceptu je pole Číslo faktury (resp. „Číslo zálohové faktury" / „Číslo dobropisu" podle typu). Pole je volitelné:

• Prázdné — při Vystavení (status draft → issued) systém automaticky vygeneruje číslo dle šablony (per-dodavatel v Nastavení nebo globální cfg). V placeholderu pole vidíš live náhled, např. 2605002 — to je číslo, které fakturu dostane, pokud nepřepíšeš.
• Vyplněné — backend použije přesně tvou hodnotu, neinkrementuje counter. Při Vystavení se ověří, že číslo není už použité u jiné faktury stejného dodavatele (jinak vrátí chybu „Číslo už existuje…"). Max 20 znaků.

💡 Použití: standardně nech prázdné, automatika tě nezklame. Manual override použij jen výjimečně — např. když migruješ historickou fakturu z jiného systému a potřebuješ zachovat originální číslo.

⚠️ Po Vystavení je číslo immutable — admin force-edit ho NEodemkne. Pokud chceš číslo změnit, musíš vystavit storno/dobropis a fakturu vystavit znovu pod jiným číslem.

Šablonu pro automatické generování nastavuješ v Systém → Dodavatelé → [tvůj dodavatel] → Číslování faktur — viz § 17.5.3.

10.3 Položky

Tabulka řádků faktury. Tlačítko + Přidat položku přidá nový řádek.

10.3.1 Drag & drop pořadí

Levým úchytem (☰) přetáhni položky pro změnu pořadí. Pořadí se zachová v PDF.

10.3.2 Smazání položky

Křížek vpravo. Pokud položka je propojená s výkazem víceprací (viz § 10.6), smazání se zeptá, jestli i smazat výkaz.

10.4 Sumář (vpravo)

Automaticky se přepočítává:

• Mezisoučet — součet množství × cena/jed. všech položek
• Sleva — pokud je vyplněná (% nebo absolutní, pole vlevo)
• Základ DPH — po slevě
• DPH 21 % / 12 % / 0 % (osvob.) / 0 % (RC) — rozdělené podle sazeb v položkách
• Celkem k úhradě — final částka v měně faktury

💡 Sazby DPH ve výběru — 0 % (osvob.) znamená osvobozeno od DPH, 0 % (RC) znamená reverse charge (přenesená daňová povinnost). Sazby mají stejné procento, ale jiný legislativní význam — vybírej dle situace.

10.4.1 Sleva

Pole Sleva podporuje:

• 10 % → procentuální sleva z mezisoučtu
• 1500 → absolutní sleva v měně faktury
• 1500 Kč → totéž

10.4.2 Faktura v cizí měně (EUR / USD / …) — přepočet do CZK

Pokud je faktura v jiné měně než CZK, MyInvoice po uložení automaticky stáhne denní devizový kurz z ČNB a uloží ho na fakturu. Kurz se použije pro přepočet základů DPH a DPH do CZK (kvůli českému účetnictví).

Kdy se kurz načítá:

• Po každém uložení EUR (cizí) faktury — server pošle požadavek na cnb.cz (kurzovní lístek pro issue_date).
• Pokud kurz pro daný den ještě není (víkend, svátek, pozdě večer): systém zkusí až 7 dní zpět a najde nejbližší dříve dostupný kurz.
• Kurz se cachuje v lokální DB — opakované otevření faktury už neposílá nový request.
• Pokud ČNB nedostupné a žádný kurz není v cache: použije se poslední známý kurz (z dřívější faktury) a zobrazí se ⚠️ upozornění toast po uložení.

Co se přepočítává:

• ✅ Základy DPH per sazba (21 %, 12 %, 0 %) → CZK
• ✅ DPH per sazba → CZK
• ✅ Celkem bez DPH / DPH celkem / Celkem → CZK
• ❌ Jednotlivé řádky položek se nepřepočítávají (zůstávají v cizí měně)

Zaokrouhlování CZK přepočtu: HALF_UP, 2 desetinná místa, zvlášť per sazba DPH.

Kde je přepočet vidět:

• Detail faktury — sekce „Přepočet do CZK" pod hlavními totály
• PDF — samostatná tabulka „Přepočet do CZK" pod sumářem (světle šedé podbarvení), plus drobná řádka „Kurz ČNB: X CZK / 1 EUR (datum)"
• Editor (re-edit) — informativní řádka pod totály s použitým kurzem

10.5 Tlačítka

10.6 Výkaz víceprací (work report)

Pokud fakturuješ za hodiny, můžeš ke každé hodinové položce přidat detailní výkaz, který se vytiskne na 2. stranu PDF.

10.6.1 Aktivace

V editoru klikni na šedou ikonu „Přidat výkaz víceprací" v řádku položky. Zobrazí se modal/sekce:

Přidej řádky → tlačítko Uložit výkaz. Suma hodin × sazba se přenese do hlavní položky faktury (pole „Množství" + „Cena/jed.").

10.6.2 PDF výstup

Druhá strana PDF má formát:

+--------------------------------------------------+
| Výkaz víceprací — faktura 2605001               |
|                                                  |
| Datum     Popis                Hod.  Sazba   Kč |
| 03.05.    Konzultace strategie  2.0  1500   3000 |
| 04.05.    Code review           1.5  1500   2250 |
| ...                                              |
|                                                  |
| Celkem hodin: 12.5                              |
| Celkem k úhradě: 18 750 Kč                      |
+--------------------------------------------------+

10.6.3 Smazání výkazu

V editoru klik na ikonu odpojit (řetěz). Položka faktury zůstane, ale ztratí detailní rozpis.

10.7 Schvalování výkazu zákazníkem

Pokud má zakázka zapnuté „Vyžaduje schválení výkazu práce zákazníkem" (viz § 8.6) a faktura obsahuje výkaz víceprací, faktura nepůjde vystavit, dokud zákazník výkaz neschválí přes e-mailový odkaz. Po schválení se faktura automaticky vystaví a odešle.

V detailu faktury se objeví:

• Badge stavu schválení v hlavičce vedle status (Neurčeno / Vyžádán / Schválen / Zamítnut)
• Tlačítko „Odeslat ke schválení" (vedle Vystavit, jen pro draft)
• Tlačítko „Test schválení" (v sekci Další akce — pošle test e-mail na adresu dodavatele bez vygenerování reálného tokenu)
• Sekce „Schválení výkazu zákazníkem" s detaily (datum žádosti, datum rozhodnutí, kdo rozhodl, případný důvod zamítnutí)
• Tlačítko „Změnit stav" (jen admin) — manuální override pro případy schválení mimo systém (telefonem, mailem mimo aplikaci)

10.7.1 Workflow

1. Vytvoříš draft fakturu s výkazem víceprací na zakázce, která vyžaduje schválení.
2. Klikneš „Odeslat ke schválení" → systém:

• vygeneruje jednorázový bezpečný token (uložený v DB)
• vyrenderuje samostatné PDF jen výkazu (Vykaz-XYZ.pdf)
• pošle e-mail s velkým červeným tlačítkem „✓ Schválit vícepráce" na fakturační e-maily zakázky (fallback hlavní e-mail klienta)

1. Tlačítko „Vystavit" je nyní zablokované s nápovědou „Faktura nepůjde vystavit, dokud zákazník neschválí výkaz."
2. Zákazník v e-mailu klikne na tlačítko → otevře se veřejná schvalovací stránka (bez přihlášení), kde vidí výpis víceprací.

1. Vybere Schválit nebo Zamítnout (s povinným důvodem). CAPTCHA ochrana proti botům, e-mail rozhodujícího se uloží do auditu.
2. Po schválení:

• Stav schválení faktury se přepne na Schválen
• Faktura se automaticky vystaví (přidělí variabilní symbol, snapshoty)
• Faktura se automaticky odešle standardním procesem (na hlavní e-mail klienta + všechny fakturační e-maily zakázky)

1. Po zamítnutí:

• Stav přepnut na Zamítnut, důvod uložen
• Faktura zůstává jako draft — můžeš výkaz upravit a poslat znovu ke schválení (vygeneruje se nový token, předchozí ztrácí platnost)

10.7.2 Test schválení

Pro náhled e-mailu před produkčním odesláním klikni „Test schválení" v sekci Další akce — e-mail půjde na adresu aktuálního dodavatele, link v něm vede na placeholder, který nic neudělá. Slouží jen ke kontrole vzhledu.

10.7.3 Manuální změna stavu (admin)

Pokud zákazník schválil mimo systém (telefonem, e-mailem), admin může v sekci „Schválení výkazu zákazníkem" kliknout „Změnit stav" a vybrat:

⚠️ Stav „Vyžádán" v dropdownu chybí — k němu vede jen tlačítko „Odeslat ke schválení", které generuje token a posílá e-mail. Ručně se nedá nastavit.

10.7.4 Bezpečnost

• Token je jednorázový — po schválení/zamítnutí přestane platit. Druhý klik na e-mailový odkaz vrátí „Tento odkaz byl již použit nebo není platný".
• Public stránka chráněna CAPTCHA (Cloudflare Turnstile) — chrání proti botům a anonymnímu spamu.
• Origin/CSRF check vypnutý pro public endpointy — zákazník přijde z e-mailového klienta s prázdným/cizím Origin headerem. Anti-bot řeší token + CAPTCHA.
• Audit log — každá akce (approval_requested, approval_approved, approval_rejected, approval_reset) se zapíše do activity logu faktury včetně IP a user-agenta.

10.8 Zálohová faktura → daňový doklad

Workflow:

1. Vystavíš zálohovou (proforma) — variabilní symbol 9NNNNNN, status issued, žádné DUZP.
2. Klient zaplatí — banka spáruje (nebo manuálně označíš jako paid).
3. Klikneš Vystavit daňový doklad (tlačítko v detailu zálohové).
4. Vytvoří se daňový doklad typu „Faktura" s automatickým odečtem zaplacené zálohy (záporná položka „Odpočet zálohy 92605001").

10.9 Storno vs. dobropis

Pokud zjistíš, že vystavená faktura je špatně:

• Storno (interní) — pouze interní označení, faktura zmizí ze statistik jako „neexistuje". Klientovi se nic neposílá. Použij, když jsi fakturu ještě neposlal a nechceš ji v evidenci.
• Dobropis (opravný daňový doklad) — vystavíš nový doklad se zápornými položkami, který klientovi pošleš jako oficiální opravu. Účetně správné, ale vyžaduje, abys měl s klientem komunikaci o tom, co a proč.

10.10 Tipy

• Vždy uložené jako koncept — Ctrl+S kdykoli uloží rozpracovanou fakturu.
• Klonování zachová položky i výkaz víceprací — datum se aktualizuje na dnešní, popis položky inkrementuje měsíc.
• Sleva v procentech se počítá z mezisoučtu před DPH.
• Reverse charge automaticky nastaví všechny položky na sazbu „RC" (0 %) a v PDF přidá text „Daň přiznává odběratel".
• PDF náhled konceptu má vodoznak „NÁHLED" přes celou stranu — klient si ho spletl s vystavenou fakturou by neměl.