Factorial - Sage 100 France | Afwezigheden: De interface opzetten

Factorial - Sage 100 France | Afwezigheden: De interface opzetten

📌 Deze handleiding is voor: Afwezigheidstemplate 2.x · BrynQ Agent 3.10 of nieuwer · Sage 100 France v9. Een andere versie? Zie Begin hier – kies je versie.

Wat het is

De template Factorial - Sage 100 France | Congés & Absences Payés stuurt goedgekeurd verlof en goedgekeurde afwezigheden automatisch van Factorial naar Sage 100 France (v9). BrynQ leest de goedgekeurde afwezigheden in Factorial, vergelijkt ze met wat al in Sage staat, en stuurt alleen de wijzigingen in een importbestand per Sage-bedrijf, <dossier>_ABSENCES.xlsx. De BrynQ Agent op je Sage-server importeert het met ConnectImport.

Hoe het werkt

Sage kan via een import alleen gebeurtenissen toevoegen. Het kan er geen wijzigen of verwijderen. Daarom past BrynQ nooit iets aan in Sage: bij elke run telt BrynQ elke afwezigheid in Factorial en in Sage, en stuurt alleen de gebeurtenissen die nodig zijn om de twee tellingen gelijk te maken. Om een afwezigheid weg te halen, stuurt BrynQ een annuleringsgebeurtenis.

1. Wat BrynQ vergelijkt

  • Factorial: alle goedgekeurde afwezigheden, ongeacht de datums. Aanvragen die nog in behandeling zijn en verlofsoorten die niet in de mapping staan, worden overgeslagen.
  • Sage: alle afwezigheidsgebeurtenissen van de medewerkers die minstens één goedgekeurde afwezigheid in Factorial hebben. Zowel de gebeurtenissen die BrynQ heeft geïmporteerd als de gebeurtenissen die met de hand zijn ingevoerd, tellen mee. Gebeurtenissen die in Sage als geannuleerd zijn gemarkeerd, worden genegeerd.
  • Eén afwezigheid is: hetzelfde matricule, dezelfde Code nature événement, hetzelfde Motif d'absence, dezelfde begindatum en dezelfde einddatum. De halve dag, Nombre en de geldigheidsdatum worden niet vergeleken. Als Sage een gebeurtenis zonder motif heeft opgeslagen, wordt het motif voor die afwezigheid genegeerd.

2. De telling

Voor elke afwezigheid telt BrynQ hoe vaak die in Sage staat. Elke gebeurtenis telt +1. Elke annuleringsgebeurtenis van dezelfde code (de code in het veld Nature d'annulation, bijvoorbeeld 9950 voor 0950) telt −1. Een afwezigheid die is geïmporteerd en later geannuleerd, telt dus 0: voor BrynQ staat die niet meer in Sage. Daarna geldt:

  • Te versturen nieuwe afwezigheden = het aantal in Factorial min het aantal in Sage, waarbij gebeurtenissen van elke geldigheidsdatum meetellen. BrynQ verstuurt nooit een afwezigheid die al in Sage staat, ook niet een uit een eerdere maand.
  • Te versturen annuleringen = het aantal in Sage min het aantal in Factorial, waarbij alleen gebeurtenissen met de geldigheidsdatum van deze run meetellen (zie 3). BrynQ annuleert nooit een gebeurtenis van een eerdere salariscyclus.

Voorbeelden, voor één medewerker en één afwezigheid:

SituatieFactorialSageBrynQ verstuurt
Een nieuwe afwezigheid wordt goedgekeurd10De afwezigheid
De volgende run, er is niets veranderd11Niets
De afwezigheid wordt in Factorial verwijderd of afgewezen. Ze is in deze cyclus geïmporteerd01 (deze cyclus)Een annuleringsgebeurtenis (bijvoorbeeld 9950)
Hetzelfde, maar ze is in een eerdere cyclus geïmporteerd01 (eerdere cyclus)Niets. Zie Dagelijks gebruik.
De datums, de verlofsoort of het motif veranderen. De oude versie is in deze cyclus geïmporteerdnieuw 1, oud 0nieuw 0, oud 1De nieuwe afwezigheid en een annulering van de oude, in hetzelfde bestand
Dezelfde wijziging, maar de oude versie komt uit een eerdere cyclusnieuw 1, oud 0nieuw 0, oud 1 (eerdere cyclus)Alleen de nieuwe afwezigheid. Zie Dagelijks gebruik.
Alleen de halve dag verandert11Niets. Zie Dagelijks gebruik.
Een afwezigheid die BrynQ eerder heeft geannuleerd, wordt opnieuw goedgekeurd11 − 1 = 0De afwezigheid opnieuw
De afwezigheid staat twee keer in Sage, beide in deze cyclus12Eén annuleringsgebeurtenis
De afwezigheid is met de hand in Sage ingevoerd (hetzelfde matricule, dezelfde code, hetzelfde motif en dezelfde datums)11Niets: geen dubbele invoer
Een gebeurtenis die met de hand in Sage is ingevoerd met de geldigheidsdatum van deze run, staat niet in Factorial01 (deze cyclus)Een annuleringsgebeurtenis. Als de code van die gebeurtenis geen Nature d'annulation heeft, stopt de run in plaats daarvan.
De verwijderde afwezigheid was de laatste goedgekeurde afwezigheid van de medewerker in Factorial01Niets: BrynQ controleert deze medewerker niet meer. Zie Dagelijks gebruik.

3. Wat "deze cyclus" betekent

Elke gebeurtenis die BrynQ verstuurt, krijgt een geldigheidsdatum: je antwoord in het tabblad Configuration, gerekend vanaf de dag van de run. Gebeurtenissen met de geldigheidsdatum van de huidige run horen bij deze cyclus. Voorbeeld met Premier jour du mois suivant: elke run in oktober gebruikt 01/11, dus in oktober kan BrynQ nog annuleren en corrigeren wat het in oktober heeft verstuurd. Vanaf 1 november gebruiken de runs 01/12. Wat in oktober is verstuurd, hoort dan bij een eerdere cyclus, en BrynQ annuleert het niet meer.

4. De annuleringscodes

  • Een annuleringsgebeurtenis gebruikt de annuleringscode van de oorspronkelijke code: de code die in Sage in het veld Nature d'annulation van die code is geselecteerd. Het is een kopie van de oorspronkelijke code met de omgekeerde Sens, zodat de dagen weer worden afgetrokken. Volgens afspraak begint het nummer met 9 (0950 → 9950) en eindigt de titel op [N].
  • Aan het begin van elke run controleert BrynQ of elke gebeurteniscode in je mapping een Nature d'annulation heeft. Ontbreekt er een, dan stopt de run voordat er iets wordt verstuurd, en worden de codes genoemd. Zie Stap 5.
  • Een annuleringsgebeurtenis heeft ook Nombre nodig. BrynQ haalt dat uit je mapping, voor die gebeurteniscode en dat motif. Staat het niet meer in de mapping, bijvoorbeeld omdat je een verlofsoort hebt verwijderd, dan stopt de run. Zie Dagelijks gebruik.

Wat je moet doen

Weet waar je bent

De stappen wisselen tussen verschillende plekken. Elke stap begint met een label 📍 Waar:

📍 LabelWat het is
BrynQHet BrynQ-platform in je browser (https://je-slug.app.brynq.com).
FactorialFactorial in je browser.
Sage 100 FranceDe Sage-applicatie, geopend op de Windows-server, in het dossier (PRH-bestand) waar de afwezigheden naartoe gaan.
Windows-serverDe computer waarop Sage 100 France en de BrynQ Agent zijn geïnstalleerd.

De route in één oogopslag

StapWat je doet📍 WaarWie
1Maak de interface aan vanuit de templateBrynQBrynQ-beheerder
2Vul de configuratie inBrynQ, tabblad ConfigurationBrynQ-beheerder, met de salarisadministratie voor de geldigheidsdatum
3Begin in dry modeBrynQ, interface > SettingsBrynQ-beheerder
4Vul het scenario aanBrynQ, tabblad Scenarios, met Sage 100 France geopend om de codes op te zoekenBrynQ-beheerder, met de salarisadministratie
5Maak de annuleringscodes aan in SageSage 100 FranceSalarisadministratie (Sage-beheerder)
6Voeg de autorisaties toeBrynQ, AuthorizationsBrynQ-beheerder en Factorial-beheerder
7Uitvoeren en controlerenBrynQ, daarna de Windows-server en Sage 100 FranceBrynQ-beheerder en salarisadministratie

Voordat je begint

  • ☐ De medewerkers staan in Sage. Afwezigheden worden via het matricule aan een medewerker gekoppeld: het personeelsnummer (company identifier) in Factorial moet gelijk zijn aan het matricule in Sage. Zet eerst de template Factorial - Sage 100 France | Medewerkers op. Nieuwe medewerkers moeten in Sage in dienst zijn genomen (en niet meer onder Salariés en attente staan) voordat hun afwezigheden kunnen worden geïmporteerd.
  • ☐ BrynQ Agent 3.10 of nieuwer met de module Sage 100 France, en het lege importmodel BrynQ Absences in Sage. Zie stap 5 van Een geautomatiseerde gegevensinterface instellen tussen Factorial en Sage.
  • ☐ Een annuleringscode voor elke Sage-gebeurteniscode die je gebruikt. In Sage heeft elke nature d'événement die je mapt (bijvoorbeeld 0950) een bijbehorende annuleringsnature nodig, ingevuld in het veld Nature d'annulation. Zonder die code kan BrynQ een afwezigheid in Sage niet annuleren of corrigeren, en stopt de run met instructies. Zie Stap 5.
  • ☐ Een Factorial-beheerdersaccount. BrynQ ziet alleen de afwezigheden van de medewerkers die dit account kan zien.

Stap 1: Maak de interface aan vanuit de template

📍 Waar: BrynQ.
Doel: De interface aanmaken vanuit de template.
Wie: BrynQ-beheerder.

  1. Ga in BrynQ naar Interfaces > New interface > Use our templates.
  2. Zoek op Sage en selecteer Factorial - Sage 100 France | Congés & Absences Payés.
  3. Controleer of de apps Factorial en Sage actief zijn.

Stap 2: Vul de configuratie in

📍 Waar: BrynQ, tabblad Configuration.
Doel: Je testmedewerkers en de geldigheidsdatum kiezen.
Wie: BrynQ-beheerder, met de salarisadministratie voor de geldigheidsdatum.

Open het tabblad Configuration:

  1. OPTIONEEL (aanbevolen). Pendant les tests : quels sont les numéros de matricule des employés test ? Vul een paar matricules in, gescheiden door komma's. Je eerste runs verwerken dan alleen de afwezigheden van deze medewerkers. Verwijder ze als je klaar bent met testen.
  2. Verplicht. Quelle est la date de validation ? Kies de geldigheidsdatum die Sage aan de geïmporteerde gebeurtenissen geeft, gerekend vanaf het moment dat de interface draait: Premier jour du mois suivant, Premier jour du mois en cours of Dernier jour du mois en cours. Kies de optie die past bij hoe jouw salarisadministratie afwezigheden verwerkt. Zonder antwoord stopt de run.

Vanaf templateversie 2.1.0 heeft de interface ook twee variabelen (tabblad Variables):

VariabeleWaardeWat het doet
Enable Data Validationtrue of false (standaard false)Bij true maakt elke run een HTML-rapport met de vulgraad van elk veld, aan de kant van Factorial en in het Sage-importbestand.
Send Report toE-mailadressen, gescheiden door komma'sDeze adressen ontvangen de runrapporten. Leeg: er wordt geen e-mail verstuurd.

Stap 3: Begin in dry mode

📍 Waar: BrynQ, interface > Settings.
Doel: Je eerste runs veilige testruns maken.
Wie: BrynQ-beheerder.

Ga in BrynQ naar Interfaces, klik op de interface en open het tabblad Settings. Dry mode bepaalt of BrynQ echt bestanden naar Sage stuurt:

Dry modeWat er gebeurt
AanTestrun. BrynQ vergelijkt Factorial met Sage en schrijft in het runlog hoeveel afwezigheden en annuleringen het zou versturen, maar verstuurt niets.
UitBrynQ stuurt de wijzigingen naar Sage.
💡 Tip: zet dry mode aan voor je eerste run en controleer het runlog. Kloppen de aantallen, zet het dan uit.

Stap 4: Vul het scenario aan

📍 Waar: BrynQ, tabblad Scenarios, met Sage 100 France geopend om de codes op te zoeken.
Doel: BrynQ laten weten welke Sage-codes elke verlofsoort uit Factorial gebruikt.
Wie: BrynQ-beheerder, met de salarisadministratie.

Open het tabblad Scenarios en het scenario Congés & Absences Payés. Vul elk onderdeel aan dat met een uitroepteken (!) is gemarkeerd:

MappingWat je doet
Juridische entiteit → DossierKoppel elke juridische entiteit in Factorial aan het bijbehorende Sage-bedrijf (dossier). Het dossier moet overeenkomen met de bedrijfsmap in de Sage-importmap, en dat is de bedrijfsnaam van het PRH-bestand.
Juridische entiteit + verlofsoort → Sage-codesVul voor elke verlofsoort in Factorial, per juridische entiteit, drie Sage-waarden in: de Code nature événement (gebeurteniscode), het Motif d'absence (redencode voor de DSN-aangifte) en Nombre (de Sage-constante die de duur telt, bijvoorbeeld in werkdagen of kalenderdagen). Vul de naam van de verlofsoort precies zo in als in Factorial.
Personeelsnummer → MatriculeVooraf ingevuld. De company identifier uit Factorial wordt gebruikt als Sage-matricule.
Begin- en einddatumVooraf ingevuld.
GeldigheidsdatumWordt automatisch ingevuld op basis van je antwoord in het tabblad Configuration.
Halve dagVooraf ingevuld. Een halve dag aan het eind van de eerste dag wordt in Sage een middagafwezigheid op de eerste dag; een halve dag aan het begin van de laatste dag wordt een ochtendafwezigheid op de laatste dag. Alleen controleren.

Voorbeeld van de mapping van verlofsoorten (gebruik de codes uit je eigen Sage-bestand):

Juridische entiteit in FactorialVerlofsoort in FactorialCode nature événementMotif d'absenceNombre
Je juridische entiteitBetaald verlof0950CPSTOTJRSOUV
Je juridische entiteitZiekteverlof2000MAMAL_NBH
⚠ Een verlofsoort zonder mapping wordt niet verstuurd. Voeg je een nieuwe verlofsoort toe in Factorial, voeg die dan ook aan deze mapping toe. Controleer ook of de gebeurteniscode in Sage een Nature d'annulation heeft (zie stap 5).

Stap 5: Maak de annuleringscodes aan in Sage

📍 Waar: Sage 100 France.
Doel: Een annuleringscode voor elke gebeurteniscode in je mapping.
Wie: Salarisadministratie (Sage-beheerder).

BrynQ annuleert en corrigeert afwezigheden met annuleringscodes (zie Hoe het werkt). Elke Code nature événement in je mapping heeft een eigen annuleringscode in Sage nodig. Je doet dit één keer per code, in elk Sage-dossier waar de afwezigheden naartoe gaan. In het voorbeeld hieronder wordt de annuleringscode voor 0950 Absence congés aangemaakt.

🎬 Video: bekijk de stappen hieronder één keer en volg daarna de tekst voor de details.
  1. Bekijk in BrynQ de Sage-kolommen van je mapping (stap 4) en noteer elke verschillende Code nature événement. In dit voorbeeld zijn dat 0950, 0955 en 2000: drie codes, dus drie annuleringscodes.
  2. Open in Sage 100 France het dossier (het PRH-bestand van het bedrijf). Ga naar Listes > Natures d'évènements.
  3. De lijst toont elke gebeurtenisnature met de code en de titel. Selecteer de code, hier 0950 Absence congés, en klik op de knop kopiëren.
  4. Er opent een kopie met een lege Code. Vul de nieuwe code in. Vuistregel: dezelfde code met het eerste cijfer veranderd in 9, dus 0950 wordt 9950. Alleen als die code nog niet door een andere gebeurtenisnature wordt gebruikt. Is dat wel zo, kies dan een andere vrije code.
  5. Voeg [N] (van negatie) toe aan het Intitulé: Absence congés [N].
  6. Belangrijk: zet onder A cumuler dans les constantes elke Sens op het omgekeerde teken. Een (+) in de oorspronkelijke code wordt (−), een (−) wordt (+).
  7. Vergelijk beide codes naast elkaar: dezelfde constanten, met de omgekeerde Sens. Links de oorspronkelijke code, rechts de annuleringscode.
  8. Controleer op het tabblad Bulletin van de nieuwe code of Nature d'annulation leeg is. Klik op Ok.
  9. Belangrijk, anders stopt de interface: open de oorspronkelijke code (0950), ga naar het tabblad Bulletin en selecteer de nieuwe code (9950) in Nature d'annulation. Doe dit alleen bij de oorspronkelijke code, nooit bij de annuleringscode. Klik op Ok.
  10. Herhaal stap 3 tot en met 9 voor elke andere code uit stap 1.
✅ Controlepunt: elke code uit je mapping heeft een annuleringscode met de omgekeerde Sens, en de oorspronkelijke code verwijst ernaar in Nature d'annulation. Het volgende runlog bevestigt dat alle gemapte codes een annuleringscode hebben.

⚠ Als een stap is overgeslagen of verkeerd is uitgevoerd, kun je het volgende verwachten:

Wat er misgingWat je zietWat je doet
De oorspronkelijke code heeft geen Nature d'annulation, of een code uit de mapping is overgeslagenDe run stopt voordat er iets is verstuurd, en noemt de codes.Voer stap 9 uit voor elke genoemde code en start de run opnieuw.
De Sens is op de annuleringscode niet omgedraaidNiets in BrynQ: de run meldt dat Sage up-to-date is. Maar in Sage telt een annulering de dagen opnieuw op in plaats van ze af te trekken, zodat saldi zoals congés pris niet kloppen.Corrigeer de Sens op de annuleringscode. Controleer en corrigeer daarna met de hand in Sage de saldi van de medewerkers met geannuleerde afwezigheden.
Nature d'annulation is ook ingevuld op de annuleringscode (bijvoorbeeld als je een code hebt gekopieerd die er al een had)Zodra de eerste annulering in Sage staat, haalt BrynQ de twee codes door elkaar en verstuurt bij elke run dezelfde afwezigheden opnieuw.Maak Nature d'annulation leeg op de annuleringscode en annuleer daarna met de hand de dubbele afwezigheden in Sage.
De nieuwe code werd al gebruikt door een andere gebeurtenisnatureGebeurtenissen van die andere nature tellen als annuleringen: afwezigheden worden twee keer verstuurd, of niet geannuleerd.Maak een annuleringscode aan met een vrij nummer, selecteer die in Nature d'annulation van de oorspronkelijke code, en controleer in Sage de afwezigheden van de betrokken medewerkers.

Stap 6: Voeg de autorisaties toe

📍 Waar: BrynQ, Authorizations.
Doel: Factorial en Sage koppelen.
Wie: BrynQ-beheerder en Factorial-beheerder.

  • Factorial: maak verbinding met een Factorial-beheerdersaccount.
  • Sage: vul de BrynQ Agent-URL (https://[your-customer-slug].brynq-agent.com) en het Agent-token in, dezelfde als voor de interface voor medewerkers.

Stap 7: Uitvoeren en controleren

📍 Waar: BrynQ, daarna de Windows-server en Sage 100 France.
Doel: Controleren of de eerste afwezigheden goed aankomen.
Wie: BrynQ-beheerder en salarisadministratie.

  1. Voer de interface uit met dry mode aan en lees het runlog. Daarin staat hoeveel nieuwe afwezigheden en annuleringen zouden worden verstuurd, of dat Sage al up-to-date is.
  2. Zet dry mode uit en voer de interface opnieuw uit.
  3. 📍 Windows-server: er verschijnt een bestand <dossier>_ABSENCES.xlsx in de importmap van het bedrijf. De Agent importeert het bij de volgende controle op nieuwe importbestanden (standaard elke 15 minuten; je kunt dit wijzigen op de beheerpagina van de Agent onder SAGE 100 France > Service. Dit is hoe vaak de Agent naar een nieuw bestand kijkt, niet hoe vaak de interface draait) en verplaatst het daarna naar een submap met de naam importe le <datum en tijd>.
  4. 📍 Sage 100 France: controleer de afwezigheidsgebeurtenissen van je testmedewerkers.
✅ Controlepunt: de afwezigheden van je testmedewerkers staan in Sage, en een tweede run meldt dat er niets nieuws te versturen is.

Dagelijks gebruik: Factorial en Sage gelijk houden

Zodra de interface draait, werkt HR in Factorial en werkt BrynQ Sage bij. In een paar situaties is een handmatige correctie in Sage nodig (zie Hoe het werkt voor de reden). Voer correcties in Factorial waar mogelijk door voordat de cyclus wisselt.

SituatieWat je doet📍 WaarWie
Er komt een verlofaanvraag binnenKeur die goed. Alleen goedgekeurde afwezigheden worden verstuurd.FactorialManager of HR
Een afwezigheid moet worden gewijzigd of geannuleerd, en is in de huidige cyclus verstuurdWijzig of verwijder de afwezigheid in Factorial. De volgende run corrigeert Sage.FactorialHR
Hetzelfde, maar de afwezigheid is in een eerdere cyclus verstuurdWijzig of verwijder de afwezigheid in Factorial, en annuleer de oude gebeurtenis met de hand in Sage. BrynQ verstuurt de nieuwe versie, maar annuleert de oude niet.Factorial en Sage 100 FranceHR en salarisadministratie
Alleen de halve dag verandertWijzig die in Factorial en corrigeer de gebeurtenis met de hand in Sage. BrynQ vergelijkt geen halve dagen.Factorial en Sage 100 FranceHR en salarisadministratie
De laatste goedgekeurde afwezigheid van een medewerker in Factorial wordt verwijderdAnnuleer de gebeurtenis met de hand in Sage. BrynQ controleert deze medewerker niet meer.Sage 100 FranceSalarisadministratie
Je wilt een afwezigheid rechtstreeks in Sage invoerenVoer die in plaats daarvan in Factorial in. Een gebeurtenis die met de hand in Sage is ingevoerd met de huidige geldigheidsdatum, en die niet in Factorial staat, wordt bij de volgende run geannuleerd.FactorialHR
Er wordt een nieuwe verlofsoort toegevoegd in FactorialVoeg die toe aan de mapping (stap 4). Gebruikt de verlofsoort een nieuwe Code nature événement, maak dan eerst de annuleringscode aan (stap 5).BrynQ en Sage 100 FranceBrynQ-beheerder en salarisadministratie
Een verlofsoort wordt uit de mapping verwijderdControleer eerst of Sage in de huidige cyclus geen gebeurtenissen van die soort heeft. Anders stopt de volgende run, omdat die ze zonder de mapping niet kan annuleren.Sage 100 France, daarna BrynQSalarisadministratie en BrynQ-beheerder

Hulp nodig?