SAP Integration – TimeAM
Überblick
Die SAP-Integration verbindet TimeAM mit SAP ERP-Systemen für Personalwirtschaft (HCM) und Projektmanagement.
Status: Enterprise-Feature (Custom Integration)
Funktionsumfang
Unterstützte SAP-Module
SAP HCM (Human Capital Management): - Stammdaten-Synchronisation - Zeitwirtschaft (PT) - Personalabrechnung (PY)
SAP PS (Project System): - Projektstammdaten - PSP-Elemente - Rückmeldungen
SAP CO (Controlling): - Kostenstellenbuchungen - Innenauftragsbuchungen
Voraussetzungen
System-Anforderungen
SAP: - SAP ERP 6.0 oder höher - SAP S/4HANA (empfohlen) - RFC-fähige Schnittstelle - SAP PI/PO (Process Integration) – optional
TimeAM: - Enterprise-Plan - Dedizierte SAP-Integration-Lizenz - API-Zugang
Berechtigungen
SAP: - RFC-Berechtigungen - Lese-/Schreibzugriff auf relevante Tabellen - Transaktion SM59 (RFC-Destinationen)
TimeAM: - Administrator-Rolle - Integration-Admin-Berechtigung
Architektur
Integrations-Muster
Option 1: Direkt-Verbindung (RFC)
- Echtzeit-Synchronisation - Direkte RFC-Calls - Empfohlen für S/4HANAOption 2: Middleware (SAP PI/PO)
- Asynchrone Kommunikation - Transformation & Mapping - Empfohlen für komplexe LandschaftenOption 3: File-based (IDoc/CSV)
- Batch-Verarbeitung - Zeitversetzt - Fallback-OptionSetup-Anleitung
Schritt 1: SAP-Vorbereitung
RFC-Destination erstellen: 1. SAP anmelden (Transaktion SM59) 2. Neue RFC-Destination anlegen: - Typ: HTTP Connection - Target Host: api.example.com (Ihre TimeAM API-URL) - Path Prefix: /api/sap 3. Logon & Security konfigurieren 4. Verbindungstest durchführen
Benutzerberechtigung:
1. Transaktion SU01
2. Technischen User anlegen: ZTIMEAM
3. Berechtigungen zuweisen:
- HR_MASTER_DATA (Read)
- HR_TIME_DATA (Read/Write)
- PS_PROJECT (Read)
Schritt 2: TimeAM-Konfiguration
Integration aktivieren: 1. TimeAM: Einstellungen → Integrationen 2. SAP-Integration aktivieren 3. Verbindungs-Details eingeben: - SAP System-ID - Client-Nummer - RFC-Destination - Credentials 4. Verbindungstest
Mapping konfigurieren: 1. Mitarbeiter: SAP Personal-Nr ↔ TimeAM User-ID 2. Projekte: SAP PSP-Element ↔ TimeAM Projekt-ID 3. Kostenstellen: SAP KostStl ↔ TimeAM Kostenstelle
Schritt 3: Datenfluss konfigurieren
Stammdaten (SAP → TimeAM): - Mitarbeiter-Stammdaten - Organisations-Struktur - Kostenstellen - Projektstammdaten
Zeitdaten (TimeAM → SAP): - Arbeitsstunden - Projektrückmeldungen - Fehlzeiten
Zeitplan: - Stammdaten: Täglich, nachts (01:00 Uhr) - Zeitdaten: Wöchentlich, am Montag
Datenflüsse
Stammdaten-Synchronisation (SAP → TimeAM)
Mitarbeiter-Stammdaten:
Felder: - Personalnummer → Employee-ID - Name, Vorname → Display Name - E-Mail → E-Mail - Kostenstelle → Kostenstelle - Org-Einheit → Team
Frequenz: Täglich
Zeitdaten-Übertragung (TimeAM → SAP)
Arbeitsstunden:
Format: - Personal-Nr - Datum - Stunden (Anwesenheit/Abwesenheit) - Lohnart - Kostenstelle
Frequenz: Wöchentlich oder monatlich
Projekt-Rückmeldungen (TimeAM → SAP)
Projektzeiten:
Format: - PSP-Element - Mitarbeiter - Stunden - Datum - Leistungsart
Buchung: - SAP CO-Beleg wird automatisch erstellt - Kostenstelle wird belastet
Export-/Import-Formate
IDoc-Format
HRMD_A (Mitarbeiter-Stammdaten):
<HRMD_A07>
<E1PLOGI>
<PERNR>00001234</PERNR>
<ENAME>Mustermann, Max</ENAME>
<KOSTL>1000</KOSTL>
</E1PLOGI>
</HRMD_A07>
CATS (Zeitrückmeldung):
<CATS_INSERT_MULTI_TIMES>
<WORKDATE>20260104</WORKDATE>
<CATSHOURS>8.0</CATSHOURS>
<WBS_ELEMENT>P-12345-1</WBS_ELEMENT>
</CATS_INSERT_MULTI_TIMES>
CSV-Format (Fallback)
Zeitdaten:
PersonalNr,Datum,Stunden,Lohnart,Kostenstelle,PSP-Element
00001234,2026-01-04,8.0,1000,4100,P-12345-1
Fehlerbehandlung
Monitoring
Integration-Dashboard: 1. Einstellungen → Integrationen → SAP → Status 2. Siehe: - Letzte Synchronisation - Erfolg/Fehler-Status - Verarbeitete Records - Fehler-Log
SAP-seitig: - Transaktion SM58: Prüfung fehlgeschlagener Updates - Transaktion SLG1: Application Log
Häufige Fehler
| Fehler | Ursache | Lösung |
|---|---|---|
| RFC_ERROR | Verbindung fehlgeschlagen | Credentials/Firewall prüfen |
| MAPPING_ERROR | Mitarbeiter nicht gemappt | Mapping vervollständigen |
| AUTH_ERROR | SAP-Berechtigungen fehlen | User-Berechtigungen prüfen |
| DATA_FORMAT | Ungültiges Datumsformat | Format-Einstellungen prüfen |
Error Recovery
Automatische Wiederholung: - Fehlgeschlagene Übertragungen werden automatisch wiederholt - 3 Versuche im Abstand von 15 Minuten - Danach: Benachrichtigung an Admin
Manuelle Wiederholung: 1. Integrations-Dashboard → Fehler-Log 2. Fehler auswählen 3. "Erneut versuchen"
Best Practices
Performance
- Batch-Größe: Max. 1000 Records pro Call
- Zeitfenster: Synchronisation außerhalb der Hauptgeschäftszeiten
- Delta-Sync: Nur geänderte Datensätze übertragen
- Indexierung: SAP-Tabellen sollten geeignet indiziert sein
Datenqualität
- Vollständige Mappings: Alle aktiven Mitarbeiter gemappt
- Validierung: Datenkonsistenz vor Übertragung prüfen
- Reconciliation: Wöchentlicher Abgleich TimeAM ↔ SAP
- Audit-Trail: Alle Übertragungen protokollieren
Sicherheit
- Verschlüsselte Verbindung: TLS 1.2 oder höher
- Least Privilege: SAP-User nur minimale Berechtigungen
- Credential Rotation: Passwörter regelmäßig ändern
- Firewall: Whitelist für IP-Adressen
Customizing
Erweiterungen
Custom Fields: - Mapping zusätzlicher Felder möglich - Kontaktieren Sie den Support
Custom Workflows: - Genehmigungsprozesse - Custom Business Logic - Transformation Rules
Zeitplan anpassen: - Individuelle Sync-Zeitpunkte - Event-basierte Triggers
Support & Wartung
Support-Kanäle
TimeAM-Support: - Kategorie "SAP-Integration" - SLA: 4 Stunden (Enterprise)
SAP-Basis-Team: - Für SAP-seitige Konfiguration - RFC-Destinationen, Berechtigungen
Wartungsfenster
Geplante Wartungen: - Werden 7 Tage vorher angekündigt - Typisch: Sonntags, 02:00-06:00 Uhr - Keine Datenübertragung während Wartung
Updates
TimeAM-Updates: - Quartalweise neue Features - Backward-kompatibel - Release Notes per E-Mail
SAP-Upgrades: - Kompatibilität mit neuen SAP-Releases - Testing vor Produktiv-Nutzung empfohlen
Kosten
Lizenzierung: - SAP-Integration-Modul: Nach Angebot - Setup-Fee: Einmalig - Laufende Kosten: Monatlich, abhängig von Datenvolumen
Implementierung: - Professional Services: Nach Aufwand - Typisch: 40-80 Stunden - Dauer: 6-12 Wochen
Weitere Ressourcen
- SAP Help Portal: help.sap.com
- TimeAM FAQ: FAQ
- Support-Hotline: Siehe Helpdesk
Hinweis: SAP-Integrationen sind komplex und erfordern typischerweise professionelle Implementierung. Kontaktieren Sie unseren Support für ein individuelles Angebot.
Letzte Aktualisierung: Januar 2026