Import / Export

Le poste de pilotage des données : exportez chaque module en CSV, réimportez vos fichiers (fusion par identifiant), et produisez l'export comptable FEC pour un contrôle fiscal.

/dataio /api/dataio/export /api/dataio/import dataio.export dataio.import

À quoi sert ce module

Import / Export centralise dans l'administration tout ce qui entre et sort de l'ERP en masse. Trois usages : exporter un module entier au format CSV (sauvegarde, analyse dans un tableur, migration), importer un CSV au même format pour créer ou mettre à jour des lignes en lot, et générer l'export comptable FEC (Fichier des Écritures Comptables) attendu lors d'un contrôle fiscal.

Il s'adresse aux administrateurs et aux profils de gestion (comptable, gestionnaire) qui manipulent des volumes de données. Comme ces opérations sont sensibles, l'accès est verrouillé par deux permissions séparées.

Export et import sont séparés à dessein dataio.export fait sortir des données (risque d'exfiltration) ; dataio.import en écrit (risque de fraude / corruption). Ce sont deux risques distincts, accordés indépendamment : un profil peut avoir le droit d'exporter sans pouvoir importer, et inversement. La page reste accessible avec l'un ou l'autre des deux droits, et n'affiche que les sections autorisées.

Vue d'ensemble de l'écran

https://erp.entreprise.fr/dataio

Exporter

CSV séparateur ;, UTF-8 avec BOM. L'export sert aussi de modèle d'import.

Jeu de données	Lignes
Clients	312	CSV
Factures (en-têtes)	1 204	CSV
Devis (en-têtes)	486	CSV
Demandes de contact lecture seule	57	CSV

Export comptable (FEC)

Du 2026-01-01 Au 2026-12-31 Télécharger le FEC

La page liste un jeu de données par module actif, avec son nombre de lignes et un bouton d'export. En dessous : le formulaire d'import (fusion par id) et, si le module Factures est actif, l'export FEC.

Exporter un module en CSV

Chaque jeu de données correspond à une table métier d'un module actif. Un module désactivé n'apparaît pas dans la liste. Le fichier produit est un CSV en séparateur point-virgule, encodé en UTF-8 avec BOM — il s'ouvre directement dans Excel ou LibreOffice.

Ouvrez Administration → Import / Export (route /dataio).
Repérez le jeu de données voulu (chaque ligne indique son nombre d'enregistrements).
Cliquez sur CSV : le téléchargement démarre, nommé <jeu>-AAAAMMJJ-HHMMSS.csv.

L'export ne fait jamais de SELECT * : seules des colonnes en liste blanche sont exportées, pour éviter d'extraire en masse des champs trop sensibles. Chaque export est journalisé (audit) avec le jeu concerné.

L'export EST votre modèle d'import Pour importer proprement, exportez d'abord le jeu visé : le fichier obtenu a exactement le bon en-tête de colonnes. Modifiez-le, puis réimportez-le. Inutile de deviner les noms de colonnes.

Jeux de données exportables

La liste dépend des modules activés sur votre installation. Le catalogue complet est :

Jeu de données	Module	Importable ?
Clients	Clients	Oui
Factures (en-têtes)	Factures	Oui (champs calculés en lecture seule)
Lignes de factures	Factures	Oui
Devis (en-têtes)	Devis	Oui (statut / montants / jeton en lecture seule)
Lignes de devis	Devis	Oui
Paiements récurrents	Récurrents	Oui
Notes de frais	Notes de frais	Oui (statut & justificatif exclus)
Paiements internes	Interne	Oui
Demandes de contact	Demandes	Non — lecture seule (entrent par le connecteur public)
Événements du calendrier	Calendrier	Oui

Importer un CSV (fusion / upsert)

L'import accepte un CSV au même format que l'export. La logique est un upsert (fusion par identifiant) : la colonne id décide. Si une ligne porte un id déjà présent, elle met à jour l'enregistrement existant ; sinon elle en crée un nouveau. Laissez id vide pour forcer une création (utile sur les tables à id auto-incrémenté comme les lignes de factures / devis).

Sélectionnez le jeu de données dans la liste déroulante (seuls les jeux importables apparaissent).
Choisissez votre fichier CSV (séparateur ; ou ,, UTF-8, première ligne = en-tête de colonnes ; 8 Mo maximum).
Cliquez sur Importer. Un compte-rendu s'affiche : lignes créées, mises à jour, ignorées, colonnes refusées le cas échéant.

Comportement de l'import — points clés

Clé d'identité: La colonne id pilote création vs mise à jour. id vide = création forcée.
Colonnes inconnues: Une colonne absente de la table — ou non autorisée à l'import — est ignorée sans bloquer l'import ; elle est listée dans le compte-rendu.
Champs protégés: Les champs calculés ou à valeur légale (status, total_ht / total_vat / total_ttc, numéro de facture, horodatages, jetons de signature, chemins de fichiers…) ne sont jamais réécrits par import. Ils restent visibles à l'export à titre indicatif.
Cellule vide: Interprétée comme « valeur absente » (NULL) : la valeur par défaut de la base s'applique.
Dépendances: Importez les Clients avant les factures, devis et récurrents (ils référencent client_id) ; et les en-têtes avant les lignes.
Dates: Format AAAA-MM-JJ (et AAAA-MM-JJ HH:MM:SS pour les horodatages).
Volume: Lecture en flux, par lots ; plafonnée à 50 000 lignes par fichier. Au-delà, segmentez votre fichier.

L'import écrit dans vos données réelles Un import met à jour ou crée des enregistrements en base, immédiatement et sans corbeille. Une mauvaise correspondance d'id peut écraser des fiches existantes. Exportez d'abord le jeu visé (sauvegarde + modèle de colonnes), vérifiez votre fichier sur un petit échantillon, et n'accordez dataio.import qu'aux comptes de confiance. Chaque import est journalisé (volume traité, colonnes refusées).

Export comptable FEC

Le Fichier des Écritures Comptables (FEC) est le format normalisé exigé par l'administration fiscale lors d'un contrôle. La section n'apparaît que si le module Factures est actif ; elle produit le journal des ventes (factures émises) sur la période choisie.

Renseignez la période : champs Du et Au (l'année civile en cours est pré-remplie).
Choisissez le séparateur : Tabulation (recommandé) ou Pipe |.
Cliquez sur Télécharger le FEC — le fichier est généré et téléchargé (route /api/fec).

Voir le module Comptabilité pour le détail des écritures et du plan comptable sous-jacent.

Tables sensibles hors de portée Seules les tables métier listées plus haut sont accessibles à l'import / export — c'est une liste blanche stricte. Les comptes, rôles, mots de passe, jetons et le journal d'audit ne sont jamais exportables ni importables par ce module, même via un paramètre forgé.

Permissions

Clé	Autorise
`dataio.export`	Exporter les données métier (CSV par module et export FEC). Ouvre la section « Exporter » de la page.
`dataio.import`	Importer des données métier (CSV, upsert). Ouvre la section « Importer ». Écrit en base — à réserver aux comptes de confiance.

L'entrée de navigation s'affiche dès que vous détenez dataio.export ; un porteur de dataio.import seul accède directement à la page d'import.

Liens utiles

Comptabilité — l'export FEC s'appuie sur les écritures comptables.
Connecteurs — les Demandes de contact entrent par le connecteur public (d'où leur statut « lecture seule » à l'import).
Rôles & permissions — pour accorder dataio.export et dataio.import séparément.