Skip to content

018 · Faktura objednávky bez protokolu o předání díla ukazuje budoucí zádržné bez nároku

Co test ověřuje

Že faktura k přijaté objednávce, která ještě nemá protokol o předání díla, se na stránce Zádržné ukáže s budoucím zádržným (nic neuhrazeno → KZ + DZ = 10 % z 605 000 Kč = 60 500 Kč, Procenta 10 %), s prázdným nárokem, se štítkem „Bez protokolu“ a bez žlutého zvýraznění. Souhrn Zádržné - Celkem je 60 500 Kč, Zádržné - Nárok 0 Kč. Když test protokol založí a nahraje k němu potvrzení, faktura v seznamu zůstane.

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.
  • Zákazník „Test Company s.r.o.“ a zakázka „Retainage Test - No Protocol“ (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 5 %, DZ 5 %, Roky 5. Podle externího čísla k ní patří faktura „FV2025020008“. Protokol o předání díla k ní zatím není.

Postup

  1. Test otevře stránku Zádržné.
  2. Ověří: řádek „FV2025020008“ má Zádržné 60 500,00 Kč a Procenta 10,00 %, sloupec Předávací protokol „Bez protokolu“, prázdný Nárok zádržné a řádek není žlutý; Zádržné - Celkem 60 500,00 Kč, Zádržné - Nárok 0,00 Kč.
  3. Test přes API založí k objednávce protokol o předání díla, vygeneruje ho (bez vad a nedodělků) a nahraje k němu potvrzení finálního protokolu.
  4. Znovu otevře stránku Zádržné.
  5. Ověří: v seznamu je faktura „FV2025020008“.

Co test neověřuje

  • Protokol, který je založený, ale ještě nepotvrzený. Test ho rovnou vygeneruje a nahraje potvrzení.
  • Hodnoty v řádku po založení protokolu (to ověřuje scénář 022). Test kontroluje jen, že faktura v seznamu je. Faktura tam byla už bez protokolu, tento krok tedy neověří, že se protokol založil ani že se změnil výpočet.
  • Že se řádek bez protokolu zbarví žlutě. Nic není uhrazeno, žluté zvýraznění tak vzniknout nemůže a kontrola „řádek není žlutý“ nemůže selhat.
  • Součet „bez protokolu“ pod Zádržné - Celkem a zbytek pod Zádržné - Nárok.
  • Že vzorec je KZ + DZ a počítá se z Celkem v CZK: KZ i DZ jsou 5 % a faktura je na stejnou částku jako objednávka, data tak neodliší jiný výpočet.
  • Částečně uhrazenou fakturu bez protokolu a žluté zvýraznění (zádržné nad domluvené KZ + DZ) — pokryté unit testem.
  • Založení protokolu formulářem. Test ho zakládá přes API (formulářem scénáře 026 a 027).
  • Jiné role než administrátor a účetní.
  • Skutečné napojení na Trivi.

Pro vývojáře

  • Test: retainage.spec.ts › „shows invoice of an order without work handover protocol as future retainage without claim“
  • Přes invoke-action: createAccountingEntity, createContract, createReceivedOrder s externalNumber: "OBJ-HIGH-RETAINAGE" (test čeká isSuccess), potom createWorkHandoverProtocol, generateWorkHandoverProtocol (withDefects: false) a uploadWorkHandoverProtocolConfirmation. Data jako ve scénáři 022 (calculateIssuedDateForExpiration(5, 7), calculateContractDates), jen KZ a DZ 5 %.
  • Párování faktury s objednávkou (ReceivedOrderService.getReceivedOrderForInvoice → isReceivedOrderInvoice): orderNo faktury = externalNumber nebo code objednávky. Bez protokolu ji RetainageService.getAllRetainageInvoices mapuje přes computeRetainageWithoutHandover (nárok null).
  • Řádek bez protokolu: Retainage.assertInvoiceRowWithoutHandoverProtocol (data-field="hasHandoverProtocol" = „Bez protokolu“, prázdný retainageClaim, bez třídy warning). Faktura po protokolu: Retainage.assertInvoiceRowExists.

Media

screenshot