id: 022 module: retainage name: percentages-high-retainage-10-percent-each title: Zádržné KZ 10 % a DZ 10 %: nárok je 90 % faktury tags: [module:retainage, status:automated, priority:high] priority: high status: automated spec: tests/e2e/tests/retainage.spec.ts
022 · Zádržné KZ 10 % a DZ 10 %: nárok je 90 % faktury¶
Co test ověřuje¶
Že při KZ 10 % a DZ 10 % ukazuje stránka Zádržné u neuhrazené faktury po splatnosti na 605 000 Kč zádržné 605 000 Kč a nárok 544 500 Kč (90 %), v souhrnu i v řádku faktury, a že řádek není zvýrazněný.
Výchozí stav (test si ho připraví sám)¶
- Prázdná databáze, přihlášený je testovací uživatel s rolemi administrátor a účetní a s podpisem nastaveným přes API.
- Trivi v testu nahrazuje simulace. Vrací mimo jiné fakturu „FV2025020008“: 605 000 Kč s DPH, splatnost 20. 3. 2021, nic neuhrazeno, číslo objednávky „OBJ-HIGH-RETAINAGE“, středisko 2025020. Se stejným střediskem vrací i další faktury s jinými čísly objednávek.
- Zákazník „Stavební firma ABC s.r.o.“ a zakázka „Retainage - High Percentage 10%/10%“ (středisko 2025020, cena 605 000 Kč), vytvořené přes API.
- Přijatá objednávka k zakázce, vytvořená přes API: externí číslo „OBJ-HIGH-RETAINAGE“, celková cena 605 000 Kč, KZ 10 %, DZ 10 %, Roky 5. Začátek rekl. doby test spočítá tak, aby hranice pro zvýraznění (konec pětileté záruky minus 2 měsíce) byla za 7 dní.
- PP o dílo k objednávce se stejným datem vystavení, přes API vygenerovaný a s nahraným potvrzením finálního protokolu.
Postup¶
- Test otevře stránku Zádržné.
- Ověří: seznam neukazuje „Žádné záznamy“.
- Ověří: v seznamu je faktura „FV2025020008“ a její řádek není zvýrazněný.
- Zkontroluje souhrnné ukazatele.
- Ověří: „Zádržné - Celkem“ je „605 000,00 Kč“ a součet Celkem v CZK pod ním „605 000,00 Kč“.
- Ověří: „Zádržné - Nárok“ je „544 500,00 Kč“ a zbytek bez nároku pod ním „60 500,00 Kč“.
- Zkontroluje řádek faktury.
- Ověří: Celkem v CZK je „605 000,00 Kč“ a Uhrazeno v CZK „0,00 Kč“.
- Ověří: Zádržné je „605 000,00 Kč“ a Procenta „100,00 %“.
- Ověří: Nárok zádržné je „544 500,00 Kč“ a Nárok procenta „90,00 %“.
Co test neověřuje¶
- Které z obou procent se od zádržného odečítá. KZ i DZ jsou stejné, že se odečítá DZ, rozlišují scénáře 024 a 025.
- Fakturu před splatností, kde se nárok počítá z KZ, a částečně uhrazenou fakturu.
- Nárok po skončení záruky, kdy je nárokem celé zádržné.
- Barvu řádku. Test kontroluje jen, že řádek nemá označení pro zvýraznění.
- Ostatní sloupce (Odběratel, Objednávka, ŽKZ, ŽDZ, DUZP, Celkem, Měna, Expirace).
- Názvy sloupců a nadpisy ukazatelů. Test hledá hodnoty podle interních označení.
- Jiné role než administrátor a účetní.
- Skutečné napojení na Trivi.
Pro vývojáře¶
- Test:
retainage.spec.ts› „Percentages: HIGH retainage 10%/10%“ - Přes
invoke-action:createAccountingEntity,createContract(branch: "2025020"),createReceivedOrder(externalNumber: "OBJ-HIGH-RETAINAGE",shortRetainage: 0.1,longRetainage: 0.1,warrantyStart=issuedDate), u všech tří test čekáisSuccess; pakcreateWorkHandoverProtocol,generateWorkHandoverProtocol,uploadWorkHandoverProtocolConfirmation. issuedDate = calculateIssuedDateForExpiration(5, 7).- Faktura
FV2025020008z mockuissued-invoices-all-retainage.json. Ostatní faktury střediska 2025020 mají jinéorderNoa k objednávce se nepřiřadí. - Kontroly:
assertHasRecords,assertInvoiceRowExists,assertInvoiceRowNotExpired(not.toHaveClass(/expired/)), test idretainage-total-sum,retainage-total-domestic,retainage-claim-sum,retainage-remaining,assertInvoiceRow(data-fields jako ve scénáři 020). - Očekávané hodnoty z
calculateRetainageValues(isAfterExpiration: false): nárok = (100 % − DZ) × 605 000.
Media¶
