Disponible pour
- Rôles : Administrateur
- Plans : Starter, Premium, On demand, si fonctionnalité activée
L'écran Historique des intégrations vous montre le résultat des échanges entre vos systèmes et Mobility Work, sans passer par une demande au support.
L'écran couvre deux types d'échanges : les appels reçus par Mobility Work via l'API Partenaires, et les webhooks envoyés par Mobility Work vers vos systèmes.
Accéder à l'historique
- Accédez aux Paramètres du réseau depuis le menu Réseau.
- Ouvrez l'onglet Historique des intégrations.
- La liste s'ouvre sur les échecs des 7 derniers jours : c'est ce que vous cherchez le plus souvent en arrivant sur cet écran.
- Ajustez les filtres si nécessaire.
Lire la liste
Au-dessus de la liste, trois compteurs résument ce que vous regardez : le nombre d'appels affichés, le nombre d'entrées sur cette page, et le nombre total d'entrées sur la période. Seul le dernier porte sur l'ensemble de la période retenue par vos filtres ; les deux premiers ne décrivent que la page en cours.
Chaque ligne de la liste correspond à un appel, et non à un événement isolé. Un même import peut produire plusieurs entrées — le lot reçu, son traitement quelques minutes plus tard, puis une entrée par ligne en erreur. L'écran les regroupe pour vous présenter l'appel dans son ensemble.
Une ligne vous indique :
- l'intégration concernée, par exemple Mouvements de stock, Création et mise à jour de pièces détachées, ou Webhooks ;
- l'adresse de l'échange :
- pour un appel reçu, l'endpoint suivi du début de la référence de la requête ;
- pour un webhook envoyé, l'URL de votre système et le code de statut obtenu ;
- le statut de l'appel sous forme d'étiquette :
- un motif d'échec, par exemple Pièce détachée introuvable ou Données envoyées invalides,
- ou Aucune erreur lorsque l'appel a réussi ;
- le nombre d'entrées rattachées à cet appel sur la page en cours ;
- la date de l'appel.
Le premier appel de la liste s'ouvre automatiquement, avec ses motifs d'échec déjà dépliés, pour vous montrer ce que contient le détail sans avoir à cliquer.
Les filtres disponibles
Quatre filtres vous permettent de cibler ce que vous cherchez.
Statut
Tous (les deux), Échecs (valeur par défaut à l'ouverture de l'écran), Succès.
Sens
Tous (valeur par défaut), Reçus — les appels que vos systèmes adressent à Mobility Work via l'API Partenaires —, Envoyés — les webhooks que Mobility Work adresse à vos systèmes.
Intégration
Permet de cibler une intégration précise :
- Mouvements de stock,
- Informations des pièces détachées,
- Niveaux de stock,
- Création et mise à jour de pièces détachées,
- Inventaire physique,
- Changement d'emplacement,
- Emplacements de stockage,
- Équipements,
- Tâches,
- Comptes rendus d'activité,
- Webhooks.
L'option Toutes les intégrations les affiche sans distinction.
Période
Trois fenêtres sont proposées : Dernier jour, 7 derniers jours, 30 derniers jours. L'écran s'ouvre sur 7 derniers jours. Selon le volume de votre réseau, la période réellement disponible peut être plus courte : les entrées les plus anciennes sont purgées régulièrement.
Ce que les compteurs annoncent
Les compteurs de l'écran parlent toujours en entrées, jamais en éléments métier. Une entrée est une ligne enregistrée par Mobility Work pendant le traitement, pas une pièce détachée ou un équipement.
Concrètement, un appel ayant importé 1 000 pièces détachées n'affiche pas « 1 000 entrées » : rien n'enregistre le nombre d'éléments contenus dans un lot. Vous ne trouverez donc pas de compteur du type « 950 réussis sur 1 000 ».
Comportements à connaître
- Tout changement de filtre vous ramène en page 1. La page 4 d'une liste complète n'est pas la page 4 d'une liste filtrée sur les webhooks, et un numéro de page hors limites afficherait une liste vide pouvant être prise pour une absence de résultat.
- La liste affiche 20 entrées par page, non modifiable. Lorsque les entrées d'un même appel ne tiennent pas toutes sur une page, l'écran vous le signale explicitement plutôt que de laisser son compteur passer pour un total. Le message qui s’affiche est le suivant:
Cet appel a X entrées sur cette page. D'autres peuvent se trouver sur les pages suivantes — filtrez sur « Échecs » pour ne garder que ce qui a raté.” - Lorsqu'aucun échange ne correspond à vos filtres, l'écran affiche « Aucune activité d'intégration sur cette période ».
- Si l'historique ne peut pas être chargé, l'écran affiche « L'historique des intégrations n'a pas pu être chargé. Veuillez réessayer. » Renouvelez l'opération avant de contacter le support.
- Si vous dépliez un appel entièrement réussi, le détail affiche « Aucune erreur enregistrée pour cet appel. »
- Lorsque le contenu transmis ne peut pas être restitué, l'écran affiche « Les données envoyées n'ont pas pu être affichées. » Communiquez alors la référence de la requête au support.
Partager une vue filtrée
Les filtres et la page en cours sont inscrits dans l'adresse de la page. Vous pouvez donc copier l'adresse depuis la barre de votre navigateur et la transmettre : la personne qui l'ouvre retrouve exactement la même liste, avec les mêmes filtres.
C'est particulièrement utile dans deux situations : transmettre un import en échec à un collègue chargé de corriger les données, ou joindre le lien à une demande au support, en complément de la référence de la requête.
Le destinataire doit être administrateur du réseau pour ouvrir le lien — un utilisateur qui n'a pas ce rôle sera redirigé. Le détail déplié d'un appel, lui, ne fait pas partie du lien : le destinataire ouvre la liste filtrée, puis déplie l'appel de son côté.
Analyser un appel en échec
- Repérez l'appel concerné dans la liste — les motifs d'échec apparaissent sous forme d'étiquettes sur la ligne.
- Cliquez sur la ligne pour la déplier.
- Consultez les motifs d'échec, puis dépliez celui qui vous intéresse pour voir les entrées concernées.
Les motifs, et pourquoi ils sont regroupés
Le détail d'un appel regroupe les entrées par motif, et non ligne par ligne. C'est le motif qui constitue l'unité utile : « 3 pièces détachées introuvables » est une seule chose à corriger, là où trois lignes séparées vous obligeraient à reconstituer le problème vous-même.
Les motifs que vous pouvez rencontrer :
- Lot reçu — Mobility Work a bien reçu votre envoi.
- Traité — le lot a été traité.
- Données envoyées invalides — le contenu de la requête n'est pas exploitable.
- Référence ambiguë — la référence fournie correspond à plusieurs éléments.
- Pièce détachée introuvable — aucune pièce ne correspond à la référence envoyée.
- Emplacement de stockage introuvable — l'emplacement indiqué n'existe pas dans le réseau.
- Changement d'emplacement impossible — la pièce ne peut pas être relocalisée.
- Création ignorée ou Création impossible — l'élément n'a pas été créé.
- Traitement impossible — une erreur est survenue pendant le traitement.
- Webhook livré ou Échec de livraison du webhook — pour les appels envoyés.
- Événement d'intégration — un échange que l'écran ne sait pas encore nommer plus précisément. Communiquez la référence au support si vous avez besoin de l'interpréter.
Les motifs de réussite sont listés au même titre que les motifs d'échec. Seuls les motifs d'échec apparaissent en étiquette sur la ligne repliée, et au maximum deux, les suivants étant comptés.
Les données envoyées
Lorsque l'appel comporte une entrée Lot reçu, un bouton Afficher les données envoyées vous permet de consulter le contenu que votre système a transmis : références, quantités, prix unitaires, seuils de stock.
Les données envoyées sont toujours repliées par défaut. Elles vous appartiennent, mais elles sont volumineuses.
Le cas des webhooks envoyés
Pour tout webhook envoyé par Mobility Work, le détail conserve l'échange avec votre système : l'URL appelée, le code de statut de la réponse, et le contenu de la réponse renvoyé par votre système.
L'écran affiche une ligne Réponse, suivie du code sous forme de pastille verte ou rouge, ou de la mention Aucune réponse. Le contenu est derrière un bouton Afficher la réponse.
Un code de statut affiché comme Aucune réponse signifie que votre système n'a pas répondu du tout : nom de domaine introuvable, serveur injoignable, connexion refusée. Ce n'est pas un code de statut valant zéro. Dans ce cas, vérifiez que l'URL configurée est joignable depuis l'extérieur.
Le cas des appels reçus
Pour un appel reçu via l'API Partenaires, le détail affiche un Endpoint et non une URL : la méthode et le chemin appelés, sans nom de domaine ni paramètres.
Il n'y a pas de réponse à consulter, et ce n'est pas un oubli. L'API Partenaires accuse réception immédiatement, puis traite votre envoi en arrière-plan. Les erreurs qui vous intéressent le plus — une pièce détachée introuvable, par exemple — sont donc enregistrées bien après que la réponse vous a été retournée.
Conséquence pratique : juste après un import, l'appel peut n'afficher que son Lot reçu. Revenez quelques minutes plus tard pour voir le résultat du traitement et les éventuelles erreurs.
Communiquer une référence au support
Une icône de copie placée à côté de la référence vous permet de la récupérer en un clic ; chaque entrée dispose de la même icône pour sa propre référence
Il est important de communiquer cette référence lors d'une demande au support : elle permet de retrouver immédiatement l'échange concerné. Lorsqu'une entrée affiche Erreur technique, le message vous invite explicitement à communiquer la référence indiquée au support — c'est le cas où le détail technique ne peut pas être présenté tel quel, et où l'analyse doit être faite par Mobility Work.
Les entrées réparties sur plusieurs pages
Lorsqu'un appel possède davantage d'entrées que la page ne peut en afficher, l'écran vous en avertit et vous propose de filtrer sur Échecs pour ne conserver que ce qui a échoué. Le nombre d'entrées affiché pour un appel correspond à ce que contient la page en cours, pas nécessairement au total de l'appel.