Mise en œuvre technique (Partie 2) : création automatisée de dossiers et gestion intelligente des documents

Dans la première partie de notre série, nous avons décrit pourquoi nous avons choisi une architecture Cloud-Native avec Apify, n8n et Actaport. L'accueil a été enthousiaste – de nombreux confrères se demandent : « À quoi cela ressemble-t-il concrètement ? »

Cette deuxième partie décrit la mise en œuvre technique de la pipeline de données. Nous montrons non seulement comment les données de base sont importées, mais nous allons encore plus loin : la création entièrement automatique d'un dossier, incluant le lien entre toutes les parties prenantes et le classement correct des documents du registre du commerce allemand récupérés automatiquement.

Étape 1 : Saisie des données via un déclencheur de formulaire

Le point de départ de l'automatisation est un n8n Form Trigger. Cela permet de séparer la saisie des données de la logique de traitement proprement dite.

Le formulaire saisit uniquement les paramètres nécessaires à la récupération via l'API :

• Tribunal d'instance (Amtsgericht) : Sélection standardisée via un menu déroulant.
• Numéro de registre : Saisie numérique.
• Gestionnaire de dossier : Affectation pour la répartition ultérieure des tâches dans Actaport.
• Créer dossier : Valeur booléenne (case à cocher). Si elle est cochée, le processus ne s'arrête pas au contact, mais crée le dossier associé.

Après l'envoi du formulaire, les données sont transmises à une requête HTTP qui initie le flux de travail (workflow) principal via un Webhook.

Vidéo : n8n Form Trigger – Saisie de données pour la consultation du registre.

Étape 2 : Traitement des données du registre (XJustiz allemand)

Le crawler fournit des données au standard XJustiz en XML. Pour le traitement ultérieur dans l'API d'Actaport, une transformation est nécessaire, car les valeurs brutes comme le code de forme juridique 221110 ne peuvent pas être interprétées directement.

Le traitement s'effectue dans un JavaScript Code-Node dans n8n, qui remplit deux fonctions centrales :

1. Parsing : Itération à travers la structure arborescente XML (ex: tns:basisdatenRegister) pour l'extraction du capital social, de l'objet de l'entreprise et des données d'adresse.
2. Mapping : Comparaison des codes XJustiz avec un tableau de mapping interne. Le code 111000 est par exemple traduit en chaîne de caractères « OHG », pour répondre aux exigences du modèle de données d'Actaport.

Illustration : Du XML brut via le n8n Code-Node (Mapping) au Payload JSON épuré.

Étape 3 : Créer des contacts et éviter les doublons

La base de tout dossier réside dans des données de contact propres. Pour éviter les redondances, le workflow vérifie avant chaque création si la personne ou l'entreprise existe déjà.

Le processus suit ce schéma :

• Requête API (GET) : Recherche dans la base d'Actaport des entrées existantes (filtrage par nom et ville).
• Logique conditionnelle (IF-Node) :
  • Cas A (Donnée trouvée) : L'ID du contact existant est extrait.
  • Cas B (Pas de résultat) : Un nouveau contact est créé via une requête POST ; l'ID nouvellement généré est retourné.
• Normalisation des données : Indépendamment du chemin, l'id_contact valide est stocké dans une variable uniforme.

Contact créé ou mis à jour dans Actaport.

Étape 4 : Création automatique du dossier

C'est ici que réside la véritable valeur ajoutée de l'extension : si la case « Créer dossier » a été activée, le workflow utilise l'id_contact précédemment déterminé pour créer un nouveau dossier.

Le workflow effectue les actions suivantes via l'API Actaport (POST /v1/akten) :

1. Attribution : L'entreprise (identifiée par son ID) est liée en tant que « Mandant » au nouveau dossier.
2. Métadonnées : Le dossier reçoit automatiquement une désignation (ex : « HR-Import : [Nom de l'entreprise] »), des mots-clés et le gestionnaire sélectionné dans le formulaire.
3. Valeur de retour : L'API retourne le nouveau numéro de dossier (ex : « 123/24 »), essentiel pour l'étape suivante.

Étape 5 : Récupération des documents et stockage dans le dossier

Un dossier vide n'est que peu utile. C'est pourquoi le workflow télécharge, dans la dernière étape, les documents pertinents du registre (extrait du registre, liste des associés, contrat de société) et les stocke directement dans la zone de documents du dossier nouvellement créé.

n8n résout ici un problème technique du registre du commerce allemand : les formats de fichiers incohérents.

• Vérification du type MIME : Un nœud IF analyse si un fichier est fourni en PDF ou en ZIP.
• Décompression (Unzip) : Les archives ZIP sont automatiquement décompressées pour extraire le PDF contenu.
• Téléchargement (Upload) : Via le point de terminaison POST /v1/akten/{numéro-dossier}/dokumente, les PDF nettoyés sont téléchargés directement dans le sous-dossier « Handelsregister » du dossier.

Le résultat

À la fin du processus, on obtient un dossier entièrement créé, prêt à être traité.

Le dossier fini : mandant lié, gestionnaire affecté et tous les documents classés dans le dossier.

Le gestionnaire reçoit enfin une confirmation par e-mail avec un lien vers le dossier et un rapport d'état. Cela démontre comment les architectures d'API modernes ne font pas que déplacer des données, mais automatisent entièrement des processus de travail juridiques complexes.

E-mail de confirmation : l'importation incluant la création du dossier a réussi.

Conclusion : de l'administrateur au concepteur

Cette immersion dans notre « salle des machines » montre que la Legal Tech aujourd'hui est bien plus que la simple numérisation de dossiers papier. Grâce à la liaison intelligente des API (Apify & Actaport) et de la logique de processus (n8n), nous avons presque totalement éliminé un chronophage administratif – la création de mandats en droit des sociétés.

Le gain ne réside pas seulement dans le temps gagné (minutes au lieu d'heures), mais surtout dans la qualité : aucune faute de frappe sur l'entreprise/les noms, les adresses ou l'affectation des gérants, aucun document oublié et une structure de données uniforme sur tous les mandats. Les assistantes et les avocats passent de « saisisseurs de données » à des concepteurs de processus, qui peuvent se concentrer sur ce pour quoi ils brûlent : le conseil juridique.