Crisphive
fr
Réservations›Classer les techniciens pour une insertion d'urgence P0

Classer les techniciens pour une insertion d'urgence P0

Renvoie les techniciens qui pourraient prendre l'intervention d'urgence au démarrage demandé, classés par ARRIVÉE LA PLUS RAPIDE d'abord (pour un P0, l'arrivée prime sur l'efficacité d'itinéraire). La réponse porte aussi une `crew_recommendation` historique (taille d'équipe médiane sur des interventions terminées comparables + clause de non-responsabilité obligatoire — AC-2). Les techniciens déjà réservés restent candidats — chaque entrée porte l'aperçu de déplacement (quelles interventions de priorité inférieure seraient repoussées, par jour) qu'entraînerait leur choix ; total_moves=0 signifie un créneau libre. Les interventions P0 ne sont jamais déplacées ; les P1 seulement par un P0. L'ETA est estimée depuis le lieu de départ du technicien (pas de GPS en direct). Transmettez le technician_id choisi à emergency/preview + emergency/commit. 409 ÉTAPES SUIVANTES : EMERGENCY_RESCHEDULE_NOT_ELIGIBLE — l'intervention ne peut pas être insérée en urgence (pas P0, déjà commencée/terminée/archivée, ou non devisée) : corrigez l'état de l'intervention ou utilisez une confirmation normale. EMERGENCY_RESCHEDULE_CREW_UNSUPPORTED — les interventions en équipe ne peuvent pas utiliser le flux d'urgence (v1) : affectez plutôt via confirm/reassign. EMERGENCY_RESCHEDULE_NO_WORKING_DAY — la date choisie n'a pas d'heures de travail : choisissez un jour ouvré. EMERGENCY_RESCHEDULE_IN_PAST — l'heure de début est déjà passée : choisissez une heure future.

Arguments

after_hours_overridebooleanbodyoptionnel
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_idstringbodyrequis
ID of the P0 job to place.
limitintegerbodyoptionnel
Nombre max de candidats à renvoyer (5 par défaut, max 10).
modeenumbodyrequis
Cascade mode each candidate's displacement preview assumes: overtime = displaced jobs stay same-day; next_day = overflow rolls to the next working day.
start_atstringbodyrequis
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"
}'
Corps de la requête
{
"after_hours_override": ,
"emergency_job_id": ,
"limit": ,
"mode": ,
"start_at":
}

Réponses

‹Interroger les demandes d'intervention nouvelles et modifiées (flux de synchronisation)Précédent
Valider l'insertion d'urgence + la reprogrammation en cascade›Suivant