Introduktion till API för löneintegrering

Obs

För att löneintegreringen ska fungera för kunder med hjälp av msror-entiteterna måste ändringssårningen för radversion inaktiveras. Om du vill inaktivera spårning av radversioner kontaktar du Microsofts support för att aktivera förhandsversionen DMFDisableSqlRowVersionCtForCDSVirtualEntity. Om du aktiverar denna förhandsversion inaktiveras ändringsspårning av radversion.

Gäller dessa Dynamics 365-appar:
Human Resources

Detta dokument beskriver API för löneintregrering i Dynamics 365 Human Resources. Med API:t kan du effektivisera kompletta integreringar mellan Personal och associerade lönesystem. Den integrerade erfarenheten startar i Personal med medarbetarprofil, löne- och avdragsinformation och bidragsinformation. När du anställer en medarbetare och anger den nödvändiga profil- och löneinformationen i Personal hämtar lönesystemet denna information i samband med bearbetning av löner. Eventuella uppdateringar av medarbetar- eller löneinformationen kan också användas vid senare lönekörningar.

För att aktivera integreringen lägger Personal till följande komponenter:

• Funktion för att markera en medarbetare som betalningsredo.
• Ett integrations-API som öppnar den nya funktionen för integrering av program.

Microsoft Dataverse

Detta API bygger på Microsoft Dataverse (tidigare Common Data Service). All RESTful-interaktion med denna API sker via webb-API för Microsoft Dataverse, som använder OData. Detta API är en underuppsättning av webb-API för Dataverse. Webb-API för Dataverse definierar egenskaper såsom autentisering, serviceavtal, batch, samtidighetskontroll och felhantering.

Mer allmän information om webb-API för Microsoft Dataverse finns här:

• Vad är Microsoft Dataverse?
• Använd Microsoft Dataverse webb-API
• Microsoft Dataverse utvecklarguide

Dokumentationen innehåller information och utvecklarvägledning för användning av webb-API för Dataverse, bland annat följande ämnen:

• Autentisera till Microsoft Dataverse med hjälp av webb-API:t
• Utföra åtgärder med hjälp av webb-API:t
• Använda ändringsspårning för att synkronisera data med externa system

Virtuella register för Personal i Dataverse

Slutpunkterna för API för löneintegrering använder plattformsfunktionerna för virtuellt register i Microsoft Dataverse. Som standard distribueras inte de virtuella registren och deras associerade API-slutpunkter för Personal-miljöer, vilket låter organisationer avgöra vilka OData-slutpunkter som ska visas för miljön. Om du vill använda API:t måste de virtuella registren för Personal-entiteterna genereras för miljön.

Information om hur du genererar virtuella register för API:et finns i Konfigurera virtuella Dataverse-register.

Datamodell

Följande diagram visar relationer inom API:t. Flera typer har utländska nycklar till andra, befintliga entiteter i Personal som inte visas här. Detta dokument innehåller information om entiteter som är specifika för löneintegreringsscenarier. Det finns emellertid många andra entiteter i webb-API:t för Dataverse för Personal som också kan vara relevanta för din integrering. Vissa av dessa entiteter refereras till i relationer med sekundärnycklar eller navigeringsegenskaper.

Lönemedarbetare och relaterade entiteter

Enheter:

• Lönemedarbetare
• Lönearbetarens adress
• Kompensationsplan med fast lön
• Löneplan för variabel kompensation
• Lönebefattningsjobb
• Lönebefattning

Se även

Generera och granska lönelisteentiteter
Konfigurera Personalparametrar
Konfigurera delade Personalparametrar
Vad är Microsoft Dataverse?
Använd Microsoft Dataverse webb-API