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¶
- Test přes API založí k objednávce žádost o KZ a žádost o DZ, obě s datem vystavení PP o dílo.
- Otevře stránku Zádržné.
- Ověří: v seznamu je faktura „FV2025020006“.
- Ověří: ve sloupci ŽKZ jejího řádku je kód „ZKZ“ a za ním osm číslic.
- Ověří: ve sloupci ŽDZ jejího řádku je kód „ZDZ“ a za ním osm číslic.
- Klikne na odkaz ve sloupci ŽKZ.
- Ověří: otevře se detail žádosti o KZ.
- Ověří: detail má nadpis s kódem ze sloupce ŽKZ.
- Znovu otevře stránku Zádržné a klikne na odkaz ve sloupci ŽDZ.
- Ověří: otevře se detail žádosti o DZ.
- 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řesinvoke-action:createAccountingEntity,createContract(branch: "2025031"),createReceivedOrder(externalNumber: "OBJ-NOT-EXPIRED",warrantyStart=issuedDate), u všech tří test čekáisSuccess; pakcreateWorkHandoverProtocol,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"aretainageRequestProtocol.LONG:assertRetainageRequestProtocol=toContainText(/ZKZ\d{8}/)resp./ZDZ\d{8}/; kód čtegetRetainageRequestCode(/Z[KD]Z\d{8}/). clickRetainageRequestProtocol: klik nagetByRole("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ňkaRenderRetainageRequestProtocolCellje odkaz „kód (datum)“.