介護記録更新API

CAREKARTEへ登録した介護記録を更新することができるAPI

リクエストの「LINKパラメータ」では、更新したい介護記録のデータを自由にカスタマイズすることができます。具体例はページ下部にあるリクエスト・レスポンスのサンプルデータとCAREKARTE連携イメージを参照してください。

このAPIを使用するにはCCJ側の設定が必須となります。どんな記録をCAREKARTEに登録・更新したいかを確認の上で、お問い合わせよりご相談ください。

リクエストした内容はCAREKARTEで更新され「業務メニュー>日常記録管理>記録一覧」の画面に表示されます。

API ID

CR0003

Request URL

care-record/update
環境 URL
Staging環境 https://stage-api.link.carekarte.jp/care-record/update/{{カテゴリ}}
環境 URL
本番環境 https://api.link.carekarte.jp/care-record/update/{{カテゴリ}}

HTTPメソッド

POST

リクエスト

パスパラメータ

パスパラメータ名 仕様
カテゴリ (CCJから提示) URLのパスパラメータ。
具体的な値については更新したい内容をヒアリング後、CCJからお伝えします。

ヘッダー

名前 必須 仕様
Content-Type application/json  
authorization tokenサービスで取得した値を設定  
X-CCJ-Datetime-Format   ISO8601/UTC

ISO8601の拡張形式(YYYY-MM-DDThh:mm:ss.sssZ)で日時データを連携したい場合のみ使用します。

指定しない場合はYYYY-MM-DD HH:mm:ss(JST)の形式で日時データを連携します。

 

ボディ

パラメータ名 物理パラメータ 必須 文字桁数 文字種/形式 仕様
利用者ID userId String 10 半角英数字 U0007 事業所所属利用者一覧取得API等から取得してください。
記録ID recordId Number     登録時の記録や、CR0002 介護記録取得API等から取得してください。
更新職員ID staffId String 10 半角英数字 ST0003 事業所所属職員一覧取得API等から取得してください。
実施職員ID workerId   String 10 半角英数字 機能訓練などで記録を登録した職員と実施した職員が異なった場合に使用するパラメータです。
記録開始日時 sdateTime   String   YYYY-MM-DD HH:mm:ss(JST)
または
ISO8601形式
CAREKARTEでは秒数以下は切り捨てとなります。
記録終了日時 edateTime   String   YYYY-MM-DD HH:mm:ss(JST)
または
ISO8601形式
CAREKARTEでは秒数以下は切り捨てとなります。
申し送りフラグ handoverFlag   Boolean     申し送り記録とするか否かのフラグです。
true:申し送りの記録とする
false:申し送りの記録としない
パラメータなし/無効な値:申し送りフラグを更新しない
削除済み記録フラグ delFlag   Boolean     削除済み(論理削除)記録とするか否かのフラグです。
true:削除済みの記録とする
false:削除済みの記録としない
パラメータなし/無効な値:削除済み記録フラグを更新しない
LINKパラメータ (CCJから提示)   (CCJから提示)     CR0001 介護記録登録APIと同じく、具体的な物理パラメータ名については、記録更新したい内容をヒアリング後、CCJからお伝えします。

※ 宣言されないパラメータは記録更新されません

食事の記録を登録するサンプルデータ (実際にリクエストしても使用できません)

URL:care-record/update/meal  //mealがカテゴリ

header:
Authorization:Bearer eyJhbGc…
Content-Type:application/json
X-CCJ-Datetime-Format:ISO8601/UTC

body:
{ 
  "userId": "0000000001",
  "recordId":1124,
  "staffId": "0000000003",
  "workerId": "0000000004",
  "sdateTime":"2022-06-01T09:00:00.000Z",
  "edateTime":"2022-06-01T09:30:00.000Z",
  "handoverFlag":true,
  "delFlag":false,
        /*以下がLINKパラメータ*/
  "mainMl":"8",  //主食
  "subMl":"10",  //副食
  "state":"様子です",
  "support":"対応です",
}

レスポンス

ボディ

パラメータ名 物理パラメータ名 必須 文字桁数 文字種/形式 備考
利用者ID userId String 10 半角英数字 リクエストのuserIdと同値です。
記録ID recordId Number     リクエストのrecordIdと同値です。

 

データの更新成功のサンプルデータ

{ 
  "userId":"0000000001",
  "recordId":1124
}

エラーレスポンス

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

連携イメージ(CAREKARTE)

更新前の記録(イメージ)

更新後の記録(イメージ)

例では登録されている項目が「主食」「副食」「様子」「対応」の4つですが、それらの既存入力値の更新や、記録の開始日時・終了日時などの属性値も更新可能です。登録時に値が入っていない項目に対して登録することも可能です。(水分量等)

イメージ画像はCAREKARTEの標準の食事のレイアウトですが、このAPIを使用する際には、基本的にCR0001 介護記録登録APIと同じパートナー様専用のレイアウトを作成いたします。こちらもヒアリングの後にCCJから提案させていただきます。