Ajout bouton ADV – Signaler à l’ADV les commandes à facturer

1. Présentation

Ajout bouton ADV ajoute sur les commandes un bouton qui prévient l’administration des ventes (ADV) qu’une commande est prête à être facturée : plus besoin d’un courriel ou d’un message oral, la demande est enregistrée dans l’agenda de Dolibarr, sur la commande et chez le tiers.

• Sur une commande client livrée, le bouton INFORMER ADV crée un événement « à faire » affecté à l’utilisateur ADV des commandes client.
• Sur une commande fournisseur reçue (partiellement ou complètement), le même bouton crée un événement affecté à l’utilisateur ADV des commandes fournisseur.
• Le bouton disparaît une fois la demande faite ; sur une commande fournisseur, il revient après une nouvelle réception.
• En option, l’utilisateur ADV dispose d’un bouton Clôture ADV pour terminer l’événement une fois la commande facturée.

Le module ne modifie aucun fichier du cœur de Dolibarr.

2. Prérequis et installation

2.1 Prérequis

• Dolibarr 19 à 24 (testé sur 23.0), PHP 7.4 à 8.3 (testé en 8.3).
• Framework NSINFO (module « NSINFO », gratuit) installé et activé, version 23.1.1 ou supérieure.
• Modules Commandes et/ou Commandes fournisseurs, et module Agenda (les demandes sont des événements d’agenda).

2.2 Installation

1. Installer et activer le framework NSINFO.
2. Menu Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe : envoyer l’archive module_addbtnadv-X.Y.Z.zip.
3. Activer le module Ajout bouton ADV dans la liste des modules (famille NSINFO).
4. Ouvrir les réglages du module (icône de configuration) et choisir les utilisateurs ADV.

Si le framework NSINFO n’est pas actif, l’activation du module est refusée avec le message « Le framework NSINFO est obligatoire… ».

2.3 Mise à jour / réactivation

Après une mise à jour du module, désactiver puis réactiver le module pour que Dolibarr prenne en compte le logo, la liste des fiches concernées et la dépendance au framework. Les réglages sont conservés.

3. Configuration

Les réglages se trouvent dans Accueil > Configuration > Modules/Applications, icône de configuration du module, onglet Réglages. Les onglets ChangeLog et À propos donnent l’historique des versions et les informations du module.

3.1 Paramètres généraux

Réglage	Rôle	Valeur par défaut
Utilisateur ADV pour la facturation des commandes client	Utilisateur à qui sont affectées les demandes faites depuis les commandes client.	aucun
Libellé de l’événement demandant la facturation client	Libellé de l’événement créé depuis une commande client.	Facturation
Utilisateur ADV pour la facturation des commandes fournisseur	Utilisateur à qui sont affectées les demandes faites depuis les commandes fournisseur.	aucun
Libellé de l’événement … (commande reçue partiellement)	Libellé de l’événement créé depuis une commande fournisseur reçue partiellement.	Facturation Reçu partiellement
Libellé de l’événement … (commande reçue complètement)	Libellé de l’événement créé depuis une commande fournisseur entièrement reçue.	Facturation Reçu totalement
Ajouter le bouton de clôture de l’événement pour l’utilisateur ADV	Affiche le bouton Clôture ADV (voir 5.4).	désactivé

Le libellé de l’événement sert aussi à retrouver une demande déjà faite : si vous le modifiez, le bouton réapparaît sur les commandes déjà signalées avec l’ancien libellé.

3.2 Options des boutons

Réglage	Rôle	Valeur par défaut
Libellé du bouton	Texte du bouton de demande.	INFORMER ADV
Mise en forme des boutons	Active la couleur personnalisée des boutons du module.	désactivé
Couleur du bouton	Couleur de fond des boutons, utilisée seulement si la mise en forme est active.	noir

4. Droits d’accès

• Le module ne déclare pas de droit propre : tout utilisateur qui peut consulter la commande voit le bouton de demande.
• Le bouton Clôture ADV n’est affiché qu’à l’utilisateur ADV choisi dans les réglages.
• Les réglages du module sont réservés aux administrateurs.

5. Utilisation

5.1 Commandes client

Le bouton INFORMER ADV apparaît dans la barre des boutons d’une commande client à l’état Livrée, tant qu’aucune demande n’a été faite pour cette commande.

1. Livrer la commande (état « Livrée »).
2. Cliquer sur INFORMER ADV : l’événement est créé et la fiche de la commande se réaffiche.
3. Le bouton disparaît : la demande est visible dans l’onglet Événements de la commande.

5.2 Commandes fournisseur

Le bouton apparaît sur une commande fournisseur reçue partiellement ou dont tous les produits sont reçus. Le libellé de l’événement dépend de cet état.

• Une fois la demande faite, le bouton disparaît.
• Si une nouvelle réception est enregistrée après la demande, le bouton réapparaît pour signaler les produits reçus depuis.

5.3 L’événement créé

Élément	Valeur
Type	Autre
Libellé	Libellé réglé pour le cas (client, fournisseur partiel, fournisseur complet)
Date	Date et heure du clic
État	À faire (0 %)
Propriétaire	Utilisateur qui a cliqué
Participants	Utilisateur qui a cliqué et utilisateur ADV du cas
Liens	Commande et tiers de la commande

L’utilisateur ADV retrouve ainsi les commandes à facturer dans son agenda et dans la liste des événements à faire.

5.4 Clôture par l’ADV

Si l’option de clôture est activée, le bouton Clôture ADV s’affiche sur la commande quand :

• la commande est classée facturée ;
• l’utilisateur connecté est l’utilisateur ADV du cas (client ou fournisseur) ;
• une demande existe et n’est pas encore terminée.

Un clic passe l’événement à 100 % avec la date et l’heure du clic comme date de fin.

6. Limites connues et FAQ

Le bouton n’apparaît pas.

• Commande client : vérifier qu’elle est à l’état « Livrée ».
• Commande fournisseur : vérifier qu’elle est reçue (partiellement ou complètement).
• Une demande avec le même libellé existe peut-être déjà : consulter l’onglet Événements de la commande.
• Après une mise à jour, désactiver puis réactiver le module.

Le bouton « Clôture ADV » n’apparaît pas.

• Vérifier que l’option de clôture est activée et que la commande est classée facturée.
• Seul l’utilisateur ADV choisi dans les réglages voit ce bouton.

Autres limites

• Aucun courriel n’est envoyé : la demande est un événement d’agenda.
• Si aucun utilisateur ADV n’est choisi, l’événement est seulement affecté à l’utilisateur qui a cliqué.
• Les libellés d’événement par défaut sont en français ; modifiez-les dans les réglages si besoin.
• Si le module « NSINFO » est désactivé après coup, la page de réglages du module n’est plus utilisable.

Une question ? Assistance NSINFO au 03 70 999 730 ou sur la page Assistance.