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から提案させていただきます。