
Accusé de réception de commande (ARC)
Documentation du module · version 23.0.0 · éditeur NSINFO
Sommaire
1. Présentation
Le module Accusé de réception de commande ajoute aux commandes clients un modèle d’impression PDF nommé « ARC ». Ce document confirme à votre client que sa commande a bien été reçue et enregistrée, avec le détail des articles, des prix et des conditions de règlement.
- Un modèle PDF dédié, titré « ARC » suivi de la référence de la commande.
- Un texte de bas de page propre à l’ARC, saisi en français et en anglais : le texte imprimé suit la langue du document.
- Un champ Commentaire ARC sur la commande et un champ Délai ARC sur les lignes de commande, créés à l’activation du module.
- Les couleurs du module DPersoPlus sont appliquées à l’ARC lorsque ce module est installé.
- Le module ne modifie pas le cœur de Dolibarr.
Document pris en charge
| Document | Modèle ajouté |
|---|---|
| Commandes clients | ARC (« Modèle accusé de réception de commande (ARC) ») |
2. Prérequis et installation
2.1 Prérequis
| Élément | Version |
|---|---|
| Dolibarr | 19.0.0 ou supérieur (testé sur 23.0) |
| PHP | 7.4 à 8.3 (testé en 7.4 et 8.3) |
| Framework NSINFO (module « NSINFO », gratuit) | Installé et activé |
| Module Commandes | Activé |
| Module DPersoPlus | Facultatif (couleurs du document) |
Le framework NSINFO est obligatoire. Si le module « NSINFO » n’est pas installé et activé, l’activation du module est refusée avec le message :
« Le framework NSINFO est obligatoire : le module « NSINFO » (nsinfo) doit être installé et activé avant d’activer le module « Accusé de réception de commande ». »
Voir le framework NSINFO.
2.2 Installation
- Installer et activer le module NSINFO.
- Depuis Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe, envoyer module_arccommande-X.Y.Z.zip (voir installer un module).
- Dans la liste des modules, famille NSINFO, activer « Accusé de réception de commande ».
- Activer le modèle ARC dans la configuration du module Commandes.
- Renseigner si besoin le texte de bas de page (roue crantée du module).
À l’activation, le module crée :
- le champ complémentaire Commentaire ARC (texte enrichi) sur les commandes clients ;
- le champ complémentaire Délai ARC (date) sur les lignes de commande ;
- le réglage du préfixe, avec la valeur « ARC » par défaut.
2.3 Activer le modèle ARC
- Ouvrir Accueil > Configuration > Modules/Applications, roue crantée du module Commandes (ou le lien « Ouvrir la page de configuration du module Commandes » de la page de réglages du module ARC).
- Dans le tableau des modèles de documents, activer le modèle ARC (« Modèle accusé de réception de commande (ARC) »).
- Facultatif : le définir comme modèle par défaut si toutes vos commandes doivent être imprimées en ARC.
2.4 Mise à jour / réactivation
Après une mise à jour du module, désactiver puis réactiver le module. Les réglages, les champs complémentaires et leurs valeurs saisies sur les commandes sont conservés.
3. Configuration
Page de réglages : Configuration > Modules, roue crantée du module (onglets Réglages, ChangeLog et À propos fournis par le framework NSINFO). Réservée aux administrateurs. Voir aussi activation et paramètres d’un module.
3.1 Lien vers les réglages des commandes
Le lien « Ouvrir la page de configuration du module Commandes » mène directement à la page où l’on active le modèle ARC (voir 2.3).
3.2 Texte de bas de page
| Option | Description |
|---|---|
| Texte affiché en bas de page de l’ARC – Français | Texte imprimé sur les ARC générés en français. Saisie en texte enrichi (gras, retours à la ligne…). |
| Texte affiché en bas de page de l’ARC – Anglais | Texte imprimé sur les ARC générés dans une autre langue que le français. |
- Le texte est imprimé sur la dernière page, sous les conditions de règlement et les totaux. La place nécessaire est réservée automatiquement : le tableau des lignes est raccourci d’autant.
- Champ vide : aucun texte n’est imprimé.
- Exemples : « Merci de vérifier cet accusé de réception et de nous signaler toute erreur sous 48 heures », délais indicatifs, conditions de livraison.
4. Droits d’accès
Le module n’ajoute aucune permission. La génération d’un ARC suit les droits Dolibarr des commandes clients (consulter et générer les documents des commandes). La page de réglages est réservée aux administrateurs.
5. Utilisation
5.1 Générer un ARC
- Ouvrir une commande client.
- Dans le bloc Documents en bas de la fiche, choisir le modèle ARC et la langue.
- Cliquer sur Générer : le PDF apparaît dans la liste des documents de la commande ; il peut être téléchargé ou joint à un e-mail envoyé au client.
5.2 Commentaire ARC sur la commande
La fiche de la commande affiche le champ Commentaire ARC, et chaque ligne de commande le champ Délai ARC. Ces champs se modifient comme les autres champs complémentaires de Dolibarr.
Pour que le Commentaire ARC soit imprimé, il doit être déclaré imprimable : Configuration du module Commandes > Attributs supplémentaires (commandes), modifier « Commentaire ARC » et choisir une valeur d’impression sur les documents PDF. Il est alors imprimé dans la zone de note, sous l’en-tête.
6. Contenu du document PDF
L’ARC reprend la mise en page des commandes de Dolibarr :
- En-tête : logo de la société, titre « ARC » et référence de la commande, référence client, date de commande, code client, objets liés (proposition commerciale…).
- Adresses : émetteur et destinataire.
- Note publique de la commande, suivie des champs complémentaires imprimables.
- Lignes : désignation, TVA, prix unitaire HT, quantité, unité (si les unités sont utilisées), remise, total HT ; photos des produits si l’option Dolibarr correspondante est activée.
- Conditions : conditions et mode de règlement, coordonnées bancaires, délai de livraison.
- Totaux : total HT, TVA par taux, total TTC.
- Texte de bas de page de l’ARC (3.2), puis pied de page de la société.
Avec le module DPersoPlus, les couleurs réglées dans DPersoPlus (textes fixes, titres du tableau, cadres, zone des totaux, séparateurs entre les lignes) sont appliquées à l’ARC.
7. Limites connues et FAQ
Le modèle ARC n’apparaît pas dans la liste des modèles de la commande.
Il doit être activé dans la configuration du module Commandes (2.3).
Le texte de bas de page ne s’imprime pas.
- Vérifier que le texte est renseigné pour la langue du document : le texte « Français » pour un document en français, le texte « Anglais » pour toutes les autres langues.
- Régénérer le PDF après la modification du réglage.
Comment changer le titre « ARC » du document ?
Par Accueil > Configuration > Traduction, en surchargeant la clé PdfARCTitle (par exemple « Accusé de réception de commande »). En anglais, le titre par défaut est « Acknowledgment of Order ».
Le PDF ARC remplace le PDF de la commande.
Comme tous les modèles de commande de Dolibarr, l’ARC est enregistré sous la référence de la commande : générer l’ARC remplace le PDF généré auparavant avec un autre modèle pour cette commande (et inversement).
Autres limites
- Le Délai ARC des lignes de commande n’est pas imprimé sur l’ARC.
- Les réglages « Libellé du champ commentaire affiché dans la commande » et « Préfixe des documents imprimés » sont présents dans la page de réglages mais sans effet sur le document dans cette version.
- Si le module « NSINFO » est désactivé après coup, la page de réglages du module n’est plus accessible.