# TicketStock

Créer un ticket lors de l'entrée de produits dans un stock défini. Le ticket est assigné à un utilisateur et un groupe. Les membres du groupe sont contacts du ticket. Tous les utilisateurs contact du ticket reçoivent un mail d'alerte.

# 1- Le module TicketStock

Tout ce qu'il faut pour installer et paramétrer votre module.

# 1.1- Présentation

TicketStock permet d'avertir automatiquement une équipe SAV ou Maintenance lors de retour de produits dans un entrepôt défini dans la configuration et de créer un ticket, ce qui va envoyer un mail à tous les contacts du ticket : utilisateur assigné et membres du groupe qui sont contacts du ticket.

Le module fonctionne avec n'importe quel type de retour : de vente ou de location.

#### **1.1.1- Fonctionnalités** 

Ticketstock se base sur les mouvements de stock entrant pour déclencher les actions suivantes :

- Lors de l'entrée en stock dans un des entrepôts à surveiller défini dans la configuration du module, un ticket est créé lors du mouvement de stock.
- Les membres du groupe défini dans la configuration sont ajoutés comme contacts du ticket
- L'utilisateur défini dans la configuration du module est assigné au ticket
- Les paramètres du ticket définis dans la configuration du module sont appliqués au ticket et repris dans le mail d'alerte
- Les contacts du ticket et l'utilisateur assigné reçoivent un mail informant de la création du ticket, avec les informations définies dans la configuration (type de ticket, sévérité, groupe, objet et contenu).

#### **1.1.2- Compatibilité et conformité du module** 

Le module Ticketstock ne remet pas en cause la conformité de Dolibarr à la loi de finances 2025 pour la lutte contre la fraude à la TVA.

Il est compatible avec [DoliRent](https://doc.altairis.fr/books/dolirent-gestion-de-location-de-materiel-pour-dolibarr "Voir la documentation de DoliRent"), la suite de module de gestion des locations et le module multi-company.

#### **1.1.3- Cible**

Le module s'adresse à tous les utilisateurs de Dolibarr. Son utilisation ne nécessite aucune connaissance technique ou d'administration hormis un paramétrage correct des emails sortants.

#### **1.1.4- Licence** 

Tous nos modules sont distribués sur [notre boutique en ligne](https://www.altairis.fr/boutique/) et sur le [Dolistore](https://www.dolistore.com/fr/recherche?search_query=altairis) sous [licence GPL v3.](https://www.gnu.org/licenses/gpl-3.0.html)

#### **1.1.5- Ressources**

##### 1.1.5.1- La présente documentation

Nos guides utilisateurs sont là pour vous accompagner sérieusement dans l'utilisation de nos modules. Certains contiennent de nombreuses pages, mais leur lecture est essentielle pour la bonne compréhension des fonctionnalités des modules.

##### 1.1.5.2- Notre site de démonstration

Le module est installé sur notre [environnement de démonstration](http://demo.altairis.fr/). Connectez-vous avec l'identifiant demo et le mot de passe demo.

<p class="callout warning">Attention : le site de démo n'envoie aucun email, vous ne pourrez pas tester cette partie là.</p>

##### 1.1.5.3- Forum

Consultez toutes les informations sur le module dans les discussions des forums Français<span style="color: #c9211e;"><span style="color: rgb(0, 0, 0);">.</span>  
</span>

Nous créons pour chacun de nos modules une discussion sur le <span style="background-color: rgb(230, 126, 35);">forum dolibarr</span>. Ces discussions contiennent de nombreuses informations. Aussi, si vous avez des commentaires et suggestions, pour une réponse plus rapide, il est préférable de continuer sur cette même conversation.

<p class="callout info">**<span style="color: rgb(24, 139, 175);">Note</span>** : Le forum est un lieu d'échange autour de l'utilisation et des fonctionnalités de nos modules. En cas de diﬀicultés d'utilisation ou pour toute remontée de bogue, vous pouvez [créer un ticket sur notre interface de support](https://support.altairis.fr). Par ailleurs, nous vous remercions de ne pas multiplier les canaux d'échange pour un même objet sur le forum.</p>

# 1.2- Avant de commencer

#### **1.2.1- Avertissement**

Nous assurons le bon fonctionnement de nos modules sur les environnements natifs de Dolibarr. Nous ne pouvons pas en garantir le bon fonctionnement suite à des modifications eﬀectuées sur les fichiers du noyau de Dolibarr ou en cas d'utilisation d'autres modules additionnels.

Cette documentation s'appuie sur le module en version 2025.12.1 avec Dolibarr version 21. En cas d'utilisation d'autres versions ou selon le thème utilisé, vous pourrez constater des diﬀérences de fonctionnement ou d'aﬀichage.

#### **1.2.2- Pré-requis techniques**

##### **Version min. de Dolibarr**

Le module TicketStock<span style="color: #000000;"><span style="font-family: Linux Biolinum O;"><span style="font-size: medium;"><span style="letter-spacing: -0.3pt;"> </span></span></span></span>est compatible avec Dolibarr à partir de version 21.

##### **Dépendances**

Le module Ticketstock nécessite l'utilisation de paramétrages corrects sur les modules suivants :

- Module Tickets de Dolibarr correctement configuré
- Gestion des stocks produits (natif) correctement configuré
- Gestion des Entrepôts (natif)
- Groupes d'utilisateurs (natif)
- Gestion des mails sortants de Dolibarr (natif) correctement configuré

Les modules suivants ne sont pas obligatoires. Ils fonctionneront avec TicketStock :

- Réception fournisseur (natif)
- Retour de produits (module Altairis)

#### **1.2.3- Mises à jour**

Les dernières versions de nos modules sont mises à disposition sur le [Dolistore](https://www.dolistore.com/fr/recherche?search_query=altairis) et sur notre [site internet](https://www.altairis.fr/boutique/).

 L'accès aux mises à jour de nos modules est gratuit pendant 1 an à compter de leur date d'achat.

Avant toute mise à jour, assurez-vous que le module est oﬀiciellement compatible avec la version de Dolibarr sur laquelle vous souhaitez l'installer.

Pour mettre à jour un module, téléchargez-le à nouveau sur le [Dolistore](https://www.dolistore.com/fr/recherche?search_query=altairis) ou sur [notre boutique en ligne](https://www.altairis.fr/boutique/) avec l'identifiant utilisé lors de l'achat initial. Nous rendons systématiquement disponibles en téléchargement les dernières versions de nos modules.

Dézippez les fichiers de la dernière version du module dans le répertoire custom de votre environnement et confirmez le remplacement de ceux déjà présents, ou bien utilisez la fonctionnalité de déploiement d'un module externe dans la configuration.

<p class="callout info">**Note :** Pour le bon déroulement d'une mise à jour, désactivez le module avant de lancer le remplacement de ses fichiers puis réactivez le. À l'issue de la mise à jour, il est conseillé de répéter l'opération de désactivation/activation pour être sûr du bon déroulement d'une éventuelle mise à jour de votre base de données. Vérifiez enfin si de nouveaux paramétrages sont nécessaires.</p>

# 1.3- Mise en route et paramétrage

#### **1.3.1- Procédure d'installation**

Si vous avez accès aux fichiers de votre Dolibarr, dézipper l'archive du module dans le dossier custom de son arborescence.

Sur les versions récentes de Dolibarr, le module zippé peut être installé directement depuis la page :

**A**ccueil &gt; **C**onfiguration &gt; **M**odules/**A**pplications, onglet **D**éployer/Installer un module externe.

#### **1.3.2- Activation** 

Activez le module en aﬀichant la liste des modules depuis les menus :

**A**ccueil &gt; **C**onfiguration &gt; **M**odules/**A**pplications, onglet **M**odules/**A**pplications installés. Il sera aﬀiché dans le tableau Altairis.

![activation-module.png](https://doc.altairis.fr/uploads/images/gallery/2025-12/TGOCQqbKPb92f79G-activation-module.png)

1. Activez le module en cliquant sur la pastille blanche pour quelle devienne verte ;
2. Pour désactiver le module cliquer de nouveau sur la pastille pour quelle devienne blanche.

#### **1.3.3- Permissions**

Il n'y a pas de permissions spécifiques pour ce module.

#### **1.3.4- Paramétrage du module**

La page de configuration du module est accessible depuis la liste des modules installés (**A**ccueil &gt; **C**onfiguration &gt; **M**odules/**A**pplications) en cliquant sur son icône [![image.png](https://doc.altairis.fr/uploads/images/gallery/2024-03/scaled-1680-/5LZimage.png)](https://doc.altairis.fr/uploads/images/gallery/2024-03/5LZimage.png).

Les paramétrages du module se déroulent en deux temps : paramétrage module et paramétrage du ticket.

Il est bien entendu très fortement conseillé de prendre le temps de faire des tests correspondant à votre situation en balayant tous les cas de figure, avant la mise en production.

##### **Section Paramètre**

Entrepôts à surveiller : liste déroulante à choix multiple. Choisissez le ou les entrepôts qui seront concernés par la surveillance des entrées en stock.

Utilisateur assigné au ticket : Il ne peut y en avoir qu'un ! Choisissez l'utilisateur de votre Dolibarr qui sera assigné au ticket et qui sera prévenu par mail lors de la création du ticket.

Groupe d'utilisateurs prévenus par email : choisissez le groupe qui sera automatiquement mis comme contact du ticket et dont les utilisateurs seront prévenus par mail lors de la création du ticket.

##### **Section Paramétrage du ticket**

Sélectionnez les valeurs par défaut qui seront définies sur le ticket créé :

- Type de ticket\*
- Sévérité du ticket\*
- Groupe du ticket\*
- Objet du ticket
- Contenu du ticket

Le entrées marquées d'une astérisque sont définies dans les dictionnaires relatifs aux ticket : **A**ccueil &gt; **C**onfiguration &gt; **D**ictionnaires.

Enregistrez votre configuration, votre module est prêt.

[![parametrage-module-ticketstock.png](https://doc.altairis.fr/uploads/images/gallery/2025-12/KUL4VRW9THvF1DRv-parametrage-module-ticketstock.png)](https://doc.altairis.fr/uploads/images/gallery/2025-12/KUL4VRW9THvF1DRv-parametrage-module-ticketstock.png)

#### **1.3.5- Paramétrage des e-mails sortants**

Vous devez avoir un paramétrage correct de vos mails sortants : **A**ccueil &gt; **C**onfiguration &gt; **E**mails &gt; **O**nglet "E-mails sortants" de manière à ce que Dolibarr soit en capacité d'envoyer les mails à la création du ticket.

Vos utilisateurs devront bien entendu aussi avoir un email de renseigné sur leur profil.

<p class="callout danger">L'option permettant d'envoyer tous les mails sortants de Dolibarr à une adresse spécifique (au lieu des vrais destinataires, à des fins de test) N'EST PAS COMPATIBLE avec le bon fonctionnement de l'envoi des mails dans le cadre des tickets.</p>

# Utilisation de TicketStock

Utilisation de TicketStock au quotidien

# Les opérations qui déclenchent la création du ticket

Un ticket va être créé lors d'un mouvement de stock entrant de matériel dans l'un des entrepôts "surveillé" dans la configuration du module.

L'action est automatique et ne nécessite aucune opération manuelle.

Au moment où l'on valide l'une des opérations suivantes, qui déclenchent le mouvement de stock entrant dans l'entrepôt :

- un transfert de stock dans un entrepôt surveillé
- ou un retour de produit dans un entrepôt surveillé via le module des retours
- ou encore une réception fournisseur dans un des entrepôts surveillé

un ticket est créé, l'utilisateur assigné, les membres du groupe ajoutés comme contact du ticket et un mail envoyé à chacun des contacts notifiant la création du ticket.

Le ticket est au statut "Assigné".

# 4- Pour finir

# 4.1- Question fréquentes / Informations pratiques

#### <span style="color: rgb(0, 0, 0);">**4.1.1- Question fréquentes**</span>

##### 4.1.1.1- Bonnes pratiques 

Ce chapitre répertorie les diﬀicultés rencontrées avec le module. Vous y trouverez donc des éléments de réponse quant à son utilisation.

Si vous rencontrez une autre erreur que celles décrites ci-dessous lors de l'utilisation de ce module :

1. 1. 1. désactivez et réactivez le module
        2. vérifiez sur le ChangeLog si une nouvelle version a été publiée et sa compatibilité avec votre version de Dolibarr
        3. ré-installez/mettez à jour le module
        4. vérifiez qu'aucune incompatibilité avec un autre module ne soit indiquée ; le cas échéant, suivez nos préconisations

Si, malgré ces manipulations, l'erreur persiste, contactez-nous en utilisant [<span lang="en-US">notre interface de support.</span>](https://support.altairis.fr/)

 Pour plus d’eﬀicacité dans l’étude de votre demande, précisez :

- - - le nom et la version du module
        - la version de Dolibarr
        - la liste des modules additionnels activés
        - tous les éléments nécessaires à la meilleure des prise en charge de votre demande, comme le contexte, les étapes successives pour reproduire l'erreur, captures d'écran, message d'erreur, etc.

##### 4.1.1.2- Autres diﬀicultés

La principale difficulté provient en général d'une mauvaise configuration des emails sortants de Dolibarr sur votre instance.

- - - N'activez pas les options de test sur la configuration des emails
        - vérifiez bien que vous avez correctement configuré votre zone DNS pour les entrées SPF, DMARC, DKIM afin que les mails sortant de dolibarr soient correctement relayés par votre fournisseur de mail de manière légitime.

#### **4.1.2- Informations pratiques** 

##### 4.1.2.1- Liens directs

Pour accéder rapidement aux diverses ressources relatives au module, nous en avons listé les liens ci-dessous :

- - - Produits associés sur [notre site](https://www.altairis.fr/boutique/)
        - Le forum français

##### 4.1.2.2- Support

Nous assurons la maintenance corrective sur nos modules pendant un an à partir de leur date d'achat. Une interface de [support ](https://support.altairis.fr/)est à votre disposition pour signaler un bug rencontré.

Pour toute demande d'aide à l'utilisation, veuillez souscrire à l'un de [nos forfaits de support](https://www.altairis.fr/assistance/).

##### 4.1.2.3- Crédit et historique des modifications

<span style="color: rgb(0, 0, 0);">Pour la présente documentation du module Produits associés pour Dolibarr : </span>

<span style="color: rgb(0, 0, 0);">Licence : [GFDL](https://www.gnu.org/licenses/fdl-1.3.html "Gnu Free Documentation License")</span>

<table border="1" id="bkmrk-version-auteurs-comm" style="border-collapse: collapse; width: 95.4762%; margin-left: 40px; height: 156.6px;"><colgroup><col style="width: 16.3542%;"></col><col style="width: 23.7199%;"></col><col style="width: 14.8797%;"></col><col style="width: 45.169%;"></col></colgroup><tbody style="padding-left: 40px;"><tr style="padding-left: 40px; height: 29.8px;"><td style="padding-left: 40px; height: 29.8px;"><span style="color: rgb(0, 0, 0);">**Version**</span>  
</td><td style="padding-left: 40px; height: 29.8px;"><span style="color: rgb(0, 0, 0);">**Auteurs**</span>  
</td><td style="padding-left: 40px; height: 29.8px;"><span style="color: rgb(0, 0, 0);">**Date**</span>  
</td><td style="padding-left: 40px; height: 29.8px;"><span style="color: rgb(0, 0, 0);">**Objet**</span></td></tr><tr style="padding-left: 40px; height: 46.6px;"><td style="padding-left: 40px; height: 46.6px;">1</td><td style="padding-left: 40px; height: 46.6px;">Agnès Rambaud

</td><td style="padding-left: 40px; height: 46.6px;">12/2025</td><td style="padding-left: 40px; height: 46.6px;">Première version de la documentation du module de ticketstock</td></tr></tbody></table>

<span style="color: rgb(0, 0, 0);">  
</span>