Guide d'intégration Pennylane
Bienvenue dans le guide d’intégration de Penylane avec Fincome. Ce document vous guide étape par étape pour connecter vos données de facturation Penylane à Fincome.
Prérequis
Avant de commencer, assurez-vous que :
Vous êtes administrateur du compte Pennylane
Votre accès API est activé (via une connexion OAuth ou token d’accès)
Vous avez un compte Fincome actif
Vous avez accès aux modules Clients, Produits, Factures, Avoirs, Abonnements
Présentation de l'intégration
L’intégration Pennylane permet de synchroniser automatiquement dans Fincome les entités suivantes :
Clients
Produits & Prix
Abonnements (via modèles de facturation)
Factures & lignes
Avoirs (crédit notes)
Ces données sont exploitées pour alimenter :
Des indicateurs de revenus mensuels (MRR)
Une lecture par abonnement ou facturation ponctuelle
Une reconnaissance de revenu basée sur les périodes
Une analyse de cohorte client
Un suivi des remises, TVA, périodes de facturation
Étapes d'intégration
1. Connexion à Pennylane depuis Fincome
Connectez-vous à votre compte Fincome.
Accédez à l'onglet Données.
Cliquez sur Connecter un nouveau système de facturation :
Sélectionnez Pennylane.
Dans une autre page, connectez vous à votre compte Pennylane.
Allez dans Paramètres entreprise > Connectivité > Développeurs > Générer un token API Choisissez Gestion des ventes en lecture seule.
Copiez cette clé et collez-la sur votre page Fincome.
Validez.
Une fois la connexion établie, la synchronisation initiale démarre automatiquement.
Une fois l’accès validé, la synchronisation initiale démarre automatiquement.
2. Données synchronisées
Clients
ID, nom, email, pays, code postal, référence client
Produits & Prix
Produit : ID, nom
Prix : ID, montant HT, devise (lié au produit)
Abonnements
Récupérés à partir des modèles de facturation (invoice_template)
Incluent : ID, client, statut, dates de début et de fin, montant mensuel
Factures & Lignes
Facture : ID, statut, date, numéro, client
Ligne : produit lié, montant HT, TVA, devise, quantité, période, description
Avoirs (Crédit Notes)
Avoirs extraits des credit_notes rattachés à une facture
Montants inversés (valeurs négatives)
Fonctionnement détaillé de l'intégration
Mapping structuré : toutes les entités sont mappées champ par champ à partir de la structure Pennylane
Détection des abonnements : basée sur les modèles de facturation (invoice_template.line_items)
Montants HT et taxes : analysés ligne par ligne, avec conversion en devise de base
Avoirs intégrés : via les credit_notes de facture, avec montant inversé
Remises fixes : valeur constante 0 (Pennylane ne gère pas de remises ligne à ligne dans la structure actuelle)
Périodes de service : extraites automatiquement (period_start, period_end)
Support du multi-adressage : pays et codes postaux extraits depuis plusieurs sources prioritaires
À savoir
Factures en brouillon (is_draft) : non synchronisées
Remises : non remontées actuellement (champ forcé à 0)
Synchronisation quotidienne : toutes les nuits automatiquement
Suppression de données dans Pennylane : non propagée dans Fincome
Références personnalisées : supportées via le champ reference des clients
Vue d'ensemble de l'intégration
Élément
Détail
Méthode d’intégration
OAuth 2.0 ou clé API Pennylane
Entités prises en charge
Clients, Produits, Prix, Abonnements, Factures, Avoirs
Fréquence de synchronisation
Quotidienne (nuit)
Portée de l’import initial
Données disponibles via API
Méthode de synchronisation
API REST avec pagination
Suppression de données Pennylane
Non supportée
Paramètres de données
Comportement / Réglage
Fonctionnement dans Fincome
Pays / Code postal client
Détection via plusieurs champs prioritaires (country_alpha2, etc.)
Abonnements
À partir des modèles de facturation (template)
Montants HT / taxes
Champs currency_price_before_tax, currency_tax
Avoirs
Lignes inversées, avec structure identique aux factures
Remises
Non disponibles (remontées à 0)
Conversion de devise
Basée sur currency et date
Périodes de facturation
period_start, period_end extraits par Fincome
Mapping technique (Pennylane → Fincome)
Clients
Champ Pennylane
Champ Fincome
source_id
original_id
name
name
country_alpha2, billing_address.country_alpha2, delivery_address.country_alpha2
country
postal_code, billing_address.postal_code, delivery_address.postal_code
zip_code
reference
custom_axis_field.reference
Produits & Prix
Champ Pennylane
Champ Fincome
source_id
original_id (produit & prix)
label
name (produit & prix)
price_before_tax
amount
currency
currency_code
Abonnements
Champ Pennylane
Champ Fincome
invoice_template.line_items[].product_id
price_id
invoice_template.currency
currency_code
invoice_template.line_items[].subscription_set_id
subscription_set_id
start
subscription_start_date
stopped_at
canceled_at
finish
effective_cancellation_date
activated_at
deal_closed_date
Calculé
monthly_value, monthly_value_main
Factures & Lignes
Champ Pennylane
Champ Fincome
id
original_id (facture)
date
date
invoice_number
invoice_number
status
status
customer.source_id
customer_id
Lignes de facture
Champ Pennylane
Champ Fincome
id
original_id (ligne)
product_id
price_id
currency_price_before_tax
amount_excluding_tax_after_discount
currency_tax
tax_amount
label
description
quantity
quantity
currency
currency_code
Calculé
amount_excluding_tax_after_discount_main, tax_amount_main
Périodes
period_start, period_end
Avoirs
Champ Pennylane
Champ Fincome
credit_notes[].id
original_id
currency_price_before_tax
amount (inversé)
currency_tax
tax_amount (inversé)
currency
currency_code
Montant remisé
discount_amount = 0 (forcé)
Avoir rattaché à facture
credit_note_id, invoice_id
Besoin d’aide ?
Notre équipe support est disponible via le chat de l’application ou par email : [email protected]
Prochaines étapes
Consultez vos KPIs dans les vues MRR, Churn, et Cohortes
Ajoutez d’autres sources de facturation (Stripe, Chargebee, etc.)
Enrichissez vos données clients (segmentation, taille d’entreprise...)
Planifiez une session avec votre Customer Success pour aller plus loin
Mis à jour