Importer des dossiers par fichier CSV

LINK permet de créer des dossiers à partir d'une extraction CSV du système de l'institution, sans développement dans ce système. LINK est en cours de livraison : cette première tranche se pilote depuis l'écran « Imports » de l'application ou par l'API, dont les opérations sont regroupées dans la famille « link » de la référence.

Le contrat de données

Le fichier suit un contrat versionné et fermé, link-contract version 1 :

• une enveloppe commune : référence du dossier chez l'institution, référence et nature du demandeur, dates (demande, observation des données) ;
• les variables de décision du produit : ce sont exactement les entrées de la politique en vigueur. Une donnée que la politique ne lit pas n'est pas demandée ;
• aucune colonne d'issue (défaut, contentieux, impayé).

Une colonne inconnue rend le fichier non importable, sauf si la correspondance la déclare explicitement ignorée. Une version de contrat non prise en charge est refusée, sans conversion.

Le gabarit d'un produit

Pour chaque produit, la plateforme produit un gabarit CSV : séparateur point-virgule, UTF-8 avec marque d'ordre, une ligne de métadonnées puis l'en-tête, sans aucune ligne d'exemple. La ligne de métadonnées sert à refuser tôt une erreur humaine (gabarit d'un autre produit, version périmée) ; elle n'autorise rien.

#nexclara-link;contract=link-contract;version=1;product=MICRO-EX;columns=0123456789abcdef
external_reference;applicant_reference;applicant_kind;application_date;requested_amount;term_months
DOS-EX-0001;CLI-EX-0001;natural_person;2026-09-30;500000.00;12
DOS-EX-0002;CLI-EX-0002;natural_person;2026-09-30;250000.00;#NA

Cet extrait est un fichier rempli à partir du gabarit : le gabarit lui-même n'a aucune ligne de données. Il est réduit à quelques colonnes pour la lecture : un gabarit réel porte toutes les entrées de la politique du produit, dans l'ordre donné par la plateforme.

Les étapes

1. Déposer le fichier : contrôles de surface (fichier vide, taille, encodage UTF-8 strict, contenu binaire ou archive refusés), stockage dans l'espace de l'institution, empreinte SHA-256.
2. Pré-valider : lecture, correspondance des colonnes, vérification ligne par ligne avec les mêmes règles que la saisie DESK, et rapport. La pré-validation ne crée aucun dossier.
3. Consulter le rapport : comptes, problèmes par code et par catégorie, colonnes reconnues, inconnues ou manquantes. Un rapport d'erreurs CSV cite les valeurs fautives, neutralisées contre l'injection de formules dans un tableur.
4. Confirmer l'import avec une clé d'idempotence choisie par le client : le lot est mis en file et traité en arrière-plan. Rejouer la même clé rend le même lot ; un fichier déjà importé pour ce produit est refusé.
5. Suivre le lot et sa qualité : complétude, validité, unicité, calculées sur les données réellement enregistrées.

Les dossiers créés sont des brouillons ; ils se soumettent au moteur comme une saisie. L'import seul ne produit aucune évaluation.

Absences et provenance

Une cellule vide est une donnée manquante ; les jetons #UNKNOWN, #NA et #NR disent pourquoi elle manque. Une absence ne devient jamais zéro. Chaque valeur importée garde sa provenance : lot, ligne, colonne, conversions appliquées, version du contrat, instant d'acquisition et date d'extraction déclarée. Sur la fiche DESK d'un dossier importé, un onglet « Provenance » l'affiche ; le dossier de preuve TRUST la reprend, avec l'empreinte du fichier d'origine.

Ce qui est encore en construction

• l'import exige la session d'un agent habilité : analyste ou responsable crédit pour déposer et confirmer, audit et conformité en lecture ;
• aucun format tableur (XLSX), aucun dépôt automatisé sur un espace sécurisé ;
• les identifiants machine n'ouvrent pas encore ces opérations ;
• aucune annulation d'un import, aucune restitution vers les systèmes de l'institution.