CAREKARTE入所系サービスのスケジュール記録を更新することができるAPIです。
リクエストの「LINKパラメータ」では、更新したい介護記録のデータを自由にカスタマイズすることができます。具体例はページ下部にあるリクエスト・レスポンスのサンプルデータとCAREKARTE連携イメージを参照してください。
(基本的にはSC0004等、スケジュール登録APIの設定に準拠する形になると思われます)
このAPIを使用するにはCCJ側の設定が必須となります。どのスケジュールをCAREKARTEへ更新したいかを確認の上で、お問い合わせよりご相談ください。
リクエストした内容はCAREKARTEに登録され「業務メニュー>スケジュール管理>居室管理」の画面に表示されます。
スケジュール登録APIで作成したスケジュールを更新する場合、同一のカテゴリを使用してください。
※アクセスが集中する時間帯や事業所が多い法人でリクエストする場合、タイムアウトが発生する可能性があります。
API ID
SC0010
Request URL
staysch/update
| 環境 | URL |
|---|---|
| Staging環境 | https://stage-api.link.carekarte.jp/staysch/update/{{カテゴリ}} |
| 環境 | URL |
|---|---|
| 本番環境 | https://api.link.carekarte.jp/staysch/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 | |||
| 職員ID | staffId | ○ | String | 10 | 半角英数字 | ST0003 事業所所属職員一覧取得API等から取得してください。 |
| ブロックコード | blockCd | △ | String | 2 | 半角英数字 | MST0003 部屋マスタ取得API等から取得してください。 ユニット・居室・ベッドの更新をする場合必須となります。 |
| ユニットコード | unitCd | △ | String | 3 | 半角英数字 | MST0003 部屋マスタ取得API等から取得してください。 ユニット・居室・ベッドの更新をする場合必須となります。 |
| 居室コード | roomCd | △ | String | 3 | 半角英数字 | MST0003 部屋マスタ取得API等から取得してください。 居室・ベッドの更新をする場合必須となります。 |
| ベッドコード | bedCd | △ | String | 3 | 半角英数字 | MST0003 部屋マスタ取得API等から取得してください。 居室・ベッドの更新をする場合必須となります。 |
| 開始日時 | sdateTime | String | YYYY-MM-DD HH:mm:ss(JST) または ISO8601形式 |
CAREKARTEでは秒数以下は切り捨てとなります。 sdateTime>edateTimeになる場合、入力値は無効となります。 |
||
| 終了日時 | edateTime | String | YYYY-MM-DD HH:mm:ss(JST) または ISO8601形式 |
CAREKARTEでは秒数以下は切り捨てとなります。 2500-01-01 00:00:00(もしくは2500-01-01T00:00:00.000Z等)指定した場合は、終了日時が未定として更新されます。 sdateTime>edateTimeになる場合、入力値は無効となります。 |
||
| 申し送りフラグ | handoverFlag | Boolean | 記録を申し送りの記録とするパラメータです。 true:記録を申し送り記録にする false:記録を申し送り記録としない 無効値・パラメータなし:更新しない |
|||
| 削除フラグ | delFlag | Boolean | 記録を削除(論理削除)の記録とするパラメータです。 true:記録を削除記録にする false:記録を削除記録としない 無効値・パラメータなし:更新しない |
|||
| LINKパラメータ | (CCJから提示) | (CCJから提示) | 登録したい内容を自由にカスタマイズできます。 具体的な物理パラメータ名については、登録したい内容をヒアリング後、CCJからお伝えします。 |
長期スケジュールを更新するサンプルデータ (実際にリクエストしても使用できません)
URL:/staysch/update/longstay //longstayがカテゴリ
HTTPメソッド:POST
header:
Authorization:Bearer eyJhbGc…
Content-Type:application/json
CCJ-Datetime-Format:ISO8601/UTC
body:
{
"userId": "0000000001",
"recordId": 1124,
"staffId": "0000000001",
"blockCd": "01",
"unitCd": "001",
"roomCd": "001",
"bedCd": "001",
"sdateTime":"2022-06-02T09:00:00.000Z",
"edateTime":"2022-06-30T10:00:00.000Z",
"handoverFlag":true,
"delFlag":false,
//以下リンクパラメータ
"note":"備考更新",
"incomment":"入所状況コメント更新"
}
レスポンス
ボディ
| パラメータ名 | 物理パラメータ | 型 | 文字桁数 | 文字種/形式 | 仕様 |
| 利用者ID | userId | String | 10 | リクエストのuserIdと同じ | |
| 記録ID | recordId | Number | リクエストのrecordIdと同じ | ||
| 更新結果 | recordResult | Boolean | true:更新に成功した false:更新に失敗した |
データの登録成功のサンプルデータ
{
"userId":"0000000001",
"recordId":1124,
"recordResult":true
}
エラーレスポンス
エラーレスポンスを参照してください。
連携イメージ(CAREKARTE)

リクエスト例では更新した項目が「部屋」「ベッド」「備考」「入所(院)状況コメント」ですが、例えばイメージの画像にない項目も追加することが可能です。
またイメージ画像はCAREKARTEの標準の長期入所スケジュールのレイアウトですが、このAPIを使用する際には、基本的にパートナー様専用のレイアウトを作成いたします。こちらもヒアリングの後にCCJから提案させていただきます。