Compartilhar via


Introdução à API de integração da folha de pagamento

Observação

Para que a integração da folha de pagamento funcione para clientes que usam as entidades mshr, o controle de alterações de versão de linha deve estar desabilitado. Para desabilitar o controle de alterações de versão de linha, contate o suporte da Microsoft para disponibilizar a versão piloto DMFDisableSqlRowVersionCtForCDSVirtualEntity. Habilitar essa versão piloto desabilitará o controle de alterações de versão de linha.

Aplica-se a estes aplicativos do Dynamics 365:
Recursos Humanos

Este documento descreve a API de integração da folha de pagamento do Dynamics 365 Human Resources. A API permite integrações completas simplificadas entre o Human Resources e sistemas de folha de pagamento de parceiros. A experiência integrada começa em Human Resources com o perfil do funcionário, salário e dedução e informações de contribuição. Quando você contrata um funcionário e insere as informações necessárias sobre o perfil e o pagamento em Human Resources, o sistema de folha de pagamento recebe essas informações para usar ao processar a folha de pagamento. As atualizações feitas nas informações do funcionário ou do pagamento também são extraídas para uso em execuções de pagamento futuras.

Fluxo de integração da folha de pagamento.

Para habilitar a integração, o Human Resources inclui os seguintes componentes:

Microsoft Dataverse

Esta API foi desenvolvida com base no Microsoft Dataverse (antes conhecido como Common Data Service). Toda a interação RESTful com essa API é realizada por meio da API Web do Microsoft Dataverse, que usa OData. Essa API é um subconjunto da API Web do Dataverse. A API Web do Dataverse define características como autenticação, SLAs, lote, controle de simultaneidade e tratamento de erros.

Para obter mais informações gerais sobre a API Web do Microsoft Dataverse, consulte:

Esta documentação inclui detalhes e orientações para o desenvolvedor sobre o uso da API Web do Dataverse, incluindo os seguintes tópicos:

Tabelas virtuais para o Human Resources no Dataverse

Os pontos de extremidade para a API de integração da folha de pagamento usam os recursos da plataforma de tabela virtual do Microsoft Dataverse. Por padrão, as tabelas virtuais e os pontos de extremidade da API associados não são implantados para ambientes do Human Resources, permitindo que organizações determinem quais pontos de extremidade OData serão expostos para o ambiente. Para usar a API, as tabelas virtuais de entidades do Human Resources devem ser geradas para o ambiente.

Para obter informações sobre como gerar as tabelas virtuais da API, consulte Configurar tabelas virtuais do Dataverse.

Modelo de dados

O diagrama a seguir ilustra relacionamentos na API. Vários tipos têm chaves estrangeiras para outras entidades preexistentes no Human Resources que não estão ilustradas aqui. Este documento fornece informações sobre entidades específicas para cenários de integração da folha de pagamento. No entanto, há várias outras entidades na API Web do Dataverse para o Human Resources que também podem ser relevantes para sua integração. Algumas dessas entidades são referenciadas em relações de chave estrangeira ou propriedades de navegação.

Modelo de dados de API de integração da folha de pagamento.

Entidades:

Consulte também

Gerar e revisar entidades da folha de pagamento
Configurar parâmetros do Human Resources
Configurar parâmetros compartilhados do Human Resources
O que é o Microsoft Dataverse?
Use a API Web do Microsoft Dataverse