Automatisierte Datenschnittstelle zwischen Factorial und Sage einrichten
Automatisierte Datenschnittstelle zwischen Factorial und Sage einrichten
📌 Diese Anleitung gilt für: BrynQ Agent 3.10 oder neuer (Screenshots: 3.10.1) · Sage 100 France v9. Andere Version? Siehe Hier starten – Version wählen.
Aktualisiert für Sage 100 France v9 und BrynQ Agent 3.10.1. Das Installationsprogramm prüft Ihr BrynQ-Token schon beim Eingeben, zeigt die Schritte für das Sage-Dienstkonto und die Importmodelle auf eigenen Seiten und legt das ConnectImport-Szenario für Sie an. Das Admin-Dashboard hat ein neues Aussehen und eine Seite Fehlerbehebung mit einer Support-Datei für den BrynQ-Support.
* Neu mit Sage v9 und Agent 3.10
Neue Mitarbeiter werden in einer separaten Datei gesendet, <dossier>_EN_ATTENTE.xlsx, die Sage in Salariés en attente importiert (Importmodell BrynQ Salariés en attente). Die Lohnabrechnung stellt sie danach in Sage ein: Gestion > Salariés en attente, die Zeilen mit Tout auswählen und auf Embaucher klicken. Bis sie eingestellt sind, überspringt BrynQ sie bei den nächsten Läufen.
Embaucher ist erst verfügbar, wenn DPAE envoyée gesetzt ist (aus der DPAE-Frage in der Registerkarte Configuration) und die Zeilen mit Tout ausgewählt sind.
Stellen Sie für die DPAE sicher, dass Geburtsort und Ende der Probezeit in Factorial ausgefüllt sind.
Sage v9 verlangt, dass die Matricule (Mitarbeiternummer) genau 4 Zeichen lang ist.
Fehler 'Code pays inexistant': Das Land muss der 3-stellige Code sein (zum Beispiel FRA). Die vorausgefüllte Länderzuordnung erledigt das.
Der Import meldet 'Import terminé avec succès', aber Sie sehen den Mitarbeiter nicht: In v9 erscheinen neue Mitarbeiter zuerst unter Salariés en attente.
Neuer Installationsschritt: Legen Sie in Sage drei leere Importmodelle mit genau den richtigen Titeln an. Siehe Schritt 5.
Was Sie erreichen
Am Ende dieser Anleitung fließen die Stammdaten der Mitarbeiter automatisch von Factorial nach Sage 100 France (v9). Keine manuellen Exporte und kein Kopieren und Einfügen.
So funktioniert es
Es hilft, sich den Ablauf vorzustellen, bevor Sie beginnen. Jeder Lauf besteht aus vier Schritten:
BrynQ liest die Mitarbeiterdaten aus Factorial.
BrynQ wandelt diese Daten in eine Excel-Importdatei um, die Sage versteht.
Der BrynQ Agent, ein kleines Programm auf Ihrem Sage-Server, empfängt die Datei.
ConnectImport importiert die Datei in die richtige Sage-Firma (PRH-Datei).
Sie richten also zwei Dinge ein: den Agent auf dem Sage-Server (Teil 1) und die Schnittstelle in BrynQ (Teil 2).
Wissen, wo Sie sind
Diese Anleitung wechselt zwischen mehreren Orten. Jeder Schritt beginnt mit einer Angabe 📍 Wo, damit Sie immer wissen, wo Sie arbeiten:
📍 Angabe
Was ist das?
Windows-Server
Der Computer (die Maschine), auf dem Sage 100 France installiert ist. Hier installieren Sie den BrynQ Agent.
SQL Server
Die Datenbank-Software, in der die Sage-Daten gespeichert sind. Sie läuft meist auf demselben Windows-Server, kann aber auch auf einer separaten Maschine laufen. Im Installationsprogramm geben Sie nur ihren Namen ein.
Sage 100 France
Die Sage-Anwendung selbst, geöffnet auf dem Windows-Server.
BrynQ
Die BrynQ-Plattform in Ihrem Browser (https://ihr-slug.app.brynq.com).
Factorial
Factorial in Ihrem Browser.
Der Weg auf einen Blick
Teil
Was Sie tun
📍 Wo
Wer
1.A
BrynQ Agent herunterladen
BrynQ, geöffnet auf dem Windows-Server
Serveradministrator
1.B
Den Agent installieren und konfigurieren und die BrynQ-Importmodelle in Sage anlegen
Windows-Server + Sage 100 France
Server- und Sage-Administrator
1.C
Prüfen, ob der Agent läuft
Windows-Server
Serveradministrator
2
Schnittstelle anlegen, konfigurieren und verbinden
BrynQ (+ Factorial und Sage zum Nachschlagen)
BrynQ- und Factorial-Administrator
Bevor Sie beginnen
Haken Sie zuerst diese Checkliste ab. Jeder Punkt verhindert einen häufigen Grund, auf halbem Weg stecken zu bleiben.
☐ Zugriff auf BrynQ mit der Berechtigung, Schnittstellen anzulegen oder zu bearbeiten.
☐ Ein Factorial-Administratorkonto mit Zugriff auf alle Mitarbeiterdaten (siehe Kasten unten).
☐ Ein Sage 100 France-Administrator sowie ein Lohnabrechnungsbenutzer, der die Importergebnisse prüfen kann.
☐ Administratorzugriff auf den Windows-Server, auf dem Sage läuft, einschließlich der Sage-PRH-Dateien und der Ordner programFiles und programData.
☐ Datenbankzugriff: Das Konto, mit dem sich der Agent beim SQL Server anmeldet (Ihr Windows-Konto oder ein SQL Server-Login), muss Zugriff auf die Datenbanken der Sage-Firmen haben. Wenn Sie unsicher sind, klären Sie das vor dem Start mit Ihrem IT-Administrator.
☐ Auf dem Windows-Server läuft Windows Server 2016 oder neuer. Auf älteren Versionen startet das Installationsprogramm nicht.
☐ Ein BrynQ-API-Token für diesen Kunden, griffbereit. Erstellen Sie es in BrynQ unter Admin Portal > API Access > Add API token und wählen Sie genau einen Kunden aus, oder fragen Sie den BrynQ-Support. Warum: Sie brauchen es sowohl in Teil 1 als auch in Teil 2. Hat das Token in BrynQ eine IP-Whitelist, muss sie die öffentliche IP-Adresse des Windows-Servers enthalten.
⚠ Verwenden Sie ein Factorial-ADMINISTRATORKONTO BrynQ synchronisiert nur die Mitarbeiter, die der verbindende Factorial-Benutzer sehen kann. Ein Konto ohne Administratorrechte bedeutet fehlende Mitarbeiter in Sage.
Zuerst ansehen: Video zu Teil 1
💡 Tipp: Sehen Sie sich ein Video an, um zu sehen, was zu tun ist, und nutzen Sie dann die schriftlichen Schritte unten für die Details jedes Schritts.
Video 1: die vollständige Installation, Schritt für Schritt erklärt (Sage v8, BrynQ Agent 3.9.4). Schritt 5 (die Importmodelle) ist nicht enthalten.
🎬 Video 2: Sage v9 und Agent 3.10, mit Schritt 5 Dieselbe Installation wie Video 1, dazu die Erklärung von Schritt 5 (die drei Importmodelle in Sage anlegen), die in Video 1 fehlt. Die übrigen Schritte zeigt es schneller; sehen Sie sich Video 1 an, wenn Sie diese ausführlicher möchten.
Dieses Video zeigt Agent 3.10.0. Seit 3.10.1 sehen einige Seiten des Installationsprogramms anders aus; maßgeblich sind die Schritte im Text unten.
Teil 1.A) BrynQ Agent auf den Windows-Server herunterladen
📍 Wo: BrynQ, geöffnet in einem Browser auf dem Windows-Server, auf dem Sage läuft. Ziel: das Installationsprogramm des Agent auf diesen Server bringen.
Melden Sie sich bei BrynQ an und gehen Sie zu Organization > Agent.
Laden Sie das neueste Installationsprogramm des BrynQ Agent herunter (brynq-agent-installer-<version>.exe).
ℹ Sicherheitswarnung? Die Dateien sind unter 'Salure ICT BV' signiert und veröffentlicht. Ihr Browser oder Windows kann sie trotzdem als nicht vertrauenswürdig markieren. Das ist normal, Sie können fortfahren.
Teil 1.B) Agent installieren und konfigurieren
📍 Wo: der Windows-Server (Installationsprogramm), dazu Sage 100 France für die Schritte 4 und 5. Ziel: den Agent installieren und mit dem SQL Server und Ihren Sage-Firmen verbinden.
💡 Tipp: Das Installationsprogramm füllt die meisten Werte selbst aus: die PRH-Dateien, die SQL-Verbindung (aus den PRH-Dateien gelesen) und die Sage-Installation, die es auf dem Server findet. Die vorgeschlagenen Werte passen meistens: Übernehmen Sie sie und klicken Sie auf Weiter, sofern ein Schritt unten nichts anderes sagt. Manche Seiten erscheinen nur, wenn sie nötig sind; Sie sehen also eventuell weniger Seiten als hier beschrieben.
⚠ Windows-Berechtigungen
Als Administrator installieren: Klicken Sie mit der rechten Maustaste auf das Installationsprogramm und wählen Sie Als Administrator ausführen.
Signierte Software: Das Installationsprogramm ist digital signiert (Rechtsklick > Eigenschaften > Digitale Signaturen zeigt den Herausgeber). Zeigt Windows Der Computer wurde durch Windows geschützt? Klicken Sie auf Weitere Informationen > Trotzdem ausführen. Erlaubt Ihre Organisation nur freigegebene Herausgeber (AppLocker, Virenschutz), bitten Sie die IT, den Agent wie unter Sicherheit beschrieben freizugeben. Datei nach dem Download blockiert? Rechtsklick > Eigenschaften > Zulassen ankreuzen.
Im Betrieb: Die BrynQ-Dienste laufen als LocalSystem. Dieses Konto braucht Lese- und Schreibrechte auf die Sage-Ordner, die PRH-Dateien und den Importordner. Bei Windows-Authentifizierung ist es auch das Konto, das SQL Server sieht: NT AUTHORITY\SYSTEM, oder das Computerkonto DOMAIN\SERVERNAME$, wenn SQL Server oder die Sage-Dateien auf einem anderen Server liegen.
Ordner von einem anderen Benutzer angelegt? Die Installation bricht ab, wenn einer der BrynQ-Ordner (zum Beispiel C:\ProgramData\BrynQ\Agent oder sein Ordner config) von einem anderen Windows-Benutzer angelegt wurde. Die Meldung nennt den Befehl takeown, der das behebt.
Ist es ein Berechtigungsproblem? Suchen Sie nach Access is denied, Permission denied oder Login failed im Protokoll des Installationsprogramms (eine Kopie liegt in C:\ProgramData\BrynQ\Agent\logs\installer, Name setup-<date>-<time>.log) oder in den Agent-Protokollen (C:\ProgramData\BrynQ\Agent\logs\agent und \sage).
Erweiterte Prüfungen (für die IT):
Dienst- und Installationsprotokolle:C:\ProgramData\BrynQ\Agent\logs\services (zum Beispiel BrynQAgentService.err.log) zeigt, warum ein Dienst angehalten wurde; logs\installer\install-post.log zeigt die Installationsschritte und den Schritt, der fehlgeschlagen ist.
Ereignisanzeige (eventvwr.msc): Unter Windows-Protokolle > System zeigen Ereignisse des Service Control Manager (Dienststeuerungs-Manager), warum ein BrynQ-Dienst nicht gestartet ist oder angehalten wurde. Unter Windows-Protokolle > Anwendung bedeutet ein SQL Server-Login failed (Ereignis 18456), dass das Agent-Konto keinen SQL-Zugriff hat.
Dienstkonto: Öffnen Sie in services.msc einen BrynQ-Dienst > Anmelden, um zu sehen, unter welchem Konto er läuft.
Ordnerzugriff: Rechtsklick auf einen Sage-Ordner > Eigenschaften > Sicherheit > Erweitert > Effektiver Zugriff, wählen Sie SYSTEM (oder das Computerkonto) und klicken Sie auf Effektiven Zugriff anzeigen.
Schritt 1: Installationsprogramm starten
Starten Sie das Installationsprogramm und wählen Sie Ihre Sprache. Das Installationsprogramm schlägt die Sprache von Windows vor. Die BrynQ-Seiten gibt es auf Englisch, Französisch, Deutsch und Niederländisch; die Lizenzvereinbarung ist auf Englisch, und die Namen der Sage-Bildschirme bleiben französisch. Die Screenshots unten sind auf Englisch.
Lesen Sie die Lizenzvereinbarung sorgfältig. Wenn Sie ihr zustimmen und den BrynQ Agent verwenden möchten, akzeptieren Sie sie, um fortzufahren.
Behalten Sie den vorgegebenen (vorausgefüllten) Installationspfad. Er passt für die meisten Umgebungen, Sie können aber auch einen anderen Ordner wählen. Diese Seite erscheint nur bei einer Erstinstallation.
Cloud-Verbindung: Fügen Sie das BrynQ-API-Token ein (siehe „Bevor Sie beginnen“). Das Installationsprogramm prüft das Token schon beim Eingeben bei BrynQ. Weiter wird verfügbar, sobald die Seite BrynQ akzeptiert dieses Token. anzeigt. Token nicht akzeptiert?
BrynQ akzeptiert dieses Token nicht (…): Prüfen Sie, ob Sie das ganze Token kopiert haben. Der Grund steht in Klammern, zum Beispiel TOKEN_NOT_FOUND oder TOKEN_EXPIRED.
BrynQ akzeptiert dieses Token nur von anderen IP-Adressen: Fügen Sie die öffentliche IP-Adresse dieses Servers in BrynQ zum Token hinzu und klicken Sie dann auf Erneut prüfen.
…es ist kein Agent-Token: Ein Agent-Token ist mit genau einem Kunden verknüpft. Verwenden Sie das Agent-Token dieses Kunden.
BrynQ war zum Prüfen des Tokens nicht erreichbar oder Die BrynQ-Plattform antwortet nicht: Warten Sie einen Moment und klicken Sie auf Erneut prüfen.
Installieren Sie erneut auf demselben Server? Die Seite meldet, dass der Server bereits verbunden ist. Lassen Sie Vorhandenes API-Token behalten (empfohlen) ausgewählt, oder wählen Sie Durch ein neues API-Token ersetzen.
Module: Aktivieren Sie Sage 100 France (unter Lohnintegrationen). Dadurch werden auch SQL Server und Dateiverwaltung eingeschaltet; sie bleiben angehakt und ausgegraut. Aktivieren Sie auch REST-Proxy, wenn BrynQ Sie darum gebeten hat. Sie können die Module später ändern, indem Sie das Installationsprogramm erneut ausführen.
Schritt 2: Ihre Sage-Firmen wählen
Kerngedanke: Jede PRH-Datei ist die Datenbank einer Firma in Sage. Eine PRH-Datei auswählen bedeutet: „BrynQ darf in diese Firma importieren“.
Das Installationsprogramm sucht zuerst nach Sage 100 Paie & RH und den PRH-Dateien auf dem Server. Das kann einige Minuten dauern. Haken Sie auf der Seite Sage-Firmen die PRH-Dateien der Firmen an, die Sie mit der Schnittstelle verbinden möchten. Nur wenn eine Firma fehlt: Fügen Sie ihre PRH-Datei mit PRH hinzufügen... hinzu. Ist diese Firma bereits angehakt, fragt das Installationsprogramm, ob ihre Datei ersetzt werden soll. Erneut suchen sucht noch einmal und behält die Dateien, die Sie hinzugefügt haben.
Schritt 3: Mit dem SQL Server verbinden
BrynQ liest die SQL-Verbindung aus den PRH-Dateien, die Sie angehakt haben. Funktioniert diese Verbindung, überspringt das Installationsprogramm diesen Schritt. Haken Sie auf der vorherigen Seite SQL-Verbindung selbst prüfen an, wenn Sie sie trotzdem sehen möchten.
SQL Server-Verbindung:
Server: Wählen Sie den vorgeschlagenen Server, oft SERVERNAME\SQLEXPRESS. Unsicher? SQL Server Management Studio zeigt den Servernamen beim Verbinden an, oder fragen Sie Ihren IT-Administrator.
Anmeldemethode:Windows-Authentifizierung, oder SQL Server-Authentifizierung, wenn Ihre Umgebung einen SQL Server-Login verwendet. Nur bei Letzterem werden Benutzername und Passwort abgefragt. Dieses Konto braucht Zugriff auf die Sage-Datenbanken.
Klicken Sie auf Verbindung testen. Es erscheint Verbindung erfolgreich oder der Grund, warum es nicht geklappt hat.
Erweitert... zeigt den ODBC-Treiber und das Feld Zusätzliche Verbindungsoptionen (Standard Encrypt=no;TrustServerCertificate=yes). Ändern Sie diese nur, wenn der Test fehlschlägt; nehmen Sie den Treiber mit der höchsten Nummer (zum Beispiel ODBC Driver 18 for SQL Server).
Datenbanken: Lassen Sie Nur die Datenbanken, die ich auswähle (empfohlen) ausgewählt und haken Sie mindestens die Datenbanken Ihrer Sage-Firmen an. Eine Datenbank fehlt in der Liste? Klicken Sie auf Datenbank nicht in der Liste? und fügen Sie ihren Namen hinzu. Alle Datenbanken auf diesem Server umfasst auch Datenbanken, die später hinzukommen. Diese Auswahl hält nur fest, welche Datenbanken die BrynQ-Schnittstellen verwenden. Sie begrenzt den Zugriff nicht: Um den Zugriff zu begrenzen, geben Sie dem SQL-Login nur Rechte auf diese Datenbanken.
Schritt 4: Einen Sage-Dienstbenutzer anlegen
📍 Wo: Sage 100 France. Warum: Der Agent braucht ein eigenes Sage-Konto, damit die Importe nicht an die Anmeldung einer Person gebunden sind.
Die Seite Sage-Dienstkonto des Installationsprogramms führt dieselben Schritte auf.
Öffnen Sie Sage 100 France, verbinden Sie sich mit einer PRH-Datei, gehen Sie zu Fichier > Droits d'accès > Utilisateurs und klicken Sie auf +.
Setzen Sie Mode d'authentification auf Compte de service. Geben Sie eine Beschreibung ein, die Sie wiedererkennen (zum Beispiel BrynQ), und lassen Sie das Gültigkeitsdatum leer. Haken Sie Token actif an und klicken Sie auf Générer. Beispiel:
📍 Zurück im Installationsprogramm fügen Sie den Code des Dienstbenutzers (zum Beispiel AAA, nicht den Anmeldenamen) und das Token ein.
📍 In Sage klicken Sie auf OK. Erst nach diesem Schritt ist der Benutzer angelegt.
🔍 Sage-Installation Als Nächstes wählt das Installationsprogramm das Sage 100 Paie & RH, in das BrynQ importiert. Bei einer Installation erledigt es das selbst. Bei mehreren zeigt die Seite Sage-Installation jede mit ihrer Version und ihrem Ordner: Wählen Sie die, mit der Sie die Lohnabrechnung machen. In dieser legen Sie in Schritt 5 die Importmodelle an. Nicht aufgeführt? Klicken Sie auf Durchsuchen... und wählen Sie deren pmsw32.exe oder ConnectImport.exe. Ältere Versionen (v8) lassen sich erst nach einer Warnung wählen; eine Installation ohne ConnectImport oder ohne Datenordner lässt sich nicht wählen.
Schritt 5: Die drei BrynQ-Importmodelle in Sage anlegen (neu in Agent 3.10)
📍 Wo: Sage 100 France und das Installationsprogramm, beide auf dem Windows-Server geöffnet.
Titel (Intitulé)
Stammdatei (Fichier racine)
BrynQ Salariés
Fiche salarié
BrynQ Salariés en attente
Salariés en attente
BrynQ Absences
Bulletin de paie > Evènements
A. Den Modellbildschirm in Sage öffnen
Das Installationsprogramm zeigt jetzt die Seite Sage-Importmodelle. Oben steht, wie viele der drei Modelle es gefunden hat; darunter steht eine Zeile pro Modell: ein grüner Haken mit dem Sage-Code (gefunden), ein rotes Kreuz mit dem Grund oder eine Sanduhr, solange es prüft. Wählen Sie eine Zeile aus, um ihren Titel mit einer Schaltfläche Kopieren und die acht Schritte für dieses Modell zu sehen. Lassen Sie die Seite geöffnet.
Öffnen Sie Sage 100 Paie & RH (die Installation, die oben auf der Seite genannt ist). Sie müssen keine Firma öffnen.
Gehen Sie zu G.A. > Format d'Importation.
B. Modell 1: BrynQ Salariés
Klicken Sie unten in der Liste auf +.
Wählen Sie Fiche salarié und klicken Sie auf Ok.
Ein Bildschirm für die Felder öffnet sich. Ändern Sie nichts: Schließen Sie ihn mit dem X oben rechts.
Das Fenster zum Speichern öffnet sich. Wählen Sie im Installationsprogramm die Zeile BrynQ Salariés aus und klicken Sie auf Kopieren. Fügen Sie den Titel in Sage in Intitulé ein (Strg+V) und klicken Sie auf Ok.
Klicken Sie im Installationsprogramm auf Erneut prüfen. Die Zeile BrynQ Salariés hat jetzt einen grünen Haken ✔ und ihren Sage-Code. Das Installationsprogramm prüft außerdem alle paar Sekunden von selbst.
C. Modell 2: BrynQ Salariés en attente
Dieselben Schritte, mit einer anderen Stammdatei und einem anderen Titel.
Klicken Sie auf +.
Scrollen Sie nach unten, wählen Sie Salariés en attente und klicken Sie auf Ok.
Schließen Sie den Feldbildschirm mit dem X.
Kopieren Sie BrynQ Salariés en attente im Installationsprogramm, fügen Sie es in Intitulé ein und klicken Sie auf Ok.
Klicken Sie auf Erneut prüfen: BrynQ Salariés en attente hat einen grünen Haken ✔.
D. Modell 3: BrynQ Absences
Noch einmal dieselben Schritte. Die Stammdatei liegt eine Ebene tiefer, unter Bulletin de paie.
Klicken Sie auf +.
Wählen Sie Bulletin de paie und klicken Sie auf Ok.
Wählen Sie Evènements und klicken Sie auf Ok.
Schließen Sie den Feldbildschirm mit dem X.
Kopieren Sie BrynQ Absences im Installationsprogramm, fügen Sie es in Intitulé ein und klicken Sie auf Ok.
Klicken Sie auf Erneut prüfen: BrynQ Absences hat einen grünen Haken ✔.
E. Sage schließen und fortfahren
Solange Sage noch geöffnet ist, meldet die Seite Alle 3 Modelle gefunden. Schließen Sie Sage 100 Paie & RH auf diesem Server (alle Sitzungen), um fortzufahren.Schließen Sie Sage 100 Paie & RH vollständig (auch andere Sitzungen auf diesem Server).
Die Seite meldet jetzt Alle 3 Modelle gefunden. Klicken Sie auf Weiter, um fortzufahren. Klicken Sie auf Weiter.
✖ Eine Zeile hat noch ein rotes Kreuz?Weiter bleibt nicht verfügbar, bis alle drei Modelle gefunden sind und Sage geschlossen ist. Wählen Sie die Zeile aus: Das Installationsprogramm sagt Ihnen, was zu tun ist.
Nicht gefunden: Der Titel stimmt nicht genau, oder das Modell wurde nicht gespeichert. Kopieren Sie den Titel erneut und korrigieren Sie ihn in Sage. Groß- und Kleinschreibung und Leerzeichen am Anfang oder Ende des Titels spielen keine Rolle.
Umbenannt: Das Modell, das BrynQ bisher verwendet hat, hat in Sage einen anderen Titel. Geben Sie ihm wieder genau den angezeigten Titel (verwenden Sie die Schaltfläche Kopieren).
Doppelt: Mehrere Modelle haben diesen Titel. Behalten Sie das Modell, das das Installationsprogramm nennt, und löschen oder benennen Sie die anderen in Sage um.
Falsches Fichier racine: Das Modell wurde mit einer anderen Stammdatei angelegt. Löschen Sie es in Sage und legen Sie es mit der Stammdatei aus der Tabelle neu an.
Dieses Modell ist in einer anderen Sage-Installation: Legen Sie es in der Sage-Installation an, die oben auf der Seite genannt ist.
Die Modellliste von Sage wurde nicht gefunden: Legen Sie zuerst die Modelle in Sage an und klicken Sie dann auf Erneut prüfen.
ℹ Gut zu wissen
Sage gibt jedem Modell einen Code (zum Beispiel IMP00012). Ihre Codes können von den Screenshots abweichen; nur die Titel zählen.
Benennen Sie die BrynQ-Modelle später nicht um und bearbeiten Sie sie nicht. BrynQ prüft ihre Titel in jedem Importzyklus: Stimmt ein Titel nicht mehr genau, wird nichts importiert, bis er wieder stimmt (die Dateien warten in der Warteschlange). Änderungen an ihren Feldern macht BrynQ rückgängig.
Aktualisieren Sie den Agent später? Diese Seite sehen Sie nur wieder, wenn ein Modell nicht in Ordnung ist oder Sage geöffnet ist. Ein blaues Informationszeichen (Felder in Sage geändert) oder ein Hinweis, dass die Modelldateien fehlen, erfordert nichts: BrynQ stellt das Modell selbst wieder her. Automatische Updates und stille Installationen zeigen diese Seite nie.
OPTIONAL: Nach der Installation sehen Sie die drei Modelle unter G.A. > Format d'Importation. Wählen Sie eines aus und klicken Sie auf den Stift, um die Felder zu sehen, die BrynQ ausgefüllt hat. Ändern Sie sie nicht.
Schritt 6: Installation abschließen
ConnectImport-Szenario: Lassen Sie BrynQ das Szenario erstellen lassen (empfohlen) ausgewählt und klicken Sie auf Weiter. Wählen Sie Mein eigenes ConnectImport-Szenario verwenden nur, wenn der BrynQ-Support Sie darum bittet. Installieren Sie erneut? Lassen Sie Aktuelles Szenario behalten (empfohlen) ausgewählt. Szenario aus den BrynQ-Einstellungen neu erstellen überschreibt das aktuelle Szenario.
Weitere Optionen:
Verknüpfungen: Lassen Sie Desktop-Symbol erstellen (empfohlen) angehakt, und nach Wunsch Verknüpfung im Startmenü erstellen. Beide bringen Sie später direkt zum Admin-Dashboard des Agent.
BrynQ-Support: Mit Erweiterte Diagnose teilen (empfohlen) kann der BrynQ-Support zusätzliche Windows-Details erfassen, wenn die Protokolle ein Problem nicht erklären. Klicken Sie auf Was sieht der BrynQ-Support?, um genau zu lesen, was. Sie können das später im Admin-Dashboard unter Fehlerbehebung ändern.
OPTIONAL: überspringen, sofern nicht nötig.Eigene lokale Netzwerkeinstellungen verwenden ist nur nötig, wenn ein anderes Programm auf diesem Server Port 7070 oder 7071 schon nutzt. Unsicher? Lassen Sie es deaktiviert.
Klicken Sie auf Installieren. Das Installationsprogramm zeigt jeden Schritt. Schlägt der letzte Schritt fehl (zum Beispiel weil BrynQ kurz nicht antwortet), zeigt es den Grund und bietet Wiederholen an: Ihre Auswahl bleibt erhalten.
OPTIONAL. Lassen Sie BrynQ-Agent-Dashboard öffnen angehakt und klicken Sie auf Fertigstellen, oder verwenden Sie später die Verknüpfung oder öffnen Sie http://127.0.0.1:7071/admin in einem Browser auf dem Windows-Server (Edge, Chrome oder Firefox; Internet Explorer kann die Seite nicht anzeigen). Das Admin-Dashboard gibt es auf Englisch, Französisch, Deutsch und Niederländisch; die Sprache wechseln Sie oben.
Teil 1.C) Prüfen, ob der Agent läuft
📍 Wo: der Windows-Server.
✅ Kontrollpunkt 1: Bestätigen Sie dies, bevor Sie zu Teil 2 übergehen.
Öffnen Sie den Task-Manager und gehen Sie zur Registerkarte Dienste.
Prüfen Sie, ob alle drei BrynQ-Dienste den Status Wird ausgeführt haben.
Oder öffnen Sie das Admin-Dashboard (http://127.0.0.1:7071/admin) und gehen Sie zu Fehlerbehebung: BrynQ-Dienste zeigt 3 von 3 laufen.
✖ Ein Dienst läuft nicht?
Klicken Sie mit der rechten Maustaste auf den Dienst und wählen Sie Starten.
Warten Sie einen Moment und prüfen Sie, ob der Status zu Wird ausgeführt wechselt.
Startet er nicht, oder stoppt er wieder? Das ist oft ein Berechtigungsproblem: Prüfen Sie Windows-Berechtigungen am Anfang von Teil 1.B und suchen Sie in den Protokollen nach Access is denied. Kommen Sie nicht weiter? Wenden Sie sich an den BrynQ-Support und fügen Sie einen Screenshot der Registerkarte Dienste und die Support-Datei bei (siehe Agent-Protokolldateien finden).
💡 Merken Sie sich: Wenn BrynQ den Agent später nicht erreicht, prüfen Sie zuerst diese drei Dienste.
Teil 2) Schnittstelle in BrynQ anlegen
📍 Wo: BrynQ (beliebiger Computer). In Factorial und Sage 100 France schlagen Sie nur Werte nach. Ziel: BrynQ mitteilen, was synchronisiert wird und wohin es gesendet wird.
Schritt 1: Schnittstelle aus der Vorlage anlegen
Öffnen Sie BrynQ und gehen Sie zu Interfaces.
Klicken Sie auf New interface und wählen Sie Use our templates.
Suchen Sie nach Sage und wählen Sie Factorial - Sage 100 France Employees.
Klicken Sie auf Use template.
Schritt 2: Registerkarte Configuration ausfüllen
Öffnen Sie die Registerkarte Configuration.
Legen Sie die Zahlungsfrequenz der Firma fest.
OPTIONAL (empfohlen). Geben Sie einige Mitarbeiter-IDs ein. Die ersten Läufe verarbeiten dann nur diese Mitarbeiter, sodass Sie sicher testen können.
Beantworten Sie die Frage Is the DPAE sent outside Sage? (Wird die DPAE außerhalb von Sage gesendet?) mit yes oder no (oui/non, ja/nee, ja/nein und 1/0 funktionieren ebenfalls). Diese Antwort ist erforderlich: Ohne gültige Antwort bricht der Lauf ab.
Schritt 3: Wertezuordnungen in der Registerkarte Scenarios vervollständigen
Kerngedanke: Eine Wertezuordnung übersetzt einen Wert aus Factorial in den passenden Wert in Sage. Jedes Element mit einem Ausrufezeichen (!) braucht noch Ihre Eingabe.
Vor dem ersten Lauf in Factorial prüfen
Jeder Vertrag hat einen französischen Vertragstyp. Er bestimmt die Vertragsart (nature du contrat) in Sage; fehlt er, bleibt dieses Feld leer und das Laufprotokoll zeigt eine Warnung.
Arbeitsstunden und ihre Frequenz sind ausgefüllt. BrynQ verwendet sie für die monatliche Arbeitszeit (zum Beispiel 35 Std./Woche = 151,67).
Die meisten Wertezuordnungen, etwa Länder (3-stellige Codes wie FRA) und Anrede, sind bereits vorausgefüllt. Sie müssen sie nur prüfen.
Öffnen Sie die Registerkarte Scenarios und suchen Sie die mit einem Ausrufezeichen markierten Elemente.
Durchgerechnetes Beispiel: 'Legal Entity -> Paying Establishment and Dossier' Diese Zuordnung finden Sie im Szenario Registration. Sie ist die wichtigste Zuordnung: Sie entscheidet, welche juristische Einheit aus Factorial mit welcher Sage-Firma synchronisiert wird. Wir gehen sie Schritt für Schritt durch; die anderen Zuordnungen funktionieren genauso.
Linke Seite (📍 Factorial): Ermitteln Sie die ID und den Namen der juristischen Einheit unter Einstellungen > Unternehmensdaten.
📍 BrynQ: Tragen Sie diesen Wert auf der linken Seite der Zuordnung ein. Mehrere Einheiten synchronisieren? Fügen Sie pro Einheit eine Zeile hinzu.
Rechte Seite (📍 Sage 100 France): Ermitteln Sie die passende Raison sociale / das Dossier der Sage-PRH-Datei. In diesem Beispiel ist das Dossier 'BRYNQ.PRH'.
📍 Sage 100 France: Ermitteln Sie außerdem das passende 'Etablissement principal'.
📍 BrynQ: Tragen Sie diese Werte auf der rechten Seite der Zuordnung ein. Das Ergebnis sieht so aus:
Bestätigen Sie die Zuordnung und speichern Sie sie.
Jetzt sind Sie dran: Vervollständigen Sie die anderen nicht standardmäßigen Zuordnungen auf dieselbe Weise (Wert auf beiden Seiten nachschlagen, eintragen, bestätigen, speichern):
Prüfen Sie abschließend, ob die standardmäßigen Wertezuordnungen für Ihre Firma korrekt sind:
Schritt 4: Factorial und Sage verbinden (Registerkarte Authorization)
Öffnen Sie die Registerkarte Authorization.
Zuerst Factorial: Klicken Sie auf Add authorization (TEST and LIVE), geben Sie einen gut erkennbaren Namen ein und klicken Sie auf Connect to app.
Melden Sie sich mit Ihrem Factorial-ADMINISTRATORKONTO an.
Stellen Sie sicher, dass die TEST-Version aktiv ist, bevor Sie Ihren ersten Testlauf starten.
⚡ Achtung: Die Verbindung kann automatisch erfolgen! Sind Sie in diesem Browser bereits bei Factorial angemeldet, mit einer aktiven Anmeldung (Sitzungscookie)? Dann verbindet Connect to app sofort mit diesem Konto, ohne Sie zur Anmeldung aufzufordern. Deshalb vor dem Klicken: Prüfen Sie, ob Sie mit dem Administratorkonto bei Factorial angemeldet sind. Falls nicht, melden Sie sich zuerst von Factorial ab oder verwenden Sie ein privates/Inkognito-Fenster.
Genehmigen Sie den angeforderten Zugriff und speichern Sie die Verbindung.
Dann Sage: Fügen Sie die Sage-Autorisierung hinzu.
Geben Sie die BrynQ Agent-URL in diesem Format ein: https://[ihr-kunden-slug].brynq-agent.com Wo Sie Ihren Slug finden: Es ist der erste Teil Ihrer BrynQ-Webadresse. Die genaue Adresse steht auch in C:\ProgramData\BrynQ\Agent\config\public_url.txt auf dem Windows-Server. Wenn Sie sich unter https://acme.app.brynq.com anmelden, ist Ihr Slug acme und die Agent-URL https://acme.brynq-agent.com.
Geben Sie das BrynQ Agent Token ein: dasselbe Token, das Sie zuvor erhalten und im Installationsprogramm eingegeben haben.
Den ersten Lauf prüfen
✅ Kontrollpunkt 2: nach einem kontrollierten Testlauf:
📍 Windows-Server: Im Importordner der Firma erscheint eine neue Excel-Importdatei: <dossier>.xlsx für bestehende Mitarbeiter und <dossier>_EN_ATTENTE.xlsx, wenn es neue Mitarbeiter gibt. Nach dem Import verschiebt der Agent die Dateien in einen Unterordner namens importe le <Datum und Uhrzeit>.
📍 Sage 100 France: Bestehende Mitarbeiter sind aktualisiert, und neue Mitarbeiter erscheinen unter Gestion > Salariés en attente. Stellen Sie sie dort ein: Wählen Sie die Zeilen mit Tout aus und klicken Sie auf Embaucher. Beginnen Sie mit den Test-Mitarbeiter-IDs, die Sie in Schritt 2 eingegeben haben.
✖ Etwas ist schiefgelaufen?
Keine Importdatei auf dem Server: Lesen Sie zuerst das Laufprotokoll der Schnittstelle (Schnittstelle > Runs). Es wird keine Datei gesendet, wenn die Schnittstelle keine neuen oder geänderten Mitarbeiter gefunden hat oder wenn alle herausgefiltert wurden (Factorial-Berechtigungen, Daten, Wertezuordnungen). Meldet das Laufprotokoll, dass eine Datei gesendet wurde? Dann konnte BrynQ sie nicht an den Agent liefern: Prüfen Sie die drei BrynQ-Dienste (Teil 1.C) und testen Sie die Sage-Autorisierung erneut.
'Import terminé avec succès', aber kein neuer Mitarbeiter: Sehen Sie zuerst unter Salariés en attente nach (Sage v9).
Die Importdatei ist da, aber Sage enthält keine oder falsche Datensätze: Prüfen Sie das Laufprotokoll, die Daten in Factorial und die Wertezuordnungen in der Registerkarte Scenarios, vor allem Registration.
Einige Mitarbeiter fehlen: Prüfen Sie das Laufprotokoll. Häufige Ursachen: Factorial-Berechtigungen (mit einem Administratorkonto neu verbinden), fehlende oder falsche Daten in Factorial oder eine Wertezuordnung, die nicht ausgefüllt ist.
Kommen Sie nicht weiter? Lesen Sie den Abschnitt zur Fehlerbehebung unten, oder wenden Sie sich an den BrynQ-Support und fügen Sie die Support-Datei bei (Admin-Dashboard > Fehlerbehebung > Support-Datei herunterladen).
Fehlerbehebung
Was Sie sehen
Was Sie tun
Ein Fehler, den Sie sich nicht erklären können
Öffnen Sie das Admin-Dashboard (http://127.0.0.1:7071/admin) > Fehlerbehebung: Es prüft die Dienste, die Verbindung mit BrynQ, den Ordnerzugriff und mehr und nennt Lösungen für häufige Probleme. Teilen Sie die Support-Datei mit dem BrynQ-Support (siehe Agent-Protokolldateien finden unten).
Teile der Installation schlagen fehl, oder der Agent läuft, kann aber keine Dateien lesen oder schreiben
Prüfen Sie die Windows-Berechtigungen: Führen Sie das Installationsprogramm als Administrator aus und stellen Sie sicher, dass das Windows-Konto des Agent die Sage-Ordner, PRH-Dateien, programFiles und programData lesen und schreiben kann. Siehe die Warnung am Anfang von Teil 1.B.
Installationsprogramm: Weiter bleibt auf Cloud-Verbindung nicht verfügbar
BrynQ akzeptiert das Token noch nicht. Die Seite nennt den Grund: Kopieren Sie das ganze Token, fügen Sie die öffentliche IP-Adresse des Servers in BrynQ zum Token hinzu, oder verwenden Sie das Agent-Token dieses Kunden. Klicken Sie dann auf Erneut prüfen. Siehe Teil 1.B, Schritt 1.
Installationsprogramm: Weiter bleibt auf Sage-Importmodelle nicht verfügbar
Eine Zeile hat noch ein rotes Kreuz, oder Sage ist noch geöffnet. In Schritt 5 steht, was jede Meldung bedeutet; schließen Sie Sage (alle Sitzungen), sobald alle drei Modelle gefunden sind.
Nicht alle Mitarbeiter werden synchronisiert
Lesen Sie zuerst das Laufprotokoll der Schnittstelle (Schnittstelle > Runs). Häufige Ursachen: Der Factorial-Benutzer sieht nicht alle Mitarbeiter (mit einem Factorial-Administratorkonto neu verbinden), fehlende oder falsche Daten in Factorial, eine Wertezuordnung, die nicht ausgefüllt ist, oder noch eingetragene Test-Mitarbeiter-IDs in der Registerkarte Configuration. Siehe Mitarbeiter: Fehlerbehebung.
'Erreur mot de passe' auf dem Sage-Server (kommt häufig vor)
Prüfen Sie zuerst Code und Token des Sage-Dienstkontos und setzen Sie dann den Benutzer oder das Dossier in Sage zurück. Siehe 'Erreur mot de passe' beheben unten.
BrynQ erreicht den Agent nicht
Prüfen Sie, ob die drei BrynQ-Dienste laufen (Teil 1.C), öffnen Sie dann http://127.0.0.1:7071/admin auf dem Windows-Server und gehen Sie zu BrynQ-Verbindung: Sowohl Dieser Agent meldet sich bei BrynQ an als auch BrynQ erreicht diesen Agent müssen OK sein. Testen Sie anschließend die Sage-Autorisierung erneut über die Registerkarte Authorization.
Das Installationsprogramm kann sich nicht mit dem SQL Server verbinden
Klicken Sie auf Verbindung testen und lesen Sie den Grund. Prüfen Sie, ob der Servername stimmt (Schritt 3), wählen Sie die richtige Anmeldemethode (Windows- oder SQL Server-Authentifizierung), versuchen Sie unter Erweitert... den ODBC-Treiber mit der höchsten Nummer und stellen Sie sicher, dass das Konto Zugriff auf die Sage-Datenbanken hat.
Eine von der Vorlage verwendete App ist inaktiv
Aktivieren Sie sie unter Settings > Interfaces > Apps.
Ein manueller Import in Sage funktioniert, der automatisierte Lauf aber nicht
Prüfen Sie den Agent im Admin-Dashboard (http://127.0.0.1:7071/admin) unter SAGE 100 France > Übersicht und Fehlerbehebung und testen Sie dann die Sage-Autorisierung erneut über die Registerkarte Authorization.
Sie möchten eine Autorisierung prüfen oder entfernen
Öffnen Sie Settings > Interfaces > Connections.
Agent-Protokolldateien finden
📍 Wo: der Windows-Server, im Explorer. Wenn etwas schiefgeht, zeigen die Protokolldateien des Agent Ihnen (und dem BrynQ-Support) meist, warum. Es gibt zwei Protokollordner. Welchen Sie brauchen, hängt vom Problem ab:
Problem
Protokollordner
Der Datenimport in Sage schlägt fehl oder liefert falsche Ergebnisse
C:\ProgramData\BrynQ\Agent\logs\sage
Allgemeine Probleme mit dem Agent, etwa Verbindungsprobleme
C:\ProgramData\BrynQ\Agent\logs\agent
Sage-Importprotokolle (zum Beispiel connectimport und connectimport-error):
Allgemeine Agent-Protokolle (zum Beispiel application, requests und security):
Sie können die Protokolldateien auch im Admin-Dashboard lesen: Fehlerbehebung > Protokolldateien (neueste zuerst; klicken Sie auf eine Datei, um sie zu lesen).
💡 Sie wenden sich an den BrynQ-Support? Fügen Sie die Support-Datei bei: Gehen Sie im Admin-Dashboard zu Fehlerbehebung (oder SAGE 100 France > Fehlerbehebung) und klicken Sie auf Support-Datei herunterladen. Sie enthält die Protokolle, die Einstellungen und den Status der Dienste in einer ZIP-Datei (brynq-agent-support-<customer>-<server>-<date>-<time>.zip), ohne Passwörter und Tokens. Das Admin-Dashboard öffnet sich nicht? Führen Sie "C:\Program Files\BrynQ\Agent\brynq-agent.exe" --support-file in einer Eingabeaufforderung als Administrator aus; die Datei wird auf Ihrem Desktop gespeichert. Das erspart meist viele Rückfragen.
Sie sehen den Ordner ProgramData nicht? Er ist standardmäßig ausgeblendet. Geben Sie C:\ProgramData\BrynQ\Agent\logs direkt in die Adressleiste des Explorers ein.
'Erreur mot de passe' beheben
📍 Wo: Sage 100 France, auf dem Windows-Server. Der Fehler 'Erreur mot de passe' tritt auf dem Sage-Server recht häufig auf. Er hat zwei häufige Ursachen:
Code oder Token des Sage-Dienstkontos, das der BrynQ-Import verwendet, stimmen nicht, oder das Token ist nicht mehr aktiv. Das ist die wahrscheinliche Ursache, wenn mit diesem Konto noch kein Import funktioniert hat oder nachdem jemand das Konto in Sage geändert hat.
Sage hält noch eine alte Sitzung des Kontos. Das ist die wahrscheinliche Ursache, wenn Importe vorher funktioniert haben. Setzen Sie den Benutzer oder das Dossier zurück (Optionen A und B).
Das Admin-Dashboard nennt die wahrscheinliche Ursache: Öffnen Sie http://127.0.0.1:7071/admin > SAGE 100 France > Fehlerbehebung und lesen Sie die letzte Importmeldung.
Zuerst das Dienstkonto prüfen
Gehen Sie in Sage zu Fichier > Droits d'accès > Utilisateurs und öffnen Sie das Dienstkonto des BrynQ-Imports.
Prüfen Sie, ob Mode d'authentification auf Compte de service steht und Token actif angehakt ist. Notieren Sie den Code.
Unsicher, ob das Token stimmt? Klicken Sie auf Générer für ein neues Token, kopieren Sie es und klicken Sie auf OK.
Öffnen Sie auf dem Windows-Server http://127.0.0.1:7071/admin > SAGE 100 France > Dienst. Prüfen Sie, ob Sage-Benutzercode mit dem Code in Sage übereinstimmt. Haben Sie ein neues Token erzeugt, klicken Sie auf Token ersetzen, fügen Sie es ein und speichern Sie.
Warten Sie den nächsten Importzyklus ab (standardmäßig 15 Minuten) und prüfen Sie die Importmeldung erneut.
Immer noch 'Erreur mot de passe'? Setzen Sie die Sitzung zurück. Beginnen Sie mit Option A. Verwenden Sie Option B nur, wenn A nicht hilft.
Option A: Zurücksetzen innerhalb der Firma (zuerst versuchen)
Öffnen Sie Sage 100 France und verbinden Sie sich mit der Firma (PRH-Datei).
Gehen Sie zu Fichier > Droits d'accès > Utilisateurs.
Klicken Sie in der Liste des utilisateurs auf Réinitialisation.
Versuchen Sie die Verbindung erneut.
Option B: Globales Zurücksetzen des Dossiers (auf eigenes Risiko)
⚠ Auf eigenes Risiko.Réinitialiser le dossier meldet alle Benutzer des Dossiers ab. Stellen Sie sicher, dass niemand in der Lohnabrechnung arbeitet, bevor Sie es verwenden.
Gehen Sie zu Fichier > Utilitaires > Réinitialisation. Nicht sichtbar? Diese Option ist manchmal nur sichtbar, wenn Sie nicht mit einer Firma verbunden sind. Schließen Sie zuerst die Firma (Fichier > Fermer) und sehen Sie erneut nach.
Der Assistant réinitialisation de dossier öffnet sich. Klicken Sie auf Parcourir... und wählen Sie das Dossier (PRH-Datei), das zurückgesetzt werden soll.
Klicken Sie auf Réinitialiser le dossier. Um nur einen bestimmten Benutzer abzumelden, wählen Sie diesen Benutzer aus und klicken Sie stattdessen auf Réinitialiser l'utilisateur.
Klicken Sie auf Terminer und versuchen Sie die Verbindung erneut.
Zusammenfassung
Der Agent auf dem Windows-Server empfängt die Importdateien und importiert sie in die PRH-Dateien, die Sie ausgewählt haben. Auf die Sage-Daten greift er über den SQL Server zu.
Die Wertezuordnungen entscheiden, welche Factorial-Einheit in welcher Sage-Firma landet. Achten Sie besonders auf 'Legal Entity -> Paying Establishment and Dossier' in Registration.
Die Autorisierungen verbinden BrynQ mit Factorial (Administratorkonto!) und mit dem Agent.
Kommen Sie nicht weiter? Prüfen Sie zuerst die drei BrynQ-Dienste und die Seite Fehlerbehebung im Admin-Dashboard. Wenden Sie sich dann an den BrynQ-Support und fügen Sie die Support-Datei bei.