Module Dons

Le module Dons d'HtkDoli vous permet de consulter et gérer les dons reçus par votre organisation (associations, fondations, structures à but non lucratif). Chaque don est rattaché à un tiers (donateur), et peut être lié à un adhérent, à un projet et à un compte bancaire.

Interface et Fonctionnalités (Liste)

La vue principale affiche la liste de tous les dons associés au profil actif.

Consultation et Recherche

Barre de recherche : Recherche par référence, libellé ou nom du donateur (tiers).
Tri :
- Date (Récent → Ancien) — défaut
- Date (Ancien → Récent)
- Montant (Décroissant)
- Montant (Croissant)
- Référence
Filtres par statut :
- Tous
- Brouillon
- Impayé
- Payé

⚠️ Le statut Annulé existe et est affiché sur les fiches concernées, mais il n'y a pas de filtre dédié « Annulé » dans la liste.

Regroupement par sections

Quand aucune recherche n'est active :

Tri par date : les dons sont regroupés par mois (ex. « Janvier 2026 »).
Tri par référence : regroupement par première lettre.
Chaque en-tête de section affiche un résumé des statuts (pastilles + compteurs).
Une bulle d'index (lettre/mois) apparaît brièvement pendant le défilement.

Informations affichées (Cartes Don)

Chaque ligne représente un don avec :

Une icône cœur et une pastille de statut (point coloré).
Sa référence.
La date du don.
Le nom du donateur (tiers).
Le montant (formaté en euros).

Pagination

Liste paginée par lots de 50, avec bouton « Charger plus » (uniquement sans filtre/recherche actifs).
Pull-to-refresh disponible (rafraîchissement avec retour haptique).
Bouton de rafraîchissement dans l'en-tête (avec indicateur d'état : à jour, en cours, succès, échec, périmé).

Actions rapides sur une ligne

Glissement (bord gauche) : Modifier.
Glissement (bord droit) : Supprimer.
Appui long (menu contextuel) :
- Voir le reçu fiscal (si don Payé) — ⚠️ limite API : le reçu fiscal d'un don n'est pas générable via l'API REST de Dolibarr ; à générer depuis l'interface web Dolibarr.
- Valider (si don Brouillon) — ⚠️ depuis ce menu : « Bientôt disponible » (la validation réelle se fait depuis la fiche détail).
- Modifier.
- Supprimer.

Création

Un bouton « + » dans la barre du haut permet de créer un nouveau don.

Vue Détail (Consultation d'un don)

En-tête (Hero Section)

Icône cœur.
Référence du don.
Date (ou « Date inconnue »).
Badge de statut.

Informations

Libellé du don.
Montant (formaté en euros).
Mode de paiement : ⚠️ affiché sous forme d'identifiant numérique (« Mode de paiement (ID) »), uniquement s'il est renseigné.
Projet lié (cliquable pour ouvrir sa fiche, si renseigné).

Tiers / Adhérent

La carte n'apparaît que si un nom de donateur est connu :

Adhérent : si un identifiant adhérent est rattaché, carte cliquable « Adhérent » menant à la fiche adhérent.
Tiers : sinon, si un identifiant tiers est rattaché, carte cliquable « Tiers » menant à la fiche tiers.
Si aucun identifiant exploitable localement n'est trouvé, seul le nom est affiché (non cliquable).

Documents

Consultation, aperçu PDF et téléchargement des fichiers joints (reçu fiscal, lettre de remerciement, preuve de virement, etc.).
Ajout d'un document (uniquement pour un don déjà synchronisé sur le serveur).
Les documents sont chargés en arrière-plan à l'ouverture de la fiche.

Notes

Note Publique.
Note Privée (cadenas).

Actions de l'en-tête flottant

Modifier (icône crayon).
Menu (…) :
- Valider : visible uniquement si le don est en Brouillon. Une confirmation indique que le don passera du statut « Brouillon » à « Validé ».
- Supprimer : alerte de confirmation, action irréversible.
Pull-to-refresh : recharge le don et ses documents depuis le serveur.

Création et modification

L'écran d'édition (DonationEditView) permet de renseigner :

Entités

Donateur (Tiers) : obligatoire, choisi dans une liste.
Adhérent : optionnel (effaçable).
Projet : optionnel (effaçable), limité aux projets ouverts.

Informations

Libellé du don (optionnel).
Date du don.
Montant (obligatoire, clavier décimal ; accepte la virgule ou le point).
Mode de paiement : Carte Bancaire, Chèque (défaut), Virement, Prélèvement, Espèces.
Compte bancaire : optionnel (« Aucun » par défaut), limité aux comptes ouverts.

Notes

Note publique.
Note privée.

Statut (édition uniquement)

En modification, un sélecteur de statut est disponible : Brouillon, Validé (Impayé), Payé, Annulé.

⚠️ Champs absents. Il n'y a pas de champ « Référence » saisissable (la référence est générée par Dolibarr ; localement le don affiche « (PROV) » en attendant la synchronisation), ni de champ « Nom » libre pour un donateur anonyme : le donateur passe toujours par la sélection d'un tiers.

⚠️ Édition restreinte aux brouillons. Un don n'est modifiable que s'il est en création ou au statut Brouillon. Dès qu'il est validé, payé ou annulé, les champs deviennent non éditables.

Validation du formulaire

L'enregistrement n'est possible que si un tiers est sélectionné et qu'un montant valide est saisi.

Comportement Métier et Dolibarr

Statuts

Brouillon (0) — gris : Don saisi mais pas encore validé.
Impayé / Validé (1) — orange : Don validé mais paiement non encore encaissé.
Payé (2) — vert : Paiement encaissé.
Annulé (3) — rouge : Don annulé.

Liens avec d'autres modules

Tiers : donateur obligatoire (entreprise ou particulier référencé).
Adhérent : pour les dons rattachés à un membre de l'association.
Projet : permet le fléchage du don sur un projet précis (campagne, opération ciblée…).
Banque : un compte bancaire peut être associé au don.

Reçus fiscaux

Les reçus fiscaux générés côté Dolibarr (justificatifs pour les déductions d'impôts des donateurs ; France : article 200 du CGI) se consultent et se téléchargent via la section Documents de la fiche.

⚠️ L'action « Voir le reçu fiscal » du menu contextuel de la liste n'est pas opérationnelle : le reçu fiscal d'un don n'est pas générable via l'API REST de Dolibarr. Il doit être généré depuis l'interface web Dolibarr, puis se consulte via la section Documents de la fiche.

Synchronisation (mode hors ligne d'abord)

La création et la modification sont d'abord appliquées localement (interface optimiste), puis mises en file d'attente de synchronisation (POST/PUT) et envoyées au serveur en arrière-plan.
Un don créé hors ligne porte une référence provisoire « (PROV) » jusqu'à sa synchronisation.
La liste est paginée ; les noms de tiers manquants sont résolus à la demande lors du rafraîchissement.
Les liens tiers / adhérent / projet sont résolus à l'ouverture de la fiche.
Les documents sont chargés en arrière-plan.
Le don ne peut être validé que s'il possède déjà un identifiant serveur (don synchronisé).

Côté API Dolibarr

Endpoints utilisés : GET /donations, GET /donations/{id}, POST /donations, PUT /donations/{id}, DELETE /donations/{id}, POST /donations/{id}/validate.
À la création/modification, l'application envoie la date via la clé date (et datedon par robustesse) et le tiers via socid (et fk_soc). Le projet est envoyé via fk_project.

Droits et Permissions

Consultation : le droit don.lire est requis pour afficher la liste, consulter les détails et télécharger les documents.
Création / Modification : le droit don.creer est requis pour créer ou modifier des dons.
Suppression : droit de suppression du module Dons.

Si ces permissions ne sont pas accordées, l'accès au module sera restreint.

Captures d'écran

2 captures — cliquez pour agrandir