Crisphive
es
Reservas›Crear una solicitud de trabajo

Crear una solicitud de trabajo

Reserva un trabajo de servicio en campo — la orden de trabajo que entra en el pipeline de despacho y programación. Envíe el UUID del cliente junto con las `job_dates` solicitadas (fecha + franjas de mañana/tarde/noche, idealmente ofrecidas desde GET /job-requests/booking-windows), un `job_type_id` opcional (catálogo de servicios), `skill_ids` (cualificaciones requeridas del técnico) y una descripción de texto libre. La cotización, la asignación de técnico/cuadrilla y la finalización hacen avanzar después la orden de trabajo por el workflow del negocio.

Argumentos

X-Timezonestringheaderopcional
Zona horaria IANA del cliente
Idempotency-Keystringheaderopcional
Unique key making retries safe: a repeat send with the same key returns the original booking instead of creating a duplicate
customer_idstringbodyobligatorio
UUID de un cliente existente de este negocio para el que se reserva el trabajo. Obligatorio.
descriptionstringbodyopcional
Descripción de texto libre del trabajo solicitado. Opcional; máx. 2000 caracteres.
▾job_datesarray<object>bodyobligatorio
Fecha(s) y franja(s) en que el cliente solicita el trabajo. Al menos una, hasta 12.
datestringbodyobligatorio
Día natural solicitado (YYYY-MM-DD), en hora local del cliente. Obligatorio.
▾periodsarray<object>bodyobligatorio
Una o más franjas horarias del día solicitadas para esta fecha. Al menos una, hasta 3.
business_viewarray<object>bodyopcional
Rangos horarios en hora local del negocio a los que corresponde la franja (devueltos por booking-windows). Opcional.
periodenumbodyobligatorio
Franja horaria del día solicitada por el cliente. Obligatorio.
job_type_idstringbodyopcional
UUID del tipo de trabajo para clasificar este trabajo. Opcional; null deja el trabajo sin clasificar.
priorityenumbodyopcional
Prioridad de programación. Opcional; las reservas sin este valor reciben la configuración default_priority del negocio (ajustes de asignación, por defecto p2). p0=emergencia (inserción interruptiva), p1=máxima (solo desplazada por p0), p2=estándar, p3=aplazable (primer candidato al desplazamiento).
skill_idsarray<string>bodyopcional
UUID de las habilidades que el cliente desea para este trabajo. Opcional; hasta 20.
sla_deadlinestringbodyopcional
Fecha límite del SLA (datetime naive en hora local del negocio, p. ej. "2026-07-15T17:00:00"). Opcional; SOLO válida junto con priority=p1 — arma el reloj de auto-escalado (el trabajo escala a p0 cuando el riesgo de incumplimiento cruza el margen de seguridad del negocio). Debe estar en el futuro.
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"
}'
Cuerpo de la solicitud
{
"customer_id": ,
"description": ,
"job_dates": [
{
"date": ,
"periods": [
{
"business_view": [
],
"period":
}
]
}
],
"job_type_id": ,
"priority": ,
"skill_ids": [
],
"sla_deadline":
}

Respuestas

‹Listar solicitudes de trabajoAnterior
Disponibilidad de reserva›Siguiente