Введение API интеграции заработной платы

Примечание

Чтобы интеграция зарплаты работала для клиентов, использующих mshr-сущности, отслеживание изменения версии строки должно быть отключено. Чтобы отключить отслеживание изменения версии строки, обратитесь в службу поддержки Microsoft, чтобы включить предоставление доступа DMFDisableSqlRowVersionCtForCDSVirtualEntity. При включении предоставления доступа отслеживание изменения версии строки отключается.

Применяется к следующим приложениям Dynamics 365:
Human Resources

В этом документе описывается API интеграции заработной платы Dynamics 365 Human Resources. API позволяет упростить сквозную интеграцию между модулями Human Resources и партнерскими системами расчета заработной платы. Интегрированный опыт начинает работать в модуле Human Resources с профилем сотрудника, зарплатой и вычетом, а также информацией о вкладе. При приеме на работу сотрудника и вводе требуемого профиля и информации о зарплате в Human Resources система заработной платы извлекает эту информацию для использования при обработке заработной платы. Все обновления, сделанные для сотрудника или информации о зарплате, также извлекаются для использования в последующих запусках платежей.

Для включения интеграции модуль Human Resources включает следующие компоненты:

• Функции для маркировки сотрудника как готового к оплате.
• API интеграции, открывающий новые функции для интеграции приложений.

Microsoft Dataverse

Этот API построен на основе Microsoft Dataverse (ранее Common Data Service). Все взаимодействие RESTful с этим API осуществляется с помощью веб-API Microsoft Dataverse, использующего OData. Этот API является подмножеством веб-API Dataverse. Веб-API Dataverse определяет такие характеристики, как проверка подлинности, соглашения SLA, пакет, управление одновременным доступом и обработка ошибок.

Дополнительные общие сведения о веб-API Microsoft Dataverse см. в разделах:

• Что такое Microsoft Dataverse?
• Использование веб-API Microsoft Dataverse
• Руководство разработчика Microsoft Dataverse

В этой документации содержатся сведения и руководство разработчика по использованию веб-API Dataverse, включая следующие разделы:

• Проверка подлинности в Microsoft Dataverse с веб-API
• Выполнение операций с помощью веб-API
• Отслеживание изменений используется для синхронизации данных с внешними системами

Виртуальные таблицы для Human Resources в Dataverse

Конечные точки для API интеграции заработной платы используют возможности платформы виртуальных таблиц Microsoft Dataverse. По умолчанию виртуальные таблицы и связанные с ними конечные точки API не развертываются для сред Human Resources, позволяя организациям определять, какие конечные точки OData будут доступны для данной среды. Для использования API-интерфейса необходимо создать виртуальные таблицы для сущностей Human Resources для данной среды.

Сведения о создании виртуальных таблиц для API см. в разделе Настройка виртуальных таблиц Dataverse.

Модель данных

На следующей схеме показаны отношения внутри API. У нескольких типов есть внешние ключи для других, ранее существующих сущностей в модуле Human Resources, которые здесь не иллюстрируются. В этом документе приводятся сведения о сущностях, предназначенных специально для сценариев интеграции заработной платы. Однако в веб-API Dataverse для Human Resources имеется множество других сущностей, которые также могут быть связаны с интеграцией. Некоторые из этих сущностей упоминаются в отношениях внешнего ключа или свойствах навигации.

"Сотрудник с заработной платой" и связанные сущности

Объекты:

• Сотрудник с заработной платой
• Адрес работника для зарплаты
• План фиксированной компенсации зарплаты
• План переменных компенсационных выплат для зарплаты
• Должность по позиции для зарплаты
• Позиция зарплаты

См. также

Создание и проверка объектов зарплаты
Настройка параметров Human Resources
Настройка общих параметров Human Resources
Что такое Microsoft Dataverse?
Использование веб-API Microsoft Dataverse