Technische Umsetzung (Teil 2): Vollautomatische Aktenanlage und intelligentes Dokumenten-Handling

Im ersten Teil unserer Serie haben wir beschrieben, warum wir uns für eine Cloud-Native-Architektur mit Apify, n8n und Actaport entschieden haben. Die Resonanz war groß – viele Kollegen fragen sich: "Wie sieht das konkret aus?"

Dieser zweite Teil beschreibt die technische Umsetzung der Datenpipeline. Wir zeigen nicht nur, wie Stammdaten importiert werden, sondern gehen noch einen Schrit weiter: Die vollautomatische Anlage einer Akte, inklusive der Verknüpfung aller Beteiligten und der korrekten Ablage der aus dem Handelsregister automatisiert abgerufenen Registerdokumente.

Schritt 1: Datenerfassung via Formular-Trigger

Der Startpunkt der Automatisierung ist ein n8n Form Trigger. Dies ermöglicht die Entkopplung der Dateneingabe von der eigentlichen Verarbeitungslogik.

Das Formular erfasst lediglich die für den API-Abruf notwendigen Parameter:

• Amtsgericht: Standardisierte Auswahl via Dropdown.
• Registernummer: Numerische Eingabe.
• Sachbearbeiter: Zuweisung für die spätere Aufgabenverteilung in Actaport.
• Akte anlegen: Boolescher Wert (Checkbox). Ist dieser gesetzt, stoppt der Prozess nicht beim Kontakt, sondern erstellt die zugehörige Akte.

Nach Absenden des Formulars werden die Daten an einen HTTP-Request übergeben, der den Haupt-Workflow via Webhook initiiert.

Video: n8n Form Trigger – Datenerfassung für den Registerabruf.

Schritt 2: Verarbeitung der Registerdaten (XJustiz)

Der Crawler liefert Daten im XJustiz-Standard als XML. Für die Weiterverarbeitung in der Actaport-API ist eine Transformation notwendig, da Rohwerte wie der Rechtsform-Code 221110 nicht direkt interpretiert werden können.

Die Verarbeitung erfolgt in einem JavaScript Code-Node in n8n, der zwei zentrale Funktionen erfüllt:

1. Parsing: Iteration durch die XML-Baumstruktur (z.B. tns:basisdatenRegister) zur Extraktion von Stammkapital, Unternehmensgegenstand und Adressdaten.
2. Mapping: Abgleich der XJustiz-Codes mit einer internen Mapping-Tabelle. Der Code 111000 wird beispielsweise in den String "OHG" übersetzt, um die Anforderungen des Actaport-Datenmodells zu erfüllen.

Abbildung: Von Roh-XML über den n8n Code-Node (Mapping) zum bereinigten JSON-Payload.

Schritt 3: Kontakte anlegen und Dubletten vermeiden

Das Fundament jeder Akte sind saubere Kontaktdaten. Um Redundanzen zu vermeiden, prüft der Workflow vor jeder Anlage, ob die Person oder Firma bereits existiert.

Der Prozess folgt diesem Schema:

• API-Abfrage (GET): Suche im Actaport-Bestand nach existierenden Einträgen (Filterung nach Name und Ort).
• Bedingte Logik (IF-Node):
  • Fall A (Datensatz gefunden): Die ID des bestehenden Kontakts wird extrahiert.
  • Fall B (Kein Treffer): Ein neuer Kontakt wird via POST-Request erstellt; die neu generierte ID wird zurückgegeben.
• Daten-Normalisierung: Unabhängig vom Pfad wird die valide kontakt_id in einer einheitlichen Variable gespeichert.

Angelegter bzw. aktualisierter Kontakt in Actaport.

Schritt 4: Die automatische Aktenanlage

Hier liegt der eigentliche Mehrwert der Erweiterung: Wenn die Checkbox "Akte anlegen" aktiviert wurde, nutzt der Workflow die zuvor ermittelte kontakt_id, um eine neue Akte anzulegen.

Der Workflow führt folgende Aktionen via Actaport-API (POST /v1/akten) durch:

1. Zuordnung: Die Firma (identifiziert durch ihre ID) wird als "Mandant" mit der neuen Akte verknüpft.
2. Metadaten: Die Akte erhält automatisch eine Bezeichnung (z.B. "HR-Import: [Firmenname]"), Schlagworte und den im Formular ausgewählten Sachbearbeiter.
3. Rückgabewert: Die API liefert die neue Aktennummer (z.B. "123/24") zurück, die für den nächsten Schritt essenziell ist.

Schritt 5: Dokumentenabruf und Speicherung in der Akte

Eine leere Akte hilft wenig. Daher lädt der Workflow im letzten Schritt die relevanten Registerdokumente (Registerauszug, Gesellschafterliste, Gesellschaftsvertrag) herunter und speichert sie direkt im Dokumentenbereich der neu erstellten Akte.

Dabei löst n8n ein technisches Problem des Handelsregisters: Die inkonsistenten Dateiformate.

• MIME-Type Prüfung: Ein IF-Node analysiert, ob eine Datei als PDF oder ZIP geliefert wird.
• Entpacken (Unzip): ZIP-Archive werden automatisch entpackt, um das enthaltene PDF zu extrahieren.
• Upload: Über den Endpunkt POST /v1/akten/{aktennummer}/dokumente werden die bereinigten PDFs direkt in den Unterordner "Handelsregister" der Akte hochgeladen.

Das Ergebnis

Am Ende des Prozesses steht eine vollständig angelegte Akte, bereit zur Bearbeitung.

Die fertige Akte: Mandant verknüpft, Sachbearbeiter zugewiesen und alle Dokumente im Ordner abgelegt.

Der Sachbearbeiter erhält abschließend eine E-Mail-Bestätigung mit Link zur Akte und Statusbericht. Dies demonstriert, wie moderne API-Architekturen nicht nur Daten verschieben, sondern komplexe juristische Arbeitsabläufe vollständig automatisieren können.

E-Mail-Bestätigung: Der Import inklusive Aktenanlage war erfolgreich.

Fazit: Vom Verwalter zum Gestalter

Dieser Deep-Dive in unsere "Maschinenraum" zeigt, dass Legal Tech heute weit mehr ist als nur das Digitalisieren von Papierakten. Durch die intelligente Verknüpfung von APIs (Apify & Actaport) und Prozesslogik (n8n) haben wir einen administrativen Zeitfresser – die Mandatsanlage im Gesellschaftsrecht – nahezu vollständig eliminiert.

Der Gewinn liegt nicht nur in der gesparten Zeit (Minuten statt Stunden), sondern vor allem in der Qualität: Keine Tippfehler bei Firma/Namen, Anschriften oder Geschäftsführer-Zuordnung, keine vergessenen Dokumente und eine einheitliche Datenstruktur über alle Mandate hinweg. Assistenzen und Anwälte werden von "Daten-Abtippern" zu Prozess-Gestaltern, die sich auf das konzentrieren können, wofür sie brennen: Die rechtliche Beratung.