Registre

Formats d’export et structures de données

Ce registre décrit, export par export, ce qu’ACTUAL DATA rend à un cabinet : le contenu de chaque fichier, son format, ses champs, ce qui n’y figure pas et les limites connues. Il est destiné autant au cabinet qu’à l’éditeur chez qui il irait.

Réponse rapideMis à jour : 17 septembre 2026

ACTUAL DATA rend les données d’un cabinet en cinq exports, obtenus depuis l’interface du service : une archive ZIP contenant clients.csv, contrats.csv et un manifeste (CSV séparés par des points-virgules, UTF-8 avec BOM) ; la fiche d’un client avec ses contrats, ses interactions, ses sinistres et la liste de ses pièces, en JSON ; les pièces de la gestion documentaire en archive ZIP, rangées par catégorie ; les véhicules et les mouvements d’un contrat de flotte en classeur Excel à deux onglets ; les parrainages en CSV. Les données que ces fichiers ne couvrent pas — tâches, journal d’activité, écritures de commissions issues des bordereaux — se lisent en JSON par l’interface programmable, authentifiée par un jeton d’accès personnel. Ce registre est publié au titre de l’article 26, point b), du règlement (UE) 2023/2854 sur les données.

Pourquoi ce registre existe

Le règlement (UE) 2023/2854 sur les données, applicable depuis le 12 septembre 2025, impose au fournisseur d’un service de traitement de données d’informer son client sur « les méthodes et formats de changement de fournisseur et de portage disponibles, ainsi que sur les restrictions et les limitations techniques connues » (article 26, point a)), et d’y ajouter « une référence à un registre en ligne à jour et hébergé par le fournisseur de services de traitement de données, avec des informations détaillées sur toutes les structures de données et tous les formats de données ainsi que les normes pertinentes et les spécifications d’interopérabilité ouvertes » (point b)).

Cette page est ce registre. C’est elle que citent l’article 6 de nos conditions générales et notre page sécurité des données. Elle décrit ce qui existe dans le produit, pas ce qui est prévu.

Export du portefeuille : clients et contrats (archive ZIP de CSV)

C’est l’export de réversibilité, déclenché depuis la liste des clients. Il ne dépend d’aucune intervention de l’éditeur.

Contenu de l’archiveclients.csv, contrats.csv et manifest.json
Colonnestoutes les colonnes scalaires de la fiche client et du contrat, dans l’ordre du modèle de données — l’en-tête les nomme
Clients — champs principauxréférence, civilité, nom, prénom, société, date de naissance, e-mails, téléphones, adresse complète, profession, régime, situation familiale, tags, notes, apporteur, source et système d’origine, consentement RGPD, archivage
Contrats — champs principauxclient, référence, compagnie et porteur de risque, produit, type, formule, dates d’effet, d’échéance et de résiliation, primes HT et TTC, cotisations annuelle et mensuelle, commissions et taux, fractionnement, mode d’encaissement, statut, motif de résiliation, garanties, date et mode de signature, apporteur
Séparateurpoint-virgule
EncodageUTF-8 avec BOM — les accents s’ouvrent tels quels dans un tableur
Fin de ligneCRLF
Ordre des lignesclients par nom croissant, contrats par date de création croissante
Champ exclule jeton d’accès au portail client (portalToken) : un secret technique du service, pas une donnée du cabinet
Manifestemanifest.json — identifiant de format « export-portefeuille-v1 », date de génération, nombre de clients et de contrats, note sur l’encodage et sur les pièces
Nom du fichierexport-portefeuille-AAAA-MM-JJ.zip
Qui peut l’obtenirun compte disposant de la capacité d’export (rôle administrateur) ; l’opération est inscrite au journal d’audit avec les volumes extraits

Fiche d’un client : contrats, interactions, sinistres et pièces (JSON)

Cet export sert deux usages : répondre à une demande de portabilité d’un client du cabinet (article 20 du RGPD) et rendre une fiche complète à un autre logiciel.

Contenula fiche du client, ses contrats, ses interactions (de la plus récente à la plus ancienne), ses sinistres et la liste de ses pièces
Piècesmétadonnées seulement : identifiant, nom, nom d’origine, catégorie, sous-type, type MIME, taille et date ; les fichiers eux-mêmes s’obtiennent par l’archive ZIP des pièces
FormatJSON indenté, UTF-8, sous une enveloppe « rgpd-portabilite-v1 » datée de sa génération
Champ exclule jeton d’accès au portail client
Nom du fichierexport-rgpd-nom-du-client-identifiant.json
Qui peut l’obtenirun compte disposant de la capacité d’export, sur une fiche qui relève de son périmètre ; l’opération est inscrite au journal d’audit

Pièces de la gestion documentaire (archive ZIP)

Contenutous les fichiers attachés à une fiche client, ou la sélection faite dans la liste
Arborescenceun dossier par catégorie de pièce ; chaque fichier conserve son nom d’origine et son extension
Nom de l’archiveDocuments_NOM_Prenom.zip
Tracechaque téléchargement groupé est inscrit au journal d’audit avec le nombre de fichiers et le volume

Contrat de flotte : véhicules et mouvements (classeur Excel)

Onglet « Véhicules »immatriculation, numéro de série (VIN), marque, modèle, type de véhicule, formule, dates d’adhésion et de radiation, motif de radiation, statut, PTAC, puissance fiscale, première mise en circulation, valeur à neuf, usage, conducteur principal, prime annuelle HT, taxes, jours couverts, primes prorata HT et TTC, quittancement sur la période, commentaire, auteur et dates de création et de modification
Onglet « Mouvements »horodatage, véhicule, type de mouvement, date d’effet, utilisateur, valeurs avant et valeurs après
Formatclasseur Excel (.xlsx), un onglet par table, en-têtes figés
Nom du fichierFLOTTE_NomClient_NumContrat_AAAAMMJJ.xlsx
Qui peut l’obtenirun compte disposant de la capacité d’export : le classeur porte les primes du portefeuille

Parrainages (CSV)

Colonnesparrain, filleul, rang, montant, date de création, date de souscription du filleul, statut de cotisation, statut de la récompense, date d’envoi, date de validation, apporteur, notes
Colonnes variablesl’en-tête de la récompense et celui de la date de validation reprennent les réglages du cabinet (nom de la récompense, durée de carence)
Séparateur et encodagepoint-virgule, UTF-8 avec BOM
Protectionune cellule commençant par =, +, - ou @ est préfixée d’une apostrophe : aucun tableur n’exécutera une formule reçue dans un export
Nom du fichierparrainages_AAAA-MM-JJ.csv

Ce que ces fichiers ne contiennent pas

  • Les tâches, le journal d’activité et les écritures de commissions issues des bordereaux n’ont pas d’export de fichier : ils se lisent en JSON par l’interface programmable, décrite plus bas.
  • Le contenu des pièces n’est pas dans le JSON de la fiche client : celui-ci n’en porte que les métadonnées, les fichiers étant dans l’archive ZIP des pièces.
  • Le jeton d’accès au portail client est retiré des deux exports : c’est un secret technique du service, et le porter dans un fichier reviendrait à le divulguer.
  • Une sauvegarde complète de la base est téléchargeable par l’administrateur du cabinet, mais elle est chiffrée en AES-256-GCM : sa lecture suppose la clé de chiffrement de l’instance. Ce n’est donc pas un format de portage, c’est une copie de sûreté.

L’interface programmable

L’export du portefeuille et celui d’une fiche client s’obtiennent aussi par appel authentifié : un jeton d’accès personnel, créé par un administrateur du cabinet, est présenté dans l’en-tête Authorization: Bearer. Le jeton n’a que les droits du compte qui le porte, il peut être révoqué, et chaque appel est journalisé avec son point d’entrée, son code de réponse et sa durée.

La limite, dite telle quelle : nous ne publions pas encore de documentation d’interface ouverte aux cabinets. Ce registre décrit les formats, pas l’ensemble des points d’entrée. Un cabinet qui prépare une reprise ou un raccordement peut nous demander ceux dont il a besoin, à l’adresse ci-dessous.

Restrictions et limites connues

  • L’export du portefeuille, celui d’une fiche client, celui des pièces et celui d’une flotte sont réservés aux comptes qui disposent de la capacité d’export : un collaborateur qui ne l’a pas ne peut pas extraire le portefeuille.
  • Les pièces s’exportent fiche par fiche : il n’existe pas d’archive unique de toute la gestion documentaire.
  • Le journal d’activité se lit par pages de deux cents événements au plus.
  • Les CSV décrivent l’état courant des fiches : ils ne portent pas l’historique des modifications, qui reste dans le journal.
  • Un export du portefeuille (clients et contrats) qui ne ramène aucune ligne ne contient pas non plus l’en-tête des colonnes ; les exports de parrainages et de flotte, eux, écrivent toujours leur en-tête.

Ce registre est tenu à jour

Sa date de mise à jour est celle d’une révision réelle, affichée en tête de page. Il change quand le produit change : une catégorie qui entre dans un export y est ajoutée, une colonne qui disparaît en est retirée.

Une erreur, un manque, ou un format dont vous auriez besoin pour une reprise se signalent à contact@actualdata.fr. Ce que le contrat en dit figure à l’article 6 des conditions générales, et la chronologie de sortie — période transitoire, période de récupération, effacement — y est écrite au même endroit.

Par l’équipe ACTUAL DATA. ACTUAL DATA est éditée par ACTUALASSURANCES, cabinet de courtage en assurance inscrit à l’ORIAS (n° 10.058.401) à Douai. Nos articles s’appuient sur une pratique quotidienne du métier.

Rédigé avec des outils d’IA à partir de sources officielles lues le jour même, chaque citation vérifiée, relu avant publication — l’équipe ACTUAL DATA en assume le contenu. Comment nous écrivons →

Voir ACTUAL DATA sur votre portefeuille

30 minutes de démonstration, sans engagement. Nous reprenons vos données là où elles sont.

Réserver ma démo