メインコンテンツへスキップ

はじめに

Zenefitsは、人事管理向けにクラウドベースのサービスとしてソフトウェアを提供しており、健康保険に重点を置いています。Zenefits APIの詳細については、ウェブサイト( https://www.zenefits.com/app-connect/ )を参照してください。 Zenefitsアカウントには、Data Centerから接続します。このトピックでは、Zenefitsコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「 コネクターを使用してDataSetを追加する 」で説明しています。

必要条件

Zenefitsアプリケーションに接続してDataSetを作成するには、以下が必要です。
  • Zenefitsからリクエストする範囲のリスト。範囲の詳細については、 https://developers.zenefits.com/docs/permissions を参照してください。
  • Zenefitsアカウントのログインに使用するユーザー名とパスワード

Zenefitsアカウントに接続する

このセクションでは、Zenefitsコネクターページの [認証情報] および [詳細] ペインのオプションについて説明します。このページのほかのペインの項目である [スケジュール設定][DataSetに名前を付け、説明を入力] に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。

[認証情報]ペイン

このペインには、Zenefitsアプリケーションにアクセスするための認証情報を入力するフィールドがあります。下表では、各フィールドに必要な内容を説明しています。

フィールド

説明

Scopes

Zenefitsからリクエストする範囲のリストを入力します。範囲は「+」記号で区切ります。例:

platform+people+companies+locations+departments+employments+banks+company_banks+people.department+people.location+people.manager+people.work_email+people.date_of_birth+people.gender

一部の列の日付は、適切な範囲が追加されたときにのみ返されます。範囲の詳細については、 https://developers.zenefits.com/docs/permissions を参照してください。

有効なZenefits認証情報を入力すると、Zenefits OAuth画面が表示され、Zenefits認証情報の入力を求められます。新しいZenefits DataSetを作成するときはいつでも同じアカウントを使用できます。コネクターアカウントは、Data Centerの [アカウント] タブで管理できます。このタブの詳細については、「 コネクターのユーザーアカウントを管理する 」を参照してください。

[詳細]ペイン

このペインには、メインとなる [Report] メニューのほか、選択したレポートタイプに応じて表示/非表示になる様々なメニューが含まれています。

メニュー

説明

Report

実行するZenefitsレポートを選択します。以下のレポートが利用できます。

Companies

会社のリストを返します。

Company Bank Accounts

特定の会社の、会社銀行口座に関する情報を返します。

Departments

特定の会社の部署のリストを返します。

Employee Bank Accounts

特定の従業員の銀行口座のリストを返します。

Employments

特定の従業員の雇用状況のリストを返します。

Locations

特定の会社の場所のリストを返します。

People

特定の会社の従業員のリストを返します。

Sub Report

目的のサブレポートを選択します。

Company ID

情報を取得する会社を選択します。

Person ID

情報を取得する従業員を選択します。

その他のペイン

スケジュール設定、再試行、オプションの更新など、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。

よくある質問

ZenefitsのベースURLは、https://api.zenefits.com/core/ です。

レポート名

エンドポイントURL

Companies

/companies

Company Bank Accounts

/companies/{会社ID}/company_banks

Departments

/departments

Employees Bank Accounts

/people/{従業員ID}/banks

Employments

/employments

Locations

/locations

People

/people

必要に応じて。
Zenefitsでは、サブスクリプションごとに1分間に100回のAPIコールを呼び出すことができます。