Planificador
Listar los servicios por cubrir
Devuelve los servicios de personal y flota de una ventana de fechas, con quién los cubre y qué recursos hacen falta.
Ejemplos de petición
curl 'https://app.filmo.io/api/v1/planner/services?startDate=2026-09-01T08%3A00%3A00Z&endDate=2026-09-01T08%3A00%3A00Z' \
--header "Authorization: Bearer $FILMO_API_KEY"Generado a partir del esquema
Devuelve FILAS, no servicios: cada servicio llega como una fila summary (rowKind: summary, con staffMemberId y vehicleId siempre null) y una fila detail por cada persona o vehículo asignado, todas con el mismo orderServiceId. Agrupa por orderServiceId: un servicio está sin cubrir cuando solo tiene su fila summary, y cubierto cuando tiene filas detail con una persona asignada, así que un null en la fila de resumen no significa "sin cubrir". Los servicios internos (no ligados a un pedido) llegan con orderId y orderNumber vacíos y un serviceId que empieza por is_. El identificador que se usa para asignar es orderServiceId.
Autorizaciones
Clave de API como Bearer, con el permiso de abajo. planner:read
Parámetros de consulta
Inicio de la ventana, en ISO 8601 con desplazamiento.
Fin de la ventana, en ISO 8601 con desplazamiento.
Qué servicios obtener. Por defecto, ambos.
Opciones disponibles: crew, fleet, both
Filtra por estado del pedido al que están asociados.
Opciones disponibles: draft, reserved, all
Limita a un proyecto.
Límites: longitud mín. 1, longitud máx. 100
Respuesta
Respuesta correcta.
Esquema de la respuesta: PlannerServiceDto
Sobre: PlannerServiceItems. meta. solo aparece cuando la operación está obsoleta.
Cabeceras: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Mostrar atributos hijosOcultar atributos hijos
Identificador de la línea de servicio. Es el que se pasa al asignar.
Qué fila es esta. Un servicio llega como UNA fila summary (el propio servicio, con staffMemberId y vehicleId siempre null) más una fila detail por cada persona o vehículo asignado, todas con el mismo orderServiceId. Un servicio está cubierto cuando tiene filas detail con un asignado, y descubierto cuando solo tiene la fila summary.
Opciones disponibles: summary, detail
Pedido al que está asociado el servicio; una cadena vacía en los servicios internos, que no pertenecen a ningún pedido.
Número legible de ese pedido; una cadena vacía en los servicios internos.
Estado del pedido.
Cliente del pedido; null si no consta.
Proyecto asociado; null si no aplica.
Nombre del proyecto; null si no procede.
Servicio del catálogo del que procede.
Nombre del servicio.
Tipo: crew, fleet o general.
Miembro del personal asignado. Solo lo llevan las filas detail; es null en la fila summary aunque el servicio esté cubierto.
Vehículo asignado. Solo lo llevan las filas detail; es null en la fila summary aunque el servicio esté cubierto.
Inicio del servicio en ISO 8601 UTC.
Fin del servicio en ISO 8601 UTC.
Estado de la línea de servicio.
Cuántas unidades del servicio se solicitan.
Tarea de la agenda vinculada; null si no hay ninguna.
Recursos necesarios para cubrirlo.
Mostrar atributos hijosOcultar atributos hijos
Lo necesario: personal o vehículo.
Opciones disponibles: personnel, vehicle
Cuántos hacen falta.
Información adicional sobre la respuesta.
Mostrar atributos hijosOcultar atributos hijos
Avisos del ciclo de vida; solo aparecen cuando la operación está obsoleta.
Mostrar atributos hijosOcultar atributos hijos
Código de aviso estable.
Opciones disponibles: deprecated
Para personas: qué está obsoleto, hasta cuándo y qué usar.
Día (YYYY-MM-DD) en que la operación deja de estar disponible.
operationId de la operación que hay que usar en su lugar, o null si no hay ninguna.
Dónde está documentada la deprecación (el changelog).
Petición no válida (validation_error): consulta o cuerpo mal formados. errors[] enumera cada campo erróneo con su código estable.
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Fallo de autenticación (unauthorized, api_key_invalid, api_key_revoked, api_key_expired, api_key_owner_inactive, api_key_owner_not_admin).
Cabeceras: X-Request-Id · Content-Language
No permitido (insufficient_scope: la clave de API no tiene el scope requerido, indicado en requiredScope; forbidden: el propietario de la clave carece del permiso que exige la operación). insufficient_scope se responde antes de que la petición cuente contra el límite de peticiones, así que no lleva cabeceras RateLimit-*; forbidden sí.
Cabeceras: X-Request-Id · Content-Language
Límite de peticiones superado (rate_limited): reintenta tras Retry-After segundos; RateLimit-* indica qué cuota se ha agotado.
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · Retry-After
Error interno (internal_error).
Cabeceras: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Errores
| Estado | Códigos | Significado |
|---|---|---|
| 400 | validation_error | Consulta o cuerpo mal formados. errors[] enumera cada campo erróneo con su código estable. |
401, 403, 429, 500 los puede devolver cualquier operación. Errores
Obsolescencia
Esta operación no está obsoleta. Las obsolescencias se anuncian con la cabecera Deprecation y una fecha de retirada. Política de versiones
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasOperaciones
Servicio del planificador
Servicio de personal o de flota pendiente de cobertura, o ya cubierto.
¿Te ha resultado útil esta página?