005 · Přijatý dobropis sníží náklady zakázky¶
Co test ověřuje¶
Že přijatý dobropis sníží náklady zakázky: faktura na 5 000 Kč a dobropis na -1 000 Kč bez DPH dají náklady 4 000 Kč a oba rozdíly -4 000 Kč. Dobropis je v tabulce faktur se zápornými částkami.
Výchozí stav (test si ho připraví sám)¶
- Prázdná databáze, přihlášený je testovací uživatel s rolí administrátor.
- Zakázka „Invoice and Credit Note Contract“, středisko 2025010, smluvní cena 200 000 Kč, období 1. 3. – 31. 12. 2025, bez investora a bez objednávek, vytvořená přes API.
- Trivi v testu nahrazuje simulace. Pro středisko 2025010 vrací dva zaplacené přijaté doklady od „Test Company s.r.o.“: fakturu FP2025106001 na 5 000 Kč a dobropis DP2025200001 na -1 000 Kč bez DPH.
Postup¶
- Test otevře detail zakázky.
- Ověří: Období je „01. 03. 2025 – 31. 12. 2025“.
- Ověří: Stav je „Aktivní“.
- Ověří: Stav fakturace je „Nutnost fakturovat“.
- Ověří: Středisko je „2025010“.
- Ověří: Smluvní cena je „200 000,00 Kč“.
- Ověří: Součet vystavených objednávek bez DPH i Součet přijatých objednávek bez DPH je „0,00 Kč“.
- Ověří: Konečný rozdíl je -4 000,00 Kč.
- Ověří: Aktuální rozdíl je -4 000,00 Kč.
- Ověří: Fáze je „Bez přijatých objednávek“.
- Ověří: údaj Investor je prázdný.
- Zkontroluje tabulku faktur, která je vidět hned po otevření detailu (výchozí záložka Přijaté faktury). Hodnoty řádků jsou níže v pořadí Externí číslo, Částka bez DPH, Částka, Datum splatnosti, Typ faktury, Zaplaceno.
- Ověří: Název dodavatele je u obou řádků „Test Company s.r.o.“.
- Ověří: FP2025106001: „EXT003“, „5 000,00 Kč“, „6 050,00 Kč“, „15. 03. 2025“, „Faktura“, „Zaplaceno“.
- Ověří: DP2025200001: „EXT004“, „-1 000,00 Kč“, „-1 210,00 Kč“, „19. 03. 2025“, „Dobropis“, „Zaplaceno“.
- Ověří: v tabulce jsou právě 2 řádky.
- Zkontroluje souhrnná čísla, u každého ukazatele velké a malé číslo.
- Ověří: Náklady - bez DPH má velké i malé číslo 4 000,00 Kč.
- Ověří: Výnosy - bez DPH má velké i malé číslo 0,00 Kč.
- Ověří: ZV Přijato má velké i malé číslo 0,00 Kč.
- Ověří: ZV Vystaveno má velké i malé číslo 0,00 Kč.
Co test neověřuje¶
- Vystavené dobropisy (scénáře 010 a 011).
- Názvy údajů, ukazatelů a sloupců ani pořadí sloupců. Test hledá hodnoty podle interních označení.
- Přesný zápis rozdílů a souhrnných čísel. Test je převádí na číslo a porovnává s tolerancí 1 haléř.
- Že jsou pravidla výpočtu správně. Očekávané částky nejsou zadané napevno, test je dopočítá ze simulovaných dokladů podle stejných pravidel, jaká používá aplikace.
- Přepínání záložek a záložku Vystavené faktury (to ověřují scénáře 008, 010 a 011). Test na žádnou záložku neklikne a nekontroluje, která je vybraná.
- Doklady s položkami více středisek. Simulované doklady mají jen položky střediska zakázky.
- Bubliny s rozpisem výpočtu, kruhové grafy, Konečnou a Aktuální marži, Očekávaný rozdíl z objednávek a Aktuální zádržné.
- Řazení řádků v tabulce.
- Vytvoření zakázky formulářem a otevření detailu ze seznamu zakázek. Zakázka vzniká přes API a test otevře detail přímo.
- Skutečné napojení na Trivi.
- Jiné role než administrátor.
Pro vývojáře¶
- Test:
contracts.spec.ts› „should subtract credit note from invoice total (branch 2025010)“ - Příprava:
beforeEachvoláTestControl.cleanDb(),Auth.logIntoApp(TEST_EMAIL, TEST_PASSWORD)aAuth.assignRoles(TEST_EMAIL, [Role.ADMIN]),afterEachznovucleanDb(). Zakázka vzniká přesContract.createContract(/api/test-control/invoke-action/createContract,customer: null), test ověříisSuccessa otevře/contracts/<id>. - Mock Trivi:
external-api-mock-responses/trivi/receipts-branch-2025010_creditnote.json,config.jsonho vrací naPOST /v2/search/accountingdocumentss filtremlineItem.tag.branch=2025010. - Očekávané hodnoty:
createPayloadLookup(receipts2025010, "2025010")(helpers/apiParser.ts) a metodyassert…FromPayloadvpage-objects/contract.page.ts; dobropis (typ 3) se v nákladech sčítá se zápornou částkou. Stav fakturace se čeká „V pořádku“ při dopočítaném aktuálním rozdílu ≥ 0, jinak „Nutnost fakturovat“. - Údaje zakázky přes
toContainText:contract-term,contract-state,contract-invoicing-status,contract-branch,contract-price,contract-issued-order-price-sum,contract-received-order-price-sum,contract-phase,contract-customer(přesně"",toHaveText). - Rozdíly a souhrnná čísla se čtou jednou přes
textContent()(bez čekání) a porovnávají číselně s tolerancí 0,01:contract-final-difference,contract-current-difference,costs-without-vat-main/-secondary,revenues-without-vat-main/-secondary,proforma-received-main/-secondary,proforma-issued-main/-secondary. - Řádky:
assertInvoiceRownajde[role="row"]s buňkoudata-field="documentNumber"a porovná buňkyexternalNo,companyName,priceVatExcluded,price,dueDate,invoiceType,paid(toContainText).assertInvoiceRowCount(2)počítá všechny[role="row"]bezcolumnheaderna stránce.
Media¶
