Was Sie erreichen

Am Ende dieser Anleitung fließen die Stammdaten der Mitarbeitenden automatisch von Factorial nach Sage 100 France (v9). Keine manuellen Exporte und kein Kopieren und Einfügen mehr.

So funktioniert es

Es hilft, sich den Ablauf vorzustellen, bevor Sie beginnen. Jeder Lauf besteht aus vier Schritten:

1. BrynQ liest die Mitarbeiterdaten aus Factorial.
2. BrynQ wandelt diese Daten in eine Excel-Importdatei um, die Sage versteht.
3. Der BrynQ Agent, ein kleines Programm auf Ihrem Sage-Server, empfängt die Datei.
4. ConnectImport importiert die Datei in das richtige Sage-Unternehmen (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:

Der Weg auf einen Blick

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 eine SQL-Server-Anmeldung), muss Zugriff auf die Sage-Unternehmensdatenbanken haben. Wenn Sie unsicher sind, klären Sie das vor dem Start mit Ihrem IT-Administrator.
• ☐ 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 benötigen ihn sowohl in Teil 1 als auch in Teil 2.

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.

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.

1. Melden Sie sich bei BrynQ an und gehen Sie zu Organization > Agent.
2. Laden Sie das neueste Installationsprogramm des BrynQ Agent herunter.
   
   
   
   

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-Unternehmen verbinden.

Schritt 1: Installationsprogramm starten

1. Starten Sie das Installationsprogramm und wählen Sie Ihre Sprache. Die Screenshots unten sind auf Englisch.
   
   
   
2. Lesen Sie die Lizenzvereinbarung sorgfältig. Wenn Sie ihr zustimmen und den BrynQ Agent nutzen möchten, akzeptieren Sie sie, um fortzufahren.
3. Behalten Sie den standardmäßigen (vorausgefüllten) Installationspfad. Er passt für die meisten Umgebungen, Sie können aber auch einen anderen Ordner wählen.
4. Geben Sie das BrynQ API-Token ein (siehe „Bevor Sie beginnen“).
   Das ist nur bei der ersten (vollständigen) Installation nötig.
5. Wählen Sie diese Module: SQL Server, File Management, REST Proxy und Sage 100 France.
   

Schritt 2: Sage-Unternehmen auswählen

Kerngedanke: Jede PRH-Datei ist die Datenbank eines Unternehmens in Sage. Eine PRH-Datei auszuwählen bedeutet: "BrynQ darf in dieses Unternehmen importieren".

6. Wählen Sie die gefundenen PRH-Dateien aus, die Sie mit der Schnittstelle verbinden möchten. Die Suche nach PRH-Dateien kann einige Minuten dauern.
   Nur wenn ein Unternehmen fehlt: Fügen Sie seine PRH-Datei manuell über die Schaltfläche 'Add PRH File...' hinzu.
   
   

Schritt 3: Mit dem SQL Server verbinden

7. Database driver: Wählen Sie den vorgeschlagenen Treiber. Gibt es mehrere, nehmen Sie die höchste Nummer (zum Beispiel ODBC Driver 18 for SQL Server).
8. Server: Wählen Sie den vorgeschlagenen Server, oft SERVERNAME\SQLEXPRESS.
   Unsicher? SQL Server Management Studio zeigt den Servernamen beim Verbinden, oder fragen Sie Ihren IT-Administrator.
9. Login method: Windows authentication oder ein SQL Server-Login (Benutzername und Passwort), wenn Ihre Umgebung eines verwendet. Dieses Konto braucht Zugriff auf die Sage-Datenbanken.
   
10. SQL Server — Database Access: Wählen Sie, welche Datenbanken der Agent abfragen darf: All databases oder Selected databases only. Das entscheiden Sie; wenn Sie den Zugriff einschränken, nehmen Sie mindestens die Datenbanken Ihrer Sage-Unternehmen auf.
    

Schritt 4: Sage-Dienstbenutzer anlegen

📍 Wo: Sage 100 France.
Warum: Der Agent braucht ein eigenes Sage-Konto, damit Importe nicht an die Anmeldung einer Person gebunden sind.

11. Öffnen Sie Sage 100 France, verbinden Sie sich mit einer PRH-Datei und gehen Sie zu Fichier > Droits d'accès > Utilisateurs.
    
    
    
12. Legen Sie einen eigenen Dienstbenutzer an: Geben Sie einen Code ein, aktivieren Sie 'Compte de service' und erzeugen Sie ein Token. Prüfen Sie, dass das Token aktiv ist, und halten Sie Code und Token für das Installationsprogramm bereit. Die Beschreibung ist optional, aber ein wiedererkennbarer Name (zum Beispiel BrynQ) hilft später.
    Beispiel:
    
    
13. 📍 Zurück im Installationsprogramm fügen Sie den Code des Dienstbenutzers und das Token ein.
    
    

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.

A. Die Modellübersicht in Sage öffnen

14. Das Installationsprogramm zeigt jetzt die Seite Sage — Import Models: die drei Titel, jeweils mit einer Copy-Schaltfläche und der Stammdatei. Lassen Sie sie geöffnet.
    
15. Öffnen Sie Sage 100 Paie & RH. Sie müssen kein Unternehmen öffnen.
16. Gehen Sie zu G.A. > Format d'Importation.
    

B. Modell 1: BrynQ Salariés

17. Klicken Sie unten in der Liste auf +.
    
18. Wählen Sie Fiche salarié und klicken Sie auf Ok.
    
19. Ein Fenster für die Felder öffnet sich. Ändern Sie nichts: Schließen Sie es mit dem X oben rechts.
    
20. Das Speicherfenster öffnet sich. Klicken Sie im Installationsprogramm neben BrynQ Salariés auf Copy. Fügen Sie den Titel in Sage bei Intitulé ein (Strg+V) und klicken Sie auf Ok.
    
21. Klicken Sie im Installationsprogramm auf Check Sage models. BrynQ Salariés hat jetzt ein grünes Häkchen ✔.
    Die Zeile „Sage 100 Paie & RH is still open“ behält vorerst ein rotes Kreuz. Das ist in Ordnung.
    

C. Modell 2: BrynQ Salariés en attente

Dieselben Schritte, mit einer anderen Stammdatei und einem anderen Titel.

22. Klicken Sie auf +.
23. Scrollen Sie nach unten, wählen Sie Salariés en attente und klicken Sie auf Ok.
    
24. Schließen Sie das Fenster für die Felder mit dem X.
25. Kopieren Sie BrynQ Salariés en attente im Installationsprogramm, fügen Sie es bei Intitulé ein und klicken Sie auf Ok.
    
26. Klicken Sie auf Check Sage models: BrynQ Salariés en attente hat ein grünes Häkchen ✔.
    

D. Modell 3: BrynQ Absences

Noch einmal dieselben Schritte. Die Stammdatei liegt eine Ebene tiefer, unter Bulletin de paie.

27. Klicken Sie auf +.
28. Wählen Sie Bulletin de paie und klicken Sie auf Ok.
    
29. Wählen Sie Evènements und klicken Sie auf Ok.
    
30. Schließen Sie das Fenster für die Felder mit dem X.
31. Kopieren Sie BrynQ Absences im Installationsprogramm, fügen Sie es bei Intitulé ein und klicken Sie auf Ok.
    
32. Klicken Sie auf Check Sage models: BrynQ Absences hat ein grünes Häkchen ✔.
    

E. Sage schließen und fortfahren

33. Schließen Sie Sage 100 Paie & RH vollständig (auch andere Sitzungen auf diesem Server).
34. Klicken Sie noch einmal auf Check Sage models. Alle Zeilen haben ein grünes Häkchen ✔ und das Installationsprogramm meldet All set. Next ist jetzt verfügbar: Klicken Sie darauf.
    

✖ Hat eine Zeile noch ein rotes Kreuz? Next bleibt nicht verfügbar, solange eine Zeile ein rotes Kreuz hat. Die Meldung sagt, was zu tun ist:

• Sage 100 Paie & RH is still open: Schließen Sie Sage (alle Sitzungen) und prüfen Sie erneut.
• not found. Create it with exactly this title: Der Titel stimmt nicht genau, oder das Modell wurde nicht gespeichert. Kopieren Sie den Titel erneut und korrigieren Sie ihn in Sage.
• not found. IMP0000x, used until now, is titled '…': Das Modell wurde in Sage umbenannt. Benennen Sie es wieder genau nach dem Titel (Copy-Schaltfläche verwenden).
• more than one model has this title: Behalten Sie das Modell, das das Installationsprogramm nennt (falls genannt), und löschen oder benennen Sie die anderen in Sage um.
• created with another root file: Löschen Sie dieses Modell in Sage und legen Sie es mit der Stammdatei aus der Tabelle neu an.
• files are missing from the GA folder: Öffnen Sie das Modell in Sage und speichern Sie es erneut.

Schritt 6: Installation abschließen

35. Sage — Scenario Code (optional): Lassen Sie das Feld leer und klicken Sie auf Next. Der Agent legt das ConnectImport-Szenario bei seinem ersten Lauf selbst an. Füllen Sie es nur aus, wenn der BrynQ-Support Sie darum bittet.
    
    
36. OPTIONAL (empfohlen). Legen Sie eine Desktop-Verknüpfung an. Damit gelangen Sie später direkt zum Agent-Dashboard.
    
    
37. OPTIONAL: nur bei Bedarf. Auf derselben Seite ist Use custom local network settings nur in besonderen Netzwerkumgebungen nötig. Unsicher? Lassen Sie das Kästchen leer.
    
38. OPTIONAL. Prüfen Sie die Agent-Konfiguration im lokalen Admin-Dashboard. Verwenden Sie die Desktop-Verknüpfung, oder öffnen Sie 127.0.0.1:7071/admin (Standard-Listen-IP und Admin-Port) im Browser auf dem Windows-Server. Das Dashboard ist auf Englisch, Französisch, Deutsch und Niederländisch verfügbar; die Sprache wechseln Sie oben.
    
    
    
    

Teil 1.C) Prüfen, ob der Agent läuft

📍 Wo: der Windows-Server.

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 und wohin es gesendet wird.

Schritt 1: Schnittstelle aus der Vorlage anlegen

1. Öffnen Sie den BrynQ und gehen Sie zu Interfaces.
2. Klicken Sie auf New interface und wählen Sie Use our templates.
3. Suchen Sie nach Sage und wählen Sie Factorial - Sage 100 France Employees.
   
   
4. Klicken Sie auf Use template.

Schritt 2: Registerkarte Configuration ausfüllen

5. Öffnen Sie die Registerkarte Configuration (Services).
   
   
   
6. Legen Sie die Zahlungsfrequenz.
   
   
7. OPTIONAL (empfohlen). Geben Sie einige Mitarbeiter-IDs ein. Die ersten Läufe verarbeiten dann nur diese Mitarbeiter, sodass Sie sicher testen können.
   
   
8. Beantworten Sie die Frage Wird die DPAE außerhalb von Sage gesendet? mit ja oder nein (oui/non, yes/no, ja/nee und 1/0 funktionieren ebenfalls). Diese Antwort ist erforderlich: Ohne gültige Antwort wird der Lauf abgebrochen.

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.

9. Ö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 Registrierung. Sie ist die wichtigste Zuordnung: Sie entscheidet, welche juristische Einheit aus Factorial mit welchem Sage-Unternehmen synchronisiert wird. Wir gehen sie Schritt für Schritt durch; die anderen Zuordnungen funktionieren genauso.

10. Linke Seite (📍 Factorial): Ermitteln Sie ID und Namen unter Einstellungen > Unternehmensdaten.
    
    
    
11. 📍 BrynQ: Tragen Sie diesen Wert auf der linken Seite der Zuordnung ein. Mehrere Einheiten synchronisieren? Fügen Sie pro Einheit eine Zeile hinzu.
    
    
12. 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'.
    
13. 📍 Sage 100 France: Ermitteln Sie außerdem das passende 'Etablissement principal'.
    
    
14. 📍 BrynQ: Tragen Sie diese Werte auf der rechten Seite der Zuordnung ein. Das Ergebnis sieht so aus:
    
    
15. 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 Ihr Unternehmen korrekt sind:

Schritt 4: Factorial und Sage verbinden (Registerkarte Authorization)

16. Öffnen Sie die Registerkarte Authorization (Services).
17. 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.
    
    
18. Genehmigen Sie den angeforderten Zugriff und speichern Sie die Verbindung.
19. Dann Sage: Fügen Sie die Sage-Autorisierung hinzu.
20. 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.
21. Geben Sie das BrynQ Agent-Token ein: dasselbe Token, das Sie zuvor erhalten und im Installationsprogramm eingetragen haben.

Den ersten Lauf prüfen

Fehlerbehebung

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:

Sage-Importprotokolle (zum Beispiel connectimport und connectimport-error):

Allgemeine Agent-Protokolle (zum Beispiel application, requests und security):

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. Meist lösen Sie ihn, indem Sie den Benutzer oder das Dossier zurücksetzen. Beginnen Sie mit Option A. Verwenden Sie Option B nur, wenn A nicht hilft.

Option A: Zurücksetzen innerhalb des Unternehmens (zuerst versuchen)

1. Öffnen Sie Sage 100 France und verbinden Sie sich mit dem Unternehmen (PRH-Datei).
2. Gehen Sie zu Fichier > Droits d'accès > Utilisateurs.
   
3. Klicken Sie in der Liste des utilisateurs auf Réinitialisation.
   
4. Versuchen Sie die Verbindung erneut.

Option B: Globales Zurücksetzen des Dossiers (auf eigenes Risiko)

1. Gehen Sie zu Fichier > Utilitaires > Réinitialisation.
   Nicht sichtbar? Diese Option ist manchmal nur sichtbar, wenn Sie nicht mit einem Unternehmen verbunden sind. Schließen Sie zuerst das Unternehmen (Fichier > Fermer) und sehen Sie erneut nach.
   
2. 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.
   
3. 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.
   
4. 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 ausgewählten PRH-Dateien. Auf die Sage-Daten greift er über den SQL Server.
• Der Wertezuordnungen entscheiden, welche Factorial-Einheit in welchem Sage-Unternehmen landet. Achten Sie besonders auf 'Legal Entity -> Paying Establishment and Dossier' in Registrierung.
• Der Autorisierungen verbinden BrynQ mit Factorial (Administratorkonto!) und mit dem Agent.
• Kommen Sie nicht weiter? Prüfen Sie zuerst die drei BrynQ-Dienste. Wenden Sie sich dann an den BrynQ Support und fügen Sie die Agent-Protokolldateien bei (logs\sage bei Importproblemen, logs\agent bei Verbindungsproblemen).