Mapping d'intégration Pennylane
Connexion à Pennylane
Suivez ce guide pour établir la connexion à l'API Pennylane.
Données synchronisées
Entité
Champs clés synchronisés
Clients
id, nom, email, pays, code_postal, référence_client
Produits (Products)
id, nom
Prix (Prices)
id, montant_HT, devise (lié_au_produit)
Abonnements (Subscriptions)
id, client lié, statut, dates de début et de fin, montant_mensuel
Factures (Invoices)
id, statut, date, numéro, client • Lignes : produit_lié, montant_HT, TVA, devise, quantité, période, description
Avoirs (Crédit Notes)
Extraits des credit_notes rattachés à une facture
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é
Périodes de service : extraites automatiquement (period_start, period_end)
À 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
Synchronisation incrémentale non supportée: les données doivent être extraites en intégralité
Vue d'ensemble de l'intégration
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
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
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
source_id
original_id (produit & prix)
label
name (produit & prix)
price_before_tax
amount
currency
currency_code
Abonnements
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
Factures & Lignes
id
original_id (facture)
date
date
invoice_number
invoice_number
status
status
customer.source_id
customer_id
Lignes de facture
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
Périodes
period_start, period_end
Avoirs
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
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