Proposer un devis

Pour soumettre un devis, le processus se déroule en deux étapes : vous devez d'abord créer la proposition formelle via un log, puis envoyer le document PDF qui y sera associé.

Étape 1 : Soumettre la proposition formelle

Vous commencez par poster un log avec le statut open et l’event proposed. Cet appel crée l'enregistrement du devis dans le système et contient les métadonnées principales de votre offre.
Endpoint : POST /quotations/logs
Body de la requête (JSON) :
{
  "reference": "Devis-1234",
  "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 suite à notre échange sur le remplacement de la salle de bain"
}

Important : L'ajout des tags est impératif.
  • devis_montant : Doit correspondre au montant total HT du devis. Utilisez un point (.) comme séparateur décimal.
  • devis_reference : Doit correspondre à la référence unique de votre devis.

Étape 2 : Envoyer le document PDF du devis

Ensuite, vous postez le fichier de votre devis au format PDF en utilisant l'API documents v1.0