Crisphive
es
Reservas›Clasificar técnicos para una inserción de emergencia P0

Clasificar técnicos para una inserción de emergencia P0

Devuelve los técnicos que podrían asumir el trabajo de emergencia en el inicio solicitado, clasificados primero por LLEGADA MÁS RÁPIDA (para un P0 la llegada prevalece sobre la eficiencia de ruta). La respuesta también incluye una `crew_recommendation` histórica (tamaño mediano de cuadrilla en trabajos completados comparables + aviso obligatorio — AC-2). Los técnicos con reservas siguen siendo candidatos — cada entrada incluye la vista previa de desplazamiento (qué trabajos de menor prioridad se empujarían, por día) que causaría comprometerse con ellos; total_moves=0 significa un hueco libre. Los trabajos P0 nunca se desplazan; los P1 solo por un P0. La ETA se estima desde la ubicación de inicio del técnico (sin GPS en vivo). Pase el technician_id elegido a emergency/preview + emergency/commit. 409 PRÓXIMOS PASOS: EMERGENCY_RESCHEDULE_NOT_ELIGIBLE — el trabajo no puede insertarse como emergencia (no es P0, ya empezó/se completó/se archivó, o no está cotizado): corrija el estado del trabajo o use una confirmación normal. EMERGENCY_RESCHEDULE_CREW_UNSUPPORTED — los trabajos de cuadrilla no pueden usar el flujo de emergencia (v1): dote personal mediante confirm/reassign. EMERGENCY_RESCHEDULE_NO_WORKING_DAY — la fecha elegida no tiene horas de trabajo: elija un día laborable. EMERGENCY_RESCHEDULE_IN_PAST — la hora de inicio ya pasó: elija una hora futura.

Argumentos

after_hours_overridebooleanbodyopcional
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_idstringbodyobligatorio
ID of the P0 job to place.
limitintegerbodyopcional
Máximo de candidatos a devolver (por defecto 5, máx. 10).
modeenumbodyobligatorio
Cascade mode each candidate's displacement preview assumes: overtime = displaced jobs stay same-day; next_day = overflow rolls to the next working day.
start_atstringbodyobligatorio
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"
}'
Cuerpo de la solicitud
{
"after_hours_override": ,
"emergency_job_id": ,
"limit": ,
"mode": ,
"start_at":
}

Respuestas

‹Sondear solicitudes de trabajo nuevas y modificadas (feed de sincronización)Anterior
Confirmar inserción de emergencia + reprogramación en cascada›Siguiente