Réceptionner une demande de devis

L'événement déclencheur : open / requested
Lorsque vous recevez cet événement, cela signifie qu'un client attend une proposition de votre part.
Comment réceptionner la demande ?Vous avez deux méthodes pour être informé d'une nouvelle demande de devis :
Webhooks: C'est la méthode la plus efficace. Votre système est notifié en temps réel à chaque fois qu'un client vous demande un nouveau devis.
Polling: Si vous ne pouvez pas utiliser les webhooks, vous pouvez interroger notre API à intervalle régulier pour récupérer les nouvelles demandes de 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 à une demande de devis de votre client.
Le "type": "operations:quotation:share" vous indique qu'il s'agit d'un webhook concernant une création d'un objet quotation.
[
  {
    "type": "operations:quotation:share",
    "id": "471b155d-09ac-4ec6-a83a-70b3b8695738",
    "event": {
        "type": "operations",
        "body": {
            "id": "57f398b4-f61e-4f0b-bdaf-f4a2f5e172b6",
            "reference": "Devis-GC1012501",
            "contractReference": "MTK1",
            "type": "quotation",
            "description": "Nous avons besoin d'un devis pour le remplacement de la baignoire",
            "status": "open",
            "event": "requested",
            "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-GC1012501?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&status=open&event=proposed
En fonction de vos besoins et de vos process, les paramètres de la requête peuvent être affinés.
Prochaine étapeUne fois que vous avez bien réceptionné le demande devis, l'étape suivante pour vous est de préparer et d'envoyer votre proposition. Pour cela, veuillez suivre la procédure ﻿ ⁠⁠Proposer un devis⁠  
﻿