> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.fincome.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Importer mon fichier

Une fois votre fichier de facturation correctement structuré, vous pouvez l'importer dans Fincome pour alimenter automatiquement vos indicateurs clés : MRR, ARR, churn, revenue recognition, etc.

## 1. Méthodes d'import disponibles

### Option A — Fichier Excel (.xlsx)

1. Téléchargez le modèle Excel depuis Fincome : **Réglages → Connecter un système de facturation → Importer un fichier .xlsx**
2. Remplissez le fichier avec vos données de facturation selon les règles vues dans [Préparer mon fichier](https://help.fincome.co/fr/article/preparer-mon-fichier-1t99smj/).
3. Importez directement votre fichier `.xlsx` dans Fincome. Renseignez bien la « Date jusqu'à laquelle porte l'import » avec la dernière date d'émission de facture (soit la date de la colonne « date » la plus proche du jour).

| Astuce : commencez par un test avec 5 à 10 lignes pour valider le format avant d'importer tout votre historique.

### Option B — Google Sheet (recommandé si < 100 000 lignes)

https://app.guideflow.com/embed/5pvylxswpn

1. Importez le modèle sur votre compte Google : **Réglages → Connecter un système de facturation → Synchroniser un document Google Sheet.**
2. Remplissez le fichier avec vos données de facturation selon les règles vues dans [Préparer mon fichier](https://help.fincome.co/fr/article/preparer-mon-fichier-1t99smj/).
3. Vous pouvez vérifier votre fichier avec le bouton « Check file ».
4. Partagez le fichier, en lecture seule, à notre compte Fincome : fincome-ggsheet-connector-prod@fincome-ggsheet-connector-prod.iam.gserviceaccount.com
5. Collez le lien sur la page Fincome.

Au premier lancement, une autorisation vous sera demandée.

## 2. Charger le fichier dans Fincome

https://app.guideflow.com/embed/9r2y14daok

1. Connectez-vous à Fincome puis allez dans : **Réglages → Connecter un système de facturation → Importer un fichier .xlsx**
2. Nommez la **source** (ex. « Historique 2023 » ou « Import Stripe complémentaire »).
3. Sélectionnez la **date de fin d'import**.
4. Importez votre fichier Excel.
5. Fincome analyse automatiquement la structure et valide la conformité.
6. Si votre fichier contient des erreurs, l'import n'est pas validé : Fincome affiche un message vous invitant à consulter le **fichier d'erreurs**. Ce fichier, téléchargeable directement sur la page d'import (à l'endroit où vous chargez votre fichier), ne contient **que les lignes en erreur**, avec le motif de chaque erreur.
7. Utilisez ce fichier comme **référence** pour repérer ce qui doit être corrigé. Les corrections ne se font **pas** dans le fichier d'erreurs, mais dans votre fichier d'import d'origine : supprimez le fichier que vous venez d'importer, corrigez votre fichier d'origine à l'aide du fichier d'erreurs, puis réimportez-le.

## 3. Dépannage : erreurs fréquentes

Le tableau ci-dessous aide à interpréter les motifs d'erreur listés dans le fichier d'erreurs.

| Message d'erreur | Interprétation | Solution |
| --- | --- | --- |
| **Informations client/facture incohérentes** | Un même ID (`invoice_id`, `customer_id`) contient des attributs différents | Harmonisez les champs sur toutes les lignes concernées |
| **Type invalide** | Valeur non reconnue dans la colonne `type` | Utilisez uniquement `subscription`, `one_off` ou `future_sub` |
| **Période invalide** | `period_start` ≥ `period_end` ou dates au format texte | Vérifiez le format Excel et l'ordre chronologique |
| **Statut invalide** | Statut de facture ou d'abonnement non autorisé | Corrigez selon les valeurs acceptées (`open`, `paid`, etc.) |
| **Dates rejetées** | Valeurs non reconnues comme dates Excel | Reconvertissez la colonne en type **Date (JJ/MM/AAAA)** |
| **Montant non numérique** | Cellules contenant du texte au lieu d'un nombre | Reformatez la colonne en **Nombre**, sans séparateur de milliers |

| Conseil : pour identifier rapidement un problème, testez avec un mini-fichier de 3 à 5 lignes avant de réimporter l'ensemble.

## 4. Contrôles post-import

Une fois le fichier importé et validé, vous pouvez vérifier la cohérence des données :

1. **Comparez vos indicateurs avant/après import** : MRR, ARR, churn, revenu total.
2. **Ouvrez le tableau de bord Revenus** pour distinguer les revenus ponctuels des récurrents.
3. **Explorez la section « Mouvements MRR »** pour analyser les upsells, churns ou erreurs éventuelles.
4. Si besoin, ajustez des lignes directement dans Fincome (voir Ajuster et corriger des lignes de facture).

Vous pouvez suivre [ces étapes](https://help.fincome.co/fr/article/cadrer-ses-chiffres-myc6l2/).

## 5. FAQ — Import et validation

**Comment éviter les doublons lors d'un ré-import ?**
Utilisez des **identifiants stables** (`customer_id`, `subscription_id`, `invoice_id`). Pour corriger des lignes déjà importées, réimportez le même fichier avec les champs mis à jour : Fincome remplacera automatiquement les données existantes. Vous pouvez également supprimer le jeu de données précédent, le compléter et le réimporter.

**Peut-on simuler l'import avant l'application en production ?**
Oui. Importez un **fichier d'essai** avec quelques lignes : vous pourrez ensuite le supprimer sans impact. Un **modèle d'exemple** est disponible dans **Réglages → Connecter un système de facturation → Importer un fichier .xlsx**, puis cliquez sur **Télécharger le template**.

**Qui peut réaliser un import et où trouver la documentation complète ?**
Seuls les **administrateurs Fincome** disposent des droits d'import. Si le menu n'apparaît pas, contactez l'administrateur de votre instance ou votre CSM.

**Comment sont sécurisées nos données lors de l'import ?**
Les échanges sont protégés par des connexions **chiffrées en transit et au repos**. Aucune donnée n'est partagée avec des tiers sans votre accord. Ces garanties s'inscrivent dans notre cadre de sécurité validé par la certification **SOC II Type 1**.

**Que faire si l'outil signale « Période invalide » alors que mes dates semblent correctes ?**
Vérifiez :

- que le **format de cellule** est bien « Date » (pas texte) ;
- qu'aucun **espace ou caractère parasite** n'est présent ;
- que `period_start` est **antérieur à** `period_end` ;
- que les fuseaux horaires de vos exports n'ont pas décalé les dates (cas fréquent avec les horodatages).

**Peut-on suivre le CARR/CMRR selon les dates de fin de remise ou les paliers tarifaires ?**
Oui. Fincome prend en charge le suivi des **paliers (ramp-ups)** et des **fins de remise**. Assurez-vous simplement que les périodes sont correctement segmentées dans vos lignes d'abonnement.

**Après l'import, comment m'assurer de la cohérence des chiffres ?**
Depuis votre espace Fincome : comparez le **MRR/ARR total** avant/après import, vérifiez la **ventilation par client, plan et devise**, et consultez la section **Mouvements MRR** pour détecter d'éventuelles incohérences (churns, montées de plan, etc.).