Lohnabrechnungs-Integration mit Beekeeper

Diese Anleitung erklärt, wie Lohnabrechnungen aus externen HR-Systemen mithilfe der Beekeeper API in Beekeeper integriert werden können. Während wir Unterstützung anbieten, liegen die Entwicklung und Implementierung der Integration in deiner Verantwortung. Hier findest du die Schritte, die du befolgen musst, um den Benutzern direkte Chat-Nachrichten mit der Lohnabrechnung als PDF-Anhang zu senden.

Voraussetzungen

Du solltest Programmierkenntnisse besitzen und in der Lage sein, deinen Code eigenständig zu entwickeln und zu hosten. Außerdem solltest du Lohnabrechnungen aus deinem HR-System im PDF-Format exportieren können. Dies kann entweder über eine direkte Exportfunktion oder ein Skript zur Generierung von PDFs aus den Daten erfolgen.

Schritte zur Implementierung der Lohnabrechnungs-Integration

Schritt 1: Lohnabrechnungsdateien hochladen

Folge diesen Schritten, um eine Datei hochzuladen:

1. Fordere ein Upload-Token an, indem du eine GET-Anfrage an /files/{usage_type}/upload/token sendest. Diese Anfrage liefert eine Upload-URL, zusätzliche Formulardaten und Registrierungsanforderungen zurück.
2. Lade die Datei in den Cloud-Speicher hoch, indem du eine POST-Anfrage mit den empfangenen Parametern und der Datei im Binärformat abschickst.
3. Wenn erforderlich, registriere die Datei durch eine POST-Anfrage an /files/{usage_type}/upload, wobei du den im vorherigen Schritt erhaltenen Key und zusätzliche Parameter angibst.

Schritt 2: Benutzer-UUIDs abrufen

Nutze die GET-Anfrage "Get a user with a given username", um die UUIDs der Benutzer zu erhalten, die die Lohnabrechnungen empfangen sollen. Die UUIDs sind erforderlich, um direkte Nachrichten an die jeweiligen Benutzer zu senden.

Schritt 3: Lohnabrechnungen an Benutzer senden

Iteriere über jeden Benutzer (z. B. in einer Schleife) und sende ihm eine direkte Nachricht mit der Lohnabrechnung als Anhang. Verwende dafür die POST-API-Anfrage "Send a message to a given recipient" für jeden Benutzer.

Fehlerbehebung

Teste die API-Aufrufe mit Postman, um sicherzustellen, dass sie korrekt funktionieren.

Weitere Ressourcen / Links

Bitte konsultiere die Beekeeper API-Dokumentation für zusätzliche Hilfe und detaillierte Informationen zur Beekeeper API.