1. Zielsetzung des Dokuments

Dieses Dokument hat das Ziel, den technischen und funktionalen Betrieb unseres Connectors im Detail zu beschreiben. Es definiert den Anwendungsbereich (was abgedeckt ist und was nicht) und listet die für die Implementierung notwendigen Voraussetzungen auf.

Wichtiger Hinweis: Unsere Teams stehen Ihnen zur Verfügung, falls Sie Klarstellungen oder weitere Informationen benötigen.

Wie verwendet man dieses Dokument? Wir empfehlen, dieses Dokument gemeinsam mit allen fachkundigen Personen (CIO, CFO, Hauptbuchhalter, IT-Manager) durchzugehen. Ziel ist es:

Überprüfen Sie, ob die vorgeschlagenen Flows Ihren geschäftlichen Anforderungen entsprechen.
Bestätigen Sie, dass Ihre technische Umgebung die Installationsvoraussetzungen erfüllt.

⚠️ Vorgehensweise bei der Implementierung: Unser Ansatz ist pragmatisch. Wenn nach der Analyse die Voraussetzungen als erfüllt gelten, bevorzugen wir die Installation des nativen Connectors. Sollte der Connector jedoch aus technischen Gründen oder aufgrund einer speziellen Konfiguration nicht aktiviert werden können, wechseln wir problemlos auf eine alternative Methode via SFTP, um die Kontinuität Ihres Projekts sicherzustellen.

2. Voraussetzungen und Implementierung

2.1 Technische Voraussetzungen

Diese Integration funktioniert nur für FRANKREICH.

Überblick über die Sage FRP 1000 Integration

Sage FRP 1000 ist eine Buchhaltungssoftware von Sage. Diese Integration ermöglicht es Ihnen, Sage FRP 1000 Daten mit Agicap zu synchronisieren und unterstützt Multi-Entity- und Multi-Währungs-Umgebungen, Pre-Matching von Zahlungen und fortgeschrittene Automatisierung.

Unterstützte Sage FRP 1000 Versionen

Unterstützte Versionen ✅	Nicht unterstützte Versionen ❌
Sage FRP 1000 v8 und höher, unabhängig von der Bezeichnung (v8, v9R2, Version 11 2025 R2 und spätere Versionen)	Sage FRP 1000 Versionen unter v8

ℹ️ Sage hat die Versionsbezeichnungen im Laufe der Zeit geändert (v8, v9R2, dann "11 2025 R2"). Es gibt keine obere Versionsgrenze. Jede Version ab v8 ist abgedeckt. Die Unterstützung der Version ist unabhängig von den unten genannten Servervoraussetzungen (Windows Server 2016+, .NET 4.7.2+, SQL Server 2016+ für Geschäftsdokumente).

Verbindung von Sage FRP 1000 mit Agicap

⚠️ Für diese Integration ist eine Softwareinstallation auf dem Sage-Server erforderlich, die vom Agicap-Technikteam durchgeführt wird, aber die Einbindung von IT/Integrator/Server-Administrator erfordert.

Ihre Setup-Voraussetzungen

Windows Server 2016 oder höher / Windows 8 oder höher
.NET Framework 4.7.2 (oder höher) auf dem SQL-Server installiert
Administratorzugriff auf den Server, auf dem die Sage-Datenbanken gehostet werden
Name des SQL-Servers und der Sage-Datenbanken
(Optional) SQL-Benutzer für Agicap mit Lesezugriff
Sie müssen einen API-Schlüssel generieren (Einstellungslink); das Agicap-Technikteam wird Sie dabei anleiten.
Die Synchronisierung von Geschäftsdokumenten wird ab SQL Server 2016 unterstützt.
Antivirus: Schließen Sie die Ordner C:\Program Files (x86)\Les Editions CoMPAGNoNS und C:\ProgramData\Les Editions CoMPAGNoNS (empfohlen) oder zumindest ProjectLauncherFx.exe, ProjectLauncherNet.exe, serviceutlis.exe und updater.exe vom Scan aus. Andernfalls kann der Antivirus den Dienst oder dessen Updates blockieren.
Das iO-Servicekonto benötigt Lese- und Schreibrechte für diese beiden Ordner sowie das Recht, msiexec.exe auszuführen, das für Service-Updates verwendet wird.
Starttyp: Der iO-Dienst ("iO Main Local Service") muss in den Windows-Diensten auf Automatisch gestellt sein. Andernfalls startet er nach einem Serverneustart nicht neu und die Flows stoppen ohne Fehlermeldung (z. B. werden Kontoauszüge nicht mehr abgelegt).

2.2 Organisation der Implementierung & Setup-Voraussetzungen

Die Installation dieses Connectors ist ein kollaborativer Prozess, der das Eingreifen von drei Beteiligten erfordert:

Ihr Team: Für die Validierung der Zugriffe und die Auswahl der zu synchronisierenden Konten.
Ihr Managed Service Provider: Für das Öffnen des Serverzugriffs und die Installation der technischen Komponente.
Ihr technisches Team: Für die Konfiguration, das Testen der Flows und die Inbetriebnahme.

Für den Betrieb ist die Installation eines Liaison-Agents auf Ihrem Sage-Server erforderlich (der iO Manager Service). Dieser Dienst ist pro Kunde einzigartig und die Einrichtung ist Teil des Projekt-Onboardings. Die Setup-Voraussetzungen sind in Abschnitt 2.1 oben aufgeführt; der für jeden Flow benötigte Datenbankzugriff ist in Abschnitt 6 beschrieben.

⚠️ Für das Verbindungsgespräch ist die Anwesenheit einer Person mit Administratorzugriff auf Agicap und einer Person mit Zugriff auf das ERP (Sage FRP 1000 Server und Datenbanken) erforderlich.

3. Allgemeine Informationen

In diesem Abschnitt wird die globale Infrastruktur beschrieben, die den Datenaustausch unterstützt.

Domain / IP	Port	Richtung	Kommentare
.iomanager.app	443	Ausgehend	Ausgehende Kommunikation mit iO für Buchhaltungs- und Journalfunktionen
iO Manager Service IP: 20.19.239.7	443	Eingehend	Eingehende Kommunikation mit iO für Geschäftsanfragen. Nur relevant für SaaS-ERPs
papi.lestudio.app	443	Ausgehend	Flowwa API-Gateway (PAPI)
sb-papi-prod-00000001-iO.servicebus.windows.net und sb-papi-prod-00000001-iO-02.servicebus.windows.net	443	Ausgehend	Azure Service Bus, sichere Verbindung zwischen iO und dem lokalen Dienst

3.1 Flowwa

Agicap arbeitet mit Flowwa und dessen Plattform IO Manager zusammen, um die Integration mit On-Premise-ERPs wie Sage 100, Sage FRP 1000 und EBP (nicht die Cloud-Versionen) zu ermöglichen. Diese Partnerschaft ermöglicht einen nahtlosen Datenaustausch zwischen den ERP-Systemen unserer Kunden und Agicap und unterstützt sowohl den Import von Geschäftsdaten (z. B. Rechnungen, Gutschriften, Kundenaufträge) als auch den Export von Zahlungsdateien aus Agicap ins ERP.

Alle Verbindungen, Konfigurationen und Datenflüsse werden in enger Zusammenarbeit zwischen den technischen Teams von Agicap, unseren Kunden und Flowwa als Integrationsanbieter eingerichtet und gewartet.

Was ist Flowwa? Es handelt sich um eine Datenintegrationsplattform (iPaaS), die auf die Verbindung von SaaS-Software und ERPs spezialisiert ist.
Sicherheit: Flowwa gewährleistet den sicheren Transport der Daten, ohne Ihre Buchhaltungsdaten dauerhaft auf seinen Servern zu speichern, und garantiert so optimale Vertraulichkeit.

3.2 Synchronisationsfrequenz

Daten, die über den IO Manager erfasst werden, werden direkt nach jeder Datenabfrage in Echtzeit an die Agicap-APIs gesendet:
- Open API: Für erwartete Liquiditätstransaktionen im Treasury-Modul (werden in Agicap nur zu vollen oder halben Stunden synchronisiert – z. B. 08:00 oder 08:30 oder 10:00 oder 10:30 …)
- Public API: Für Geschäftsdokumente im Accounts Receivable-Modul

Import-/Export-Flows sind gesichert: Flowwa speichert oder visualisiert keine Kundendaten, sondern übernimmt nur die Übertragung über die IO Manager Plattform.
Für jede Integration wird in Agicap eine identifizierbare Verbindung erstellt (als Liquiditätsintegration oder als Geschäftsintegration, je nach unten erklärtem Anwendungsfall).
In Agicap synchronisiert die Verbindung nur, wenn neue Daten oder Aktualisierungen zu synchronisieren sind.
Synchronisationszeiten und -frequenzen werden während der Implementierung konfiguriert: Der Connector kann beliebig oft pro Tag synchronisieren.

3.3 Multi-Entity- und Multi-Währungs-Unterstützung

Der Connector unterstützt Multi-Entity- und Multi-Währungs-Setups.
Agicap erstellt im Treasury-Modul für jede Entität (Firma) und jede Währung ein Konto.
Beispiel: Unternehmen ALPHA (EUR), Unternehmen ALPHA (USD), Unternehmen BETA (EUR), Unternehmen BETA (USD).

3.4 Anpassungen von Daten und Synchronisation

Anpassungen können vorgenommen werden, um die Bezeichnungen, Daten oder Beträge der importierten Daten zu modifizieren. Die Machbarkeit wird vom Agicap-Technikteam geprüft.
Die synchronisierten Daten können nach spezifischen Regeln gefiltert werden. Die Machbarkeit wird vom Agicap-Technikteam geprüft.

3.5 Pre-Matching (Pré-lettrage) Unterstützung

Pre-Matching wird unterstützt: In Agicap wird nur der noch offene Betrag angezeigt, nicht der gesamte Rechnungsbetrag.
Transaktionen, die in Sage FRP 1000 vorab zugeordnet wurden, erscheinen in Agicap nur mit ihrem offenen (unbezahlten) Saldo.

4. Flows & Anwendungsfälle

Hier sind die über den Connector verfügbaren Funktionen aufgeführt. Einige Flows sind als "Beta" gekennzeichnet, was bedeutet, dass sie sich im schrittweisen Rollout oder in der abschließenden Testphase befinden.

Weitere technische Details zu zusätzlichen Einstellungen und Einschränkungen je Anwendungsfall finden Sie im Anhang.

Hinweis: Für BETA-Funktionen kann je nach Komplexität Ihrer Umgebung ein zusätzlicher Implementierungszeitraum erforderlich sein.

⚠️ Es ist nicht möglich, das Accounts Payable-Modul von Agicap mit einer Sage FRP 1000-Verbindung zu befüllen.

5. Häufig gestellte Fragen (FAQ)

Können mehrere Synchronisationen pro Tag erfolgen?

Ja, Synchronisationszeiten und -frequenzen sind während der Implementierung konfigurierbar; mehrere tägliche Synchronisationen sind möglich.

Was passiert, wenn ein Kunde nur bestimmte Konten oder Journale synchronisieren möchte?

Während der Implementierung kann das Technikteam Filter für ein- oder auszuschließende Konten und gefilterte Journale einrichten.

Wo kann ich den Status der Synchronisationen sehen?

Das Datum der letzten Synchronisation wird neben dem Verbindungsnamen in Banken & Integrationen angezeigt. Detaillierte Protokolle und Nachverfolgungsinformationen können beim Agicap Support angefordert werden.

Werden Teilzahlungen im Treasury berücksichtigt?

Eine im Treasury erfasste Operation, die von einer Teilzahlung betroffen ist, wird direkt mit ihrem Restbetrag angezeigt.

Wie werden PDFs nach Sage synchronisiert?

Die Datei wird von Flowwa in einen temporären Ordner hochgeladen. Der Dateipfad wird in Sage aktualisiert. Die Objets métiers von Sage verschieben die Datei in ein Medienverzeichnis und erstellen den Link.

6. Technische Anhänge

6.1 Datenbankzugriff je Flow

Flow	Zugriff auf die Sage FRP 1000 Datenbank
Importe (Geschäftsdokumente, erwartete Transaktionen, Kontenplan)	SQL-Zugriff mit Leserechten.
Zahlungsdateien	Der einzige Flow, der in die Datenbank schreibt, entweder über ein von Flowwa signiertes Modul (DSM, von Ihrem Integrator installiert) oder über ein PowerShell-Skript.
Bankjournal-Export	Die Schreibmethode wird derzeit finalisiert. Die entsprechenden Voraussetzungen werden Ihnen vor der Einrichtung mitgeteilt.

6.2 API & Sicherheit

Daten werden über REST-APIs per HTTPS (TLS-Verschlüsselung) an Agicap gesendet.
Flowwa übernimmt nur die Übertragung der Daten und speichert Ihre Buchhaltungsdaten nicht dauerhaft.
Für Import-Flows kann für Agicap ein SQL-Benutzer mit Lesezugriff erstellt werden (optional, siehe 2.1).

Brauchen Sie Hilfe oder weitere Informationen?

Kontaktieren Sie Ihren Agicap-Support.

Verwandte Artikel

Sage FRP1000