Přeskočit na obsah

Krok po platbě vrací ID dokladu, který nemusel vzniknout

import { Aside } from ‘@astrojs/starlight/components’;

Zálohová faktura byla uhrazená a k platbě existoval daňový doklad na celou částku. Na stejnou fakturu pak přišla další, drobná bankovní platba (přeplatek). Přiřazení skončilo chybou 500 s hláškou o čtení vlastnosti z null, platba se neuložila a řádek výpisu zůstal nespárovaný. Při každém dalším pokusu totéž.

let created: Doc | null = null;
if (uncoveredAmount > 0) created = await issueDocumentForPayment(…);
// … stavové kroky …
return created!.id; // doklad nevznikl → TypeError → rollback celé platby

Doklad k platbě vzniká jen na část, kterou ještě žádný doklad nekryje. U přeplatku je tato část nulová, takže nevznikne nic — a to je správně. Návratová hodnota ale s tím nepočítala a vykřičník kontrolu typů umlčel. Chyba nastala až na samém konci, po všech správných krocích.

return created ? created.id : null;
  • Funkce vrací null, když doklad nevznikl a nebyl zablokovaný kontrolou; chyba validace se dál šíří jako chyba.
  • Volající s volitelným výsledkem počítají: platba se uloží, řádek výpisu se spáruje, doklad zůstane jeden.
  • Na přeplatek se dál vztahují stávající pravidla; oprava nezavádí automatickou vratku ani zdanění.

Test: plná úhrada, potom dalších pár stokorun na tutéž fakturu ručně i automatickým párováním. Očekává se úspěch, vyšší přijatá částka, stále jeden doklad, žádná nová navazující akce a odmítnutí opakování téhož řádku.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: grep na !.id, !.number a podobné vynucení u proměnných, které se plní uvnitř podmínky.
  • Test: ke každé platební cestě přidej případ „nic dalšího už vzniknout nemá“ (přeplatek, opakovaná úhrada, doklad vystavený předem). Nestačí ověřit, že odpověď není 500; zkontroluj uložené částky a počet dokladů.
  • Anti-pattern: vynucené „není null“ jako náhrada za rozhodnutí, co má volající dostat.
  • Pozor na různé vstupní cesty: automatické párování nemusí už uhrazené doklady vůbec nabízet. Test pro něj musí použít případ, který tou cestou skutečně jde, jinak ověřuje něco, co se stát nemůže.

Sister bugs / související

Sekce “Sister bugs / související”
Přidal aiarchitekt.cz · 17. 11. 2026 1:00
Provozuje aiarchitekt.cz