負担割合情報更新API

利用者の負担割合情報を更新するAPI

指定した月時点で有効な負担割合情報を更新するAPIです。

リクエストした内容はCAREKARTEに更新され「基本情報管理>介護保険情報>負担割合証」の画面に表示されます。

API ID

I0008

Request URL

co-pay/update
環境 URL
Staging環境 https://stage-api.link.carekarte.jp/co-pay/update
環境 URL
本番環境 https://api.link.carekarte.jp/co-pay/update

HTTPメソッド

POST

リクエスト

ヘッダー

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

ボディ

パラメータ名 物理パラメータ名 必須 型 文字桁数 文字種/形式 仕様
利用者ID userId

 ◯

 String 10   CAREKARTEに登録されている利用者番号です
負担割合交付日 issueDate   String   YYYY-MM-DD I0005　負担割合情報取得APIから取得してください。
被保険者番号 insuredNumber   String 10   I0005　負担割合情報取得APIから取得してください。
保険者番号 isurerNumber   String 6   I0005　負担割合情報取得APIから取得してください。
負担割合期間開始日 sdate ◯ String   YYYY-MM-DD 負担割合期間開始日
検索用のsdate
負担割合期間終了日 edate   String   YYYY-MM-DD  
更新用のsdate updSdate   String   YYYY-MM-DD 更新用のsdate
負担割合 rate   String    

国の負担する割合を％で入力します。個人負担が1割なら90、2割なら80、3割なら70を入力します
職員ID staffId ◯ String 10   ST0003　事業所所属職員一覧取得API等から取得してください。

負担割合情報を更新するサンプルデータ（実際にリクエストしても使用できません）

{
 "userId": "0000000002",
    "issueDate": "2022-07-15",
    "insuredNumber": "1111111206",
    "isurerNumber": "221028",
    "sdate": "2022-08-02",
    "edate": "2022-08-31",
    "updSdate": "2022-08-15",
    "rate": "80",
    "staffId": "0000000004"
}

レスポンス

ボディ

パラメーター名 物理パラメータ名 型 必須 文字行数 備考
利用者ID userId String  

 ◯

 10 リクエストのuserIdと同値です。
開始日 sdate String  

 ◯

   更新後の開始日

負担割合情報の更新に成功した際のサンプルデータ

{
"userId":"0000000001",
"sdate":"2023-10-11"
}

エラーレスポンス

エラーレスポンスを参照してください。

{
    "ecErrorCode": "",
    "elErrorCode": "EL400001",
    "message": "[userId]の値が正しくありません。",
    "method": "POST",
    "path": "/co-pay/update",
    "code": 400,
    "timestamp": "4/20/2022, 6:16:43 AM"
}

連携イメージ(CAREKARTE)

更新前の負担割合情報（イメージ）

更新後の負担割合情報（イメージ）