Data Bridge — Schnittstellen & Connectors — valora Wiki

Data Bridge — Schnittstellen & Connectors

Status: ✅ Aktiv v1.0 — Port 9403
Letzte Aktualisierung: 2026-06-12
Priorität: Hoch

📄 Technische Spezifikation: data-bridge-spec.md — Vollständige Architektur, Datenmodell, API-Design und Connector-Dokumentation.
📦 Repository: /projects/valora-databridge/

Übersicht

Der Data Bridge ist das Herzstück der automatischen Dateneingabe. Er verbindet valora mit allen gängigen Buchhaltungs- und Steuerberatungssystemen.

Geplante Connectors

System Typ Status Details
BMD NTCS REST-API ✅ Aktiv JSON-Parser, Normalisierung, Mapping-Stub
RZL XML-Schnittstelle ✅ Aktiv XML-Parser, Namespace-Handling, Normalisierung
DVO CSV/XLS ✅ Aktiv CSV-Parser, Encoding-Erkennung, deutsches Zahlenformat
DATEV ASCII ✅ Aktiv Fixed-Width-Parser, Satzarten 0-5, ISO-8859-1
HMD CSV 🔮 Geplant Weitere Buchhaltungssysteme
STOTAX CSV 🔮 Geplant Steuerberatungs-Schnittstelle
LSS CSV 🔮 Geplant Lohn- und Gehaltsabrechnung

Architektur

BMD NTCS ─┐     ┌─────────────────────────────────────┐     ┌──────────────┐
(REST)    │     │         DATA BRIDGE (Port 9403)       │     │              │
RZL       ├────▶│  ┌───────────┐  ┌─────────────────┐ │────▶│  valora       │
(XML)     │     │  │ Connector │  │  Normalisierungs │ │     │  Backend      │
DVO       │     │  │   Layer   │──│     Layer        │ │     │  (Port 9400)  │
(CSV)     │     │  │           │  │ (einheitliches   │ │     └──────────────┘
DATEV ────┘     │  │ bmd.js   │  │  Datenmodell)    │ │
(ASCII)   │     │  │ rzl.js   │  │                  │ │     ┌──────────────┐
                │  │ dvo.js   │  │                  │ │     │  FormelF     │
                │  │ datev.js │  │                  │ │────▶│  (Berechnung) │
                │  └───────────┘  └─────────────────┘ │     │              │
                │         │                            │     └──────────────┘
                │   Validierungs-Workflow              │
                │   (Plausi + Schema)                  │
                └─────────────────────────────────────┘

Features (aktiv)

  • ✅ 4 Connector-Stubs: BMD NTCS, RZL, DVO, DATEV — über einheitliche API
  • ✅ Normalisierungs-Layer: Einheitliches NormalizedBooking-Datenmodell
  • ✅ Validierungs-Workflow: Schema + Plausibilitätsprüfung vor Übernahme
  • ✅ Multi-Kanzlei: Beliebig viele Mandanten mit unterschiedlichen Systemen
  • ✅ Import-Journal: Jeder Import wird als JSON-Datei geloggt (imports/)
  • ✅ Health-Endpoint: GET /health — Status aller Connectors
  • 🔮 KI-Konten-Matching: Neue Konten automatisch valora-Kategorien zuordnen (v2.0)
  • 🔮 Polling-Connectors: Automatischer Abruf per Cron/Timer (v2.0)

API-Endpunkte

Methode Pfad Beschreibung
GET /health Health-Check + Connector-Status
POST /api/connect/bmd BMD NTCS-Daten importieren
POST /api/connect/rzl RZL-XML-Daten importieren
POST /api/connect/dvo DVO-CSV/XLS-Daten importieren
POST /api/connect/datev DATEV-ASCII-Daten importieren
GET /api/status/:importId Import-Status abfragen
POST /api/import/:importId Import in valora ausführen
GET /api/config/:system Connector-Konfiguration abfragen

Quickstart

cd /projects/valora-databridge/
npm install
npm start

# Health-Check
curl -s http://127.0.0.1:9403/health

# BMD-Daten importieren
curl -s -X POST http://127.0.0.1:9403/api/connect/bmd \
  -H "Content-Type: application/json" \
  -d '{"clientId":"10001","data":[...]}'

📄 Technische Details: data-bridge-spec.md — Vollständige Spezifikation mit Datenmodell, Validierungsregeln und Connector-Interface.