Konzept · Option A — ICM liefert Belege, Buchhalter bucht in FreeFinance
ICMerfasst ER inkl. Belegdaten (Lieferant, Beträge, Steuer, Rechnungsnr., PDF)
→
FF-PosteingangBeleg + Belegdaten kommen an (Staging, „Verbuchen nach PDF/Beleg")
→
Buchhalter in FFprüft Vorschläge, ergänzt Konto/Belegart, bucht ab, erfasst Zahlung
→
ICMholt Buchungs-/Zahlungsstatus + FF-Belegnummer aktiv zurück
ICM besitzt
Welche ERs existieren · Lieferant · Währung · Beleg-PDF · Lieferanten-Rechnungsnr. · Beträge · SteuersätzeFF besitzt
Buchungskonten · Belegart · Steuer-Sonderfälle · FF-Belegnummer · die Buchung · ZahlungsstatusRahmen & Leitprinzip
Leitprinzip: Wer die Daten fachlich besitzt, ist führend.
• Doppelte Buchhaltung — kein Löschen, nur Stornieren.
• Buchhalterische Verantwortung liegt in FF — ICM liefert Vorschläge, der Buchhalter entscheidet.
• Verknüpfung ICM ↔ FF über die FF-ER-ID, nicht über den Lieferanten.
• Bestandsbelege: manuelle Verknüpfung mit FF-ER-ID muss möglich sein.
• Sichtbarkeit in ICM pro ER: Export-Status · Buchungs-Status (inkl. Betragsabweichung) · Zahlungs-Status (inkl. Teilbeträge).
• Doppelte Buchhaltung — kein Löschen, nur Stornieren.
• Buchhalterische Verantwortung liegt in FF — ICM liefert Vorschläge, der Buchhalter entscheidet.
• Verknüpfung ICM ↔ FF über die FF-ER-ID, nicht über den Lieferanten.
• Bestandsbelege: manuelle Verknüpfung mit FF-ER-ID muss möglich sein.
• Sichtbarkeit in ICM pro ER: Export-Status · Buchungs-Status (inkl. Betragsabweichung) · Zahlungs-Status (inkl. Teilbeträge).
Verbindung
Konfiguration wird geladen…
Beleg + Belegdaten an den FF-Posteingang übertragen. Der Beleg landet immer im Posteingang
(„Verbuchen nach PDF/Beleg") — kein Ordner wählbar, das ist gewollt. Den Beleg bucht der Buchhalter in FF.
1 · Beleg (PDF/Bild, max. 2 MB)
2 · Belegdaten
In der Praxis liefert ICM diese Daten. Zum Testen kannst du sie hier per KI aus dem PDF ableiten.
3 · Übertragen
Belegdaten-Übernahme prüfen (was FF gespeichert hat)
Nach der Übertragung automatisch. Zeigt, ob FF die mitgelieferten Belegdaten übernimmt (im Posteingang nur, wenn die App als „trusted" freigeschaltet ist — sonst greift OCR).
| Key | Gespeichert | Quelle | Status |
|---|---|---|---|
| — | |||
Posteingang-Inhalt
| Dateiname | OCR-Status | Beleg-ID | |
|---|---|---|---|
| — | |||
⚙️ Test- & Debug-Werkzeuge — nur für die Integrationsentwicklung. ICM nutzt das im Betrieb NICHT.
Login-Ablauf (Request/Response) inkl. Mandanten
Die drei Schritte: Issuer → Token (grant_type=client_credentials) → Mandanten. Secret wird redigiert, Access-Token gekürzt — beide verlassen den Server nicht.
KI-Einstellungen (OpenRouter)
…
Buchhalter simulieren · Eingangsrechnung per API erzeugen
⚠️ In der Praxis macht das der Buchhalter in FF. Hier nur zum Testen des Buchungs-/Status-Wegs. Erzeugt eine echte Buchung.
DMS-Ordner durchsuchen & Datei-Upload in Ordner
Reines Datei-Browsing/Ablage im DMS. Für den ICM-Belegfluss irrelevant — Belege gehen in den Posteingang (Tab ①).
—
| Name | Typ | Flags | provider_id |
|---|---|---|---|
| „Root laden". | |||
Kein Ordner gewählt.
Audit-Protokoll (Server → FreeFinance/OpenRouter)
Methode · Host/Pfad · Status. Token und Secret erscheinen nie.
Rohe letzte Antwort
—