Gestion des devis

Répertoire

Le concept : Un processus événementiel

La gestion d'un devis sur notre plateforme est conçue comme un échange d'événements (appelés "logs") entre le système du client (le gestionnaire immobilier) et celui du prestataire. Chaque action importante (demande, proposition, acceptation, refus) est matérialisée par un log envoyé via l'API, créant ainsi un historique complet et traçable sur un objet appelé quotation.
Le point d'accès central pour la gestion des devis est l'API operations v2.

Le flux des statuts

Chaque log est défini par la combinaison unique d'un status (open ou closed) et d'un event (requested, proposed, etc.). Le tableau ci-dessous décrit chaque combinaison possible et son rôle dans le cycle de vie du devis.
Status / Event
Flux de données (côté Prestataire)
Description de l'étape
open / requested
GET / Webhook
Le client demande un devis pour une intervention.
open / proposed
POST
Le prestataire soumet sa proposition de devis.
open / acknowledged
GET / Webhook
Le système du client confirme la bonne réception de la proposition.
open / precisions_requested
GET / Webhook
Le client demande une modification ou des précisions.
open / updated
POST
Le prestataire soumet une nouvelle version de son devis.
closed / accepted
GET / Webhook
Check Mark Button Succès ! Le devis est accepté par le client.
closed / rejected
GET / Webhook
Cross Mark Le devis a été refusé par le client.
closed / canceled
GET / Webhook
Cross Mark Le client a annulé sa demande de devis.
closed / canceled_order
GET / Webhook
Cross Mark Le client a annulé sa commande