Ce document guide les prestataires de maintenance dans la transmission de leurs données d'interventions réglementaires via notre API. L'objectif est de centraliser et de tracer efficacement toutes les opérations liées aux contrôles réglementaires.
Note pour les bureaux de contrôle : Ce document s'adresse aux prestataires de maintenance. Si vous êtes un bureau de contrôle, veuillez consulter la documentation dédiée à votre scénario métier Bureau de contrôle
Récupération des rapports et réserves à lever
Pour optimiser vos processus et offrir un meilleur reporting au gestionnaire immobilier, IntentPlatform vous permet de récupérer les rapports réglementaires et leurs réserves directement via nos API. Cette intégration évite les doubles saisies et la récupération manuelle des documents.
Pour mettre en place ce scénario, le prestataire bureau de contrôle doit également transmettre ces données au travers d'IntentPlatform. N'hésitez pas à nous solliciter pour connaître la comptabilité du bureau de contrôle chez votre client.
Types d'interventions gérées
En tant que prestataire, vous gérez 2 typologies d'intervention:
Accompagnement du bureau de contrôle : Le prestataire assiste l'organisme de contrôle durant son inspection (par exemple, manipulation d'un équipement, ouverture de trappes, etc.).
Levée de réserves : Le prestataire effectue une action corrective pour résoudre une non-conformité signalée dans un rapport de contrôle.
Cycle de vie et statuts de l'intervention
Pour assurer un suivi complet et transparent pour le gestionnaire, il est essentiel de transmettre chaque étape clé du cycle de vie d'une intervention.
Les principales étapes à transmettre sont :
L'accusé de réception
La planification
Le début d'intervention
La fin d'intervention
La clôture de l'intervention (avec le document quitus en pièce jointe)
Pour plus de détails sur la gestion des statuts et les données attendues à chaque étape, veuillez vous référer à la Partie fonctionnelle
Transmission des données
Points d'attention
serviceCode : Assurez-vous de toujours utiliser la bonne valeur (Accompagnement ou LR-{domaine}) pour garantir un traitement correct des données.
LR-CFO, LR-SSI, LR-ASC
description : Pour la clôture de l'intervention levée de réserve, fournissez une description claire et factuelle. Elle constitue la preuve de la résolution.
Endpoint de l'API
Pour soumettre une intervention, effectuez une requête POST sur l'endpoint suivant :
POST /api/operations/v2/interventions/logs
Structure des Données
Le corps de votre requête POST doit être un objet JSON contenant les informations clés de l'intervention.
Exemples de Requêtes
1. Exemple pour un Accompagnement :
{
"reference":"INTER-0505",
"description":"Accompagnement du bureau de contrôle pour accéder à la machine ascenseur",
"contractReference":"contract1",
"status":"closed",
"event":"done",
"eventDate":"2020-03-06T15:35:00",
"logDate":"2020-03-06T15:35:26",
"serviceCode":"Accompagnement",
"location":{
"assetReference":"BATI_002"
},
"workType":"regulatory",
"criticalLevel":0,
"visitAttempt":1
}
2. Exemple pour une LR-SSI :
{
"reference":"INTER-0506",
"description":"Remise en sécurité du système incendie. Tout est conforme",