介護記録登録(ベッドキー)API

CAREKARTEへ介護記録をベッドキーで登録することができるAPI

ベッドを指定して、そのベッドを使用している利用者に介護記録を登録することができます。
利用者IDを直接指定して記録を登録したい場合、CR0001 介護記録登録APIをご使用下さい。

リクエストの「LINKパラメータ」では、登録したい介護記録のデータを自由にカスタマイズすることができます。具体例はページ下部にあるリクエスト・レスポンスのサンプルデータとCAREKARTE連携イメージを参照してください。
このAPIを使用するにはCCJ側の設定が必須となります。どんな記録をCAREKARTEに登録したいかを確認の上で、お問い合わせよりご相談ください。

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

API ID

CR0004

Request URL

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

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)の形式で日時データを連携します。

 

ボディ

パラメータ名 物理パラメータ名 必須 文字桁数 文字種/形式 仕様
ブロックコード blockCd String 2   MST0003 部屋マスタ取得API等から取得してください。
ユニットコード unitCd String 3 MST0003 部屋マスタ取得API等から取得してください。
部屋コード roomCd String   半角英数字 MST0003 部屋マスタ取得API等から取得してください。
ベッドコード bedCd String 3 半角英数字 MST0003 部屋マスタ取得API等から取得してください。
登録職員ID staffId String 10 半角英数字 ST0003 事業所所属職員一覧取得API等から取得してください。
実施職員ID workerId   String 10 半角英数字 機能訓練などで記録を登録した職員と実施した職員が異なった場合に 使用するパラメータです。 指定しない場合は、登録職員ID(staffId)の職員が登録されます。
記録開始日時 sdateTime String   YYYY-MM-DD HH:mm:ss(JST) または ISO8601形式 CAREKARTEでは秒数以下は切り捨てとなります。
記録終了日時 edateTime   String   YYYY-MM-DD HH:mm:ss(JST) または ISO8601形式 CAREKARTEでは秒数以下は切り捨てとなります。 指定しない場合は、終了日時が未定として登録されます
デフォルト記録フラグ defaultFlag   Boolean     CAREKARTEでは記録に対してあらかじめデフォルトの値を設定でき、そのデフォルト値を使用するか否かのフラグです。 true:デフォルト記録を使用する false または パラメータなし:デフォルト記録を使用しない ex)食事記録で、食事する場所は居室と決まっているので、あらかじめ設定しておく等。
申し送りフラグ handoverFlag   Boolean     申し送り記録とするか否かのフラグです。 true:申し送りの記録とする false または パラメータなし:申し送りの記録としない 申し送り記録とすると、記録内容が赤く表示され「業務メニュー>日常記録管理>ホーム」にも表示されます。
LINKパラメータ (CCJから指定)   (CCJから指定)     具体的な物理パラメータ名については、記録更新したい内容をヒアリング後、CCJからお伝えします。

ベッド情報から介護記録を登録するサンプルデータ (実際にリクエストしても使用できません)

URL:care-record/bed-add/meal //mealがカテゴリ
header:
Authorization:Bearer eyJhbGc…
Content-Type:application/json
X-CCJ-Datetime-Format:ISO8601/UTC
body:
{
   "blockCd": "01",
   "unitCd": "001",
   "roomCd": "001",
   "bedCd": "001",
   "staffId":"0000000001",
   "workerId":"0000000013",
   "sdateTime":"2021-06-17T01:00:00.000Z",
   "edateTime":"2021-06-17T01:05:30.000Z",
   "defaultFlag":true,
   "handoverFlag":true,
   "mainMl":"10",
 //以下リンクパラメータ
   "subMl":"9",
   "state":"様子",
   "support":"対応"
}

レスポンス

ボディ

パラメータ名 物理パラメータ名 配列内パラメータ 文字行数 文字種/形式 備考
利用者ID userId   String 10 半角英数字 記録をしたuserIdを返却
記録ID recordId   Number     記録IDを返却する
ブロックコード blockCd   String 2    
ユニットコード unitCd   String 3    
部屋コード roomCd   String      
ベッドコード bedCd   String 3    

データの登録成功のサンプルデータ

{
"userId": "0000000001",
"recordId": 112,
"blockCd": "01",
"unitCd": "001",
"roomCd": "001",
"bedCd": "001"
}

エラーレスポンス

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

連携イメージ(CAREKARTE)

CAREKARTE側のイメージ画像

例ではAPIパラメータ指定サンプルの通り、ベッド情報をキーとした、NOTEの記録タイプの登録汎用APIを記録登録可能です。 利用者が特定できなかった場合は、「氏名不詳」記録として登録します。 複数レコードが取得される場合以下の条件になります 第1条件:スケジュールの開始日時が最新の利用者 第2条件:スケジュールの終了日時が最新の利用者 第3条件:スケジュールの更新日時が最新の利用者 イメージ画像はCAREKARTEの標準の記録一覧のレイアウトです。こちらもヒアリングの後にCCJから提案させていただきます。