Skip to content

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

  1. Test otevře stránku Zádržné.
  2. Ověří: seznam neukazuje „Žádné záznamy“.
  3. Ověří: v seznamu je faktura „FV2025020008“ a její řádek není zvýrazněný.
  4. Zkontroluje souhrnné ukazatele.
  5. Ověří: „Zádržné - Celkem“ je „605 000,00 Kč“ a součet Celkem v CZK pod ním „605 000,00 Kč“.
  6. Ověří: „Zádržné - Nárok“ je „544 500,00 Kč“ a zbytek bez nároku pod ním „60 500,00 Kč“.
  7. Zkontroluje řádek faktury.
  8. Ověří: Celkem v CZK je „605 000,00 Kč“ a Uhrazeno v CZK „0,00 Kč“.
  9. Ověří: Zádržné je „605 000,00 Kč“ a Procenta „100,00 %“.
  10. 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; pak createWorkHandoverProtocol, generateWorkHandoverProtocol, uploadWorkHandoverProtocolConfirmation.
  • issuedDate = calculateIssuedDateForExpiration(5, 7).
  • Faktura FV2025020008 z mocku issued-invoices-all-retainage.json. Ostatní faktury střediska 2025020 mají jiné orderNo a k objednávce se nepřiřadí.
  • Kontroly: assertHasRecords, assertInvoiceRowExists, assertInvoiceRowNotExpired (not.toHaveClass(/expired/)), test id retainage-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

screenshot