Odoo 19: Otvorené položky v zákazníckom portáli s rozhodným dňom a exportom do PDF – modul portal_open_items

„Koľko u vás vlastne ešte máme neuhradené?“ Túto otázku dostávajú pravidelne všetci, ktorí majú zákazníkov, väčšinou tesne pred koncom štvrťroka, pred audítorskou kontrolou účtovnej závierky alebo keď účtovníctvo zákazníka pripravuje platby. Kto na ňu neodpovie vopred, dostane ju e-mailom alebo telefonicky a niekto musí z účtovníctva exportovať a odoslať zoznam otvorených položiek (zoznam OP). V Odoo 19 Community to nefunguje samo: zákaznícky portál síce zobrazuje jednotlivé faktúry, ale nie zoznam otvorených položiek celej spoločnosti, a už vôbec nie k voľne zvolenému dňu.

Vytvorili sme na to modul Otvorené položky v zákazníckom portáli (portal_open_items) pre Odoo 19. Zákazníci s povoleným prístupom vidia v portáli zoznam všetkých otvorených faktúr, dobropisov a ešte nepriradených platieb svojej spoločnosti, môžu zvoliť rozhodný deň, stiahnuť zoznam ako PDF a na prvý pohľad vidia, ako je na tom ich platobná morálka. Modul je slobodný softvér pod licenciou AGPL-3 a nájdete ho na GitHube:

github.com/Alex0176/odoo-portal-open-items

Modul sme nainštalovali 5. novembra 2026 v našom produkčnom systéme. Voľba je tam v predvolenom nastavení vypnutá a nastavuje sa až po dohode s jednotlivými zákazníkmi. Skúsenosti z prevádzky sú teda zatiaľ krátke; testovali sme s trinástimi automatickými testami a testovacou databázou s ukážkovými zákazníkmi. Kto modul preberá, mal by si prečítať časti o výpočte rozhodného dňa, o platobnej morálke a o obmedzeniach .

Problém: zoznam OP na požiadanie

Zoznam otvorených položiek ukazuje, ktoré faktúry zákazníka ešte nie sú uhradené, ktoré z nich sú po splatnosti a aké je saldo. Pre dodávateľa je nástrojom plánovania likvidity a upomínacieho procesu. Pre zákazníka je podkladom na plánovanie platieb, na odsúhlasenie faktúr s vlastným účtovníctvom a na vyjasnenie otázok bez toho, aby musel otvárať každú faktúru zvlášť. Typické príležitosti:

• Štvrťročná a ročná závierka: Účtovníctvo zákazníka chce vedieť, aké záväzky existovali k 31. 12. Ide o rozhodný deň v minulosti.
• Odsúhlasenie: Zákazník sa domnieva, že faktúru uhradil, my ju vidíme stále ako neuhradenú. Spoločný zoznam s dátumom, splatnosťou a sumou to vyjasní rýchlejšie ako reťazec e-mailov.
• Platobné dávky: Kto pripravuje platby týždenne alebo mesačne, potrebuje mať všetky otvorené faktúry dodávateľa na jednom mieste, s tými po splatnosti navrchu.
• Viacero kontaktných osôb: Vo firme jeden objednáva, iný platí. Otvorené položky patria spoločnosti, nie jednotlivej osobe.

Doteraz sme tieto zoznamy vyťahovali ručne z účtovníctva a posielali e-mailom. Stojí to čas a výsledkom je len momentka, ktorá je už nasledujúci deň neaktuálna. Lepší je zoznam, ktorý si zákazník môže kedykoľvek sám otvoriť v portáli, vždy s aktuálnym stavom.

Riešenie v skratke

Modul rozširuje zákaznícky portál Odoo o stránku Otvorené položky a dlaždicu v sekcii Môj účet. Rozsah funkcií:

• Voľba pre každý kontakt: „Zobraziť zoznam otvorených položiek v portáli“. Iba ak je nastavená, vidí používateľ portálu dlaždicu a stránku. V predvolenom nastavení je vypnutá.
• Celá spoločnosť: Zoznam obsahuje otvorené položky všetkých kontaktov firmy, nielen prihláseného používateľa.
• Rozhodný deň: Zákazník zvolí dátum a vidí, čo bolo k tomuto dňu otvorené.
• Export do PDF: Zoznam ako PDF v rozložení vašej spoločnosti, s hlavičkou, saldom a súčtom položiek po splatnosti.
• Platobná morálka: podiel faktúr uhradených načas, s miernym oneskorením a neskoro, najstaršia otvorená faktúra a hodnotenie dobré alebo zlé, v portáli aj v PDF.
• Položky po splatnosti sú farebne zvýraznené a zobrazujú počet dní po dátume splatnosti.
• Dobropisy a kredity sú v zozname uvedené so zápornou sumou a znižujú saldo.
• Prepojenie: Každá faktúra v zozname vedie na zobrazenie faktúry v portáli.
• Viacjazyčnosť: Rozhranie aj PDF sa riadia jazykom používateľa, nemecký preklad je súčasťou modulu.

Dlaždica sa zobrazuje na úvodnej stránke Môj účet vedľa objednávok a faktúr. Kto voľbu nemá, nevidí ju.

Povolenie pre každý kontakt: voľba

Zoznam OP zobrazuje obchodné údaje celej spoločnosti. Preto ho modul nepovoľuje všetkým používateľom portálu, ale iba tam, kde to výslovne chcete. V kontakte sa vo formulári v časti Webstránka nachádza začiarkavacie políčko „Zobraziť zoznam otvorených položiek v portáli“. Je viditeľné pre používateľov s oprávneniami na fakturáciu (skupina account.group_account_invoice) a platí pre tento jeden kontakt.

Zodpovedá to praxi: Vo firme má zoznam vidieť vedenie alebo účtovníctvo, zamestnanec, ktorý si prezerá iba tikety, nie. Voľba platí pre kontakt, zobrazené položky však patria celej spoločnosti. Nastavte preto voľbu u osoby, ktorá má mať prehľad o firme.

Zoznam v zákazníckom portáli

Kliknutím na dlaždicu sa otvorí /my/open-items. Stránka zobrazuje názov spoločnosti, výber rozhodného dňa a tabuľku s otvorenými položkami:

Pod tabuľkou sa nachádza saldo, teda súčet všetkých otvorených súm, a súčet položiek po splatnosti. Riadky po splatnosti majú farebné pozadie, aby boli pri prehliadaní okamžite viditeľné. Dobropisy a platby, ktoré ešte nie sú priradené k faktúre, sa zobrazujú so záporným znamienkom a znižujú saldo; poznámka pod tabuľkou to zákazníkovi vysvetľuje. Ak vaša spoločnosť účtuje vo viacerých menách, saldo sa uvádza osobitne pre každú menu.

Otvorené položky k rozhodnému dňu

Nad dátumom sa nachádza „Otvorené položky k rozhodnému dňu“, vedľa neho pole s dátumom a tlačidlo Zobraziť. Pri rozhodnom dni v minulosti zoznam ukazuje, čo bolo k tomuto dňu ešte neuhradené. Presne takéto vyhodnotenie sa potrebuje pri závierkach, kontrolách a odsúhlasovaní: „Aké záväzky sme mali k 31. 12. voči tomuto dodávateľovi?“

Ako sa počíta rozhodný deň

Pre každú položku platí: Otvorené k rozhodnému dňu = suma faktúry mínus všetky platby, ktoré boli odsúhlasené najneskôr k rozhodnému dňu vrátane. Položka patrí do zoznamu, ak bola k rozhodnému dňu už zaúčtovaná a mala vtedy ešte zostatok. Faktúra zo 7. septembra na 1.250,50 €, ktorá bola 20. októbra čiastočne uhradená sumou 500,00 € a 5. novembra doplatená, je teda pri rozhodnom dni 2. novembra v zozname so sumou 750,50 € a pri rozhodnom dni 5. novembra už vôbec nie.

Omeškanie sa taktiež posudzuje k rozhodnému dňu: Položka je po splatnosti, ak je jej dátum splatnosti pred rozhodným dňom a zostatok je kladný. Dni po splatnosti sa počítajú do rozhodného dňa, nie do dnešného dňa. Rozhodný deň v budúcnosti sa spracuje ako dnešný deň, rovnako ako prázdny alebo neplatný dátum v adresnom riadku. Zoznam tak nemôže predstierať prognózu.

Čo tu znamená „dátum platby“

Rozhodujúci je dátum, kedy boli faktúra a platba v Odoo navzájom odsúhlasené (neskorší z oboch dátumov zaúčtovania), nie dátum faktúry. Toto je bežný prípad: Platba sa zaúčtuje v deň prijatia platby a priradí sa k faktúre. Kto platby priraďuje až o niekoľko dní neskôr, vidí faktúru primerane dlhšie ako otvorenú. Sekcia obmedzeniach sa tomu venuje podrobnejšie.

Export do PDF

Cez Stiahnuť PDF modul vytvorí zoznam ako súbor PDF pre zvolený rozhodný deň. Tlačidlo Tlačiť otvorí ten istý zoznam v tlačovom dialógu prehliadača. PDF používa rozloženie dokumentu vašej spoločnosti v Odoo (logo, adresa, pätička z nastavení) a európsky formát papiera:

• Nadpis s rozhodným dňom: „Otvorené položky k rozhodnému dňu 02.11.2026“, aj keď je rozhodným dňom dnešok. Ak nie sú žiadne otvorené položky, uvedie sa „Neexistujú žiadne otvorené položky.“
• Adresa zákazníka v adresnom poli rozloženia spoločnosti, aby zoznam sedel k veci aj po vytlačení.
• Položky po splatnosti tučne, aby boli výrazné aj pri čiernobielej tlači.
• Saldo a súčet položiek po splatnosti na konci tabuľky, pri viacerých menách pre každú menu osobitne.
• Názov súboru s firmou a dátumom, napríklad Open_items_Muster_Handels_GmbH_2026-11-02.pdf.

Platobná morálka: hodnotenie na prvý pohľad

Od verzie 19.0.1.1.0 je nad tabuľkou krátke vyhodnotenie toho, ako načas spoločnosť uhrádza svoje faktúry. To isté vyhodnotenie sa zobrazuje aj v PDF. Zákazník tak sám vidí, kde stojí, a vy mu to už nemusíte vysvetľovať osobitne.

• Zelená: „47 % bolo uhradených v lehote splatnosti.“ Ide o faktúry uhradené v deň splatnosti alebo skôr.
• Oranžová: „29 % bolo uhradených v týždni po uplynutí lehoty splatnosti.“ Ide o platby jeden až sedem dní po splatnosti.
• Červená: „24 % bolo uhradených neskôr, v priemere po 39 dňoch (25 dní po uplynutí lehoty splatnosti).“ Prvé číslo sa počíta od dátumu faktúry, číslo v zátvorke od splatnosti. Riadok sa zobrazí, len ak takéto faktúry existujú.
• „Faktúry sú otvorené až 60 dní.“ Je to vek najstaršej faktúry, ktorá je k rozhodnému dňu ešte otvorená, počítaný od dátumu faktúry.

Pod tým je hodnotenie platobnej morálky: dobré alebo zlé a na konci stránky (v PDF na konci strany) poznámka „Zákazníci so zlou platobnou morálkou sa prestavujú na platbu vopred.“ PDF zobrazuje rovnaké riadky v rozložení s hlavičkou:

Čo sa počíta

• Hodnotia sa faktúry vystavené zákazníkovi, ktoré sú zaúčtované. Dobropisy a návrhy sa nepočítajú. Pri splátkach sa každá splátka počíta osobitne.
• Obdobie: faktúry za posledných dvanásť mesiacov a všetky faktúry, ktoré sú ešte otvorené, aj keď sú staršie.
• Deň úhrady je dátum posledného odsúhlasenia s platbou, tak ako pri rozhodnom dni.
• Otvorené faktúry: Ak je faktúra k rozhodnému dňu po splatnosti, počíta sa, ako keby bola uhradená v rozhodný deň, teda oranžová alebo červená. Otvorená faktúra, ktorá ešte nie je splatná, sa nehodnotí.
• Pri rozhodnom dni v minulosti platí stav k tomuto dňu: platby po rozhodnom dni sa ešte nepočítajú.
• Ak nie je čo hodnotiť, zobrazí sa „Žiadne faktúry za posledných 12 mesiacov na hodnotenie.“ a hodnotenie sa nezobrazí.

Kedy je platobná morálka „dobrá“?

Hodnotenie je dobré, ak je aspoň 70 % faktúr zelených alebo oranžových (načas alebo najviac s týždňovým oneskorením) a žiadna otvorená faktúra nie je po splatnosti dlhšie ako 30 dní. Inak je zlé. Prahové hodnoty (7 dní, 70 %, 30 dní, 12 mesiacov) sú ako konštanty na začiatku súboru models/res_partner.py a dajú sa tam upraviť.

Dôležité: modul nikoho neprestavuje na platbu vopred. Poznámka v pätičke je pevný text, ktorý zákazníkom so zlým hodnotením ukazuje, čo z toho môže vyplynúť. Či a kedy sa tak rozhodnete, zostáva na vás. Ak vám veta nevyhovuje, zmeňte ju v oboch šablónach (stránka portálu a správa) alebo v preklade.

Kto čo smie vidieť? Model prístupu

Otvorené položky sú citlivé údaje, preto bol pre nás prístup dôležitejší než akákoľvek ďalšia funkcia. Model je zámerne jednoduchý:

• Iba s nastavenou voľbou. Bez začiarknutia v kontakte neexistuje dlaždica a otvorenie /my/open-items presmeruje na Môj účet.
• Vždy vlastná spoločnosť. Spoločnosť sa určuje z prihláseného používateľa, nie z parametra v adrese. Neexistuje možnosť vyžiadať si cez adresný riadok cudziu spoločnosť.
• Rovnaká kontrola pri PDF. Odoo vo všeobecnosti sprístupňuje PDF správy aj cez všeobecnú adresu. Modul preto priamo v správe znovu kontroluje: PDF dostanú iba používatelia s oprávnením na účtovníctvo alebo používatelia portálu s nastavenou voľbou pre vlastnú spoločnosť, všetci ostatní chybu prístupu.
• Iba zaúčtované položky. Návrhy a stornované doklady sa nikdy nezobrazia.
• Iba vlastné účtovné okruhy: Zohľadňujú sa iba zaúčtovania spoločností, ku ktorým má používateľ prístup.

Technická realizácia

Modul závisí iba od account a portal, teda od súčastí Odoo Community. Pridáva do kontaktu jediné pole a inak pozostáva z kontrolera, triedy správy a šablón.

Otvorené položky sa čítajú z účtovných riadkov, nie z faktúr. Je to dôležité: Iba tak sa zobrazia aj dobropisy a ešte nepriradené platby a iba tak sa dá stav k skoršiemu dňu odvodiť z odsúhlasení (account.partial.reconcile). Dopyt sa vykonáva pre celú spoločnosť (commercial_partner_id) so zvýšenými oprávneniami, kontrola, či ich používateľ smie vidieť, je pred ním.

Testy

Modul obsahuje trinásť automatických testov, ktoré u nás prebiehajú úspešne:

• prístup iba s nastavenou voľbou, inak presmerovanie na Môj účet,
• zoznam obsahuje položky celej spoločnosti, ale nikdy položky inej spoločnosti,
• voľba platí pre kontakt, nie pre všetkých používateľov spoločnosti,
• dobropisy sú v zozname so zápornou sumou a znižujú saldo,
• rozhodný deň: neskôr uhradená faktúra je pred platbou v zozname, po nej nie,
• stránka s dátumom v budúcnosti a s neplatným dátumom,
• adresa PDF vracia súbor PDF,
• správa ako HTML a kontrola prístupu v správe,
• otvorená suma k rozhodnému dňu po čiastočných platbách pred rozhodným dňom a po ňom,
• platobná morálka: rozdelenie na uhradené načas, s oneskorením do týždňa a neskôr, s priemernými hodnotami, aj pre rozhodný deň v minulosti,
• platobná morálka s otvorenými faktúrami a hodnotenie dobré alebo zlé,
• platobná morálka bez faktúr a nikdy s údajmi inej firmy,
• platobná morálka na stránke portálu a v PDF.

Okrem toho sme stránku prešli v prehliadači v testovacej databáze s ukážkovými zákazníkmi, obrázky v tomto príspevku pochádzajú odtiaľ. Všetky mená, čísla dokladov a sumy sú v nich úplne vymyslené.

Inštalácia a nastavenie

git clone https://github.com/Alex0176/odoo-portal-open-items.git
ln -s /pfad/odoo-portal-open-items/portal_open_items /pfad/addons/
odoo-bin -c odoo.conf -d <datenbank> -i portal_open_items --stop-after-init

Závislosťami sú account a portal. Po inštalácii je potrebné reštartovať službu Odoo, pretože modul obsahuje kód v Pythone. Kto prevádzkuje produkčný systém, nainštaluje modul najprv na kópii databázy. Potom:

1. otvorte kontakt, ktorý má vidieť zoznam (osoba s prístupom do portálu),
2. vo formulári nastavte začiarkavacie políčko Zobraziť zoznam otvorených položiek v portáli a uložte,
3. prihláste sa do portálu ako tento používateľ alebo to skontrolujte spoločne so zákazníkom: dlaždica, zoznam, rozhodný deň a PDF.

Pred povolením skontrolujte nastavenia odosielateľa a rozloženia vašej spoločnosti, pretože PDF preberá logo, adresu a pätičku z rozloženia dokumentu. Modul sám neodosiela e-maily ani nevytvára upozornenia.

Obmedzenia a upozornenia

• Dnešný stav zaúčtovaných dokladov. Rozhodný deň sa počíta na základe zaúčtovaní tak, ako sú teraz v systéme. Ak bola po rozhodnom dni faktúra stornovaná alebo vrátená do návrhu, zoznam ju nezobrazuje. Nejde o nemennú momentku „tak, ako bola vtedy vytlačená“.
• Platby sa započítavajú od dňa odsúhlasenia. Ak sa platba priradí až o niekoľko dní po prijatí faktúry, faktúra je dovtedy v zozname ako otvorená. Kto chce čisté vyhodnotenia k rozhodnému dňu, mal by platby priraďovať včas. Bankové párovanie s faktúrami nie je súčasťou Odoo Community; na to používame náš modul Bank-Statement-Matcher.
• Platobná morálka je taká dobrá ako vaše odsúhlasenie. Počíta sa, kedy bola platba priradená faktúre. Platby, ktoré sa dlho neodsúhlasili, spôsobujú, že zákazník vyzerá horšie, než v skutočnosti je. Skontrolujte hodnotenie u svojich zákazníkov, skôr než z neho vyvodíte nejaké závery.
• Hodnotenie je pre zákazníka viditeľné. Kto má voľbu, vidí aj výsledok a poznámku o platbe vopred. Modul pritom nemení platobné podmienky.
• Iba pohľadávky. Modul zobrazuje, čo vám zákazník dlhuje, nie vaše záväzky voči zákazníkovi.
• Žiadne upomínacie stupne a žiadny odkaz na platbu v zozname. Zákazník môže zo zoznamu otvoriť faktúru a zaplatiť ju tam, ako to váš portál inak umožňuje.
• PDF a viacprocesová prevádzka. Na vytvorenie PDF správ Odoo interne volá vlastnú webovú adresu. Ak váš systém beží iba s jedným pracovným procesom, môže to blokovať. Týka sa to všetkých PDF správ v portáli, nielen tohto modulu. Po inštalácii raz vyskúšajte tlačidlo PDF za skutočných podmienok.
• Testované iba na Odoo 19.0 Community. Pre iné verzie sme ho neoverovali.
• Nenahrádza upomínací proces ani výpis z účtu. Zoznam nenahrádza ani účtovný výpis z účtu, ani vaše upomínacie procesy, iba robí stav prehľadným stav.

Často kladené otázky

Čo je zoznam otvorených položiek (zoznam OP)?

Prehľad všetkých faktúr, ktoré ešte nie sú alebo nie sú úplne uhradené, s dátumom faktúry, splatnosťou a otvorenou sumou. Nazýva sa aj „otvorené faktúry“, „zákaznícky účet“ alebo „zoznam sald“, pričom zoznam sald v užšom zmysle znamená salda všetkých účtov.

Prečo portál Odoo nezobrazuje zoznam OP už v základe?

Portál zobrazuje objednávky, faktúry a platby jednotlivo, so stavom a filtrami. Celkový zoznam spoločnosti so saldom a vyhodnotenie k rozhodnému dňu nie sú podľa našich zistení súčasťou rozsahu Community. Na to je modul určený.

Vidia zoznam všetci používatelia portálu spoločnosti?

Nie. Iba kontakty s nastavenou voľbou. Zobrazený zoznam však zahŕňa celú spoločnosť, nielen faktúry tohto jedného kontaktu.

Môžem zvoliť rozhodný deň z minulosti, napríklad 31. 12. predchádzajúceho roka?

Áno, ľubovoľný dátum až po dnešok. Zoznam potom zobrazuje položky, ktoré boli k tomuto dňu zaúčtované a ešte neuhradené. Všimnite si upozornenia k výpočtu: Rozhodujúci je deň odsúhlasenia platby.

Podporuje sa rozhodný deň v budúcnosti?

Nie. Budúce dátumy sa spracujú ako dnešok, aby zoznam nezobrazoval stav, ktorý ešte neexistuje.

Zobrazujú sa v zozname dobropisy a zálohy?

Áno. Dobropisy a platby, ktoré ešte nie sú priradené k faktúre, sú v zozname so zápornou sumou a znižujú saldo. Poznámka pod tabuľkou to zákazníkovi vysvetľuje.

Ako sa rozpoznajú položky po splatnosti?

Položka je po splatnosti, ak je jej dátum splatnosti pred rozhodným dňom a ešte zostáva otvorený kladný zostatok. Dni po splatnosti sa počítajú do rozhodného dňa.

Je PDF dostupné aj v iných jazykoch?

Áno, rozhranie aj PDF sa riadia jazykom používateľa. Súčasťou je nemecký preklad; pre ďalšie jazyky stačí súbor .po alebo preklad cez rozhranie Odoo.

Môže zákazník vidieť zoznam inej spoločnosti, ak zmení adresu?

Nie. Spoločnosť vždy vyplýva z prihláseného používateľa. Adresa obsahuje iba rozhodný deň. Aj adresa PDF správ Odoo sa priamo v správe znovu kontroluje.

Ako sa počíta platobná morálka?

Zo zaúčtovaných zákazníckych faktúr za posledných dvanásť mesiacov a zo všetkých otvorených faktúr. Pri každej faktúre sa počíta, koľko dní po splatnosti bola uhradená: najneskôr v deň splatnosti (zelená), do siedmich dní po nej (oranžová) alebo neskôr (červená). Hodnotenie je dobré pri aspoň 70 % zelených alebo oranžových faktúr a žiadnej otvorenej faktúre, ktorá je po splatnosti dlhšie ako 30 dní. Podrobnosti sú v časti platobnej morálke.

Prestavuje modul zákazníkov so zlou platobnou morálkou na platbu vopred?

Nie. Zobrazuje iba hodnotenie a poznámku. Platobné podmienky, platba vopred a blokovanie zostávajú vaším rozhodnutím a vaším procesom v Odoo.

Odosiela modul e-maily alebo upomienky?

Nie. Poskytuje iba stránku a PDF. Nevytvára správy, upozornenia ani aktivity.

Funguje modul s Odoo Enterprise?

Závisí iba od account a portal, ktoré existujú v oboch edíciách. Testovali sme ho iba na edícii Community Odoo 19.

Pod akou licenciou je modul?

Pod AGPL-3. Môžete ho používať, upravovať a šíriť, ak dodržíte licenčné podmienky. Chyby a návrhy na zlepšenie vítame ako Issue v repozitári GitHub .

Podpora od Biricon IT Services

Staráme sa o inštalácie Odoo pre malé a stredné podniky: od zavedenia cez úpravy a migrácie až po bežnú prevádzku. Ak chcete svojim zákazníkom poskytnúť v portáli otvorené položky, faktúry a tikety, rozšíriť účtovníctvo v Odoo Community alebo bezpečne preniesť modul do produkčnej inštancie, radi vám pomôžeme. Ďalšie vlastné vývoje: Archivácia firmy vrátane používateľov portálu, Obchodný register a overenie adries pre rakúskych zákazníkov, Čísla dokladov z prefixu, roka a počítadla a Sady produktov v ponuke ako sekcia.

Kontaktujte nás

Stav k 6. novembru 2026. Verzia modulu 19.0.1.1.1. Zmeny od prvej verzie z 5. novembra: platobná morálka (19.0.1.1.0) a oprava otvorenej sumy k rozhodnému dňu po čiastočných platbách (19.0.1.1.1). Všetky mená, čísla dokladov a sumy na obrázkoch sú úplne vymyslené.