データ連携/(新)PCAクラウド給与のAPI連携方法
機能概要
PCAクラウド給与で管理している従業員情報・給与勤怠情報をHRBrainに連携できます。
また、HRBrainで管理している従業員情報をPCAクラウド給与に連携できます。
連携の定期実行を設定することで、毎日AM 2:00 ~ AM 5:00頃にデータの登録・更新を行うため、CSV連携や手入力などの作業コストを削減することができます。
目次
連携項目について
設定・操作方法
注意事項
連携項目について
従業員情報と給与勤怠情報の2種類のデータが連携可能です。
| データ種類 | 項目種類 | 連携方向 |
| 従業員情報 | 【固定のマッピング項目】 ・連携元と連携先が固定されている ・連携する場合は、チェックボックスをオンにする |
・HRBrain → PCAクラウド給与 ・PCAクラウド給与 → HRBrain |
| 【選択可能なマッピング項目】 ・ 連携先と連携元の項目それぞれを自由に選択できる ・HRBrainへの連携時のみ、氏・名のマッピングが必須になる (PCAクラウド給与側の項目は自由に選択可能) |
・HRBrain → PCAクラウド給与 ・PCAクラウド給与 → HRBrain |
|
| 【グループのマッピング項目】 ・ HRBrainの個別追加項目の中から選択できる ・従業員毎に持つ情報の内、先頭(最新)から10個目までを連携できる |
・HRBrain → PCAクラウド給与 | |
| 給与勤怠情報 | 【選択可能なマッピング項目】 ・ HRBrainの定期更新項目の中から選択できる ・PCAクラウド給与の前月分の給与勤怠項目をHRBrainの定期更新項目に連携できる |
・PCAクラウド給与 → HRBrain |
⚠️注意点
“PCAクラウド給与 → HRBrain”と”HRBrain → PCAクラウド給与”の2つの連携を同時に設定した場合、
定期実行ON、かつメンバー情報の自動削除ONの状態ではデータ不整合になる可能性があります。
従業員情報
■固定のマッピング項目
- HRBrainとPCAクラウド給与のどちらからの連携でも連携項目が固定になります
- データ照合条件を含む詳細は下表をご確認ください
| PCAクラウド給与項目名 | HRBrain項目名 | 照合条件 |
| 所属 | 組織情報>主部署 | 名称で一致判定(コードと階層は一致不要) |
| 役職 | 組織情報>役職・職位 | 名称で一致判定 |
| 就労状況 | 組織情報>在籍状況 | 下記3つのみ連携可能(下記以外はエラー表示される) ・在籍中 ・休職中 ・退職済み |
■選択可能なマッピング項目
- 一部項目を除き自由にマッピング設定が可能です
- PCAクラウド給与→HRBrainへの連携時のみ、HRBrain側のプロフィール>氏・プロフィール>名のマッピング設定が必須になります(PCAクラウド給与側のマッピング項目は自由に選択可能です)
- HRBrain→PCAクラウド給与への連携時のみ、PCAクラウド給与側の個人情報>社員氏名(姓)のマッピング設定が必須になります(HRBrain側のマッピング項目は自由に選択可能です)
- 下記はPCAクラウド給与の従業員項目一覧です
社員コード
個人情報>社員氏名(姓)
個人情報>社員氏名(名)
個人情報>社員氏名フリガナ(姓)
個人情報>社員氏名フリガナ(名)
個人情報>生年月日
個人情報>性別
就労情報>入社日
連絡先情報>個人用メールアドレス1
連絡先情報>会社用メールアドレス1
年末調整マスター>合計表提出
年末調整マスター>扶養控除申告書
年末調整マスター>所得金額調整控除申告書
年末調整マスター>基礎控除申告書
年末調整マスター>旧生命保険料
年末調整マスター>新生命保険料
年末調整マスター>介護医療保険料
年末調整マスター>旧個人年金保険料
年末調整マスター>新個人年金保険料
年末調整マスター>地震保険料
年末調整マスター>旧長期損害保険料
年末調整マスター>国民年金保険料
年末調整マスター>国民年金基金加入者掛金
年末調整マスター>その他申告による保険料等
年末調整マスター>独立行政法人中小企業基盤整備機構の共済契約の掛金
年末調整マスター>個人型又は企業型年金加入者掛金
年末調整マスター>心身障害者扶養共済制度に関する契約の掛金
年末調整マスター>給与等からの控除分のうち小規模企業共済等掛金の金額
年末調整マスター>住宅借入金等特別控除額
年末調整マスター>総支給額からの調整額
年末調整マスター>税額からの調整額
年末調整マスター>社会保険からの調整額
年末調整マスター>扶養控除等申告書 従たる給与についての扶養控除等申告書の提出
年末調整マスター>扶養控除等申告書 配偶者
年末調整マスター>扶養控除等申告書 障害者等の内容
年末調整マスター>扶養控除等申告書 障害者等 異動月日及び事由
年末調整マスター>住宅借入金等1回目 居住開始年月日
年末調整マスター>住宅借入金等1回目 控除の種類
年末調整マスター>住宅借入金等1回目 借入金等年末残高
年末調整マスター>住宅借入金等1回目 特定取得
年末調整マスター>住宅借入金等2回目 居住開始年月日
年末調整マスター>住宅借入金等2回目 控除の種類
年末調整マスター>住宅借入金等2回目 借入金等年末残高
年末調整マスター>住宅借入金等2回目 特定取得
年末調整マスター>住宅借入金等3回目 居住開始年月日
年末調整マスター>住宅借入金等3回目 控除の種類
年末調整マスター>住宅借入金等3回目 借入金等年末残高
年末調整マスター>住宅借入金等3回目 特定取得
年末調整マスター>本支店等区分番号
年末調整マスター>住民税徴収区分
年末調整マスター>青色専従区分
年末調整マスター>条約課税免除区分
住所情報>世帯主
住所情報>続柄
■グループのマッピング項目
- HRBrain→PCAクラウド給与への連携時のみマッピング設定が可能です
- HRBrainの社員名簿で設定した個別追加項目の中から連携したい項目を選択し、従業員毎に持つ情報の最も古いもの(ブロック1)から順に10個目(ブロック10)までを連携可能です
- 個別追加項目の作成方法についてはこちらをご確認ください
- 下記はPCAクラウド給与のグループマッピング可能な従業員項目一覧です
社員コード
個人情報>社員氏名(姓)
個人情報>社員氏名(名)
個人情報>社員氏名フリガナ(姓)
個人情報>社員氏名フリガナ(名)
個人情報>生年月日
個人情報>性別
就労情報>入社日
連絡先情報>個人用メールアドレス1
連絡先情報>会社用メールアドレス1
年末調整マスター>合計表提出
年末調整マスター>扶養控除申告書
年末調整マスター>所得金額調整控除申告書
年末調整マスター>基礎控除申告書
年末調整マスター>旧生命保険料
年末調整マスター>新生命保険料
年末調整マスター>介護医療保険料
年末調整マスター>旧個人年金保険料
年末調整マスター>新個人年金保険料
年末調整マスター>地震保険料
年末調整マスター>旧長期損害保険料
年末調整マスター>国民年金保険料
年末調整マスター>国民年金基金加入者掛金
年末調整マスター>その他申告による保険料等
年末調整マスター>独立行政法人中小企業基盤整備機構の共済契約の掛金
年末調整マスター>個人型又は企業型年金加入者掛金
年末調整マスター>心身障害者扶養共済制度に関する契約の掛金
年末調整マスター>給与等からの控除分のうち小規模企業共済等掛金の金額
年末調整マスター>住宅借入金等特別控除額
年末調整マスター>総支給額からの調整額
年末調整マスター>税額からの調整額
年末調整マスター>社会保険からの調整額
年末調整マスター>扶養控除等申告書 従たる給与についての扶養控除等申告書の提出
年末調整マスター>扶養控除等申告書 配偶者
年末調整マスター>扶養控除等申告書 障害者等の内容
年末調整マスター>扶養控除等申告書 障害者等 異動月日及び事由
年末調整マスター>住宅借入金等1回目 居住開始年月日
年末調整マスター>住宅借入金等1回目 控除の種類
年末調整マスター>住宅借入金等1回目 借入金等年末残高
年末調整マスター>住宅借入金等1回目 特定取得
年末調整マスター>住宅借入金等2回目 居住開始年月日
年末調整マスター>住宅借入金等2回目 控除の種類
年末調整マスター>住宅借入金等2回目 借入金等年末残高
年末調整マスター>住宅借入金等2回目 特定取得
年末調整マスター>住宅借入金等3回目 居住開始年月日
年末調整マスター>住宅借入金等3回目 控除の種類
年末調整マスター>住宅借入金等3回目 借入金等年末残高
年末調整マスター>住宅借入金等3回目 特定取得
年末調整マスター>本支店等区分番号
年末調整マスター>住民税徴収区分
年末調整マスター>青色専従区分
年末調整マスター>条約課税免除区分
住所情報>世帯主
住所情報>続柄
給与勤怠情報
■選択可能なマッピング項目
- PCAクラウド給与の前月分の給与勤怠情報をHRBrainの定期更新項目に連携することが可能です
- 定期更新項目はHRBrain側で事前に作成しておく必要があります(定期更新項目の作成方法についてはこちらをご確認ください)
- 下記はPCAクラウド給与の給与勤怠項目一覧です
給与計算期間>開始/終了日
給与計算期間>開始日
給与計算期間>終了日
賞与計算期間>開始/終了日
賞与計算期間>開始日
賞与計算期間>終了日
システム定義勤怠>要勤務日数
システム定義勤怠>要勤務時間 (分)
システム定義勤怠>要勤務時間 (時間)
システム定義勤怠>出勤日数
システム定義勤怠>出勤時間 (分)
システム定義勤怠>出勤時間 (時間)
システム定義勤怠>事故欠勤日数
システム定義勤怠>病欠日数
システム定義勤怠>代休特休日数
システム定義勤怠>休日出勤日数
システム定義勤怠>有休消化日数
システム定義勤怠>有休残日数
システム定義勤怠>残業時間平日普通 (分)
システム定義勤怠>残業時間平日深夜 (分)
システム定義勤怠>残業時間休日普通 (分)
システム定義勤怠>残業時間休日深夜 (分)
システム定義勤怠>残業時間法定休日普通 (分)
システム定義勤怠>残業時間法定休日深夜 (分)
システム定義勤怠>残業時間平日普通 (時間)
システム定義勤怠>残業時間平日深夜 (時間)
システム定義勤怠>残業時間休日普通 (時間)
システム定義勤怠>残業時間休日深夜 (時間)
システム定義勤怠>残業時間法定休日普通 (時間)
システム定義勤怠>残業時間法定休日深夜 (時間)
システム定義勤怠>遅刻早退回数
システム定義勤怠>遅刻早退時間 (分)
システム定義勤怠>遅刻早退時間 (時間)
システム定義勤怠>有休日数消化
システム定義勤怠>有休時間消化 (分)
システム定義勤怠>有休時間消化 (時間)
システム定義勤怠>有休日数残
システム定義勤怠>有休時間残
システム定義勤怠>有休可能時間
システム定義勤怠>残業時間普通45下 (分)
システム定義勤怠>残業時間普通45超 (分)
システム定義勤怠>残業時間普通60超 (分)
システム定義勤怠>残業時間普通代休 (分)
システム定義勤怠>残業時間深夜45下 (分)
システム定義勤怠>残業時間深夜45超 (分)
システム定義勤怠>残業時間深夜60超 (分)
システム定義勤怠>残業時間深夜代休 (分)
システム定義勤怠>残業時間休普45下 (分)
システム定義勤怠>残業時間休普45超 (分)
システム定義勤怠>残業時間休普60超 (分)
システム定義勤怠>残業時間休普代休 (分)
システム定義勤怠>残業時間休深45下 (分)
システム定義勤怠>残業時間休深45超 (分)
システム定義勤怠>残業時間休深60超 (分)
システム定義勤怠>残業時間休深代休 (分)
システム定義勤怠>残業時間普通45下 (時間)
システム定義勤怠>残業時間普通45超 (時間)
システム定義勤怠>残業時間普通60超 (時間)
システム定義勤怠>残業時間普通代休 (時間)
システム定義勤怠>残業時間深夜45下 (時間)
システム定義勤怠>残業時間深夜45超 (時間)
システム定義勤怠>残業時間深夜60超 (時間)
システム定義勤怠>残業時間深夜代休 (時間)
システム定義勤怠>残業時間休普45下 (時間)
システム定義勤怠>残業時間休普45超 (時間)
システム定義勤怠>残業時間休普60超 (時間)
システム定義勤怠>残業時間休普代休 (時間)
システム定義勤怠>残業時間休深45下 (時間)
システム定義勤怠>残業時間休深45超 (時間)
システム定義勤怠>残業時間休深60超 (時間)
システム定義勤怠>残業時間休深代休 (時間)
システム定義支給(給与)>基本給
システム定義支給(給与)>残業手当平日普通
システム定義支給(給与)>残業手当平日深夜
システム定義支給(給与)>残業手当休日普通
システム定義支給(給与)>残業手当休日深夜
システム定義支給(給与)>残業手当法定休日普通
システム定義支給(給与)>残業手当法定休日深夜
システム定義支給(給与)>非課税通勤費
システム定義支給(給与)>課税通勤費
システム定義支給(給与)>遅刻早退控除
システム定義支給(給与)>欠勤控除
システム定義支給(給与)>遡及差額
システム定義支給(給与)>残業手当普通45下
システム定義支給(給与)>残業手当普通45超
システム定義支給(給与)>残業手当普通60超
システム定義支給(給与)>残業手当普通代休
システム定義支給(給与)>残業手当深夜45下
システム定義支給(給与)>残業手当深夜45超
システム定義支給(給与)>残業手当深夜60超
システム定義支給(給与)>残業手当深夜代休
システム定義支給(給与)>残業手当休普45下
システム定義支給(給与)>残業手当休普45超
システム定義支給(給与)>残業手当休普60超
システム定義支給(給与)>残業手当休普代休
システム定義支給(給与)>残業手当休深45下
システム定義支給(給与)>残業手当休深45超
システム定義支給(給与)>残業手当休深60超
システム定義支給(給与)>残業手当休深代休
システム定義控除(給与)>健康保険料被保険者
システム定義控除(給与)>健康保険料事業主
システム定義控除(給与)>基本保険料被保険者
システム定義控除(給与)>基本保険料事業主
システム定義控除(給与)>特定保険料被保険者
システム定義控除(給与)>特定保険料事業主
システム定義控除(給与)>介護保険料被保険者
システム定義控除(給与)>介護保険料事業主
システム定義控除(給与)>厚生年金保険料被保険者
システム定義控除(給与)>厚生年金保険料事業主
システム定義控除(給与)>厚生年金基金保険料被保険者
システム定義控除(給与)>厚生年金基金保険料事業主
システム定義控除(給与)>確定拠出年金掛金
システム定義控除(給与)>雇用保険料
システム定義控除(給与)>社会保険調整額
システム定義控除(給与)>所得税
システム定義控除(給与)>住民税
システム定義控除(給与)>税調整
システム定義合計(給与)>通勤費計
システム定義合計(給与)>課税支給合計
システム定義合計(給与)>非課税支給合計
システム定義合計(給与)>総支給額合計
システム定義合計(給与)>社会保険料合計
システム定義合計(給与)>課税対象額
システム定義合計(給与)>現物支給
システム定義合計(給与)>控除計
システム定義合計(給与)>控除合計
システム定義合計(給与)>累積課税額
システム定義合計(給与)>日給・時給単価
システム定義合計(給与)>前月調整残
システム定義合計(給与)>端数合計
システム定義合計(給与)>当月調整額
システム定義合計(給与)>調整後支給額
システム定義合計(給与)>支払1
システム定義合計(給与)>支払2
システム定義合計(給与)>支払3
システム定義合計(給与)>差引支給
システム定義合計(給与)>銀行振込
システム定義合計(給与)>郵便振込
システム定義合計(給与)>現金支給
システム定義合計(給与)>雇用保険対象額
システム定義合計(給与)>現物の額 非固定的賃金
システム定義合計(給与)>現物の額 固定的賃金
システム定義合計(給与)>通貨の額 非固定的賃金
システム定義合計(給与)>通貨の額 固定的賃金
システム定義合計(給与)>現物の通勤費
システム定義合計(給与)>通貨の通勤費
システム定義合計(給与)>健康保険標準報酬月額
システム定義合計(給与)>厚生年金標準報酬月額
システム定義合計(給与)>健康保険標準報酬月額(翌月分)
システム定義合計(給与)>厚生年金標準報酬月額(翌月分)
システム定義合計(給与)>労災保険対象額
システム定義合計(給与)>残業基準調整額
システム定義合計(給与)>減額基準調整額
システム定義基礎(賞与)>前月課税額
システム定義基礎(賞与)>賞与税率
システム定義基礎(賞与)>基準給与
システム定義基礎(賞与)>賞与倍率
システム定義基礎(賞与)>賞与試算額
システム定義支給(賞与)>賞与額
システム定義支給(賞与)>遡及差額
システム定義控除(賞与)>健康保険料被保険者
システム定義控除(賞与)>健康保険料事業主
システム定義控除(賞与)>基本保険料被保険者
システム定義控除(賞与)>基本保険料事業主
システム定義控除(賞与)>特定保険料被保険者
システム定義控除(賞与)>特定保険料事業主
システム定義控除(賞与)>介護保険料被保険者
システム定義控除(賞与)>介護保険料事業主
システム定義控除(賞与)>厚生年金保険料被保険者
システム定義控除(賞与)>厚生年金保険料事業主
システム定義控除(賞与)>厚生年金基金保険料被保険者
システム定義控除(賞与)>厚生年金基金保険料事業主
システム定義控除(賞与)>雇用保険料
システム定義控除(賞与)>社会保険調整額
システム定義控除(賞与)>所得税
システム定義控除(賞与)>税調整
システム定義合計(賞与)>課税支給合計
システム定義合計(賞与)>非課税支給合計
システム定義合計(賞与)>総支給額合計
システム定義合計(賞与)>社会保険料合計
システム定義合計(賞与)>課税対象額
システム定義合計(賞与)>現物支給
システム定義合計(賞与)>控除計
システム定義合計(賞与)>控除合計
システム定義合計(賞与)>累積課税額
システム定義合計(賞与)>賞与調整
システム定義合計(賞与)>調整後支給額
システム定義合計(賞与)>支払1
システム定義合計(賞与)>支払2
システム定義合計(賞与)>支払3
システム定義合計(賞与)>差引支給
システム定義合計(賞与)>銀行振込
システム定義合計(賞与)>郵便振込
システム定義合計(賞与)>現金支給
システム定義合計(賞与)>雇用保険対象額
システム定義合計(賞与)>現物の額 固定的賃金
システム定義合計(賞与)>通貨の額 固定的賃金
システム定義合計(賞与)>健康保険標準賞与額
システム定義合計(賞与)>厚生年金標準賞与額
システム定義合計(賞与)>労災保険対象額
マッピング設定の注意点
-
HRBrain→PCAクラウド給与連携の際に、PCAクラウド給与に同名の所属や役職が複数存在する場合、
連携先の判別が不可のためエラーになります。 - PCAクラウド給与→HRBrain連携の場合、PCAクラウド給与の管理画面で給与一覧の入力列が◯になっている必要があります
- PCAクラウド給与の「給与計算期間>開始/終了日」と「給与計算期間>開始日」、「給与計算期間>終了日」は、PCAクラウド給与の管理画面で給与体系IDを設定しないと連携されません
- PCAクラウド給与→HRBrainのマッピング設定において、日付項目を日付項目以外(文章項目、単文項目など)に連携する場合、「YYYY/MM/DD」ではなく「YYYYMMDD」の8桁の数値で連携されます
- PCAクラウド給与→HRBrainのマッピング設定において、個人情報>性別をプロフィール>性別以外(文章項目、単文項目など)に連携する場合、「1」「2」の数値で連携されます
設定・操作方法
権限設定
開発者向けサイトの以下権限が必要です。
- [外部サービス同士の連携]権限
- [公開API Token設定]権限(Token取得のため)
▷データ連携/開発者向けサイトについて>開発者向けサイト内の権限付与の方法
連携設定
1.[メニュー] > [開発者向けサイト] > [外部サービスとの連携]をクリック
2.[新規連携設定]ボタンを押下し、データ連携方向と連携するサービスを選択
3.[連携設定] > [認証情報設定]でHRBrainとPCAクラウド給与を認証
※HRBrainのトークン発行方法はこちらを参照
4.連携設定の[項目マッピング設定]で連携したい項目を選択し[保存]をクリック
a.PCAクラウド給与→HRBrain連携設定の場合
b.HRBrain→PCAクラウド給与連携設定の場合
⚠️注意点
・連携のキーとなる情報を「従業員番号」か「メールアドレス」で選択可能です
・メンバー情報の自動削除の[有効にする]にチェックを入れた場合、
連携元に存在しないメンバーは連携先から自動で削除されます(PCAクラウド給与→HRBrain連携時のみ)
・PCAクラウド給与の「従業員番号」か「メールアドレス」に一致するメンバーがHRBrainに存在しない場合、
そのメンバーは連携されません
・PCAクラウド給与のアカウントが必要です
設定情報の確認
保存された設定は[開発者向けサイト] > [外部サービスとの連携] > [連携設定]に一覧表示
手動実行
手動でデータ連携を行いたい場合は、[連携実行]ボタンをクリック
※定期実行を有効にすると、AM 2:00 ~ AM 5:00頃に連携実行可能
連携結果の確認
1.連携結果は[開発者向けサイト] > [外部サービスとの連携] > [連携ログ]から確認可能
2.[連携ログ]の「>」をクリックすることで、連携内容の詳細を確認可能(ステータスによる絞り込みも可能)
データの更新がない場合の連携内容詳細は下記
注意事項
PCAクラウド給与の1テナントとHRBrainの1テナントとの連携を想定しており、PCAクラウド給与の複数テナントをHRBrainの1つのテナントへ連携することは想定外のユースケースとなります。
(利用にあたり想定外のエラーが発生する可能性があるため、サポートの対象外となります。)