Créer et envoyer un devis
Comment créer et envoyer un devis, puis le marquer comme accepté.
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 prospects et clients existants le coût de produits et/ou de services qu’ils envisagent d’acquérir. Ils modélisent le coût d’une facture ponctuelle ou celui d’un abonnement. Lorsqu’un devis que vous lui avez communiqué est accepté par votre prospect ou client, Stripe crée automatiquement les factures et abonnements correspondants. De nombreux flux de vente font usage de cet outil commun.
Créer un clientCôté serveur
Pour créer un devis, transmettez un poste pour chaque produit ou service. Associez un objet Customer au devis, représentant votre client. Après avoir créé le client, stockez la valeur id dans votre base de données pour pouvoir la réutiliser ultérieurement. À l’étape suivante, vous utiliserez ce client pour créer un devis.
Créer un devisCôté serveur
Pour créer un devis, transmettez le client et les postes de votre choix. Les objets Price vous permettent de modéliser les offres que vous proposez. Pour pouvoir utiliser ces objets dans vos devis, découvrez comment configurer votre catalogue de produits.
Vous ajoutez chacune de vos offres pertinentes à votre devis en tant que poste en spécifiant le tarif et la quantité voulus. Prenons l’exemple d’un devis que vous créez pour l’octroi de licences mensuelles de l’un de vos logiciels et incluant des frais initiaux de conseil pour l’installation du logiciel. Votre devis comprendra dans ce cas deux postes :
- Le premier poste chiffre le coût de cinq licences de votre logiciel, facturées à hauteur de 100 USD par mois et par licence.
- Le second poste chiffre vos frais de consulting ponctuels, facturés 1 000 USD.
Les devis que vous créez prennent automatiquement l’état draft. Vous pouvez modifier les brouillons de devis en ajoutant ou en supprimant des postes.
Envoyer un devisCôté serveur
Une fois prêt(e) à envoyer votre devis à votre client, vous pouvez le faire passer à l’état open en le finalisant. Dans la mesure où le devis est destiné à un client spécifique, vous devez y associer un objet Customer object avant qu’il ne bascule sur le nouvel état.
Une fois le devis finalisé, vous pouvez le télécharger au format PDF afin d’en obtenir un aperçu. Envoyez-le par e-mail à votre client en tant que pièce jointe.
Vous pouvez également définir un en-tête (header), un pied de page (footer) et une description pour votre devis. Ces éléments seront affichés dans le PDF. Vous pouvez définir des options par défaut pour les paramètres header, footer et description dans le modèle de devis. Veillez à conserver le devis à l’état open tant que votre client ne l’a pas accepté.
Marquer un devis comme acceptéCôté serveur
Une fois que le client a accepté le devis, faites-le passer à l’état accepted. Cette action aura pour effet de créer automatiquement une facture ou un abonnement (selon que vous avez ajouté ou non des postes avec un tarif récurrent). Lorsque vous utilisez un devis pour un paiement ponctuel, Stripe crée une facture à l’état draft. Vous pouvez apporter des modifications à votre facture avant de l’envoyer à votre client.
FacultatifConvertir un devis en abonnementCôté serveur
Pour créer un abonnement sur la base d’un devis, vous devez ajouter au moins un poste dont le tarif est récurrent. Dès lors, le devis génèrera automatiquement un abonnement lorsqu’il basculera sur l’état accept. Si le paramètre recurring d’un devis n’est pas défini sur null, alors Stripe crée un abonnement ou une planification d’abonnement une fois que le client a accepté le devis.
Pour personnaliser l’abonnement, vous pouvez spécifier sa configuration à l’aide du paramètre subscription_data. Par exemple, vous pouvez souhaiter que l’abonnement débute par une période d’essai. Il vous suffit dans ce cas de configurer le paramètre trial_period_days pour définir la durée de cette période d’essai.
Vous pouvez collecter les données de paiement de votre client en amont. Si votre client n’a pas de payment_method enregistré et que vous prévoyez de le débiter automatiquement définissez le paramètre collection_method du devis charge_.
Stripe crée un abonnement avec l’état active et la première facture prend l’état draft, avec auto_. Nous finalisons automatiquement la facture au bout d’une heure et l’état de l’abonnement est mis à jour en conséquence.
Créer une planification d’abonnement sur la base d’un devis
Si vous voulez que votre abonnement ne débute qu’à une date donnée dans le futur, créez une planification d’abonnement. Par exemple, vous pouvez souhaiter que l’abonnement débute le premier jour du mois suivant. Définissez le paramètre effective_date sur la date d’entrée en vigueur de l’abonnement :