Introduzione all'API di integrazione retribuzioni
Nota
Affinché l'integrazione della gestione stipendi funzioni per i clienti che utilizzano entità mshr, il rilevamento delle modifiche alla versione della riga deve essere disabilitato. Per disabilitare il rilevamento delle modifiche alla versione delle righe, contattare il supporto tecnico Microsoft per abilitare la diistribuzione in anteprima DMFDisableSqlRowVersionCtForCDSVirtualEntity. L'abilitazione di questa diistribuzione in anteprima disabiliterà il rilevamento delle modifiche alla versione della riga.
Si applica a queste app Dynamics 365:
Human Resources
Questo documento descrive l'API di integrazione retribuzioni di Dynamics 365 Human Resources. L'API consente integrazioni end-to-end ottimizzate tra Human Resources e i sistemi di gestione delle retribuzioni dei partner. L'esperienza integrata inizia in Human Resources con il profilo del dipendente, lo stipendio e le detrazioni e le informazioni sui contributi. Quando si assume un dipendente e si immettono il profilo richiesto e le informazioni sulla retribuzione in Human Resources, il sistema delle retribuzioni estrae queste informazioni per utilizzarle durante l'elaborazione delle retribuzioni. Anche gli eventuali aggiornamenti alle informazioni sul dipendente o sulle retribuzioni vengono estratti per essere utilizzati nei cicli di pagamenti successivi.
Per abilitare l'integrazione, Human Resources include i seguenti componenti:
- Funzionalità per contrassegnare un dipendente come Pronto per il pagamento.
- Un'API di integrazione che apre le nuove funzionalità alle applicazioni di integrazione.
Microsoft Dataverse
Questa API è creata su Microsoft Dataverse (in precedenza Common Data Service). Tutta l'interazione RESTful con questa API viene eseguita tramite l'API Web Microsoft Dataverse, che utilizza OData. Questa API è un sottoinsieme di API Web Dataverse. L'API Web Dataverse definisce caratteristiche quali autenticazione, SLA, batch, controllo della concorrenza e gestione degli errori.
Per ulteriori informazioni generali sull'API Web Microsoft Dataverse, vedi:
- Che cos'è Microsoft Dataverse?
- Usa l'API Web Microsoft Dataverse
- Guida per gli sviluppatori Microsoft Dataverse
Questa documentazione include dettagli e indicazioni per sviluppatori per l'utilizzo dell'API web di Dataverse, inclusi i seguenti argomenti:
- Autenticare in Microsoft Dataverse con l'API Web
- Eseguire operazioni utilizzando l'API Web
- Utilizzare il rilevamento delle modifiche per sincronizzare i dati con sistemi esterni
Tabelle virtuali per Human Resources in Dataverse
Gli endpoint per l'API di integrazione retribuzioni utilizzano le funzionalità della piattaforma di tabelle virtuali di Microsoft Dataverse. Per impostazione predefinita, le tabelle virtuali e gli endpoint API associati non vengono distribuiti per gli ambienti Human Resources, consentendo alle organizzazioni di determinare quali endpoint OData saranno esposti per l'ambiente. Per utilizzare l'API, le tabelle virtuali per le entità Human Resources devono essere generate per l'ambiente.
Per informazioni sulla generazione delle tabelle virtuali per l'API, vedi Configura tabelle virtuali Dataverse.
Modello dati
Nel diagramma riportato di seguito vengono illustrate le relazioni all'interno dell'API. Diversi tipi hanno chiavi esterne per altre entità preesistenti in Human Resources che non sono illustrate qui. Questo documento fornisce informazioni sulle entità specifiche per gli scenari di integrazione delle retribuzioni. Tuttavia, ci sono molte altre entità nell'API Web di Dataverse per Human Resources potrebbe anche essere rilevante per la tua integrazione. Alcune di queste entità sono referenziate in relazioni di chiavi esterne o proprietà di navigazione.
Dipendente retribuzioni e entità correlate
Entità:
- Dipendente retribuzioni
- Indirizzo lavoratore retribuzioni
- Piano di retribuzione fissa retribuzioni
- Piano di retribuzione variabile retribuzioni.
- Mansione posizione di retribuzione
- Posizione di retribuzione
Vedere anche
Generare ed esaminare le entità retribuzioni
Configurare i parametri di Human Resources
Configurare i parametri condivisi di Human Resources
Che cos'è Microsoft Dataverse?
Usa l'API Web Microsoft Dataverse