1. Zielsetzung des Dokuments
Dieses Dokument beschreibt die technische und funktionale Funktionsweise unseres Connectors. Es definiert den Anwendungsbereich (was abgedeckt ist und was nicht) und listet die für die Implementierung erforderlichen 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 mit allen sachkundigen Personen (CIO, CFO, Hauptbuchhalter, IT-Manager) durchzugehen. Ziel ist es:
Zu überprüfen, ob die vorgeschlagenen Flows Ihren geschäftlichen Anforderungen entsprechen.
Zu bestätigen, 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
EBP ist eine Buchhaltungssoftware, die von EBP Informatique bereitgestellt wird. Diese Integration ermöglicht die Synchronisierung von EBP-Daten mit Agicap und unterstützt Multi-Entity- und Multi-Währungs-Umgebungen, Zahlungs-Vorabstimmung und erweiterte Automatisierung.
In diesem Abschnitt werden die Voraussetzungen für die Nutzung des Connectors beschrieben.
2.1 Technische Voraussetzungen
Die Integration ist kompatibel mit lokalen EBP-Installationen, einschließlich EBP, das auf dem Server Ihres Integrators gehostet wird (oft als "Cloud" bezeichnet), sofern Server- und SQL-Zugriff gewährt werden kann. Das eigene SaaS-Cloud-Angebot von EBP wird nicht unterstützt.
Unterstützt ✅ | Nicht unterstützt ❌ |
• EBP Buchhaltung (Compta) On-Premise, Pro- und PME-Reihen ab Version 21.0 • EBP gehostet auf dem Server oder der VM eines Integrators, sofern Server- und SQL-Zugriff gewährt werden kann | • EBP SaaS-Cloud-Angebot • EBP-Versionen unter 21.0 |
Die genaue Version wird während der Implementierungsphase mit Ihrem EBP-Integrator und dem Agicap-Technikteam bestätigt.
2.2 Organisation der Implementierung & Setup-Voraussetzungen
Die Installation dieses Connectors ist ein kollaborativer Prozess, der die Beteiligung von drei Parteien erfordert:
Ihr Team: Für die Validierung der Zugänge und Auswahl der zu synchronisierenden Konten.
Ihr Managed Service Provider: Für die Freigabe des Serverzugriffs und die Installation der technischen Komponente.
Ihr technisches Team: Für Konfiguration, Flow-Tests und Inbetriebnahme.
Für den Betrieb ist die Installation eines Verbindungsagenten auf Ihrem EBP-Server erforderlich: IO Manager Service Installation. Dieser Service ist pro Kunde einzigartig und die Einrichtung ist Teil des Projekt-Onboardings.
2.3 Setup-Voraussetzungen
EBP-Umgebung
Windows-Regionseinstellungen: Die Windows-Kultur muss auf fr-FR eingestellt sein, bevor die EBP-Datenbank auf dem Server installiert wird.
SQL-Instanz: Alle EBP-Unternehmen eines Projekts müssen auf derselben SQL-Instanz gehostet werden. Wenn Ihre Unternehmen auf mehrere SQL-Instanzen verteilt sind, ist pro Instanz ein Projekt erforderlich.
Datenbankmodell: eine SQL-Datenbank = ein EBP-Unternehmen = eine Agicap-Entität.
Debitoren-/Kreditorenbuchhaltung: nicht erforderlich. Ohne Debitoren-/Kreditorenbuchhaltung liest der Connector stattdessen die Sachkonten.
Vor der Verbindung: Löschen Sie die Demo- (fiktiven) Daten aus Ihrem Agicap-Konto, damit diese nicht mit den aus EBP synchronisierten Daten vermischt werden.
iO-Service-Zugriff
Antivirus: Schließen Sie die Ordner
C:\Program Files (x86)\Les Editions CoMPAGNoNSundC:\ProgramData\Les Editions CoMPAGNoNS(empfohlen) oder zumindest ProjectLauncherFx.exe, ProjectLauncherNet.exe, serviceutlis.exe und updater.exe aus. Andernfalls kann der Antivirus den Dienst oder dessen Updates blockieren.Ordnerrechte: Das iO-Service-Konto 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-Service ("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).
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 |
443 | Ausgehend | Flowwa API-Gateway (PAPI) | |
443 | Ausgehend | Azure Service Bus, sichere Verbindung zwischen iO und dem lokalen Service |
3.1 Flowwa
Agicap arbeitet mit Flowwa und seiner 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 Technikteams 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 in Echtzeit direkt nach jeder Datenabfrage vom 'IO Manager Agent' an die Agicap-APIs gesendet:
Open API : Für erwartete Cash-Transaktionen 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 -frequenz 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 (eine SQL-Datenbank = ein EBP-Unternehmen = eine Agicap-Entität).
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 Daten- und Synchronisationsanpassungen
Anpassungen können vorgenommen werden, um die Bezeichnungen, Daten oder Beträge der importierten Daten anzupassen. Die Machbarkeit wird vom Agicap-Technikteam geprüft.
Die synchronisierten Daten können nach bestimmten 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.
In EBP vorab zugeordnete Transaktionen erscheinen in Agicap nur mit ihrem offenen (nicht bezahlten) Saldo.
4. Flows & Anwendungsfälle
Hier sind die über den Connector verfügbaren Funktionen aufgeführt. Einige Flows sind als "Beta" gekennzeichnet, d. h. sie befinden sich in schrittweiser Einführung oder in der abschließenden Testphase.
Name | Status | Flow-Typ | Beschreibung | Einschränkungen |
PA-Emission (nur Frankreich) | 🔴 Nicht verfügbar | |||
PA-Empfang (nur Frankreich) | 🔴 Nicht verfügbar | |||
[VERALTET] Nur erwartete Transaktionen in Agicap importieren | 🔴 Nicht verfügbar | ERP → Agicap | TRY mit erwarteten Transaktionen befüllen | VERALTET: Legacy-OpenAPI-Flow, ersetzt durch "Import Business Docs in Agicap" (Public API). Nicht für neue Verbindungen verwenden. Diese Seite wird gelöscht, sobald alle Verbindungen migriert wurden. |
Export der Abstimmung im ERP über das Bankjournal | 🔴 Nicht verfügbar | |||
Prognosen aus Agicap exportieren | 🔴 Nicht verfügbar | Agicap → ERP | ||
Business-Dokumente in Agicap importieren | 🟢 Verfügbar | ERP → Agicap | TRY mit erwarteten Transaktionen, AR mit zu zahlenden Rechnungen und zur Nachverfolgung + Gutschriften befüllen | PublicAPI: Ruft nur die Einkaufs- und Verkaufsjournale ab 1. Es werden nur die abgeglichenen Buchungen des aktuellen Geschäftsjahres und der letzten 6 Monate des vorherigen Geschäftsjahres synchronisiert, die die oben genannten Kriterien erfüllen 2. Es können nur AN der letzten 4 Geschäftsjahre abgerufen werden (die Originaldokumente des aktuellen Geschäftsjahres + wenn sie mit einem AN bis zu 4 Jahre verknüpft sind) ⚠️ Nicht verfügbar, wenn es sich um EBP Cloud handelt, es sei denn, es wird auf dem Server des Integrators gehostet (dann kann es als On-Premise behandelt werden). |
AP-Rechnungen aus Agicap exportieren | 🔴 Nicht verfügbar | Agicap → ERP | Use Case für PDP noch zu präzisieren (für französische ERPs) | |
Kundenstamm & Kontakte in Agicap importieren | 🔴 Nicht verfügbar | ERP → Agicap | AR-Modul von Agicap mit Kundendaten aus dem ERP befüllen, um manuelle Aktualisierungen in Agicap zu vermeiden | |
Einkaufsjournal aus Agicap ins ERP exportieren | 🔴 Nicht verfügbar | Agicap → ERP | Agicap SIM OCR nutzen, um Lieferantenrechnungen zu digitalisieren und sie mit dem zugehörigen PDF im Einkaufsjournal zu erstellen | |
Mahnungen aus Agicap AR exportieren | 🔴 Nicht verfügbar | Agicap → ERP | ||
Begünstigte in Agicap importieren | 🔴 Nicht verfügbar | ERP → Agicap | Agicap-Liste der Begünstigten im Zahlungsmodul einspielen, um das manuelle Erstellen/Aktualisieren zu vermeiden. + Sicherheitsaspekt: Fehler oder betrügerische Änderungen in Agicap vermeiden | |
Kontenplan / Kundennummer-/Lieferantennummer in Agicap importieren | 🔴 Nicht verfügbar | ERP → Agicap | ||
Spend-Bankjournal aus Agicap exportieren | 🔴 Nicht verfügbar | Agicap → ERP | Automatisieren Sie die Erstellung von Bankjournalbuchungen im ERP für Transaktionen, die mit dem Spend-Modul in Agicap durchgeführt wurden | |
Bankauszüge aus Agicap ins ERP exportieren | 🔴 Nicht verfügbar | Agicap → ERP | Automatisieren Sie die Synchronisierung des Kontenplans und der Drittparteienkonten zwischen ERP und Agicap | |
Konzerninterne Finanzierung aus Agicap exportieren | 🔴 Nicht verfügbar | Agicap → ERP | ||
Finanzanlagen aus Agicap exportieren | 🔴 Nicht verfügbar | Agicap → ERP | ||
Zahlungsdateien in Agicap importieren | 🔴 Nicht verfügbar | ERP → Agicap | Nutzen Sie die Agicap-Bankenanbindung, um den Zahlungsprozess zu automatisieren und eine bessere Sicherheit zu gewährleisten | |
Finanzierungen aus Agicap exportieren | 🔴 Nicht verfügbar | Agicap → ERP | ||
Bankjournal ohne Automatisierung der Abstimmung TRY ins ERP exportieren | 🔴 Nicht verfügbar | Agicap → ERP | Nutzen Sie das Agicap-Abstimmungs- und Bankjournalmodul, um die Erstellung des Bankjournals zu automatisieren + automatische Abstimmung von AR/AP-Rechnungen | |
AP-Bestellungen aus Agicap exportieren | 🔴 Nicht verfügbar | Agicap → ERP | Use Case für PDP ist noch zu präzisieren (für französische ERPs) |
Hinweis: Für BETA-Funktionen kann je nach Komplexität Ihrer Umgebung ein zusätzlicher Implementierungszeitraum erforderlich sein.
5. Häufig gestellte Fragen (FAQ)
Können mehrere Synchronisierungen pro Tag erfolgen?
Ja, Synchronisierungszeiten und -frequenzen sind während der Implementierung konfigurierbar; mehrere tägliche Synchronisierungen sind möglich.
Was passiert, wenn ein Kunde nur bestimmte Konten oder Journale 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 Synchronisierungen sehen?
Das Datum der letzten Synchronisierung wird neben dem Verbindungsnamen in Banken & Integrationen angezeigt. Detaillierte Protokolle und Nachverfolgungsinformationen können beim Agicap Support angefordert werden.
Werden Zwischenzahlungen in der Treasury berücksichtigt?
Eine erwartete Transaktion in der Treasury, die von einer Zwischenzahlung betroffen ist, wird direkt mit ihrem Restbetrag angezeigt.
Benötigen Sie Hilfe oder weitere Informationen?
Kontaktieren Sie Ihren Agicap Support.