Kontrola DPH období řeže datum v UTC — platba 1. dne měsíce „spadne“ do předchozího měsíce
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Zálohová faktura vystavená 1. dne měsíce byla týž den zaplacena, platba se spárovala, ale daňový doklad k přijaté platbě (DD) nevznikl. V logu:
DD pro ZF-… NEVYSTAVEN: datum přijaté platby (2026-08-31) je v dřívějším DPH obdobínež datum vystavení zálohové faktury (2026-09-01)Při dokončení zakázky pak systém vystavil obyčejnou fakturu na plnou částku místo vyúčtovací faktury s odpočtem zálohy — a odeslal ji klientovi.
Root cause
Sekce “Root cause”- Bankovní API vrací datum transakce bez času (
2026-09-01+0200).new Date()z něj udělá lokální půlnoc =2026-08-31T22:00:00Z. Validace porovnávalapaymentDate.toISOString().slice(0, 10)(UTC!) s datem ZF →2026-08<2026-09→ blok. Projeví se jen u plateb 1. den měsíce k ZF z téhož dne, takže většina dokladů prošla a chyba zůstala týdny skrytá (alert existoval, nikdo ho neřešil). - Volba typu finální faktury (
VYUCTOVACIvsFAKTURA) se řídila jen existencí DD. Chybějící DD ⇒ tiše „bez záloh“ ⇒ faktura bez odpočtu.
Fix
Sekce “Fix”- Den z
Datevýhradně přes helperpragueDay(d)=Intl.DateTimeFormat("en-CA", { timeZone: "Europe/Prague", … })ve všech třech validacích (auto-párování, ruční DD, akce smlouvy). - Ruční dovystavení DD má datum = den přijetí platby (DUZP), ne „dnes“ (volitelný override pro opravné skripty).
- Fail-closed: zaplacená ZF bez DD ⇒ finální faktura se nevystaví, uživatel dostane pokyn vystavit DD, při automatickém dokončení vznikne trvalý alert.
- Testy s reálnými časy: ZF vznikla v poledne, platba má lokální půlnoc, obojí 1. den měsíce.
Jak poznat
Sekce “Jak poznat”grep "NEVYSTAVEN"v logu jen u datYYYY-MM-01.- Dotaz: zaplacené ZF bez potomka typu DD, všechny s datem platby 1. dne měsíce.
Poučení
Sekce “Poučení”Server v lokální TZ nic nezachrání — toISOString() je vždy UTC. A fail-closed validace bez eskalace alertu se časem změní v „tiše chybějící doklad“; navazující automatiky musí na chybějící povinný doklad reagovat zastavením, ne degradací.