crisphive
Réservations›Créer une demande d'intervention (acteur entreprise)

Créer une demande d'intervention (acteur entreprise)

Books a field-service job — the work order that enters the dispatch & scheduling pipeline. Send the customer's UUID plus requested `job_dates` (date + morning/afternoon/evening periods, ideally offered from GET /job-requests/booking-windows), optional `job_type_id` (service catalog), `skill_ids` (required technician qualifications) and a free-text description. Quoting, technician/crew assignment and completion then advance the work order through the business's workflow.

Arguments

X-Timezonestringheaderoptionnel
Fuseau horaire IANA du client
customer_idstringbodyrequis
UUID d'un client existant de cette entreprise pour lequel réserver l'intervention. Requis.
descriptionstringbodyoptionnel
Description libre des travaux demandés. Facultative ; 2000 caractères max.
▾job_datesarray<object>bodyrequis
Date(s) et période(s) souhaitées par le client pour l'intervention. Au moins une, jusqu'à 12.
datestringbodyrequis
Jour calendaire demandé (YYYY-MM-DD), dans le fuseau du client. Requis.
▾periodsarray<object>bodyrequis
Une ou plusieurs périodes de la journée demandées pour cette date. Au moins une, jusqu'à 3.
business_viewarray<object>bodyoptionnel
Plages horaires locales de l'entreprise auxquelles la période correspond (reprises de booking-windows). Facultatif.
periodenumbodyrequis
Période de la journée demandée par le client. Requis.
job_type_idstringbodyoptionnel
UUID du type d'intervention pour classer cette intervention. Facultatif ; null laisse l'intervention non classée.
skill_idsarray<string>bodyoptionnel
UUID des compétences souhaitées par le client pour cette intervention. Facultatif ; jusqu'à 20.
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": "2026-07-02T09:30:00Z",
      "periods": [
        {
          "business_view": [],
          "period": "morning"
        }
      ]
    }
  ],
  "job_type_id": "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01",
  "skill_ids": [
    "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01"
  ]
}'
Corps de la requête
{
"customer_id": ,
"description": ,
"job_dates": [
{
"date": ,
"periods": [
{
"business_view": [
],
"period":
}
]
}
],
"job_type_id": ,
"skill_ids": [
]
}

Réponses

‹Lister les demandes d'interventionPrécédent
Disponibilités de réservation (acteur entreprise)›Suivant