Fakturační API bez konceptu plátcovství DPH — klient posílal natvrdo 21 %

Symptom

Automaticky vystavené faktury (dobití kreditu, měsíční tarif) odcházely zákazníkům s 21 % DPH, přestože fakturující firma není plátce DPH. Částka „s DPH” na dokladu byla o 21 % vyšší, než měla být, a doklad byl formálně vadný (neplátce nesmí DPH vyčíslit).

Příčina

Fakturační platforma nemá v API ani v profilu firmy žádný flag „plátce/neplátce DPH” — sazba se určuje per položka a je plně na volajícím. Integrace v SaaS klientovi měla sazbu zadrátovanou:

items: [{ description, quantity: 1, unitPrice: amount, vatRate: 21 }]

Autor integrace předpokládal, že „fakturační nastavení dodavatele” sazbu doplní nebo zvaliduje. Nedoplnilo — API poslušně vystavilo, co dostalo.

Řešení

1. Sazbu řídit z konfigurace integrace podle skutečného plátcovství dodavatele (u neplátce vatRate: 0), ne konstantou opsanou z příkladu.
2. Opravit i UI texty („částka + 21 % DPH” → „nejsme plátci DPH — částka je konečná”).
3. Chybně vystavené doklady stornovat a vystavit znovu — nestačí opravit kód.

Prevence

• Při integraci na fakturační API si vždy ověř, kdo je zdrojem pravdy pro DPH — profil dodavatele, nebo volající? Pokud volající, plátcovství patří do konfigurace, ne do kódu.
• Do E2E testu fakturace přidat assert na subtotal == total (neplátce) resp. očekávaný poměr (plátce).