Porte-monnaie TakePOS

Le module donne un solde prépayé à chaque tiers. Il ne tient pas de comptabilité à part : il s’appuie sur le crédit disponible de Dolibarr, celui que le cœur utilise déjà pour les acomptes et les avoirs.

La recharge

Elle se fait depuis l’onglet « Porte-monnaie » de la fiche tiers ou de la fiche adhérent : montant, mode de règlement, compte bancaire, note. Le module enchaîne alors, dans une seule transaction :

1. une facture d’acompte d’une ligne, à 0 % de TVA, validée ;
2. le paiement de cette facture, versé en banque si le module Banques et caisses est actif ;
3. le classement de la facture en payée ;
4. sa conversion en crédit disponible du client.

Si une étape échoue, rien n’est enregistré en base. Le même onglet affiche le solde disponible et l’historique des recharges et des achats.

Sur la fiche adhérent, l’onglet affiche le porte-monnaie du tiers lié à l’adhérent. Un adhérent qui n’est lié à aucun tiers n’a pas de porte-monnaie : l’onglet le dit.

En caisse

Sur l’écran de paiement de TakePOS, un bouton « Porte-monnaie (solde) » apparaît quand le client du ticket a un solde et que le ticket n’est pas réglé.

• Le navigateur n’envoie aucun montant. Le serveur applique au plus le reste à payer, et au plus le solde.
• Les crédits les plus anciens sont utilisés d’abord. Un crédit plus grand que le besoin est découpé en deux : la part utilisée, et le reste, qui reste disponible.
• Si le solde couvre le ticket, celui-ci est validé et payé sans autre paiement.
• Sinon, l’écran affiche le reste à payer, à régler en espèces, par carte ou par chèque.
• Le lien « Annuler » rend le solde.

Le crédit est appliqué comme un paiement, pas comme une remise : le ticket garde ses lignes et sa TVA, sans ligne négative.

Seuls les crédits issus d’une recharge sont utilisés. Les avoirs et acomptes ordinaires du client ne sont jamais touchés.

Le solde est protégé

Si un ticket brouillon auquel le porte-monnaie a été appliqué est modifié — ligne ajoutée, modifiée ou supprimée —, supprimé, ou change de client, le montant appliqué est rendu au porte-monnaie. Il suffit de cliquer à nouveau sur le bouton.

Cette précaution comble un manque du cœur : quand on supprime une facture, Dolibarr ne libère pas les crédits qui lui ont été appliqués comme paiement.

Selon la version de Dolibarr

De la 19 à la 22, l’écran de paiement de TakePOS n’affiche pas les boutons ajoutés par les modules. Sur ces versions, le module affiche lui-même son bouton.

La TVA

Une recharge est enregistrée à 0 % de TVA : la TVA est due au moment de l’achat, sur le ticket. C’est le traitement d’un bon à usages multiples, valable si vos produits ont des taux de TVA différents.

Si tous vos produits ont le même taux — par exemple uniquement de l’alimentaire à 5,5 % —, le solde est un bon à usage unique : la TVA est due dès la recharge, et la version 1.0.0 ne gère pas ce cas (BOI-TVA-CHAMP-10-10-40-50). Sans objet si votre structure n’est pas assujettie à la TVA. En cas de doute, demandez à votre comptable.

Sur l’écran de paiement de TakePOS, pour un ticket de 107,60 € TTC, le bouton « Porte-monnaie (51,60 €) » apparaît sous le pavé numérique, à côté des modes de paiement Espèce, Chèque et Carte bancaire.

Après un clic, le solde ne couvre pas tout le ticket : 51,60 € sont appliqués, et l’écran affiche « Reste à payer: 56,00 € », à régler par un autre moyen. Le bouton a disparu, le solde étant épuisé. Sous les boutons, la ligne « Porte-monnaie appliqué : 51,60 € » porte le lien « Annuler ».

L’onglet « Porte-monnaie » de la fiche d’une adhérente, sous Dolibarr 24.0.1 : solde disponible de 51,60 €, tiers lié, formulaire de recharge (montant, mode de règlement, compte bancaire, note), puis l’historique — deux recharges de 50,00 € et 20,00 €, deux achats de 12,00 € et 6,40 €. Chaque ligne renvoie à sa facture.

La page de configuration du module est réservée aux administrateurs. Elle commence par le rappel du traitement de la TVA.

• Trois droits dédiés, non accordés par défaut : « Voir les soldes de porte-monnaie » ouvre l’onglet, « Recharger un porte-monnaie » affiche le formulaire de recharge, « Payer avec le porte-monnaie en caisse » affiche le bouton dans TakePOS.
• Le droit de Dolibarr en plus : pour payer en caisse, l’utilisateur doit aussi avoir le droit de créer des factures.
• L’onglet respecte les droits sur les tiers : il s’ouvre seulement sur un tiers auquel l’utilisateur a accès.
• Le montant est calculé par le serveur. Le navigateur demande seulement d’appliquer ou d’annuler ; le serveur applique au plus le reste à payer et au plus le solde.
• Requêtes protégées : l’application et l’annulation n’acceptent que des requêtes POST avec le jeton anti-CSRF de Dolibarr. Elles sont refusées sur un avoir, une facture d’acompte ou une facture déjà payée.
• Transactions : une recharge ou une application du solde qui échoue en cours de route est annulée en entier.
• Libération automatique du solde quand un ticket brouillon change ou disparaît.

• Le dossier du module, dolixportemonnaie, à déposer dans htdocs/custom/ ou à installer depuis le zip.
• Trois langues : français (fr_FR), anglais (en_US) et allemand (de_DE).
• Pas de README ni de ChangeLog dans le dossier du module.
• Licence GPL v3 ou ultérieure, code source complet et lisible.

• Une table est ajoutée : llx_dolixpm_recharge. Elle garde une ligne par recharge : tiers, facture d’acompte, montant, date, utilisateur, note, entité. Le solde n’y est pas stocké : c’est la somme des crédits disponibles de Dolibarr issus de ces factures d’acompte.
• Ce qui est écrit à chaque recharge, par les classes du cœur : une facture d’acompte, son paiement, l’écriture bancaire si le module Banques et caisses est actif, et un crédit disponible du client. À la validation, Dolibarr génère le PDF de la facture d’acompte, comme pour toute facture.
• Ce qui est écrit en caisse : le crédit utilisé est lié au ticket, comme un paiement. Le module n’ajoute aucune ligne au ticket.
• Aucun fichier de Dolibarr n’est modifié. Aucune connexion sortante.
• À la désactivation, l’onglet et le bouton de caisse disparaissent. Les factures d’acompte, les paiements et les crédits restent : ce sont des données de votre base, et les soldes non consommés restent des crédits disponibles du client dans Dolibarr. La table llx_dolixpm_recharge et les réglages du module ne sont pas supprimés.