ドキュメント トップ / json / cpos_export_bundle
使い方ローカル前処理エンジンログイン / プランレビュアーポートフォリオ最適化マスタ整合性レビューCPOS 連携 (PAT)JSON 形式データ取扱方針デプロイCLI技術

cpos_export_bundle.json — CPOS 連携統合形式

CPOS の /api/platform/kasan/export が返す統合 bundle 形式。加算マネージャは これを既存判定エンジンの入力(tenant_status / staff / user_summary / evidence)に変換する。

目的

必須フィールド

パス 説明
formatVersion string 現在 "1"
facility.id string 事業所 ID
serviceMonth string YYYY-MM

任意フィールド

パス 説明
staffSummary object 職員集計(qualifiedPersonCountByProfession 等)
userSummary object 利用者集計
claimSummary object 請求集計(加算別件数・単位数)
benefitManagementSummary object 給付管理集計
fteSummary object 常勤換算集計
source.authMethod string personal_access_token / app_token
source.subjectUserId string CPOS の発行ユーザ ID
source.tokenPreview string PAT のプレビュー(先頭 14 文字)

サンプル

{
  "formatVersion": "1",
  "generatedAt": "2026-05-07T12:00:00.000Z",
  "organizationId": "default",
  "facility": {
    "id": "facility-a",
    "name": "デイほっと",
    "businessNumber": "1234567890",
    "serviceTypeCodes": ["15"]
  },
  "serviceMonth": "2026-04",
  "serviceKey": "tsusho_kaigo",
  "source": {
    "system": "CPOS",
    "authMethod": "personal_access_token",
    "subjectUserId": "user_xxx",
    "tokenPreview": "cpos_pat_abcd...wxyz"
  },
  "staffSummary": {
    "qualifiedPersonCountByProfession": { "nurse": 3, "care_worker": 8 },
    "fteByProfession": { "nurse": 2.4, "care_worker": 6.8 }
  },
  "userSummary": {
    "activeUserCount": 42,
    "careLevelDistribution": { "care3": 7, "care4": 4, "care5": 2 },
    "care3PlusRatio": 0.3095
  },
  "claimSummary": {
    "currentAddOnCounts": { "nyuyoku_kaijo_ii": 28 }
  }
}

個人情報

含めません。設計上、集計値のみを返します。CPOS 側で includePii=true オプションを使えば個別データを返すことは可能ですが、本アプリは既定で includePii=false を使います。

バリデーション

npm run validate:json -- --kind cpos_export_bundle --input path/to/bundle.json

スキーマ: cpos_export_bundle.schema.json

関連

このドキュメントはリポジトリ docs/ 配下の Markdown を配信しています。