Odoo 19: openstaande posten in het klantenportaal met peildatum en pdf-export – module portal_open_items

“Hoeveel staat er eigenlijk nog open bij u?” Die vraag komt bij elk klantenbestand regelmatig voorbij, meestal vlak voor het einde van het kwartaal, vóór de controle van de jaarrekening of wanneer de boekhouding van de klant betalingen voorbereidt. Wie de vraag niet zelf beantwoordt, krijgt haar per e-mail of telefoon gesteld, en iemand moet een lijst met openstaande posten (OP-lijst) uit de boekhouding exporteren en versturen. Met Odoo 19 Community gaat dat niet vanzelf: het klantenportaal toont weliswaar de afzonderlijke facturen, maar geen lijst van de openstaande posten van het hele bedrijf, en al helemaal niet op een vrij gekozen dag.

Daarvoor hebben we de module Openstaande posten in het klantenportaal (portal_open_items) voor Odoo 19 geschreven. Klanten met geactiveerde toegang zien in het portaal een lijst van alle openstaande facturen, creditnota’s en nog niet toegewezen betalingen van hun bedrijf, kunnen een peildatum kiezen, de lijst als PDF downloaden en zien in één oogopslag hoe het met hun betaalmoraal gesteld is. De module is vrije software onder de AGPL-3-licentie en staat op GitHub:

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

We hebben de module op 5 november 2026 in ons productiesysteem geïnstalleerd. De optie staat daar standaard uit en wordt alleen na overleg met individuele klanten ingesteld. De praktijkervaring is dus nog kort; getest hebben we met dertien automatische tests en een testdatabase met voorbeeldklanten. Wie de module overneemt, moet de secties over de berekening van de peildatum, over de betaalmoraal en over de beperkingen lezen.

Het probleem: een OP-lijst op verzoek

Een lijst met openstaande posten toont welke facturen van een klant nog niet zijn betaald, welk deel daarvan achterstallig is en hoe hoog het saldo is. Voor de leverancier is het een instrument voor liquiditeitsplanning en debiteurenbeheer. Voor de klant is het de basis om betalingen te plannen, facturen af te stemmen met de eigen boekhouding en vragen op te lossen zonder elke factuur afzonderlijk te openen. Typische aanleidingen:

• Kwartaal- en jaarafsluiting: De boekhouding van de klant wil weten welke schulden er op 31 december bestonden. Dat is een peildatum in het verleden.
• Afstemming: De klant meent een factuur te hebben betaald, wij zien hem nog als openstaand. Een gezamenlijke lijst met datum, vervaldatum en bedrag lost dat sneller op dan een keten van e-mails.
• Betalingsrondes: Wie wekelijks of maandelijks betalingen voorbereidt, heeft alle openstaande facturen van een leverancier in één overzicht nodig, met de achterstallige bovenaan.
• Meerdere contactpersonen: In een bedrijf bestelt de een en betaalt de ander. De openstaande posten horen bij het bedrijf, niet bij één afzonderlijke persoon.

Tot nu toe haalden wij deze lijsten handmatig uit de boekhouding en stuurden ze per e-mail. Dat kost tijd en is uiteindelijk een momentopname die al de volgende dag verouderd is. Beter is een lijst die de klant zelf op elk moment in het portaal opent, altijd met de actuele stand.

De oplossing in het kort

De module vult het Odoo-klantenportaal aan met een pagina Openstaande posten en een tegel op Mijn account. De functies:

• Optie per contactpersoon: “Lijst met openstaande posten in het portaal tonen”. Alleen als deze is ingesteld, ziet de portaalgebruiker de tegel en de pagina. Standaard is de optie uitgeschakeld.
• Het hele bedrijf: De lijst bevat de openstaande posten van alle contactpersonen van het bedrijf, niet alleen die van de aangemelde gebruiker.
• Peildatum: De klant kiest een datum en ziet wat er op die dag openstond.
• Pdf-export: De lijst als PDF in de opmaak van uw bedrijf, met briefhoofd, saldo en totaal van de achterstallige posten.
• Betaalmoraal: aandeel van de op tijd, net te laat en laat betaalde facturen, de langst openstaande factuur en een beoordeling goed of slecht, in het portaal en in de PDF.
• Achterstallige posten zijn gekleurd gemarkeerd en tonen het aantal dagen na de vervaldatum.
• Creditnota’s en tegoeden staan met een negatief bedrag in de lijst en verlagen het saldo.
• Koppeling: Elke factuur in de lijst leidt naar de factuurweergave in het portaal.
• Meertalig: Interface en PDF volgen de taal van de gebruiker; een Duitse vertaling is bijgevoegd.

De tegel verschijnt op de startpagina Mijn account naast de orders en facturen. Wie de optie niet heeft, ziet hem niet.

Toegang per contactpersoon: de optie

Een OP-lijst toont bedrijfsgegevens van een heel bedrijf. Daarom activeert de module haar niet voor alle portaalgebruikers, maar alleen waar u dat uitdrukkelijk wilt. Bij de contactpersoon staat in het formulier onder Website het selectievakje “Lijst met openstaande posten in het portaal tonen”. Het is zichtbaar voor gebruikers met factuurrechten (groep account.group_account_invoice) en werkt voor deze ene contactpersoon.

Dat sluit aan bij de praktijk: in een bedrijf moet de directie of de boekhouding de lijst zien, een medewerker die alleen tickets bekijkt daarentegen niet. De optie geldt voor de contactpersoon, maar de getoonde posten horen bij het hele bedrijf. Stel de optie dus in bij de persoon die het overzicht over het bedrijf moet hebben.

De lijst in het klantenportaal

Een klik op de tegel opent /my/open-items. De pagina toont de bedrijfsnaam, de keuze van de peildatum en de tabel met de openstaande posten:

Onder de tabel staan het saldo, dus de som van alle openstaande bedragen, en het totaal van de achterstallige posten. Achterstallige regels zijn gekleurd, zodat u ze bij het doorbladeren meteen ziet. Creditnota’s en betalingen die nog niet aan een factuur zijn toegewezen, verschijnen met een negatief teken en verlagen het saldo; een opmerking onder de tabel legt dat aan de klant uit. Werkt uw bedrijf in meerdere valuta, dan wordt het saldo per valuta weergegeven.

Openstaande posten per peildatum

Boven de datum staat “Openstaande posten per peildatum”, ernaast een datumveld en de knop Weergeven. Met een peildatum in het verleden toont de lijst wat er op die dag nog niet was betaald. Dat is precies de analyse die nodig is voor jaarafsluitingen, controles en afstemmingen: “Welke schulden hadden we op 31 december bij deze leverancier?”

Hoe de peildatum wordt berekend

Voor elke post geldt: Openstaand per peildatum = factuurbedrag min alle betalingen die tot en met de peildatum waren afgeletterd. Een post komt op de lijst als hij op de peildatum al was geboekt en toen nog een restant had. Een factuur van 7 september van 1.250,50 €, die op 20 oktober met 500,00 € gedeeltelijk is betaald en op 5 november met het restant is voldaan, staat dus bij een peildatum van 2 november met 750,50 € op de lijst en bij een peildatum van 5 november helemaal niet meer.

De achterstalligheid wordt eveneens per peildatum beoordeeld: een post is achterstallig als zijn vervaldatum vóór de peildatum ligt en het restant positief is. De dagen na de vervaldatum worden geteld tot de peildatum, niet tot vandaag. Een peildatum in de toekomst wordt behandeld als vandaag, evenals een lege of ongeldige datum in de adresbalk. De lijst kan dus geen prognose voorwenden.

Wat “datum van de betaling” hier betekent

Bepalend is de datum waarop factuur en betaling in Odoo met elkaar zijn afgeletterd (de latere van de twee boekingsdatums), niet de factuurdatum. Dat is het gebruikelijke geval: de betaling wordt op de dag van ontvangst geboekt en aan de factuur toegewezen. Wie betalingen pas dagen later toewijst, ziet de factuur dienovereenkomstig langer als openstaand. De sectie beperkingen gaat hier nader op in.

Pdf-export

Via PDF downloaden genereert de module de lijst als pdf-bestand voor de gekozen peildatum. De knop Afdrukken opent dezelfde lijst in het afdrukvenster van de browser. De PDF gebruikt de documentopmaak van uw Odoo-bedrijf (logo, adres, voettekst uit de instellingen) en het Europese papierformaat:

• Kop met peildatum: “Openstaande posten per peildatum 02.11.2026”, ook als de peildatum vandaag is. Zijn er geen openstaande posten, dan staat daar “Er zijn geen openstaande posten.”
• Adres van de klant in het adresveld van de bedrijfsopmaak, zodat de lijst ook uitgeprint bij de zaak past.
• Achterstallige posten vet gedrukt, zodat ze ook in zwart-wit opvallen.
• Saldo en totaal van achterstallige posten aan het einde van de tabel, bij meerdere valuta per valuta.
• Bestandsnaam met bedrijf en datum, bijvoorbeeld Open_items_Muster_Handels_GmbH_2026-11-02.pdf.

Betaalmoraal: beoordeling in één oogopslag

Sinds versie 19.0.1.1.0 staat boven de tabel een korte analyse van hoe stipt het bedrijf zijn facturen betaalt. Dezelfde analyse verschijnt in de PDF. De klant ziet zo zelf waar hij staat, en u hoeft het hem niet meer apart uit te leggen.

• Groen: “47 % is binnen de betalingstermijn betaald.” Bedoeld zijn facturen die op de vervaldatum of eerder zijn betaald.
• Oranje: “29 % is in de week na afloop van de betalingstermijn betaald.” Dat zijn betalingen één tot zeven dagen na de vervaldatum.
• Rood: “24 % is later betaald, gemiddeld na 39 dagen (25 dagen na afloop van de betalingstermijn).” Het eerste getal telt vanaf de factuurdatum, het getal tussen haakjes vanaf de vervaldatum. De regel verschijnt alleen als er zulke facturen zijn.
• “Facturen staan tot 60 dagen open.” Dat is de leeftijd van de oudste factuur die op de peildatum nog openstaat, gerekend vanaf de factuurdatum.

Daaronder staat de beoordeling van de betaalmoraal: goed of slecht, en onderaan de pagina, in de PDF aan het einde van de pagina, de opmerking “Klanten met een slechte betaalmoraal worden omgezet naar vooruitbetaling.” De PDF toont dezelfde regels in de opmaak met briefhoofd:

Wat er wordt meegeteld

• Beoordeeld worden facturen aan de klant die zijn geboekt. Creditnota’s en concepten tellen niet mee. Bij betaling in termijnen telt elke termijn afzonderlijk.
• Periode: de facturen van de afgelopen twaalf maanden en alle facturen die nog openstaan, ook als ze ouder zijn.
• Betaaldatum is de datum van de laatste afletting met een betaling, net zoals bij de peildatum.
• Openstaande facturen: Is een factuur op de peildatum achterstallig, dan telt ze alsof ze op de peildatum is betaald, dus oranje of rood. Een openstaande factuur die nog niet vervallen is, wordt niet beoordeeld.
• Met een peildatum in het verleden geldt de stand van die dag: betalingen na de peildatum tellen nog niet mee.
• Is er niets te beoordelen, dan staat er “Geen facturen van de afgelopen 12 maanden om te beoordelen.” en is er geen beoordeling.

Wanneer is de betaalmoraal “goed”?

De beoordeling is goed als minstens 70 % van de facturen groen of oranje is (op tijd of hooguit een week te laat) en geen enkele openstaande factuur langer dan 30 dagen achterstallig is. Anders is ze slecht. De drempels (7 dagen, 70 %, 30 dagen, 12 maanden) staan als constanten bovenaan models/res_partner.py en kunnen daar worden aangepast.

Belangrijk: de module zet niemand om naar vooruitbetaling. De opmerking in de voettekst is een vaste tekst die klanten met een slechte beoordeling laat zien wat daaruit kan volgen. Of en wanneer u daartoe besluit, blijft uw zaak. Als de zin u niet bevalt, wijzigt u hem in de twee sjablonen (portaalpagina en rapport) of in de vertaling.

Wie mag wat zien? Het toegangsmodel

Openstaande posten zijn gevoelige gegevens, daarom was de toegang ons belangrijker dan welke extra functie ook. Het model is bewust eenvoudig:

• Alleen met ingestelde optie. Zonder vinkje bij de contactpersoon is er geen tegel, en een aanroep van /my/open-items leidt door naar Mijn account.
• Altijd het eigen bedrijf. Het bedrijf wordt bepaald op basis van de aangemelde gebruiker, niet uit een parameter in het adres. Er is geen mogelijkheid om via de adresbalk een ander bedrijf op te vragen.
• Dezelfde controle bij de PDF. Odoo stelt PDF-rapporten in principe ook beschikbaar via een algemeen adres. De module controleert daarom in het rapport zelf nogmaals: alleen gebruikers met boekhoudrechten of portaalgebruikers met ingestelde optie voor het eigen bedrijf krijgen een PDF, alle anderen een toegangsfout.
• Alleen geboekte posten. Concepten en geannuleerde documenten verschijnen nooit.
• Alleen eigen boekhoudkringen: Er worden alleen boekingen meegenomen van bedrijven waartoe de gebruiker toegang heeft.

Technische uitvoering

De module is alleen afhankelijk van account en portal, dus van onderdelen van Odoo Community. Ze voegt één enkel veld toe aan de contactpersoon en bestaat verder uit een controller, een rapportklasse en sjablonen.

De openstaande posten worden uit de boekingsregels gelezen, niet uit de facturen. Dat is belangrijk: alleen zo verschijnen ook creditnota’s en nog niet toegewezen betalingen, en alleen zo kan de stand op een eerdere dag uit de afletteringen (account.partial.reconcile) worden herleid. De query loopt voor het hele bedrijf (commercial_partner_id) met verhoogde rechten; de controle of de gebruiker ze mag zien, gaat eraan vooraf.

Tests

De module bevat dertien automatische tests die bij ons groen doorlopen:

• Toegang alleen met ingestelde optie, anders doorverwijzing naar Mijn account,
• lijst bevat de posten van het hele bedrijf, maar nooit die van een ander bedrijf,
• de optie geldt per contactpersoon, niet voor alle gebruikers van het bedrijf,
• creditnota’s staan met een negatief bedrag in de lijst en verlagen het saldo,
• peildatum: een later betaalde factuur staat ervoor op de lijst, erna niet,
• pagina met een toekomstige en met een ongeldige datum,
• PDF-adres levert een pdf-bestand,
• rapport als HTML en toegangscontrole in het rapport,
• openstaand bedrag per peildatum na gedeeltelijke betalingen voor en na de peildatum,
• betaalmoraal: indeling in op tijd, tot een week te laat en later, met de gemiddelde waarden, ook voor een peildatum in het verleden,
• betaalmoraal met openstaande facturen en de beoordeling goed of slecht,
• betaalmoraal zonder facturen en nooit met gegevens van een ander bedrijf,
• betaalmoraal in portaalpagina en PDF.

Daarnaast hebben we de pagina in een testdatabase met voorbeeldklanten in de browser doorlopen; de afbeeldingen in dit artikel zijn daar afkomstig. Alle namen, documentnummers en bedragen daarin zijn verzonnen.

Installatie en configuratie

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

Afhankelijkheden zijn account en portal. Na de installatie moet de Odoo-service opnieuw worden gestart, omdat de module Python-code bevat. Wie een productiesysteem beheert, installeert de module eerst op een kopie van de database. Daarna:

1. Open de contactpersoon die de lijst moet zien (persoon met portaaltoegang),
2. zet in het formulier het selectievakje Lijst met openstaande posten in het portaal tonen en sla op,
3. meld u in het portaal aan als die gebruiker of controleer samen met de klant: tegel, lijst, peildatum en PDF.

Controleer vóór de activering de afzender- en opmaakinstellingen van uw bedrijf, want de PDF neemt logo, adres en voettekst over uit de documentopmaak. De module verstuurt zelf geen e-mails en genereert geen meldingen.

Beperkingen en opmerkingen

• Actuele stand voor geboekte documenten. De peildatum rekent op basis van de boekingen zoals ze nu in het systeem staan. Is na de peildatum een factuur geannuleerd of teruggezet naar concept, dan toont de lijst hem niet. Een onveranderlijke momentopname “zoals destijds afgedrukt” is het dus niet.
• Betalingen tellen vanaf de dag van de aflettering. Wordt een betaling pas dagen na ontvangst aan een factuur toegewezen, dan staat de factuur tot dan toe als openstaand op de lijst. Wie zuivere peildatumanalyses wil, moet betalingen tijdig toewijzen. Een bankafstemming op facturen is niet opgenomen in Odoo Community; wij gebruiken daarvoor onze Bank-Statement-Matcher-module.
• De betaalmoraal is zo goed als uw afstemming. Geteld wordt wanneer een betaling aan een factuur is toegewezen. Betalingen die lang niet zijn afgestemd, laten een klant slechter overkomen dan hij is. Controleer de beoordeling bij uw klanten voordat u er iets uit afleidt.
• De beoordeling is voor de klant zichtbaar. Wie de optie heeft, ziet ook het resultaat en de opmerking over vooruitbetaling. De module verandert daarbij niets aan de betalingsvoorwaarden.
• Alleen vorderingen. De module toont wat de klant u verschuldigd is, niet uw schulden aan de klant.
• Geen aanmaningsniveaus en geen betaallink in de lijst. De klant kan vanuit de lijst een factuur openen en daar betalen, zoals uw portaal dat anders toestaat.
• PDF en multiprocesbedrijf. Om PDF-rapporten te genereren roept Odoo intern zijn eigen webadres aan. Draait uw systeem met slechts één werkproces, dan kan dat blokkeren. Dat geldt voor alle PDF-rapporten in het portaal, niet alleen voor deze module. Controleer de PDF-knop na de installatie eenmaal onder echte omstandigheden.
• Alleen getest met Odoo 19.0 Community. Voor andere versies hebben wij het niet gecontroleerd.
• Geen vervanging van aanmaningsbeheer en rekeningafschrift. De lijst vervangt noch een boekhoudkundig rekeningafschrift noch uw aanmaningsprocessen; ze maakt de stand alleen transparant.

Veelgestelde vragen

Wat is een lijst met openstaande posten (OP-lijst)?

Een overzicht van alle facturen die nog niet of niet volledig zijn betaald, met factuurdatum, vervaldatum en openstaand bedrag. Ze wordt ook “openstaande facturen”, “klantrekening” of “saldilijst” genoemd, hoewel een saldilijst in strikte zin de saldi van alle rekeningen bedoelt.

Waarom toont het Odoo-portaal niet standaard al een OP-lijst?

Het portaal toont orders, facturen en betalingen afzonderlijk, met status en filters. Een totaallijst van het bedrijf met saldo en een peildatumanalyse maken, voor zover wij hebben gezien, geen deel uit van de Community. Daarvoor is de module bedoeld.

Zien alle portaalgebruikers van een bedrijf de lijst?

Nee. Alleen contactpersonen met ingestelde optie. De getoonde lijst omvat echter het hele bedrijf, niet alleen de facturen van die ene contactpersoon.

Kan ik een peildatum uit het verleden kiezen, bijvoorbeeld 31 december van het voorgaande jaar?

Ja, een willekeurige datum tot en met vandaag. De lijst toont dan de posten die op die dag waren geboekt en nog niet betaald. Let op de opmerkingen over de berekening: bepalend is de dag van aflettering van de betaling.

Wordt een peildatum in de toekomst ondersteund?

Nee. Toekomstige data worden behandeld als vandaag, zodat de lijst geen stand toont die er nog niet is.

Verschijnen creditnota’s en vooruitbetalingen in de lijst?

Ja. Creditnota’s en betalingen die nog niet aan een factuur zijn toegewezen, staan met een negatief bedrag in de lijst en verlagen het saldo. Een opmerking onder de tabel legt dat aan de klant uit.

Hoe worden achterstallige posten herkend?

Een post is achterstallig als zijn vervaldatum vóór de peildatum ligt en er nog een positief restant openstaat. De dagen na de vervaldatum worden geteld tot de peildatum.

Is de PDF ook in andere talen beschikbaar?

Ja, interface en PDF volgen de taal van de gebruiker. Meegeleverd is de Duitse vertaling; voor andere talen volstaat een .po-bestand of de vertaling via de Odoo-interface.

Kan een klant de lijst van een ander bedrijf zien als hij het adres wijzigt?

Nee. Het bedrijf volgt altijd uit de aangemelde gebruiker. Het adres bevat alleen de peildatum. Ook het PDF-rapportadres van Odoo wordt in het rapport zelf nogmaals gecontroleerd.

Hoe wordt de betaalmoraal berekend?

Uit de geboekte klantfacturen van de afgelopen twaalf maanden en alle openstaande facturen. Per factuur telt hoeveel dagen na de vervaldatum ze is betaald: uiterlijk op de vervaldatum (groen), tot zeven dagen daarna (oranje) of later (rood). De beoordeling is goed bij minstens 70 % groen of oranje en geen factuur die langer dan 30 dagen achterstallig openstaat. De details staan in de sectie betaalmoraal.

Zet de module klanten met een slechte betaalmoraal om naar vooruitbetaling?

Nee. Ze toont alleen de beoordeling en de opmerking. Betalingsvoorwaarden, vooruitbetaling en blokkades blijven uw beslissing en uw proces in Odoo.

Verstuurt de module e-mails of aanmaningen?

Nee. Ze levert alleen pagina en PDF. Ze genereert geen berichten, meldingen of activiteiten.

Werkt de module met Odoo Enterprise?

Ze is alleen afhankelijk van account en portal, die in beide edities bestaan. Wij hebben ze alleen getest op de Community-editie van Odoo 19.

Onder welke licentie staat de module?

Onder de AGPL-3. U mag haar gebruiken, wijzigen en doorgeven als u de licentievoorwaarden naleeft. Fouten en verbetervoorstellen zijn welkom als issue in de GitHub-repository welkom.

Ondersteuning door Biricon IT Services

Wij ondersteunen Odoo-installaties voor kleine en middelgrote bedrijven: van de invoering via aanpassingen en migraties tot de lopende exploitatie. Als u uw klanten in het portaal openstaande posten, facturen en tickets wilt aanbieden, de boekhouding in Odoo Community wilt uitbreiden of een module veilig in uw productie-instantie wilt brengen, helpen wij u graag. Verdere eigen ontwikkelingen: Bedrijf archiveren inclusief portaalgebruikers, Handelsregister en adrescontrole voor Oostenrijkse klanten, Documentnummers uit prefix, jaar en teller en Productsets in de offerte als sectie.

Neem nu contact op

Stand: 6 november 2026. Moduleversie 19.0.1.1.1. Wijzigingen sinds de eerste versie van 5 november: betaalmoraal (19.0.1.1.0) en correctie van het openstaande bedrag per peildatum na gedeeltelijke betalingen (19.0.1.1.1). Alle namen, documentnummers en bedragen in de afbeeldingen zijn verzonnen.