Skip to content

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

  1. Test otevře detail zakázky.
  2. Ověří: Období je „01. 03. 2025 – 31. 12. 2025“.
  3. Ověří: Stav je „Aktivní“.
  4. Ověří: Stav fakturace je „Nutnost fakturovat“.
  5. Ověří: Středisko je „2025010“.
  6. Ověří: Smluvní cena je „200 000,00 Kč“.
  7. Ověří: Součet vystavených objednávek bez DPH i Součet přijatých objednávek bez DPH je „0,00 Kč“.
  8. Ověří: Konečný rozdíl je -4 000,00 Kč.
  9. Ověří: Aktuální rozdíl je -4 000,00 Kč.
  10. Ověří: Fáze je „Bez přijatých objednávek“.
  11. Ověří: údaj Investor je prázdný.
  12. 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.
  13. Ověří: Název dodavatele je u obou řádků „Test Company s.r.o.“.
  14. Ověří: FP2025106001: „EXT003“, „5 000,00 Kč“, „6 050,00 Kč“, „15. 03. 2025“, „Faktura“, „Zaplaceno“.
  15. Ověří: DP2025200001: „EXT004“, „-1 000,00 Kč“, „-1 210,00 Kč“, „19. 03. 2025“, „Dobropis“, „Zaplaceno“.
  16. Ověří: v tabulce jsou právě 2 řádky.
  17. Zkontroluje souhrnná čísla, u každého ukazatele velké a malé číslo.
  18. Ověří: Náklady - bez DPH má velké i malé číslo 4 000,00 Kč.
  19. Ověří: Výnosy - bez DPH má velké i malé číslo 0,00 Kč.
  20. Ověří: ZV Přijato má velké i malé číslo 0,00 Kč.
  21. 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: beforeEach volá TestControl.cleanDb(), Auth.logIntoApp(TEST_EMAIL, TEST_PASSWORD) a Auth.assignRoles(TEST_EMAIL, [Role.ADMIN]), afterEach znovu cleanDb(). Zakázka vzniká přes Contract.createContract (/api/test-control/invoke-action/createContract, customer: null), test ověří isSuccess a otevře /contracts/<id>.
  • Mock Trivi: external-api-mock-responses/trivi/receipts-branch-2025010_creditnote.json, config.json ho vrací na POST /v2/search/accountingdocuments s filtrem lineItem.tag.branch = 2025010.
  • Očekávané hodnoty: createPayloadLookup(receipts2025010, "2025010") (helpers/apiParser.ts) a metody assert…FromPayload v page-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: assertInvoiceRow najde [role="row"] s buňkou data-field="documentNumber" a porovná buňky externalNo, companyName, priceVatExcluded, price, dueDate, invoiceType, paid (toContainText). assertInvoiceRowCount(2) počítá všechny [role="row"] bez columnheader na stránce.

Media

screenshot