Introduktion till API för löneintegrering

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 webb-API för Microsoft Dataverse
• Utvecklarguide för Microsoft Dataverse

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 Postman med 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 webb-API för Microsoft Dataverse