Crisphive
de
Buchungen›Auftragsanfrage anlegen

Auftragsanfrage anlegen

Bucht einen Außendienstauftrag — den Arbeitsauftrag, der in die Dispositions- und Planungspipeline gelangt. Senden Sie die UUID des Kunden plus die gewünschten `job_dates` (Datum + Zeitfenster morning/afternoon/evening, idealerweise aus GET /job-requests/booking-windows angeboten), optional `job_type_id` (Servicekatalog), `skill_ids` (erforderliche Technikerqualifikationen) und eine Freitextbeschreibung. Angebotserstellung, Techniker-/Crew-Zuweisung und Abschluss führen den Arbeitsauftrag anschließend durch den Workflow des Unternehmens.

Argumente

X-Timezonestringheaderoptional
IANA-Zeitzone des Kunden
Idempotency-Keystringheaderoptional
Unique key making retries safe: a repeat send with the same key returns the original booking instead of creating a duplicate
customer_idstringbodyerforderlich
UUID eines bestehenden Kunden dieses Unternehmens, für den der Auftrag gebucht wird. Erforderlich.
descriptionstringbodyoptional
Freitextbeschreibung der angefragten Arbeit. Optional; max. 2000 Zeichen.
▾job_datesarray<object>bodyerforderlich
Gewünschte(s) Datum/Daten und Zeitfenster, an denen der Kunde den Auftrag wünscht. Mindestens eines, bis zu 12.
datestringbodyerforderlich
Gewünschter Kalendertag (YYYY-MM-DD), in der Zeitzone des Kunden. Erforderlich.
▾periodsarray<object>bodyerforderlich
Ein oder mehrere für dieses Datum angefragte Tageszeitfenster. Mindestens eines, bis zu 3.
business_viewarray<object>bodyoptional
Zeitbereiche in Unternehmenszeit, auf die das Zeitfenster abgebildet wird (aus booking-windows übernommen). Optional.
periodenumbodyerforderlich
Vom Kunden angefragtes Tageszeitfenster. Erforderlich.
job_type_idstringbodyoptional
UUID des Auftragstyps zur Klassifizierung dieses Auftrags. Optional; null lässt den Auftrag unklassifiziert.
priorityenumbodyoptional
Planungspriorität. Optional; ausgelassene Buchungen erhalten die default_priority-Einstellung des Unternehmens (Zuweisungseinstellungen, Standard p2). p0=Notfall (unterbrechungsgesteuertes Einschieben), p1=höchste (nur von p0 verdrängt), p2=Standard, p3=aufschiebbar (erster Kandidat für Verdrängung).
skill_idsarray<string>bodyoptional
UUIDs der Fähigkeiten, die der Kunde für diesen Auftrag wünscht. Optional; bis zu 20.
sla_deadlinestringbodyoptional
SLA-Frist (unternehmenslokale naive Datetime, z. B. "2026-07-15T17:00:00"). Optional; NUR zusammen mit priority=p1 gültig — aktiviert die Auto-Eskalations-Uhr (der Auftrag eskaliert auf p0, sobald das Überschreitungsrisiko den Sicherheitspuffer des Unternehmens überschreitet). Muss in der Zukunft liegen.
POST/v1/job-requests
curl -X POST "https://api.crisphive.com/v1/job-requests" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \
  -H "Content-Type: application/json" \
  -d '{
  "customer_id": "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01",
  "description": "Please call on arrival.",
  "job_dates": [
    {
      "date": "2030-06-03",
      "periods": [
        {
          "business_view": [],
          "period": "morning"
        }
      ]
    }
  ],
  "job_type_id": "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01",
  "priority": "p1",
  "skill_ids": [
    "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01"
  ],
  "sla_deadline": "2030-06-14T17:00:00"
}'
Anfragetext
{
"customer_id": ,
"description": ,
"job_dates": [
{
"date": ,
"periods": [
{
"business_view": [
],
"period":
}
]
}
],
"job_type_id": ,
"priority": ,
"skill_ids": [
],
"sla_deadline":
}

Antworten

‹Auftragsanfragen auflistenZurück
Buchungsverfügbarkeit›Weiter