10. Přijaté faktury (nákupy)

Přidáno v3.5.0 jako součást fáze 1 integrace forku myinvoiceDph (Martin Říha).

Přijaté faktury jsou doklady, které dostáváš od svých dodavatelů — peníze odcházejí z firmy. Oproti vystaveným fakturám:

V hlavním menu Přijaté faktury.

10.1 Stavy přijaté faktury

Smazat jde jen koncept. Pro pozdější stavy použij Stornovat (zachová auditní stopu).

10.2 Nová přijatá faktura

V seznamu klikni + Nová přijatá faktura. Otevře se formulář.

10.2.1 Drag & drop PDF

Nad formulářem je drag & drop zóna. Pokud máš PDF od dodavatele:

• Přetáhni PDF do zóny (nebo klikni a vyber soubor).
• Systém prohledá PDF zda obsahuje embedded ISDOC přílohu:
• Pokud ano (fakturační software jako Money S3, Pohoda, Stormware, sám MyInvoice) → pole formuláře se předvyplní strukturovanými daty.
• Pokud ne (běžné PDF bez přílohy) → ve fázi 1 musíš vyplnit ručně. Ve fázi 2c (plánováno) doplníme AI extrakci přes Anthropic Claude — viz source/09-fork-integration-plan.md.
• Originál PDF se po prvním uložení faktury automaticky archivuje mimo webroot a v detailu si ho můžeš kdykoli stáhnout zpět.

💡 *Od v4.9.0:* doklad jde nahrát už při zakládání nové faktury (po přetažení se ukáže kartička „soubor připraven, nahraje se po uložení") i z detailu faktury, která zatím doklad nemá — dřív to šlo jen v editaci. Kromě PDF lze přetáhnout i fotku (JPG/PNG/WEBP/HEIC), systém ji převede na PDF.

Limity:

• Max 20 MiB per soubor
• Akceptujeme pouze application/pdf (magic bytes %PDF- se ověřují server-side)
• SHA-256 deduplikace — stejný PDF už archivovaný u jiné faktury nebude akceptován

10.2.2 Povinná pole

10.2.3 Položky

Tlačítkem + Přidat položku přidej řádek. Per řádek:

• Popis
• Množství (např. 1)
• Měrná jednotka (ks / hod / kus…)
• Cena za MJ bez DPH
• Sazba DPH (z číselníku — 21 % / 12 % / 0 %)
• (volitelně) MFČR DPH klasifikační kód — pro výkazy DPH (sekce Daně, auto-default podle sazby)

Souhrn dole se přepočítá automaticky po každé změně.

💡 Ceny „s DPH" (brutto režim) *(od v4.7.0)* — přepínačem Ceny zadávám s DPH (u DPH v hlavičce) lze zadat položky včetně DPH (typicky účtenka / paragon), takže celková částka sedí na haléř. DPH se pak počítá „shora" koeficientovou metodou (§37 ZDP). Zadání ceny do sloupce „Celkem s DPH" respektuje aktuální režim (nepřepíná ho); jednotková cena se v detailu i PDF zobrazuje jako netto. Funguje stejně jako u vystavených faktur — viz § 11.2.6. AI import účtenek režim nastaví sám.

10.2.4 Daňová uznatelnost a nárok na odpočet

V boxu Klasifikace jsou dva nezávislé příznaky řídící, jak faktura vstupuje do daňových výkazů:

• Nárok na odpočet DPH:
• Plný (výchozí) — standardní odpočet, faktura jde do Knihy DPH, DPHDP3 (ř. 40–45) i Kontrolního hlášení.
• Bez nároku — faktura vůbec nevstupuje do DPH evidence (Kniha DPH, DPHDP3, KH); je to jen účetní náklad. Typicky reprezentace, osobní spotřeba.
• Krácený (poměrný §75) — odpočet jen v poměrné výši (např. auto 70 % pro ekonomickou činnost). Po výběru zadáš Odpočet % a o toto procento se zkrátí základ i daň odpočtu v Knize DPH a DPHDP3 (ř. 40–45); zbytek je nedaňová část.
• Daňově uznatelný náklad — řídí pouze daň z příjmů: když je vypnuto, náklad se nezahrne do orientačního hospodářského výsledku (DPFO/DPPO). S DPH to nesouvisí (faktura může mít odpočitatelné DPH a být daňově neuznatelná, i naopak).

Oba příznaky jsou vidět i v detailu přijaté faktury (box Měna/DPH).

💡 Interní číslo se řídí daňovým typem. Prefix automaticky generovaného interního čísla (viz 10.2.2) odpovídá těmto dvěma příznakům — PF/PN plný nárok (uznatelný/ne), KU/KN krácený §75, NU/NN bez nároku. Když u už očíslované faktury daňové uplatnění změníš, přepíše se jen prefix (PF2602001 → NN2602001); číselná řada {YYMM}{CCC} i ručně zadaná čísla zůstanou. Počítadlo je sdílené per dodavatel a měsíc napříč všemi prefixy, takže čísla jsou v rámci měsíce souvislá bez ohledu na daňový typ; případné mezery po smazaných konceptech jsou u interního označení neškodné (na rozdíl od vystavených faktur se u přijatých dokladů souvislá řada nevyžaduje).

Rekapitulace DPH dle dokladu (§ 73 ZDPH)

Přidáno ve v4.9.0.

Pod položkami je box Rekapitulace DPH se základem a daní za každou sazbu. Hodnoty se dopočítají ze řádků, ale pokud doklad dodavatele uvádí kvůli zaokrouhlení jiný základ nebo DPH, můžeš je přepsat přesně podle dokladu. Důvod je daňový: nárok na odpočet je svázaný s částkou daně uvedenou na dokladu (§ 73 odst. 6 ZDPH), proto je primární shoda s dokladem, ne náš přepočet.

• Přepsat lze základ i DPH, samostatně pro každou sazbu. Ručně upravené pole je zvýrazněné; odkaz Spočítat automaticky vrátí vypočtenou hodnotu.
• Override se uloží do faktury a promítne se konzistentně do DPH přiznání, kontrolního hlášení, knihy DPH i do daně z příjmů a daňového optimalizátoru.
• Při AI importu se rekapitulace předvyplní automaticky dle dokladu (pro jednu i více sazeb), pokud sedí v toleranci.
• Box se nezobrazuje u reverse-charge (na dokladu zahraničního dodavatele není česká DPH).

Dodavatel neplátce DPH → bez nároku na odpočet

Přidáno v4.7.0.

Pokud je dodavatel neplátce DPH, na jeho dokladu žádná DPH není a není co odpočítat — uplatnit odpočet by byla daňová chyba (neoprávněný odpočet v ř. 40 přiznání / sekci B kontrolního hlášení). MyInvoice proto plátcovství dodavatele sleduje a vynucuje:

• Zjištění plátcovství — autoritativně z ARES podle IČO (CZ), u zahraničních EU subjektů z VIES podle DIČ. Ověří se online při výběru / editaci dodavatele ve formuláři (výsledek se cachuje 24 h).
• Volba v editoru — pod checkboxem „Reverse charge" je přepínač „Dodavatel je plátce DPH". Nastaví se automaticky podle ARES/VIES, ale můžeš ho vědomě přepsat.
• Vynucení u neplátce — když je dodavatel neplátce, faktura se automaticky nastaví na Nárok na odpočet = Bez nároku (vat_deduction='none'), sazby řádků se vynulují na 0 % a zobrazí se varování. Doklad pak do DPH evidence nevstupuje (je to jen účetní náklad). Override je možný.
• AI import — extraktor plátcovství ověří a u neplátce (signál „DIČ: Neplátce DPH" / žádné DIČ + žádná DPH na řádcích, případně ARES) odpočet automaticky zakáže a doplní varování (viz § 10.7).

Plátcovství dodavatele je vidět i ve výpisu klientů/dodavatelů jako badge *Plátce DPH* (viz § 7.1).

🛠️ Zpětná oprava existujících dodavatelů — po upgradu na v4.7.0 jednorázově spusť php api/bin/backfill-vendor-vat-payer.php. Skript podle ARES/VIES doplní příznak plátcovství a u neplátců opraví už zaevidované přijaté faktury (zakáže odpočet, sazby na 0 %, celková částka beze změny). Výchozí běh je dry-run (jen náhled); zápis až s --apply.

10.2.5 Platba v jiné měně (multi-currency)

Klikni na „Platba v jiné měně než měna faktury" pokud máš tento scénář:

Faktura je v USD ($1000), ale platíš ji z CZK účtu (banka konvertuje na ~24 500 Kč s 1–2% spread / poplatkem).

V tomto bloku zadáš:

• Měna platebního účtu (např. CZK)
• Kurz platba → měna faktury (např. 0.0408 USD/CZK, nebo opačně dle UI)
• Kolik reálně odešlo z účtu (24 500 CZK)

Systém automaticky vypočte:

• Ekvivalent v měně faktury — pro spárování proti amount_to_pay
• Kurzový rozdíl — v základní měně (CZK). Záporný = kurzová ztráta, kladný = zisk. Zatím se zaznamenává pro reporting; účetně se v fázi 6 (DPH výkazy) automaticky promítne do správných řádků.

10.2.6 Reverse charge z EU — pořízení zboží vs. služba

Od v4.16.0 (issues #116, #117).

Typický případ: nákup zboží od EU dodavatele (např. auto z Německa) — doklad je vystaven bez DPH (osvobozené intrakomunitární dodání) a daň si samovyměříš v ČR. Správné zaevidování:

Klíčové principy:

• Sazba 0 % na řádku je chyba — samovyměření by vyšlo nulové. Sazba na řádku je *nominální* (daň na dokladu zůstává 0, částka k úhradě se nemění), výkazy z ní dopočítají samovyměřenou daň i zrcadlový odpočet. Pojistka: pokud řádek s RC klasifikací přesto sazbu nemá, výkazy použijí sazbu klasifikačního kódu (21 %).
• Doklad se do DPH období zařadí podle DUZP — povinnost přiznat daň vzniká k DUZP bez ohledu na to, kdy faktura fyzicky dorazila (§ 25 odst. 1), a pozdní doklad neblokuje ani odpočet (§ 73 odst. 1 písm. b — nárok lze prokázat jiným způsobem, např. protokolem o převzetí + smlouvou + platbou). Pozdě vystavená faktura za zboží převzaté v dubnu tak patří do května (DUZP 15. 5.), ne do měsíce vystavení.
• Kurz ČNB se váže k DUZP (§ 4 odst. 8 — den vzniku povinnosti přiznat daň).
• AI import tohle vše nastaví sám — viz § 10.7.

⚠️ U vybraných osobních automobilů pohlídej limit odpočtu dle § 72 (strop základu 2 000 000 Kč / DPH 420 000 Kč) — aplikace ho nehlídá.

10.3 Detail přijaté faktury

Po uložení / přechodu na detail:

• Vidíš dodavatele (s IČO/DIČ), datumy, položky, DPH rozpis, totály, K úhradě.
• Sekce Originální PDF od dodavatele — pokud jsi nahrál, můžeš stáhnout zpět.
• Tlačítka pro přechod stavu podle state-machine:
• Z draft: Označit jako přijaté / Stornovat
• Z received: Označit jako zaúčtované / uhrazené / Stornovat
• Z booked: Označit jako uhrazené / Stornovat
• Tlačítko Upravit je dostupné jen u draft. Po označení jako přijatá je doklad immutable (kromě admin override ?force=1 u received).
• Tlačítko Smazat je dostupné jen u draft. Pro pozdější stavy použij Stornovat.

10.3.1 Propojení zálohy s vyúčtovací fakturou (proti dvojímu započtení)

Přidáno v4.3.11.

Když ti dodavatel pošle nejdřív zálohovou fakturu (typ dokladu *Záloha* / proforma) a po zaplacení samostatnou vyúčtovací (finální) fakturu, máš v systému dva doklady na tentýž náklad. Bez propojení by se náklad počítal dvakrát (Náklady, CRM, daň z příjmů). Proto je lze spárovat.

Jak na to — v detailu finální faktury je box Zálohová faktura:

• Pokud vazba není, klikni Spárovat se zálohou a vyber zálohu od stejného dodavatele. Nabídka řadí napřed zálohy ve stejné měně a s nejbližší částkou (porovnává hrubou částku faktury *před* odečtem zálohy, takže i faktura uhrazená zálohou „na 0 Kč" se napáruje správně).
• Po spárování se zobrazí odkaz na zálohu a tlačítko Zrušit propojení. Na finální fakturu se zároveň doplní odečet zálohy (advance_paid_amount), pokud byl nulový.
• V detailu zálohy vidíš reverzně, kterou fakturou je vyúčtována. Nevyúčtovanou zálohu lze spárovat i odtud — tlačítkem Spárovat s fakturou (nabídne nepropojené vyúčtovací faktury téhož dodavatele). *(Obousměrné párování přidáno ve v4.8.0; tlačítka se zobrazí jen když existuje vhodný protějšek.)*

Jedna záloha může být navázaná jen na jednu finální fakturu.

Co propojení (a zaplacení) ovlivní:

AI návrh propojení — když naimportuješ vyúčtovací fakturu přes AI extrakci z PDF (viz 10.7) a ta odkazuje na zálohu (text typu *„zaplaceno zálohou č. X"*), systém zkusí najít odpovídající zálohu a v detailu nabídne návrh propojení. Stačí ho Potvrdit (nebo Zamítnout) — nic se nepáruje automaticky.

10.4 Scan inbox — automatický import z adresáře

Pokud máš dodavatele kteří ti posílají PDF e-mailem nebo máš složku sdílených dokladů, nakonfiguruj inbox adresář v cfg.php:

'purchase_invoice' => [
    'inbox_dir'         => 'C:/inetpub/wwwroot/myinvoice.cz/inbox',
    'inbox_recursive'   => true,
    'allowed_exts'      => ['pdf', 'isdoc', 'xml'],
    'archive_storage'   => __DIR__ . '/storage/purchase-invoices',
],

V seznamu Přijaté faktury klikni 📥 Nascanovat inbox:

• Systém rekurzivně projde nakonfigurovaný adresář.
• Pro každý soubor spočte SHA-256 — pokud už existuje faktura se stejným otiskem, soubor přeskočí.
• Z PDF s embedded ISDOC rozpozná data dodavatele a obsah.
• Plain PDF (bez ISDOC) jsou ve fázi 1 přeskakovány (s důvodem „AI extrakce dorazí v fázi 2c").

Modal po skončení zobrazí přehled: vytvořeno / přeskočeno / chyby + per-soubor detail.

Bezpečnost: soubory mimo configured inbox_dir jsou odmítnuty (path traversal guard přes realpath()). Maximum 500 souborů per běh (DoS protection na velké adresáře).

10.5 Klienti vs. dodavatelé

V tabulce klientů jsme zavedli dva flagy:

• is_customer — klient, kterému fakturuješ (default 1 pro všechny existující záznamy)
• is_vendor — dodavatel, od kterého přijímáš faktury

Některé firmy jsou současně zákazník i dodavatel (např. partnerská IT firma, kterou fakturuješ za development a od níž kupuješ hosting) — jedna entita = jedna řádka, oba flagy = 1. ARES synchronizace, kontakty, historie jsou sdílené.

V hlavním menu Klienti vidíš defaultně jen is_customer=1. V budoucí verzi přidáme oddělený view Dodavatelé pro is_vendor=1.

10.6 Export přijaté faktury (naše PDF / ISDOC / Pohoda)

V detailu přijaté faktury najdeš tlačítko „Exporty" s dropdown menu:

Naše PDF (rekonstrukce)

Vygeneruje naši vlastní PDF kopii ze strukturovaných dat. Užitečné když:

• Importovaly se jen metadata (z iDokladu/Fakturoidu API, ne originální PDF)
• Originál není dostupný (přijatá faktura zadaná ručně)
• Potřebuješ čitelný PDF pro účetní archiv

PDF obsahuje hlavičku s dodavatelem, položky, totals, poznámky. Footer poznámka: *„Naše rekonstrukce přijaté faktury z dat v MyInvoice.cz. Originál od dodavatele je referenční dokument."*

ISDOC XML

Export do ISDOC 6.0 standardu — kompatibilní s Pohoda, Money S3, iDoklad a dalšími. Strategie: role inversion — v ISDOC pro přijatou fakturu je *dodavatel* = původní vendor, *zákazník* = naše firma (opak vystavené).

Pohoda XML

Pohoda dataPack XML pro import do účetního software Pohoda. Direction = purchase (<pur:purchase> místo <inv:invoice>).

Hromadný export za měsíc

V hlavním menu Přijaté faktury → Exporty vyber měsíc + formát:

• PDF ZIP — preferuje archivovaný originál od dodavatele (Prijata-{vs}-{vendor}.pdf); pokud originál chybí, doplní se naše rekonstrukce z dat faktury (…-rekonstrukce.pdf, ať ji účetní pozná). Faktura se přeskočí jen když selže i rekonstrukce.
• ISDOC ZIP — jeden .isdoc XML soubor za fakturu, sbaleno do ZIP.
• Pohoda XML — sloučený <dataPack> se všemi fakturami za měsíc (přímý import do Pohody, direction = purchase).

„Datum dle" volí, podle kterého data se faktura zařadí do měsíce: DUZP (tax), datum vystavení (issue, default) nebo datum přijetí (received).

10.7 AI extrakce — kontrola výsledků

Při AI extrakci z PDF se po importu automaticky spustí sanity check: sečtou se řádky bez DPH a porovnají s celkovým základem daně, který AI přečetla z PDF „K úhradě". Pokud se hodnoty liší o víc než 2 %, faktura získá flag „Ke kontrole" a uživatel by měl řádky před zaúčtováním ověřit.

Indikátory v UI

• Žluté zvýraznění řádku + ikona ⚠ vedle čísla faktury v seznamu přijatých faktur (/purchase-invoices).
• Filtr „Ke kontrole" v topbaru seznamu — zobrazí jen faktury, kde je flag aktivní.
• Žlutý warning banner v detailu i editoru faktury s diagnostickým textem (např. *„součet řádků bez DPH (XX) je vyšší než AI-vrácený základ daně bez DPH (YY) — rozdíl Z %"*).

Jak zrušit warning

• Tlačítko Beru na vědomí v banneru — pošle POST /api/purchase-invoices/{id}/dismiss-extraction-warning a flag se smaže.
• Automaticky při přechodu z draftu na další stav (received / booked / paid) — uživatel posunul stav = ověřil data.

Auto-upgrade modelu

Pokud levnější model (Haiku 4.5) vrátí slabý výsledek (vendor se shoduje s tenantem nebo součet řádků se výrazně liší od totalu), extractor automaticky zkusí znovu se silnějším modelem (Sonnet 4.6, ~4× dráž za extract). Pokud máš Sonnet/Opus jako default, retry se přeskočí.

Katastrofální mismatch — placeholder

Když ani silnější model nezvládne rozparsovat řádky (typicky komplexní multi-column servisní faktury) a součet řádků se liší od totalu o víc než 50 %, extractor:

1. Zachová popisy řádků z AI extraktu (jsou obvykle správně)
2. Vynuluje jejich qty a unit_price (0)
3. Přidá první řádek KOREKCE s AI totalem z „K úhradě", aby seděl celkový součet faktury

Uživatel pak postupně doplní qty/cenu k jednotlivým řádkům a nakonec smaže korekční řádek.

Backfill existujících faktur

CLI skript php api/bin/recheck-ai-extracted-invoices.php projde přijaté faktury s PDF přílohou, re-spustí AI extrakci a porovná AI total s aktuálním DB totalem. Při rozdílu nad práh (default 2 %) zapíše varování:

php api/bin/recheck-ai-extracted-invoices.php                    # dry-run
php api/bin/recheck-ai-extracted-invoices.php --apply            # zápis
php api/bin/recheck-ai-extracted-invoices.php --supplier-id=1
php api/bin/recheck-ai-extracted-invoices.php --threshold=0.05

Dodavatel neplátce DPH

Přidáno v4.7.0.

Při AI importu se ověří plátcovství dodavatele (ARES/VIES, případně signál z dokladu „DIČ: Neplátce DPH"). U neplátce se automaticky nastaví Bez nároku na odpočet, vynulují sazby a doplní varování — aby se neoprávněný odpočet nedostal do přiznání. Detail viz § 10.2.4.

Reverse charge ze zahraničí — automatika

Od v4.16.0 (issue #116).

Když extraktor detekuje reverse charge (zahraniční dodavatel + všechny řádky bez DPH), doklad automaticky daňově připraví:

• AI klasifikuje povahu plnění (zboží / služba) přímo z dokladu (VIN a vozidlo → zboží; SaaS, licence, API → služba).
• Položky dostanou tuzemskou sazbu 21 % a klasifikační kód: 23 (zboží z EU → ř. 3 + ř. 43, KH A.2), 24 (služba), 25 (zboží ze 3. země). Částka k úhradě se nemění — daň zůstává na dokladu nulová, samovyměří se až ve výkazech.
• U pořízení zboží z EU se dopočítá zákonné DUZP dle § 25 (15. den měsíce po dodání, pokud doklad nebyl vystaven dříve) a k němu se naváže kurz ČNB — pozdě vystavená faktura tak spadne do správného DPH období.
• Do dokladu se zapíše informační varování s rekapitulací, co se nastavilo — zkontroluj hlavně zboží vs. služba a případně změň kód (23 ↔ 24).

Detail daňové logiky viz § 10.2.6.

10.8 Audit log

Akce s přijatými fakturami jsou logované v aktivním logu (Systém → Log):

• purchase_invoice.created
• purchase_invoice.updated / force_updated
• purchase_invoice.items_updated
• purchase_invoice.exchange_rate_set
• purchase_invoice.transitioned (s payloadem {from, to})
• purchase_invoice.extraction_warning_dismissed
• purchase_invoice.advance_linked / advance_unlinked (propojení se zálohou)
• purchase_invoice.advance_suggestion_dismissed (zamítnutý AI návrh propojení)
• purchase_invoice.deleted
• purchase_invoice.pdf_uploaded / pdf_downloaded
• purchase_invoice.our_pdf_downloaded
• purchase_invoice.isdoc_exported / pohoda_exported
• purchase_invoice.inbox_scanned

10.9 REST API

Všechny operace jsou dostupné i přes REST API (/api/v1/purchase-invoices/*) — viz Swagger UI nebo Redoc. PAT token musí mít scope read_write pro mutace.

10.10 Status integrace forku

Všechny fáze plánu jsou dokončeny:

• ✅ Fáze 1 (v3.5.0) — základní CRUD přijatých faktur, PDF upload + inbox scan
• ✅ Fáze 2a (v3.6.0) — iDoklad API import (OAuth + jobs + dobropisy + attachments)
• ✅ Fáze 2b — Fakturoid import (BasicAuth + subjects + invoices + expenses)
• ✅ Fáze 2c — AI extrakce z PDF (Anthropic Claude vision, BYOK)
• ✅ Fáze 3 (v3.7.0) — bank matching CSV + auto-match (vystavené + přijaté)
• ✅ Fáze 5 — CRM dashboard (revenue/costs/profit/aging/DSO/concentration/churn)
• ✅ Fáze 6 (v4.0.0) — VAT klasifikace + tax settings + DPHDP3/KH/SH/DPFO/DPPO XML výkazy + Naše PDF + ISDOC/Pohoda export přijatých

Detail viz source/09-fork-integration-plan.md.