Een geautomatiseerde gegevensinterface instellen tussen Factorial en Sage
Een geautomatiseerde gegevensinterface instellen tussen Factorial en Sage
📌 Deze handleiding is voor: BrynQ Agent 3.10 of nieuwer (schermafbeeldingen: 3.10.1) · Sage 100 France v9. Een andere versie? Zie Begin hier – kies je versie.
Bijgewerkt voor Sage 100 France v9 en BrynQ Agent 3.10.1. Het installatieprogramma controleert je BrynQ-token terwijl je typt, toont de stappen voor het Sage-serviceaccount en de importmodellen op eigen pagina's, en maakt het ConnectImport-scenario voor je aan. De beheerpagina heeft een nieuw uiterlijk en een pagina Probleemoplossing met een supportbestand voor BrynQ-support.
* Nieuw met Sage v9 en Agent 3.10
Nieuwe medewerkers worden in een apart bestand verstuurd, <dossier>_EN_ATTENTE.xlsx, dat Sage importeert in Salariés en attente (importmodel BrynQ Salariés en attente). De salarisadministratie neemt ze daarna in dienst in Sage: Gestion > Salariés en attente, selecteer de regels met Tout en klik op Embaucher. Zolang ze niet in dienst zijn genomen, slaat BrynQ ze bij de volgende runs over.
Embaucher is pas beschikbaar als DPAE envoyée is ingesteld (via de DPAE-vraag op het tabblad Configuration) en de regels met Tout zijn geselecteerd.
Zorg voor de DPAE dat de geboorteplaats en de einddatum van de proeftijd in Factorial zijn ingevuld.
Sage v9 vereist dat het matricule (personeelsnummer) precies 4 tekens lang is.
Fout 'Code pays inexistant' (landcode bestaat niet): het land moet de 3-lettercode zijn (bijvoorbeeld FRA). De vooraf ingevulde landenkoppeling regelt dit.
De import meldt 'Import terminé avec succès' (import geslaagd), maar je ziet de medewerker niet: in v9 verschijnen nieuwe medewerkers eerst onder Salariés en attente.
Nieuwe installatiestap: maak in Sage drie lege importmodellen aan met precies de juiste titels. Zie stap 5.
Wat je bereikt
Aan het einde van deze handleiding stromen de stamgegevens van medewerkers automatisch van Factorial naar Sage 100 France (v9). Geen handmatige exports en geen kopiëren en plakken meer.
Hoe het werkt
Het helpt om de gegevensstroom voor je te zien voordat je begint. Elke run doorloopt vier stappen:
BrynQ leest de medewerkergegevens uit Factorial.
BrynQ zet die gegevens om in een Excel-importbestand dat Sage begrijpt.
De BrynQ Agent, een klein programma op je Sage-server, ontvangt het bestand.
ConnectImport importeert het bestand in het juiste Sage-bedrijf (PRH-bestand).
Je richt dus twee dingen in: de Agent op de Sage-server (deel 1) en de interface in BrynQ (deel 2).
Weet waar je bent
Deze handleiding wisselt tussen verschillende plekken. Elke stap begint met een label 📍 Waar, zodat je altijd weet waar je moet werken:
📍 Label
Wat het is
Windows-server
De computer (machine) waarop Sage 100 France is geïnstalleerd. Hier installeer je de BrynQ Agent.
SQL Server
De databasesoftware waarin de Sage-gegevens staan. Meestal draait die op dezelfde Windows-server, maar het kan ook een aparte machine zijn. In het installatieprogramma vul je alleen de naam in.
Sage 100 France
De Sage-applicatie zelf, geopend op de Windows-server.
BrynQ
Het BrynQ-platform in je browser (https://je-slug.app.brynq.com).
Factorial
Factorial in je browser.
De route in één oogopslag
Deel
Wat je doet
📍 Waar
Wie
1.A
De BrynQ Agent downloaden
BrynQ, geopend op de Windows-server
Serverbeheerder
1.B
De Agent installeren en configureren, en de BrynQ-importmodellen aanmaken in Sage
Windows-server + Sage 100 France
Server- en Sage-beheerder
1.C
Controleren of de Agent draait
Windows-server
Serverbeheerder
2
De interface aanmaken, configureren en koppelen
BrynQ (+ Factorial en Sage om waarden op te zoeken)
BrynQ- en Factorial-beheerder
Voordat je begint
Loop eerst deze checklist af. Elk punt voorkomt een veelvoorkomende reden om halverwege vast te lopen.
☐ Toegang tot BrynQ met rechten om interfaces aan te maken of te wijzigen.
☐ Een Factorial-beheerdersaccount met toegang tot alle medewerkergegevens (zie het kader hieronder).
☐ Een Sage 100 France-beheerder, plus een salarisgebruiker die de importresultaten kan controleren.
☐ Beheerderstoegang tot de Windows-server waarop Sage draait, inclusief de Sage PRH-bestanden en de mappen programFiles en programData.
☐ Databasetoegang: het account waarmee de Agent verbinding maakt met SQL Server (je Windows-account of een SQL Server-login) moet toegang hebben tot de Sage-bedrijfsdatabases. Weet je het niet zeker? Controleer dit dan vooraf met je IT-beheerder.
☐ Op de Windows-server draait Windows Server 2016 of nieuwer. Op oudere versies start het installatieprogramma niet.
☐ Een BrynQ API-token voor deze klant, bij de hand. Maak het aan in BrynQ onder Admin Portal > API Access > Add API token en selecteer precies één klant, of vraag het aan BrynQ-support. Waarom: je hebt het nodig in zowel deel 1 als deel 2. Heeft het token in BrynQ een IP-whitelist, dan moet het openbare IP-adres van de Windows-server daarin staan.
⚠ Gebruik een Factorial-BEHEERDERSaccount BrynQ synchroniseert alleen de medewerkers die de gekoppelde Factorial-gebruiker kan zien. Een account zonder beheerdersrechten betekent ontbrekende medewerkers in Sage.
Bekijk eerst: video van deel 1
💡 Tip: bekijk een video om te zien wat je moet doen, en gebruik daarna de geschreven stappen hieronder voor de details van elke stap.
Video 1: de volledige installatie, stap voor stap uitgelegd (Sage v8, BrynQ Agent 3.9.4). Stap 5 (de importmodellen) zit er niet in.
🎬 Video 2: Sage v9 en Agent 3.10, inclusief stap 5 Dezelfde installatie als video 1, plus de uitleg van stap 5 (de drie importmodellen aanmaken in Sage), die in video 1 ontbreekt. De andere stappen komen sneller voorbij; bekijk video 1 als je die uitgebreider wilt zien.
Deze video toont Agent 3.10.0. Sinds 3.10.1 zien enkele pagina's van het installatieprogramma er anders uit; de stappen in de tekst hieronder zijn leidend.
Deel 1.A) Download de BrynQ Agent op de Windows-server
📍 Waar: BrynQ, geopend in een browser op de Windows-server waarop Sage draait. Doel: het installatieprogramma van de Agent op die server krijgen.
Log in bij BrynQ en ga naar Organization > Agent.
Download het nieuwste installatieprogramma van de BrynQ Agent (brynq-agent-installer-<version>.exe).
ℹ Beveiligingswaarschuwing? De bestanden zijn ondertekend en gepubliceerd onder 'Salure ICT BV'. Je browser of Windows kan ze toch als niet-vertrouwd markeren. Dat is normaal en je kunt gewoon doorgaan.
Deel 1.B) Installeer en configureer de Agent
📍 Waar: de Windows-server (installatieprogramma), plus Sage 100 France voor stap 4 en 5. Doel: de Agent installeren en koppelen aan SQL Server en je Sage-bedrijven.
💡 Tip: het installatieprogramma vult de meeste waarden zelf in: de PRH-bestanden, de SQL-verbinding (gelezen uit de PRH-bestanden) en de Sage-installatie die het op de server vindt. De voorgestelde waarden werken meestal: laat ze staan en klik op Volgende, tenzij een stap hieronder iets anders zegt. Sommige pagina's verschijnen alleen als ze nodig zijn, dus je ziet mogelijk minder pagina's dan hier beschreven.
⚠ Windows-rechten
Installeer als beheerder: klik met de rechtermuisknop op het installatieprogramma en kies Als administrator uitvoeren.
Ondertekende software: het installatieprogramma is digitaal ondertekend (rechtsklik > Eigenschappen > Digitale handtekeningen toont de uitgever). Toont Windows Windows heeft uw pc beschermd? Klik op Meer informatie > Toch uitvoeren. Staat je organisatie alleen goedgekeurde uitgevers toe (AppLocker, antivirus)? Vraag IT dan om de Agent toe te staan zoals beschreven in Beveiliging. Bestand geblokkeerd na het downloaden? Rechtsklik > Eigenschappen > vink Blokkering opheffen aan.
Tijdens het draaien: de BrynQ-services draaien als LocalSystem. Dat account heeft lees- en schrijfrechten nodig op de Sage-mappen, de PRH-bestanden en de importmap. Bij Windows-authenticatie is dit ook het account dat SQL Server ziet: NT AUTHORITY\SYSTEM, of het computeraccount DOMEIN\SERVERNAAM$ als SQL Server of de Sage-bestanden op een andere server staan.
Map aangemaakt door een andere gebruiker? De installatie stopt als een van de mappen van BrynQ (bijvoorbeeld C:\ProgramData\BrynQ\Agent of de map config daarin) door een andere Windows-gebruiker is aangemaakt. De melding noemt het takeown-commando dat dit oplost.
Is het een rechtenprobleem? Zoek naar Access is denied, Permission denied of Login failed in het log van het installatieprogramma (een kopie staat in C:\ProgramData\BrynQ\Agent\logs\installer, met de naam setup-<date>-<time>.log) of in de Agent-logs (C:\ProgramData\BrynQ\Agent\logs\agent en \sage).
Geavanceerde controles (voor IT):
Service- en installatielogs:C:\ProgramData\BrynQ\Agent\logs\services (bijvoorbeeld BrynQAgentService.err.log) laat zien waarom een service stopte; logs\installer\install-post.log laat de installatiestappen zien en welke stap mislukte.
Logboeken (eventvwr.msc): onder Windows-logboeken > Systeem laten gebeurtenissen van Service Control Manager zien waarom een BrynQ-service niet startte of stopte. Onder Windows-logboeken > Toepassing betekent een SQL Server-melding Login failed (gebeurtenis 18456) dat het Agent-account geen SQL-toegang heeft.
Serviceaccount: open in services.msc een BrynQ-service > Aanmelden om te zien onder welk account deze draait.
Maptoegang: rechtsklik op een Sage-map > Eigenschappen > Beveiliging > Geavanceerd > Effectieve toegang, selecteer SYSTEM (of het computeraccount) en klik op Effectieve toegang weergeven.
Stap 1: Start het installatieprogramma
Start het installatieprogramma en kies je taal. Het installatieprogramma stelt de taal van Windows voor. De BrynQ-pagina's zijn beschikbaar in het Engels, Frans, Duits en Nederlands; de licentieovereenkomst is in het Engels en de namen van Sage-schermen blijven in het Frans. De schermafbeeldingen hieronder zijn in het Engels.
Lees de licentieovereenkomst zorgvuldig. Ga je ermee akkoord en wil je de BrynQ Agent gebruiken, accepteer haar dan om verder te gaan.
Houd het standaard (vooraf ingevulde) installatiepad aan. Dat werkt voor de meeste omgevingen, maar je kunt ook een andere map kiezen. Deze pagina verschijnt alleen bij een eerste installatie.
Cloudverbinding: plak het BrynQ API-token (zie "Voordat je begint"). Het installatieprogramma controleert het token bij BrynQ terwijl je typt. Volgende wordt beschikbaar zodra de pagina BrynQ accepteert dit token. meldt. Token niet geaccepteerd?
BrynQ accepteert dit token niet (…): controleer of je het hele token hebt gekopieerd. De reden staat tussen haakjes, bijvoorbeeld TOKEN_NOT_FOUND of TOKEN_EXPIRED.
BrynQ accepteert dit token alleen vanaf andere IP-adressen: voeg het openbare IP-adres van deze server toe aan het token in BrynQ en klik dan op Opnieuw controleren.
…het is geen agent-token: een agent-token is aan precies één klant gekoppeld. Gebruik het agent-token van deze klant.
BrynQ kon niet worden bereikt of Het BrynQ-platform reageert niet: wacht even en klik op Opnieuw controleren.
Installeer je opnieuw op dezelfde server? Dan meldt de pagina dat de server al verbonden is. Laat Het bestaande API-token behouden (aanbevolen) staan, of kies Vervangen door een nieuw API-token.
Modules: vink Sage 100 France aan (onder Salarisintegraties). Daarmee worden ook SQL Server en Bestandsbeheer ingeschakeld; die blijven aangevinkt en grijs. Vink ook REST-proxy aan als BrynQ je daarom heeft gevraagd. Je kunt de modules later wijzigen door het installatieprogramma opnieuw uit te voeren.
Stap 2: Kies je Sage-bedrijven
Kernidee: elk PRH-bestand is de database van één bedrijf in Sage. Een PRH-bestand selecteren betekent "BrynQ mag in dit bedrijf importeren".
Het installatieprogramma zoekt eerst naar Sage 100 Paie & RH en de PRH-bestanden op de server. Dit kan enkele minuten duren. Vink op de pagina Sage-bedrijven de PRH-bestanden aan van de bedrijven die je aan de interface wilt koppelen. Alleen als een bedrijf ontbreekt: voeg het PRH-bestand toe met PRH toevoegen.... Is dat bedrijf al aangevinkt, dan vraagt het installatieprogramma of het bestand moet worden vervangen. Opnieuw zoeken zoekt opnieuw en behoudt de bestanden die je hebt toegevoegd.
Stap 3: Maak verbinding met SQL Server
BrynQ leest de SQL-verbinding uit de PRH-bestanden die je hebt aangevinkt. Werkt die verbinding, dan slaat het installatieprogramma deze stap over. Vink op de vorige pagina SQL-verbinding zelf controleren aan als je de stap toch wilt zien.
SQL Server-verbinding:
Server: kies de voorgestelde server, vaak SERVERNAAM\SQLEXPRESS. Twijfel je? SQL Server Management Studio toont de servernaam als je verbinding maakt, of vraag het aan je IT-beheerder.
Aanmeldmethode:Windows-authenticatie, of SQL Server-authenticatie als je omgeving een SQL Server-login gebruikt. Alleen die laatste vraagt om Gebruikersnaam en Wachtwoord. Dat account heeft toegang nodig tot de Sage-databases.
Klik op Verbinding testen. Je ziet Verbinding geslaagd, of de reden waarom het mislukte.
Geavanceerd... toont het ODBC-Stuurprogramma en de Extra verbindingsopties (standaard Encrypt=no;TrustServerCertificate=yes). Wijzig deze alleen als de test mislukt; kies het stuurprogramma met het hoogste nummer (bijvoorbeeld ODBC Driver 18 for SQL Server).
Databases: laat Alleen de databases die ik selecteer (aanbevolen) staan en vink ten minste de databases van je Sage-bedrijven aan. Staat een database niet in de lijst? Klik op Database staat niet in de lijst? en voeg de naam toe. Alle databases op deze server omvat ook databases die later worden toegevoegd. Deze keuze legt alleen vast welke databases de BrynQ-interfaces gebruiken. De toegang wordt er niet door beperkt: wil je de toegang beperken, geef de SQL-login dan alleen rechten op deze databases.
Stap 4: Maak een Sage-servicegebruiker aan
📍 Waar: Sage 100 France. Waarom: de Agent heeft een eigen Sage-account nodig, zodat imports niet aan de login van een persoon gekoppeld zijn.
De pagina Sage-serviceaccount van het installatieprogramma toont dezelfde stappen.
Open Sage 100 France, maak verbinding met een PRH-bestand, ga naar Fichier > Droits d'accès > Utilisateurs en klik op +.
Zet Mode d'authentification op Compte de service. Vul een omschrijving in die je herkent (bijvoorbeeld BrynQ) en laat de geldigheidsdatum leeg. Vink Token actif aan en klik op Générer. Voorbeeld:
📍 Terug in het installatieprogramma: plak de Code van de servicegebruiker (bijvoorbeeld AAA, niet de inlognaam) en het Token.
📍 In Sage: klik op OK. Pas na deze stap is de gebruiker aangemaakt.
🔍 Sage-installatie Daarna kiest het installatieprogramma de Sage 100 Paie & RH waarin BrynQ importeert. Bij één installatie gebeurt dat vanzelf. Bij meer dan één toont de pagina Sage-installatie elke installatie met versie en map: kies de installatie die je voor de salarisadministratie gebruikt. Daarin maak je in stap 5 de importmodellen aan. Staat ze er niet bij? Klik op Bladeren... en selecteer de pmsw32.exe of ConnectImport.exe ervan. Oudere versies (v8) kunnen alleen na een waarschuwing worden gekozen; een installatie zonder ConnectImport of zonder gegevensmap kan niet worden gekozen.
Stap 5: Maak de drie BrynQ-importmodellen aan in Sage (nieuw in Agent 3.10)
📍 Waar: Sage 100 France en het installatieprogramma, allebei geopend op de Windows-server.
Titel (Intitulé)
Hoofdbestand (Fichier racine)
BrynQ Salariés
Fiche salarié
BrynQ Salariés en attente
Salariés en attente
BrynQ Absences
Bulletin de paie > Evènements
A. Open het modellenscherm in Sage
Het installatieprogramma toont nu de pagina Sage-importmodellen. Bovenaan staat hoeveel van de drie modellen het heeft gevonden; daaronder staat één regel per model: een groen vinkje met de Sage-code (gevonden), een rood kruis met de reden, of een zandloper zolang de controle loopt. Selecteer een regel om de titel met een knop Kopiëren en de acht stappen voor dat model te zien. Laat de pagina open.
Open Sage 100 Paie & RH (de installatie die bovenaan de pagina staat). Je hoeft geen bedrijf te openen.
Ga naar G.A. > Format d'Importation.
B. Model 1: BrynQ Salariés
Klik op + onder aan de lijst.
Selecteer Fiche salarié en klik op Ok.
Er opent een scherm voor de velden. Wijzig niets: sluit het met de X rechtsboven.
Het venster om op te slaan opent. Selecteer in het installatieprogramma de regel BrynQ Salariés en klik op Kopiëren. Plak de titel in Sage in Intitulé (Ctrl+V) en klik op Ok.
Klik in het installatieprogramma op Opnieuw controleren. De regel BrynQ Salariés heeft nu een groen vinkje ✔ en de Sage-code. Het installatieprogramma controleert ook zelf om de paar seconden.
C. Model 2: BrynQ Salariés en attente
Dezelfde stappen, met een ander hoofdbestand en een andere titel.
Klik op +.
Scroll omlaag, selecteer Salariés en attente en klik op Ok.
Sluit het veldenscherm met de X.
Kopieer BrynQ Salariés en attente in het installatieprogramma, plak de titel in Intitulé en klik op Ok.
Klik op Opnieuw controleren: BrynQ Salariés en attente heeft een groen vinkje ✔.
D. Model 3: BrynQ Absences
Opnieuw dezelfde stappen. Het hoofdbestand zit één niveau dieper, onder Bulletin de paie.
Klik op +.
Selecteer Bulletin de paie en klik op Ok.
Selecteer Evènements en klik op Ok.
Sluit het veldenscherm met de X.
Kopieer BrynQ Absences in het installatieprogramma, plak de titel in Intitulé en klik op Ok.
Klik op Opnieuw controleren: BrynQ Absences heeft een groen vinkje ✔.
E. Sluit Sage en ga verder
Zolang Sage nog open is, meldt de pagina Alle 3 modellen gevonden. Sluit Sage 100 Paie & RH op deze server (alle sessies) om verder te gaan.Sluit Sage 100 Paie & RH volledig af (ook andere sessies op deze server).
De pagina meldt nu Alle 3 modellen gevonden. Klik op Volgende om verder te gaan. Klik op Volgende.
✖ Heeft een regel nog een rood kruis?Volgende blijft onbeschikbaar tot alle drie de modellen gevonden zijn en Sage gesloten is. Selecteer de regel: het installatieprogramma vertelt wat je moet doen.
Niet gevonden: de titel klopt niet precies, of het model is niet opgeslagen. Kopieer de titel opnieuw en corrigeer hem in Sage. Hoofdletters en spaties rond de titel maken niet uit.
Hernoemd: het model dat BrynQ tot nu toe gebruikte, heeft in Sage een andere titel. Geef het weer precies de getoonde titel (gebruik de knop Kopiëren).
Dubbel: meer dan één model heeft deze titel. Behoud het model dat het installatieprogramma noemt en verwijder of hernoem de andere in Sage.
Verkeerd Fichier racine: het model is met een ander hoofdbestand aangemaakt. Verwijder het in Sage en maak het opnieuw aan met het hoofdbestand uit de tabel.
Dit model staat in een andere Sage-installatie: maak het aan in de Sage-installatie die bovenaan de pagina staat.
De modellijst van Sage is niet gevonden: maak eerst de modellen aan in Sage en klik dan op Opnieuw controleren.
ℹ Goed om te weten
Sage geeft elk model een code (bijvoorbeeld IMP00012). Je codes kunnen afwijken van de schermafbeeldingen; alleen de titels zijn van belang.
Hernoem of wijzig de BrynQ-modellen later niet. BrynQ controleert de titels bij elke importcyclus: klopt een titel niet meer precies, dan wordt er niets geïmporteerd tot hij weer klopt (de bestanden wachten in de wachtrij). Wijzigingen in de velden maakt BrynQ ongedaan.
Werk je de Agent later bij? Je ziet deze pagina alleen opnieuw als een model niet in orde is of Sage open is. Een blauw informatieteken (velden gewijzigd in Sage) of een melding dat de modelbestanden ontbreken, vraagt geen actie: BrynQ herstelt het model zelf. Automatische updates en stille installaties tonen deze pagina nooit.
OPTIONEEL: na de installatie zie je de drie modellen onder G.A. > Format d'Importation. Selecteer er een en klik op het potlood om de velden te zien die BrynQ heeft ingevuld. Wijzig ze niet.
Stap 6: Rond de installatie af
ConnectImport-scenario: laat BrynQ het scenario laten maken (aanbevolen) staan en klik op Volgende. Kies alleen Mijn eigen ConnectImport-scenario gebruiken als BrynQ-support je daarom vraagt. Installeer je opnieuw? Laat Het huidige scenario behouden (aanbevolen) staan. Het scenario opnieuw maken vanuit de BrynQ-instellingen overschrijft het huidige scenario.
Extra opties:
Snelkoppelingen: laat Maak een snelkoppeling op het bureaublad (aanbevolen) aangevinkt, en vink desgewenst Maak een snelkoppeling in het menu Start aan. Beide brengen je later direct naar de beheerpagina van de Agent.
BrynQ-support: met Uitgebreide diagnose delen (aanbevolen) kan BrynQ-support extra Windows-gegevens verzamelen als de logs een probleem niet verklaren. Klik op Wat ziet BrynQ-support? om precies te lezen wat. Je kunt dit later wijzigen op de beheerpagina onder Probleemoplossing.
OPTIONEEL: sla over tenzij nodig.Aangepaste lokale netwerkinstellingen gebruiken is alleen nodig als een ander programma op deze server al poort 7070 of 7071 gebruikt. Twijfel je? Laat het dan uitgevinkt.
Klik op Installeren. Het installatieprogramma toont elke stap. Mislukt de laatste stap (bijvoorbeeld omdat BrynQ even niet antwoordt), dan toont het de reden en biedt het Opnieuw aan: al je keuzes blijven bewaard.
OPTIONEEL. Laat Het BrynQ Agent-dashboard openen aangevinkt en klik op Voltooien, of gebruik later de snelkoppeling of open http://127.0.0.1:7071/admin in een browser op de Windows-server (Edge, Chrome of Firefox; Internet Explorer kan de pagina niet tonen). De beheerpagina is beschikbaar in het Engels, Frans, Duits en Nederlands; wissel de taal bovenaan.
Deel 1.C) Controleer of de Agent draait
📍 Waar: de Windows-server.
✅ Controlepunt 1: bevestig dit voordat je verdergaat met deel 2.
Open Taakbeheer en ga naar het tabblad Services.
Controleer of alle drie BrynQ-services de status Wordt uitgevoerd hebben.
Of open de beheerpagina (http://127.0.0.1:7071/admin) en ga naar Probleemoplossing: BrynQ-services toont 3 van 3 actief.
✖ Draait een service niet?
Klik met de rechtermuisknop op de service en kies Starten.
Wacht even en controleer of de status verandert in Wordt uitgevoerd.
Start hij niet, of stopt hij weer? Vaak is dit een rechtenprobleem: controleer Windows-rechten aan het begin van deel 1.B en zoek in de logs naar Access is denied. Kom je er nog steeds niet uit? Neem contact op met BrynQ-support en stuur een schermafbeelding van het tabblad Services en het supportbestand mee (zie Logbestanden van de Agent vinden).
💡 Onthoud: kan BrynQ de Agent later niet bereiken, controleer dan eerst deze drie services.
Deel 2) Maak de interface aan in BrynQ
📍 Waar: BrynQ (op elke computer). In Factorial en Sage 100 France zoek je alleen waarden op. Doel: BrynQ vertellen wat er gesynchroniseerd moet worden en waar het naartoe moet.
Stap 1: Maak de interface aan vanuit de template
Open BrynQ en ga naar Interfaces.
Klik op New interface en kies Use our templates.
Zoek op Sage en selecteer Factorial - Sage 100 France Employees.
Klik op Use template.
Stap 2: Vul het tabblad Configuration in
Open het tabblad Configuration.
Stel de betaalfrequentie van het bedrijf in.
OPTIONEEL (aanbevolen). Voer een paar medewerker-ID's in. De eerste runs verwerken dan alleen deze medewerkers, zodat je veilig kunt testen.
Beantwoord de vraag Is the DPAE sent outside Sage? (wordt de DPAE buiten Sage verstuurd?) met yes of no (oui/non, ja/nee, ja/nein en 1/0 werken ook). Dit antwoord is verplicht: zonder geldig antwoord stopt de run.
Stap 3: Vul de waardekoppelingen in op het tabblad Scenarios
Kernidee: een waardekoppeling (value mapping) vertaalt een waarde in Factorial naar de bijbehorende waarde in Sage. Elk item met een uitroepteken (!) heeft nog je input nodig.
Controleer in Factorial vóór de eerste run
Elk contract heeft een Frans contracttype. Dat bepaalt de contractsoort in Sage; ontbreekt het, dan blijft dat veld leeg en toont het runlog een waarschuwing.
De werkuren en hun frequentie zijn ingevuld. BrynQ gebruikt ze voor de maandelijkse arbeidsduur (bijvoorbeeld 35 u/week = 151,67).
De meeste waardekoppelingen, zoals landen (3-lettercodes zoals FRA) en aanhef, zijn al vooraf ingevuld. Je hoeft ze alleen te controleren.
Open het tabblad Scenarios en zoek de items met een uitroepteken.
Uitgewerkt voorbeeld: 'Legal Entity -> Paying Establishment and Dossier' Deze koppeling vind je in het scenario Registratie. Het is de belangrijkste koppeling: die bepaalt welke juridische entiteit uit Factorial naar welk Sage-bedrijf wordt gesynchroniseerd. We lopen hem stap voor stap door; de andere koppelingen werken op dezelfde manier.
Linkerkant (📍 Factorial): zoek het ID en de naam van de juridische entiteit op onder Instellingen > Bedrijfsgegevens.
📍 BrynQ: vul deze waarde in aan de linkerkant van de koppeling. Synchroniseer je meerdere entiteiten? Voeg dan per entiteit een regel toe.
Rechterkant (📍 Sage 100 France): zoek de bijbehorende Raison sociale / het dossier van het Sage-PRH-bestand. In dit voorbeeld is het dossier 'BRYNQ.PRH'.
📍 Sage 100 France: zoek ook het bijbehorende 'Etablissement principal' op.
📍 BrynQ: vul deze waarden in aan de rechterkant van de koppeling. Het resultaat ziet er zo uit:
Bevestig de koppeling en sla hem op.
Nu jij: vul de andere niet-standaard koppelingen op dezelfde manier in (zoek aan beide kanten de waarde op, vul in, bevestig, sla op):
Controleer tot slot of de standaard waardekoppelingen kloppen voor je bedrijf:
Stap 4: Koppel Factorial en Sage (tabblad Authorization)
Open het tabblad Authorization.
Eerst Factorial: klik op Add authorization (TEST and LIVE), voer een herkenbare naam in en klik op Connect to app.
Log in met je Factorial-BEHEERDERSaccount.
Zorg dat de TEST-versie actief is voordat je je eerste testrun doet.
⚡ Let op: dit kan automatisch koppelen! Ben je in deze browser al ingelogd bij Factorial, met een actieve login (sessiecookie)? Dan koppelt Connect to app direct met dat account, zonder dat je hoeft in te loggen. Dus voordat je klikt: controleer of je bij Factorial bent ingelogd met het beheerdersaccount. Zo niet, log dan eerst uit bij Factorial, of gebruik een privé-/incognitovenster.
Keur de gevraagde toegang goed en sla de verbinding op.
Daarna Sage: voeg de Sage-autorisatie toe.
Voer de BrynQ Agent-URL in dit formaat in: https://[je-klant-slug].brynq-agent.com Waar vind je jouw slug: het is het eerste deel van je BrynQ-webadres. Het exacte adres staat ook in C:\ProgramData\BrynQ\Agent\config\public_url.txt op de Windows-server. Log je in op https://acme.app.brynq.com, dan is je slug acme en is de Agent-URL https://acme.brynq-agent.com.
Voer het BrynQ Agent Token in: hetzelfde token dat je eerder hebt ontvangen en in het installatieprogramma hebt ingevuld.
Controleer de eerste run
✅ Controlepunt 2: na een gecontroleerde testrun:
📍 Windows-server: er verschijnt een nieuw Excel-importbestand in de importmap van het bedrijf: <dossier>.xlsx voor bestaande medewerkers, en <dossier>_EN_ATTENTE.xlsx als er nieuwe medewerkers zijn. Na de import verplaatst de Agent de bestanden naar een submap met de naam importe le <datum en tijd>.
📍 Sage 100 France: bestaande medewerkers zijn bijgewerkt, en nieuwe medewerkers staan onder Gestion > Salariés en attente. Neem ze daar in dienst: selecteer de regels met Tout en klik op Embaucher. Begin met de test-medewerker-ID's die je in stap 2 hebt ingevuld.
✖ Ging er iets mis?
Geen importbestand op de server: lees eerst het runlog van de interface (interface > Runs). Er wordt geen bestand verstuurd als de interface geen nieuwe of gewijzigde medewerkers heeft gevonden, of als ze allemaal zijn weggefilterd (Factorial-rechten, gegevens, waardekoppelingen). Meldt het runlog dat er een bestand is verstuurd? Dan kon BrynQ het niet bij de Agent afleveren: controleer de drie BrynQ-services (deel 1.C) en test de Sage-autorisatie opnieuw.
'Import terminé avec succès', maar geen nieuwe medewerker: kijk eerst onder Salariés en attente (Sage v9).
Het importbestand is er, maar Sage heeft geen of verkeerde gegevens: controleer het runlog, de gegevens in Factorial en de waardekoppelingen op het tabblad Scenarios, vooral Registratie.
Er ontbreken medewerkers: controleer het runlog. Veelvoorkomende oorzaken: Factorial-rechten (koppel opnieuw met een beheerdersaccount), ontbrekende of verkeerde gegevens in Factorial, of een waardekoppeling die niet is ingevuld.
Kom je er nog niet uit? Bekijk het onderdeel Probleemoplossing hieronder, of neem contact op met BrynQ-support en voeg het supportbestand toe (beheerpagina > Probleemoplossing > Supportbestand downloaden).
Probleemoplossing
Wat je ziet
Wat je doet
Een fout die je niet kunt verklaren
Open de beheerpagina (http://127.0.0.1:7071/admin) > Probleemoplossing: die controleert de services, de verbinding met BrynQ, de maptoegang en meer, en toont oplossingen voor veelvoorkomende problemen. Deel het supportbestand met BrynQ-support (zie Logbestanden van de Agent vinden hieronder).
Delen van de installatie mislukken, of de Agent draait maar kan geen bestanden lezen of schrijven
Controleer de Windows-rechten: voer het installatieprogramma uit als administrator en zorg dat het Windows-account van de Agent de Sage-mappen, PRH-bestanden, programFiles en programData kan lezen en schrijven. Zie de waarschuwing aan het begin van deel 1.B.
Installatieprogramma: Volgende blijft onbeschikbaar op Cloudverbinding
BrynQ accepteert het token nog niet. De pagina meldt waarom: kopieer het hele token, voeg het openbare IP-adres van de server toe aan het token in BrynQ, of gebruik het agent-token van deze klant. Klik daarna op Opnieuw controleren. Zie deel 1.B, stap 1.
Installatieprogramma: Volgende blijft onbeschikbaar op Sage-importmodellen
Een regel heeft nog een rood kruis, of Sage is nog open. Zie stap 5 voor de betekenis van elke melding; sluit Sage (alle sessies) zodra alle drie de modellen gevonden zijn.
Niet alle medewerkers worden gesynchroniseerd
Lees eerst het runlog van de interface (interface > Runs). Veelvoorkomende oorzaken: de Factorial-gebruiker kan niet alle medewerkers zien (koppel opnieuw met een Factorial-beheerdersaccount), ontbrekende of verkeerde gegevens in Factorial, een waardekoppeling die niet is ingevuld, of test-medewerker-ID's die nog op het tabblad Configuration staan. Zie Employees: Probleemoplossing.
'Erreur mot de passe' (wachtwoordfout) op de Sage-server (dit komt vaak voor)
Controleer eerst de code en het token van het Sage-serviceaccount en initialiseer daarna de gebruiker of het dossier opnieuw in Sage. Zie 'Erreur mot de passe' oplossen hieronder.
BrynQ kan de Agent niet bereiken
Controleer of de drie BrynQ-services draaien (deel 1.C), open daarna http://127.0.0.1:7071/admin op de Windows-server en ga naar BrynQ-verbinding: zowel Deze agent meldt zich aan bij BrynQ als BrynQ bereikt deze agent moeten in orde zijn. Test vervolgens de Sage-autorisatie opnieuw vanaf het tabblad Authorization.
Het installatieprogramma kan geen verbinding maken met SQL Server
Klik op Verbinding testen en lees de reden. Controleer of de servernaam klopt (stap 3), kies de juiste aanmeldmethode (Windows- of SQL Server-authenticatie), probeer het ODBC-stuurprogramma met het hoogste nummer onder Geavanceerd... en controleer of het account toegang heeft tot de Sage-databases.
Een app die de template gebruikt is inactief
Activeer de app via Settings > Interfaces > Apps.
Een handmatige Sage-import werkt, maar de automatische run niet
Controleer de Agent op de beheerpagina (http://127.0.0.1:7071/admin) onder SAGE 100 France > Overzicht en Probleemoplossing, en test daarna de Sage-autorisatie opnieuw vanaf het tabblad Authorization.
Je moet een autorisatie bekijken of verwijderen
Open Settings > Interfaces > Connections.
Logbestanden van de Agent vinden
📍 Waar: de Windows-server, in Verkenner. Als er iets misgaat, vertellen de logbestanden van de Agent jou (en BrynQ-support) meestal waarom. Er zijn twee logmappen. Welke je nodig hebt, hangt af van het probleem:
Probleem
Logmap
Gegevens importeren in Sage mislukt of geeft verkeerde resultaten
C:\ProgramData\BrynQ\Agent\logs\sage
Algemene problemen met de Agent, zoals verbindingsproblemen
C:\ProgramData\BrynQ\Agent\logs\agent
Sage-importlogs (bijvoorbeeld connectimport en connectimport-error):
Algemene Agent-logs (bijvoorbeeld application, requests en security):
Je kunt de logbestanden ook op de beheerpagina lezen: Probleemoplossing > Logbestanden (nieuwste eerst; klik op een bestand om het te lezen).
💡 Contact met BrynQ-support? Voeg het supportbestand toe: ga op de beheerpagina naar Probleemoplossing (of SAGE 100 France > Probleemoplossing) en klik op Supportbestand downloaden. Het bevat de logs, de instellingen en de status van de services in één zipbestand (brynq-agent-support-<customer>-<server>-<date>-<time>.zip), zonder wachtwoorden en tokens. Opent de beheerpagina niet? Voer dan "C:\Program Files\BrynQ\Agent\brynq-agent.exe" --support-file uit in een opdrachtprompt als administrator; het bestand wordt op je bureaublad opgeslagen. Dit scheelt meestal veel heen-en-weer.
Zie je de map ProgramData niet? Die is standaard verborgen. Typ C:\ProgramData\BrynQ\Agent\logs rechtstreeks in de adresbalk van Verkenner.
'Erreur mot de passe' oplossen
📍 Waar: Sage 100 France, op de Windows-server. De fout 'Erreur mot de passe' komt vrij vaak voor op de Sage-server. Er zijn twee veelvoorkomende oorzaken:
De code of het token van het Sage-serviceaccount dat de BrynQ-import gebruikt, klopt niet, of het token is niet meer actief. Dit is de waarschijnlijke oorzaak als er nog geen import met dit account heeft gewerkt, of nadat iemand het account in Sage heeft gewijzigd.
Sage houdt nog een oude sessie van het account vast. Dit is de waarschijnlijke oorzaak als imports eerder wel werkten. Initialiseer de gebruiker of het dossier opnieuw (optie A en B).
De beheerpagina noemt de waarschijnlijke oorzaak: open http://127.0.0.1:7071/admin > SAGE 100 France > Probleemoplossing en lees de laatste importmelding.
Controleer eerst het serviceaccount
Ga in Sage naar Fichier > Droits d'accès > Utilisateurs en open het serviceaccount van de BrynQ-import.
Controleer of Mode d'authentification op Compte de service staat en of Token actif is aangevinkt. Noteer de Code.
Twijfel je of het token klopt? Klik op Générer voor een nieuw token, kopieer het en klik op OK.
Open op de Windows-server http://127.0.0.1:7071/admin > SAGE 100 France > Service. Controleer of de Sage-gebruikerscode overeenkomt met de Code in Sage. Heb je een nieuw token gegenereerd, klik dan op Token vervangen, plak het en sla op.
Wacht op de volgende importcyclus (standaard 15 minuten) en controleer de importmelding opnieuw.
Nog steeds 'Erreur mot de passe'? Initialiseer de sessie opnieuw. Begin met optie A. Gebruik optie B alleen als A niet helpt.
Optie A: opnieuw initialiseren vanuit het bedrijf (probeer dit eerst)
Open Sage 100 France en maak verbinding met het bedrijf (PRH-bestand).
Ga naar Fichier > Droits d'accès > Utilisateurs.
Klik in de Liste des utilisateurs op Réinitialisation.
Probeer de verbinding opnieuw.
Optie B: het hele dossier opnieuw initialiseren (op eigen risico)
⚠ Op eigen risico.Réinitialiser le dossier meldt alle gebruikers van het dossier af. Zorg dat niemand in de salarisadministratie aan het werk is voordat je dit gebruikt.
Ga naar Fichier > Utilitaires > Réinitialisation. Zie je deze optie niet? Soms is ze alleen zichtbaar als je niet met een bedrijf verbonden bent. Sluit eerst het bedrijf (Fichier > Fermer) en kijk opnieuw.
De Assistant réinitialisation de dossier opent. Klik op Parcourir... en selecteer het dossier (PRH-bestand) dat je opnieuw wilt initialiseren.
Klik op Réinitialiser le dossier. Wil je maar één bepaalde gebruiker afmelden, selecteer dan die gebruiker en klik in plaats daarvan op Réinitialiser l'utilisateur.
Klik op Terminer en probeer de verbinding opnieuw.
Samenvatting
De Agent op de Windows-server ontvangt de importbestanden en importeert ze in de PRH-bestanden die je hebt geselecteerd. De Agent bereikt de Sage-gegevens via SQL Server.
De waardekoppelingen bepalen welke Factorial-entiteit in welk Sage-bedrijf terechtkomt. Wees extra zorgvuldig met 'Legal Entity -> Paying Establishment and Dossier' in Registratie.
De autorisaties koppelen BrynQ aan Factorial (beheerdersaccount!) en aan de Agent.
Loop je vast? Controleer eerst de drie BrynQ-services en de pagina Probleemoplossing van de beheerpagina. Neem daarna contact op met BrynQ-support en voeg het supportbestand toe.