start-visit-with-hoken

患者の診察を、使用する保険を明示的に指定して開始する。リクエストボディで保険 ID の組み合わせを送る。新規行を作成する非冪等な操作のため POST で受け付け、作成後はレガシーサーバーへ変更が通知される。

リクエスト

項目	内容
メソッド	POST
パス	/api/start-visit-with-hoken
クエリ	patient-id — 患者 ID（正の整数）、at — 診察日時（YYYY-MM-DD HH:MM:SS。省略時は現在時刻）
リクエストボディ	HokenIdSet（使用する各保険の ID。未使用は 0）

例

{
  "shahokokuhoId": 100,
  "koukikoureiId": 0,
  "roujinId": 0,
  "kouhi1Id": 0,
  "kouhi2Id": 0,
  "kouhi3Id": 0
}

レスポンス

作成された Visit。指定した保険が割り当てられる。

例

{
  "visitId": 5678,
  "patientId": 1234,
  "visitedAt": "2026-07-10 09:30:00",
  "shahokokuhoId": 100,
  "roujinId": 0,
  "kouhi1Id": 0,
  "kouhi2Id": 0,
  "kouhi3Id": 0,
  "koukikoureiId": 0
}

エラー

ステータス	意味
400	patient-id が不正、またはリクエストボディが HokenIdSet の形式に合わない
404	指定した ID の患者が存在しない
500	診察開始に失敗した