Einführung Lohnintegrations-API

Hinweis

Damit die Gehaltsabrechnungsintegration für Kunden funktioniert, die die mshr-Entitäten verwenden, muss die Nachverfolgung von Zeilenversionsänderungen deaktiviert werden. Um die Nachverfolgung von Zeilenversionsänderungen zu deaktivieren, wenden Sie sich an den Microsoft-Support, um den DMFDisableSqlRowVersionCtForCDSVirtualEntity-Flight zu aktivieren. Durch die Aktivierung dieses Flights wird die Nachverfolgung von Zeilenversionsänderungen deaktiviert.

Gilt für diese Dynamics 365-Apps:
Human Resources

Dieses Dokument beschreibt die Lohnintegrations-API in Dynamics 365 Human Resources. Die API ermöglicht eine optimierte End-to-End-Integration zwischen Human Resources und Partner-Lohnsystemen. Die integrierte Erfahrung beginnt in Human Resources mit dem Mitarbeiterprofil, dem Gehalt und dem Abzug sowie den Beitragsinformationen. Wenn Sie einen Mitarbeiter einstellen und das erforderliche Profil und die Zahlungsinformationen in Human Resources eingeben, ruft das Lohnsystem diese Informationen ab, um sie bei der Lohnabrechnung zu verwenden. Alle am Mitarbeiter oder den Gehaltsinformationen vorgenommenen Aktualisierungen werden auch zur Verwendung in späteren Zahlungsläufen abgerufen.

Um die Integration zu ermöglichen, enthält Human Resources die folgenden Komponenten:

• Funktionalität, um einen Mitarbeiter als „Bereit für Zahlung“ zu kennzeichnen.
• Eine Integrations-API öffnet die neue Funktionalität für die Integration von Anwendungen.

Microsoft Dataverse

Diese API basiert auf Microsoft Dataverse (früher Common Data Service). Alle RESTful-Interaktionen mit dieser API erfolgen über die Microsoft Dataverse-Web-API, die OData verwendet. Diese API ist eine Teilmenge der Dataverse-Web-API. Die Dataverse-Web-API definiert Merkmale wie Authentifizierung, SLAs, Stapelverarbeitung, Parallelitätskontrolle und Fehlerbehandlung.

Weitere allgemeine Informationen zur Microsoft Dataverse-Web-API finden Sie unter:

• Was ist Microsoft Dataverse?
• Verwenden der Microsoft Dataverse-Web-API
• Microsoft Dataverse-Entwicklerhandbuch

Diese Dokumentation enthält Details und Entwickleranleitungen für die Verwendung der Dataverse Web-API, einschließlich der folgenden Themen:

• Authentifizierung bei Microsoft Dataverse mit der Web-API
• Vorgänge mit der Web-API ausführen
• Die Änderungsverfolgung zum Synchronisieren von Daten mit externen Systemen verwenden

Virtuelle Tabellen für Human Resources in Dataverse

Die Endpunkte für die Lohnintegrations-API verwenden die Funktionen der Plattform für virtuelle Tabellen von Microsoft Dataverse. Standardmäßig werden die virtuellen Tabellen und die zugehörigen API-Endpunkte nicht für Human Resources-Umgebungen bereitgestellt, sodass Unternehmen bestimmen können, welche OData-Endpunkte für die Umgebung verfügbar gemacht werden. Um die API verwenden zu können, müssen die virtuellen Tabellen für die Personalentitäten für die Umgebung generiert werden.

Informationen zum Generieren der virtuellen Tabellen für die API finden Sie unter Konfigurieren von virtuellen Dataverse-Tabellen.

Datenmodell

Das folgende Diagramm veranschaulicht die Beziehungen innerhalb der API. Einige Typen verfügen über Fremdschlüssel für andere bereits vorhandene Entitäten in Human Resources, die hier nicht dargestellt sind. Dieses Dokument enthält Informationen zu Entitäten, die für die Lohnintegrationsszenarien spezifisch sind. Es gibt jedoch viele andere Entitäten in der Dataverse-Web-API für Human Resources, die auch für Ihre Integration relevant sein können. Einige dieser Entitäten werden in Fremdschlüsselbeziehungen oder Navigationseigenschaften referenziert.

Mitarbeiter der Lohnbuchhaltung und verbindene Entitäten

Entitäten:

• Mitarbeiter der Lohnbuchhaltung
• Lohn – Adresse der Arbeitskraft
• Fester Vergütungsplan für Lohnabrechnung
• Variabler Vergütungsplan für Lohnabrechnung
• Lohnpositions-Einzelvorgang
• Lohnposition

Siehe auch

Lohnentitäten generieren und überprüfen
Parameter in Human Resources konfigurieren
Freigegebene Human Resources Parameter konfigurieren
Was ist Microsoft Dataverse?
Verwenden der Microsoft Dataverse-Web-API