Fonctionnement des devis
Découvrir le cycle de vie d'un devis.
Remarque
Vous pouvez utiliser les devis dans un environnement de test. Si vous souhaitez finaliser, télécharger ou accepter des devis en mode production pour des factures ponctuelles via l’API ou le Dashboard, vous devez passer à Invoicing Plus. Découvrez l’offre qui vous convient le mieux.
Les devis vous permettent de communiquer à vos clients un chiffrage estimatif du coût de biens ou de services qu’ils envisagent d’acquérir et simplifient la négociation avant le démarrage d’un abonnement ou d’une facture.
Les différents états d’un devis reflètent le flux qu’il suit typiquement depuis sa création – avec spécification des postes chiffrant l’offre proposée, ainsi que des éventuelles ristournes pratiquées et des taxes applicables – jusqu’à l’envoi du devis au client potentiel et à la mise en service après acceptation du devis.
| État | Description | Actions possibles |
|---|---|---|
draft | État initial de tous les devis. À ce stade, il est toujours possible de modifier le devis. | Finaliser le devis en le basculant sur open ou l’annuler. |
open | Le devis a été finalisé et un retour du client est à présent attendu. Seule la date d’expiration est encore modifiable à ce stade. | Marquer le devis comme accepted ou l’annuler. |
accepted | Le client a accepté le devis. Une facture, un abonnement ou une planification d’abonnement a été généré(e) sur la base du devis. | S.O. |
canceled | Le devis a expiré ou a été annulé. Il ne peut plus être accepté. | S.O. |
Devis annulés
Lorsqu’un client rejette un devis ou que vous ne considérez plus votre devis comme valide, vous pouvez l’annuler. Un devis annulé ne peut plus être accepté. Les devis à l’état draft ou open sont automatiquement annulés dès lors que leur date d’expiration est atteinte. Stripe génère un webhook quote..
Devis acceptés
Une fois que le client a accepté votre devis, vous pouvez le marquer comme accepté. Les devis acceptés génèrent automatiquement une facture, un abonnement ou une planification d’abonnement, selon qu’il comporte ou non des postes récurrents ou que la date d’entrée en vigueur de la prestation se situe dans le futur.
Changements d’état
Les devis peuvent changer d’état comme suit :
| État | Endpoint d’API | Webhook émis | État final |
|---|---|---|---|
draft | POST /v1/quotes/:id/cancel | quote. | canceled |
draft | POST /v1/quotes/:id/finalize | quote. | open |
open | POST /v1/quotes/:id/cancel | quote. | canceled |
open | POST /v1/quotes/:id/accept | quote. | accepted |
Finaliser un brouillon de devis
Les devis créés prennent initialement l’état draft. Tant qu’ils conservent cet état, vous restez en capacité de leur apporter toutes les modifications que vous souhaitez. Une fois prêt à envoyer votre devis à votre client, vous pouvez le finaliser. Cette action le fait basculer à l’état open et votre devis conserve cet état jusqu’à réception du retour de votre client.
La finalisation d’un devis a également pour effet de lui attribuer un number. Ce numéro se compose de quatre éléments : le préfixe QT, le préfixe de facture du client, le numéro de référence du devis et le numéro de référence de la révision. Le premier devis généré pour un client, dans sa première révision, prendra ainsi un numéro du type QT-68BB114-0001-1. Et une deuxième révision de ce même devis sera quant à elle numérotée QT-68BB114-0001-2. QT-68BB114-0002-1 sera le deuxième devis du client.
La finalisation d’un devis via l’API s’effectue comme suit :
Accepter un devis
Seuls les devis à l’état open peuvent être marqués comme étant acceptés. Cette opération fait basculer le devis sur accepted et déclenche la création de la facture, de l’abonnement ou de la planification d’abonnement.
Si aucun des postes du devis n’est un poste récurrent, un brouillon de facture à l’état draft est créé sur la base du devis et auto_ est défini sur false. S’il y a lieu, vous pouvez apporter des modifications à votre facture avant de la finaliser et de l’envoyer à votre client pour paiement.
Si votre devis comporte au moins un poste récurrent, un abonnement ou une planification d’abonnement est alors créé(e) : une planification d’abonnement si la date d’entrée en vigueur du devis se situe dans le futur ; et un abonnement si ce n’est pas le cas. La première facture générée pour l’abonnement prend l’état draft et auto_ est défini sur true.
Dans le Dashboard, vous pouvez marquer un devis comme étant accepté avec le bouton Convertir en facture ou le bouton Convertir en abonnement de la page de détail du devis. Vous pouvez marquer un devis comme accepté dans l’API, comme illustré ci-dessous.
Annuler un devis
Vous pouvez annuler un devis dès lors qu’il est à l’état draft ou open. Annulez un devis depuis le Dashboard sur la page des détails du devis ou en utilisant l’API comme illustré dans l’exemple suivant.
Télécharger un devis au format PDF
La méthode PDF fonctionne différemment de la majorité des méthodes SDK auxquelles vous êtes habitué, qui renvoient généralement des données au format JSON. Au lieu de cela, la méthode PDF produit un résultat unique.
Elle renvoie directement un flux de données qui représente les séquences d’octets des données entrantes.
En effet, au lieu d’attendre que l’intégralité de l’ensemble de données soit chargé avant de devenir disponible, le flux d’octets peut être lu par ‘chunks’ ou segments au fur et à mesure de l’arrivée des données.
Cette méthode est particulièrement utile pour la manipulation de données volumineuses ou le traitement de données en temps réel, car vous pouvez commencer à traiter les données entrantes avant que le chargement de l’intégralité des données ne soit terminé.