*API REST › Objetos › Operaciones*

# Servicio del planificador

> Servicio de personal o de flota pendiente de cobertura, o ya cubierto.

Un servicio de personal o de flota de un pedido que está pendiente de cobertura o ya cubierto. Cuando `staffMemberId` y `vehicleId` son null, el servicio está sin cubrir. El identificador que usas para asignarlo es `orderServiceId`, no un `id`. Lista los servicios de una ventana de fechas con [`GET /api/v1/planner/services`](https://docs.filmo.io/es/rest-api/endpoint-reference/planner/list-the-services-to-cover).

Esquemas: `PlannerServiceDto`

## Atributos

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `orderServiceId` | string | Identificador de la línea de servicio. Es el que se pasa al asignar. |
| `rowKind` | string | 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`. `summary`, `detail` |
| `orderId` | string | Pedido al que está asociado el servicio; una cadena vacía en los servicios internos, que no pertenecen a ningún pedido. |
| `orderNumber` | string | Número legible de ese pedido; una cadena vacía en los servicios internos. |
| `orderStatus` | string | Estado del pedido. |
| `contactName` | string | Cliente del pedido; null si no consta. |
| `projectId` | string | Proyecto asociado; null si no aplica. |
| `projectName` | string | Nombre del proyecto; null si no procede. |
| `serviceId` | string | Servicio del catálogo del que procede. |
| `serviceName` | string | Nombre del servicio. |
| `serviceType` | string | Tipo: crew, fleet o general. |
| `staffMemberId` | string | Miembro del personal asignado. Solo lo llevan las filas `detail`; es null en la fila `summary` aunque el servicio esté cubierto. |
| `vehicleId` | string | Vehículo asignado. Solo lo llevan las filas `detail`; es null en la fila `summary` aunque el servicio esté cubierto. |
| `startDate` | string<date-time> | Inicio del servicio en ISO 8601 UTC. |
| `endDate` | string<date-time> | Fin del servicio en ISO 8601 UTC. |
| `status` | string | Estado de la línea de servicio. |
| `qty` | number | Cuántas unidades del servicio se solicitan. |
| `taskId` | string | Tarea de la agenda vinculada; null si no hay ninguna. |
| `requirements` | object[] | Recursos necesarios para cubrirlo. |
| `requirements.requiredResourceType` | string | Lo necesario: personal o vehículo. `personnel`, `vehicle` |
| `requirements.qty` | number | Cuántos hacen falta. |

## Valores

| Campo | Valores |
| --- | --- |
| `rowKind` | `summary`, `detail` |

## Ejemplo

*Planner service · Generado a partir del esquema*

```json
{
  "orderServiceId": "string",
  "rowKind": "summary",
  "orderId": "string",
  "orderNumber": "string",
  "orderStatus": "string",
  "contactName": "Example",
  "projectId": "string",
  "projectName": "Example",
  "serviceId": "string",
  "serviceName": "Example",
  "serviceType": "string",
  "staffMemberId": "string",
  "vehicleId": "string",
  "startDate": "2026-09-01T08:00:00Z",
  "endDate": "2026-09-01T08:00:00Z",
  "status": "string",
  "qty": 1,
  "taskId": "string",
  "requirements": [
    {
      "requiredResourceType": "personnel",
      "qty": 1
    }
  ]
}
```

## Lo devuelven

- [`GET /api/v1/planner/services`](https://docs.filmo.io/es/rest-api/endpoint-reference/planner/list-the-services-to-cover) — Listar los servicios por cubrir

## Lo modifican

Ninguna operación.

---

URL canónica: https://docs.filmo.io/es/rest-api/objects/planner-service  
Última actualización: 2026-10-25