Skip to content

161 · Žádosti o KZ a DZ jsou v řádku faktury na stránce Zádržné a odkazy otevřou jejich detail

Co test ověřuje

Že žádost o krátkodobé (KZ) a o dlouhodobé (DZ) zádržné k přijaté objednávce se ukáže v řádku faktury této objednávky na stránce Zádržné, každá ve svém sloupci ŽKZ a ŽDZ, a že odkaz otevře detail protokolu s kódem, který je v řádku.

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 „FV2025020006“: 121 000 Kč s DPH, splatnost 20. 3. 2021, nic neuhrazeno, číslo objednávky „OBJ-NOT-EXPIRED“, středisko 2025031.
  • Zákazník „Stavební firma ABC s.r.o.“ a zakázka „Retainage - Request Protocol Linkage“ (středisko 2025031, cena 121 000 Kč), vytvořené přes API.
  • Přijatá objednávka k zakázce, vytvořená přes API: externí číslo „OBJ-NOT-EXPIRED“, celková cena 121 000 Kč, KZ 5 %, DZ 5 %, Roky 5. Začátek rekl. doby test spočítá tak, aby hranice pro zvýraznění byla zítra.
  • 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, aby se faktura na stránce Zádržné ukázala.

Postup

  1. Test přes API založí k objednávce žádost o KZ a žádost o DZ, obě s datem vystavení PP o dílo.
  2. Otevře stránku Zádržné.
  3. Ověří: v seznamu je faktura „FV2025020006“.
  4. Ověří: ve sloupci ŽKZ jejího řádku je kód „ZKZ“ a za ním osm číslic.
  5. Ověří: ve sloupci ŽDZ jejího řádku je kód „ZDZ“ a za ním osm číslic.
  6. Klikne na odkaz ve sloupci ŽKZ.
  7. Ověří: otevře se detail žádosti o KZ.
  8. Ověří: detail má nadpis s kódem ze sloupce ŽKZ.
  9. Znovu otevře stránku Zádržné a klikne na odkaz ve sloupci ŽDZ.
  10. Ověří: otevře se detail žádosti o DZ.
  11. Ověří: detail má nadpis s kódem ze sloupce ŽDZ.

Co test neověřuje

  • Založení žádostí formulářem. Test je zakládá přes API a výsledek ani jejich stav nekontroluje (zakládání žádostí: scénář 156).
  • Datum žádosti, které je v odkazu za kódem.
  • Názvy sloupců ŽKZ a ŽDZ. Test hledá buňky podle interních názvů.
  • Více žádostí stejného druhu k jedné objednávce.
  • Zádržné, nárok, souhrnné ukazatele a zvýraznění řádku (scénář 020).
  • Jiné role než administrátor a účetní.
  • Skutečné napojení na Trivi.

Pro vývojáře

  • Test: retainage.spec.ts › „Retainage request protocols (KZ/DZ) are linked on the retainage invoice row and open the correct protocol“
  • test.setTimeout(90_000). Příprava přes invoke-action: createAccountingEntity, createContract (branch: "2025031"), createReceivedOrder (externalNumber: "OBJ-NOT-EXPIRED", warrantyStart = issuedDate), u všech tří test čeká isSuccess; pak createWorkHandoverProtocol, generateWorkHandoverProtocol, uploadWorkHandoverProtocolConfirmation. issuedDate = calculateIssuedDateForExpiration(5, 1).
  • Žádosti: Orders.createRetainageRequestProtocol (createRetainageRequestProtocol, term: "SHORT" a "LONG", orderType: "received"), výsledek se nekontroluje.
  • Buňky data-field="retainageRequestProtocol.SHORT" a retainageRequestProtocol.LONG: assertRetainageRequestProtocol = toContainText(/ZKZ\d{8}/) resp. /ZDZ\d{8}/; kód čte getRetainageRequestCode (/Z[KD]Z\d{8}/).
  • clickRetainageRequestProtocol: klik na getByRole("link") v buňce, waitForURL(/\/protocols\/\d+\/retainage-request-short-term/) resp. retainage-request-long-term; Protocol.assertDetailCode(code) = getByRole("heading", { name: code }) viditelný.
  • Aplikace: RetainageService.getAllRetainageInvoices → mapRetainageInvoice(invoice, workHandover, retainageRequestProtocols) → retainageRequestProtocol.{SHORT,LONG}; buňka RenderRetainageRequestProtocolCell je odkaz „kód (datum)“.