Odoo 19 : postes ouverts dans le portail client avec date de référence et export PDF – module portal_open_items

« Combien nous reste-t-il encore à vous payer, au juste ? » Cette question revient régulièrement dans toute clientèle, le plus souvent juste avant la clôture trimestrielle, avant l’audit des comptes annuels ou lorsque la comptabilité du client prépare ses paiements. Celui qui n’y répond pas lui-même la reçoit par e-mail ou par téléphone, et quelqu’un doit alors exporter de la comptabilité une liste des postes ouverts (liste PO) et l’envoyer. Avec Odoo 19 Community, cela ne se fait pas tout seul : le portail client affiche certes les factures une à une, mais pas de liste des postes ouverts de toute l’entreprise, et encore moins à une date librement choisie.

Nous avons écrit pour cela le module Postes ouverts dans le portail client (portal_open_items) pour Odoo 19. Les clients dont l’accès est activé voient dans le portail une liste de toutes les factures ouvertes, de tous les avoirs et de tous les paiements pas encore affectés de leur entreprise, peuvent choisir une date de référence, télécharger la liste en PDF et voient d’un coup d’œil où ils en sont de leur comportement de paiement. Le module est un logiciel libre sous licence AGPL-3 et se trouve sur GitHub :

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

Nous avons installé le module le 5 novembre 2026 dans notre système de production. L’option y est désactivée par défaut et n’est activée qu’après accord avec chaque client concerné. Notre expérience en exploitation est donc encore brève ; nous l’avons testé avec treize tests automatiques et une base de test contenant des clients d’exemple. Si vous reprenez le module, lisez les sections sur le calcul de la date de référence, sur le comportement de paiement et sur les limites .

Le problème : la liste PO sur demande

Une liste des postes ouverts indique quelles factures d’un client ne sont pas encore payées, lesquelles sont échues et à combien s’élève le solde. Pour le fournisseur, c’est un outil de planification de trésorerie et de relance. Pour le client, c’est la base pour planifier ses paiements, rapprocher les factures de sa propre comptabilité et clarifier des questions sans ouvrir chaque facture une à une. Occasions typiques :

• Clôture trimestrielle et annuelle : la comptabilité du client veut savoir quelles dettes existaient au 31.12. Il s’agit d’une date de référence passée.
• Rapprochement : le client pense avoir payé une facture, alors que nous la voyons encore ouverte. Une liste commune avec la date, l’échéance et le montant règle la question plus vite qu’une chaîne d’e-mails.
• Campagnes de paiement : celui qui prépare ses paiements chaque semaine ou chaque mois a besoin de toutes les factures ouvertes d’un fournisseur d’un seul coup d’œil, les échues en tête.
• Plusieurs interlocuteurs : dans une entreprise, l’un commande, l’autre paie. Les postes ouverts appartiennent à l’entreprise, pas à une personne en particulier.

Jusqu’ici, nous extrayions ces listes à la main de la comptabilité et les envoyions par e-mail. Cela prend du temps et ne donne finalement qu’un instantané, déjà périmé dès le lendemain. Il vaut mieux une liste que le client ouvre lui-même à tout moment dans le portail, toujours à jour.

La solution en bref

Le module complète le portail client d’Odoo par une page Postes ouverts et une vignette sur Mon compte. Étendue des fonctions :

• Option par contact : « Afficher la liste des postes ouverts dans le portail ». Ce n’est que si elle est cochée que l’utilisateur du portail voit la vignette et la page. Par défaut, elle est désactivée.
• Toute l’entreprise : la liste contient les postes ouverts de tous les contacts de la société, pas seulement ceux de l’utilisateur connecté.
• Date de référence : le client choisit une date et voit ce qui était ouvert ce jour-là.
• Export PDF : la liste en PDF dans la mise en page de votre entreprise, avec en-tête, solde et total des postes échus.
• Comportement de paiement : part des factures payées à temps, avec un léger retard et en retard, facture ouverte la plus ancienne et évaluation bon ou mauvais, dans le portail et dans le PDF.
• Les postes échus sont signalés en couleur et indiquent le nombre de jours de retard par rapport à la date d’échéance.
• Avoirs et crédits figurent dans la liste avec un montant négatif et réduisent le solde.
• Lien : chaque facture de la liste mène à la vue de la facture dans le portail.
• Multilingue : l’interface et le PDF suivent la langue de l’utilisateur ; l’allemand est fourni en traduction.

La vignette apparaît sur la page d’accueil Mon compte, à côté des commandes et des factures. Celui qui n’a pas l’option ne la voit pas.

Activation par contact : l’option

Une liste PO montre les données commerciales de toute une entreprise. C’est pourquoi le module ne l’active pas pour tous les utilisateurs du portail, mais seulement là où vous le souhaitez expressément. Sur le contact, le formulaire comporte, sous Site web, la case à cocher « Afficher la liste des postes ouverts dans le portail ». Elle est visible pour les utilisateurs disposant des droits de facturation (groupe account.group_account_invoice) et vaut pour ce seul contact.

Cela correspond à la pratique : dans une entreprise, la direction ou la comptabilité doit voir la liste, alors qu’un collaborateur qui ne consulte que des tickets n’en a pas besoin. L’option s’applique au contact, mais les postes affichés appartiennent à toute l’entreprise. Activez donc l’option pour la personne qui doit avoir une vue d’ensemble de la société.

La liste dans le portail client

Un clic sur la vignette ouvre /my/open-items. La page affiche le nom de l’entreprise, le choix de la date de référence et le tableau des postes ouverts :

Sous le tableau figurent le solde, c’est-à-dire la somme de tous les montants ouverts, et le total des postes échus. Les lignes échues sont surlignées en couleur afin de les repérer immédiatement d’un coup d’œil. Les avoirs et les paiements non encore affectés à une facture apparaissent avec un signe négatif et réduisent le solde ; une remarque sous le tableau l’explique au client. Si votre entreprise travaille dans plusieurs devises, le solde est indiqué par devise.

Postes ouverts à une date de référence

Au-dessus de la date figure « Postes ouverts à une date de référence », à côté un champ de date et le bouton Afficher. Avec une date de référence passée, la liste montre ce qui n’était pas encore payé ce jour-là. C’est exactement l’analyse nécessaire pour les clôtures, les audits et les rapprochements : « Quelles dettes avions-nous au 31.12. envers ce fournisseur ? »

Comment la date de référence est calculée

Pour chaque poste, la règle est la suivante : ouvert à la date de référence = montant de la facture moins tous les paiements rapprochés jusqu’à la date de référence incluse. Un poste figure dans la liste s’il était déjà comptabilisé à la date de référence et présentait encore un reliquat. Une facture du 7 septembre de 1.250,50 €, partiellement payée à hauteur de 500,00 € le 20 octobre et soldée le 5 novembre, apparaît donc dans la liste avec 750,50 € pour une date de référence au 2 novembre, et plus du tout pour une date de référence au 5 novembre.

L’échéance dépassée est elle aussi appréciée à la date de référence : un poste est échu si sa date d’échéance précède la date de référence et que le reliquat est positif. Les jours de retard sont comptés jusqu’à la date de référence, non jusqu’à aujourd’hui. Une date de référence future est traitée comme aujourd’hui, de même qu’une date vide ou invalide dans la barre d’adresse. La liste ne peut donc pas simuler une prévision.

Ce que signifie ici « date du paiement »

Ce qui compte est la date à laquelle la facture et le paiement ont été rapprochés l’un de l’autre dans Odoo (la plus tardive des deux dates de comptabilisation), et non la date de la facture. C’est le cas habituel : le paiement est comptabilisé le jour de son encaissement et affecté à la facture. Celui qui n’affecte les paiements que plusieurs jours plus tard verra la facture comme ouverte d’autant plus longtemps. La section limites y revient plus en détail.

Export PDF

Avec Télécharger le PDF, le module génère la liste sous forme de fichier PDF pour la date de référence choisie. Le bouton Imprimer ouvre la même liste dans la boîte de dialogue d’impression du navigateur. Le PDF utilise la mise en page des documents de votre société Odoo (logo, adresse, pied de page issus des paramètres) et le format de papier européen :

• Titre avec la date de référence : « Postes ouverts à la date de référence du 02.11.2026 », même si la date de référence est aujourd’hui. S’il n’y a aucun poste ouvert, on lit « Il n’y a aucun poste ouvert. »
• Adresse du client dans le champ d’adresse de la mise en page de la société, pour que la liste reste pertinente une fois imprimée.
• Postes échus en gras à l’impression, afin qu’ils ressortent aussi en noir et blanc.
• Solde et total des postes échus en bas du tableau, par devise en cas de plusieurs devises.
• Nom de fichier avec l’entreprise et la date, par exemple Open_items_Muster_Handels_GmbH_2026-11-02.pdf.

Comportement de paiement : une évaluation d’un coup d’œil

Depuis la version 19.0.1.1.0, une courte analyse figure au-dessus du tableau : elle indique avec quelle ponctualité l’entreprise paie ses factures. La même analyse apparaît dans le PDF. Le client voit ainsi lui-même où il en est, et vous n’avez plus à le lui expliquer séparément.

• Vert : « 47 % ont été payées dans le délai de paiement. » Il s’agit des factures payées à la date d’échéance ou avant.
• Orange : « 29 % ont été payées dans la semaine suivant l’expiration du délai de paiement. » Ce sont des paiements intervenus un à sept jours après l’échéance.
• Rouge : « 24 % ont été payées plus tard, en moyenne après 39 jours (25 jours après l’expiration du délai de paiement). » Le premier chiffre compte à partir de la date de facture, celui entre parenthèses à partir de l’échéance. Cette ligne n’apparaît que s’il existe de telles factures.
• « Les factures restent ouvertes jusqu’à 60 jours. » Il s’agit de l’ancienneté de la plus ancienne facture encore ouverte à la date de référence, calculée à partir de la date de facture.

En dessous figure l’évaluation du comportement de paiement : bon ou mauvais, et, en bas de page (dans le PDF, en fin de page), la mention « Les clients dont le comportement de paiement est mauvais sont passés au paiement d’avance. » Le PDF affiche les mêmes lignes dans la mise en page à en-tête :

Ce qui est compté

• Sont évaluées les factures adressées au client qui sont comptabilisées. Les avoirs et les brouillons ne comptent pas. En cas de paiement échelonné, chaque échéance compte séparément.
• Période : les factures des douze derniers mois et toutes les factures encore ouvertes, même plus anciennes.
• La date de paiement est la date du dernier rapprochement avec un paiement, comme pour la date de référence.
• Factures ouvertes : si une facture est échue à la date de référence, elle compte comme si elle avait été payée à la date de référence, donc orange ou rouge. Une facture ouverte qui n’est pas encore échue n’est pas évaluée.
• Avec une date de référence passée, c’est la situation de ce jour qui s’applique : les paiements postérieurs à la date de référence ne comptent pas encore.
• S’il n’y a rien à évaluer, on lit « Aucune facture des 12 derniers mois à évaluer. » et il n’y a pas d’évaluation.

Quand le comportement de paiement est-il « bon » ?

L’évaluation est bonne si au moins 70 % des factures sont vertes ou orange (à temps ou au plus une semaine de retard) et qu’aucune facture ouverte n’est échue depuis plus de 30 jours. Sinon, elle est mauvaise. Les seuils (7 jours, 70 %, 30 jours, 12 mois) figurent comme constantes au début de models/res_partner.py et peuvent y être modifiés.

Important : le module ne fait passer personne au paiement d’avance. La mention en pied de page est un texte fixe qui montre aux clients dont l’évaluation est mauvaise ce qui peut en découler. Si et quand vous prenez une telle décision, cela reste votre affaire. Si cette phrase ne vous convient pas, modifiez-la dans les deux modèles (page du portail et rapport) ou dans la traduction.

Qui peut voir quoi ? Le modèle d’accès

Les postes ouverts sont des données sensibles ; l’accès nous importait donc plus que toute fonction supplémentaire. Le modèle est volontairement simple :

• Uniquement avec l’option cochée. Sans la case cochée sur le contact, il n’y a pas de vignette, et un appel à /my/open-items redirige vers Mon compte.
• Toujours sa propre entreprise. L’entreprise est déterminée à partir de l’utilisateur connecté, et non d’un paramètre dans l’adresse. Il n’existe aucun moyen de demander une entreprise tierce via la barre d’adresse.
• Même contrôle pour le PDF. Odoo met en principe les rapports PDF à disposition aussi via une adresse générale. Le module effectue donc un nouveau contrôle dans le rapport lui-même : seuls les utilisateurs disposant du droit de comptabilité, ou les utilisateurs du portail avec l’option cochée pour leur propre entreprise, obtiennent un PDF ; tous les autres reçoivent une erreur d’accès.
• Uniquement les postes comptabilisés. Les brouillons et les pièces annulées n’apparaissent jamais.
• Uniquement ses propres périmètres comptables : seules sont prises en compte les écritures des sociétés auxquelles l’utilisateur a accès.

Réalisation technique

Le module ne dépend que de account et de portal, donc de composants d’Odoo Community. Il ajoute un unique champ sur le contact et se compose, pour le reste, d’un contrôleur, d’une classe de rapport et de modèles.

Les postes ouverts sont lus dans les lignes d’écriture, et non dans les factures. C’est important : c’est la seule façon de faire apparaître aussi les avoirs et les paiements pas encore affectés, et la seule façon de reconstituer la situation à une date antérieure à partir des rapprochements (account.partial.reconcile). La requête porte sur toute l’entreprise (commercial_partner_id) avec des droits élevés ; le contrôle visant à savoir si l’utilisateur a le droit de les voir est effectué au préalable.

Tests

Le module est livré avec treize tests automatiques, qui passent au vert chez nous :

• accès uniquement avec l’option cochée, sinon redirection vers Mon compte,
• la liste contient les postes de toute l’entreprise, mais jamais ceux d’une autre,
• l’option vaut par contact, et non pour tous les utilisateurs de l’entreprise,
• les avoirs figurent dans la liste avec un montant négatif et réduisent le solde,
• date de référence : une facture payée plus tard figure dans la liste avant, mais pas après,
• page avec une date future et avec une date invalide,
• l’adresse du PDF renvoie un fichier PDF,
• rapport en HTML et contrôle d’accès dans le rapport,
• montant ouvert à la date de référence après des paiements partiels avant et après la date de référence,
• comportement de paiement : répartition entre à temps, jusqu’à une semaine de retard et plus tard, avec les valeurs moyennes, y compris pour une date de référence passée,
• comportement de paiement avec des factures ouvertes et l’évaluation bon ou mauvais,
• comportement de paiement sans factures et jamais avec les données d’une autre société,
• comportement de paiement dans la page du portail et dans le PDF.

En outre, nous avons parcouru la page dans le navigateur sur une base de test contenant des clients d’exemple ; les illustrations de cet article en proviennent. Tous les noms, numéros de pièces et montants qui y figurent sont entièrement fictifs.

Installation et configuration

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

Les dépendances sont account et portal. Après l’installation, le service Odoo doit être redémarré, car le module contient du code Python. Si vous exploitez un système de production, installez d’abord le module sur une copie de la base de données. Ensuite :

1. ouvrir le contact qui doit voir la liste (personne disposant d’un accès au portail),
2. dans le formulaire, cocher la case Afficher la liste des postes ouverts dans le portail et enregistrer,
3. se connecter au portail en tant que cet utilisateur, ou vérifier avec le client : vignette, liste, date de référence et PDF.

Avant l’activation, vérifiez les paramètres d’expéditeur et de mise en page de votre entreprise, car le PDF reprend le logo, l’adresse et le pied de page de la mise en page des documents. Le module n’envoie lui-même aucun e-mail et ne génère aucune notification.

Limites et remarques

• Situation actuelle des pièces comptabilisées. La date de référence est calculée sur la base des écritures telles qu’elles figurent actuellement dans le système. Si une facture a été annulée ou remise en brouillon après la date de référence, la liste ne l’affiche pas. Ce n’est pas un instantané inaltérable « tel qu’il avait été imprimé à l’époque ».
• Les paiements comptent à partir du jour du rapprochement. Si un paiement n’est affecté que plusieurs jours après la réception d’une facture, la facture figure dans la liste comme ouverte jusque-là. Pour obtenir des analyses à date de référence fiables, il convient d’affecter les paiements rapidement. Le rapprochement bancaire sur les factures n’est pas inclus dans Odoo Community ; nous utilisons pour cela notre module Bank Statement Matcher.
• Le comportement de paiement vaut ce que vaut votre rapprochement. Ce qui compte, c’est le moment où un paiement a été affecté à une facture. Des paiements restés longtemps non rapprochés donnent d’un client une image plus mauvaise qu’elle ne l’est. Vérifiez l’évaluation chez vos clients avant d’en tirer des conséquences.
• L’évaluation est visible pour le client. Celui qui dispose de l’option voit aussi le résultat et la mention du paiement d’avance. Le module ne modifie en rien les conditions de paiement.
• Uniquement les créances. Le module montre ce que le client vous doit, et non vos dettes envers le client.
• Pas de niveaux de relance ni de lien de paiement dans la liste. Depuis la liste, le client peut ouvrir une facture et la payer là, comme votre portail le permet par ailleurs.
• PDF et exploitation multiprocessus. Pour générer les rapports PDF, Odoo appelle en interne sa propre adresse web. Si votre système ne fonctionne qu’avec un seul processus de travail, cela peut se bloquer. Cela concerne tous les rapports PDF du portail, pas seulement ce module. Après l’installation, testez une fois le bouton PDF en conditions réelles.
• Testé uniquement sur Odoo 19.0 Community. Nous ne l’avons pas vérifié pour d’autres versions.
• Ne remplace ni la relance ni le relevé de compte. La liste ne remplace ni un relevé de compte comptable ni vos processus de relance ; elle ne fait que rendre la situation transparente.

Questions fréquentes

Qu’est-ce qu’une liste des postes ouverts (liste PO) ?

Un état de toutes les factures qui ne sont pas encore payées ou pas intégralement payées, avec la date de facture, l’échéance et le montant ouvert. On l’appelle aussi « factures ouvertes », « compte client » ou « balance des comptes » (« Saldenliste » en allemand), bien que ce dernier terme désigne, au sens strict, les soldes de tous les comptes.

Pourquoi le portail Odoo n’affiche-t-il pas déjà une liste PO en standard ?

Le portail affiche les commandes, les factures et les paiements individuellement, avec statut et filtres. Une liste globale de l’entreprise avec solde et une analyse à date de référence ne font pas partie du périmètre de la Community, pour autant que nous l’ayons constaté. C’est à cela que sert le module.

Tous les utilisateurs du portail d’une entreprise voient-ils la liste ?

Non. Seulement les contacts dont l’option est cochée. La liste affichée porte cependant sur toute l’entreprise, et pas seulement sur les factures de ce seul contact.

Puis-je choisir une date de référence passée, par exemple le 31.12. de l’année précédente ?

Oui, n’importe quelle date jusqu’à aujourd’hui. La liste montre alors les postes qui étaient comptabilisés et pas encore payés ce jour-là. Tenez compte des remarques sur le calcul : ce qui compte est le jour du rapprochement du paiement.

Une date de référence future est-elle prise en charge ?

Non. Les dates futures sont traitées comme aujourd’hui, afin que la liste n’affiche pas une situation qui n’existe pas encore.

Les avoirs et les acomptes figurent-ils dans la liste ?

Oui. Les avoirs et les paiements qui ne sont pas encore affectés à une facture figurent dans la liste avec un montant négatif et réduisent le solde. Une remarque sous le tableau l’explique au client.

Comment les postes échus sont-ils identifiés ?

Un poste est échu si sa date d’échéance précède la date de référence et qu’il reste un reliquat positif. Les jours de retard sont comptés jusqu’à la date de référence.

Le PDF existe-t-il aussi dans d’autres langues ?

Oui, l’interface et le PDF suivent la langue de l’utilisateur. La traduction allemande est fournie ; pour d’autres langues, un fichier .po ou la traduction via l’interface Odoo suffit.

Un client peut-il voir la liste d’une autre entreprise en modifiant l’adresse ?

Non. L’entreprise découle toujours de l’utilisateur connecté. L’adresse ne contient que la date de référence. L’adresse du rapport PDF d’Odoo est elle aussi revérifiée dans le rapport lui-même.

Comment le comportement de paiement est-il calculé ?

À partir des factures clients comptabilisées des douze derniers mois et de toutes les factures ouvertes. Pour chaque facture, on regarde combien de jours après l’échéance elle a été payée : au plus tard à la date d’échéance (vert), jusqu’à sept jours après (orange) ou plus tard (rouge). L’évaluation est bonne si au moins 70 % des factures sont vertes ou orange et qu’aucune facture ouverte n’est échue depuis plus de 30 jours. Les détails figurent dans la section comportement de paiement.

Le module fait-il passer au paiement d’avance les clients dont le comportement de paiement est mauvais ?

Non. Il affiche seulement l’évaluation et la mention. Les conditions de paiement, le paiement d’avance et les blocages restent votre décision et votre processus dans Odoo.

Le module envoie-t-il des e-mails ou des relances ?

Non. Il se contente de fournir la page et le PDF. Il ne génère ni messages, ni notifications, ni activités.

Le module fonctionne-t-il avec Odoo Enterprise ?

Il ne dépend que de account et de portal, qui existent dans les deux éditions. Nous ne l’avons testé que sur l’édition Community d’Odoo 19.

Sous quelle licence le module est-il publié ?

Sous l’AGPL-3. Vous pouvez l’utiliser, le modifier et le redistribuer si vous respectez les conditions de la licence. Les erreurs et suggestions d’amélioration sont les bienvenues sous forme d’issue dans le dépôt GitHub .

Assistance de Biricon IT Services

Nous accompagnons les installations Odoo de petites et moyennes entreprises : de la mise en place aux adaptations et migrations, jusqu’à l’exploitation courante. Si vous souhaitez proposer à vos clients, dans le portail, des postes ouverts, des factures et des tickets, étoffer la comptabilité dans Odoo Community ou déployer un module en toute sécurité dans votre instance de production, nous vous aidons volontiers. Autres développements internes : Archiver une entreprise avec ses utilisateurs du portail, Registre du commerce et vérification d’adresses pour les clients autrichiens, Numéros de pièces composés d’un préfixe, de l’année et d’un compteur et Ensembles de produits dans le devis sous forme de section.

Nous contacter maintenant

Version du 6 novembre 2026. Version du module 19.0.1.1.1. Modifications depuis la première version du 5 novembre : comportement de paiement (19.0.1.1.0) et correction du montant ouvert à la date de référence après des paiements partiels (19.0.1.1.1). Tous les noms, numéros de pièces et montants des illustrations sont fictifs.