🔥 DOKUMENT ZUM TEILEN MIT INTERESSENTEN:Google Doc VersionPDF-Version:Datei nicht verfügbar
1. Ziel des Dokuments
Dieses Dokument soll den technischen und funktionalen Betrieb unseres Connectors im Detail beschreiben. Es definiert den Handlungsbereich (was abgedeckt ist oder 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 nutzt man dieses Dokument? Wir empfehlen, dieses Dokument mit allen sachkundigen Personen (CIO, CFO, Hauptbuchhalter, IT-Manager) durchzugehen, mit dem Ziel:
Überprüfen, ob die vorgeschlagenen Flows Ihren Geschäftsanforderungen entsprechen.
Bestätigen, dass Ihre technische Umgebung die Installationsvoraussetzungen erfüllt.
⚠️ Deployment Methodology:Unser Ansatz ist pragmatisch. Wenn nach Analyse die Voraussetzungen als erfüllt erscheinen, bevorzugen wir die Installation des nativen Connectors.Falls jedoch aus technischen Gründen oder aufgrund einer spezifischen Konfiguration der Connector nicht aktiviert werden kann, wechseln wir problemlos auf eine alternative Methode via SFTP, um die Kontinuität Ihres Projekts zu gewährleisten.
2. Voraussetzungen und Bereitstellung
Sage 100 ist eine Buchhaltungssoftware von Sage. Diese Integration ermöglicht die Synchronisierung von Sage 100 Daten mit Agicap und unterstützt Multi-Entity- und Multi-Währungs-Umgebungen, Zahlungs-Vorabstimmung und fortgeschrittene Automatisierung.
Diese Integration funktioniert nur für FRANKREICH und dieser Abschnitt beschreibt die Voraussetzungen für die Nutzung des Connectors.
2.1 Technische Voraussetzungen
Die Integration ist mit dem Großteil des Sage 100 Ökosystems kompatibel.
Unterstützte Versionen ✅ | Teilweise unterstützt 🏗️ | Nicht unterstützte Versionen ❌ |
• Sage 100 Comptabilité (v6 und höher) • Sage 100c • Sage 100c Comptabilité • Sage 100 i7 • Sage 100 Cloud • Sage 100 Entreprise • Sage 100 Suite comptable et financière | • Sage 100 Sage Partner Cloud (SPC, gehostet auf Sage Cloud/Azure) → Beta für: Geschäftsdokumente, Export Einkaufsjournal, Export Bankjournal & Zahlungsdateien (noch nicht getestet) → ⚠️ Voraussetzung: iO Execution Agent muss innerhalb der SPC-Umgebung installiert sein | • Andere Produkte außerhalb der Sage 100 Suite • Sage 100 Gestion commerciale • Sage 100 Paie • Sage 100 Online, Sage Hébergé (private Sage Cloud gehostet) • Sage 100 Essential Comptabilité 7.00 cloud / Sage Online (noch nicht verfügbar) |
So prüfen Sie Ihre Version
Öffnen Sie Sage 100
Klicken Sie auf "
?" dann "A propos de…"
2.2 Organisation der Bereitstellung & Installationsvoraussetzungen
Die Installation dieses Connectors ist ein kollaborativer Prozess, der das Eingreifen von drei Beteiligten erfordert:
Ihre Teams: Zur Validierung der Zugänge und Auswahl der zu synchronisierenden Konten.
Ihr Managed Service Provider: Zum Öffnen des Serverzugangs und zur 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 Sage-Server erforderlich: IO Manager Service Installation. Dieser Service ist pro Kunde einzigartig und die Einrichtung ist Teil des IO Manager Projekt-Onboardings. Siehe Anhang für detaillierte Installationsvoraussetzungen
3. Allgemeine Informationen
Dieser Abschnitt beschreibt die globale Infrastruktur, die den Datenaustausch unterstützt.
2.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 nahtlose Datenaustausche zwischen den ERP-Systemen unserer Kunden und Agicap, sowohl für den Import von Geschäftsdaten (z. B. Rechnungen, Gutschriften, Kundenaufträge) als auch für den Export von Bankdateien von Agicap ins ERP.
Alle Verbindungen, Konfigurationen und Datenflüsse werden in enger Zusammenarbeit zwischen den technischen Teams von Agicap (CS Tech & PKM), 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.
2.2 Synchronisationsfrequenz
Daten, die über IO Manager gesammelt werden, werden in Echtzeit nach jeder Datenabfrage durch den 'IO Manager Agent' an die Agicap-APIs gesendet:
Open API : Für erwartete Liquiditätstransaktionen im Treasury-Modul (Synchronisation in Agicap nur zu vollen oder halben Stunden – z. B. 08:00 oder 08:30 oder 10:00 oder 10:30…)
Offentliche API : Für Geschäftsdokumente im Accounts Receivable Modul
Import-/Export-Flows sind gesichert: Flowwa speichert oder visualisiert keine Kundendaten, sondern überträgt sie nur über die IO Manager Plattform.
In Agicap synchronisiert die Verbindung nur, wenn neue Daten oder Updates zu synchronisieren sind.
4. Flows & Anwendungsfälle
Hier sind die über den Connector verfügbaren Funktionen. Einige Flows sind als "Beta" gekennzeichnet, d. h. sie befinden sich in schrittweiser Einführung oder Endtestphase.
Für weitere technische Details zu zusätzlichen Einstellungen und Einschränkungen pro Anwendungsfall siehe Anhang
Name | Status | Flow-Typ | Beschreibung | Einschränkungen |
Automatische Rechnungsabstimmung über Bankjournal-Export | In Beta | Einige Kunden nutzen dieses Beta, sei es mit in das ERP Agicap Einkaufsjournal importierten Rechnungen oder mit aus dem ERP exportierten Rechnungen über Geschäftsdokumente | ||
PA-Ausgabe | Geplant | Agicap -> ERP | SFTP vorerst | |
PA-Empfang | In Beta | Agicap -> ERP | ||
Nur erwartete Transaktionen in Agicap importieren | Verfügbar | ERP -> Agicap | TRY mit erwarteten Transaktionen befüllen | OpenAPI-Verbindung: Dieser Verbindungstyp wird zukünftig abgeschafft |
AP-Bestellungen aus Agicap exportieren | Nicht verfügbar | Agicap -> ERP | Anwendungsfall für PDP noch zu präzisieren (für französische ERPs) | |
Schulden aus Agicap exportieren | Nicht verfügbar | Agicap -> ERP | ||
Konzerninterne Finanzierung aus Agicap exportieren | Nicht verfügbar | Agicap -> ERP | ||
Bankauszüge von Agicap ins ERP exportieren | Verfügbar | Agicap -> ERP | Automatisieren Sie die Synchronisation des Kontenplans und der Drittparteienkonten zwischen ERP und Agicap | Auszüge werden in einen Ordner auf dem Kundenserver exportiert, aber nicht direkt in Sage |
Geschäftsdokumente 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 das Einkaufs- und Verkaufsjournal ab1. Nur die abgeglichenen Buchungen des aktuellen Geschäftsjahres und der letzten 6 Monate des vorherigen Geschäftsjahres, die die obigen Kriterien erfüllen, werden synchronisiert2. Nur AN der letzten 4 Geschäftsjahre können abgerufen werden (die Originaldokumente des aktuellen Geschäftsjahres + wenn mit einem AN bis zu 4 Jahre verknüpft) |
Follow-ups aus Agicap AR exportieren | Nicht verfügbar | Agicap -> ERP | ||
Finanzanlagen aus Agicap exportieren | Nicht verfügbar | Agicap -> ERP | ||
Zahlungsdateien in Agicap importieren | In Beta | ERP -> Agicap | Nutzen Sie die Agicap-Bankenanbindung, um den Zahlungsprozess zu automatisieren und mehr Sicherheit zu bieten | Derzeit nicht verfügbar, wenn der Kunde auf Sage SPC ist |
Kundenstamm & Kontakte in Agicap importieren | Geplant | ERP -> Agicap | Befüllen Sie das Agicap AR-Modul mit Kundendaten aus dem ERP, um manuelle Updates in Agicap zu vermeiden | |
Einkaufsjournal aus Agicap ins ERP exportieren (inkl. PDFs) | Verfügbar | Agicap -> ERP | Nutzen Sie Agicap SIM OCR, um Lieferantenrechnungen zu digitalisieren und sie mit zugehörigem PDF im Einkaufsjournal zu erstellen | Die Buchungen können nur in einem Journalcode pro Entität exportiert werden |
Bankjournal TRY ins ERP exportieren | Verfügbar | Agicap -> ERP | Nutzen Sie Agicap-Abstimmung und Bankjournal-Modul, um die Erstellung des Bankjournals zu automatisieren + automatische Abstimmung von AR/AP-Rechnungen | Funktioniert nicht, wenn die „centralisation en fin de mois“ in Sage 100 FR im „journal de trésorerie“ aktiviert ist (eine monatliche Bankjournalbuchung jeweils zum Monatsende) |
AP-Rechnungen aus Agicap exportieren | Nicht verfügbar | Agicap -> ERP | Anwendungsfall für PDP noch zu präzisieren (für französische ERPs) | |
Begünstigte in Agicap importieren | Nicht verfügbar | ERP -> Agicap | Befüllen Sie die Agicap-Liste der Begünstigten im Zahlungsmodul, um manuelle Erstellung/Aktualisierung zu vermeiden. + Sicherheitsbedarf: Fehler oder betrügerische Änderungen in Agicap vermeiden | |
Prognosen aus Agicap exportieren | Nicht verfügbar | Agicap -> ERP | ||
Kontenplan / Drittparteiennummern in Agicap importieren | Verfügbar | ERP -> Agicap | Der Import ist nur für TRY. Um die Daten auch in AP zu erhalten, ist ein AFT erforderlich. | |
Spend Bankjournal aus Agicap exportieren | In Beta | Agicap -> ERP | Automatisieren Sie die Erstellung von Bankjournalbuchungen im ERP für Transaktionen, die mit dem Spend-Modul in Agicap durchgeführt wurden | 1 Kunde live |
Hinweis: Für BETA-Funktionen kann je nach Komplexität Ihrer Umgebung ein zusätzlicher Bereitstellungszeitraum erforderlich sein
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 möchte?
Während der Implementierung kann das technische Team Filter für ein- oder auszuschließende Konten und gefilterte Journale setzen.
Wo kann ich den Status der Synchronisationen sehen?
Das Datum der letzten Synchronisation wird neben dem Verbindungsnamen im Tab Bank & Integration angezeigt; Synchronisationsstatus und Protokolle sowie Nachverfolgbarkeitsinformationen sind nur für den Agicap-Support zugänglich.
Werden Zwischenzahlungen im Treasury berücksichtigt?
Eine im Treasury erfasste Operation, die von einer Zwischenzahlung betroffen ist, wird direkt mit ihrem Restbetrag angezeigt.
Wie werden PDFs mit Sage synchronisiert?
Die Datei wird von Flowwa in einen temporären Ordner hochgeladen. Der Dateipfad wird in Sage aktualisiert. Sages Objets Métiers verschieben die Datei in ein Medienverzeichnis und erstellen den Link.
6. Technische Anhänge
Setup-Voraussetzungen
Setup-Voraussetzungen
Bitte überprüfen und validieren Sie vor der Konfiguration der Sage 100 Verbindung die folgenden Punkte:
Betriebssystem: Windows Server 2016 (oder höher) oder Windows 8 (oder höher).
Datenbankverwaltung: SQL Server Management Studio (SSMS) muss auf dem Sage 100 Server installiert sein.
Framework: .NET Framework Version 4.7.2 (oder höher) muss auf dem SQL Server installiert sein.
SQL Server Version: Mindestens Version 2016 (Version 13.X).
Sage-Komponenten: Der Dienst "Sage 100 Objets Métiers" muss in Ihrer Sage 100 Umgebung installiert sein.
Berechtigungen: Schreibrechte für Daten sind für Buchungsfälle erforderlich.
Hinweise zum Zugriff auf den iO-Service
Die Implementierung des Connectors beinhaltet die Installation eines Windows-Dienstes, der aus den Sage 100 Datenbanken liest und in diese schreibt. Sie müssen sicherstellen, dass dieser Dienst ausreichende Berechtigungen für die Ordner und Datenbanken hat, auf die er zugreifen muss.
Wenn der iO-Service nicht unter dem Local System Account ausgeführt wird, muss ein dediziertes Windows-Konto mit Lese-/Schreibrechten auf den relevanten Sage 100 SQL-Datenbanken erstellt werden.
Dieses Konto muss konfiguriert werden als:
SQL Server Login.
Auf allen SQL-Instanzen, die von Plugins genutzt werden, die auf Sage 100 basieren.
Wenn der Server, der den iO-Service hostet, ein anderer ist als der SQL-Server:
Das Servicekonto muss ein Domänenkonto sein.
Es muss die entsprechenden Berechtigungen auf der entfernten SQL-Instanz haben
Datenabfrage & Filterung
Der IO Manager Service fragt routinemäßig das ERP des Kunden nach neuen oder aktualisierten Daten ab.
Die Häufigkeit und der Zeitplan für diese Abfragen können pro Projekt im IO Manager konfiguriert werden.
Filter können angewendet werden, um die Datenerfassung nach Journalen oder Sachkonten direkt im IO Manager einzuschränken.
Ein spezifischer Geschäftsjahresabruf kann direkt im IO Manager eingerichtet werden.
Allgemeine Informationen zu Datenflüssen, Sicherheit, Datenfeldern
Daten-Synchronisations-Flow
1️⃣ Eine geplante Aufgabe startet den Sage Connector Service.
2️⃣ Der Service fragt die Sage-Datenbank nach allen nicht abgestimmten Buchungen geschlossener Kunden- und Lieferantenrechnungen ab.
3️⃣ Der Service ruft die Agicap-API auf, um Buchungen nach Bedarf zu erstellen, zu löschen oder zu aktualisieren.
Daten- und Synchronisationsanpassungen
Agicap-Anpassungen können angewendet werden, um Bezeichnungen, Daten oder Beträge der importierten Daten anzupassen (die Machbarkeit muss vom Agicap-Technikteam geprüft werden).
Die synchronisierten Daten können nach spezifischen Regeln gefiltert werden (die Machbarkeit muss vom Agicap-Technikteam geprüft werden).
API & Sicherheit
REST API über HTTPS (TLS-Verschlüsselung)
Rate Limiting: 100 Anfragen/Min/Nutzer; darüber hinaus wird ein HTTP 429 Fehler zurückgegeben; Infrastruktur unterstützt 500k+ Anfragen von über 150 Nutzern in wenigen Stunden
Authentifizierung: Token aus Agicap-Oberfläche; wird in der API-Autorisierung verwendet (nicht im Header)
Kein Risiko für SQL-/Code-Injection: nur JSON-Eingabe; Objekte sind streng formatiert
Verwendete Datenbanktabellen: F_ECRITUREC, F_COMPTET, F_COMPTEG, F_JOURNAUX
Multi-Entity- und Multi-Währungs-Unterstützung
Unterstützt Multi-Entity- und Multi-Währungs-Setups. Agicap erstellt ein Konto pro Entität (Unternehmen) und Währung im Treasury-Modul.
Beispiel:
Unternehmen ALPHA (EUR), Unternehmen ALPHA (USD)
Unternehmen BETA (EUR), Unternehmen BETA (USD)
Datenfelder & Datumslogik
Sage 100 Datumslogik
Rechnungsdatum
Kombination: JM_date (Monat/Jahr) + EC_jour (Tag)
Beispiel:**F_ECRITUREC_JM_Date = 2023-11-01F_ECRITUREC_EC_Jour = 8**→ Rechnungsdatum: 2023-11-08
Zahlungsdatum
Wenn abgestimmt: Feld EC_Echeance verwenden
Wenn abgestimmt und EC_Echeance leer: Rückgriff auf Rechnungsdatum (JM_date + EC_jour)
Wenn nicht abgestimmt: Rechnungsdatum verwenden
Details pro Anwendungsfall
Details pro Anwendungsfall
Bankdateien nach Sage 100 exportieren
Dieser Connector ermöglicht es Kunden, Agicap als Datenquelle für den Export von Bankdateien in ihr ERP zu nutzen.
💡
Automatischer Export von in Agicap gesammelten Bankdateien in einen bestimmten Ordner auf Ihrem Sage 100 Server.
Dateien werden NICHT automatisch in Sage 100 importiert; manueller Import ist erforderlich.
Jede über die öffentliche API von Agicap verfügbare Bankdatei ist zulässig.
Weitere Informationen zu dieser Funktion finden Sie unter:
Der Kunde muss die exportierte Datei weiterhin manuell in sein ERP importieren. Dieser Connector kann die Datei nur in einen bestimmten Ordner auf dem Server des Kunden übertragen, löst aber keinen Importprozess im ERP aus.
Kontenplan importieren (TRY, AR)
Zusätzliche Einstellungen
IO
⚠️ Sie müssen die Quelle im Tab „Geschäftsdokumente / Engagés“ ausfüllen
Aktivieren Sie das Feld „aktiv“ bei „Lieferantenkonten“ und „Sachkonten“