Quotes

Lister les devis

Retourne la liste paginée des devis du client (cursor v2). Tri stable created_at DESC, id DESC.

Les devis archivés (archived_at IS NOT NULL) sont exclus par défaut — l'API publique ne les expose pas. Pour récupérer un devis archivé, utiliser le dashboard.

Filtres

• ?status — filtre exact (draft, sent, signed, cancelled)

curl -X GET 'https://api.capturia.io/v1/quotes' \
  -H 'Authorization: Bearer cap_live_<your-key>' \
  -H 'Content-Type: application/json'

Créer un devis

Crée un devis en brouillon (status="draft") par le même point de création que le dashboard : Capturia attribue le numéro (quote_number, séquence du compte, jamais de doublon) et pose les défauts du compte (validité, conditions de paiement, profil de taxes, politique de dépôt). Un quote_number fourni est refusé (400 validation_error, raison read_only).

contact_id rattache le devis à sa fiche (/v1/contacts) : chaque champ prospect_* absent est lu de la fiche, chaque champ fourni prime. line_items écrit les lignes dans la même opération ; les montants sont calculés par le serveur. Pour envoyer le devis au prospect, utiliser POST /v1/quotes/{id}/send.

Idempotency

Le header Idempotency-Key est optionnel mais recommandé : une reprise après un délai dépassé ne crée jamais un second devis. Une 2e requête avec la même clé et le même payload renvoie la réponse d'origine ; la même clé avec un payload différent retourne 409 idempotency_conflict. Un refus (400, 403, 404) n'est pas mémorisé : la clé reste utilisable.

curl -X POST 'https://api.capturia.io/v1/quotes' \
  -H 'Authorization: Bearer cap_live_<your-key>' \
  -H 'Content-Type: application/json' \
  -d '{
  "contact_id": "5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a",
  "valid_until": "2026-06-30",
  "payment_terms": "Net 30",
  "line_items": [
    {
      "description": "Remplacement de la toiture",
      "quantity": 1,
      "unit_price": 9500
    }
  ]
}'

Mettre à jour un devis

Met à jour les champs fournis du devis (champs absents conservés). Au moins un champ doit être fourni sinon 400 no_fields.

Les montants (subtotal, tps_amount, tvq_amount, total) ne sont pas éditables via PATCH — calculés serveur-side à partir des blocks (gérés via le dashboard).

status n'accepte que declined (le prospect a refusé) et cancelled : un devis passe à sent par POST /v1/quotes/{id}/send (le courriel part), à viewed et signed par le prospect, à expired par sa date de validité. Un devis signé, payé ou déjà clos ne se clôt plus (409 status_locked). La clôture se fait seule : status combiné à d'autres champs retourne 400 validation_error (raison exclusive_field).

Les devis archivés (archived_at IS NOT NULL) ne sont pas modifiables — retourne 404 resource_not_found.

curl -X PATCH 'https://api.capturia.io/v1/quotes/{id}' \
  -H 'Authorization: Bearer cap_live_<your-key>' \
  -H 'Content-Type: application/json' \
  -d '{
  "prospect_name": "Alexandre Tremblay",
  "valid_until": "2026-07-31",
  "payment_terms": "Net 60"
}'

Envoyer un devis au prospect

Envoie le devis par courriel au prospect, par le même service que le bouton « Envoyer » du dashboard : expéditeur du vendeur assigné (sinon de l'entreprise), lien vers la page publique du devis, puis status="sent" et sent_at. Seul un brouillon s'envoie ; rien ne repart d'un devis déjà envoyé.

Un devis sans fiche de contact (prospect saisi sans fiche) est d'abord relié à la fiche du prospect : retrouvée par son courriel ou son numéro, sinon créée — jamais un doublon. Le courriel ouvre alors son fil dans l'Inbox. La fiche créée reste dans le compte de la clé, et sa création déclenche les automatisations et la synchronisation CRM d'une nouvelle fiche.

Refus

• 409 already_signed : le devis est signé.
• 409 quote_cancelled : le devis a été annulé.
• 409 already_sent : le devis a déjà été envoyé.
• 409 quote_status_changed : le devis n'est plus un brouillon (par exemple expiré).
• 409 send_in_progress : un envoi de ce devis est déjà en cours.
• 409 send_outcome_unknown : un envoi précédent n'a pas pu être confirmé ; il n'est pas refait.
• 409 recipient_unsubscribed : le prospect s'est désabonné.
• 409 sender_unavailable : le vendeur assigné n'a pas d'adresse d'envoi valide.
• 422 no_prospect_email / 422 invalid_prospect_email : courriel du prospect absent ou invalide.
• 422 unpriced_lines, 422 untaxed_quote, 422 deposit_not_payable : garde de contenu.

Aucun body n'est requis.

curl -X POST 'https://api.capturia.io/v1/quotes/{id}/send' \
  -H 'Authorization: Bearer cap_live_<your-key>' \
  -H 'Content-Type: application/json'