ja
予約緊急挿入 + カスケード日程変更のプレビュー

緊急挿入 + カスケード日程変更のプレビュー

緊急ジョブを選んだ時刻にテクニシャンへ挿入した場合のカスケードを(書き込みなしで)計算します: 緊急ジョブがどこに着地するか + 押しのけられるすべてのジョブを、ビジネスローカルの日ごとにグループ化します。`displacement_mode=reassign` を指定すると、代わりに押しのけられた各ジョブを元のウィンドウのまま別の実行可能なテクニシャンに引き渡します(当日中の約束)— 代替キャパシティがないジョブは reschedule にフォールバックし `days` に残ります。`mode=overtime` は全員を当日中に維持します(テクニシャンが遅くまで働く)。`mode=next_day` はあふれた分を次の勤務日へ繰り越します。読み取り専用です — 繰り返し呼び出しても安全で、コミットは別のエンドポイントです。独立した機能です(EMERGENCY_RESCHEDULE_DESIGN.md を参照)。 409 の次のステップ: EMERGENCY_RESCHEDULE_SLOT_OCCUPIED — 着地ウィンドウが、カスケードが移動できないジョブ(別の P0、クルーまたは複数日ジョブ)でブロックされています: 別のテクニシャン(/candidates のランキングを辿る)または別の時刻を選んでください。押しのけが P0/クルー/複数日のアンカーに触れることは決してありません。EMERGENCY_RESCHEDULE_NOT_ELIGIBLE / CREW_UNSUPPORTED / NO_WORKING_DAY / IN_PAST — /candidates と同じ対処です。

引数

displacement_modeenumbody任意
押しのけられたジョブの扱い: reschedule(デフォルト — 後のウィンドウへずらす)または reassign(元の時刻のまま別の実行可能なテクニシャンへ引き渡す。キャパシティのないジョブは reschedule にフォールバックします)。
emergency_job_idstringbody必須
挿入する P0 ジョブの ID です。
modeenumbody必須
カスケードモード: overtime = 押しのけられたジョブを当日中に維持する(テクニシャンが遅くまで働く)。next_day = あふれた分を次の勤務日へ繰り越す。
start_atstringbody必須
希望する開始時刻 — ビジネスローカルのナイーブな日時(例: "2026-07-20T09:00:00")です。未来の時刻である必要があります。
technician_idstringbody必須
対象のテクニシャン(ビジネスに属している必要があります)です。
POST/v1/job-requests/emergency/preview
curl -X POST "https://api.crisphive.com/v1/job-requests/emergency/preview" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \
  -H "Content-Type: application/json" \
  -d '{
  "displacement_mode": "reschedule",
  "emergency_job_id": "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01",
  "mode": "overtime",
  "start_at": "2030-06-14T09:00:00",
  "technician_id": "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01"
}'
リクエストボディ
{
"displacement_mode": ,
"emergency_job_id": ,
"mode": ,
"start_at": ,
"technician_id":
}

レスポンス