Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Vue d’ensemble

L’intégration Stripe — Facture crée une facture Stripe à partir des lignes d’un devis Qwoty et peut optionnellement la finaliser et la livrer à votre client. Selon vos paramètres, la facture peut être envoyée directement via Stripe, ou associée à un lien de paiement Stripe Checkout et livrée par email via Qwoty avec le PDF de la facture en pièce jointe.

​
Authentification

Allez dans Tableau de bord Stripe → Développeurs → Clés API et copiez votre clé secrète (sk_live_... en production, sk_test_... en mode test). La clé secrète nécessite les permissions Stripe suivantes :
  • Customers — lecture et écriture (créer, rechercher)
  • Invoices — lecture et écriture (créer, finaliser, envoyer, attacher un paiement)
  • Invoice items — écriture (créer)
  • Tax rates — lecture et écriture (lister, créer)
  • Checkout Sessions — écriture (créer)
  • Webhook endpoints — lecture et écriture (lister, créer)
Deux portées de jeton sont disponibles selon votre organisation : Workspace — une seule clé Stripe partagée entre tous les devis. Saisissez-la dans le champ Jeton API Workspace. Business unit — une clé Stripe différente par business unit. Saisissez un map JSON dans le champ Jetons API Business unit : 
{
  "business_unit_id_1": "sk_live_...",
  "business_unit_id_2": "sk_live_..."
}
En mode Business unit, le devis doit être associé à une business unit dont l’ID est présent dans le map. Sinon, la facture ne sera pas créée.

​
Comportement

​
Client

L’intégration trouve ou crée automatiquement un client Stripe pour chaque devis :
  1. Si un ID client Stripe est déjà enregistré sur le contact Qwoty (external_ids.accounting), il est utilisé directement.
  2. Sinon, une recherche est effectuée dans Stripe — d’abord par UUID du contact Qwoty, puis par email de facturation.
  3. Si aucune correspondance n’est trouvée, un nouveau client Stripe est créé avec le nom, l’email et l’adresse de facturation du contact. L’ID client Stripe est ensuite enregistré sur le contact Qwoty pour une utilisation future.

​
Lignes de facture

Un article de facture Stripe est créé pour chaque produit facturable dans les sections product du devis. Si un article a une remise, un second article négatif est ajouté sur la même ligne. Les remises globales sur le devis sont ajoutées comme un seul article négatif en bas de facture.
Seules les sections de type product sont incluses. Les sections récurrentes (plan) ne sont pas prises en charge dans cette intégration.

​
Taxes

Les taux de taxe sont résolus automatiquement pour chaque ligne :
  1. Si un ID de taux de taxe Stripe est déjà enregistré sur la taxe Qwoty (external_ids.accounting), il est utilisé directement.
  2. Sinon, l’intégration recherche les taux de taxe Stripe existants par pourcentage et pays (analysé depuis le format api_name Qwoty — par ex. vat_fr_200 → France, 20%).
  3. Si aucune correspondance n’est trouvée, un nouveau taux de taxe est créé dans Stripe et son ID est enregistré dans Qwoty.
Les taux de taxe sont toujours exclusifs (prix affichés hors taxes).

​
Statut de la facture

Si Créer la facture en Brouillon, la facture est créée mais pas finalisée. Aucun email ni lien de paiement n’est envoyé quels que soient les autres paramètres. Si Créer la facture en Ouverte, la facture est finalisée et l’une des actions suivantes est déclenchée :

​
Actions post-finalisation

ParamètreAction
Envoyer la facture par email (via Stripe)Stripe envoie la facture finalisée directement à l’email du client.
Envoyer le lien de paiement + facture (via Qwoty)Un lien de paiement Stripe Checkout est créé pour le montant du premier acompte. Un email est envoyé via Qwoty avec le PDF de la facture en pièce jointe et un lien de paiement. Une fois le paiement effectué, la Checkout Session est automatiquement attachée à la facture via un webhook Stripe.
Si les deux options sont désactivées, la facture est finalisée mais pas envoyée.
L’option Envoyer le lien de paiement + facture nécessite l’enregistrement d’un webhook Stripe. L’intégration gère cela automatiquement lors de la première utilisation — aucune configuration manuelle n’est nécessaire.

​
Paramètres

ParamètreValeursPar défautDescription
Créer la facture enBrouillon / OuverteBrouillonBrouillon : la facture est créée mais pas finalisée. Ouverte : la facture est finalisée immédiatement.
Envoyer la facture par email (via Stripe)Oui / NonNonStripe envoie la facture finalisée au client. Actif uniquement quand la facture est Ouverte.
Envoyer le lien de paiement + facture (via Qwoty)Oui / NonNonEnvoie un lien de paiement Stripe Checkout et le PDF de la facture par email. Actif uniquement quand la facture est Ouverte.
Méthode de paiementDéfaut StripeDéfaut StripeMéthodes de paiement présentées au client sur la page Checkout.

​
Exemples

Devis accepté — 4 acomptes de 2 275,50 € Le devis a 4 acomptes. L’intégration crée une facture Stripe pour le montant total et envoie un lien de paiement Checkout pour le premier acompte (2 275,50 €) par email.
ChampValeur
Total facture9 102,00 €
Premier acompte2 275,50 € (25%)
Montant du lien de paiement2 275,50 €
PDF jointPDF de la facture Stripe
Expiration du lien24 heures
Une fois que le client a payé la Checkout Session, le paiement est automatiquement attaché à la facture. Le statut de la facture passe à partially_paid, et les acomptes suivants peuvent être envoyés de la même manière.