Odoo 19: Poziții deschise în portalul clienților cu dată de referință și export PDF – modulul portal_open_items

„Cât mai avem de încasat de la dumneavoastră, de fapt?” Această întrebare apare periodic în orice bază de clienți, de obicei înainte de sfârșitul trimestrului, înaintea auditului anual sau când contabilitatea clientului pregătește plăți. Cine nu răspunde singur primește întrebarea prin e-mail sau telefon, iar cineva trebuie să exporte din contabilitate o listă a pozițiilor deschise (listă OP) și să o trimită. Cu Odoo 19 Community acest lucru nu se face de la sine: portalul clienților afișează facturile individuale, dar nu o listă a pozițiilor deschise ale întregii companii, cu atât mai puțin la o zi aleasă liber.

Pentru aceasta am scris modulul Poziții deschise în portalul clienților (portal_open_items) pentru Odoo 19. Clienții cu acces activat văd în portal o listă a tuturor facturilor deschise, a notelor de credit și a plăților încă nealocate ale companiei lor, pot alege o dată de referință, pot descărca lista ca PDF și văd dintr-o privire cum stau cu comportamentul de plată. Modulul este software liber sub licența AGPL-3 și se găsește pe GitHub:

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

Am instalat modulul la 5 noiembrie 2026 în sistemul nostru de producție. Opțiunea este acolo dezactivată implicit și se setează doar după înțelegere cu fiecare client în parte. Experiența din exploatare este deci încă scurtă; am testat cu treisprezece teste automate și cu o bază de date de test cu clienți exemplu. Cine preia modulul ar trebui să citească secțiunile despre calculul datei de referință, despre comportamentul de plată și despre limitări .

Problema: lista OP la cerere

O listă a pozițiilor deschise arată care facturi ale unui client nu sunt încă plătite, care dintre ele sunt scadente depășite și cât este soldul. Pentru furnizor este un instrument de planificare a lichidităților și de urmărire a creanțelor. Pentru client este baza pentru a planifica plățile, a reconcilia facturile cu propria contabilitate și a lămuri întrebări fără a deschide fiecare factură în parte. Ocazii tipice:

• Închiderea trimestrială și anuală: Contabilitatea clientului vrea să știe ce datorii existau la 31.12. Aceasta este o dată de referință din trecut.
• Reconciliere: Clientul crede că a plătit o factură, noi o vedem încă deschisă. O listă comună cu data, scadența și suma lămurește situația mai repede decât un lanț de e-mailuri.
• Runde de plată: Cine pregătește plăți săptămânal sau lunar are nevoie de toate facturile deschise ale unui furnizor dintr-o privire, cu cele scadente depășite în partea de sus.
• Mai multe persoane de contact: Într-o firmă, una comandă, alta plătește. Pozițiile deschise aparțin firmei, nu unei singure persoane.

Până acum extrăgeam aceste liste manual din contabilitate și le trimiteam prin e-mail. Acest lucru costă timp și, în final, este o fotografie de moment, care a devenit depășită chiar a doua zi. Mai bine este o listă pe care clientul o deschide singur oricând în portal, mereu cu situația actuală.

Soluția pe scurt

Modulul completează portalul clienților Odoo cu o pagină Poziții deschise și o casetă pe Contul meu. Funcționalitățile:

• Opțiune per contact: „Afișează lista pozițiilor deschise în portal”. Numai dacă este setată, utilizatorul de portal vede caseta și pagina. Implicit este dezactivată.
• Întreaga companie: Lista conține pozițiile deschise ale tuturor contactelor firmei, nu doar ale utilizatorului autentificat.
• Dată de referință: Clientul alege o dată și vede ce era deschis în acea zi.
• Export PDF: Lista ca PDF în layoutul firmei dumneavoastră, cu antet, sold și suma pozițiilor scadente depășite.
• Comportamentul de plată: ponderea facturilor plătite la timp, cu întârziere mică și cu întârziere mare, cea mai veche factură deschisă și o evaluare bună sau slabă, în portal și în PDF.
• Pozițiile scadente depășite sunt marcate colorat și arată zilele de peste data scadenței.
• Notele de credit și creditele apar în listă cu sumă negativă și reduc soldul.
• Legătură: Fiecare factură din listă duce la vizualizarea facturii în portal.
• Multilingv: Interfața și PDF-ul urmează limba utilizatorului; traducerea în germană este inclusă.

Caseta apare pe pagina de start Contul meu, lângă comenzi și facturi. Cine nu are opțiunea nu o vede.

Activare per contact: opțiunea

O listă OP afișează date comerciale ale unei întregi firme. De aceea modulul nu o activează pentru toți utilizatorii de portal, ci doar acolo unde doriți în mod expres. La contact, în formular, sub Website, se află caseta de selectare „Afișează lista pozițiilor deschise în portal”. Este vizibilă pentru utilizatorii cu drepturi de facturare (grupul account.group_account_invoice) și acționează pentru acel contact.

Acest lucru se potrivește practicii: într-o firmă, conducerea sau contabilitatea ar trebui să vadă lista, iar un angajat care consultă doar tichete, nu. Opțiunea se aplică contactului, dar pozițiile afișate aparțin întregii companii. Setați deci opțiunea la persoana care trebuie să aibă o imagine de ansamblu asupra firmei.

Lista în portalul clienților

Un clic pe casetă deschide /my/open-items. Pagina afișează numele firmei, selecția datei de referință și tabelul cu pozițiile deschise:

Sub tabel se află soldul, adică suma tuturor sumelor deschise, și suma pozițiilor scadente depășite. Rândurile scadente depășite au fundal colorat, pentru a fi observate imediat la o privire rapidă. Notele de credit și plățile care nu sunt încă alocate unei facturi apar cu semn negativ și reduc soldul; o notă sub tabel explică acest lucru clientului. Dacă firma dumneavoastră lucrează în mai multe monede, soldul este afișat pe monede.

Poziții deschise la o dată de referință

Deasupra datei se află „Poziții deschise la data de referință”, alături un câmp de dată și butonul Afișează. Cu o dată de referință din trecut, lista arată ce nu era încă plătit în acea zi. Aceasta este exact analiza necesară pentru închideri, audituri și reconcilieri: „Ce datorii aveam la 31.12. față de acest furnizor?”

Cum se calculează data de referință

Pentru fiecare poziție se aplică: Deschis la data de referință = suma facturii minus toate plățile care erau reconciliate până la data de referință inclusiv. O poziție aparține listei dacă la data de referință era deja înregistrată și avea acolo încă un rest. O factură din 7 septembrie de 1.250,50 €, plătită parțial cu 500,00 € la 20 octombrie și achitată cu restul la 5 noiembrie, apare deci în listă cu 750,50 € la data de referință 2 noiembrie, iar la data de referință 5 noiembrie nu mai apare deloc.

Depășirea scadenței este evaluată de asemenea la data de referință: o poziție este scadentă depășită dacă data ei de scadență este înaintea datei de referință și restul este pozitiv. Zilele de peste scadență se numără până la data de referință, nu până astăzi. O dată de referință din viitor este tratată ca astăzi, la fel ca o dată goală sau invalidă în linia de adresă. Lista nu poate deci simula o prognoză.

Ce înseamnă aici „data plății”

Hotărâtoare este data la care factura și plata au fost reconciliate între ele în Odoo (cea mai mare dintre cele două date de înregistrare), nu data facturii. Acesta este cazul obișnuit: plata este înregistrată în ziua încasării și alocată facturii. Cine alocă plățile abia după câteva zile vede factura ca deschisă corespunzător mai mult timp. Secțiunea limitări tratează acest aspect mai în detaliu.

Export PDF

Prin Descarcă PDF, modulul generează lista ca fișier PDF pentru data de referință aleasă. Butonul Imprimă deschide aceeași listă în dialogul de imprimare al browserului. PDF-ul folosește layoutul de document al firmei dumneavoastră Odoo (logo, adresă, subsol din setări) și formatul european de hârtie:

• Titlu cu data de referință: „Poziții deschise la data de referință 02.11.2026”, chiar dacă data de referință este astăzi. Dacă nu există poziții deschise, apare „Nu există poziții deschise.”
• Adresa clientului în câmpul de adresă al layoutului firmei, astfel încât lista să fie potrivită și tipărită.
• Pozițiile scadente depășite cu litere aldine, pentru a se remarca și la tipărirea alb-negru.
• Soldul și suma pozițiilor scadente depășite la sfârșitul tabelului, la mai multe monede pe fiecare monedă.
• Numele fișierului cu firma și data, de exemplu Open_items_Muster_Handels_GmbH_2026-11-02.pdf.

Comportamentul de plată: evaluare dintr-o privire

Începând cu versiunea 19.0.1.1.0, deasupra tabelului apare o scurtă analiză a modului în care compania își plătește la timp facturile. Aceeași analiză apare în PDF. Astfel, clientul vede singur unde se află, iar dumneavoastră nu mai trebuie să i-o explicați separat.

• Verde: „47 % au fost plătite în termenul de plată.” Sunt facturile plătite la data scadenței sau mai devreme.
• Portocaliu: „29 % au fost plătite în săptămâna de după expirarea termenului de plată.” Sunt plăți făcute la una până la șapte zile după scadență.
• Roșu: „24 % au fost plătite mai târziu, în medie după 39 de zile (25 de zile după expirarea termenului de plată).” Primul număr se numără de la data facturii, numărul din paranteză de la scadență. Rândul apare doar dacă există astfel de facturi.
• „Facturile sunt deschise de până la 60 de zile.” Aceasta este vechimea celei mai vechi facturi care la data de referință este încă deschisă, calculată de la data facturii.

Dedesubt se află evaluarea comportamentului de plată: bună sau slabă și, la sfârșitul paginii (în PDF, la sfârșitul foii), mențiunea „Clienții cu comportament de plată slab sunt trecuți la plata în avans.” PDF-ul arată aceleași rânduri în layoutul cu antet:

Ce se numără

• Se evaluează facturile emise către client care sunt înregistrate. Notele de credit și ciornele nu contează. La plata în rate, fiecare rată contează separat.
• Perioada: facturile din ultimele douăsprezece luni și toate facturile care sunt încă deschise, chiar dacă sunt mai vechi.
• Ziua plății este data ultimei reconcilieri cu o plată, ca la data de referință.
• Facturi deschise: Dacă o factură este scadentă depășită la data de referință, ea contează ca și cum ar fi fost plătită la data de referință, deci portocaliu sau roșu. O factură deschisă care încă nu a ajuns la scadență nu este evaluată.
• Cu o dată de referință în trecut contează situația din ziua respectivă: plățile de după data de referință nu se iau încă în calcul.
• Dacă nu există nimic de evaluat, apare „Nu există facturi din ultimele 12 luni de evaluat.” și nu se acordă nicio evaluare.

Când este comportamentul de plată „bun”?

Evaluarea este bună dacă cel puțin 70 % dintre facturi sunt verzi sau portocalii (la timp sau cu cel mult o săptămână întârziere) și nicio factură deschisă nu este scadentă depășită de mai mult de 30 de zile. În caz contrar este slabă. Pragurile (7 zile, 70 %, 30 de zile, 12 luni) se află ca constante la începutul fișierului models/res_partner.py și pot fi ajustate acolo.

Important: modulul nu trece pe nimeni la plata în avans. Mențiunea din subsol este un text fix, care arată clienților cu evaluare slabă ce poate urma. Dacă și când luați o astfel de decizie rămâne treaba dumneavoastră. Dacă fraza nu vi se potrivește, modificați-o în cele două șabloane (pagina de portal și raportul) sau în traducere.

Cine ce are voie să vadă? Modelul de acces

Pozițiile deschise sunt date sensibile, de aceea accesul a contat pentru noi mai mult decât orice funcție suplimentară. Modelul este intenționat simplu:

• Numai cu opțiunea setată. Fără bifă la contact nu există casetă, iar accesarea /my/open-items redirecționează către Contul meu.
• Întotdeauna propria firmă. Firma este determinată din utilizatorul autentificat, nu dintr-un parametru din adresă. Nu există nicio posibilitate de a solicita o firmă străină prin linia de adresă.
• Aceeași verificare la PDF. Odoo pune în principiu rapoartele PDF la dispoziție și printr-o adresă generală. De aceea modulul verifică încă o dată în raportul însuși: doar utilizatorii cu drept de contabilitate sau utilizatorii de portal cu opțiunea setată pentru propria firmă primesc un PDF, toți ceilalți o eroare de acces.
• Numai poziții înregistrate. Ciornele și documentele anulate nu apar niciodată.
• Numai propriile cercuri contabile: Se iau în considerare doar înregistrările companiilor la care utilizatorul are acces.

Implementare tehnică

Modulul depinde doar de account și portal, adică de componente ale Odoo Community. Adaugă un singur câmp la contact și, în rest, constă dintr-un controller, o clasă de raport și șabloane.

Pozițiile deschise sunt citite din liniile de înregistrare, nu din facturi. Acest lucru este important: doar așa apar și notele de credit și plățile încă nealocate și doar așa se poate reconstitui situația de la o zi anterioară din reconcilieri (account.partial.reconcile). Interogarea rulează pentru întreaga firmă (commercial_partner_id) cu drepturi extinse; verificarea dacă utilizatorul are voie să le vadă se află înaintea ei.

Teste

Modulul vine cu treisprezece teste automate, care la noi rulează cu succes:

• acces doar cu opțiunea setată, altfel redirecționare către Contul meu,
• lista conține pozițiile întregii firme, dar niciodată pe cele ale altei firme,
• opțiunea se aplică per contact, nu tuturor utilizatorilor firmei,
• notele de credit apar în listă cu sumă negativă și reduc soldul,
• data de referință: o factură plătită mai târziu apare înainte în listă, după aceea nu,
• pagina cu dată viitoare și cu dată invalidă,
• adresa PDF livrează un fișier PDF,
• raport ca HTML și verificarea accesului în raport,
• suma deschisă la data de referință după plăți parțiale înainte și după data de referință,
• comportamentul de plată: încadrarea în la timp, cu până la o săptămână întârziere și mai târziu, cu valorile medii, inclusiv pentru o dată de referință în trecut,
• comportamentul de plată cu facturi deschise și evaluarea bună sau slabă,
• comportamentul de plată fără facturi și niciodată cu date ale altei firme,
• comportamentul de plată în pagina de portal și în PDF.

În plus, am parcurs pagina în browser într-o bază de date de test cu clienți exemplu; imaginile din acest articol provin de acolo. Toate numele, numerele de documente și sumele din ele sunt inventate.

Instalare și configurare

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

Dependențele sunt account și portal. După instalare, serviciul Odoo trebuie repornit, deoarece modulul conține cod Python. Cine administrează un sistem de producție instalează modulul mai întâi pe o copie a bazei de date. Apoi:

1. deschideți contactul care trebuie să vadă lista (persoană cu acces la portal),
2. în formular bifați caseta Afișează lista pozițiilor deschise în portal și salvați,
3. autentificați-vă în portal ca acest utilizator sau verificați împreună cu clientul: caseta, lista, data de referință și PDF-ul.

Înainte de activare, verificați setările de expeditor și de layout ale firmei dumneavoastră, deoarece PDF-ul preia logoul, adresa și subsolul din layoutul documentului. Modulul nu trimite singur e-mailuri și nu generează notificări.

Limitări și observații

• Situația de astăzi pentru documentele înregistrate. Data de referință se calculează pe baza înregistrărilor, așa cum se află acum în sistem. Dacă după data de referință o factură a fost anulată sau resetată la ciornă, lista nu o afișează. Nu este o fotografie imuabilă „așa cum a fost tipărită atunci”.
• Plățile contează din ziua reconcilierii. Dacă o plată este alocată abia după zile de la primirea unei facturi, factura apare până atunci ca deschisă în listă. Cine dorește analize curate la data de referință ar trebui să aloce plățile la timp. O reconciliere bancară pe facturi nu este inclusă în Odoo Community; pentru aceasta folosim modulul nostru Bank-Statement-Matcher.
• Comportamentul de plată este la fel de bun ca reconcilierea dumneavoastră. Se numără momentul în care o plată a fost alocată unei facturi. Plățile care nu au fost reconciliate multă vreme fac ca un client să arate mai rău decât este. Verificați evaluarea la clienții dumneavoastră înainte de a deduce ceva din ea.
• Evaluarea este vizibilă pentru client. Cine are opțiunea vede și rezultatul, și mențiunea privind plata în avans. Modulul nu modifică prin aceasta condițiile de plată.
• Numai creanțe. Modulul arată ce vă datorează clientul, nu datoriile dumneavoastră față de client.
• Fără trepte de somație și fără link de plată în listă. Clientul poate deschide din listă o factură și o poate plăti acolo, așa cum permite altfel portalul dumneavoastră.
• PDF și funcționare multiproces. Pentru a genera rapoarte PDF, Odoo își apelează intern propria adresă web. Dacă sistemul dumneavoastră rulează cu un singur proces de lucru, aceasta se poate bloca. Acest lucru este valabil pentru toate rapoartele PDF din portal, nu doar pentru acest modul. Verificați butonul PDF după instalare o dată în condiții reale.
• Testat numai cu Odoo 19.0 Community. Pentru alte versiuni nu l-am verificat.
• Nu înlocuiește urmărirea creanțelor și extrasul de cont. Lista nu înlocuiește nici un extras de cont contabil, nici procesele dumneavoastră de somare, ci doar face situația transparentă.

Întrebări frecvente

Ce este o listă a pozițiilor deschise (listă OP)?

O situație a tuturor facturilor care nu sunt încă plătite sau nu sunt plătite integral, cu data facturii, scadența și suma deschisă. Se mai numește „facturi deschise”, „cont client” sau „balanță de verificare”, deși o balanță de verificare înseamnă, în sens strict, soldurile tuturor conturilor.

De ce nu afișează portalul Odoo din start o listă OP?

Portalul afișează comenzile, facturile și plățile individual, cu stare și filtre. O listă globală a companiei cu sold și o analiză la data de referință nu fac parte din conținutul Community, din câte am văzut. Pentru aceasta este destinat modulul.

Văd toți utilizatorii de portal ai unei firme lista?

Nu. Doar contactele cu opțiunea setată. Lista afișată cuprinde însă întreaga firmă, nu doar facturile acelui contact.

Pot alege o dată de referință din trecut, de exemplu 31.12. a anului precedent?

Da, orice dată până astăzi. Lista arată atunci pozițiile care în acea zi erau înregistrate și încă neplătite. Rețineți observațiile privind calculul: hotărâtoare este ziua reconcilierii plății.

Este acceptată o dată de referință din viitor?

Nu. Datele viitoare sunt tratate ca astăzi, pentru ca lista să nu afișeze o situație care nu există încă.

Apar în listă notele de credit și avansurile?

Da. Notele de credit și plățile care nu sunt încă alocate unei facturi apar în listă cu sumă negativă și reduc soldul. O notă sub tabel explică acest lucru clientului.

Cum sunt recunoscute pozițiile scadente depășite?

O poziție este scadentă depășită dacă data ei de scadență este înaintea datei de referință și mai este deschis un rest pozitiv. Zilele de peste scadență se numără până la data de referință.

Există PDF-ul și în alte limbi?

Da, interfața și PDF-ul urmează limba utilizatorului. Este livrată traducerea în germană; pentru alte limbi este suficient un fișier .po sau traducerea prin interfața Odoo.

Poate un client vedea lista altei firme dacă modifică adresa?

Nu. Firma rezultă întotdeauna din utilizatorul autentificat. Adresa conține doar data de referință. Și adresa de raport PDF a Odoo este verificată încă o dată în raportul însuși.

Cum se calculează comportamentul de plată?

Din facturile de client înregistrate din ultimele douăsprezece luni și din toate facturile deschise. La fiecare factură contează câte zile după scadență a fost plătită: cel mult la data scadenței (verde), până la șapte zile după aceasta (portocaliu) sau mai târziu (roșu). Evaluarea este bună la cel puțin 70 % verde sau portocaliu și nicio factură deschisă scadentă depășită de mai mult de 30 de zile. Detaliile se găsesc în secțiunea comportamentul de plată.

Trece modulul clienții cu comportament de plată slab la plata în avans?

Nu. Afișează doar evaluarea și mențiunea. Condițiile de plată, plata în avans și blocările rămân decizia dumneavoastră și procesul dumneavoastră în Odoo.

Trimite modulul e-mailuri sau somații?

Nu. Oferă doar pagina și PDF-ul. Nu generează mesaje, notificări sau activități.

Funcționează modulul cu Odoo Enterprise?

Depinde doar de account și portal, care există în ambele ediții. L-am testat numai pe ediția Community a Odoo 19.

Sub ce licență se află modulul?

Sub AGPL-3. Aveți voie să îl folosiți, să îl modificați și să îl distribuiți, dacă respectați condițiile licenței. Erorile și propunerile de îmbunătățire sunt binevenite ca issue în depozitul GitHub .

Asistență din partea Biricon IT Services

Ne ocupăm de instalări Odoo pentru întreprinderi mici și mijlocii: de la introducere, prin adaptări și migrări, până la exploatarea curentă. Dacă doriți să puneți la dispoziția clienților dumneavoastră în portal pozițiile deschise, facturile și tichetele, să extindeți contabilitatea în Odoo Community sau să aduceți în siguranță un modul în instanța dumneavoastră de producție, vă ajutăm cu plăcere. Alte dezvoltări proprii: Arhivarea unei firme împreună cu utilizatorii de portal, Registrul comerțului și verificarea adreselor pentru clienți austrieci, Numere de documente din prefix, an și contor și Seturi de produse în ofertă ca secțiune.

Luați legătura acum

Stadiu: 6 noiembrie 2026. Versiunea modulului 19.0.1.1.1. Modificări față de prima versiune din 5 noiembrie: comportamentul de plată (19.0.1.1.0) și corectarea sumei deschise la data de referință după plăți parțiale (19.0.1.1.1). Toate numele, numerele de documente și sumele din imagini sunt inventate.