RFC-016: §6 Employment Income (DPČ/DPP/HPP) with OCR

[zajca]

Summary

• Adds plan (RFC-016) for full §6 employment income support in DPFO -- DPČ, DPP, HPP -- with OCR extraction from "Potvrzení o zdanitelných příjmech" (form 25 5460 vzor 33) and "Potvrzení o vyplacených příjmech a sražené dani" (25 5460/A vzor 12)
• Fills already-existing XSD attributes (kc_prij6, kc_zd6, kc_dan_zah, kc_zalzavc, kc_sraz_6_4, potv_zam/potv_36/potv_dazvyh) -- no schema invention
• Fixes hardcoded assumption in internal/annualtaxxml/income_tax_gen.go:210 (// ř.42 -- assumes §6 employment base = 0)
• All field meanings cross-checked against DPFO 2025 vzor 33 official pokyny (financnisprava.gov.cz) and the local docs/xml-schemas/epo/dpfdp7_epo2.xsd

Verified corrections vs. initial draft

Initial assumption	Verified fact
ř.32 = úhrn povinného pojistného	ř.32 is "Neobsazeno" in vzor 33; superhrubá mzda zrušena 2021 (zákon 609/2020 Sb.)
ř.34 = ř.31 + ř.32	ř.34 = ř.31 − ř.33 (foreign tax only)
Sražené zálohy = ř.16 Potvrzení	ř.8 Potvrzení vzor 33 (per XSD doc on kc_zalzavc)
Sleva na poplatníka snížit při měsíčním uplatnění	Vždy plná 30 840 Kč/rok -- rozdíl jde přes ř.84 → ř.91

Scope highlights

• DB migration 027 (employment_documents, employment_income_certificates, §6 columns on income_tax_returns)
• New service EmploymentCertificateService with upload + OCR + validation pipeline
• New OCR prompt distinguishing advance vs. withholding Potvrzení
• New page /tax/employment with dual upload tiles, modal editor with confidence display
• 4th card on /tax, read-only §6 panel on income return detail
• 13 new help topics covering DPČ/DPP, both Potvrzení variants, each affected DAP row, and superhrubá mzda explanation
• §16a separate base (>36× avg wage) explicitly out of MVP -- emits warning instead

Test plan

• Review the data model (migration 027) for soundness, especially the ON CONFLICT REPLACE choice on the UNIQUE clause
• Confirm the §6 row mapping against the live EPO portal validator before implementation begins
• Verify §6 + §7 ztráta combination — kc_zakldan23 = kc_zd6 per XSD critical control
• Confirm "include withholding in DAP" UX wording vs. § 38g odst. 6 ZDP requirement to include all such income
• Decide on the three open questions in the RFC (UNIQUE conflict policy, DPP threshold warning, OCR vendor neutrality)

References

• Pokyny DPFO 2025 vzor 33
• Vyhláška 386/2025 Sb.
• Local: docs/xml-schemas/epo/dpfdp7_epo2.xsd
• Related RFCs: 006 (annual tax base), 007 (§15 OCR), 012 (calc extraction)

[zajca]

Review feedback addressed (v2 commit f8968a7)

Accepted (fixed in RFC):

• K2 — Vyplacený měsíční bonus přemapován z chybně přiřazeného ř.76 na ř.89 (kc_vyplbonus). Ř.76 je computed = ř.72 − ř.73 (nárok na bonus po uplatnění daně), nemá s výplatou nic společného.
• K3 — Odstraněn chybný kód itr.ChildBenefit -= itr.Section6MonthlyBonusPaid. Způsoboval by dvojí započtení: vyplacený bonus je samostatná hodnota na ř.89, ChildBenefit (ř.72) zůstává plně vypočtený existující logikou.
• K4 — foreign_income přejmenováno na income_without_advance ve všech vrstvách (DB sloupec, doménové pole, JSON output, UI label). Ř.35 zahrnuje i §38c (zahraniční zastup. úřady v ČR), nejen zahraniční zdroje.
• §16 vs §16a — Progresivní 23 % je v § 16 odst. 1 ZDP, ne v §16a. §16a je samostatný institut Přílohy 4 (vybrané zahraniční příjmy). WarningSection16aManual přejmenován na WarningProgressiveRateReview, terminologie napříč RFC i help-content opravena.
• Lhůta vystavení Potvrzení — § 38j odst. 3 ZDP říká "do 10 dnů od podání žádosti", ne "do 1. března". Help-content potvrzeni-zalohove a zavisla-cinnost-s6 opraven.
• OCR prompt — monthly_bonus_paid_czk se extrahuje jako ř.5 + ř.13 Potvrzení vzor 33 (potvrzeno oficiálními pokyny 2025 str. 4 a XSD docstringem na kc_vyplbonus), ne jen ř.13.

Push-back na K1 (ř.32) — ponecháno bez změny:

Pokyny FS 2025 vzor 33 explicitně říkají "ř. 32 Neobsazeno" (PDF str. 2, citace z bodu K2 oddílu). Pokyny pro ř.31 zároveň instruují, že srážkové příjmy zahrnuté do DAP "jste povinen uvést veškeré tyto příjmy do ř. 31" — tedy jdou do ř.31, ne ř.32.

Stale text v XSD docstringu na kc_prij6 ("do ř. 32") je dědictví z předchozích vzorů, kde ř.32 měl jiný význam. Mapování XML je jednoznačné — kc_prij6 reprezentuje ř.31, žádný atribut pro ř.32 v XSD neexistuje. RFC tabulka tuto nesrovnalost teď explicitně dokumentuje.

Pokud máte odlišné čtení pokynů 2025 vzor 33 (např. jiná verze než ta z financnisprava.gov.cz), pošlete prosím odkaz a citaci — rád to znovu ověřím.

[zajca]

v3 review feedback addressed (commit 8e17f0e)

• N1 — Test description "monthly bonus subtraction from child benefit" → "ChildBenefit zůstává nezměněn i když MonthlyBonusPaid > 0 (regression for K3)". Doplněn nový test TestIncomeTaxXML_BonusReportedSeparately ověřující, že ř.72/76 a ChildBenefit se nemění při ne-nulovém kc_vyplbonus.
• N2 + N7 — "doplatek z RZ z ř.19" odstraněno z tabulky. Ř.19 v Potvrzení vzor 33 neexistuje; doplatek z ročního zúčtování je obsažen v ř.13 (per XSD doc na kc_vyplbonus).
• N4 — Frontend sekce na detail income return řádek ř.76 → ř.89.
• N5 — Section6CertsBonus++ v Recalculate odstraněn s vysvětlujícím komentářem. potv_dazvyh reflektuje počet samostatných formulářů "Potvrzení o vyplaceném daňovém bonusu" (EmploymentDocument.Kind=bonus), ne advance certifikátů s vyplaceným bonusem. V MVP zůstává 0; samostatný upload UI pro tento formulář je explicitně v Out of Scope.
• N6 — "§16a limit warning" → "§16 progressive rate warning when totalBase > 36× průměrná mzda".
• Integration test: potv_dazvyh=1 → potv_dazvyh=0 (důsledek N5).

[zajca]

v4 (commit efaa2a2): Q7/Q8 fix — kc_zd6p v tabulce XSD atributů sjednoceno na "§38f / Příloha 3" (alokace §6 portionu pro zápočet zahraniční daně), s explicitní poznámkou, že nesouvisí s §16a ani s progresivní sazbou §16 odst. 1. Drobné — vnitřní rozpor mezi tabulkou a Legislative notes / XML generátorem opraven.