目次
・処理の流れ
・各ステップの詳細
１．接続情報の確認
２．事業所データの同期
３．部署データの同期
４．従業員データの同期
・処理結果
・注意事項
・マッピング表
処理の流れ
PathosLogosとmedimentの連携処理は下記の流れで実施されます。
接続情報の確認: PathosLogosへの接続情報を取得します。
事業所データの同期: PathosLogosの事業所をmedimentに取り込みます。
部署データの同期: PathosLogosの部署をmedimentに取り込みます。
従業員データの同期: PathosLogosの従業員をmedimentに取り込みます。
各ステップの詳細
連携処理の詳細は下記の通りです。
1.接続情報の確認
項目 | 詳細 |
取得情報 | PathosLogosへの接続情報（クライアントID、シークレット、APIキー）を取得します。 |
エラー処理 | 接続情報が設定されていない場合はエラーとなり、処理を中断します。 |
2. 事業所データの同期
PathosLogosに登録されている事業所をmedimentに取り込みます。
条件 | 動作 |
同じ名前の事業所がmedimentに存在する | 既存の事業所情報を更新 |
同じ名前の事業所がmedimentに存在しない | 新規に事業所を作成 |
3. 部署データの同期
PathosLogosに登録されている部署をmedimentに取り込みます。
部署の親子関係（階層構造）も自動的に設定されます。
条件 | 動作 |
同じ名前の部署がmedimentに存在する | 既存の部署情報を更新 |
同じ名前の部署がmedimentに存在しない | 新規に部署を作成 |
4. 従業員データの同期
PathosLogosに登録されている従業員をmedimentに取り込みます。
取り込む従業員情報
氏名（漢字・カナ）
社員番号
メールアドレス
生年月日、性別
所属事業所、所属部署
入社日、退職日
雇用形態、役職
住所（都道府県・市区町村）
既存従業員との照合方法（優先度順）
優先度 | 照合条件 | 動作 |
1 | 社員番号が一致 | 既存の従業員情報を更新 |
2 | メールアドレス＋氏名が一致 | 既存の従業員情報を更新 |
- | どちらも一致しない | 新規に従業員を作成 |
入退社の処理
入社日が設定されている場合：「入社予定」ラベルを付与
退職日が設定されている場合：「退社予定」ラベルを付与
退職日が過去の日付の場合：即座に退職済みとして処理
取り込み対象外となるケース
処理結果
処理完了後、以下の情報がログとして記録されます。
項目 | 内容 |
targets（成功） | 正常に取り込まれたデータ |
skips（スキップ） | 条件を満たさず取り込まれなかったデータ |
errors（エラー） | エラーが発生したデータ |
注意事項
・グループ会社連携は未対応: PathosLogosに複数の会社が登録されている場合は処理できません。
・同期は片方向: PathosLogos → mediment の取り込みのみです。
medimentでの変更はPathosLogosに反映されません。
・データの上書き: 同一従業員として照合された場合、PathosLogosに登録されている情報で、medimentの情報が上書きされます。
マッピング表
基本情報
PathosLogos項目名 | mediment項目名 | 説明 | 文字数制限 |
code | local_id | 社員番号 | 100文字 |
lastNameKanji | last_name_kanji | 姓（漢字） | 100文字 |
firstNameKanji | first_name_kanji | 名（漢字） | 100文字 |
lastNameKana | last_name_kana | 姓（カナ） | 100文字 |
firstNameKana | first_name_kana | 名（カナ） | 100文字 |
lastNameAlphabet | last_name_alphabet | 姓（ローマ字） | 100文字 |
firstNameAlphabet | first_name_alphabet | 名（ローマ字） | 100文字 |
email | email_address | メールアドレス | 200文字 |
otherEmail | other_email_address | その他メールアドレス | 200文字 |
個人情報
PathosLogos項目名 | mediment項目名 | 説明 | 文字数制限 | 備考 |
sex | sex | 性別 | - | "Male"→"男"、"Female"→"女" に変換 |
birthDate | birthday | 生年月日 | - | 日付型 |
nationality | nationality | 国籍 | 50文字 |
|
insuredReferenceNumber | insured_reference_number | 被保険者整理番号 | 20文字 |
|
住所情報
PathosLogos項目名 | mediment項目名 | 説明 | 文字数制限 |
postalCode | postal_code | 郵便番号 | 10文字 |
prefecture | prefecture | 都道府県 | 5文字 |
cityOrCounty | city_or_county | 市区町村 | 50文字 |
townAddress | town_address | 町名・番地 | 100文字 |
apartmentName | apartment_name | 建物名・部屋番号 | 100文字 |
所属・雇用情報
PathosLogos項目名 | mediment項目名 | 説明 | 文字数制限 | 備考 |
officeId | office | 所属事業所 | - | PathosLogos事業所IDから引き当て |
departmentId | department | 所属部署 | - | PathosLogos部署IDから引き当て |
employmentCategory | employment_category, employment_type | 雇用形態 | 各50文字 | マスタから名称を取得 |
jobTitle | job_title | 役職 | 50文字 | マスタから名称を取得 |
入退社情報
PathosLogos項目名 | mediment項目名 | 説明 | 文字数制限 | 備考 |
hireDate | start_date | 入社日 | - | 日付型 |
retirementDate | - | 退職日 | - | 退社予定ラベルとして処理 |
isDeleted | is_deleted, is_removed | 削除フラグ | - | true の場合、removed_at に現在日時を設定 |
事業所情報
PathosLogos項目名 | mediment項目名 | 説明 | 文字数制限 |
name | name | 事業所名 | 50文字 |
todofuken | prefecture | 都道府県 | 10文字 |
jusho1 + jusho2 | address | 住所 | 200文字 |
zipCode | postal_code | 郵便番号 | 20文字 |
jusho1Kana + jusho2Kana | address_kana | 住所カナ | 200文字 |
tel | phone_number | 電話番号 | 20文字 |
部署情報
PathosLogos項目名 | mediment項目名 | 説明 | 文字数制限 | 備考 |
name | name | 部署名 | 100文字 |
|
code | department_code | 部署コード | 10文字 |
|
parentId | parent | 親部署 | - |
|
注意事項
文字数制限を超えた場合: データは自動的に切り詰められます（エラーにはなりません）。
性別の変換: "Male"または"M"は「男」に、"Female"または"W"は「女」に変換されます。
雇用形態・役職: PathosLogos側のマスタから名称を取得してmedimentに設定します。
空の値: PathosLogos側で未設定の項目は、mediment側も更新されません（既存値を保持）。