Acheter à partir d'un ticket, sans rien ressaisir dans le portail d'achats. Le module Mercado Eletronico de NexTool relie GLPI à la plateforme d'achats Mercado Eletronico (ME) et transforme un ticket en demande d'achat - avec un catalogue synchronisé, une approbation unique et un suivi automatique du cycle jusqu'à la commande, le tout dans GLPI.
Le problème
Quand l'informatique ou les achats reçoivent une demande d'achat par ticket, le flux traditionnel est manuel et dupliqué : l'agent enregistre le ticket dans GLPI, ouvre le portail Mercado Eletronico, ressaisit les articles, choisit un fournisseur et un approbateur, puis revient au ticket pour noter le numéro. Chaque demande passe par deux outils et, souvent, par deux approbations. Le résultat, c'est du retravail, des erreurs de saisie et - ce qui fait le plus mal lors d'un audit - la perte de traçabilité entre le ticket qui a lancé l'achat et la commande qui en est sortie. Quand quelqu'un demande "cette commande de 8 000 a-t-elle vraiment été approuvée par la bonne personne ?", la réponse se perd entre deux systèmes.
Comment fonctionne Mercado Eletronico
Le module ajoute l'onglet Demande ME au ticket et gère le pont avec ME de bout en bout :
- Catalogue synchronisé - produits, groupes, fournisseurs, filiales et utilisateurs de ME sont importés dans GLPI, avec une recherche sur tous les champs.
- Demande sur le ticket lui-même - cascade Groupe → Produit, approbateur, filiale de livraison, catégorie et quantité, avec le total estimé calculé en direct.
- Approbation unique - les utilisateurs disposant du droit « Envoyer la demande déjà approuvée » envoient la demande déjà approuvée à ME, ce qui supprime la seconde approbation manuelle ; sans ce droit, elle arrive dans ME en attente d'approbation.
- Confirmation automatique - le statut revient de ME par webhook et une routine de réconciliation garde tout synchronisé ; quand ME refuse la demande faute de permission sur le groupe de produits, le ticket affiche le motif, la demande revient pour correction et renvoi et le groupe est marqué comme bloqué dans le catalogue.
- Chronologie sur le ticket - pré-commande, cotation et commande apparaissent comme des étapes sur le ticket, sans ouvrir le portail ME.
Ce que le module apporte au-delà de GLPI natif
GLPI dispose de registres solides pour les fournisseurs, les contrats et les budgets - mais il ne dialogue pas avec une plateforme d'achats externe. C'est exactement le pont que construit le module :
| Besoin | GLPI natif | Avec le module Mercado Eletronico |
|---|---|---|
| Enregistrer une demande d'achat depuis un ticket | Note manuelle dans le texte du ticket, non structurée | Onglet Demande ME avec articles, approbateur et total estimé |
| Catalogue de produits et fournisseurs | Saisie manuelle des fournisseurs ; pas de catalogue ME | Catalogue ME (produits, groupes, fournisseurs, filiales) synchronisé |
| Envoyer la demande à la plateforme d'achats | Tout ressaisir dans le portail ME | Envoyée directement depuis le ticket, sans ressaisie |
| Suivre pré-commande, cotation et commande | Consulter le portail ME manuellement | Chronologie automatique sur le ticket, par webhook |
| Groupe sans permission d'achat | Refus visible seulement dans le portail ME | Refus affiché sur le ticket, avec le motif, et groupe marqué comme bloqué dans le catalogue |
Du ticket à la commande, sans quitter GLPI
Une fois envoyée, la demande parcourt le cycle ME - pré-commande, cotation et commande. Le module suit chaque étape automatiquement via les webhooks de Mercado Eletronico et dessine une chronologie sur le ticket : l'agent voit si la pré-commande a été générée, à quelle étape en est la cotation et quand la commande a été émise. Chaque événement envoyé par ME passe par ces étapes avant d'atteindre le ticket :
# ce que GLPI fait de chaque evenement envoye par ME
1. verifie le Basic Auth : utilisateur et mot de passe de l'identifiant de cette instance (sinon, refus avec 401)
2. verifie la signature HMAC (X-ME-WEBHOOK-SIGNATURE), seulement si le jeton de verification est configure
3. ignore les evenements repetes (X-ME-EVENT-ID) et enregistre l'evenement brut dans la boite de reception
4. repond 200 en moins de 10 s, dans le delai de ME
5. la tache "tracking" (toutes les 2 min) interroge la pre-commande, la cotation ou la commande par ID dans l'API ME
et met a jour la chronologie du ticket
Un détail qui n'apparaît que lorsqu'on exploite l'intégration en production : les endpoints de listage de l'API Mercado Eletronico (/pre-orders et /orders) ignorent une bonne partie des filtres de requête que la documentation suggère. Nous l'avons découvert en support en voyant la réconciliation remonter des enregistrements qui auraient dû être filtrés. La décision a été de traiter l'intégration comme une boîte de réception : au lieu de faire confiance à un filtre distant, le module enregistre chaque événement reçu, interroge la ressource par son propre ID dans l'API ME et fait la correspondance avec le ticket localement, par le numéro de la demande, présent dans l'événement ou dans les articles de la pré-commande. En plus, chaque webhook doit passer le Basic Auth, avec l'utilisateur et le mot de passe de l'identifiant de cette instance, et la signature HMAC peut être exigée comme couche supplémentaire : un webhook sans identifiants valides est rejeté, car un statut d'achat ne doit pas pouvoir être falsifié par n'importe quelle requête qui tombe sur l'URL.
Comment l'activer
- Installez NexTool sur votre GLPI 11.
- Allez dans Configuration > NexTool > Modules et activez Mercado Eletronico.
- Dans l'onglet Intégrations, saisissez les identifiants de l'API ME et testez la connexion.
- Définissez le périmètre (entités et catégories de ticket) autorisé à générer une demande.
- Enregistrez les webhooks de cycle en un clic et vérifiez l'URL de retour configurée dans ME.
Pour qui c'est fait
Les entreprises qui utilisent Mercado Eletronico comme plateforme d'achats et traitent les demandes via le service desk GLPI - informatique, achats et facilities qui veulent supprimer la double saisie et garder ticket et achat traçables au même endroit.
Quand NE PAS l'utiliser : si l'entreprise n'utilise pas Mercado Eletronico comme plateforme, le module ne s'applique pas - il est spécifique à ME, pas un catalogue d'achats générique. Si la demande d'achat ne naît pas d'un ticket, l'intégration n'apporte aucune traçabilité. Et si vous devez seulement enregistrer des fournisseurs, contrats et budgets internes, le registre natif de GLPI y répond déjà, sans intégration externe.
Compatibilité
- GLPI : 11.0+
- Offre : Sous licence (à la demande)
- Plugin : NexTool 6.15.0+
- Mercado Eletronico : API v1 (recette et production)
Prochaine étape
Mercado Eletronico fait partie de NexTool, l'écosystème de modules pour étendre GLPI sans personnalisation de code. Voyez la page du module ou parlez à l'équipe pour une démonstration.
Révisé par l'équipe NexTool Solutions.
