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.

Webhook

Exemple d'un webhook reçu suite à une demande de devis de votre client.
[
{
"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"
}
}
}
]

Polling

Exemple 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 étape

Une 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