API Intégrations ERP

← Retour au centre d’aide API & ERP 📖 Documentation API

Connecter StageReturn à vos outils métiers

Connectez StageReturn à vos logiciels métiers pour consulter l’état de vos équipements,
synchroniser les réparations, les équipements sérialisés, les équipements non sérialisés
et certaines variations de stock.

Dans ce guide

Comprendre l’API StageReturn
Générer et protéger une clé API
Comprendre les intégrations ERP
Découvrir les synchronisations disponibles
Gérer les connexions ERP par dépôt
Consulter les ERP compatibles
Suivre les erreurs et statuts de synchronisation

1. À quoi sert l’API StageReturn ?

L’API StageReturn permet à un logiciel externe ou à une intégration personnalisée
de consulter certaines informations liées aux équipements et aux réparations.
Elle est utile pour les entreprises qui souhaitent connecter StageReturn à leur ERP,
leur outil interne ou leur système de gestion de parc.

Exemple :
une entreprise possède déjà un logiciel interne pour gérer son parc matériel.
Elle peut utiliser l’API StageReturn pour consulter l’état SAV d’un équipement
à partir de son numéro de série.

2. Générer une clé API

Les clés API sont générées depuis l’espace d’administration StageReturn.
Elles permettent d’identifier votre entreprise lorsqu’un logiciel externe interroge l’API.

Pour accéder à cette partie, ouvrez le panneau d’administration puis la section
API. Selon vos permissions, vous pouvez créer,
consulter ou gérer les clés API de votre entreprise.

Exemple :
un développeur crée une clé API StageReturn afin de connecter un outil interne
qui vérifie automatiquement si un équipement est en réparation ou immobilisé.

3. Sécurité des clés API

Une clé API doit être protégée comme un mot de passe. Elle ne doit pas être publiée
sur un site web, partagée publiquement ou envoyée à une personne non autorisée.

Exemple :
une clé API destinée à un ERP doit être conservée dans la configuration sécurisée
du logiciel connecté, et non dans un document partagé ou un message public.

4. Intégrations ERP

Les intégrations ERP permettent à StageReturn de communiquer avec les logiciels métiers
déjà utilisés par votre entreprise. L’objectif est de conserver StageReturn comme outil
de déclaration, de traçabilité et de suivi SAV, tout en synchronisant certaines informations
utiles avec votre ERP.

Les fonctions disponibles peuvent varier selon l’ERP connecté. Une intégration peut notamment
gérer les équipements sérialisés, les équipements non sérialisés, les immobilisations
ou les variations de stock.

Exemple :
une entreprise utilise StageReturn pour déclarer les incidents et son ERP pour gérer
la disponibilité du matériel. Lorsqu’un équipement est immobilisé ou qu’une quantité
est déclarée manquante, l’information peut être synchronisée vers l’ERP compatible.

5. Synchronisations disponibles

Selon les possibilités du connecteur ERP utilisé, StageReturn peut synchroniser
plusieurs types d’informations.

🔧

Réparations

Une réparation créée dans StageReturn peut être associée à une action
ou à un changement de disponibilité dans l’ERP.

🏷️

Équipements sérialisés

Les équipements identifiés par un numéro de série peuvent être retrouvés
dans l’ERP et rendus indisponibles lorsqu’une immobilisation est activée.

📦

Équipements non sérialisés

Les équipements gérés en quantité peuvent être associés à un article ERP
afin de synchroniser leurs variations de stock.

↕️

Variations de stock

Une quantité déclarée manquante peut être déduite du stock ERP, puis
réintégrée automatiquement lorsque le matériel est déclaré revenu.

Exemple :
deux câbles sont déclarés manquants dans StageReturn. Si ces câbles sont associés
à un article ERP compatible, la quantité disponible peut être diminuée de deux.
Lorsqu’ils sont déclarés revenus, la même quantité peut être réintégrée.

6. Immobilisation ERP

L’immobilisation ERP est une option indépendante du statut de réparation.
Une réparation peut exister dans StageReturn sans forcément rendre l’équipement
indisponible dans un ERP externe.

Cette séparation permet de conserver de la souplesse : certaines interventions nécessitent
de bloquer l’équipement, tandis que d’autres servent uniquement à documenter un incident
ou à conserver un historique SAV.

Exemple :
une intervention esthétique est enregistrée dans StageReturn, mais l’équipement reste disponible.
À l’inverse, une panne bloquante peut entraîner son immobilisation dans l’ERP
jusqu’à la fin de la réparation.

7. Connexion par dépôt

Les connexions ERP peuvent être associées à un ou plusieurs dépôts StageReturn.
Cette organisation permet de séparer les sites, les agences, les stocks
et les comptes ERP utilisés par une même entreprise.

Exemple :
une entreprise possède un dépôt à Paris et un dépôt à Lyon. Chaque dépôt peut
conserver son propre périmètre de synchronisation et être relié au compte ERP adapté.

8. ERP compatibles

StageReturn est conçu pour accueillir progressivement plusieurs connecteurs ERP.
Chaque connecteur dispose de ses propres fonctionnalités et de sa propre documentation.

Connecteur disponible

Rentman

L’intégration Rentman permet de synchroniser les réparations, l’immobilisation
des équipements sérialisés et les variations de stock des équipements non sérialisés associés.

Connexion par token API
Immobilisation des équipements sérialisés
Synchronisation des réparations
Déduction des équipements non sérialisés manquants
Réintégration des équipements déclarés revenus
Connexion et synchronisation par dépôt

Voir la documentation Rentman

D’autres intégrations ERP pourront être ajoutées progressivement.

9. Correspondance avec les équipements ERP

Pour synchroniser correctement un équipement, StageReturn doit pouvoir identifier
l’élément correspondant dans l’ERP. Cette correspondance peut reposer sur un numéro
de série pour un équipement sérialisé ou sur une association configurée pour
un équipement non sérialisé.

Si aucune correspondance n’est trouvée, l’incident ou la réparation reste enregistré
dans StageReturn. Seule la synchronisation ERP concernée ne peut pas être effectuée.

Exemple :
un équipement est déclaré en réparation dans StageReturn, mais son numéro de série
n’existe pas dans l’ERP. La fiche SAV reste disponible dans StageReturn et le statut
de synchronisation indique que l’équipement correspondant n’a pas été trouvé.

10. Logs et suivi de synchronisation

Les intégrations peuvent afficher des statuts de synchronisation, des erreurs,
des informations de dernier test ou la date de la dernière opération.
Ces éléments permettent aux administrateurs de vérifier le bon fonctionnement
de la connexion.

Exemple :
après avoir renseigné les informations de connexion d’un ERP, l’administrateur lance un test.
Si les identifiants sont invalides ou si l’ERP ne retrouve pas un équipement,
StageReturn affiche un statut permettant d’identifier le problème.

Bonnes pratiques

Réserver l’accès API & intégrations aux utilisateurs autorisés.
Protéger les clés et tokens API comme des mots de passe.
Tester la connexion ERP après chaque modification.
Vérifier les numéros de série des équipements sérialisés.
Vérifier les associations des équipements non sérialisés.
Activer l’immobilisation ERP uniquement lorsque cela est nécessaire.
Surveiller les erreurs et statuts de synchronisation.
Conserver StageReturn comme source de vérité pour les incidents et les réparations.

À retenir

L’API et les intégrations ERP permettent de connecter StageReturn à vos outils métiers,
tout en conservant un suivi clair, indépendant et traçable des incidents,
des réparations et des mouvements liés aux équipements.

Retour au centre d’aide