Odoo 19: Neuhrazené položky v zákaznickém portálu s rozhodným datem a exportem do PDF – modul portal_open_items

„Kolik vlastně u vás ještě máme otevřeno?“ Tato otázka se u každé zákaznické základny objevuje pravidelně, většinou krátce před koncem čtvrtletí, před auditem roční účetní závěrky nebo když účetní zákazníka připravuje platby. Kdo na ni neodpoví sám, dostane ji e-mailem nebo telefonicky a někdo musí z účetnictví vyexportovat a odeslat seznam otevřených položek (OP). V Odoo 19 Community to samo od sebe nefunguje: zákaznický portál sice zobrazuje jednotlivé faktury, ale ne seznam otevřených položek celé společnosti, a to už vůbec ne k libovolně zvolenému dni.

Proto jsme pro Odoo 19 vytvořili modul Otevřené položky v zákaznickém portálu (portal_open_items). Zákazníci s povoleným přístupem vidí v portálu přehled všech neuhrazených faktur, dobropisů a dosud nepřiřazených plateb své společnosti, mohou zvolit rozhodné datum a stáhnout si přehled jako PDF. Modul je svobodný software pod licencí AGPL-3 a je dostupný na GitHubu:

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

Modul jsme nainstalovali 5. listopadu 2026 v našem produkčním systému. Volba je tam ve výchozím stavu vypnutá a nastavuje se pouze po dohodě s jednotlivými zákazníky. Zkušenosti z provozu jsou tedy zatím krátké; testovali jsme třinácti automatickými testy a testovací databází s ukázkovými zákazníky. Kdo modul přebírá, měl by si pozorně přečíst sekce k Výpočet k rozhodnému datu, k platební morálce a k Omezení přečíst.

Problém: přehled otevřených položek na vyžádání

Seznam otevřených položek ukazuje, které faktury zákazníka dosud nejsou uhrazeny, kolik z toho je po splatnosti a jak vysoké je saldo. Pro dodavatele je nástrojem plánování likvidity a upomínání. Pro zákazníka je podkladem pro plánování plateb, odsouhlasení faktur s vlastním účetnictvím a vyjasňování otázek, aniž by musel otevírat každou fakturu zvlášť. Typické příležitosti:

• Čtvrtletní a roční závěrka: Účetní zákazníka chce vědět, jaké závazky existovaly k 31. 12. Jde o rozhodné datum v minulosti.
• Odsouhlasení: Zákazník se domnívá, že fakturu zaplatil, ale my ji stále evidujeme jako neuhrazenou. Společný přehled s datem, splatností a částkou pomůže situaci vyjasnit rychleji než řetězec e-mailů.
• Příprava plateb: Kdo připravuje platby každý týden nebo měsíc, potřebuje mít všechny neuhrazené faktury od dodavatele na jednom místě, s fakturami po splatnosti nahoře.
• Více kontaktních osob: Ve firmě jeden člověk objednává a jiný platí. Otevřené položky patří firmě, nikoli jednotlivé osobě.

Dosud jsme tyto seznamy ručně vytahovali z účetnictví a posílali e-mailem. To stojí čas a výsledkem je momentka, která je už další den zastaralá. Lepší je seznam, který si zákazník může kdykoli sám otevřít v portálu, vždy s aktuálním stavem.

Přehled řešení

Modul přidává do zákaznického portálu Odoo stránku Otevřené položky a dlaždici na stránku Můj účet. Nabízí tyto funkce:

• Nastavení pro jednotlivé kontakty: „Zobrazit přehled otevřených položek v portálu“. Uživatel portálu vidí dlaždici a stránku pouze tehdy, když je tato možnost zaškrtnutá. Ve výchozím stavu je vypnutá.
• Celá společnost: Přehled obsahuje otevřené položky všech kontaktů firmy, nejen přihlášeného uživatele.
• Rozhodné datum: Zákazník zvolí datum a uvidí, které položky byly k tomuto dni otevřené.
• Export do PDF: Přehled ve formátu PDF s firemní úpravou, hlavičkou, zůstatkem a součtem položek po splatnosti.
• Platební morálka: podíl faktur zaplacených včas, s malým zpožděním a pozdě, nejdéle otevřená faktura a hodnocení dobré nebo špatné, v portálu i v PDF.
• Položky po splatnosti jsou barevně označené a zobrazují počet dnů po splatnosti.
• Dobropisy a přeplatky se v přehledu zobrazují se zápornou částkou a snižují zůstatek.
• Odkazy: Každá faktura v přehledu odkazuje na svůj detail v portálu.
• Vícejazyčnost: Rozhraní i PDF se zobrazují v jazyce uživatele, součástí je německý překlad.

Dlaždice se zobrazí na úvodní stránce Můj účet vedle objednávek a faktur. Uživatelé, kteří nemají tuto možnost povolenou, ji nevidí.

Zpřístupnění jednotlivým kontaktům: nastavení

Přehled otevřených položek zobrazuje obchodní údaje celé firmy. Modul ho proto nezpřístupňuje všem uživatelům portálu, ale pouze těm, kterým přístup výslovně povolíte. Ve formuláři kontaktu je v části Web zaškrtávací políčko „Zobrazit přehled otevřených položek v portálu“. Vidí ho uživatelé s oprávněním k fakturaci (skupina account.group_account_invoice) a platí pouze pro daný kontakt.

To odpovídá praxi: ve firmě má přehled vidět vedení nebo účetní oddělení, nikoli zaměstnanec, který pouze nahlíží do požadavků podpory. Nastavení platí pro daný kontakt, ale zobrazené položky patří celé společnosti. Možnost tedy zaškrtněte u osoby, která má mít přehled o celé firmě.

Přehled v zákaznickém portálu

Kliknutím na dlaždici se otevře /my/open-items. Stránka zobrazuje název firmy, výběr rozhodného data a tabulku otevřených položek:

Pod tabulkou je uveden zůstatek, tedy součet všech neuhrazených částek, a součet položek po splatnosti. Řádky po splatnosti mají barevné pozadí, aby byly ihned patrné i při zběžném prohlížení. Dobropisy a platby, které dosud nejsou přiřazené k žádné faktuře, se zobrazují se záporným znaménkem a snižují zůstatek. Zákazníkovi to vysvětluje poznámka pod tabulkou. Pokud vaše společnost účtuje ve více měnách, zůstatek se uvádí pro každou měnu zvlášť.

Otevřené položky k rozhodnému datu

Nad datem je nadpis „Otevřené položky k rozhodnému datu“, vedle něj pole pro datum a tlačítko Zobrazit. S rozhodným datem v minulosti zobrazuje seznam, co bylo k tomuto dni ještě neuhrazeno. To je přesně ten výstup, který se potřebuje pro závěrky, audity a odsouhlasení: „Jaké závazky jsme měli k 31. 12. u tohoto dodavatele?“

Jak funguje výpočet k rozhodnému datu

Pro každou položku platí: Otevřeno k rozhodnému datu = částka faktury minus všechny platby, které byly spárovány nejpozději k rozhodnému datu včetně. Položka patří do seznamu, pokud byla k rozhodnému datu již zaúčtována a měla tam ještě zbytek. Faktura ze 7. září na 1.250,50 €, která byla 20. října částečně uhrazena částkou 500,00 € a 5. listopadu doplacena, je tedy při rozhodném datu 2. listopadu v seznamu s částkou 750,50 € a při rozhodném datu 5. listopadu už vůbec ne.

Také stav po splatnosti se posuzuje k rozhodnému datu: položka je po splatnosti, pokud její datum splatnosti předchází rozhodnému datu a zbývající částka je kladná. Dny po splatnosti se počítají do rozhodného data, nikoli do dneška. Rozhodné datum v budoucnosti se nahradí dnešním datem, stejně jako prázdné nebo neplatné datum v adresním řádku. Přehled tak nemůže budit zdání prognózy.

Co zde znamená „datum platby“

Rozhodující je datum, ke kterému byly faktura a platba v Odoo vzájemně spárovány (pozdější z obou dat zaúčtování), nikoli datum faktury. Obvykle je postup takový, že se platba v den přijetí zaúčtuje a přiřadí k faktuře. Pokud platby přiřazujete až o několik dnů později, faktura se bude odpovídajícím způsobem déle zobrazovat jako neuhrazená. Část Omezení se tomu věnuje podrobněji.

Export do PDF

Pomocí Stáhnout PDF modul vytvoří přehled ve formátu PDF ke zvolenému rozhodnému datu. Tlačítko Tisk otevře tentýž přehled v tiskovém dialogu prohlížeče. PDF používá rozvržení dokumentů vaší společnosti v Odoo (logo, adresu a zápatí z nastavení) a evropský formát papíru:

• Nadpis s rozhodným datem: „Otevřené položky k rozhodnému datu 02.11.2026“, i když je rozhodným datem dnešek. Pokud žádné otevřené položky nejsou, zobrazí se „Nejsou žádné otevřené položky.“
• Adresa zákazníka v adresním poli firemní šablony, aby bylo i z vytištěného přehledu jasné, komu je určen.
• Položky po splatnosti tučně, aby vynikly i při černobílém tisku.
• Zůstatek a součet položek po splatnosti na konci tabulky, při více měnách pro každou měnu zvlášť.
• Název souboru s firmou a datem, například Open_items_Muster_Handels_GmbH_2026-11-02.pdf.

Platební morálka: hodnocení na první pohled

Od verze 19.0.1.1.0 je nad tabulkou krátké vyhodnocení, jak včas společnost své faktury platí. Stejné vyhodnocení se objeví i v PDF. Zákazník tak sám vidí, jak na tom je, a vy mu to již nemusíte zvlášť vysvětlovat.

• Zelená: „47 % bylo zaplaceno v rámci lhůty splatnosti.“ Myslí se faktury zaplacené v den splatnosti nebo dříve.
• Oranžová: „29 % bylo zaplaceno v týdnu po uplynutí lhůty splatnosti.“ Jde o platby jeden až sedm dní po splatnosti.
• Červená: „24 % bylo zaplaceno později, v průměru po 39 dnech (25 dnů po uplynutí lhůty splatnosti).“ První číslo se počítá od data vystavení faktury, číslo v závorce od splatnosti. Řádek se objeví jen tehdy, pokud takové faktury existují.
• „Faktury jsou otevřené až 60 dní.“ To je stáří nejstarší faktury, která je k rozhodnému datu stále otevřená, počítáno od data vystavení faktury.

Pod tím je hodnocení platební morálky: dobré nebo špatné a na konci stránky, v PDF na konci stránky, upozornění „Zákazníci se špatnou platební morálkou budou převedeni na platbu předem.“ PDF zobrazuje stejné řádky v rozvržení s hlavičkovým papírem:

Co se počítá

• Hodnotí se faktury zákazníkovi, které jsou zaúčtované. Dobropisy a koncepty se nepočítají. Při splátkách se každá splátka počítá zvlášť.
• Období: faktury za posledních dvanáct měsíců a všechny faktury, které jsou ještě otevřené, i když jsou starší.
• Dnem platby je datum posledního odsouhlasení s platbou, stejně jako u rozhodného data.
• Otevřené faktury: Je-li faktura k rozhodnému datu po splatnosti, počítá se, jako by byla zaplacena k rozhodnému datu, tedy oranžově nebo červeně. Otevřená faktura, která ještě není splatná, se nehodnotí.
• U rozhodného data v minulosti platí stav k tomuto dni: platby po rozhodném datu se zatím nepočítají.
• Pokud není co hodnotit, objeví se tam „Žádné faktury za posledních 12 měsíců k hodnocení.“ a hodnocení se nezobrazí.

Kdy je platební morálka „dobrá“?

Hodnocení je dobré, pokud je alespoň 70 % faktur zelených nebo oranžových (včas nebo nejvýše o týden později) a zároveň žádná otevřená faktura není po splatnosti déle než 30 dní. Jinak je špatné. Prahové hodnoty (7 dní, 70 %, 30 dní, 12 měsíců) jsou uvedeny jako konstanty na začátku souboru models/res_partner.py a lze je tam upravit.

Důležité: modul nikoho nepřevádí na platbu předem. Upozornění v zápatí je pevný text, který zákazníkům se špatným hodnocením ukazuje, co z toho může vyplynout. Zda a kdy tak rozhodnete, zůstává na vás. Pokud se vám věta nelíbí, změňte ji v obou šablonách (stránka portálu a report) nebo v překladu.

Kdo co smí vidět? Model přístupových práv

Otevřené položky jsou citlivé údaje, proto pro nás bylo řízení přístupu důležitější než jakákoli doplňková funkce. Model je záměrně jednoduchý:

• Pouze se zaškrtnutou možností. Bez zaškrtnutí u kontaktu se dlaždice nezobrazí a otevření /my/open-items přesměruje uživatele na Můj účet.
• Vždy vlastní firma. Firma se určuje podle přihlášeného uživatele, nikoli podle parametru v adrese. Přes adresní řádek nelze vyžádat údaje cizí firmy.
• Stejná kontrola i u PDF. Odoo standardně zpřístupňuje sestavy PDF také přes obecnou adresu. Modul proto provádí další kontrolu přímo v sestavě: PDF získají pouze uživatelé s účetním oprávněním nebo uživatelé portálu s povolenou možností pro vlastní firmu. Všem ostatním se zobrazí chyba přístupu.
• Pouze zaúčtované položky. Koncepty ani stornované doklady se nikdy nezobrazují.
• Pouze přístupné účetní jednotky: Zohledňují se pouze účetní zápisy společností, ke kterým má uživatel přístup.

Technické řešení

Modul závisí pouze na account a portal, tedy na součástech Odoo Community. Ke kontaktu přidává jediné pole a jinak se skládá z kontroleru, třídy sestavy a šablon.

Otevřené položky se načítají z řádků účetních zápisů, nikoli z faktur. To je důležité: jedině tak se zobrazí i dobropisy a dosud nepřiřazené platby a jedině tak lze ze spárování (account.partial.reconcile) zpětně zjistit stav k dřívějšímu dni. Dotaz se provádí pro celou firmu (commercial_partner_id) se zvýšenými oprávněními. Kontrola, zda uživatel smí údaje vidět, probíhá před ním.

Testy

Modul obsahuje osm automatických testů, které u nás úspěšně procházejí:

• přístup pouze s povolenou možností, jinak přesměrování na Můj účet,
• přehled obsahuje položky celé firmy, ale nikdy položky jiné firmy,
• nastavení platí pro jednotlivý kontakt, nikoli pro všechny uživatele firmy,
• dobropisy se v seznamu zobrazují se zápornou částkou a snižují zůstatek,
• rozhodné datum: faktura uhrazená později je před datem úhrady v seznamu uvedena, po něm už ne,
• stránka s budoucím a s neplatným datem,
• adresa PDF vrací soubor PDF,
• sestava ve formátu HTML a kontrola přístupu přímo v sestavě.
• otevřená částka k rozhodnému datu po částečných platbách před rozhodným datem a po něm,
• platební morálka: rozdělení na včas, nejvýše o týden později a později, s průměrnými hodnotami, i pro rozhodné datum v minulosti,
• platební morálka s otevřenými fakturami a hodnocení dobré nebo špatné,
• platební morálka bez faktur a nikdy s údaji jiné firmy,
• platební morálka na stránce portálu a v PDF.

Stránku jsme navíc vyzkoušeli v prohlížeči na testovací databázi s ukázkovými zákazníky. Odtud pocházejí i obrázky v tomto článku. Všechna jména, čísla dokladů a částky na nich jsou smyšlené.

Instalace a nastavení

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ávislostmi jsou account a portal. Po instalaci je nutné restartovat službu Odoo, protože modul obsahuje kód v Pythonu. Pokud provozujete produkční systém, nainstalujte modul nejprve na kopii databáze. Poté:

1. otevřete kontakt, který má přehled vidět (osoba s přístupem do portálu),
2. ve formuláři zaškrtněte políčko Zobrazit přehled otevřených položek v portálu a uložte změny,
3. přihlaste se do portálu jako tento uživatel nebo společně se zákazníkem zkontrolujte dlaždici, přehled, rozhodné datum a PDF.

Před zpřístupněním zkontrolujte nastavení údajů o odesílateli a rozvržení dokumentů vaší firmy, protože PDF přebírá logo, adresu a zápatí právě z tohoto rozvržení. Modul sám neposílá e-maily ani nevytváří oznámení.

Omezení a poznámky

• Aktuální stav zaúčtovaných dokladů. Výpočet k rozhodnému datu vychází z účetních zápisů v podobě, v jaké jsou právě teď v systému. Pokud byla faktura po rozhodném datu stornována nebo vrácena do konceptu, přehled ji nezobrazí. Nejde o neměnný snímek stavu „tak, jak byl tehdy vytištěn“.
• Platby se započítávají ode dne spárování. Pokud platbu přiřadíte k faktuře až několik dní po přijetí platby, bude faktura do té doby v přehledu vedena jako neuhrazená. Chcete-li mít přesné přehledy k rozhodnému datu, přiřazujte platby včas. Odoo Community neobsahuje párování bankovních transakcí s fakturami; používáme k tomu náš modul Bank-Statement-Matcher.
• Platební morálka je tak dobrá, jako je vaše odsouhlasení. Počítá se, kdy byla platba přiřazena k faktuře. Platby, které se dlouho neodsouhlasily, způsobují, že zákazník vypadá hůř, než je. Před vyvozením jakýchkoli závěrů hodnocení u svých zákazníků zkontrolujte.
• Hodnocení je pro zákazníka viditelné. Kdo má volbu, vidí i výsledek a upozornění na platbu předem. Modul přitom nic nemění na platebních podmínkách.
• Pouze pohledávky. Modul zobrazuje, co vám zákazník dluží, nikoli vaše závazky vůči němu.
• Bez úrovní upomínání a platebního odkazu v přehledu. Zákazník může z přehledu otevřít fakturu a zaplatit ji tam, pokud to váš portál běžně umožňuje.
• PDF a provoz s více procesy. Odoo při vytváření PDF sestav interně volá svou vlastní webovou adresu. Pokud váš systém běží pouze s jedním pracovním procesem, může se tím zablokovat. To platí pro všechny PDF sestavy v portálu, nejen pro tento modul. Po instalaci vyzkoušejte tlačítko PDF v reálných provozních podmínkách.
• Testováno pouze v Odoo 19.0 Community. V jiných verzích jsme modul neověřovali.
• Není náhradou upomínacího procesu a výpisu z účtu. Seznam nenahrazuje ani účetní výpis z účtu, ani vaše upomínací procesy, pouze činí stav transparentním.

Časté dotazy

Co je seznam otevřených položek (seznam OP)?

Seznam všech faktur, které dosud nebyly zaplaceny vůbec nebo byly zaplaceny jen částečně, s datem vystavení, splatností a neuhrazenou částkou. Používají se také názvy „neuhrazené faktury“, „zákaznický účet“ nebo „přehled zůstatků“, přičemž přehled zůstatků v užším smyslu zahrnuje zůstatky všech účtů.

Proč portál Odoo nenabízí přehled neuhrazených položek už v základu?

Portál zobrazuje objednávky, faktury a platby samostatně, se stavy a filtry. Souhrnný přehled za celou firmu se zůstatkem a vyhodnocením k rozhodnému datu podle našich zjištění není součástí edice Community. Právě k tomu slouží tento modul.

Vidí přehled všichni uživatelé portálu dané firmy?

Ne. Pouze kontakty, u kterých je zapnutá příslušná volba. Zobrazený přehled však zahrnuje celou firmu, nikoli jen faktury daného kontaktu.

Mohu zvolit rozhodné datum z minulosti, například 31. 12. předchozího roku?

Ano, libovolné datum až do dneška. Přehled pak zobrazí položky, které byly k danému dni zaúčtované a dosud neuhrazené. Věnujte pozornost části Poznámky k výpočtu: Rozhodující je den spárování platby.

Lze zvolit rozhodné datum v budoucnosti?

Ne. Budoucí datum se posuzuje jako dnešní, aby přehled nezobrazoval stav, který ještě nenastal.

Zobrazují se v přehledu dobropisy a zálohy?

Ano. Dobropisy a platby, které dosud nebyly přiřazeny k žádné faktuře, se v přehledu zobrazují se zápornou částkou a snižují zůstatek. Vysvětluje to poznámka pro zákazníka pod tabulkou.

Jak se určují položky po splatnosti?

Položka je po splatnosti, pokud její datum splatnosti předchází rozhodnému datu a zbývá u ní kladná neuhrazená částka. Počet dní po splatnosti se počítá k rozhodnému datu.

Je PDF dostupné i v jiných jazycích?

Ano, rozhraní i PDF se řídí jazykem uživatele. Součástí je německý překlad; pro další jazyky stačí soubor .po nebo překlad prostřednictvím rozhraní Odoo.

Může zákazník zobrazit přehled jiné firmy, pokud změní adresu?

Ne. Firma se vždy určuje podle přihlášeného uživatele. Adresa obsahuje pouze rozhodné datum. I při přístupu přes adresu PDF sestavy v Odoo se oprávnění znovu ověřuje přímo v sestavě.

Jak se platební morálka počítá?

Ze zaúčtovaných zákaznických faktur za posledních dvanáct měsíců a ze všech otevřených faktur. U každé faktury se počítá, kolik dní po splatnosti byla zaplacena: nejvýše v den splatnosti (zelená), až sedm dní poté (oranžová) nebo později (červená). Hodnocení je dobré při alespoň 70 % zelených nebo oranžových a žádné faktuře, která je otevřená déle než 30 dní po splatnosti. Podrobnosti jsou v sekci platební morálce.

Převádí modul zákazníky se špatnou platební morálkou na platbu předem?

Ne. Zobrazuje pouze hodnocení a upozornění. Platební podmínky, platba předem a blokace zůstávají vaším rozhodnutím a vaším procesem v Odoo.

Odesílá modul e-maily nebo upomínky?

Ne. Zpřístupňuje pouze stránku a PDF. Nevytváří žádné zprávy, oznámení ani aktivity.

Funguje modul s Odoo Enterprise?

Závisí pouze na modulech account a portal, které jsou dostupné v obou edicích. Testovali jsme ho pouze v edici Community systému Odoo 19.

Pod jakou licencí je modul dostupný?

Pod licencí AGPL-3. Můžete jej používat, upravovat a dále šířit, pokud dodržíte licenční podmínky. Hlášení chyb a návrhy na vylepšení ve formě issues v repozitáři na GitHubu vítány.

Podpora od Biricon IT Services

Spravujeme instalace Odoo pro malé a střední firmy: od zavedení přes úpravy a migrace až po běžný provoz. Pokud chcete zákazníkům v portálu zpřístupnit neuhrazené položky, faktury a požadavky podpory, rozšířit účetnictví v Odoo Community nebo bezpečně nasadit modul do produkčního prostředí, rádi vám pomůžeme. Další moduly z našeho vývoje: Archivace firmy včetně uživatelů portálu, Obchodní rejstřík a ověřování adres pro rakouské zákazníky, Čísla dokladů tvořená předponou, rokem a pořadovým číslem a Produktové sady jako oddíl v nabídce.

Kontaktujte nás

Stav k 6. listopadu 2026. Verze modulu 19.0.1.1.1. Změny od první verze z 5. listopadu: platební morálka (19.0.1.1.0) a oprava otevřené částky k rozhodnému datu po částečných platbách (19.0.1.1.1). Všechna jména, čísla dokladů a částky na obrázcích jsou smyšlené.