Zurück

Silae Integration

Entdecken Sie, wie Sie Ihr Factorial-Konto mühelos mit Silae integrieren können, um Ihren Lohnabrechnungsprozess zu optimieren. Synchronisieren Sie neue Einstellungen, Mitarbeiteraktualisierungen und Abwesenheiten von Factorial zu Silae für mehr Effizienz und Genauigkeit.

Bevor Sie die Integration mit Ihrem Live-Konto nutzen, 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.

Dazu müssen Sie zuerst die Integration in Ihrer Silae-Demoumgebung einrichten und die Tests durchführen. Sobald die Integration als korrekt funktionierend bestätigt ist, 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."


 

 

3. Vervollständigen Sie die Einstellungen basierend auf den Informationen, die Ihr Buchhalter von Silae geteilt hat:

 

 
 

Die Betriebscodes (entsprechend den Arbeitsplätzen)

 

 
 

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:

 

Die Ordnernummern und Betriebscodes sind zwingend 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 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 die Sicherheit Ihrer Daten ernst. Sobald Sie das Formular eingereicht haben:

  1. Werden Ihre Schlüssel automatisch in einen vollständig gesicherten Container verschoben.
  2. Alle sensiblen Daten werden sofort aus dem temporären Speicher (SharePoint) gelöscht.
  3. Fortify konfiguriert dann die Schnittstelle sicher in Ihrem Namen.

Sobald die Konfiguration abgeschlossen ist, wird eine automatisierte Benachrichtigung an:

  • Sie (den Kunden)
  • Ihren Lohnbuchhalter

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 nun 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 den 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.
  • Technischer Einfluss: Die Client-ID, der Client-Secret und der Subkey bleiben gleich. Es sind keine Änderungen an Ihrem Code oder Ihren Verbindungseinstellungen erforderlich.
  • Wer macht das? 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.

  • Technischer Einfluss: In diesem Szenario werden alle Schlüssel unterschiedlich sein und müssen über das Formular an Fortify übermittelt werden.
  • Warnung: Ein Subkey ist an Ihr Abonnement und Ihre Anmeldeinformationen (Client-ID / Client-Secret) gebunden. 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 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 ein Silae-Nutzer: 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 (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

Daten werden von Factorial zu Silae über unseren "Mitarbeiter-Lohnaktualisierungen"-Bereich übertragen. Jede Aktion, die Sie in Factorial durchführen und 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. Dazu gehören möglicherweise Neueinstellungen, Vertragsänderungen, Aktualisierungen persönlicher Daten und Abwesenheiten. 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 sie überprüfen und sie an Silae senden, indem Sie die Mitarbeiteraktualisierung als "Abgeschlossen" markieren. Die Übertragungszeiten können je nach Zeitraum variieren. Wenn beispielsweise am Ende des Monats eine große Anzahl von Vorfällen während des Lohnabschlusses gesendet wird, kann die Bearbeitung 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 überprüfen oder die tägliche E-Mail überprüfen, die die gesendeten Daten zusammenfasst und etwaige Fehler identifiziert.

 
 
 

Synchronisierung neuer Einstellungen

Wenn ein neuer Mitarbeiter in Factorial erstellt wird, wird eine Mitarbeiteraktualisierung erzeugt. Sie können diese öffnen und überprüfen, ob 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, Vertragsart und Eintrittsdatum 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 sollten Sie darauf achten, dass das Vertragsdatum (Eintritt ins Unternehmen) und das Beschäftigungsdatum (aktuelle Vertragsaktualisierung) in SILAE gleich sind. Andernfalls wird Silae einen neuen Vertrag erstellen, was zu Duplikationen führt.
  • Für Mitarbeiter ohne Sozialversicherungsnummer: Der Datensatz wird weiterhin erstellt, aber die Validierung erfolgt auf der Grundlage 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 pflichtig. 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üllen wir automatisch das Matricule-Feld in Factorial aus. Sie können eine Option in Silae aktivieren, um die Eindeutigkeit 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 Aktivität, direkte Einstellung oder Einstellung über Wettbewerb (öffentlicher Dienst), Beginn der Abordnung, Beginn des kulturellen Lebens (Religionen). Sie können dies in Silae bei Bedarf ändern.

Der neue Mitarbeiter wird mit einem Mitarbeitercode, der sequenziell dem höchsten vorhandenen Code im Silae-Konto des Kunden folgt, in Silae hinzugefügt.

 

 

Felder, die an Silae gesendet werden

  1. Mitarbeiterdaten
    • Vorname
    • Nachname
    • Sozialversicherungsnummer (der Kunde muss die Sozialversicherungsnummer im Feld für die Identifikationsnummer auswählen)
    • Geburtsname (wenn im Factorial leer gelassen, wird der Vorname auch hier synchronisiert)
    • Geschlecht
    • Berufliche E-Mail
    • Persönliche E-Mail (wenn im Factorial leer gelassen, wird die persönliche E-Mail durch die berufliche E-Mail ersetzt)
    • Handynummer
    • Heimadresse (Stadt, Land, Bundesland, Straße, Nummer und Postleitzahl)
    • INSEE-Gemeindecode
    • Geburtsdatum
    • Geburtsabteilung (wird von der SSN übernommen; wenn sie außerhalb Frankreichs liegt, wird sie als Code "99" gesendet, und der Benutzer muss sie manuell in Silae bearbeiten)
    • Geburtslandcode (wird von der SSN übernommen)
    • Nationalität
    • IBAN
    • BIC
  2. Vertragsdaten
    • Eintrittsdatum (basierend auf dem Eintrittsdatum-Feld des Vertrags von Factorial)
    • Vertragsbeginn (basierend auf dem Wirksamkeitsdatum des Vertrags von Factorial)
    • Vertragsversion Beginn (basierend auf dem Wirksamkeitsdatum des Vertrags von Factorial)
    • Enddatum
    • Startgrund (standardmäßig synchronisierter Grund: 001)
    • Einrichtung
    • Berufsbezeichnung - unter "andere Berufsbezeichnung"
    • Vertragscode (muss ein in Factorial standardmäßig verfügbarer Vertragstyp sein)
    • Grundgehalt (muss auf monatlicher oder jährlicher Basis angegeben werden)
    • Für stundenweise Beschäftigte → 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 tagebasierten Vertrag → Anzahl der Tage

 

 
 

Synchronisierung von Änderungen an Mitarbeiter- und Vertragsdaten

Wenn die Profil- oder 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 dann als "Abgeschlossen" markieren, um die Änderung mit Silae zu synchronisieren.

Die folgenden Felder generieren ein Mitarbeitenden-Update, das mit Silae synchronisiert werden kann:

  1. Mitarbeitendendaten
    • Nachname
    • Vorname
    • Berufliche E-Mail
    • Handy
    • 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
  2. Vertragsdaten 
    • Beschäftigungsbeginn
    • Vertragsbeginn
    • 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 monatliche Gehalt oder das Jahresgehalt sein)
    • Für stundenweise Mitarbeitende:
      • 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 Mitarbeitende mit einem tagbasierten Vertrag:
      • Anzahl der Tage

Wichtig:

  • Wenn Sie Vertragsänderungen für einen bestehenden Mitarbeitenden in Ihrem Unternehmen senden möchten, überprüfen Sie sorgfältig die Vertragsbeginn- und Beschäftigungsbeginn-Daten in Factorial und Silae, um zu vermeiden, versehentlich einen neuen Mitarbeitenden-Datensatz in Silae zu erstellen
  • API-Aktionen bezüglich Verträgen müssen strikt in der Gegenwart oder Zukunft festgelegt werden. Es sollten keine früheren Vertragsdaten gesendet werden.

Andernfalls wird die Synchronisierung gestört und ein "weißer Bubble" (nicht berechneter/Fehlerstatus) auf den Gehaltsabrechnungen des Mitarbeitenden ausgelöst.

Wenn dies geschieht, folgen Sie dem genauen Lösungsprozess unten:

  1. Identifikation
    • Lokalisieren Sie die rote Bubble im letzten Monat, die grüne Bubbles anzeigt.
    • 🛑 KRIITISCHE WARNUNG: Versuchen Sie niemals, eine Bulletin zu berechnen, die eine rote Bubble zeigt.
       
  2. Aktionsplan

Sie müssen die fehlerhaften Verträge löschen, um das System wiederherzustellen, folgen Sie diesem spezifischen Workaround:

  1. Die Regel: Ein Vertrag kann nur gelöscht werden, wenn er chronologisch der letzte in der Historie ist.
  2. 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.
  3. Die Löschung: Dieser Trick schiebt Vertrag #1 in die finale Position, wodurch er entsperrt wird, 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-Reiter 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 nicht, wird automatisch ein neuer Job in Silae erstellt:

 

Verwaltung von Vertragsbeendigungen, -verlängerungen und -nachfolgen

Was ist der korrekte Workflow, der in Factorial zu befolgen ist?

Wenn der Mitarbeitende das Unternehmen verlässt:

  • Schließen Sie das Profil des Mitarbeitenden in Factorial, geben Sie das Enddatum und den Grund dafür ein; der Eintrag zur Vertragskündigung erscheint im Abschnitt "Updates" des Gehaltsmoduls.

Der Standardcode für Vertragskündigungen wird automatisch auf 008 in Silae gesetzt. Wenn Sie ihn ändern müssen, müssen Sie dies manuell in Silae tun.

 

Wenn der Mitarbeitende wieder ins Unternehmen eintritt:

  • Reaktivieren Sie dasselbe Profil, um die neue Bedingung zu erstellen.

 

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 Mitarbeitendendatensatz mit Vertragsdaten erstellt 001 – neuer Vertrag
2. Erneutes Senden von Informationen aus Factorial nach einem Dateneingabefehler während der Erstellung des Mitarbeitendenprofils Der Mitarbeitende existiert noch nicht in Silae, wir senden die Informationen erneut Als neue Einstellung 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 neue Einstellung 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 Einfache Vertragsaktualisierung 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
 

 

 

 
 

Synchronisation von Abwesenheiten

Wenn eine Abwesenheit eines Mitarbeitenden in Factorial genehmigt wird, wird ein Gehaltsabrechnungs-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, auf der Seite der Einstellungen für Mitarbeitenden-Updates aktiviert sind und den Silae-Code in der Seite der Integrations-Einstellungen zugeordnet haben (nur den 3-stelligen Code, ohne '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, Arbeitgeberzuschüsse oder Schwellenwerte) werden von Factorial gesendet, aber in Silae berechnet, das in diesem Fall als Hauptsystem 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 Hauptsystem fungiert - keine weitere Verarbeitung ist 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 Gehaltsabrechnung 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:

 

 
 

Übertragung von Gehaltskomponenten

Allgemeiner Workflow

Schritt 1 – Identifizieren Sie die EVP-Codes in Silae

Variable Gehaltsbestandteile 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:

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 verifizieren, dass der EVP-Code, der von Factorial gesendet wird, in Silae vorhanden ist.

 

Schritt 2 – Konfigurieren Sie EVP-Codes in Factorial

In Factorial werden diese EVPs am selben Ort eingegeben wie Abwesenheitscodes, Mitarbeitendenaktennummern und Einrichtungscodes, unter den Feldern „zusätzliche Vergütung“:

Schritt 3 – Senden Sie die EVP von Factorial an Silae

Die EVPs werden in Factorial eingegeben und manuell (durch einen Klick auf einen Button) über die API gesendet:

Voraussetzungen für die EVP-Übertragung

Damit die Synchronisation funktioniert, müssen die folgenden Voraussetzungen erfüllt sein:

  • Mitarbeitenden-ID im Profil des Mitarbeitenden
  • Akte Nummer (codiert 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 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 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 kann nicht leer sein.
Fehlende oder falsche Mitarbeitenden-ID Kein Mitarbeitender entspricht der ID ungültig – FehlendeID Die Mitarbeitenden-ID für die Gehaltsabrechnung fehlt oder ist inkorrekt.
Falsche Aktennummer Der Wert in der Dateiliste ist null oder leer fehlgeschlagen – FalscheDatei 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 passt nicht zum aktuellen Zeitraum in Silae.
Ungültiger Untercode SubscriptionKeyInvalid, Zugriff verweigert fehlgeschlagen – FalscherUntercode Der Silae-Subscription-Schlüssel ist ungültig.
Ungültiges Client-Geheimnis oder Client-ID "error": "invalid_client" fehlgeschlagen – FalscherAPIKey Das Silae-Client-Geheimnis oder die Client-ID ist ungültig.
Ungültiger VPE-Code N/A (vergleichen mit Silae-Tabelle) ungültig – FalscherEVPCode Der VPE-Code existiert nicht in Silae. Bitte korrigieren Sie ihn.

 

Zusätzliche Details zu spezifischen Variablentypen

*Die nativen Stunden

Für Stunden müssen Sie nicht in das Menü „Eingangsvariablen“ eingeben.

Sie müssen nur die entsprechenden Silae-Stundencodes in Factorial korrekt zuordnen, abhängig von den in Ihrer Gehaltsabrechnung 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 zu 25%
  • HS50 = Überstunden zu 50%
  • HS100 = Überstunden zu 100%

2. Stunden mit benutzerdefinierten Silae-Codes

Die folgenden Codes entsprechen Stunden, die auf benutzerdefinierten Silae-Konfigurationen basieren.

Wenn Ihre Einrichtung einen dieser Codes 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:

📩 support@fortifydigital.zendesk.com

 

 

3. Ein EVP, der als reguläre Stunden getarnt ist

Hier sind einige Beispiele - Dies sind Gehaltsvariablen (oft mit Premium- oder Zulagenprofilen verknüpft)

  • Feiertagsstunden: Die Anzahl der Stunden dient als Multiplikator für eine Prämie oder Erhöhung.
  • Bereitschaftsstunden: Ob als Pauschalbetrag oder Stundenlohn bezahlt, Silae benötigt einen variablen Zahlungscode (oft die Anzahl der Bereitschaftsstunden), um die Zulage auszulösen.
  • Nachtarbeitsstunden: Das Volumen der übertragenen Stunden dient ausschließlich als Auslöser für die Nachtzuschlagszahlung.

 

Ü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 richtig 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 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, nachdem Ihre Gehaltsabrechnungen validiert wurden. Nach diesem Update werden die bezahlten Urlaubstage (CP) und RTT-Zähler 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 Urlaubstage von SILAE zu Factorial ab?

  1. 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.

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, kontaktieren Sie bitte Ihren Account-Manager. Dieser wird dies für Sie einrichten.

  1. 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.

  2. Achten Sie in den Einstellungen von Factorial darauf, die Übertragung ungenutzter Tage aus dem Vorjahr nicht zuzulassen, da die Berechnung der angesammelten Urlaubstage (CP) von Silae die übertragenen Tage beinhaltet.
  3. Sobald die Zähler aktiviert und die Zählercodes vervollständigt sind, werden die von Ihren Aktionen auf KLYR angepassten Zähler für Factorial angepasst.

Was ist KLYR und wie funktioniert es?

KLYR ist die Plattform, die verwendet wird, um Ihre Urlaubstage von Silae zu Factorial zu synchronisieren. So funktioniert es:

  1. 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
  2. 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.
  3. Zugang zu KLYR:

Sobald die Anpassung vorgenommen wurde, sieht der Benutzer eine Notiz im Zähler von Factorial, die sagt: „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 der Integrations-Einstellungen leer lassen.

Wenn Silae erst begonnen hat, die Gehaltsabrechnungen zu berechnen, 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 die 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 im Vorjahr (N-1) angesammelten und der derzeit für dieses Jahr (N) angesammelten Tage
rttAcquis Anzahl der angesammelten 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 bei nicht erfolgreich übertragenen Daten identifizieren und lösen kann.

Hier ist ein Beispiel für einen Fehlerbericht:

Was passiert, wenn ein neuer Mitarbeiter mit einer bestimmten Matrikel synchronisiert wird, die in Silae nicht 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 zu 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
  • Urlaubsanspruchszähler - 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 (SSN) ausgefüllt sein. Wenn ein Mitarbeiter diese nicht hat, muss der Mitarbeiter manuell sowohl in Silae als auch in Factorial 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 nicht auf der Seite des Factorial Marktplatzes ausgefüllt.
  • Kein API-Zugang für einige Kundenakten.

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 bei Factorial funktioniert, Sie jedoch die Daten nicht korrekt auf 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 der 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 nachverfolgt wird.

War dieser Artikel hilfreich?

Give feedback about this article

Können Sie nicht finden, wonach Sie suchen?

Unser Kundenserviceteam steht Ihnen zur Verfügung.

Kontakt

Knowledge Base Software powered by Helpjuice