Bevor Sie die Integration mit Ihrem Live-Konto verwenden, empfehlen wir, sie zunächst in einem Demokonto zu testen. Wenn Sie das tun möchten, fragen Sie Ihren Ansprechpartner bei Factorial nach den nächsten Schritten.
Um dies zu tun, müssen Sie zunächst die Integration in Ihrer Silae-Demoumgebung einrichten und die Tests durchführen. Sobald die Integration bestätigt wurde, dass sie korrekt funktioniert, wird sie in Ihrem Live-Konto implementiert.
Schritt für Schritt
1. Überprüfen Sie die Datenkonsistenz zwischen Factorial und Silae
Überprüfen Sie, ob die Daten von Factorial und Silae konsistent sind, bevor Sie den Connector aktivieren.
2. Installieren Sie die Integration von Silae im Factorial Marketplace
Gehen Sie in Ihrer Seitenleiste zu Entdecken → Integration → Silae API Connector → Klicken Sie auf "Installieren."

.png)
.png)
3. Vervollständigen Sie die Einstellungen basierend auf den Informationen, die Ihr Buchhalter von Silae geteilt hat:
Die Dateicodes (zum rechtlichen Einheit)
.png)
Die Betriebscodes (zum Arbeitsplätzen)
.png)
Die Abwesenheitscodes, die der Benutzer synchronisieren möchte

Die EVP-Codes, die der Benutzer synchronisieren möchte

Die Zählercodes, die der Benutzer in Factorial anpassen möchte
cpnAcquis oder rttAcquis
Sobald Sie die Bestätigung von Ihrem Ansprechpartner bei Factorial erhalten, ist die Integration bereit zur Nutzung.
Hier müssen Sie den Code über die Einstellungen vervollständigen:
.png)
Die Ordnernummern und Betriebscodes sind obligatorisch, damit die Integration funktioniert.
4. Geben Sie die erforderlichen Silae- und Factorial-Informationen an
Um die beiden Plattformen zu verknüpfen, benötigen Sie zwei spezifische Schlüssel. Bitte beziehen Sie sich auf unseren technischen Dokumentationslink , um diese zu finden:
- 3 Silae API-Schlüssel
- 1 Factorial API-Schlüssel
Sobald Sie Ihre Schlüssel haben, müssen Sie unser sicheres Aktivierungsformular ausfüllen:
Wichtige Details zum Formular:
- Pflichtfelder: Alle Felder müssen ausgefüllt werden, um Integrationsfehler zu vermeiden.
- Validierung: Sie werden aufgefordert, zu bestätigen, dass alle technischen Voraussetzungen erfüllt sind.
- Fehlerbehandlung: Wenn die bereitgestellten Informationen falsch sind, werden Sie aufgefordert, sie erneut einzureichen oder support@fortifydigital.zendesk.com zu kontaktieren.
Datensicherheit & Datenschutz
Wir nehmen Ihre Datensicherheit ernst. Sobald Sie das Formular einreichen:
- Ihre Schlüssel werden automatisch in einen vollständig gesicherten Container verschoben.
- Alle sensiblen Daten werden sofort aus dem temporären Speicher (SharePoint) gelöscht.
- Fortify konfiguriert dann die Schnittstelle sicher in Ihrem Namen.
Sobald die Konfiguration abgeschlossen ist, wird eine automatisierte Benachrichtigung an folgende Personen gesendet:
- Sie (der Kunde)
- Ihr Lohnbuchhalter
5. Die Integration ist bereit zur Nutzung!
Sobald Sie die Bestätigung von Ihrem Ansprechpartner bei Factorial erhalten, ist die Integration bereit zur Nutzung!
6. Wechsel von Test zu Produktion auf Silae: So migrieren Sie Ihre Umgebung (sofern noch nicht geschehen)
Haben Sie Ihre API-Tests abgeschlossen und funktioniert alles einwandfrei? Herzlichen Glückwunsch! Es ist jetzt an der Zeit, in Ihre Produktionsumgebung zu wechseln.
Hier sind die wichtigsten Schritte und goldenen Regeln für einen erfolgreichen Übergang ohne Unterbrechung des Dienstes.
Fall Nr. 1: Sie behalten die gleiche Konfiguration (Einfache Aktualisierung)
Wenn Sie einfach Ihre Testdateien durch Ihre echten Dateien ersetzen möchten, ohne Ihre API-Anmeldeinformationen zu ändern.
- Die Aktion: Bereinigen Sie die Liste der Dateien für die Produktionsintegration.
- Das Verfahren:
- Gehen Sie zu Silae.
- Gehen Sie zu Lohnabrechnungseinstellungen (Paramétrage Paie).
- Greifen Sie auf die Testkontoeinstellungen zu.
- Klicken Sie auf die "moulinette" (Dateiliste-Konfiguration).
- Entfernen/Löschen Sie die Testdateien.
- Fügen Sie die neuen Produktionsdateien hinzu.
- Technische Auswirkungen: Die Client-ID, das Client-Geheimnis und der Subkey bleiben gleich. Es sind keine Änderungen an Ihrem Code oder Ihren Verbindungseinstellungen erforderlich.
- Wer macht es? Der Integrator oder der Silae-Partner.
Fall Nr. 2: Erstellen einer neuen Konfiguration
Einige Partner ziehen es vor, ihre Flüsse zu "trennen": eine dedizierte Testkonfiguration für alle ihre Kunden und eine separate Konfiguration für die Produktion.
- Technische Auswirkungen: In diesem Szenario werden alle Schlüssel unterschiedlich sein und müssen über das Formular an Fortify übermittelt werden.
- Warnung: Ein Subkey ist mit Ihrem Abonnement und Ihren Anmeldeinformationen (Client-ID / Client-Geheimnis) verknüpft. Der Subkey Ihrer Testkonfiguration ist nicht mehr gültig.
- Regel für Externe: Wenn Sie mehrere Kunden verwalten, können die Client-ID und das Geheimnis identisch sein, aber jede Gruppe von Dateien muss ihren eigenen dedizierten Subkey haben.
Wie beantragt man eine Änderung?
Das Verfahren hängt von Ihrem Profil ab:
- Sie sind Partner/Integrator: Sie haben die Möglichkeit, die Dateien in den Lohnabrechnungseinstellungen wie im Fall Nr. 1 angegeben zu ändern.
- Sie sind Silae-Benutzer: Sie müssen das offizielle Anfrageformular für jede Ergänzung oder Änderung einer API-Konfiguration ausfüllen.
Die 2 Goldenen Regeln
Der Wechsel zur Produktion erfordert eine enge Kommunikation mit Ihren technischen Partnern, um zu verhindern, dass der Connector blockiert wird.
- Informieren Sie Fortify über jede Schlüsseländerung. Sobald Sie Schlüssel regenerieren oder neue Verbindungsinformationen erhalten (geänderter Subkey usw.), ist es wichtig, Fortify sofort zu informieren → support@fortifydigital.zendesk.com
- Erklären Sie Ihre neuen Dateinummern. Wenn Sie eine neue Dateinummer zu Ihrer Silae-Konfiguration hinzufügen, informieren Sie Fortify. Sie müssen diese Nummern unbedingt zum Connector hinzufügen, damit die Daten korrekt zurückfließen.
Welche Daten werden synchronisiert?
Allgemeiner Prozess zum Senden von Daten an Silae
Daten werden von Factorial an Silae über unseren "Mitarbeiter-Lohnabrechnungs-Updates" Bereich übertragen. Jede Aktion, die Sie in Factorial durchführen, die die Lohnabrechnung betrifft, generiert ein Mitarbeiter-Update.
Um sicherzustellen, dass die richtigen Updates synchronisiert werden, ist es wichtig, die relevanten Mitarbeiter-Updates in Factorial zu aktivieren. Diese können Neueinstellungen, Vertragsänderungen, Aktualisierungen persönlicher Daten und Abwesenheiten umfassen. Gehen Sie dazu zu Einstellungen > Lohnabrechnung > Mitarbeiter-Updates und aktivieren Sie alle Updates, die Sie mit Silae synchronisieren möchten.

Wenn ein Mitarbeiter-Update generiert wird, können Sie es überprüfen und es an Silae senden, indem Sie das Mitarbeiter-Update als "Abgeschlossen" markieren. Die Übertragungszeiten können je nach Zeitraum variieren. Wenn beispielsweise am Ende des Monats eine große Anzahl von Vorgängen während des Lohnabschlusses gesendet wird, kann die Verarbeitung bis zu 5–10 Minuten in Anspruch nehmen.

Sie können in Factorial nicht sehen, ob die Daten erfolgreich an Silae gesendet wurden. Um dies zu überprüfen, müssen Sie den Mitarbeiterdatensatz in Silae überprüfen oder die tägliche E-Mail einsehen, die die gesendeten Daten zusammenfasst und eventuelle Fehler identifiziert.
Synchronisation neuer Einstellungen
Wenn ein neuer Mitarbeiter in Factorial erstellt wird, wird ein Mitarbeiter-Update erstellt. Sie können es öffnen und überprüfen, ob alle Daten korrekt sind, und es dann als "Abgeschlossen" markieren, um die Änderung mit Silae zu synchronisieren.
Sozialversicherungsnummer (oder E-Mail Adresse für ausländische Arbeiter ohne Nummer), Vorname, Nachname, Vertragsart und Eintrittsdatum sind Pflichtfelder. Wenn diese fehlen, wird der neue Mitarbeiter in Silae nicht erstellt.
Weitere wichtige Dinge zu beachten:
- Beim Erstellen des Mitarbeiters und Laden der Vertragsinformationen, stellen Sie sicher, dass das Vertragsdatum (Eintritt ins Unternehmen) und das Beschäftigungsdatum (letzte Vertragsaktualisierung) in SILAE gleich sind. Andernfalls erstellt Silae einen neuen Vertrag, was zu Duplikationen führt.
- Für Mitarbeiter ohne Sozialversicherungsnummer: Der Datensatz wird trotzdem erstellt, aber die Validierung basiert auf der E-Mail-Adresse anstelle der Sozialversicherungsnummer. Daher wird die E-Mail-Adresse zu einem Pflichtfeld; andernfalls kann das Mitarbeiterprofil nicht in Silae erstellt werden.
- Das Geburtsdatum und das Geschlecht, das angegeben wird, müssen mit der Sozialversicherungsnummer übereinstimmen.
- Der Geburtsname ist obligatorisch. Wenn er leer gelassen wird, wird der verwendete Nachname als Geburtsname behandelt, um eine Blockierung der Erstellung zu vermeiden.
- Die Matricule muss nicht in Factorial hinzugefügt werden. Wenn die Neueinstellung synchronisiert wird, fügen wir automatisch das Matricule-Feld in Factorial hinzu. Sie können in Silae eine Option aktivieren, um die Einzigartigkeit der Personalnummer über mehrere Dateien oder Dateigruppen hinweg sicherzustellen, falls erforderlich.
- Der Grund für den Beschäftigungsbeginn wird standardmäßig als Code 001 gesendet: Einstellung, Beginn der Tätigkeit, direkte Rekrutierung oder Rekrutierung über Wettbewerb (öffentlicher Dienst), Beginn der Abordnung, Beginn des kulturellen Lebens (Religionen). Sie können dies in Silae bei Bedarf ändern.
.png)
Der neue Mitarbeiter wird in Silae mit einem Mitarbeiterschlüssel hinzugefügt, der sequentiell dem höchsten vorhandenen Schlüssel im Silae-Konto des Kunden folgt.
Felder, die an Silae gesendet werden
-
Mitarbeiterdaten
- Vorname
- Nachname
- Sozialversicherungsnummer (der Kunde muss die Sozialversicherungsnummer im Feld zur Identifikationsnummer auswählen)
- Geburtsname (wenn in Factorial leer gelassen, wird der Vorname hier ebenfalls synchronisiert)
- Geschlecht
- Professionelle E-Mail
- Persönliche E-Mail (wenn in Factorial leer gelassen, wird die persönliche E-Mail durch die professionelle E-Mail ersetzt)
- Handynummer
- Wohnadresse (Stadt, Land, Bundesland, Straße, Nummer und Postleitzahl)
- INSEE-Gemeindecode
- Geburtsdatum
- Geburtsdepartement (wird aus der SSN entnommen; wenn es außerhalb von Frankreich liegt, wird es als Code "99" gesendet und der Benutzer muss es manuell in Silae bearbeiten)
- Geburtslandcode (wird aus der SSN entnommen)
- Nationalität
- IBAN
- BIC
-
Vertragsdaten
- Eintrittsdatum (basierend auf dem Startdatum-Feld des Vertrags von Factorial)
- Vertragsbeginn (basierend auf dem Gültigkeitsdatum des Vertrags von Factorial)
- Vertragsversion Beginn (basierend auf dem Gültigkeitsdatum des Vertrags von Factorial)
- Enddatum
- Startgrund (standardmäßig synchronisierter Grund: 001)
- Betrieb
- Berufsbezeichnung - unter „anderer Berufsbezeichnung”
- Vertragscode (muss ein Vertragsart sein, die standardmäßig in Factorial verfügbar ist)
- Grundgehalt (muss auf monatlicher oder jährlicher Basis angegeben werden)
- Für Stundenmitarbeiter → Arbeitsstunden im Vertrag (muss auf monatlicher oder wöchentlicher Basis angegeben werden). Es werden die Felder „Normale monatliche Stunden“ und „Überstunden monatliche Stunden“ in Silae ausgefüllt)
- Für Mitarbeiter mit einem tagesbasierten Vertrag → Anzahl der Tage
Synchronisation von Mitarbeiter- & Vertragsdatenänderungen
Wenn das Profil oder die Vertragsdaten eines Mitarbeiters in Factorial aktualisiert werden, wird ein Mitarbeiterupdate erstellt. Sie können es öffnen und überprüfen, ob alle Daten korrekt sind, und es dann als "Abgeschlossen" markieren, um die Änderung mit Silae zu synchronisieren.
Die folgenden Felder generieren ein Mitarbeiterupdate, das mit Silae synchronisiert werden kann:
- Mitarbeiterdaten
- Nachname
- Vorname
- Berufliche E-Mail
- Handynummer
- Wohnadresse (Stadt, Land, Bundesland, Straße, Nummer und Postleitzahl)
- Nationalität (nur der Code wird geändert, der Text muss manuell in Silae geändert werden)
- IBAN
- BIC
- Vertragsdaten
- Beginn des Arbeitsverhältnisses
- Beginn des Vertrags
- Eintrittsdatum
- Enddatum
- Einrichtung
- Berufsbezeichnung (unter "andere Berufsbezeichnung")
- Code des Arbeitsvertrags (muss ein Vertragstyp sein, der standardmäßig in Factorial verfügbar ist)
- Grundgehalt (muss das Monatsgehalt oder das Jahresgehalt sein)
- Für stundenweise Beschäftigte:
- Vertragliche Stunden - monatliche oder wöchentliche Stunden müssen eingegeben werden (diese füllen die Felder “Normale monatliche Stunden” und “Überstunden monatliche Stunden” in Silae aus)
- Für Mitarbeiter mit einem tagebasierten Vertrag:
- Anzahl der Tage
Wichtig:
- Wenn Sie Vertragsänderungen für einen bestehenden Mitarbeiter in Ihrem Unternehmen senden möchten, stellen Sie sicher, dass Sie die Vertragsbeginn- und Arbeitsbeginn-Daten in Factorial und Silae sorgfältig überprüfen, um zu vermeiden, dass versehentlich ein neuer Mitarbeiterdatensatz in Silae erstellt wird.
- API-Aktionen bezüglich Verträgen müssen strikt in der Gegenwart oder Zukunft festgelegt werden. Kein vorheriges Vertragsdatum sollte gesendet werden.
Andernfalls wird die Synchronisation gestört und es wird ein "weißer Bubble" (nicht berechneter/Fehlerstatus) auf den Lohnabrechnungen des Mitarbeiters ausgelöst.
Wenn dies geschieht, folgen Sie dem genauen Lösungsprozess unten:
-
Identifikation
- Lokalisieren Sie die rote Bubble im letzten Monat, der grüne Bubbles anzeigt.
- 🛑 KRIITISCHE WARNUNG: Versuchen Sie niemals, eine Abrechnung zu berechnen, die eine rote Bubble zeigt.
- Aktionsplan
Sie müssen die fehlerhaften Verträge löschen, um das System wiederherzustellen. Folgen Sie diesem spezifischen Workaround:
- Die Regel: Ein Vertrag kann nur gelöscht werden, wenn er chronologisch der letzte in der Historie ist.
- Der Workaround: Wenn der Vertrag, den Sie löschen müssen, "hinter" einem anderen blockiert ist, ändern Sie vorübergehend das Datum von Vertrag #1, um es später als Vertrag #2 zu machen.
- Die Löschung: Dieser Trick schiebt Vertrag #1 in die letzte Position und entsperrt ihn, sodass Sie ihn erfolgreich löschen können.
Wie man einen Nachtrag erstellt oder einfach einen Vertrag ändert
- Erstellen Sie einen Nachtrag: Wenn eine Vertragsänderung erfolgt, und Sie möchten einen neuen Job in Silae erstellen, gehen Sie zum Vertrag-Tab im Profil Ihres Mitarbeiters in Factorial, klicken Sie auf Neue Bedingungen und geben Sie das Datum der Änderung ein.
- Ändern Sie einen Vertrag: Wenn Sie eine Änderung ohne einen neuen Job in Silae vornehmen möchten, klicken Sie auf die drei Punkte und wählen Sie Bedingungen korrigieren.
Stellen Sie sicher, dass das wirksame Datum mit dem Datum des Jobs in Silae übereinstimmt. Wenn nicht, wird automatisch ein neuer Job in Silae erstellt:

Verwaltung von Vertragsbeendigungen, Verlängerungen und Nachfolgen
Was ist der korrekte Workflow in Factorial ?
Wenn der Mitarbeiter das Unternehmen verlässt:
- Schließen Sie das Profil des Mitarbeiters in Factorial, geben Sie das Enddatum und den Grund dafür ein; der Vertragkündigungseintrag erscheint im Abschnitt "Updates" des Lohnmoduls.
Der Standardcode für die Vertragskündigung wird automatisch auf 008 in Silae gesetzt. Wenn Sie ihn ändern müssen, müssen Sie dies manuell in Silae tun.
Wenn der Mitarbeiter ins Unternehmen zurückkehrt:
- Reaktivieren Sie dasselbe Profil, um die neue Bedingung zu erstellen.
.png)
Systemverhalten gemäß den verschiedenen Szenarien zur Erstellung von Mitarbeitern zwischen Factorial und Silae:
| Fall | Was passiert | Ergebnis in Silae | Beschäftigungsgrund |
|---|---|---|---|
| 1. Erstellung eines neuen Mitarbeiters in Factorial (normaler Fall) | Der Mitarbeiter existiert überhaupt nicht in Silae | Mitarbeiterdatensatz mit Vertragsdaten erstellt | 001 – neuer Vertrag |
| 2. Erneutes Senden von Informationen aus Factorial nach einem Datenfehler bei der Erstellung des Mitarbeiterprofils | Der Mitarbeiter existiert noch nicht in Silae, wir senden die Informationen erneut | Als Neueinstellung behandelt | 001 – neuer Vertrag |
| 3. Senden eines Vertragsvorfalls, der Mitarbeiter existiert bereits in Silae, aber ohne Vertrag | Silae hat den Mitarbeiter, aber keinen Vertrag | Als Neueinstellung behandelt | 001 – neuer Vertrag |
| 4. Senden eines Vorfalls für eine Vertragsänderung, der Mitarbeiter existiert mit einem ähnlichen Vertragsbeginn in Silae und Factorial | Die Daten sind konsistent | Einfache Vertragsaktualisierung | Keine Änderung |
| 5. Senden eines Vorfalls für eine Vertragsänderung, der Mitarbeiter existiert, aber das Vertragsbeginn-Datum unterscheidet sich zwischen Factorial und Silae | Daten stimmen nicht überein → Konflikt | Erstellung eines neuen Jobs in Silae | 901 – Änderung der Situation |
| 6. Senden mit einer Mitarbeiter-ID, während der Mitarbeiter nicht existiert | Die Mitarbeiter-ID ist in Silae unbekannt | Synchronisation schlägt fehl | Keine Änderung |
Synchronisation von Abwesenheiten
Wenn eine Abwesenheit eines Mitarbeiters in Factorial genehmigt wird, wird ein Lohnabrechnungsmitarbeiterupdate erstellt. Sie können überprüfen, ob alle Daten korrekt sind, und dann den Vorfall als “Abgeschlossen” markieren, um die Daten mit Silae zu synchronisieren.

Überprüfen Sie, ob die Abwesenheiten, die Sie senden möchten, auf der Seite der Mitarbeitereinstellungen aktiviert sind und den Silae-Code auf der Seite der Integrations Einstellungen zugeordnet haben (nur mit dem 3-stelligen Code, ohne den ‘AB-’ einzuschließen)
Art der Abwesenheiten, die synchronisiert werden können
Halbtägige, ganztägige und stundenweise Abwesenheiten können synchronisiert werden. Abwesenheiten, die komplexe Regeln beinhalten (wie Wartezeiten, Sozialversicherungszulagen, Arbeitgeberzuschüsse oder Schwellenwerte) werden von Factorial gesendet, aber in Silae berechnet, das in diesem Fall als Hauptsystem fungiert. Silae bestimmt sowohl die vergütete Dauer als auch die zu zahlenden Beträge.
Andere Abwesenheiten, die im Allgemeinen einfacher sind, werden direkt in Factorial verwaltet, das als Hauptsystem fungiert — keine weitere Verarbeitung ist auf der Seite von Silae erforderlich.
- Bezahlter Urlaub und RTT müssen immer in Tagen oder Halbtagen gesendet werden.
- Krankheitstage werden von Silae berechnet. Wenn sie in Tagen gesendet werden, erfolgt die Verarbeitung automatisch.
- Stundenweise Abwesenheiten müssen ihre Zähler korrekt in Stunden konfiguriert haben (z. B. Schulungen, Umwandlungsurlaub, Feiertage, Ausgleichsurlaub, bezahlter/unbezahlter Urlaub).
Wenn mehrere Tage stundenweiser Abwesenheiten gesendet werden, werden die gesamtstunden möglicherweise nicht sofort angezeigt, aber die Berechnung wird genau auf der Lohnabrechnung reflektiert.
Ändern & Löschen einer synchronisierten Abwesenheit
Wenn Sie eine Abwesenheit für einen Ihrer Mitarbeiter von Factorial an Silae gesendet haben und Ihr Mitarbeiter in der Zwischenzeit diese Abwesenheit aus seinem Profil gelöscht hat, wird der Abwesenheitsvorfall mit der Nachricht: “Die Abwesenheit wurde gelöscht” wieder geöffnet. Durch das Markieren dieses Vorfalls als abgeschlossen wird die Löschung an Silae gesendet:
.png)
Übertragung von Lohnbestandteilen
Allgemeiner Workflow
Schritt 1 – Identifizieren Sie die EVP-Codes in Silae
Variable Lohnbestandteile werden jeden Monat von Factorial zur Integration in Silae übertragen. Jeder EVP in Silae entspricht einem spezifischen Kunden-Code. Sie finden sie unter Einstellungen > Eingabewerte. Die zu verwendenden EVP-Codes sind in der **„Name“**-Spalte aufgeführt:
.png)
Stellen Sie sicher, dass alle Ihre EVPs in diesem Menü aufgeführt sind, mit Ausnahme der nativen Stunden*.
Dieses Menü ermöglicht uns auch, eine zusätzliche Überprüfung durchzuführen, um zu überprüfen, ob der EVP-Code, der von Factorial gesendet wird, in Silae existiert.
Schritt 2 – Konfigurieren Sie die EVP-Codes in Factorial
In Factorial werden diese EVPs an derselben Stelle wie Abwesenheitscodes, Mitarbeiterdateinummern und Einrichtungscodes unter den Feldern „zusätzliche Vergütung” eingegeben:
.png)
Schritt 3 – Senden Sie die EVP von Factorial an Silae
Die EVPs werden in Factorial eingegeben und manuell (durch einen Klick auf eine Schaltfläche) über die API gesendet:
.png)
Voraussetzungen für die EVP-Übertragung
Damit die Synchronisation funktioniert, müssen die folgenden Voraussetzungen erfüllt sein:
- Mitarbeiter-ID im Profil des Mitarbeiters
- Dateinummer (kodiert für die juristische Person im Factorial-Marktplatz)
- Betrag, der im Vergütungsmodul eingegeben wurde
- EVP-Code im Factorial-Marktplatz
Schritt 4 – Überprüfen Sie den Integrationsstatus in Factorial
Nachdem die Daten verarbeitet wurden, wird der Integrationsstatus in Factorial zurückgegeben:
Die Antwort muss die ID und den Verarbeitungsstatus enthalten, der eine der folgenden drei Optionen sein kann:
- erfolgreich – wenn die VPE erfolgreich mit Silae synchronisiert wurde
- fehlgeschlagen – wenn ein technischer Fehler die Synchronisation verhinderte
- ungültig – wenn die gesendeten Daten falsch oder unvollständig sind
| Silae-Fehlerfall | Fehlermeldung gesehen | Status zurückgeben | Erklärung |
|---|---|---|---|
| Ungültiges Datenformat | Unerwartetes Zeichen beim Parsen des Wertes | ungültig – FalschesFormat | Die eingegebenen Daten sind falsch. Bitte überprüfen Sie das Format. |
| Leerer EVP-Wert | Fehler beim Konvertieren des Wertes {null} | ungültig – LeererCode | Der EVP-Wert darf nicht leer sein. |
| Fehlende oder falsche Mitarbeiter-ID | Kein Mitarbeiter stimmt mit der ID überein | ungültig – FehlendeID | Die Mitarbeiter-ID für die Lohnabrechnung fehlt oder ist falsch. |
| Falsche Dateinummer | Der Wert in der Dateiliste ist null oder leer | fehlgeschlagen – FalscheDatei | Die Silae-Dateinummer ist falsch. |
| VPE-Zeitraum zu alt | Der VPE-Zeitraum ist älter als der aktuelle Zeitraum in der Datei | ungültig – FalscherZeitraum | Der VPE stimmt nicht mit dem aktuellen Zeitraum in Silae überein. |
| Ungültiger Unterkey | SubscriptionKeyInvalid, Zugriff verweigert | fehlgeschlagen – FalscherUnterkey | Der Silae-Subscription-Key ist ungültig. |
| Ungültiges Client-Geheimnis oder Client-ID | "error": "invalid_client" | fehlgeschlagen – FalscheAPIKey | Das Silae-Client-Geheimnis oder die Client-ID ist ungültig. |
| Ungültiger VPE-Code | N/A (mit Silae-Tabelle vergleichen) | ungültig – FalscherEVPCode | Der VPE-Code existiert nicht in Silae. Bitte korrigieren Sie ihn. |
Zusätzliche Details zu spezifischen Variablenarten
*Die nativen Stunden
Für Stunden müssen Sie sie nicht im Menü „Eingabewerte” eingeben.
Sie müssen nur die entsprechenden Silae-Stunden-Codes in Factorial korrekt zuweisen, je nach den in Ihrer Lohnabrechnung verwendeten Kategorien.
1. Native Stunden (Standard-Silae-Codes)
Diese Stunden verwenden vordefinierte Silae-Codes:
- HN = reguläre Stunden
- HM = Stunden mit erhöhtem Satz
- HC = ergänzende Stunden
- HCNSTEPA = ergänzende Stunden, die nicht der TEPA unterliegen
- HS25 = Überstunden mit 25%
- HS50 = Überstunden mit 50%
- HS100 = Überstunden mit 100%
2. Stunden mit benutzerdefinierten Silae-Codes
Die folgenden Codes entsprechen Stunden, die auf benutzerdefinierten Silae-Konfigurationen basieren.
Wenn Ihre Einrichtung eine dieser Stunden verwendet, stellen Sie sicher, dass Sie den genauen Code in Factorial reproduzieren:
| Code | Code | Code | Code |
|---|---|---|---|
| PHNE | PHNE.1 | HROUTE | HEROUTE |
| HMOD1 | HREG1 | PHNE25 | PHNE25.1 |
| PHNE50 | PHNE50.1 | PHE | HAC15 |
| HAC | HAC12 | HAC10 | HAC25 |
| HAC05 | HAC20 | HAC10R | HAC07 |
| HAC17 | HAC06 | HC-HT | HC-AS |
| HC05 | HC05-HT | HC25 | HC25-HT |
| HC15 | HC15-HT | HC10 | HC10-HT |
| HC11 | HC10-AS | HC25-AS | HC50-HT |
| HC12 | HC20 | HC20-HT | HC30 |
| HC30-HT | HC20-AS | HC17 | HC11-HT |
| HC12-HT | HC17-HT | HC50 | HC50-AS |
| HC100 | HC100-HT | HE | HE25 |
| H500 | H500RR | H500-HT | H500DP |
| H500DP-HT | H500-AS | H510 | H510R |
| H510RR | H510-HT | H512 | H510RX |
| H515 | H515RR | H515-HT | H515RX |
| H520 | H520R | H520RR | H520-HT |
| H520RX | H525 | H525RR | H525-HT |
| H530 | H530R | H530RR | H525-AS |
| H525R-HT | H525DP-HT | H525DP | H525R2 |
| H520-AS | H525R2-HT | H530-HT | H525RX |
| H530RX | H533RX | H533 | H533R |
| H533RR | H533-HT | H535 | H550 |
| H550R | H550RR | H550-HT | H550-AS |
| H550R2 | H550R2-HT | H550RX | H550DP |
| H550DP-HT | H550-D | H575 | HS100 |
Wenn Sie zusätzliche benutzerdefinierte Codes haben, die nicht in dieser Liste enthalten sind, senden Sie bitte eine Anfrage an:
3. Ein EVP, das als reguläre Stunden getarnt ist
Hier sind einige Beispiele - Dies sind Lohnvariablen (oft mit Prämien- oder Zulagenprofilen verknüpft), für die es wichtig ist, den Code im spezifischen Silae-Menü “einzugeben” anzugeben:
- Feiertagsstunden : die Anzahl der Stunden dient als Multiplikator für eine Prämie oder Erhöhung.
- Bereitschaftsstunden: Ob als Pauschale oder Stundenlohn bezahlt, benötigt Silae einen variablen Vergütungscode (oft die Anzahl der Bereitschaftsstunden), um die Zulage auszulösen.
- Nachtarbeitsstunden: Das Volumen der übertragenen Stunden dient ausschließlich als Auslöser für das Nachtarbeitsprämienzahlungselement.
Versand einer Vorauszahlung
Wenn Sie eine Vorauszahlung senden müssen, müssen Sie den Code “acompte” in den Factorial-Integrationsdaten verwenden, damit wir diesen Typ von VPE ordnungsgemäß identifizieren können.
Es gibt keinen spezifischen entsprechenden Code in Silae für Vorauszahlungen.
Wie können angesammelte Urlaubsansprüche von SILAE in Factorial abgerufen werden?
Die Integration ruft die angesammelten Urlaubstage von Silae zu Factorial gemäß Ihren Bedürfnissen ab und spiegelt den angesammelten Urlaub wider. Die Zähler werden über die KLYR-Plattform zu Beginn des folgenden Monats aktualisiert, sobald Ihre Gehaltsabrechnungen validiert wurden. Nach diesem Update werden die Zähler für bezahlten Urlaub (CP) und RTT automatisch synchronisiert. Für CP umfasst dies sowohl die Tage, die im Vorjahr (N‑1) bereits angesammelt wurden, als auch die Tage, die derzeit für das laufende Jahr (N) angesammelt werden.
Für die Synchronisation des Urlaubsanspruchs müssen die Mitarbeiter-IDs von Silae in Factorial vorhanden und identisch sein.
Wie ruft man die angesammelten Urlaubszähler von SILAE zu Factorial ab?
- Bevor Sie die Zähler aktivieren, müssen Sie die Basis für die kumulierten Tage in Ihren Urlaubsrichtlinien auf 0 setzen, um die automatische Berechnung der Ansammlung durch Factorial zu deaktivieren. Gehen Sie zu Einstellungen > Urlaub und Abwesenheit > Ihre Urlaubsrichtlinie > Zähler → setzen Sie die Basis für kumulierte Tage auf 0.
.png)
WARNUNG: Wenn Sie die bereits in Ihren vorherigen Zählern angesammelten Tage beibehalten und nur die beiden Zähler, die mit dem vorherigen Zyklus (Cpn‑1) und dem aktuellen Zyklus (Cpn) verbunden sind, zurücksetzen möchten, wenden Sie sich bitte an Ihren Account-Manager. Er wird dies für Sie einrichten.
- Geben Sie den Zählercode in Factorial unter Entdecken > Integration ein. Jede Zeile entspricht einem anderen Zähler, der mit einer Urlaubsrichtlinie verknüpft ist.
.png)
- Achten Sie in den Einstellungen von Factorial darauf, dass keine Übertragung von ungenutzten Tagen aus dem Vorjahr zulässig ist, da die Berechnung der angesammelten Urlaubstage von Silae die übertragenen Tage umfasst.
- Sobald die Zähler aktiviert und die Zählercodes vervollständigt sind, werden die angesammelten und derzeit angesammelten Zähler in Factorial durch Ihre Aktionen auf KLYR angepasst.
Was ist KLYR und wie funktioniert es?
KLYR ist die Plattform, die verwendet wird, um Ihre Urlaubszähler von Silae zu Factorial zu synchronisieren. So funktioniert es:
-
Am Ende jedes Monats, nachdem Ihre Gehaltsabrechnungen validiert wurden, müssen Sie auswählen:
- Den Namen Ihres Unternehmens
- Die Gehaltsordner (Einheiten), die Sie synchronisieren möchten
-
Wählen Sie den richtigen Monat:
- Wählen Sie den vorherigen Monat, wenn Sie diese Aktion zu Beginn des folgenden Monats durchführen.
- Wählen Sie den aktuellen Monat, wenn Sie Ihre Gehaltsabrechnungen vor Ende des Monats validiert haben.
-
Zugang zu KLYR:
- Um jemandem Zugang zu KLYR zu gewähren, senden Sie die E-Mail-Adressen der Personen, die Zugang benötigen an die folgende Adresse: support@fortifydigital.zendesk.com

Sobald die Anpassung vorgenommen wurde, sieht der Benutzer eine Notiz im Factorial-Zähler mit dem Hinweis „Automatisch aktualisiert von Silae + ein Code.“ Der Mitarbeiter erhält jedoch keine Benachrichtigung.
Wenn Sie den Zähler in Factorial nicht anpassen möchten, können Sie einfach den Code auf der Seite der Integrationseinstellungen leer lassen.
Wenn Silae erst mit der Berechnung der Gehaltsabrechnungen begonnen hat, ist es normal, dass die Zähler noch nicht aktualisiert wurden. Die monatlichen Zähler werden nur berücksichtigt, wenn alle Gehaltsabrechnungen validiert und gedruckt wurden.
Wenn beispielsweise Gehaltsabrechnungen berechnet, aber noch nicht überprüft oder gedruckt wurden, bleibt die Blase oben gelb. Sobald die Blase grün wird, werden die Informationen korrekt aktualisiert.
Liste der Zähler und ihrer zugehörigen Codes in Silae:
| Code | Beschreibung |
|---|---|
| cpnAcquis | Anzahl der Tage, die im Vorjahr (N-1) erworben wurden, und Anzahl der Tage, die derzeit für dieses Jahr (N) erworben werden |
| rttAcquis | Anzahl der erworbenen RTT |
Häufig gestellte Fragen
Wie können Sie bestätigen, ob die Daten erfolgreich mit Silae synchronisiert wurden oder ob ein Fehler aufgetreten ist?
Wenn ein Synchronisierungsfehler auftritt, wird ein Fehlerbericht per E-Mail an den Kunden gesendet. Der Kunde muss die E-Mail-Adresse angeben, an die der Bericht gesendet werden soll.
Diese Berichte bieten eine detaillierte Zusammenfassung aller an Silae gesendeten Daten sowie den Status ihrer Aktualisierung, sodass der Benutzer:
- Überprüfen kann, dass alle Daten korrekt übertragen wurden.
- Probleme mit Daten, die nicht erfolgreich übertragen wurden, identifizieren und lösen kann.
Hier ist ein Beispiel für einen Fehlerbericht:
.png)
Was passiert, wenn ein neuer Mitarbeiter mit einer bestimmten Matrikel synchronisiert wird, die nicht in Silae existiert?
Der neue Mitarbeiter wird NICHT synchronisiert (es wird ein Fehler angezeigt).
Was passiert, wenn ein neuer Mitarbeiter mit einer bestimmten Matrikel synchronisiert wird, die bereits in Silae existiert?
Die Daten des neuen Mitarbeiters in Factorial überschreiben die Daten des bestehenden Mitarbeiters in Silae.
Ist die Integration bidirektional?
Die meisten Daten werden von Factorial nach Silae synchronisiert. Es gibt jedoch 2 spezifische Datenpunkte, die von Silae nach Factorial synchronisiert werden:
- Matrikel - wird an Factorial synchronisiert, sobald der Mitarbeiter in Silae erstellt wird
- Urlaubsanspruchszähler - werden automatisch in Factorial 5 Tage nach der Berechnung der Gehaltsabrechnung in Silae angepasst
Was passiert, wenn ein neuer Mitarbeiter keine Sozialversicherungsnummer hat?
Damit ein Mitarbeiter in Silae erstellt werden kann, muss die Sozialversicherungsnummer (SSN) ausgefüllt werden. Wenn ein Mitarbeiter diese nicht hat, muss der Mitarbeiter sowohl in Silae als auch in Factorial manuell erstellt werden. Sobald die temporäre SSN in Silae zugewiesen ist, müssen Sie sie in Factorial kopieren und einfügen.
Was sind die häufigsten Fehler?
- Geburtsdaten und Sozialversicherungsnummer sind nicht kohärent
- Codes sind auf der Seite des Factorial Marktplatzes nicht ausgefüllt.
- Kein API-Zugang für einige Kundendossiers.
Brauchen Sie Hilfe?
Für jegliche Unterstützung oder Hilfe bei einem Fehler im Zusammenhang mit Factorial: Bitte greifen Sie hier auf das Support-Portal zu: Factorial Kunden-Support .
Wenn alles in Factorial funktioniert, Sie jedoch die Daten nicht korrekt in Silae erhalten, senden Sie bitte ein Ticket, indem Sie eine E-Mail an support@fortifydigital.zendesk.com senden.
Wenn es sich um ein Problem oder eine Änderung bezüglich API-Schlüssel handelt: Bitte füllen Sie dieses Formular aus: Ausfüllen | Erstellung API FACTORIAL - SILAE .
Vergessen Sie nicht, payroll-consultant@factorial.co in CC zu setzen, um sicherzustellen, dass Ihre Anfrage von unseren Teams verfolgt wird.