通所系スケジュール更新API

CAREKARTE通所系サービスのスケジュール記録を更新することができるAPIです。

リクエストの「LINKパラメータ」では、更新したい介護記録のデータを自由にカスタマイズすることができます。具体例はページ下部にあるリクエスト・レスポンスのサンプルデータとCAREKARTE連携イメージを参照してください。
(基本的にはSC0005等、スケジュール登録APIの設定に準拠する形になると思われます)

このAPIを使用するにはCCJ側の設定が必須となります。どのスケジュールをCAREKARTEへ更新したいかを確認の上で、お問い合わせよりご相談ください。
リクエストした内容はCAREKARTEに登録され「業務メニュー>スケジュール管理>利用予定」の画面に表示されます。

スケジュール登録APIで作成したスケジュールを更新する場合、同一のカテゴリを使用してください。

※アクセスが集中する時間帯や事業所が多い法人でリクエストする場合、タイムアウトが発生する可能性があります。

API ID

SC0011

Request URL

daysch/update
環境 URL
Staging環境 https://stage-api.link.carekarte.jp/daysch/update/{{カテゴリ}}
環境 URL
本番環境 https://api.link.carekarte.jp/daysch/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)の形式で日時データを連携します。

 

ボディ

パラメータ名 物理パラメータ名 配列内パラメータ名 必須:○
条件付き必須:△
文字桁数 文字種/形式 仕様
更新スケジュール daySchedule   [array]      
利用者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等から取得してください。
ブロック・ユニットの更新をする場合必須となります。
開始日時   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になる場合、入力値は無効となります。
結果状態   result   Number 1 半角数字 スケジュールの結果状態を更新するパラメータです。
1:計画
2:実施
3:中止
無効値・パラメータなし:更新しない
申し送りフラグ   handoverFlag   Boolean     記録を申し送りの記録とするパラメータです。
true:記録を申し送り記録にする
false:記録を申し送り記録としない
無効値・パラメータなし:更新しない
削除フラグ   delFlag   Boolean     記録を削除(論理削除)の記録とするパラメータです。
true:記録を削除記録にする
false:記録を削除記録としない
無効値・パラメータなし:更新しない
LINKパラメータ   (CCJから提示) (CCJから提示)   登録したい内容を自由にカスタマイズできます。
具体的な物理パラメータ名については、登録したい内容をヒアリング後、CCJからお伝えします。

通所スケジュールを更新するサンプルデータ (実際にリクエストしても使用できません)

URL:/daysch/update/longstay //dayがカテゴリ

HTTPメソッド:POST

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

body:
{ 
   "daychedule":[
      {
         "userId": "0000000001",
         "recordId": 1100,
         "staffId": "0000000001",
         "blockCd": "01",
         "unitCd": "001",
         "sdateTime":"2022-06-02T09:00:00.000Z",
         "edateTime":"2022-06-02T12:00:00.000Z",
         "handoverFlag":true,
         "delFlag":false,
 //以下リンクパラメータ
          "timeext":"時間延長(8〜9)",
          "demantiaAdd":"若年性認知症加算"
      },
      {
         "userId": "0000000002",
         "recordId": 52,
         "staffId": "0000000001",
・・・
      }
   ]
 }

レスポンス

ボディ

パラメータ名 物理パラメータ 配列内パラメータ 文字行数 文字種/形式 仕様
更新スケジュール schedule   [array]      
利用者ID   userId String 10   リクエストのuserIdと同じ
記録ID   recordId Number     リクエストのrecordIdと同じ
更新結果   recordResult Boolean     更新に成功した:true
更新に失敗した:false
リクエストメッセージコード   rmCode String     詳細は「API仕様・公開仕様」>「RMメッセージ」を確認ください。
リクエストメッセージ   rmMessage String     詳細は「API仕様・公開仕様」>「RMメッセージ」を確認ください。

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

{ 
  "schedule":[
    {
    "userId":"0000000001",
    "recordid":123,
    "recordResult":true,
    "rmcode";"",
    "rmMessage";""
    }
  ],
  [
    {
    "userId":"0000000002",
    "recordid":100,
    "recordResult":false,
    "rmcode";"RM003",
    "rmMessage";"スケジュールの保存に失敗しました"
    }
  ]
}

エラーレスポンス

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

連携イメージ(CAREKARTE)

リクエスト例では更新した項目が「時間区分」「加算項目」ですが、例えばイメージの画像にない項目も追加することが可能です。

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