l10n_sk_partner/CLAUDE.md

l10n_sk_partner — Slovak Tax IDs for Odoo 19.0

Účel modulu

Modul pridáva slovenské daňové identifikátory na kontakty a faktúry:

• IČO (company_registry) — 8 číslic, natívne pole Odoo, label prepísaný na "IČO" pre SK krajinu
• DIČ (dic) — vlastné pole, 10 číslic
• IČ DPH (vat) — štandardné Odoo pole, validácia formátu SK + 10 číslic

Štruktúra

l10n_sk_partner/
├── models/
│   ├── res_partner.py      # Pole dic, is_vat_payer, validácie, label IČO
│   └── res_company.py      # Sync dic → income_tax_id pri uložení firmy
├── views/
│   └── res_partner_views.xml   # Pole dic a is_vat_payer na formulári partnera
├── report/
│   └── report_layout_sk.xml    # Prázdny, opravy sa robia cez migration scripty
├── migrations/
│   ├── 19.0.2.0.4/post-migrate.py  # Oprava šablón faktúr (IČO/DIČ pre odberateľa)
│   ├── 19.0.2.0.5/post-migrate.py  # Skrytie natívneho VAT t-if bloku v external_layout pre SK
│   └── 19.0.2.0.6/post-migrate.py  # Oprava VAT t-else bloku (zostatok po 2.0.5)
└── hooks.py                # post_init_hook — oprava l10n_sk.vat_registry_tax_id_external_layout

Kľúčové rozhodnutia

Prečo migration scripty miesto XML pohľadov

Moduly l10n_sk a web definujú šablóny faktúr ako databázové záznamy (ir.ui.view). Štandardný inherit_id v XML spôsoboval problémy (duplicitné bloky, zlý rendering). Riešenie: priame prepísanie arch_db cez SQL v migration scriptoch.

• hooks.py → oprava l10n_sk.vat_registry_tax_id_external_layout (blok IČO/DIČ firmy)
• migrations/19.0.2.0.4 → oprava l10n_sk.report_invoice_document (IČO/DIČ odberateľa)
• migrations/19.0.2.0.5 → skrytie natívneho VAT t-if bloku v web.external_layout_* šablónach pre SK
• migrations/19.0.2.0.6 → oprava VAT t-else bloku (2.0.5 opravila t-if, ale t-else zostal — renderoval prázdny "IČ DPH:" riadok)

Podmienka zobrazovania

Všetky bloky IČO/DIČ sa zobrazujú len keď company.account_fiscal_country_id.code == 'SK' alebo company_id.country_code == 'SK', takže modul neovplyvňuje zahraničné lokalizácie.

Validácie

Pole	Formát	Constraint
company_registry (IČO)	presne 8 číslic	_check_ico
dic (DIČ)	presne 10 číslic	_check_dic
vat (IČ DPH)	SK + 10 číslic	_check_sk_vat (len pre SK krajinu)

Automatické správanie

• _onchange_vat_fill_dic — pri zadaní IČ DPH automaticky vyplní DIČ (bez SK prefixu), ak je prázdne
• is_vat_payer — computed field, True ak vat začína SK
• res_company.write() — pri každom uložení firmy syncuje partner.dic → company.income_tax_id

Závislosti

• contacts — základná správa kontaktov
• account — modul faktúr
• l10n_sk — slovenská lokalizácia (definuje šablóny, ktoré tento modul opravuje)

Nasadenie

Modul je nasadený na produkčnom serveri 10.10.10.240, databáza seri_db.

Po aktualizácii modulu spustiť:

# Na serveri
odoo -d seri_db -u l10n_sk_partner --stop-after-init

Migration scripty sa spustia automaticky pri upgrade keď sa zmení verzia v __manifest__.py.

Časté problémy

Duplicitný IČ DPH na faktúre — vyriešené v migrations/19.0.2.0.5 + 19.0.2.0.6. 2.0.5 zmenila t-if="not forced_vat" na t-if="not forced_vat and country != SK", ale t-else zostal a renderoval prázdny "IČ DPH:" riadok. 2.0.6 zmenila tento t-else na t-if="forced_vat and country != SK". Ak sa objaví znovu po reinstalácii web modulu, treba zvýšiť verziu a upgradovať modul.

Pozor na \\n v JSON texte pri migration scriptoch — arch_db::text obsahuje newline ako literálne \n (2 znaky: backslash + n), nie skutočný newline. V regex to treba matchovať ako \\n, v replace() ako Python string '\\n' (= \\ + n). Práve preto zlyhala 2.0.5 — použila Python '\n' (skutočný newline) v regex patternu. Riešenie v 2.0.6: replace() s _NL = '\\n'.

Rôzna indentácia v external_layout šablónach — VAT blok má rôzny počet medzier po \n podľa layoutu: standard/bold/folder/striped/wave = 28, boxed = 32, bubble = 40. Pri replace() treba použiť správny počet medzier pre každý layout.

hooks.py vs migration script — post_init_hook sa spustí len pri prvej inštalácii. Pre opravy existujúcich inštalácií treba migration script s vyššou verziou.