Lien entre intervention et devis

Un devis peut être créé de manière autonome ou être directement lié à une intervention existante, qu'elle soit en cours ou terminée. Comprendre comment gérer ces différentes situations via l'API est essentiel pour assurer la cohérence des données entre votre système et celui de vos clients.
Cette page décrit les trois principaux cas de figure que vous rencontrerez.

Cas 1 : Devis initié par le client (sans intervention préexistante)

Contexte : Le client vous contacte directement pour un besoin qui n'est pas encore formalisé par une intervention dans la plateforme (ex: un projet d'amélioration, une demande de chiffrage suite à un constat).
Flux API :
    Vous recevez la demande de devis par un canal externe (téléphone, email, etc.) ou via la plateforme (open / requested)
    Vous suivez le processus  ⁠⁠Proposer un devis⁠ 
    Dans ce scénario, le devis est "autonome" ; il n'est pas rattaché à une intervention existante au moment de sa création.

Cas 2 : Devis soumis APRÈS une intervention terminée

Contexte : Vous avez terminé une intervention (elle est donc closed dans le système). Lors de la clôture, vous identifiez un besoin de travaux complémentaires ou réglementaires.
Flux API :
    L'intervention initiale est terminée et son cycle de vie est clos.
    Vous proposez un devis à votre client en suivant le processus  ⁠⁠Proposer un devis⁠ 
    Point clé : Pour assurer la traçabilité et le contexte, lors de sa création, le devis doit être liée à l'intervention d'origine par le champ parentReference.

{
  "reference": "Devis-1234",
  "parentReference": "inter-7867234",
  "contractReference": "Plomberie_2025",
  "status": "open",
  "event": "proposed",
  "eventDate": "2025-08-04T10:00:00Z",
  "logDate": "2025-08-04T10:00:00Z",
  "location": {
    "assetReference": "440917"
  },
  "tags": {
    "devis_montant":"900.70"
    "devis_reference":"XLW0987"
  },
  "description": "Proposition de remplacement de la salle de bain suite à notre intervention inter-7867234" "
}

Cas 3 : Devis nécessaire pour TERMINER une intervention en cours

Contexte : Vous êtes en train de réaliser une intervention (elle est donc open, pending ou hold dans le système), mais vous faites face à une situation qui bloque la finalisation :
  • Découverte de travaux hors contrat.
  • Nécessité de commander des pièces coûteuses non prévues.
  • Besoin d'une régularisation avant de pouvoir clôturer.
Flux API :
    Vous devez mettre à jour l'intervention en la passant dans un état d'attente hold / quote_request
    Vous proposez un devis à votre client en suivant le processus  ⁠⁠Proposer un devis⁠ 
    Point clé : Lors de la création du devis, il doit être rattaché à l'intervention en cours. Cette liaison se fait via le champ parentReference.
    Une fois le devis accepté ou refusé, vous pouvez reprendre le cycle de vie de l’intervention et la mettre à jour.