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

É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
email	email
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

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
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

---

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