# Format des fichiers d Tous les imports d'Altoviz partagent le même lecteur de fichier. Cette page décrit ce qu'il accepte ; les colonnes propres à chaque import sont détaillées sur sa page. ## Formats de fichier | Format | Extension | Remarque | | ----------------------- | --------- | ----------------------------------------------------------- | | **CSV (Point virgule)** | `.csv` | Le format par défaut, et celui qu'Excel produit en français | | **CSV (Virgule)** | `.csv` | Le CSV anglo-saxon | | **Microsoft Excel** | `.xlsx` | La première feuille du classeur est lue | L'import des opérations bancaires accepte en plus les formats bancaires **OFX**, **QIF**, **CAMT**, **CFONB 120** et **CFONB 240**, qui n'ont pas de colonnes à décrire : leur structure est fixée par la norme. ## Encodage | Choix | Quand l'utiliser | | ---------------- | ---------------------------------------------------------------- | | **Auto** | Par défaut. Convient dans la quasi-totalité des cas | | **UTF-8** | Le standard actuel, produit par la plupart des logiciels récents | | **Windows-1252** | Un export d'un logiciel Windows ancien | | **ISO 8859-1** | Idem, variante Latin-1 | Un encodage mal choisi ne fait pas échouer l'import : il abîme les accents. Si l'aperçu de l'étape 2 affiche `Société` au lieu de `Société`, revenez en arrière et forcez **UTF-8**. ## Région La région détermine la lecture des **nombres** et des **dates** : | Région | Séparateur décimal | Dates | | --------------------------- | ---------------------- | --------------- | | **France** | la virgule — `1234,56` | jour/mois/année | | **États-Unis / Angleterre** | le point — `1234.56` | année-mois-jour | En pratique le lecteur est tolérant et essaie les deux conventions, mais un fichier ambigu — `1.234` peut être « mille deux cent trente-quatre » ou « un virgule deux cent trente-quatre » — est tranché par ce réglage. ## Les types de données Chaque colonne des tableaux d'import renvoie à l'un de ces types. ### Texte Repris tel quel. Un texte contenant le séparateur, un guillemet ou un retour à la ligne doit être entouré de guillemets doubles : `"94, avenue du Paradis"`. ### Nombre Le point et la virgule sont acceptés comme séparateur décimal, quelle que soit la région choisie : `19.50` et `19,50` donnent le même résultat. Pas de séparateur de milliers, pas de symbole monétaire. ### Taux : pourcentage ou fraction Deux familles de colonnes portent un taux, et **elles ne se lisent pas de la même façon**. **Les taux de TVA** — `Ligne TVA taux`, `Port TVA taux`, le `TVA` d'un produit, le `Taux TVA` d'une classification — acceptent indifféremment le pourcentage ou la fraction. Le taux est rapproché de ceux configurés dans *Paramètres → Taux de TVA*, en essayant la valeur telle quelle puis divisée par cent : | Vous écrivez | Taux retenu | | --- | --- | | `20` | 20 % | | `0,2` | 20 % | | `20 %` | 20 % | | `5,5` ou `0,055` | 5,5 % | Un taux ne correspondant à aucun taux configuré n'est pas repris : le taux par défaut de la région s'applique. Les mentions `exonéré`, `hors taxe`, `HT`, `exempted` et `tax free` valent un taux de 0. **Les taux de remise et de marge** — `Remise taux`, `Ligne remise taux`, `Ligne marge taux`, `Taux de marge`, `Taux de marque` — s'écrivent en pourcentage, **sans le signe `%`** : | Vous écrivez | Valeur retenue | | --- | --- | | `10` | 10 % | | `10 %` | 0,1 % — sans doute pas ce que vous vouliez | Le signe `%` divise la valeur par cent. C'est sans conséquence sur un taux de TVA, qui tolère les deux écritures ; sur une remise, il donne un taux cent fois trop petit. **Écrivez donc `10`, pas `10 %`.** ### Date Ces formats sont reconnus : `2026-03-14` · `14-03-2026` · `14/03/2026` · `14/03/26` · `14/03/2026 09:30:00` Un fichier Excel dont la colonne est réellement formatée en date fonctionne aussi. ### Oui / Non | Lu comme vrai | Lu comme faux | | ----------------------------------------------- | -------------------------------------- | | `Oui` `O` `Yes` `Y` `True` `T` `1` `-1` `✓` `✔` | `Non` `N` `No` `False` `F` `0` `✗` `✘` | La casse est ignorée. Une valeur vide ou non reconnue laisse la valeur par défaut de la colonne. ### Pays Le nom du pays en clair (`France`) ou son code ISO à deux lettres (`FR`), selon la colonne utilisée. ### Listes de valeurs Certaines colonnes n'acceptent qu'un ensemble fermé de valeurs — type de produit, statut de devis, moyen de paiement. Elles sont énumérées sur la page de l'import concerné, et acceptent généralement le mot français, le mot anglais et une abréviation. ## Les trois étapes d'un import 1. **Sélectionnez un fichier à importer** — après avoir réglé format, région et encodage. 2. **Vérifiez les données** — un aperçu affiche les lignes telles qu'Altoviz les a comprises, et signale les erreurs en rouge. **C'est la seule occasion de vérifier avant écriture.** Une colonne vide dans l'aperçu alors qu'elle est remplie dans votre fichier signifie que son en-tête n'a pas été reconnu. 3. **Import en cours** — le traitement se déroule sur nos serveurs ; vous êtes averti par une notification dans l'application lorsqu'il est terminé. ## Règles communes aux colonnes - **L'ordre des colonnes n'a aucune importance.** Seul le nom de l'en-tête compte. - **Une colonne inconnue est ignorée** sans erreur. C'est pratique — vous pouvez importer un export brut d'un autre logiciel — mais c'est aussi ce qui fait qu'un en-tête mal orthographié passe inaperçu. D'où l'étape 2. - **Presque toutes les colonnes sont facultatives.** Les rares obligatoires sont signalées sur chaque page. - Plusieurs noms sont acceptés pour une même colonne, afin de reprendre directement les exports des logiciels courants. N'en mettez **qu'un seul** par fichier.