Equipement

De Documentations Patas-monkey
Sauter à la navigation Sauter à la recherche
Equipement 250x250.png Le module Équipement créé, dans Dolibarr, la fonctionnalité de sérialisation de produits, à l’unité, en quantité ou en lot, et permet le suivi du cycle de vie des produits en leur associant des évènements (garantie, location, expédition…) et en gérant des états (en vente, en réparation…), le tout, de façon unitaire ou en masse.

Présentation

Le module Equipement gère 3 notions qui interragissent entre elles :

Les Equipement C'est principalement un produit qui a un numéro de série unique (paramétrable, externe, ou issue d'un lot), il peut être associé à un client et un fournisseur (ainsi qu'à leur factures) , associé ou non à un entrepot et avoir des dates (début, de fin, de DLUO)
Les Evènements Il s'agit un moment (avec une date de début et de fin) associé à un ou plusieurs Equipement c'est ce qui permet d'avoir un historique sur le cycle de vie de l'équipement. Un équipement peut être associé à un d'autres éléments natifs de dolibarr, que ce soit par un onglet dédié (intervention, contrat, expédition, projet) ou par des liaisons créer manuellement (avec le module customLink ).
Les consommations Cette notion correspond à l'utilisation d'un produit (sérialisé avec Equipement ou non), que ce soit dans la fabrication de l'équipement ou son utilisation (par exemple le remplacement d'une batterie dans un smartphone)

Ces trois notions sont traçables grâce au module Equipement et permet ainsi d'avoir un historique précis de la vie d'un produit unique (ou d'un lot de produit). Il va bien plus loin que la notion de batch/lot native qu'il utilise pour regrouper des équipements entre eux (numéro de version), sans avoir besoin que cette fonction soit activée dans Dolibarr.


Equipement Liste equipement.png

Le module gère la création et l’enregistrement de numéros de série à partir des produits ou des commandes.

Numéros de série, événements et états sont personnalisables avec les masques et dictionnaires de Dolibarr.

La gestion des équipements se fait transversalement avec tous les modules natifs de Dolibarr pour les fonctionnalités telles que celles des produits, stocks et entrepôts, expéditions, interventions …

Customtabs Equipement entrepot.png

Équipement, en tant qu'élément du pack de GPAO (Equipement, Factory et reStock), permet aussi la traçabilité des composants utilisés pour la fabrication d'autres produits dans Dolibarr et l'enregistrement de la consommation de produits en interne.

Paramétrage

La configuration du module s'effectue depuis la page d'administration des modules accessible par les menus Accueil > Configuration > Modules en cliquant sur l'icône Doli-setup.png ou Doli-setup-old.png en bout de ligne. Les 3 premiers onglet sont dédiés à la configuration des trois notions (Equipement, Evènement et Consommation) les trois suivants à la configuration des attributs supplémentaires

Paramétrage Equipements, Evènements et Consommations

Equipement Configuration.png Le module Equipement permet la personnalisation du masque de numérotation des équipements.
Info-icon.png Le module requiert l'activation des modèles de numérotation et de documents des équipements

En cas d'utilisation de lecteurs optiques de codes barres, Equipement propose le paramétrage des séparateurs pour les numéros de série externes et de leur position de début.

Il est possible d'afficher les numéros de série des produits sur les fiches des expéditions.

Pour une gestion de stock simplifiée, Equipement propose la création de mouvements de stock à la création d'équipements. Le paramétrage permet de cocher la case par défaut pour une alimentation automatique des stocks.

Attributs supplémentaires

Equipement vous permet de créer des champs supplémentaires (Extrafields) au niveau:

  • des Equipements
  • des évènements
  • des consommations

Leur paramétrage s'effectue au niveau de la configuration du module sur l'onglet dédié

Dictionnaire

Le module s'appuie sur les dictionnaires de Dolibarr pour l'attribution d'événements et de conditions aux équipements. Vous pouvez créer vos propres entrées depuis Accueil > Configuration > Dictionnaires > État d'équipement et Type d'évènement équipement. La couleur des événements de l'agenda est à déclarer dans le dictionnaire des type d'événements.

Customtabs Dictionnaire.png

Equipement Dictionnaire2.png La couleur ajoutée aux événements sera reprise dans les listes déroulantes de sélection. Il en est de même pour la création des types de contacts à associer aux équipements.

Sélectionner Équipement dans la liste déroulante des éléments, le type de contact (interne pour un utilisateurs, externe pour un contact de tiers), un code et un libellé qui sera affiché dans la liste de sélection de l'onglet contacts/adresses d'un Equipement.

Permissions

Les accès aux fonctionnalités du module peuvent être restreints aux utilisateurs et groupes existants ou créés ultérieurement à l'installation du module. Cliquez sur le – pour ajouter un permission. Une permission accordée est symbolisée par un coche verte (Tick.png).

Permissions utilisateurs et groupes

Equipment Permissions-utilisateurs.png Les accès aux fonctionnalités du modules peuvent être restreints aux utilisateurs et groupes, depuis leur fiche puis onglet Permissions, selon les permissions ci-contre

Permissions par défaut

Equipment Permissions-defaut.png Les permissions par défaut (Accueil > Configuration > Sécurité > Permissions par défaut), accordées à tout utilisateur créé ultérieurement à l'installation du module, si il n'est pas ajouté à un groupe, sont les suivantes

Démarrage

Les fonctionnalités d'Équipement sont accessibles depuis l'onglet de menu principal Produits/services.

Votre menu secondaire présente alors les entrées de menu suivantes

Equipment Menusecondaire.png

Equipement : Affiche "l'espace" Equipement avec des zones de recherche, des tableaux de bord de l'utilisation du module.

Nouvel Equipement : Permet de créer directement un Equipement en sélectionnant d'abord un produit et un mode de sérialisation, un second écran apparait ensuite pour saisir le reste des informations.
Liste des équipements : L'entrée affichera la liste des équipements avec options de tri et de filtrage. Il est également possible de modifier des équipements en masse depuis cette liste.
Liste des évènements : L'entrée affichera la liste des événements avec options de tri et de filtrage.
Liste des consommations : L'entrée affichera la liste des consommations avec options de tri et de filtrage.

Création/Sérialisation d'équipement

Initialisation

Les différents modes de sérialisation sont détaillés à la section Choix du mode de sérialisation, plus bas.

Depuis les menus

La création d'équipements peut être réalisée depuis les menus Produits/Services > Equipement > Nouvel équipement.

Equipment Equipement creation.png Saisissez le produit source et le mode de sérialisation de l'équipement et cliquez sur le bouton Créer brouillon

Depuis les fiches des produits

Les équipements peuvent aussi être créés depuis les fiches des produits, avec l'onglet Équipement :

Equipment Equipement crea ficheproduit.png

Depuis les fiches des commandes fournisseur

Les équipements peuvent aussi être créés depuis les fiches des commandes, avec l'onglet Équipement :

Equipment Equipement crea fichecommande.png

Info-icon.png La création du mouvement de stock correspondant à la création des équipements depuis une commande peut faire doublon avec les règles d'incrémentation des stocks lors de leur réception vers les entrepôts

Dans tous les cas de création, l'écran suivant affichera la page de saisie des informations complémentaires de l’équipement selon le type de sérialisation choisie.

Choix du mode de sérialisation

Sérialisation automatique (interne)

Customtabs Equipement crea auto.png Les numéros de série créés et attribués seront ceux définis par le masque sélectionné dans les paramétrages du module (voir "Configuration" ci-dessous). Équipement générera autant de numéros de série consécutifs que d'équipements à créer.

Sérialisation saisie (externe)

Equipment Equipement crea saisie.png Les numéros de série seront à saisir selon ceux que portent les produits que vous enregistrez en les sépérant par un point-virgule (;) et sans espace. Si la zone est laissée vide, la génération automatique des numéros de série sera utilisée. Le module Équipement créera autant d'équipements que de numéros de série saisis.

Gestion par lot d'équipements

Equipment Equipement crea lot.png Pour l'enregistrement d'un équipement en lot, la sérialisation se fait par la saisie d'un numéro de version du produit.

Un lot peut être découpé si le champ quantité est rempli d’une valeur supérieure à 1. Pour découper un lot, cliquez sur le bouton Décomposer le lot :

Equipment Boutons découpage lots.png

Une fenêtre affiche alors les options disponibles :

Equipment Confirmation découpage lot.png

Autres champs de création

Equipment Equipement crea autres.png Les autres informations de la page permettent d'enregistrer les données propres à l'équipement si elles diffèrent du produit d'origine.
Info-icon.png Le champ Fournisseur n'est affiché que si le produit a un fournisseur enregistré. Si le produit n'a qu'un seul fournisseur, celui-ci est ajouté automatiquement. Enfin, si le produit a plusieurs fournisseur, une liste déroulante vous sera proposée pour le sélectionner

Entrepôt et mouvements de stock

Equipment Mouvement stock.png Si un entrepôt est saisie dès la création d'un équipement, celui-ci est automatiquement validé.

À la création d'un équipement, si la case à cocher Créer le mouvement de stock correspondant est cochée, les stocks de l'entrepôt seront incrémentés de la quantité d'équipements créés. L'origine permettra d'identifier le mouvement

Si aucun entrepôt n'est saisi à la création d'un équipement, celui-ci sera créé à l'état brouillon. Vous devrez le valider ultérieurement.

Liste des équipements

Equipment Equipement liste generale.png Le lien de menu secondaire Produits/Services > Équipement > Liste des équipements vous affichera la liste des équipements avec des options de tri et de filtrage
Info-icon.png Astuce : La liste des équipements permet de leur apporter des modifications en masse. Il est possible, depuis la liste d'affecter des équipements en masse à un entrepôt : cochez les équipement à déplacer, sélectionner l'entrepôt dans la liste déroulante sous la liste, cochez la case, éventuellement celle de la création du mouvement de stock et modifiez. Il en est de même pour modifier les conditions et les états des équipements
Info-icon.png Astuce : Un clic sur le + du texte Récupérer la liste des équipements vous affichera la liste filtrée des équipements au format CSV. Vous pourrez la copiez pour la réutiliser
Info-icon.png Les fiches de nombreux autres éléments auxquels il est possible de lier des équipement proposeront un lien vers la fiche des équipements

Détail d'un équipement

À l'état brouillon, seules les saisies produit et fournisseur ne sont pas modifiables. Il est possible de modifier la référence de l'équipement grâce aux "Permissions", voir plus bas.

Equipment Equipement fiche.png Il est possible enfin d’accéder aux autres informations de l’équipement grâce aux différents onglets apparaissant sur la fiche.
Info-icon.png L’onglet Composition est affiché si la prise en charge des produits composés a été activée dans la configuration du module Produits, ou si le module Factory (http://docs.patas-monkey.com/factory) est installé et activé

Si on change le client associé à un équipement, alors qu'une facture est déjà associée à ce même équipement, l'association de la facture est réinitialisée.

Dans le cas d’un utilisateur ayant une gestion d’habilitation des tiers limités, si l’on ne définit pas de client à l’équipement dès sa création, celui-ci n’est pas accessible une fois crée.

Autres informations depuis les fiches des produits

Equipment Liste equipement-fiche-produit.png L'onglet Équipement des fiches produit affiche :
  • Liste des équipement : Il s'agit de la liste des équipements issus du produit
Equipment Client-possesseur-fiche-produit.png
  • Client possesseur : Cette liste affiche les client auxquels sont affectés des équipements du produits source.
Equipment Evenement-predefini-fiche-produit.png
  • Événements prédéfinis : Les événements prédéfinis sont une sorte de dictionnaire. La description que vous ajouterez ici à chacun des événements sera automatiquement copiée sur les prochains événements des équipements de ce produit.

Événements d'équipement

Événements

Il est possible de créer des événements aux équipement depuis leur fiche, onglet Événement ou depuis l'entrée de menu secondaire Produits > équipement > Nouveaux événements.

Info-icon.png Il est possible de saisir des événements sur un équipement à l’état brouillon

Ajout d'événement depuis la fiche des équipements

Equipment Crea-evenement-fiche.png L'onglet Événements des fiches des équipements affiche la page d'ajout d'un événement

Sélectionnez un événement dans la liste déroulante, une description et les dates et heures de l'événement avant d'enregistrer.

Info-icon.png Si l'équipement est relié à un client, et que ce client est le tiers d'un contrat, projet, intervention,... il est possible d'indiquer ici la liaison avec l'équipement
Info-icon.png Cette même page affiche l'historique des événements enregistrés sur l'équipement

Ajout d'événement en masse

Equipment Crea-evenement-menu.png Il est possible de créer des événements à plusieurs équipement depuis l'entrée de menu Produits > équipement > Nouveaux événements.

Indiquez la liste des équipements concernés, sélectionnez un événement dans la liste déroulante, une description et les dates et heures de l'événement avant d'enregistrer.

Agenda mensuel des événements des équipements

L'entrée de menu Agenda d'équipement affiche une liste filtrable des équipements selon leur entrepôt, condition et événements :

Equipment Agenda-equipement.png

Info-icon.png Si vous ne saisissez aucun filtre, la liste affichera tous les équipements associés à un événement sur le mois courant

La page affiche alors, sur le mois courant, les événements enregistrés aux équipements. Un tooltip permet d'afficher la description de l'événement.

Equipment Couleur-dictionnaire.png Il est possible d'attribuer une couleur aux événements des équipements depuis le "Dictionnaire" des événements. La couleur doit être saisie au format hexadécimal (FF6600 par exemple).

Joindre un équipement à une expédition, une facture ou une intervention

Equipement ajoute deux onglets aux fiches des expéditions et des factures. L'onglet Joindre un équipement permettra la sélection des équipements à lier au document, tandis que l'onglet Equipement affichera la liste des équipements déjà liés à ce même document.

Info-icon.png Pour joindre un équipement à un document, il est nécessaire que le produit duquel l'équipement est issu ait été ajouté dans les lignes du document : un équipement sans lien avec le produit présent dans les lignes des documents ne sera pas joignable

Joindre un équipement à une expédition

Equipement Jointure-expedition.png Depuis une commande, créez l'expédition d'un produit. Cliquez sur l'onglet Joindre un équipement
Equipment Jointure-selection.png L'écran affiche les équipements selon les types disponibles : lot ou équipement unique. Dans le cas d'équipement en lot, saisissez la quantité à retrancher du lot présent dans l'entrepôt. Dans le cas d'un équipement unique, cliquez sur le + pour afficher la liste des équipements expédiables.
Info-icon.png Pour être expédiable un équipement doit être lié à un entrepôt

Continuez en cliquant sur le bouton Joindre.

Equipment Jointure-validation.png Terminez en validant l'expédition de l'équipement depuis l'onglet Equipement en cliquant sur le bouton Valider l'expédition de l'équipement.
Info-icon.png Une fois l'équipement validé sur cet onglet, il n'est plus possible de le modifier
Equipment Rouget.png
Info-icon.png En activant le modèle de document Rouget Equipement dans la configuration du module Expéditions, vous pourrez afficher les numéros de série des équipements expédiés sur les fiches expéditions:

Joindre un équipement à une facture

Equipment Jointure-facture.png Depuis une facture, cliquez sur l'onglet Équipement. Saisissez le numéro de l'équipement à ajouter à la facture et cliquez sur le bouton Ajouter.
Equipment Information-equipement-facture.png Le même écran fera mention des autres équipement précédemment joints au document en liste.

Le bouton Ajouter les équipements sur le détail de la facture ajoutera à la ligne de la facture le numéro de série du produit :

Info-icon.png Si une facture est créé à partir d'une expédition, l'onglet Equipement affichera le bouton Ajouter les équipements de l'expédition. Ce bouton enregistrera sur la facture les équipement enregistrés sur l'expédition source en vous évitant de les saisir ou rechercher à nouveau

Joindre un équipement à une intervention

Equipment Jointure-intervention.png Depuis la fiche d'une intervention, cliquez sur l'onglet Joindre un équipement. Filtrez la liste et ajouter l'équipement en le sélectionnant avec la case à cocher
Equipment Information-equipement-intervention.png Le numéro de série de l'équipement sera alors imprimé dans la note publique de la fiche d'intervention

Traçabilité des équipements

La traçabilité des équipements est assurée par la succession des événements qui leur sont enregistrés :

Equipment Tracabilite.png

Info-icon.png Le client apparaît en plus des autres informations d'expédition ou intervention si l'équipement ne lui est plus attaché

Consommation

Equipment Saisie-consommation.png Équipement permet de tracer les produits utilisé en interne. Depuis la fiche d'un équipement, cliquez sur l'onglet Consommation.

Sélectionnez le produit consommateur de l'équipement, un entrepôt et saisissez si besoin une description.

Autres fonctionnalités

Widgets en page d'accueil

Eqipment Widget.png Deux widgets peuvent être affichés sur la page d'accueil de Dolibarr. Ils permettent de suivre l'activité des équipements et leurs événements.

Recherche

Equipment Recherche.png Fonction de recherche à multiples critères depuis la barre de recherche du menu gauche

Export

Equipment Equipement export.png La fonctionnalité d'export permet le traitement des informations des équipements sous différents formats avec sélection de nombreux champs utiles.

Questions fréquentes

Vous trouverez ci-dessous des éléments de réponse aux principales difficultés rencontrées à l'utilisation du module :

  • Message d'erreur suite à l'installation : Si les modèles de numérotation et de document ne sont pas activés dans la configuration du module, le message d'erreur suivant sera affiché :
Equipment Erreur atlantic.png
Activez les modèles de numérotation et de document, et tout rentrera dans l'ordre.