*API REST › Objetos › Operaciones*

# Servicio

> Línea vendible que no procede del inventario: personal, transporte, jornadas de trabajo.

Una línea vendible que no procede del inventario: personal, transporte o jornadas de trabajo. Un servicio indica si aparece en el planificador y si está incluido en el precio, y puede llevar requisitos. El coste del servicio y su nombre interno no se publican.

Esquemas: `ServiceDto`

## Atributos

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `id` | string | Identificador único del servicio. |
| `name` | string | Nombre del servicio tal como lo ve el cliente. |
| `serviceType` | string | Tipo: crew (personal), fleet (vehículos) o general. |
| `description` | string | Descripción; null si no tiene. |
| `defaultQty` | integer | Cantidad que se añade por defecto a un pedido. |
| `showInPlanner` | boolean | Si aparece como servicio planificable. |
| `includeInPrice` | boolean | Si su importe cuenta para el total del documento. |
| `collectionName` | string | Ruta de la colección a la que pertenece; null si no está en ninguna. |
| `tags` | object[] | Etiquetas del servicio, con su identificador y nombre. |
| `tags.id` | string | Identificador único de la etiqueta. |
| `tags.name` | string | Nombre de la etiqueta. |
| `requirements` | object[] | Recursos necesarios para prestarlo. |
| `requirements.requiredResourceType` | string | Lo necesario para prestarlo: personal o vehículo. `personnel`, `vehicle` |
| `requirements.qty` | integer | Cuántos hacen falta. |
| `requirements.requiredTags` | string[] | Etiquetas que debe tener el recurso asignado. Ej.: "Carné C". |
| `createdAt` | string<date-time> | Fecha de creación en ISO 8601 UTC; null si no consta. |
| `updatedAt` | string<date-time> | Fecha de la última modificación en ISO 8601 UTC; null si no está registrada. |

## Ejemplo

*Service · Generado a partir del esquema*

```json
{
  "id": "id_8f2a1c",
  "name": "Example",
  "serviceType": "string",
  "description": "string",
  "defaultQty": 1,
  "showInPlanner": true,
  "includeInPrice": true,
  "collectionName": "Example",
  "tags": [
    {
      "id": "id_8f2a1c",
      "name": "Example"
    }
  ],
  "requirements": [
    {
      "requiredResourceType": "personnel",
      "qty": 1,
      "requiredTags": [
        "string"
      ]
    }
  ],
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z"
}
```

## Lo devuelven

- [`GET /api/v1/services`](https://docs.filmo.io/es/rest-api/endpoint-reference/services/list-services) — Listar servicios
- [`GET /api/v1/services/{serviceId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/services/get-a-service) — Obtener un servicio

## Lo modifican

- [`POST /api/v1/services`](https://docs.filmo.io/es/rest-api/endpoint-reference/services/create-a-service) — Crear un servicio
- [`PATCH /api/v1/services/{serviceId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/services/update-a-service) — Actualizar un servicio

---

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