Operaciones

Servicio

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

Esquemas: ServiceDto

{
  "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"
}

Generado a partir del esquema

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.

Atributos

idstring

Identificador único del servicio.

namestring

Nombre del servicio tal como lo ve el cliente.

serviceTypestring

Tipo: crew (personal), fleet (vehículos) o general.

descriptionstring | null

Descripción; null si no tiene.

defaultQtyinteger

Cantidad que se añade por defecto a un pedido.

showInPlannerboolean

Si aparece como servicio planificable.

includeInPriceboolean

Si su importe cuenta para el total del documento.

collectionNamestring | null

Ruta de la colección a la que pertenece; null si no está en ninguna.

tagsobject[]

Etiquetas del servicio, con su identificador y nombre.

Mostrar atributos hijos

tags.idstring

Identificador único de la etiqueta.

tags.namestring

Nombre de la etiqueta.

requirementsobject[]

Recursos necesarios para prestarlo.

Mostrar atributos hijos

requirements.requiredResourceTypestring

Lo necesario para prestarlo: personal o vehículo.

Opciones disponibles: personnel, vehicle

requirements.qtyinteger

Cuántos hacen falta.

Límites: mín. 1

requirements.requiredTagsstring[]

Etiquetas que debe tener el recurso asignado. Ej.: "Carné C".

Límites: máx. 20 elementos, cada uno: longitud máx. 100

createdAtstring<date-time> | null

Fecha de creación en ISO 8601 UTC; null si no consta.

updatedAtstring<date-time> | null

Fecha de la última modificación en ISO 8601 UTC; null si no está registrada.

Lo devuelven

GET /api/v1/services — Listar servicios
GET /api/v1/services/{serviceId} — Obtener un servicio

Lo modifican

POST /api/v1/services — Crear un servicio
PATCH /api/v1/services/{serviceId} — Actualizar un servicio

¿Te ha resultado útil esta página?

Ejemplo

Atributos

Lo devuelven

Lo modifican