利用者所属登録API

利用者の所属を登録するAPI
APIキーが関連付けされている事業所以外も登録可能です。
法人コードや事業所コードはO0001：事業所情報取得APIなどで取得してください。

以下の条件で、エラーコードEL409000が返却されます。
・既存レコードと、登録する法人コード、事業所コード、ブロックコード、ユニットコード、利用者IDが一致し、かつ、所属期間が重複する

既存レコードはUB0004：利用者所属取得APIで確認できます。
CAREKARTEからの操作では、所属期間が重複する場合があります。

API ID

UB0001

Request URL

user-belong/add
環境 URL
Staging環境 https://stage-api.link.carekarte.jp/user-belong/add
環境 URL
本番環境 https://api.link.carekarte.jp/user-belong/add

HTTPメソッド

POST

リクエスト

ヘッダー

名前 必須 値
Content-Type ○ application/json
authorization ○ tokenサービスで取得した値を設定

ボディ

パラメータ名 物理パラメータ名 型 必須 文字桁数 文字種/形式 仕様
法人コード corpCd String 〇 1桁 半角数字  
事業所コード officeCd String 〇 2桁 半角数字  
ブロックコード blockCd String 〇 2桁 半角数字  
ユニットコード unitCd String 〇 3桁 半角数字  
利用者ID userId String 〇 10桁 半角数字 U0007　事業所所属利用者一覧取得API等から取得してください。
所属開始日 sdate String 〇   YYYY-MM-DD  
所属終了日 edate String     YYYY-MM-DD パラメータをリクエストしない場合、未定として登録されます。
職員ID staffId String 〇 10桁 半角数字 ST0003　事業所所属職員一覧取得API等から取得してください。
CAREKAETE上では基本情報の更新者として保存されます。

サンプルデータ

{
    "corpCd": "1",
    "officeCd": "01",
    "blockCd": "01",
    "unitCd": "001",
    "userId": "0000000001",
    "sdate": "2021-10-01",
    "edate": "2023-06-24",
    "staffId":"0000000001"
}

レスポンス

ボディ

パラメータ名 物理パラメータ名 型 文字桁数 文字種/形式 仕様
利用者番号 userId String 10桁   リクエストしたuserIdが返却されます

 

利用者所属の登録に成功した際のサンプルデータ

{
    "userId": "0000000001"
}

エラーレスポンス

メニューのエラーレスポンスを参照してください

連携イメージ(CAREKARTE)

イメージ画像はCAREKARTEで所属を確認できる画面です。