Odoo 19: avatud kirjed kliendiportaalis aruandekuupäeva ja PDF-ekspordiga – moodul portal_open_items

„Kui palju on meil teie ees tegelikult veel avatud?“ Seda küsimust esitatakse igas kliendibaasis regulaarselt, enamasti vahetult enne kvartali lõppu, enne aastaaruande auditit või siis, kui kliendi raamatupidamine valmistab ette makseid. Kes sellele ise ei vasta, saab küsimuse e-posti või telefoni teel ning keegi peab raamatupidamisest avatud kirjete nimekirja (OP-nimekirja) eksportima ja ära saatma. Odoo 19 Community puhul see iseenesest ei toimi: kliendiportaal näitab küll üksikuid arveid, kuid mitte kogu ettevõtte avatud kirjete nimekirja, veel vähem vabalt valitud päeva seisuga.

Kirjutasime selleks mooduli Avatud kirjed kliendiportaalis (portal_open_items) Odoo 19 jaoks. Aktiveeritud juurdepääsuga kliendid näevad portaalis nimekirja kõigist oma ettevõtte avatud arvetest, kreeditarvetest ja veel seostamata maksetest, saavad valida aruandekuupäeva, laadida nimekirja alla PDF-ina ning näevad ühe pilguga, milline on nende maksedistsipliin. Moodul on vaba tarkvara AGPL-3 litsentsi all ja asub GitHubis:

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

Paigaldasime mooduli 5. novembril 2026 oma tootmissüsteemi. Valik on seal vaikimisi välja lülitatud ja seatakse ainult üksikute klientidega kokkuleppel. Töökogemus on seega veel lühike; testisime kolmeteistkümne automaattesti ja näidisklientidega testandmebaasiga. Kes mooduli üle võtab, peaks läbi lugema lõigud Aruandekuupäeva arvutus, Maksedistsipliin ja Piirangud .

Probleem: OP-nimekiri nõudmisel

Avatud kirjete nimekiri näitab, millised kliendi arved on veel tasumata, kui palju neist on tähtaja ületanud ja kui suur on saldo. Tarnijale on see likviidsuse planeerimise ja maksete meeldetuletamise vahend. Kliendile on see alus maksete planeerimiseks, arvete oma raamatupidamisega võrdlemiseks ja küsimuste selgitamiseks ilma iga arvet eraldi avamata. Tüüpilised põhjused:

• Kvartali- ja aastaaruanne: Kliendi raamatupidamine tahab teada, millised kohustused olid 31.12. seisuga. See on aruandekuupäev minevikus.
• Võrdlemine: Klient usub, et on arve tasunud, meie näeme seda veel avatuna. Ühine nimekiri kuupäeva, maksetähtaja ja summaga selgitab selle kiiremini kui e-kirjade ahel.
• Maksete jooksud: Kes valmistab makseid ette iga nädal või kuu, vajab kõiki tarnija avatud arveid ühe pilguga, tähtaja ületanud arved eespool.
• Mitu kontaktisikut: Ettevõttes tellib üks, maksab teine. Avatud kirjed kuuluvad ettevõttele, mitte üksikule isikule.

Siiani tõmbasime need nimekirjad käsitsi raamatupidamisest ja saatsime e-kirjaga. See võtab aega ja on lõpuks hetktõmmis, mis aegub juba järgmisel päeval. Parem on nimekiri, mille klient avab ise portaalis igal ajal, alati aktuaalse seisuga.

Lahendus lühidalt

Moodul täiendab Odoo kliendiportaali lehega Avatud kirjed ja kaardiga lehel Minu konto. Funktsioonid:

• Kontaktipõhine valik: „Kuva avatud kirjete nimekiri portaalis“. Ainult siis, kui see on seatud, näeb portaalikasutaja kaarti ja lehte. Vaikimisi on see välja lülitatud.
• Kogu ettevõte: Nimekiri sisaldab kõigi ettevõtte kontaktide avatud kirjeid, mitte ainult sisseloginud kasutaja omi.
• Aruandekuupäev: Klient valib kuupäeva ja näeb, mis oli sel päeval avatud.
• PDF-eksport: Nimekiri PDF-ina teie ettevõtte paigutuses, koos kirjapea, saldo ja tähtaja ületanud kirjete summaga.
• Maksedistsipliin: õigeaegselt, napilt hilinenult ja hilja tasutud arvete osakaal, kõige kauem avatud arve ning hinnang hea või halb, portaalis ja PDF-is.
• Tähtaja ületanud kirjed on värviliselt märgitud ja näitavad päevi üle maksetähtaja.
• Kreeditarved ja ettemaksud on nimekirjas negatiivse summaga ja vähendavad saldot.
• Seos: Iga nimekirjas olev arve viib portaali arvevaatesse.
• Mitmekeelne: Kasutajaliides ja PDF järgivad kasutaja keelt, saksakeelne tõlge on kaasas.

Kaart ilmub avalehele Minu konto tellimuste ja arvete kõrvale. Kellel valikut ei ole, ei näe seda.

Lubamine kontaktipõhiselt: valik

OP-nimekiri näitab kogu ettevõtte äriandmeid. Seetõttu ei lülita moodul seda sisse kõigile portaalikasutajatele, vaid ainult seal, kus te seda sõnaselgelt soovite. Kontakti vormil on jaotises Veebileht märkeruut „Kuva avatud kirjete nimekiri portaalis“. See on nähtav arveldusõigustega kasutajatele (grupp account.group_account_invoice) ja kehtib selle ühe kontakti kohta.

See sobib praktikaga: ettevõttes peaks nimekirja nägema juhtkond või raamatupidamine, mitte töötaja, kes vaatab ainult pöördumisi. Valik kehtib kontaktile, kuid kuvatavad kirjed kuuluvad kogu ettevõttele. Seadke valik seega isikule, kes peab saama ülevaate kogu ettevõttest.

Nimekiri kliendiportaalis

Klõps kaardil avab lehe /my/open-items. Leht näitab ettevõtte nime, aruandekuupäeva valikut ja avatud kirjete tabelit:

Tabeli all on saldo, ehk kõigi avatud summade summa, ja tähtaja ületanud kirjete summa. Tähtaja ületanud read on värviliselt esile tõstetud, et neid oleks läbi vaadates kohe näha. Kreeditarved ja maksed, mis ei ole veel arvega seostatud, kuvatakse negatiivse märgiga ja vähendavad saldot; tabeli all olev märkus selgitab seda kliendile. Kui teie ettevõte arveldab mitmes valuutas, kuvatakse saldo valuutade kaupa.

Avatud kirjed aruandekuupäeva seisuga

Kuupäeva kohal on „Avatud kirjed aruandekuupäeva seisuga“, selle kõrval kuupäevaväli ja nupp Kuva. Minevikus oleva aruandekuupäevaga näitab nimekiri, mis oli sel päeval veel tasumata. See on täpselt see aruanne, mida läheb vaja aastalõpu sulgemisel, auditites ja võrdlemisel: „Millised kohustused olid meil 31.12. seisuga selle tarnija ees?“

Kuidas aruandekuupäeva arvutatakse

Iga kirje puhul kehtib: Avatud aruandekuupäeva seisuga = arve summa miinus kõik maksed, mis olid aruandekuupäevani (kaasa arvatud) kooskõlastatud. Kirje kuulub nimekirja, kui see oli aruandekuupäeval juba kantud ja sellel oli siis veel jääk. Arve 7. septembrist summas 1.250,50 €, mis tasuti 20. oktoobril osaliselt 500,00 € ja 5. novembril ülejäänud summaga, on aruandekuupäeva 2. november korral nimekirjas summaga 750,50 € ja aruandekuupäeva 5. november korral enam üldse mitte.

Ka tähtaja ületamist hinnatakse aruandekuupäeva seisuga: kirje on tähtaja ületanud, kui selle maksetähtaeg on enne aruandekuupäeva ja jääk on positiivne. Päevi üle maksetähtaja loetakse aruandekuupäevani, mitte tänaseni. Tulevikus olev aruandekuupäev käsitletakse nagu tänane, samuti tühi või kehtetu kuupäev aadressireal. Nimekiri ei saa seega prognoosi näiliselt esitada.

Mida „makse kuupäev“ siin tähendab

Määrav on kuupäev, mil arve ja makse Odoos omavahel kooskõlastati (kahest kandekuupäevast hilisem), mitte arve kuupäev. See on tavaline juhtum: makse kantakse laekumise päeval ja seostatakse arvega. Kes seostab maksed alles päevi hiljem, näeb arvet vastavalt kauem avatuna. Lõik Piirangud käsitleb seda täpsemalt.

PDF-eksport

Nupu Laadi PDF alla kaudu loob moodul nimekirja PDF-failina valitud aruandekuupäeva kohta. Nupp Prindi avab sama nimekirja brauseri prindidialoogis. PDF kasutab teie Odoo ettevõtte dokumendipaigutust (logo, aadress, jalus seadetest) ja Euroopa paberivormingut:

• Pealkiri aruandekuupäevaga: „Avatud kirjed aruandekuupäeva 02.11.2026 seisuga“, ka siis, kui aruandekuupäev on täna. Kui avatud kirjeid ei ole, on seal „Avatud kirjeid ei ole.“
• Kliendi aadress ettevõtte paigutuse aadressiväljal, et nimekiri sobiks ka välja prinditult asjasse.
• Tähtaja ületanud kirjed rasvases kirjas, et need paistaksid silma ka mustvalgelt printides.
• Saldo ja tähtaja ületanud kirjete summa tabeli lõpus, mitme valuuta korral valuutade kaupa.
• Failinimi ettevõtte ja kuupäevaga, näiteks Open_items_Muster_Handels_GmbH_2026-11-02.pdf.

Maksedistsipliin: hinnang ühe pilguga

Alates versioonist 19.0.1.1.0 on tabeli kohal lühike ülevaade sellest, kui õigeaegselt ettevõte oma arveid tasub. Sama ülevaade on ka PDF-is. Nii näeb klient ise, kus ta seisab, ja teil ei ole vaja seda talle enam eraldi selgitada.

• Roheline: „47 % tasuti maksetähtaja jooksul.“ Mõeldud on arveid, mis tasuti maksetähtaja päeval või varem.
• Oranž: „29 % tasuti nädala jooksul pärast maksetähtaja möödumist.“ Need on maksed, mis tehti üks kuni seitse päeva pärast maksetähtaega.
• Punane: „24 % tasuti hiljem, keskmiselt 39 päeva pärast (25 päeva pärast maksetähtaja möödumist).“ Esimene arv loeb arve kuupäevast, sulgudes olev arv maksetähtajast. Rida ilmub ainult siis, kui selliseid arveid on.
• „Arved on avatud kuni 60 päeva.“ See on aruandekuupäeval veel avatud vanima arve vanus, arvestatuna arve kuupäevast.

Selle all on maksedistsipliini hinnang: hea või halb ning lehe lõpus, PDF-is lehe lõpus, märkus „Halva maksedistsipliiniga kliendid viiakse üle ettemaksule.“ PDF näitab samu ridu kirjapeaga paigutuses:

Mida loetakse

• Hinnatakse kliendile esitatud arveid, mis on kantud. Kreeditarved ja mustandid ei loe. Osamaksete korral loeb iga osamakse eraldi.
• Ajavahemik: viimase kaheteistkümne kuu arved ja kõik arved, mis on veel avatud, ka siis, kui need on vanemad.
• Maksepäev on makse viimase kooskõlastamise kuupäev, nagu aruandekuupäeva puhul.
• Avatud arved: Kui arve on aruandekuupäeval tähtaja ületanud, loetakse see nii, nagu oleks see tasutud aruandekuupäeval, see tähendab oranžina või punasena. Avatud arvet, mille maksetähtaeg ei ole veel käes, ei hinnata.
• Aruandekuupäeva korral minevikus kehtib selle päeva seis: pärast aruandekuupäeva tehtud maksed ei loe veel.
• Kui hinnata pole midagi, on seal kirjas „Viimase 12 kuu arveid hindamiseks ei ole.“ ja hinnangut ei ole.

Millal on maksedistsipliin „hea“?

Hinnang on hea, kui vähemalt 70 % arvetest on rohelised või oranžid (õigeaegsed või hilinenud kõige rohkem nädala) ja ükski avatud arve ei ole tähtaja ületanud üle 30 päeva. Muidu on see halb. Lävendid (7 päeva, 70 %, 30 päeva, 12 kuud) asuvad konstantidena faili models/res_partner.py alguses ja neid saab seal kohandada.

Oluline: moodul ei vii kedagi ettemaksule. Jaluses olev märkus on kindel tekst, mis näitab halva hinnanguga klientidele, mis sellest võib järgneda. Kas ja millal te nii otsustate, on teie enda asi. Kui lause teile ei sobi, muutke seda mõlemas mallis (portaalileht ja aruanne) või tõlkes.

Kes mida näha tohib? Juurdepääsumudel

Avatud kirjed on tundlikud andmed, seetõttu oli meile juurdepääs olulisem kui ükski lisafunktsioon. Mudel on teadlikult lihtne:

• Ainult seatud valikuga. Ilma kontakti märketa kaarti ei ole ja /my/open-items avamine suunab lehele Minu konto.
• Alati oma ettevõte. Ettevõte määratakse sisseloginud kasutaja järgi, mitte aadressi parameetri põhjal. Aadressirea kaudu ei ole võimalik teise ettevõtte andmeid nõuda.
• Sama kontroll PDF-i puhul. Odoo pakub PDF-aruandeid põhimõtteliselt ka üldise aadressi kaudu. Seetõttu kontrollib moodul aruandes ise uuesti: PDF-i saavad ainult raamatupidamisõigusega kasutajad või portaalikasutajad, kellel on oma ettevõtte jaoks valik seatud, kõik teised saavad juurdepääsuvea.
• Ainult kantud kirjed. Mustandid ja tühistatud dokumendid ei ilmu kunagi.
• Ainult oma raamatupidamisringid: Arvestatakse ainult nende ettevõtete kandeid, millele kasutajal on juurdepääs.

Tehniline teostus

Moodul sõltub ainult moodulitest account ja portal, ehk Odoo Communityga kaasas olevatest osadest. See lisab kontaktile ainult ühe välja ja koosneb muus osas kontrollerist, aruandeklassist ja mallidest.

Avatud kirjed loetakse kanderidadest, mitte arvetest. See on oluline: ainult nii ilmuvad nimekirja ka kreeditarved ja veel seostamata maksed ning ainult nii saab varasema päeva seisu kooskõlastuste (account.partial.reconcile) põhjal tagantjärele välja arvutada. Päring käib kogu ettevõtte kohta (commercial_partner_id) laiendatud õigustega, kontroll, kas kasutaja tohib neid näha, tehakse enne seda.

Testid

Moodulil on kaasas kolmteist automaattesti, mis meie süsteemis läbivad rohelisena:

• juurdepääs ainult seatud valikuga, muidu suunamine lehele Minu konto,
• nimekiri sisaldab kogu ettevõtte kirjeid, kuid mitte kunagi teise ettevõtte omi,
• valik kehtib kontakti kohta, mitte kõigile ettevõtte kasutajatele,
• kreeditarved on nimekirjas negatiivse summaga ja vähendavad saldot,
• aruandekuupäev: hiljem tasutud arve on varem nimekirjas, hiljem mitte,
• leht tulevikus oleva ja kehtetu kuupäevaga,
• PDF-aadress tagastab PDF-faili,
• aruanne HTML-ina ja juurdepääsukontroll aruandes,
• avatud summa aruandekuupäeva seisuga pärast osamakseid enne ja pärast aruandekuupäeva,
• maksedistsipliin: jaotus õigeaegseteks, kuni nädala hilinenud ja hilisemateks, koos keskmiste väärtustega, ka aruandekuupäeva korral minevikus,
• maksedistsipliin avatud arvetega ning hinnang hea või halb,
• maksedistsipliin ilma arveteta ja mitte kunagi teise ettevõtte andmetega,
• maksedistsipliin portaalilehel ja PDF-is.

Lisaks mängisime lehe brauseris läbi näidisklientidega testandmebaasis, selle postituse pildid pärinevad sealt. Kõik nimed, dokumendinumbrid ja summad on seal vabalt välja mõeldud.

Paigaldus ja seadistus

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

Sõltuvused on account ja portal. Pärast paigaldamist tuleb Odoo teenus uuesti käivitada, sest moodul sisaldab Pythoni koodi. Kes haldab tootmissüsteemi, paigaldab mooduli kõigepealt andmebaasi koopiale. Seejärel:

1. avage kontakt, kes peab nimekirja nägema (portaalijuurdepääsuga isik),
2. märkige vormil ruut Kuva avatud kirjete nimekiri portaalis ja salvestage,
3. logige portaali sisse selle kasutajana või kontrollige koos kliendiga: kaart, nimekiri, aruandekuupäev ja PDF.

Kontrollige enne lubamist oma ettevõtte saatja- ja paigutuseseadeid, sest PDF võtab dokumendipaigutusest logo, aadressi ja jaluse. Moodul ei saada ise e-kirju ega loo teavitusi.

Piirangud ja märkused

• Praegune seis kantud dokumentide kohta. Aruandekuupäev arvutatakse kannete põhjal sellisena, nagu need praegu süsteemis on. Kui arve on pärast aruandekuupäeva tühistatud või mustandiks tagasi pandud, nimekiri seda ei näita. See ei ole muutumatu hetktõmmis „sellisena, nagu seda toona prinditi“.
• Maksed loevad kooskõlastamise päevast. Kui makse seostatakse alles päevi pärast arve laekumist, on arve selle ajani nimekirjas avatuna. Kes soovib puhtaid aruandekuupäeva aruandeid, peaks maksed õigeaegselt seostama. Pangakonto väljavõtte võrdlemine arvetega ei ole Odoo Communitys kaasas; selleks kasutame oma Bank-Statement-Matcher-moodulit.
• Maksedistsipliin on nii hea kui teie kooskõlastamine. Loetakse seda, millal makse arvega seostati. Maksed, mida pole pikka aega kooskõlastatud, panevad kliendi paistma halvemana, kui ta on. Kontrollige oma klientide hinnangut, enne kui sellest midagi järeldate.
• Hinnang on kliendile nähtav. Kes valiku saab, näeb ka tulemust ja märkust ettemaksu kohta. Moodul ei muuda sealjuures maksetingimusi.
• Ainult nõuded. Moodul näitab, mida klient teile võlgneb, mitte teie kohustusi kliendi ees.
• Ei mingeid meeldetuletustasemeid ega maksesidet nimekirjas. Klient saab nimekirjast arve avada ja seal tasuda, nii nagu teie portaal muidu lubab.
• PDF ja mitme protsessi režiim. Odoo pöördub PDF-aruannete loomiseks sisemiselt oma veebiaadressi poole. Kui teie süsteem töötab ainult ühe töötlusprotsessiga, võib see blokeeruda. See kehtib kõigi portaali PDF-aruannete kohta, mitte ainult selle mooduli kohta. Kontrollige PDF-nuppu pärast paigaldamist üks kord päris tingimustes.
• Testitud ainult Odoo 19.0 Communityga. Muude versioonide kohta ei ole me seda kontrollinud.
• Ei asenda meeldetuletusprotsessi ega kontoväljavõtet. Nimekiri ei asenda ei raamatupidamislikku kontoväljavõtet ega teie meeldetuletusprotsesse, see teeb seisu ainult läbipaistvaks.

Korduma kippuvad küsimused

Mis on avatud kirjete nimekiri (OP-nimekiri)?

Ülevaade kõigist arvetest, mis ei ole veel või mitte täielikult tasutud, koos arve kuupäeva, maksetähtaja ja avatud summaga. Seda nimetatakse ka „avatud arveteks“, „kliendikontoks“ või „saldonimekirjaks“, kusjuures saldonimekiri kitsamas tähenduses tähendab kõigi kontode saldosid.

Miks ei näita Odoo portaal OP-nimekirja juba vaikimisi?

Portaal näitab tellimusi, arveid ja makseid eraldi, koos oleku ja filtritega. Kogu ettevõtte koondnimekiri saldoga ja aruandekuupäeva aruanne ei kuulu Community väljaande mahtu, niipalju kui me oleme näinud. Selleks see moodul mõeldud ongi.

Kas kõik ettevõtte portaalikasutajad näevad nimekirja?

Ei. Ainult seatud valikuga kontaktid. Kuvatav nimekiri hõlmab aga kogu ettevõtet, mitte ainult selle ühe kontakti arveid.

Kas ma saan valida aruandekuupäeva minevikust, näiteks eelmise aasta 31.12.?

Jah, mis tahes kuupäeva kuni tänaseni. Nimekiri näitab siis kirjeid, mis olid sel päeval kantud ja veel tasumata. Pange tähele arvutuse märkusi: määrav on makse kooskõlastamise päev.

Kas aruandekuupäev tulevikus on toetatud?

Ei. Tulevikukuupäevi käsitletakse nagu tänast, et nimekiri ei näitaks seisu, mida veel ei ole.

Kas kreeditarved ja ettemaksud ilmuvad nimekirja?

Jah. Kreeditarved ja maksed, mis ei ole veel arvega seostatud, on nimekirjas negatiivse summaga ja vähendavad saldot. Tabeli all olev märkus selgitab seda kliendile.

Kuidas tähtaja ületanud kirjed tuvastatakse?

Kirje on tähtaja ületanud, kui selle maksetähtaeg on enne aruandekuupäeva ja positiivne jääk on veel avatud. Päevi üle maksetähtaja loetakse aruandekuupäevani.

Kas PDF on saadaval ka teistes keeltes?

Jah, kasutajaliides ja PDF järgivad kasutaja keelt. Kaasas on saksa tõlge; teiste keelte jaoks piisab .po-failist või tõlkimisest Odoo kasutajaliidese kaudu.

Kas klient saab näha teise ettevõtte nimekirja, kui ta aadressi muudab?

Ei. Ettevõte tuleneb alati sisseloginud kasutajast. Aadress sisaldab ainult aruandekuupäeva. Ka Odoo PDF-aruande aadressi kontrollitakse aruandes ise uuesti.

Kuidas maksedistsipliini arvutatakse?

Viimase kaheteistkümne kuu kantud kliendiarvetest ja kõigist avatud arvetest. Iga arve puhul loeb, mitu päeva pärast maksetähtaega see tasuti: kõige rohkem maksetähtaja päeval (roheline), kuni seitse päeva hiljem (oranž) või hiljem (punane). Hinnang on hea, kui vähemalt 70 % on rohelised või oranžid ja ükski arve ei ole avatuna tähtaja ületanud üle 30 päeva. Üksikasjad on lõigus Maksedistsipliin.

Kas moodul viib halva maksedistsipliiniga kliendid ettemaksule?

Ei. See näitab ainult hinnangut ja märkust. Maksetingimused, ettemaks ja blokeerimine jäävad teie otsuseks ja teie protsessiks Odoos.

Kas moodul saadab e-kirju või meeldetuletusi?

Ei. See pakub ainult lehte ja PDF-i. See ei loo sõnumeid, teavitusi ega tegevusi.

Kas moodul töötab Odoo Enterprise'iga?

See sõltub ainult moodulitest account ja portal, mis on olemas mõlemas väljaandes. Testinud oleme seda ainult Odoo 19 Community väljaandes.

Mis litsentsi all moodul on?

AGPL-3 all. Te tohite seda kasutada, muuta ja edasi anda, kui järgite litsentsitingimusi. Vead ja parendusettepanekud on teretulnud probleemina (Issue) siin: GitHubi hoidla .

Biricon IT Servicesi tugi

Hooldame Odoo paigaldusi väikestele ja keskmise suurusega ettevõtetele: alates kasutuselevõtust kohanduste ja migratsioonide kaudu kuni jooksva tööni. Kui soovite pakkuda oma klientidele portaalis avatud kirjeid, arveid ja pöördumisi, laiendada raamatupidamist Odoo Communitys või viia moodul turvaliselt oma tootmisinstantsi, aitame hea meelega. Muud oma arendused: Ettevõtte arhiveerimine koos portaalikasutajatega, Äriregister ja aadressikontroll Austria klientidele, Dokumendinumbrid prefiksist, aastast ja loendurist ja Tootekomplektid pakkumises jaotisena.

Võtke meiega ühendust

Seisuga: 6. november 2026. Mooduli versioon 19.0.1.1.1. Muudatused alates esimesest versioonist 5. novembrist: maksedistsipliin (19.0.1.1.0) ja avatud summa parandus aruandekuupäeva seisuga pärast osamakseid (19.0.1.1.1). Kõik nimed, dokumendinumbrid ja summad piltidel on väljamõeldud.