Passer au contenu principal

​
Ce que fait cette intégration

À chaque signature d’un devis Qwoty, l’intégration Pennylane crée automatiquement les documents comptables correspondants dans votre espace Pennylane :
  • Devis ponctuel (one-off) → une ou plusieurs factures (selon vos conditions de paiement) ou un devis
  • Abonnements → un abonnement récurrent par phase tarifaire
  • Client inconnu → le client est créé automatiquement dans Pennylane si besoin

​
Prérequis

​
Créer une clé API Pennylane

Rendez-vous dans Paramètres › API dans votre espace Pennylane et créez une clé en mode Read and write avec les scopes suivants :
  • Manage billing subscriptions
  • Manage customer invoices
  • Manage clients
  • Manage quotes
  • Customer mandates
  • ledger accounts
Consultez la documentation Pennylane pour le détail des étapes de création d’une clé API.

​
Configurer un premier numéro de document

Avant d’utiliser l’intégration, Pennylane exige qu’un premier numéro de facture et de devis soit défini dans votre espace, faute de quoi la création de documents échoue. Configurez-les dans Paramètres › Numérotation avant de lancer votre première synchronisation.
Cette étape est requise aussi bien sur la sandbox que sur votre environnement de production. Sans numérotation configurée, l’intégration renvoie une erreur à la création du premier document.

​
Tester sur la sandbox

Pennylane met à disposition un environnement de sandbox pour tester l’intégration sans toucher à vos données de production. Les tests sur sandbox sont recommandés avant la mise en production.
Pensez à configurer aussi la numérotation sur votre sandbox, et à utiliser une clé API sandbox distincte de votre clé de production.

​
Configuration

​
Documents

​
liste
défaut:"Invoice"
requis
Détermine le type de document créé dans Pennylane pour vos devis ponctuels (produits sans abonnement).
Ce paramètre n’a pas d’effet sur les sections abonnement : celles-ci créent toujours un billing_subscription.

​
Factures

​
liste
défaut:"Yes (brouillon)"
requis
Définit si les factures sont créées en brouillon ou finalisées.
Une facture finalisée ne peut plus être modifiée. Utilisez le mode brouillon si vous souhaitez vérifier les montants avant l’envoi.
​
liste
défaut:"No"
requis
Envoie automatiquement la facture au client par e-mail après sa création dans Pennylane.
L’envoi par e-mail utilise le modèle d’e-mail configuré dans Pennylane. Ce paramètre s’applique uniquement aux factures : les devis ne sont jamais envoyés automatiquement par e-mail.

​
Abonnements

​
liste
défaut:"Awaiting validation"
requis
Définit le mode de création des abonnements récurrents dans Pennylane.
​
liste
défaut:"Upon receipt"
requis
Conditions de paiement appliquées aux factures générées par l’abonnement.
​
liste
défaut:"Offline (wire transfer)"
requis
Méthode de paiement associée à l’abonnement.
Si vous choisissez GoCardless direct debit, activez également Send GoCardless SEPA mandate request pour que votre client reçoive automatiquement la demande de mandat.
​
liste
défaut:"No"
requis
Envoie automatiquement une demande de mandat SEPA GoCardless au client après la création de l’abonnement.
Ce paramètre ne fonctionne que si Subscription payment method est réglé sur GoCardless direct debit et que votre compte Pennylane est connecté à GoCardless.

​
Comportements automatiques

​
Création du client

Si le client du devis n’existe pas encore dans Pennylane, il est créé automatiquement avec les informations suivantes :
  • Nom de l’entreprise
  • Adresse de facturation
  • E-mail du contact principal
  • Référence externe (ID Qwoty), qui évite les doublons lors des devis suivants

​
Conditions de paiement et échéances

Si votre devis Qwoty contient des conditions de paiement échelonnées (acompte + solde), l’intégration crée une facture par échéance :
  • Les montants sont calculés proportionnellement au pourcentage de chaque échéance
  • La première facture suit le statut brouillon/finalisé configuré
  • Les factures suivantes sont toujours créées en brouillon

​
Abonnements multiphases

Si votre devis contient un plan tarifaire avec plusieurs phases (par exemple un tarif de lancement puis un tarif standard), l’intégration crée un abonnement par phase dans Pennylane, avec une date de démarrage calculée automatiquement.

​
Remises globales

Les remises globales appliquées à l’ensemble du devis sont reportées sur chaque document Pennylane via le champ discount.

​
Questions fréquentes

Non. L’intégration vérifie d’abord si un client avec la même référence externe (ID Qwoty) existe déjà dans Pennylane. Si c’est le cas, il est réutilisé. Si vous avez renseigné manuellement l’ID Pennylane sur la fiche client dans Qwoty, cette valeur est utilisée directement, sans recherche.
La TVA est lue dans les paramètres de chaque produit dans Qwoty et convertie au format Pennylane (par exemple 20 % → FR_200). Si aucune TVA n’est configurée sur un produit, la ligne est créée exonérée (exempt).
L’intégration crée les deux types de documents indépendamment : une facture (ou un devis) pour la partie ponctuelle, et un abonnement pour la partie récurrente.
Vérifiez que votre espace Pennylane dispose d’un modèle d’e-mail configuré et que l’adresse e-mail du contact principal est renseignée sur le devis Qwoty. L’envoi par e-mail ne fonctionne que pour les factures finalisées : si votre facture est en brouillon, l’e-mail n’est pas envoyé.
Deux conditions sont nécessaires : (1) Subscription payment method doit être réglé sur GoCardless direct debit, et (2) votre compte Pennylane doit être connecté à GoCardless. Si l’une des deux conditions n’est pas remplie, la demande ne peut pas être envoyée.
Dernière modification le 27 octobre 2026