Buchungen›Passende Zeitfenster für einen Auftrag mit Angebot
Passende Zeitfenster für einen Auftrag mit Angebot
Buchbare Ankunftsfenster-Slots für einen Auftrag mit Angebot, berechnet von der Smart-Assignment-Matching-Engine: Jeder Slot listet die Techniker auf, die zu diesem Zeitpunkt tatsächlich starten können (Fähigkeiten, wöchentliche Verfügbarkeit, bestehender Zeitplan, Abwesenheiten und Fahrtwege werden alle geprüft), mit einem Match-Score je Techniker. Verwenden Sie ihn, um Termine zu finden und anzubieten, die ein Agent oder eine Integration anschließend bestätigen kann (POST /job-requests/{id}/confirm mit dem business_time.datetime des Slots). Dasselbe Raster, das der Slot-Picker des Endkunden anzeigt; die Slot-Breite entspricht standardmäßig dem Ankunftsfenster des Unternehmens — überschreibbar über ?step_minutes (5–240). Der Auftrag muss zuerst ein Angebot haben (das Angebot legt die Einsatzdauer fest, die der Matcher einplant).
Argumente
idstringpatherforderlich
Auftragsanfrage-ID (UUID oder short_code)
step_minutesintegerqueryoptional
Slot-Schrittweite in Minuten (Standard: Ankunftsfenster des Unternehmens, 5–240)
GET/v1/job-requests/{id}/time-segments
curl -X GET "https://api.crisphive.com/v1/job-requests/9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01/time-segments" \
-H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT"
