工资单集成 API 简介

注意

为了使工资单集成适用于使用 mshr 实体的客户，必须禁用行版本更改跟踪。 若要禁用行版本更改跟踪，请联系 Microsoft 支持部门以启用 DMFDisableSqlRowVersionCtForCDSVirtualEntity 外部测试版。 启用此外部测试版将禁用行版本更改跟踪。

适用于以下 Dynamics 365 应用：
Human Resources

本文档介绍了 Dynamics 365 Human Resources 工资单集成 API。 该 API 支持 Human Resources 与合作工资单系统之间的简化端到端集成。 集成体验始于具有员工配置文件、薪金和扣缴以及缴纳信息的 Human Resources。 当您雇用员工并在 Human Resources 中输入所需的配置文件和付款信息时，工资单系统会提取此信息以在处理工资单时使用。 还将提取对员工或付款信息所做的任何更新，以用于以后的付款运行。

为了支持集成，Human Resources 包括以下组件：

• 将员工标记为准备付款的功能。
• 为集成应用程序开启新功能的集成 API。

Microsoft Dataverse

此 API 基于 Microsoft Dataverse（以前称为 Common Data Service）构建。 与此 API 的所有 RESTful 交互都通过使用 OData 的 Microsoft Dataverse Web API 完成。 此 API 是 Dataverse Web API 的子集。 Dataverse Web API 定义诸如身份验证、SLA、批处理、并发控制和错误处理等特征。

有关 Microsoft Dataverse Web API 的更多一般信息，请参阅：

• 什么是 Microsoft Dataverse？
• 使用 Microsoft Dataverse Web API
• Microsoft Dataverse 开发人员指南

本文档包含有关使用 Dataverse Web API 的详细信息和开发人员指南，包括以下主题：

• 使用 Web API 对 Microsoft Dataverse 进行身份验证
• 使用 Web API 执行操作
• 使用更改跟踪将数据与外部系统同步

Dataverse 中适用于 Human Resources 的虚拟表

工资单集成 API 的终结点使用 Microsoft Dataverse 的虚拟表平台功能。 默认情况下，虚拟表及其关联的 API 终结点不针对 Human Resources 环境部署，以让组织可以确定哪些 OData 终结点将为环境公开。 要使用 API，必须为环境生成适用于 Human Resources 实体的虚拟表。

有关为 API 生成虚拟表的信息，请参阅配置 Dataverse 虚拟表。

数据模型

下图说明了 API 中的关系。 若干个类型具有 Human Resources 中其他预先存在的实体的外键，这里没有说明。 本文档提供有关特定于工资单集成场景的实体的信息。 但是，适用于 Human Resources 的 Dataverse Web API 中还有很多其他实体也可能与您的集成相关。 其中某些实体在外键关系或导航属性中引用。

工资单员工和相关实体

实体:

• 工资单员工
• 工资单工作人员地址
• 工资单固定薪酬计划
• 工资单可变薪酬计划
• 工资单职位工作
• 工资单职位

请参阅

生成并查看工资单实体
配置 Human Resources 参数
配置 Human Resources 共享参数
什么是 Microsoft Dataverse？
使用 Microsoft Dataverse Web API