レセプト連携
更新日: 2026-04-28
この機能でできること
Black Swan に蓄積したケア記録を、レセプト管理システム「ケア樹（グッドツリー）」に自動で送る機能です。
スタッフは Black Swan に記録するだけ で、ケア樹のレセプト作業に必要なデータが自動で連携されます。
ドキュメント一覧
| ファイル | 内容 |
|---|---|
02_レセプトについて.md | 介護レセプトとは何か・月次の処理フロー |
03_利用シナリオ.md | ユースケース一覧（13シナリオ、アクター・タイミング・フロー付き） |
04_連携の仕組み.md | Black Swan とケア樹がどのようにつながるか |
05_セキュリティ方針.md | 情報の取り扱い・安全性について |
06_ケア樹でのレセプト提出手順.md | ケア樹を使った国保連へのレセプト提出操作手順 |
07_ケア樹連携API一覧.md | 連携に使用するケア樹 API の一覧 |
08_連携データ一覧.md | どのデータが連携されるかの一覧 |
09_APIデータマッピング.md | ケア樹 API と Black Swan モデルの対応表 |
Black Swan とケア樹の連携方法
データの流れ
┌─────────────────────┐
│ Black Swan │
│ │
│ ケア樹ログイン情報 │
│ （事業所設定で登録）│
└──────────┬───────────┘
│ ケア樹 API を呼び出してデータを送信
▼
┌─────────────────────┐
│ ケア樹 API │
└──────────┬───────────┘
│ データが反映される
▼
┌─────────────────────┐
│ ケア樹 Web │
│ （管理者がレセプト │
│ を確認・提出） │
└─────────────────────┘
Black Swan が主システム。ケア樹への登録・更新・削除はすべて Black Swan 側から行う。
同期パターン
GET で既存データを確認
├─ なければ POST（新規登録）
├─ あれば PUT（更新）
└─ Black Swan で削除されたら DELETE
紐付けキー
ケア樹から返却された ID を Black Swan 側のモデルに caretreeXxxId フィールドとして保存し、以降の PUT / DELETE に使用する。
登録の前提順序
依存関係があるため、以下の順序で登録する必要がある。
① 部屋グループ（02.02.03）
② 部屋（02.02.04） ← 部屋グループIDが必要
③ 事業所食事提供（02.02.05）
④ 利用者（02.04.01）
⑤ サービス提供期間（02.04.03）← 利用者IDが必要
⑥ 介護保険被保険者証（02.04.04）
⑦ 給付率（02.04.05）
⑧ 入退所（02.04.06） ← サービス提供期間が必要
⑨ 転室（02.04.07） ← 部屋IDが必要
⑩ 食事提供（02.04.08） ← 事業所食事提供が必要
⑪ 食止め（02.04.09）
⑫ 外出外泊（02.04.10）
⑬ 食事記録（04.02.02） ← 日次送信
使用する API の概観と不足データ
利用する API
連携に使用するのは計 13 API。詳細は 09_APIデータマッピング.md を参照。
| API番号 | API名称 |
|---|---|
| 02.02.03 | 部屋グループ |
| 02.02.04 | 部屋 |
| 02.02.05 | 事業所食事提供 |
| 02.04.01 | 利用者 |
| 02.04.03 | サービス提供期間 |
| 02.04.04 | 介護保険被保険者証 |
| 02.04.05 | 給付率 |
| 02.04.06 | 入退所 |
| 02.04.07 | 転室 |
| 02.04.08 | 食事提供 |
| 02.04.09 | 食止め |
| 02.04.10 | 外出外泊 |
| 04.02.02 | 食事記録 |
Black Swan モデルへの追加フィールドが必要
ケア樹との紐付けキーや、ケア樹の API で必要になる値を保持するために追加が必要なフィールド。
| モデル | 追加フィールド |
|---|---|
Group | caretreeRoomGroupId, caretreeRoomGroupNo, caretreeSortNo |
Bed | caretreeRoomId, caretreeRoomNo, caretreeSortNo, caretreeKai, caretreeTeiin, caretreeType, caretreeKyoshitsuType, caretreeKyoshitsuhiTanka, caretreeStartDt |
User | caretreeRiyoushaId |
Insurance | caretreeKaigoHokenId, caretreeKyuufuRitsuId, ninteiShubetsuCd |
BedAdmissionContract | caretreeTeikyouKikanId, caretreeNyuutaishoId, caretreeTenshitsuId |
DayCareContract | caretreeTeikyouKikanId |
CareMeal | caretreeShokujiTeikyouId |
UserAbsence | caretreeShokudomeId, caretreeGaishutsuGaihakuId, shokudomeFromShokujiBunruiKbn, shokudomeToShokujiBunruiKbn |
Staff | caretreeStaffId（食事記録の送信に必要） |
Black Swan に存在しないが必要なデータ
ケア樹の API で必須だが Black Swan が現在持っていないデータ。施設の設定や請求のための情報であり、連携開始前に管理者が入力できる画面を新たに追加する必要がある。
| データ | 関連 API |
|---|---|
| 居室費単価・居室形態・居室タイプ | 02.02.04 部屋 |
| 事業所の食事種類・単価・食事形態・税区分 | 02.02.05 事業所食事提供 |
| 提供形態CD（通所系） | 02.04.03 サービス提供期間 |
| 退所後状況CD | 02.04.06 入退所 |
| 利用者ごとの食事種類・単価・食事形態・税区分 | 02.04.08 食事提供 |
| 食止め開始・終了の食事区分 | 02.04.09 食止め |
| 外出・外泊の開始食事区分・開始終了時間 | 02.04.10 外出外泊 |
確認事項
- 同期のタイミング: バッチ処理（自動・定期実行）にするか、管理者がボタンを押したタイミングで実行するか
- 削除の扱い: Black Swan でデータを削除した場合、ケア樹側でも DELETE を行うか（ケア樹に依存データが残っている場合はエラーになる可能性あり）
- 送信データの全体確認: 各 API で実際に送るフィールドを確認する（詳細は
09_APIデータマッピング.md参照）