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.
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’archive | clients.csv, contrats.csv et manifest.json |
|---|---|
| Colonnes | toutes 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 principaux | ré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 principaux | client, 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éparateur | point-virgule |
| Encodage | UTF-8 avec BOM — les accents s’ouvrent tels quels dans un tableur |
| Fin de ligne | CRLF |
| Ordre des lignes | clients par nom croissant, contrats par date de création croissante |
| Champ exclu | le jeton d’accès au portail client (portalToken) : un secret technique du service, pas une donnée du cabinet |
| Manifeste | manifest.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 fichier | export-portefeuille-AAAA-MM-JJ.zip |
| Qui peut l’obtenir | un 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.
| Contenu | la 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èces | mé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 |
| Format | JSON indenté, UTF-8, sous une enveloppe « rgpd-portabilite-v1 » datée de sa génération |
| Champ exclu | le jeton d’accès au portail client |
| Nom du fichier | export-rgpd-nom-du-client-identifiant.json |
| Qui peut l’obtenir | un 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)
| Contenu | tous les fichiers attachés à une fiche client, ou la sélection faite dans la liste |
|---|---|
| Arborescence | un dossier par catégorie de pièce ; chaque fichier conserve son nom d’origine et son extension |
| Nom de l’archive | Documents_NOM_Prenom.zip |
| Trace | chaque 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 |
| Format | classeur Excel (.xlsx), un onglet par table, en-têtes figés |
| Nom du fichier | FLOTTE_NomClient_NumContrat_AAAAMMJJ.xlsx |
| Qui peut l’obtenir | un compte disposant de la capacité d’export : le classeur porte les primes du portefeuille |
Parrainages (CSV)
| Colonnes | parrain, 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 variables | l’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 encodage | point-virgule, UTF-8 avec BOM |
| Protection | une 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 fichier | parrainages_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