| SaaStainerサイトページへ戻る |
お知らせ
2024/07/29 部署連携が正常に動作しない不具合が発生しています。
修正メンテナンス日は確定次第ご連絡します。
2023/07/14 下記にチェックを付けている場合、稀にタイムアウトが発生します。
【連携アプリ＞freee人事労務連携設定＞連携項目設定＞主部署にチェック】
⇒連携アプリの改修が行われるまで
連携項目設定＞主部署のチェックを外し、
主部署は手動でHRBrainに登録をお願いします。
恐れ入りますがよろしくお願いいたします。
目次
■アプリ概要
freee人事労務で管理している従業員情報をHRBrainに連携するアプリです。
一度連携設定した後は、毎日AM03:15時点でfreee人事労務に登録されている情報をHRBrainに登録/更新するため、CSV連携や手入力などの作業コストを削減することができます。
●アプリ機能
●従業員マスタ連携 機能
freee人事労務に登録している従業員情報（主部署、雇用形態等の組織情報を含む様々な情報）を毎日AM03:15にHRBrainへ連携する事ができます。
・マッピング 機能
- 連携のキーとなる情報を「従業員番号」か「メールアドレス」で選ぶことが可能です。
※メールアドレスはfreee人事労務のログインメールアドレスを指します。
- その他項目もHRBrainに連携したい項目のみを設定できるため、HRBrainでは必要ない情報は連携されないようにすることができます。
※freeeの複数事業所をHRBrainの1つのテナントへ連携することは想定外のユースケースとなります。
利用にあたり想定外のエラーが発生する可能性があるため、サポートの対象外となります。
利用についてはお客様のご判断にて確認並びに運用いただきますようお願いいたします。
●おすすめな方
・毎月従業員情報の登録や更新作業（CSV連携、手作業等）が発生している方
・CSV連携するためのデータ形成作業をExcelのマクロ機能などを用いてされている方
・従業員情報のマスタは奉行クラウドとして管理したい方
●利用にあたっての注意
・HRBrainアカウント（開発者向けサイト権限付与）が必要です
・freee人事労務アカウントが必要です
・日次連携となります（毎日AM03:15）
・HRBrainからfreee人事労務へは登録/更新は行われません
・freeeの1事業所とHRBrainの1テナントとの連携を想定しております
| SaaStainerサイトページへ戻る |
■アプリ設定方法/マニュアル
▼利用するにはSaaStainerのアカウントが必要です
下記リンクからご登録ください
●1. HRBrain上の操作
●2. 連携アプリ上の操作（認証設定）
●3.連携アプリ上の操作（連携設定）
HRBrainのプルダウン項目へ連携する場合は、必ずfreee人事労務の選択肢とHRBrainの選択肢を統一してから連携してください。選択肢が統一で無い場合、エラー発生の原因になります。
●4.その他
※組織プルダウンとは、「3.3.連携項目設定をする」でチェックをつけた組織情報を指します。
連携エラーを防ぐため、freee人事労務側とHRBrain側の組織情報の組織情報コードおよび名称が一致している状態にしてください。
■FAQ
- よくある連携エラーはどのようなケースが多いか
失敗理由が【400, 3, BadRequest】の時
-
-
freee人事労務とHRBrainのプルダウン項目の選択肢に差異がある場合
→HRBrainのプルダウン形式の項目へ連携する場合、HRBrainのプルダウン項目の選択肢にない情報を連携するとエラーが発生します。
足りないもしくは入力値が異なる場合は、同一の選択肢となるよう修正をお願いします。
-
マッピング設定でキーとなる値として選択していた従業員番号もしくはメールアドレスをfreee人事労務側で更新した場合
→freee人事労務側で修正しても自動連携されず、また、エラーが発生します。
お手数おかけいたしますが、手動でHRBrainの情報を修正してください。
-
freee人事労務とHRBrainのプルダウン項目の選択肢に差異がある場合
失敗理由が【401, 1, Unauthorized】の時
-
-
HRBrainのトークンが有効でない場合
→HRBrainのトークンが有効でない場合があります。
トークンが削除されていないか確認いただくか、
「1.1.トークンを作成する」及び「2.3.トークンを設定する」の再設定をお願いします。
それでも再発する場合は連携ログの発生時刻とメッセージ内容がわかるスクリーンショットを添付して弊社にお問い合わせください。
-
HRBrainのトークンが有効でない場合
失敗理由が【409, 9, Conflict】の時
もしくは「メールアドレス、従業員番号を使用している従業員がHRBrain上にそれぞれ存在するため、更新対象を特定できませんでした。」の時
-
-
複数名の従業員情報に同一のメールアドレス(共通アドレス等)が入力されている場合
→1従業員1メールアドレスとなるよう修正いただくか、連携項目から削除してください。
-
freee人事労務に入力されている従業員番号もしくはメールアドレスが既にHRBrainに登録されている場合
→重複エラーが発生します。連携ログから失敗で絞り込み、該当の失敗者と同一の従業員番号もしくはメールアドレスがないか確認の上、修正をお願いいたします。
※HRBrainでアカウント登録した後にfreeeと連携しても問題ありません。
-
複数名の従業員情報に同一のメールアドレス(共通アドレス等)が入力されている場合
失敗理由が【429, -, Too Many Requests】【500, 4, Internal Server Error】の時
-
-
一括取り込み処理中にfreee人事労務もしくはHRBrainの項目内容や組織マスタを更新した場合
→一括取り込み中は修正しないようお願いします。
-
一括取り込み処理中にfreee人事労務もしくはHRBrainの項目内容や組織マスタを更新した場合
共通
-
-
「氏」「名」項目が入力されていない、マッピング設定されていない場合
→HRBrainでは「氏」「名」の登録が必須となります。
名も入力し更新をお願いします。
-
メールアドレス内に許容できない文字が存在する場合
→連携できません。下記許容できる範囲で修正してください。
アルファベット : 半角小文字でa～zまでの26文字
数字 :半角で0～9までの10字
記号 :半角で “.”（ピリオド）、“-”（ハイフン）、“_”（アンダーバー）、“+”（プラス）の4種類
-
「氏」「名」項目が入力されていない、マッピング設定されていない場合
- freee人事労務側のマッピング可能な項目が知りたい
下記一覧の項目が連携可能です。
| 基本情報>メールアドレス | 本人情報>性別 |
| 基本情報>従業員番号 | 本人情報>配偶者の有無 |
| 基本情報>従業員名（表示名） | 本人情報>勤労学生かどうか |
| 基本情報>基礎年金番号 | 本人情報>寡夫／寡婦かどうか |
| 基本情報>被保険者番号（雇用保険） | 本人情報>障害者かどうか |
| 基本情報>生年月日 | 社会保険>健康保険に加入しているかどうか |
| 基本情報>入社日 | 社会保険>健康保険の被保険者整理番号 |
| 基本情報>退社日 | 社会保険>標準報酬月額 |
| 本人情報>姓 | 厚生年金保険>厚生年金保険に加入しているかどうか |
| 本人情報>名 | 厚生年金保険>厚生年金保険の被保険者整理番号 |
| 本人情報>姓カナ | 厚生年金保険>標準報酬月額 |
| 本人情報>名カナ | 振込先口座>金融機関名 |
| 本人情報>住民票住所の郵便番号1 | 振込先口座>金融機関名カナ |
| 本人情報>住民票住所の郵便番号2 | 振込先口座>金融機関コード |
| 本人情報>住民票住所の都道府県 | 振込先口座>支店名 |
| 本人情報>住民票住所の市区町村以降の住所 | 振込先口座>支店名カナ |
| 本人情報>住民票住所の市区町村以降の住所カナ | 振込先口座>支店コード |
| 本人情報>電話番号1 | 振込先口座>口座番号 |
| 本人情報>電話番号2 | 振込先口座>口座名義カナ |
| 本人情報>現住所の都道府県 | 振込先口座>預金種類 |
| 本人情報>現住所の住所 | 給与振込方法>給与方式 |
| 本人情報>現住所のカナ | 給与振込方法>基本給 |
| 本人情報>肩書 |
▼SaaStainerへ戻る
| SaaStainerサイトページ |
▼本アプリに関する不明点は下記お問い合わせフォームからご連絡ください
| お問い合わせフォーム |