Odoo 19: Otevřené 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.

Napsali jsme pro to modul Otevřené položky v zákaznickém portálu (portal_open_items) pro Odoo 19. Zákazníci s povoleným přístupem vidí v portálu seznam všech otevřených faktur, dobropisů a dosud nepřiřazených plateb své společnosti, mohou zvolit rozhodné datum, stáhnout seznam jako PDF a na první pohled vidí, jak na tom jsou se svou platební morálkou. Modul je svobodný software pod licencí AGPL-3 a nachází se 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čtu rozhodného data, k platební morálce a o omezeních .

Problém: seznam OP na zavolanou

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, my ji vidíme stále jako otevřenou. Společný seznam s datem, splatností a částkou to vyjasní rychleji než řetězec e-mailů.
• Platební dávky: Kdo připravuje platby týdně nebo měsíčně, potřebuje mít všechny otevřené faktury jednoho dodavatele na jednom místě, s položkami po splatnosti nahoře.
• Více kontaktních osob: Ve firmě objednává jeden a platí druhý. 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.

Řešení v kostce

Modul rozšiřuje zákaznický portál Odoo o stránku Otevřené položky a dlaždici na stránce Můj účet. Rozsah funkcí:

• Volba pro jednotlivý kontakt: „Zobrazit seznam otevřených položek v portálu“. Pouze pokud je nastavena, vidí uživatel portálu dlaždici i stránku. Ve výchozím nastavení je vypnutá.
• Celá společnost: Seznam 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í, co bylo k tomuto dni otevřené.
• Export do PDF: Seznam jako PDF v layoutu vaší společnosti, s hlavičkovým papírem, saldem 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čeny a zobrazují počet dní po datu splatnosti.
• Dobropisy a zálohy jsou v seznamu uvedeny se zápornou částkou a snižují saldo.
• Propojení: Každá faktura v seznamu vede na zobrazení faktury v portálu.
• Vícejazyčnost: Rozhraní i PDF se řídí jazykem uživatele, německý překlad je součástí.

Dlaždice se zobrazuje na úvodní stránce Můj účet vedle objednávek a faktur. Kdo volbu nemá, nevidí ji.

Aktivace pro jednotlivé kontakty: volba

Seznam OP zobrazuje obchodní údaje celé společnosti. Modul jej proto neaktivuje všem uživatelům portálu, ale pouze tam, kde to výslovně chcete. U kontaktu najdete ve formuláři na záložce Web zaškrtávací políčko „Zobrazit seznam otevřených položek v portálu“. Je viditelné pro uživatele s oprávněním k fakturaci (skupina account.group_account_invoice) a platí pro tento jeden kontakt.

Odpovídá to praxi: Ve firmě má seznam vidět vedení nebo účetní, zatímco zaměstnanec, který si prohlíží pouze tikety, nikoli. Volba platí pro kontakt, zobrazené položky však patří celé společnosti. Nastavte proto volbu u osoby, která má mít přehled o celé firmě.

Seznam 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 s otevřenými položkami:

Pod tabulkou se nachází saldo, tedy součet všech otevřených částek, a součet položek po splatnosti. Řádky po splatnosti jsou barevně podbarveny, aby byly při přelétnutí okamžitě vidět. Dobropisy a platby, které dosud nejsou přiřazeny k žádné faktuře, se zobrazují se záporným znaménkem a snižují saldo; upozornění pod tabulkou to zákazníkovi vysvětluje. Pokud vaše společnost účtuje ve více měnách, je saldo uvedeno za 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 se rozhodné datum počítá

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.

Prodlení se rovněž posuzuje k rozhodnému datu: Položka je po splatnosti, pokud její datum splatnosti předchází rozhodnému datu a zbytek je kladný. Dny po splatnosti se počítají do rozhodného data, nikoli do dneška. Rozhodné datum v budoucnosti se považuje za dnešek, stejně jako prázdné nebo neplatné datum v adresním řádku. Seznam tedy nemůže předstírat prognózu.

Co zde znamená „datum platby“

Rozhodující je datum, kdy byly faktura a platba v Odoo vzájemně spárovány (pozdější z obou dat zaúčtování), nikoli datum faktury. To je obvyklý případ: Platba se zaúčtuje v den připsání a přiřadí se k faktuře. Kdo platby přiřazuje až o několik dní později, vidí fakturu odpovídajícím způsobem déle jako otevřenou. Oddíl omezeních to rozebírá podrobněji.

Export do PDF

Pomocí Stáhnout PDF modul vygeneruje seznam jako soubor PDF pro zvolené rozhodné datum. Tlačítko Tisk otevře tentýž seznam v tiskovém dialogu prohlížeče. PDF používá layout dokumentů vaší společnosti v Odoo (logo, adresa, patička 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 neexistují, stojí tam „Neexistují žádné otevřené položky.“
• Adresa zákazníka v adresním poli layoutu společnosti, aby seznam seděl k věci i po vytištění.
• Položky po splatnosti tučně, aby byly nápadné i při černobílém tisku.
• Saldo a součet položek po splatnosti na konci tabulky, při více měnách za 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řístupu

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

• Pouze s nastavenou volbou. Bez zaškrtnutí u kontaktu neexistuje dlaždice a otevření /my/open-items přesměruje na Můj účet.
• Vždy vlastní firma. Firma se určuje z přihlášeného uživatele, nikoli z parametru v adrese. Neexistuje možnost vyžádat si přes adresní řádek cizí firmu.
• Stejná kontrola u PDF. Odoo zpřístupňuje PDF reporty zásadně i přes obecnou adresu. Modul proto přímo v reportu kontroluje znovu: PDF dostane pouze uživatel s účetním oprávněním nebo uživatel portálu s nastavenou volbou pro vlastní firmu, všichni ostatní chybu přístupu.
• Pouze zaúčtované položky. Koncepty a stornované doklady se nikdy nezobrazují.
• Pouze vlastní účetní okruhy: Zohledňují se pouze zápisy společností, k nimž má uživatel přístup.

Technické provedení

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

Otevřené položky se čtou z účetních řádků, nikoli z faktur. To je důležité: Jen tak se objeví i dobropisy a dosud nepřiřazené platby a jen tak lze stav k dřívějšímu dni zpětně dohledat ze spárování (account.partial.reconcile). Dotaz běží pro celou firmu (commercial_partner_id) se zvýšenými oprávněními, kontrola, zda ji uživatel smí vidět, je předřazena.

Testy

Modul obsahuje třináct automatických testů, které u nás procházejí zeleně:

• přístup pouze s nastavenou volbou, jinak přesměrování na Můj účet,
• seznam obsahuje položky celé firmy, ale nikdy položky jiné firmy,
• volba platí pro jednotlivý kontakt, nikoli pro všechny uživatele firmy,
• dobropisy jsou v seznamu se zápornou částkou a snižují saldo,
• rozhodné datum: později uhrazená faktura je před tímto datem v seznamu, po něm ne,
• stránka s budoucím a s neplatným datem,
• adresa PDF vrací soubor PDF,
• report jako HTML a kontrola přístupu v reportu,
• 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.

Navíc jsme stránku v testovací databázi s ukázkovými zákazníky projeli v prohlížeči, obrázky v tomto příspěvku pocházejí odtud. 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 třeba restartovat službu Odoo, protože modul obsahuje kód v Pythonu. Kdo provozuje produkční systém, nainstaluje modul nejprve na kopii databáze. Poté:

1. otevřít kontakt, který má seznam vidět (osoba s přístupem do portálu),
2. ve formuláři zaškrtnout políčko Zobrazit seznam otevřených položek v portálu a uložit,
3. přihlásit se do portálu jako tento uživatel nebo ověřit společně se zákazníkem: dlaždici, seznam, rozhodné datum a PDF.

Před aktivací zkontrolujte nastavení odesílatele a layoutu své společnosti, protože PDF přebírá logo, adresu a patičku z layoutu dokumentů. Modul sám neodesílá žádné e-maily a nevytváří žádná oznámení.

Omezení a upozornění

• Aktuální stav zaúčtovaných dokladů. Rozhodné datum se počítá na základě zápisů tak, jak jsou nyní v systému. Pokud byla po rozhodném datu faktura stornována nebo vrácena do konceptu, seznam ji nezobrazí. Nejde o neměnnou momentku „tak, jak byla tehdy vytištěna“.
• Platby se počítají ode dne spárování. Pokud je platba přiřazena až několik dní po přijetí faktury, je faktura do té doby v seznamu uvedena jako otevřená. Kdo chce čisté vyhodnocení k rozhodnému datu, měl by platby přiřazovat včas. Párování bankovních výpisů s fakturami není v Odoo Community obsaženo; 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 zákazníkovi.
• Žádné upomínací stupně a žádný odkaz k platbě v seznamu. Zákazník může ze seznamu otevřít fakturu a tam ji zaplatit, jak to váš portál jinak umožňuje.
• PDF a vícenásobné pracovní procesy. Odoo při generování PDF reportů interně volá vlastní webovou adresu. Pokud váš systém běží jen s jedním pracovním procesem, může to způsobit zablokování. Týká se to všech PDF reportů v portálu, nejen tohoto modulu. Po instalaci jednou vyzkoušejte tlačítko PDF za reálných podmínek.
• Testováno pouze s Odoo 19.0 Community. Pro jiné verze jsme jej nezkoušeli.
• 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.

Často kladené otázky

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

Přehled všech faktur, které dosud nejsou nebo nejsou zcela uhrazeny, s datem faktury, splatností a otevřenou částkou. Nazývá se také „otevřené faktury“, „zákaznický účet“ nebo „rozvaha sald“, přičemž rozvaha sald v užším slova smyslu znamená salda všech účtů.

Proč portál Odoo neobsahuje seznam OP už ve výchozím stavu?

Portál zobrazuje objednávky, faktury a platby jednotlivě, se stavem a filtry. Souhrnný seznam společnosti se saldem a vyhodnocení k rozhodnému datu nejsou podle našich zjištění součástí Community. K tomu je modul určen.

Vidí seznam všichni uživatelé portálu jedné firmy?

Ne. Pouze kontakty s nastavenou volbou. Zobrazený seznam však zahrnuje celou firmu, nejen faktury tohoto jednoho kontaktu.

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

Ano, libovolné datum do dneška. Seznam pak zobrazí položky, které byly k tomuto dni zaúčtovány a dosud neuhrazeny. Dbejte na upozornění k výpočtu: Rozhodující je den spárování platby.

Podporuje se rozhodné datum v budoucnosti?

Ne. Budoucí data se považují za dnešek, aby seznam neukazoval stav, který ještě neexistuje.

Zobrazují se v seznamu dobropisy a zálohy?

Ano. Dobropisy a platby, které dosud nejsou přiřazeny k žádné faktuře, jsou v seznamu uvedeny se zápornou částkou a snižují saldo. Upozornění pod tabulkou to zákazníkovi vysvětluje.

Jak se poznají položky po splatnosti?

Položka je po splatnosti, pokud její datum splatnosti předchází rozhodnému datu a stále je otevřený kladný zbytek. Dny po splatnosti se počítají do rozhodného data.

Existuje PDF také 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 přes rozhraní Odoo.

Může zákazník vidět seznam jiné firmy, pokud změní adresu?

Ne. Firma vždy vyplývá z přihlášeného uživatele. Adresa obsahuje pouze rozhodné datum. I adresa PDF reportu Odoo se přímo v reportu znovu kontroluje.

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. Poskytuje pouze stránku a PDF. Nevytváří žádné zprávy, oznámení ani aktivity.

Funguje modul s Odoo Enterprise?

Závisí pouze na account a portal, které existují v obou edicích. Testovali jsme jej pouze na edici Community Odoo 19.

Pod jakou licencí modul je?

Pod AGPL-3. Můžete jej používat, upravovat a šířit, pokud dodržíte licenční podmínky. Chyby a návrhy na zlepšení jsou vítány jako issue v repozitáři GitHub .

Podpora ze strany Biricon IT Services

Pečujeme o instalace Odoo pro malé a střední podniky: od zavedení přes úpravy a migrace až po běžný provoz. Pokud chcete svým zákazníkům v portálu zpřístupnit otevřené položky, faktury a tikety, rozšířit účetnictví v Odoo Community nebo bezpečně nasadit modul do své produkční instance, rádi vám pomůžeme. Další vlastní vývoje: Archivace firmy včetně uživatelů portálu, Obchodní rejstřík a ověření adres pro rakouské zákazníky, Čísla dokladů z prefixu, roku a počítadla a Sady produktů v nabídce jako sekce.

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é.