Mapping d'intégration Pennylane
onnexion à 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) | <p>id, statut, date, numéro, client<br>• Lignes : produit_lié, montant_HT, TVA, devise, quantité, période, description</p> |
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 |
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
Mis à jour le : 08/06/2026
Merci !