REST · GMAO · terrain

La donnée technique au bon endroit dans l'ordre de travail

L'API REST CVC pour votre GMAO et vos techniciens

Renvoyez à votre app le sens d'un code, le manuel applicable et la bonne abstention quand le SKU n'est pas couvert. Gardez votre UX, vos OT et votre système de record ; AskMarcel apporte la couche diagnostic sourcée.

Le Harnais reste une surface distincte pour les sessions multi-tours guidées : choisissez-le seulement si vous devez orchestrer et journaliser chaque contrôle.

Obtenir une clé Developer Réserver un pilote GMAO

Le problème métier

Votre GMAO sait gérer l'intervention — pas toujours interpréter le défaut

Les plateformes terrain excellent sur le planning, les pièces et la facturation. Lorsque le technicien saisit un code, il ouvre encore souvent un PDF ou appelle la hotline. L'API REST place une réponse sourcée dans le workflow sans remplacer votre GMAO.

PDF hors workflow

Le bon manuel existe, mais ni le code ni la page source ne remontent dans l'ordre de travail.

Mauvais modèle, mauvaise réponse

Un code peut couvrir plusieurs séries. v2 résout le modèle/SKU et s'abstient au lieu de laisser l'UI présenter un manuel voisin comme exact.

Couche technique à maintenir

Ingestion, normalisation et provenance OEM ne devraient pas devenir un sous-produit de votre roadmap FSM.

Exemple terrain

Un code Gree E6 attaché à l'OT, avec sa source

Depuis un ordre de travail, votre app envoie la marque, l'indice modèle et E6. Elle résout le modèle, appelle le diagnostic v2 et affiche l'interprétation avec le manuel et la page applicables.

Si le manuel exact n'est pas disponible, l'API renvoie une abstention structurée : votre app ouvre alors l'escalade expert au lieu de suggérer une pièce. Si vous devez ensuite guider chaque mesure, basculez vers le Harnais Beta.

REST v1 : lookup large et recherche documentaire
REST v2 : résolution modèle, provenance SKU et abstention explicite
La réponse et la citation restent attachables à votre ordre de travail

Extrait redacted à titre d'illustration. L'API live renvoie manufacturer, manual, page et section complets — voir le protocole HVAC-Bench.

Citation illustratif

Gree · Service manual · p. 201

Scénario bench: hvac-bench/field-service-e6-gree

Réponse sourcée (extrait illustratif)

{
  "status": "sourced",
  "model_id": "mdl_…",
  "error_code": "E6",
  "diagnostic": "Communication fault (redacted)",
  "citation": {
    "manufacturer": "gree",
    "manual": "Service manual (redacted)",
    "page": 201
  },
  "billable": true
}

Abstention (non facturable)

{
  "status": "no_exact_source",
  "model_id": "unknown-sku-…",
  "message": "No exact OEM manual for this SKU — route to expert review",
  "billable": false
}

Protocole HVAC-Bench →Exemples quickstart →

Limites assumées

Ce que l'API REST promet — et ne promet pas

v1 n'est pas une preuve SKU

v1 aide au lookup large. Pour une réponse qui doit s'appuyer sur le manuel du modèle précis, utilisez v2.

v2 préfère s'abstenir

Sans manuel exact ou avec modèle ambigu, la bonne réponse est une abstention structurée — pas une confiance artificielle.

Pas un moteur de session

L'API REST enrichit votre GMAO. Pour journaliser une succession de contrôles et de réponses technicien, évaluez le Harnais Beta.

Deux périmètres

Éditeur GMAO vs opérateur terrain

Périmètre A — Produit FSM / GMAO

Vous enrichissez un workflow existant

Les éditeurs veulent intégrer le lookup et la provenance sans faire basculer leurs utilisateurs dans une application tierce.

REST v1/v2 consommable depuis mobile, back-office ou portail client
Model/SKU résolu avant les réponses qui doivent être exactes
Programme Connecteurs pour co-vente Marcel Inside

Périmètre B — Opérateur de maintenance

Vous déployez l'aide au diagnostic

Les responsables opérations cherchent une réponse utilisable dans leur outil et un chemin d'escalade clair — pas une nouvelle interface pour leurs équipes.

Pilote sur une marque, une région et un type d'OT
Citation et statut d'abstention exploitables dans votre BI
Harnais en seconde étape si le workflow exige des contrôles multi-tours

Flux d'intégration

De l'ordre de travail à une réponse sourcée

1
Normaliser la demande
Envoyez marque, code et indice modèle depuis votre registre d'actifs ou l'OT.
2
Choisir v1 ou v2
Utilisez v1 pour le lookup large ; résolvez le modèle et passez à v2 lorsque la provenance SKU est une exigence.
3
Afficher la source ou l'abstention
Rattachez la citation constructeur à l'OT. Sans source exacte, ouvrez votre file expert au lieu de forcer une réponse.
4
Passer au Harnais seulement si nécessaire
Quand chaque contrôle doit être proposé, répondu et rejoué, lancez un pilote Harnais plutôt que de reconstruire une session dans votre GMAO.

Preuve

Une surface REST vérifiable avant intégration

La documentation publique, le contrat machine et HVAC-Bench permettent à l'équipe produit de vérifier l'étendue, la provenance et le comportement d'abstention avant le pilote.

Voir méthodologie benchmark

400k+

Codes erreur en lookup mondial

v1 + v2

Surfaces REST

source ou abstention

Politique v2

Aller plus loin

Guide REST

Lookup v1, provenance v2 et choix de la surface pour votre intégration.

Harnais diagnostic guidé

Évaluez la surface session si votre app doit piloter des contrôles multi-tours.

Quelle API choisir

Comparez REST v1/v2, MCP et Harnais avant de concevoir le workflow.

Ajoutez la donnée diagnostic à votre GMAO, sans la reconstruire

Validez le lookup et la provenance avec une clé Developer, puis cadrez un pilote sur une marque et un type d'ordre de travail.