Suivre l'état d'un devis

Comment suivre l'état d'un devis ?Il est crucial de suivre les décisions du client pour maintenir votre système à jour. Pour cela, deux méthodes sont possibles :
Webhooks: C'est la méthode la plus efficace. Votre système est notifié en temps réel à chaque fois qu'un nouvel événement est ajouté au devis par le client.
Polling: Si vous ne pouvez pas utiliser les webhooks, vous pouvez interroger notre API à intervalle régulier pour récupérer les dernières informations sur un devis.
Vous devrez alors analyser la réponse pour identifier les nouveaux événements qui n'ont pas encore été traités par votre système.
WebhookExemple d'un webhook reçu suite à l'acceptation de votre devis.
Le "type": "operations:quotation:update" vous indique qu'il s'agit d'un webhook concernant la mise à jour d'un objet devis.
[
  {
    "type": "operations:quotation:update",
    "id": "471b155d-09ac-4ec6-a83a-70b3b8695738",
    "event": {
        "type": "operations",
        "body": {
            "id": "57f398b4-f61e-4f0b-bdaf-f4a2f5e172b6",
            "reference": "Devis-GC10125010000000",
            "contractReference": "MTK1",
            "type": "quotation",
            "description": "Commande créée - commande : CO082AA173 - ENERGIE SERVICES",
            "status": "closed",
            "event": "accepted",
            "serviceCode": "",
            "workType": "",
            "criticalLevel": "-1",
            "assetReference": "921051",
            "assetPath": "/DRID/92/921051",
            "assetAddress": {
                "way": "243 BOULEVARD JEAN JAURES",
                "city": "CAEN",
                "country": "",
                "zip": "14100",
                "complement": ""
            },
            "issuer": {
                "entity": {
                    "id": "6107bbff02a2a205f6b23",
                    "label": "Gestionnaire immo"
                },
                "user": {
                    "id": "connector-client",
                    "name": "Connector"
                }
            },
            "operation_url": "https://api.hubintent.com/api/operations/v2/operations/Devis-GC10125010000000?contractReference=MTK1"
        }
    }
  }
]
PollingExemple de requête pour récupérer les mises à jour d'événements sur les devis.
/api/operations/v2/operations?since=2021-06-01T10:00:00&fields=logs&type=quotation
En fonction de vos besoins et de vos process, les paramètres de la requête peuvent être affinés.
Événements à réceptionnerVotre système doit être capable de recevoir et d'interpréter les événements suivants, envoyés par le client, pour mettre à jour l'état du devis de votre côté.
Status / Event
Signification et action attendue
open / acknowledged
Accusé de réception. Le client confirme avoir bien reçu votre proposition. C'est une étape de confirmation, sans action requise de votre part.
open / precisions_requested
Demande de modification. Le client attend une nouvelle version du devis de votre part. Voir la page ﻿ ⁠⁠Nouvelle version d'un devis⁠ .
closed / accepted
﻿﻿ Devis accepté. Le devis est validé. Un bon de commande vous sera transmis par la suite.
closed / rejected
﻿﻿ Devis refusé. Le devis n'a pas été accepté par le client. Le cycle de vie de ce devis est terminé.
closed / canceled
﻿﻿ Demande annulée. Le client a annulé sa demande initiale de devis. Le cycle de vie est terminé.
closed / canceled_order
﻿﻿ Devis annulée. Le client a annulé sa commande
﻿