Bevor Sie die Integration mit Ihrem Live-Konto verwenden, empfehlen wir, sie zuerst in einem Demokonto zu testen. Wenn Sie das tun möchten, fragen Sie Ihre Kontaktperson bei Factorial nach den nächsten Schritten.
Um dies zu tun, müssen Sie zunächst die Integration in Ihrer Silae-Demo-Umgebung 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, dass die Daten von Factorial und Silae konsistent sind, bevor Sie den Connector aktivieren.
2. Installieren Sie die Silae-Integration 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 Datei-Codes (entsprechend der Rechtseinheit)
.png)
Die Establishment-Codes (entsprechend den 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 Ihrer Kontaktperson bei Factorial erhalten, ist die Integration bereit zur Nutzung.
Hier müssen Sie den Code über die Einstellungen vervollständigen:
.png)
Die Ordnernummern und Establishment-Codes sind erforderlich, 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 gebeten, 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.
Daten Sicherheit & Datenschutz
Wir nehmen Ihre Datensicherheit ernst. Sobald Sie das Formular einreichen:
- Werden Ihre Schlüssel 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:
- Sie (der Kunde)
- Ihren Lohnberater
5. Die Integration ist bereit zur Nutzung!
Sobald Sie die Bestätigung von Ihrer Kontaktperson bei Factorial erhalten, ist die Integration bereit zur Nutzung!
6. Wechsel von Test zu Produktion auf Silae: So migrieren Sie Ihre Umgebung (falls noch nicht geschehen)
Haben Sie Ihre API-Tests abgeschlossen und funktioniert alles einwandfrei? Herzlichen Glückwunsch! Es ist jetzt Zeit, zu Ihrer 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 zur Integration in die Produktion.
- Das Verfahren:
- Gehen Sie zu Silae.
- Gehen Sie zu Lohnabrechnungseinstellungen (Paramétrage Paie).
- Greifen Sie auf die Testkonto-Konfiguration 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, der Client-Secret und der Subkey bleiben gleich. In Ihrem Code oder Ihren Verbindungseinstellungen sind keine Änderungen 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 "aufzuteilen": 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-Secret) verknüpft. Der Subkey Ihrer Testkonfiguration wird nicht mehr gültig sein.
- Regel für Externe: Wenn Sie mehrere Kunden verwalten, können die Client-ID und der Secret identisch sein, aber jede Gruppe von Dateien muss ihren eigenen dedizierten Subkey haben.
Wie beantrage ich 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-Nutzer: Sie müssen das offizielle Anfrageformular für jede Hinzufügung 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.
- Benachrichtigen Sie Fortify über jede Schlüsseländerung. Sobald Sie Schlüssel regenerieren oder neue Verbindungsinformationen (geänderter Subkey usw.) erhalten, 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. Diese Nummern müssen unbedingt zum Connector hinzugefügt werden, damit die Daten korrekt zurückfließen.
Welche Daten werden synchronisiert?
Allgemeiner Prozess zum Senden von Daten an Silae
Die Daten werden von Factorial an Silae über unseren "Mitarbeiter Lohnabrechnungsaktualisierungen" Abschnitt übertragen. Jede Aktion, die Sie in Factorial durchführen, die die Lohnabrechnung betrifft, generiert eine Mitarbeiteraktualisierung.
Um sicherzustellen, dass die richtigen Aktualisierungen synchronisiert werden, ist es wichtig, die entsprechenden Mitarbeiteraktualisierungen in Factorial zu aktivieren. Diese können Neueinstellungen, Vertragsänderungen, Aktualisierungen persönlicher Daten und Abwesenheiten umfassen. Gehen Sie dazu zu Einstellungen > Lohnabrechnung > Mitarbeiteraktualisierungen und aktivieren Sie alle Aktualisierungen, die Sie mit Silae synchronisieren möchten.

Wenn eine Mitarbeiteraktualisierung generiert wird, können Sie diese überprüfen und an Silae senden, indem Sie die Mitarbeiteraktualisierung als "Abgeschlossen" markieren. Die Übertragungszeiten können je nach Zeitraum variieren. Wenn beispielsweise eine große Anzahl von Vorfällen am Ende des Monats während der Lohnabrechnung gesendet wird, kann die Verarbeitung bis zu 5–10 Minuten dauern.

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 prüfen oder die tägliche E-Mail überprüfen, die die gesendeten Daten zusammenfasst und etwaige Fehler identifiziert.
Synchronisation neuer Einstellungen
Wenn ein neuer Mitarbeiter in Factorial erstellt wird, wird eine Mitarbeiteraktualisierung erstellt. Sie können diese öffnen und überprüfen, dass alle Daten korrekt sind, und sie dann als "Abgeschlossen" markieren, um die Änderung mit Silae zu synchronisieren.
Sozialversicherungsnummer (oder E-Mail Adresse für ausländische Arbeitnehmer ohne Nummer), Vorname, Nachname, Vertragstyp und Startdatum sind Pflichtfelder. Wenn diese fehlen, wird die Neueinstellung nicht in Silae 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 identisch sind. Andernfalls wird Silae einen neuen Vertrag erstellen, was zu Duplikationen führt.
- Für Mitarbeiter ohne Sozialversicherungsnummer: Der Datensatz wird trotzdem erstellt, aber die Validierung erfolgt basierend 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, die angegeben werden, müssen mit der Sozialversicherungsnummer übereinstimmen.
- Der Geburtsname ist Pflicht. Wenn er leer gelassen wird, wird der verwendete Nachname als Geburtsname behandelt, um die Erstellung nicht zu blockieren.
- 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 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 sequenziell dem höchsten bestehenden 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 für Identifikationsnummer auswählen)
- Geburtsname (wenn in Factorial leer gelassen, wird der Vorname hier ebenfalls synchronisiert)
- Geschlecht
- Berufliche E-Mail
- Persönliche E-Mail (wenn in Factorial leer gelassen, wird die persönliche E-Mail durch die berufliche E-Mail ersetzt)
- Handynummer
- Wohnadresse (Stadt, Land, Bundesland, Straße, Nummer und Postleitzahl)
- INSEE-Gemeindecode
- Geburtsdatum
- Geburtsabteilung (es wird von der Sozialversicherungsnummer übernommen; wenn es außerhalb von Frankreich ist, wird es als Code "99" gesendet und der Benutzer muss es manuell in Silae bearbeiten)
- Geburtsland-Code (wird von der Sozialversicherungsnummer übernommen)
- Nationalität
- IBAN
- BIC
-
Vertragsdaten
- Eintrittsdatum (basierend auf dem Startdatum Feld des Vertrags in Factorial)
- Vertragsbeginn (basierend auf dem Gültigkeitsdatum des Vertrags in Factorial)
- Vertragsversion Beginn (basierend auf dem Gültigkeitsdatum des Vertrags in Factorial)
- Enddatum
- Startgrund (standardmäßig synchronisierter Grund: 001)
- Einrichtung
- Berufsbezeichnung - unter "andere Berufsbezeichnung"
- Arbeitsvertragscode (muss ein Vertragstyp sein, der standardmäßig in Factorial verfügbar ist)
- Grundgehalt (muss auf monatlicher oder jährlicher Basis sein)
- Für stundenweise Beschäftigte → Arbeitsstunden im Vertrag (muss auf monatlicher oder wöchentlicher Basis sein). 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 Mitarbeitenden in Factorial aktualisiert werden, wird ein Mitarbeitenden-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.
Die folgenden Felder erzeugen ein Mitarbeitenden-Update, das mit Silae synchronisiert werden kann:
- Mitarbeitendendaten
- 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 von Silae geändert werden)
- IBAN
- BIC
- Vertragsdaten
- Beschäftigungsbeginn
- Vertragsbeginn
- Eintrittsdatum
- Enddatum
- Einrichtung
- Berufsbezeichnung (unter "andere Berufsbezeichnung")
- Vertragstypcode (muss ein Vertragstyp sein, der standardmäßig in Factorial verfügbar ist)
- Grundgehalt (muss das Monatsgehalt oder das Jahresgehalt sein)
- Für stundenweise Mitarbeitende:
- Vertragliche Stunden - monatliche oder wöchentliche Stunden müssen eingegeben werden (diese werden die Felder „Normale monatliche Stunden“ und „Überstunden monatliche Stunden“ in Silae ausfüllen)
- Für Mitarbeitende mit einem tagebasierten Vertrag:
- Anzahl der Tage
Wichtig:
- Wenn Sie Vertragsänderungen für einen bestehenden Mitarbeitenden in Ihrem Unternehmen senden möchten, stellen Sie sicher, dass Sie die Vertragsbeginn- und Beschäftigungsbeginn-Daten in Factorial und Silae sorgfältig überprüfen, um zu vermeiden, dass versehentlich ein neuer Mitarbeitenden-Datensatz 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 eine "weiße Blase" (nicht berechnet/Fehlerstatus) in den Lohnabrechnungen des Mitarbeitenden ausgelöst.
Wenn dies passiert, folgen Sie dem genauen Lösungsprozess unten:
-
Identifikation
- Lokalisieren Sie die rote Blase im letzten Monat, der grüne Blasen anzeigt.
- 🛑 KRIITISCHE WARNUNG: Versuchen Sie niemals, eine Abrechnung zu berechnen, die eine rote Blase zeigt.
- Aktionsplan
Sie müssen die fehlerhaften Verträge löschen, um das System wiederherzustellen. Befolgen Sie diesen 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, wodurch er entsperrt wird, sodass Sie ihn erfolgreich löschen können.
So erstellen Sie einen Nachtrag oder ändern einfach einen Vertrag
- 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 Mitarbeitenden in Factorial, klicken Sie auf Neue Bedingungen und geben Sie das Datum der Änderung ein.
- Ändern Sie einen Vertrag: Wenn Sie eine Änderung ohne Erstellung eines neuen Jobs 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 dies nicht der Fall ist, wird automatisch ein neuer Job in Silae erstellt:

Verwaltung von Vertragsbeendigungen, -verlängerungen und -nachfolgen
Was ist der richtige Workflow, dem in Factorial gefolgt werden sollte?
Wenn der Mitarbeitende das Unternehmen verlässt:
- Schließen Sie das Profil des Mitarbeitenden in Factorial, geben Sie das Enddatum und den Grund ein; der Eintrag zur Vertragsbeendigung wird im Abschnitt "Updates" des Lohnmoduls angezeigt.
Der Standardcode für die Vertragsbeendigung wird automatisch auf 008 in Silae gesetzt. Wenn Sie ihn ändern müssen, müssen Sie dies manuell in Silae tun.
Wenn der Mitarbeitende ins Unternehmen zurückkehrt:
- Reaktivieren Sie dasselbe Profil, um die neue Bedingung zu erstellen.
.png)
Systemverhalten gemäß den verschiedenen Szenarien zur Erstellung von Mitarbeitenden zwischen Factorial und Silae:
| Fall | Was passiert | Ergebnis in Silae | Beschäftigungsgrund |
|---|---|---|---|
| 1. Erstellung eines neuen Mitarbeitenden in Factorial (normaler Fall) | Der Mitarbeitende existiert überhaupt nicht in Silae | Mitarbeitenden-Datensatz mit Vertragsdaten erstellt | 001 – neuer Vertrag |
| 2. Erneutes Senden von Informationen aus Factorial nach einem Dateneingabefehler bei der Erstellung des Mitarbeitendenprofils | Der Mitarbeitende existiert noch nicht in Silae, wir senden die Informationen erneut | Als Neueinstellung behandelt | 001 – neuer Vertrag |
| 3. Senden eines Vertragsvorfalls, der Mitarbeitende existiert bereits in Silae, aber ohne Vertrag | Silae hat den Mitarbeitenden, aber keinen Vertrag | Als Neueinstellung behandelt | 001 – neuer Vertrag |
| 4. Senden eines Vorfalls für eine Vertragsänderung, der Mitarbeitende existiert mit einem ähnlichen Vertragsbeginn in Silae und Factorial | Die Daten sind konsistent | Einfaches Vertragsupdate | Keine Änderung |
| 5. Senden eines Vorfalls für eine Vertragsänderung, der Mitarbeitende 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 Mitarbeitenden-ID, während der Mitarbeitende nicht existiert | Die Mitarbeitenden-ID ist in Silae unbekannt | Synchronisation schlägt fehl | Keine Änderung |
Abwesenheitensynchronisation
Wenn die Abwesenheit eines Mitarbeitenden in Factorial genehmigt wird, wird ein Lohnabrechnungs-Mitarbeitenden-Update erstellt. Sie können überprüfen, ob alle Daten korrekt sind, und dann den Vorfall als „Abgeschlossen“ markieren, um die Daten an Silae zu synchronisieren.

Überprüfen Sie, ob die Abwesenheiten, die Sie senden möchten, in der Seite Mitarbeitenden-Update-Einstellungen aktiviert sind und den Silae-Code in der Integrationsseite zugeordnet haben (nur den 3-stelligen Code, ohne die Einbeziehung von „AB-“)
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, Arbeitgeber-Zuschüsse oder Schwellenwerte) werden von Factorial gesendet, aber in Silae berechnet, das in diesem Fall als Master-System fungiert. Silae bestimmt sowohl die entschädigte Dauer als auch die zu zahlenden Beträge.
Andere Abwesenheiten, die in der Regel einfacher sind, werden direkt in Factorial verwaltet, das als Master-System fungiert — es sind keine weiteren Bearbeitungen auf Seiten von Silae erforderlich.
- Bezahlter Urlaub und RTT müssen immer in Tagen oder Halbtagen gesendet werden.
- Krankheitsurlaub wird von Silae berechnet. Wenn in Tagen gesendet, wird es automatisch verarbeitet.
- 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 in der Lohnabrechnung widergespiegelt.
Ändern & Löschen einer synchronisierten Abwesenheit
Wenn Sie eine Abwesenheit für einen Ihrer Mitarbeitenden von Factorial an Silae gesendet haben und Ihr Mitarbeitender 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. Indem Sie diesen Vorfall als abgeschlossen markieren, 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 kundenspezifischen Code. Sie finden sie unter Einstellungen > Eingangsvariablen. 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 upstream durchzuführen, um zu verifizieren, dass der von Factorial gesendete EVP-Code in Silae existiert.
Schritt 2 – Konfigurieren Sie EVP-Codes in Factorial
In Factorial werden diese EVPs am selben Ort wie Abwesenheitscodes, Mitarbeitenden-Nummern und Einrichtungscodes unter den „zusätzlichen Vergütungen“-Feldern eingegeben:
.png)
Schritt 3 – Senden Sie die EVP von Factorial an Silae
Die EVPs werden in Factorial eingegeben und werden manuell (durch einen Button-Klick) über die API gesendet:
.png)
Voraussetzungen für die EVP-Übertragung
Damit die Synchronisation funktioniert, müssen folgende Voraussetzungen erfüllt sein:
- Mitarbeitenden-ID im Profil des Mitarbeitenden
- Aktennummer (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
Sobald die Daten verarbeitet wurden, wird der Integrationsstatus in Factorial zurückgegeben:
Die Antwort muss die ID und den Verarbeitungsstatus enthalten, der einer der folgenden drei Optionen sein kann:
- Erfolg – wenn die VPE erfolgreich mit Silae synchronisiert wurde
- Fehler – wenn ein technischer Fehler die Synchronisation verhindert hat
- ungültig – wenn die gesendeten Daten inkorrekt oder unvollständig sind
| Silae-Fehlerfall | Fehlermeldung angezeigt | Status zurückgeben | Erklärung |
|---|---|---|---|
| Ungültiges Datenformat | Unerwartetes Zeichen beim Parsen des Wertes | ungültig – FalschesFormat | Die eingegebenen Daten sind inkorrekt. 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 Mitarbeitenden-ID | Kein Mitarbeitender mit dieser ID vorhanden | ungültig – FehlendeID | Die Mitarbeitenden-ID für die Lohnabrechnung fehlt oder ist inkorrekt. |
| Falsche Aktennummer | Der Wert in der Dateiliste ist null oder leer | fehlerhaft – FalschesAkten | Die Silae-Aktennummer ist inkorrekt. |
| 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 Subkey | SubscriptionKeyInvalid, Zugriff verweigert | fehlerhaft – FalscherSubkey | Der Silae-Subscription-Key ist ungültig. |
| Ungültiges Client-Geheimnis oder Client-ID | "error": "invalid_client" | fehlerhaft – FalscherAPIKey | Das Silae-Client-Geheimnis oder die Client-ID ist ungültig. |
| Ungültiger VPE-Code | N/A (vergleichen mit der Silae-Tabelle) | 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ü „Eingangsvariablen“ eingeben.
Sie müssen nur die entsprechenden Silae-Stunden-Codes in Factorial korrekt zuordnen, abhängig von den Kategorien, die in Ihrer Lohnabrechnungskonfiguration verwendet werden.
1. Native Stunden (standardmäßige 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 Konfiguration eines dieser 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. EVPs, die im Menü "Variablen einfügen" in Silae fehlen
Damit Ihre Variablen über die Schnittstelle abgerufen werden können, müssen sie im Menü „Variablen einfügen“ eingegeben werden.
Die EVPs, die in diesem Fenster nicht vorhanden sind, können nicht über die Schnittstelle verarbeitet werden.
- Beispiel für Restaurantgutscheine:
Voraussetzung: Die Restaurantgutscheine müssen konfiguriert sein „Anzahl der Restaurantgutscheine, die eingegeben werden sollen“:.png)
Schritte in Silae:
1- Gehen Sie zu Einstellungen / Variablen, die eingegeben werden sollen
.png)
2- Überprüfen Sie, ob die Variable in der Tabelle vorhanden ist
3- Wenn die Variable nicht vorhanden ist, klicken Sie auf "Eine Variable erstellen"
.png)
4- Fügen Sie die Variable im unteren Teil der Seite hinzu (z. B.: NbTicket):
.png)
5- Speichern Sie die neue Variable, sie wird in der Tabelle sichtbar sein:
.png)
6- Geben Sie den Namen der Variable in Factorial in den Silae-Integrations-Einstellungen (API-Connector) ein:
.png)
7- Ihre Variable ist jetzt bereit, über das Vergütungsmodul verarbeitet zu werden
Überweisung 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 die angesammelten Urlaubsansprüche von SILAE in Factorial abgerufen werden?
Die Integration ruft die angesammelten Urlaubsstände von Silae zu Factorial gemäß Ihren Anforderungen ab und spiegelt den angesammelten Urlaub wider. Die Stände werden über die KLYR-Plattform zu Beginn des folgenden Monats aktualisiert, nachdem Ihre Gehaltsabrechnungen validiert wurden. Nach diesem Update werden die bezahlten Urlaubstage (CP) und RTT-Stände automatisch synchronisiert. Für CP umfasst dies sowohl die bereits im Vorjahr (N‑1) angesammelten Tage als auch die derzeit für das laufende Jahr (N) angesammelten Tage.
Für die Synchronisation des Urlaubsstands müssen die Silae-Mitarbeiter-IDs vorhanden und identisch in Factorial sein.
Wie ruft man die angesammelten Urlaubsstände von SILAE zu Factorial ab?
- Bevor Sie die Stände aktivieren, müssen Sie die kumulierte Tagesbasis 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 kumulierte Tagesbasis 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) zusammenhängen, zurücksetzen möchten, kontaktieren Sie bitte Ihren Account-Manager. Sie werden 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 darauf, in den Einstellungen von Factorial keine Übertragung ungenutzter Tage aus dem Vorjahr zuzulassen, da die Berechnung des angesammelten Urlaubs von Silae die übertragenen Tage umfasst.
- Sobald 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 Urlaubsstände 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, schicken 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 das Feld auf der Seite für Integrations-Einstellungen leer lassen.
Falls 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 deren zugehörige 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 Synchronisationsfehler auftritt, wird dem Kunden ein Fehlerbericht per E-Mail 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 bezüglich nicht erfolgreich übertragener Daten 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 einen Fehler geben).
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 zu Factorial synchronisiert werden:
- Matrikel - wird zu Factorial synchronisiert, sobald der Mitarbeiter in Silae erstellt wird
- Urlaubsstände - werden automatisch in Factorial 5 Tage nach 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 (SV-Nr.) ausgefüllt werden. Wenn ein Mitarbeiter diese nicht hat, muss der Mitarbeiter manuell sowohl in Silae als auch in Factorial erstellt werden. Sobald die vorläufige SV-Nr. in Silae zugewiesen ist, müssen Sie diese in Factorial kopieren und einfügen.
Was sind die häufigsten Fehler?
- Geburtsdaten und Sozialversicherungsnummer sind nicht konsistent
- Codes sind nicht auf der Factorial-Marktplatzseite ausgefüllt.
- Kein API-Zugang für einige Kundendossiers.
Brauchen Sie Hilfe?
Für jegliche Unterstützung oder Hilfe bezüglich eines Fehlers 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 ein Problem oder eine Änderung bezüglich der API-Schlüssel gibt: 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.