Odoo 19: partite aperte nel portale clienti con data di riferimento ed esportazione PDF – modulo portal_open_items

“Quanto abbiamo ancora in sospeso con voi?” Questa domanda arriva regolarmente in ogni base clienti, di solito poco prima della chiusura del trimestre, prima della revisione del bilancio annuale o quando la contabilità del cliente prepara i pagamenti. Chi non vi risponde in autonomia se la vede porre per e-mail o per telefono, e qualcuno deve esportare dalla contabilità un elenco delle partite aperte (elenco P.A.) e inviarlo. Con Odoo 19 Community questo non avviene da sé: il portale clienti mostra sì le singole fatture, ma non un elenco delle partite aperte dell’intera azienda, tanto meno a una data scelta liberamente.

Per questo abbiamo scritto il modulo Partite aperte nel portale clienti (portal_open_items) per Odoo 19. I clienti con accesso abilitato vedono nel portale un elenco di tutte le fatture aperte, le note di credito e i pagamenti non ancora assegnati della loro azienda, possono scegliere una data di riferimento, scaricare l’elenco in PDF e vedere a colpo d’occhio come stanno con la loro puntualità nei pagamenti. Il modulo è software libero con licenza AGPL-3 ed è disponibile su GitHub:

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

Abbiamo installato il modulo il 5 novembre 2026 nel nostro sistema di produzione. L’opzione lì è disattivata per impostazione predefinita e viene attivata solo previo accordo con i singoli clienti. L’esperienza d’uso è quindi ancora breve; abbiamo eseguito tredici test automatici e provato il modulo su un database di test con clienti di esempio. Chi adotta il modulo dovrebbe leggere le sezioni sul calcolo della data di riferimento, sulla puntualità nei pagamenti e sui limiti .

Il problema: l’elenco P.A. su richiesta

Un elenco delle partite aperte mostra quali fatture di un cliente non sono ancora state pagate, quali sono scadute e a quanto ammonta il saldo. Per il fornitore è uno strumento di pianificazione della liquidità e di sollecito dei pagamenti. Per il cliente è la base per pianificare i pagamenti, riconciliare le fatture con la propria contabilità e chiarire eventuali dubbi senza aprire ogni fattura singolarmente. Occasioni tipiche:

• Chiusura trimestrale e annuale: la contabilità del cliente vuole sapere quali debiti sussistevano al 31.12. Si tratta di una data di riferimento nel passato.
• Riconciliazione: il cliente ritiene di aver pagato una fattura, mentre per noi risulta ancora aperta. Un elenco condiviso con data, scadenza e importo chiarisce la questione più rapidamente di una catena di e-mail.
• Cicli di pagamento: chi prepara i pagamenti ogni settimana o ogni mese ha bisogno di tutte le fatture aperte di un fornitore a colpo d’occhio, con quelle scadute in alto.
• Più referenti: in un’azienda uno ordina e un altro paga. Le partite aperte appartengono all’azienda, non a una singola persona.

Finora estraevamo questi elenchi a mano dalla contabilità e li inviavamo per e-mail. Ciò richiede tempo e alla fine si tratta di un’istantanea che il giorno dopo è già superata. Meglio un elenco che il cliente può aprire da sé in qualsiasi momento nel portale, sempre con la situazione aggiornata.

La soluzione in sintesi

Il modulo integra il portale clienti di Odoo con una pagina Partite aperte e un riquadro in Il mio account. Le funzionalità:

• Opzione per contatto: “Mostra l’elenco delle partite aperte nel portale”. Solo se è impostata, l’utente del portale vede il riquadro e la pagina. Per impostazione predefinita è disattivata.
• Intera azienda: l’elenco contiene le partite aperte di tutti i contatti dell’azienda, non solo quelle dell’utente connesso.
• Data di riferimento: il cliente sceglie una data e vede che cosa risultava aperto in quel giorno.
• Esportazione PDF: l’elenco in PDF nel layout della vostra azienda, con intestazione, saldo e somma delle partite scadute.
• Puntualità nei pagamenti: quota delle fatture pagate in tempo, con lieve ritardo e in ritardo, fattura aperta da più tempo e una valutazione buona o scarsa, nel portale e nel PDF.
• Le partite scadute sono evidenziate a colori e indicano i giorni trascorsi dalla data di scadenza.
• Le note di credito e i crediti compaiono nell’elenco con importo negativo e riducono il saldo.
• Collegamento: ogni fattura dell’elenco porta alla vista della fattura nel portale.
• Multilingua: interfaccia e PDF seguono la lingua dell’utente; la traduzione in tedesco è inclusa.

Il riquadro compare nella pagina iniziale Il mio account accanto agli ordini e alle fatture. Chi non dispone dell’opzione non lo vede.

Abilitazione per contatto: l’opzione

Un elenco P.A. mostra dati commerciali di un’intera azienda. Per questo il modulo non lo abilita per tutti gli utenti del portale, ma solo dove lo desiderate espressamente. Nella scheda del contatto, sotto Sito web, si trova la casella “Mostra l’elenco delle partite aperte nel portale”. È visibile agli utenti con diritti di fatturazione (gruppo account.group_account_invoice) e vale per quel singolo contatto.

Ciò corrisponde alla pratica: in un’azienda l’elenco deve essere visibile alla direzione o alla contabilità, ma non a un collaboratore che consulta solo i ticket. L’opzione vale per il contatto, mentre le partite visualizzate appartengono all’intera azienda. Impostate quindi l’opzione per la persona che deve avere una visione d’insieme dell’azienda.

L’elenco nel portale clienti

Un clic sul riquadro apre /my/open-items. La pagina mostra il nome dell’azienda, la selezione della data di riferimento e la tabella con le partite aperte:

Sotto la tabella compaiono il saldo, cioè la somma di tutti gli importi aperti, e la somma delle partite scadute. Le righe scadute hanno uno sfondo colorato, così da risultare subito visibili a una rapida occhiata. Le note di credito e i pagamenti non ancora assegnati a una fattura compaiono con segno negativo e riducono il saldo; una nota sotto la tabella lo spiega al cliente. Se la vostra azienda opera in più valute, il saldo viene esposto per ciascuna valuta.

Partite aperte alla data di riferimento

Sopra la tabella compare “Partite aperte alla data di riferimento”, accanto un campo data e il pulsante Mostra. Con una data di riferimento nel passato l’elenco mostra che cosa non era ancora stato pagato in quel giorno. È esattamente l’analisi necessaria per chiusure, revisioni e riconciliazioni: “Quali debiti avevamo al 31.12. nei confronti di questo fornitore?”

Come viene calcolata la data di riferimento

Per ogni partita vale: Aperto alla data di riferimento = importo della fattura meno tutti i pagamenti riconciliati fino alla data di riferimento inclusa. Una partita compare nell’elenco se alla data di riferimento era già registrata e presentava ancora un residuo. Una fattura del 7 settembre di 1.250,50 €, pagata in parte il 20 ottobre con 500,00 € e saldata per il resto il 5 novembre, compare quindi nell’elenco con 750,50 € per una data di riferimento al 2 novembre e non compare più affatto per una data di riferimento al 5 novembre.

Anche la scadenza viene valutata alla data di riferimento: una partita è scaduta se la sua data di scadenza precede la data di riferimento e il residuo è positivo. I giorni oltre la scadenza si contano fino alla data di riferimento, non fino a oggi. Una data di riferimento nel futuro viene trattata come oggi, così come una data vuota o non valida nella barra degli indirizzi. L’elenco non può quindi simulare una previsione.

Che cosa significa qui “data del pagamento”

Fa fede la data in cui fattura e pagamento sono stati riconciliati tra loro in Odoo (la maggiore delle due date di registrazione), non la data della fattura. È il caso abituale: il pagamento viene registrato il giorno dell’incasso e assegnato alla fattura. Chi assegna i pagamenti solo dopo alcuni giorni vedrà la fattura come aperta più a lungo. La sezione limiti approfondisce questo aspetto.

Esportazione PDF

Con Scarica PDF il modulo genera l’elenco come file PDF per la data di riferimento scelta. Il pulsante Stampa apre lo stesso elenco nella finestra di stampa del browser. Il PDF utilizza il layout dei documenti della vostra azienda Odoo (logo, indirizzo, piè di pagina dalle impostazioni) e il formato carta europeo:

• Titolo con data di riferimento: “Partite aperte alla data di riferimento 02.11.2026”, anche se la data di riferimento è oggi. Se non ci sono partite aperte, compare “Non ci sono partite aperte.”
• Indirizzo del cliente nel campo indirizzo del layout aziendale, affinché l’elenco, anche stampato, sia riconducibile al destinatario.
• Partite scadute in grassetto, in modo che risaltino anche nella stampa in bianco e nero.
• Saldo e somma delle partite scadute alla fine della tabella, per ciascuna valuta se ce ne sono più di una.
• Nome del file con azienda e data, ad esempio Open_items_Muster_Handels_GmbH_2026-11-02.pdf.

Puntualità nei pagamenti: valutazione a colpo d’occhio

Dalla versione 19.0.1.1.0 sopra la tabella compare una breve analisi di quanto puntualmente l’azienda paga le proprie fatture. La stessa analisi compare nel PDF. Il cliente vede così da solo a che punto si trova e voi non dovete più spiegarglielo a parte.

• Verde: “Il 47 % è stato pagato entro il termine di pagamento.” Si tratta di fatture pagate alla data di scadenza o prima.
• Arancione: “Il 29 % è stato pagato nella settimana successiva alla scadenza del termine di pagamento.” Sono pagamenti da uno a sette giorni dopo la scadenza.
• Rosso: “Il 24 % è stato pagato più tardi, in media dopo 39 giorni (25 giorni dopo la scadenza del termine di pagamento).” Il primo numero conta dalla data della fattura, quello tra parentesi dalla scadenza. La riga compare solo se esistono fatture di questo tipo.
• “Le fatture sono aperte da un massimo di 60 giorni.” È l’età della fattura più vecchia ancora aperta alla data di riferimento, calcolata dalla data della fattura.

Sotto compare la valutazione della puntualità nei pagamenti: buona o scarsa, e a fine pagina, nel PDF in fondo alla pagina, l’avviso “I clienti con scarsa puntualità nei pagamenti vengono passati al pagamento anticipato.” Il PDF mostra le stesse righe nel layout su carta intestata:

Che cosa viene conteggiato

• Vengono valutate le fatture emesse al cliente e registrate. Le note di credito e le bozze non contano. In caso di pagamento rateale ogni rata conta a sé.
• Periodo: le fatture degli ultimi dodici mesi e tutte le fatture ancora aperte, anche se più vecchie.
• Giorno di pagamento è la data dell’ultima riconciliazione con un pagamento, come per la data di riferimento.
• Fatture aperte: se una fattura è scaduta alla data di riferimento, conta come se fosse stata pagata in quella data, quindi arancione o rossa. Una fattura aperta non ancora scaduta non viene valutata.
• Con una data di riferimento nel passato vale la situazione di quel giorno: i pagamenti successivi alla data di riferimento non contano ancora.
• Se non c’è nulla da valutare, compare “Nessuna fattura degli ultimi 12 mesi da valutare.” e non c’è alcuna valutazione.

Quando la puntualità nei pagamenti è “buona”?

La valutazione è buona se almeno il 70 % delle fatture è verde o arancione (puntuali o con al massimo una settimana di ritardo) e nessuna fattura aperta è scaduta da più di 30 giorni. Altrimenti è scarsa. Le soglie (7 giorni, 70 %, 30 giorni, 12 mesi) sono costanti all’inizio di models/res_partner.py e possono essere modificate lì.

Importante: il modulo non passa nessuno al pagamento anticipato. L’avviso nel piè di pagina è un testo fisso che mostra ai clienti con valutazione scarsa che cosa può derivarne. Se e quando decidere in tal senso resta una vostra scelta. Se la frase non vi piace, modificatela nei due template (pagina del portale e report) o nella traduzione.

Chi può vedere cosa? Il modello di accesso

Le partite aperte sono dati sensibili; per questo l’accesso è stato per noi più importante di qualsiasi funzione aggiuntiva. Il modello è volutamente semplice:

• Solo con l’opzione impostata. Senza la spunta sul contatto non c’è alcun riquadro, e una chiamata a /my/open-items reindirizza a Il mio account.
• Sempre la propria azienda. L’azienda viene determinata dall’utente connesso, non da un parametro nell’indirizzo. Non è possibile richiedere un’azienda terza tramite la barra degli indirizzi.
• Stessa verifica per il PDF. Odoo mette di norma a disposizione i report PDF anche tramite un indirizzo generico. Il modulo ripete quindi la verifica nel report stesso: solo gli utenti con diritti di contabilità o gli utenti del portale con l’opzione impostata per la propria azienda ottengono un PDF, tutti gli altri un errore di accesso.
• Solo partite registrate. Le bozze e i documenti annullati non compaiono mai.
• Solo i propri ambiti contabili: vengono considerate solo le registrazioni delle aziende a cui l’utente ha accesso.

Realizzazione tecnica

Il modulo dipende solo da account e portal, cioè da componenti di Odoo Community. Aggiunge un solo campo al contatto e per il resto consiste in un controller, una classe di report e dei template.

Le partite aperte vengono lette dalle righe di registrazione, non dalle fatture. Questo è importante: solo così compaiono anche le note di credito e i pagamenti non ancora assegnati, e solo così è possibile ricostruire la situazione a un giorno precedente a partire dalle riconciliazioni (account.partial.reconcile). La query viene eseguita per l’intera azienda (commercial_partner_id) con diritti elevati; la verifica che l’utente possa vederle precede la query.

Test

Il modulo include tredici test automatici, che da noi passano tutti:

• accesso solo con l’opzione impostata, altrimenti reindirizzamento a Il mio account,
• l’elenco contiene le partite dell’intera azienda, ma mai quelle di un’altra,
• l’opzione vale per contatto, non per tutti gli utenti dell’azienda,
• le note di credito compaiono nell’elenco con importo negativo e riducono il saldo,
• data di riferimento: una fattura pagata successivamente compare nell’elenco prima, ma non dopo,
• pagina con data futura e con data non valida,
• l’indirizzo del PDF restituisce un file PDF,
• report come HTML e controllo degli accessi nel report,
• importo aperto alla data di riferimento dopo pagamenti parziali prima e dopo la data di riferimento,
• puntualità nei pagamenti: suddivisione in puntuali, fino a una settimana di ritardo e oltre, con i valori medi, anche per una data di riferimento nel passato,
• puntualità nei pagamenti con fatture aperte e la valutazione buona o scarsa,
• puntualità nei pagamenti senza fatture e mai con dati di un’altra azienda,
• puntualità nei pagamenti nella pagina del portale e nel PDF.

Inoltre abbiamo provato la pagina nel browser in un database di test con clienti di esempio; le immagini di questo articolo provengono da lì. Tutti i nomi, i numeri di documento e gli importi sono del tutto inventati.

Installazione e configurazione

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

Le dipendenze sono account e portal. Dopo l’installazione il servizio Odoo deve essere riavviato, perché il modulo contiene codice Python. Chi gestisce un sistema di produzione installa il modulo prima su una copia del database. Poi:

1. aprire il contatto che deve vedere l’elenco (persona con accesso al portale),
2. nella scheda impostare la casella Mostra l’elenco delle partite aperte nel portale e salvare,
3. accedere al portale come questo utente oppure verificare insieme al cliente: riquadro, elenco, data di riferimento e PDF.

Prima dell’abilitazione controllate le impostazioni del mittente e del layout della vostra azienda, perché il PDF riprende logo, indirizzo e piè di pagina dal layout dei documenti. Il modulo non invia e-mail in autonomia e non genera notifiche.

Limiti e avvertenze

• Situazione attuale per i documenti registrati. La data di riferimento viene calcolata sulla base delle registrazioni così come si trovano ora nel sistema. Se dopo la data di riferimento una fattura è stata annullata o riportata in bozza, l’elenco non la mostra. Non si tratta di un’istantanea immutabile “così come era stata stampata allora”.
• I pagamenti contano dal giorno della riconciliazione. Se un pagamento viene assegnato solo alcuni giorni dopo l’incasso di una fattura, fino ad allora la fattura compare nell’elenco come aperta. Chi desidera analisi alla data di riferimento accurate dovrebbe assegnare i pagamenti tempestivamente. La riconciliazione bancaria sulle fatture non è inclusa in Odoo Community; per questo utilizziamo il nostro modulo Bank Statement Matcher.
• La puntualità nei pagamenti vale quanto la vostra riconciliazione. Si conta quando un pagamento è stato assegnato a una fattura. I pagamenti non riconciliati da molto tempo fanno apparire un cliente peggiore di quanto sia. Controllate la valutazione dei vostri clienti prima di trarne conclusioni.
• La valutazione è visibile al cliente. Chi ha l’opzione vede anche il risultato e l’avviso sul pagamento anticipato. Il modulo non modifica in alcun modo le condizioni di pagamento.
• Solo crediti. Il modulo mostra ciò che il cliente vi deve, non i vostri debiti nei confronti del cliente.
• Nessun livello di sollecito e nessun link di pagamento nell’elenco. Dall’elenco il cliente può aprire una fattura e pagarla lì, secondo quanto il vostro portale consente altrimenti.
• PDF e funzionamento multiprocesso. Per generare i report PDF Odoo richiama internamente il proprio indirizzo web. Se il vostro sistema funziona con un solo processo di lavoro, ciò può causare un blocco. Questo vale per tutti i report PDF nel portale, non solo per questo modulo. Dopo l’installazione verificate il pulsante PDF almeno una volta in condizioni reali.
• Testato solo con Odoo 19.0 Community. Per altre versioni non l’abbiamo verificato.
• Non sostituisce il sollecito dei pagamenti né l’estratto conto. L’elenco non sostituisce né un estratto conto contabile né i vostri processi di sollecito, rende solo trasparente la situazione.

Domande frequenti

Che cos’è un elenco delle partite aperte (elenco P.A.)?

Un prospetto di tutte le fatture non ancora pagate o pagate solo in parte, con data della fattura, scadenza e importo aperto. Viene chiamato anche “fatture aperte”, “conto cliente” o “bilancio di verifica”, anche se il bilancio di verifica in senso stretto indica i saldi di tutti i conti.

Perché il portale Odoo non mostra già di serie un elenco P.A.?

Il portale mostra ordini, fatture e pagamenti singolarmente, con stato e filtri. Un elenco complessivo dell’azienda con saldo e un’analisi alla data di riferimento non rientrano, per quanto abbiamo potuto vedere, nelle funzioni della Community. Il modulo serve proprio a questo.

Tutti gli utenti del portale di un’azienda vedono l’elenco?

No. Solo i contatti con l’opzione impostata. L’elenco visualizzato comprende però l’intera azienda, non solo le fatture di quel singolo contatto.

Posso scegliere una data di riferimento nel passato, ad esempio il 31.12. dell’anno precedente?

Sì, una data qualsiasi fino a oggi. L’elenco mostra allora le partite che in quel giorno erano registrate e non ancora pagate. Tenete presente le avvertenze sul calcolo: fa fede il giorno della riconciliazione del pagamento.

È supportata una data di riferimento nel futuro?

No. Le date future vengono trattate come oggi, in modo che l’elenco non mostri una situazione che non esiste ancora.

Nell’elenco compaiono note di credito e acconti?

Sì. Le note di credito e i pagamenti non ancora assegnati a una fattura compaiono nell’elenco con importo negativo e riducono il saldo. Una nota sotto la tabella lo spiega al cliente.

Come vengono riconosciute le partite scadute?

Una partita è scaduta se la sua data di scadenza precede la data di riferimento ed è ancora aperto un residuo positivo. I giorni oltre la scadenza vengono contati fino alla data di riferimento.

Il PDF è disponibile anche in altre lingue?

Sì, interfaccia e PDF seguono la lingua dell’utente. È inclusa la traduzione in tedesco; per altre lingue è sufficiente un file .po oppure la traduzione tramite l’interfaccia di Odoo.

Un cliente può vedere l’elenco di un’altra azienda se modifica l’indirizzo?

No. L’azienda risulta sempre dall’utente connesso. L’indirizzo contiene solo la data di riferimento. Anche l’indirizzo dei report PDF di Odoo viene ricontrollato nel report stesso.

Come viene calcolata la puntualità nei pagamenti?

Dalle fatture cliente registrate degli ultimi dodici mesi e da tutte le fatture aperte. Per ogni fattura conta quanti giorni dopo la scadenza è stata pagata: al più alla data di scadenza (verde), fino a sette giorni dopo (arancione) o più tardi (rosso). La valutazione è buona con almeno il 70 % di fatture verdi o arancioni e nessuna fattura aperta scaduta da più di 30 giorni. I dettagli sono nella sezione puntualità nei pagamenti.

Il modulo passa al pagamento anticipato i clienti con scarsa puntualità nei pagamenti?

No. Mostra soltanto la valutazione e l’avviso. Condizioni di pagamento, pagamento anticipato e blocchi restano una vostra decisione e un vostro processo in Odoo.

Il modulo invia e-mail o solleciti?

No. Mette a disposizione solo la pagina e il PDF. Non genera messaggi, notifiche o attività.

Il modulo funziona con Odoo Enterprise?

Dipende solo da account e portal, presenti in entrambe le edizioni. Lo abbiamo testato solo sull’edizione Community di Odoo 19.

Con quale licenza è distribuito il modulo?

Con la AGPL-3. Potete utilizzarlo, modificarlo e distribuirlo nel rispetto delle condizioni di licenza. Segnalazioni di errori e proposte di miglioramento sono benvenute come issue nel repository GitHub .

Assistenza da parte di Biricon IT Services

Seguiamo installazioni Odoo per piccole e medie imprese: dall’introduzione alle personalizzazioni e migrazioni fino alla gestione corrente. Se desiderate mettere a disposizione dei vostri clienti nel portale partite aperte, fatture e ticket, ampliare la contabilità in Odoo Community o portare un modulo in sicurezza nella vostra istanza di produzione, saremo lieti di aiutarvi. Altri sviluppi interni: Archiviare un’azienda insieme agli utenti del portale, Registro delle imprese e verifica degli indirizzi per clienti austriaci, Numeri di documento composti da prefisso, anno e contatore e Set di prodotti nell’offerta come sezione.

Contattateci ora

Aggiornamento: 6 novembre 2026. Versione del modulo 19.0.1.1.1. Modifiche rispetto alla prima versione del 5 novembre: puntualità nei pagamenti (19.0.1.1.0) e correzione dell’importo aperto alla data di riferimento dopo pagamenti parziali (19.0.1.1.1). Tutti i nomi, i numeri di documento e gli importi nelle figure sono di fantasia.