de
Buchungen›Techniker für ein P0-Notfall-Einschieben einstufen

Techniker für ein P0-Notfall-Einschieben einstufen

Gibt die Techniker zurück, die den Notfallauftrag zum angeforderten Start übernehmen könnten, sortiert nach SCHNELLSTER ANKUNFT zuerst (bei einem P0 schlägt die Ankunft die Routeneffizienz). Die Antwort enthält außerdem eine historische `crew_recommendation` (mediane Teamgröße bei vergleichbaren abgeschlossenen Aufträgen + verpflichtender Haftungsausschluss — AC-2). Gebuchte Techniker sind weiterhin Kandidaten — jeder Eintrag enthält die Verdrängungs-Vorschau (welche Aufträge mit niedrigerer Priorität pro Tag verschoben würden), die eine Zusage an sie verursachen würde; total_moves=0 bedeutet ein freier Slot. P0-Aufträge werden nie verdrängt; P1 nur durch ein P0. Die ETA wird vom Startort des Technikers geschätzt (kein Live-GPS). Übergeben Sie die gewählte technician_id an emergency/preview + emergency/commit. 409 NÄCHSTE SCHRITTE: EMERGENCY_RESCHEDULE_NOT_ELIGIBLE — der Auftrag kann nicht als Notfall eingeschoben werden (nicht P0, bereits gestartet/abgeschlossen/archiviert oder ohne Angebot): korrigieren Sie den Auftragsstatus oder verwenden Sie ein normales confirm. EMERGENCY_RESCHEDULE_CREW_UNSUPPORTED — Team-Aufträge können den Notfall-Ablauf nicht verwenden (v1): stattdessen über confirm/reassign besetzen. EMERGENCY_RESCHEDULE_NO_WORKING_DAY — das gewählte Datum hat keine Arbeitszeiten: wählen Sie einen Arbeitstag. EMERGENCY_RESCHEDULE_IN_PAST — die Startzeit ist bereits vergangen: wählen Sie eine Zeit in der Zukunft.

Argumente

after_hours_overridebooleanbodyoptional
Place this P0 outside working hours / approved time-off — you have phoned the technician and they agreed. Drops the non-working-day rejection; the response then carries an AFTER_HOURS warning. Double-booking, service area, required skills and the lead-tier rule still reject.
emergency_job_idstringbodyerforderlich
ID of the P0 job to place.
limitintegerbodyoptional
Maximale Anzahl zurückgegebener Kandidaten (Standard 5, max. 10).
modeenumbodyerforderlich
Cascade mode each candidate's displacement preview assumes: overtime = displaced jobs stay same-day; next_day = overflow rolls to the next working day.
start_atstringbodyerforderlich
Desired start — business-local wall clock. Seconds may be omitted and a space may replace the T; an offset is accepted only when it agrees with the business timezone (a disagreeing one is refused with JOB_REQUEST_INVALID_INPUT rather than guessed). Must be in the future.
POST/v1/job-requests/emergency/candidates
curl -X POST "https://api.crisphive.com/v1/job-requests/emergency/candidates" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \
  -H "Content-Type: application/json" \
  -d '{
  "after_hours_override": true,
  "emergency_job_id": "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01",
  "limit": 1,
  "mode": "overtime",
  "start_at": "2030-06-14T09:00:00"
}'
Anfragetext
{
"after_hours_override": ,
"emergency_job_id": ,
"limit": ,
"mode": ,
"start_at":
}

Antworten