Operaciones

Incidencia

Material roto, perdido o que funciona mal, con su estado de reparación.

Esquemas: IncidentDto

{
  "id": "id_8f2a1c",
  "identifier": "string",
  "title": "Example",
  "description": "string",
  "type": "string",
  "scope": "item",
  "status": "string",
  "priority": "string",
  "severity": "string",
  "blocksAvailability": true,
  "affectedQuantity": 1,
  "itemId": "string",
  "serializedItemId": "string",
  "spaceId": "string",
  "vehicleId": "string",
  "orderId": "string",
  "projectId": "string",
  "dueDate": "2026-09-01T08:00:00Z",
  "commentCount": 1,
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z"
}

Generado a partir del esquema

Material roto, perdido o con mal funcionamiento, con su estado de reparación. Una incidencia apunta al artículo, la unidad serializada, el espacio, el vehículo, el pedido o el proyecto al que afecta, y blocksAvailability indica si saca stock de la disponibilidad. Necesita el add-on incidence: sin él la respuesta es 402, no 403. El coste de la reparación y la nota interna de resolución no se publican.

Atributos

idstring

Identificador único de la incidencia.

identifierstring

Número de incidencia legible.

titlestring

Título corto de la incidencia.

descriptionstring | null

Descripción; null si no tiene.

typestring

Naturaleza: damage, loss, malfunction, cosmetic, theft o custom.

scopestring

A qué afecta: item, serializedItem, space, kit, vehicle o custom.

Opciones disponibles: item, serializedItem, space, kit, vehicle, custom

statusstring

Estado del ciclo de vida: draft, open, waiting, repairing, complete o lost.

prioritystring

Prioridad: urgent, high, medium, low o none.

severitystring

Gravedad declarada.

blocksAvailabilityboolean

true cuando la incidencia retira el material del conjunto disponible.

affectedQuantityinteger | null

Unidades afectadas en stock a granel; null cuando no aplica.

itemIdstring | null

Artículo afectado; null si no aplica.

serializedItemIdstring | null

Unidad física afectada; null si no aplica.

spaceIdstring | null

Espacio afectado; null si no aplica.

vehicleIdstring | null

Vehículo afectado; null si no aplica.

orderIdstring | null

Pedido en el que se detectó; null si no procede.

projectIdstring | null

Proyecto asociado; null si no aplica.

dueDatestring<date-time> | null

Fecha objetivo de resolución en ISO 8601 UTC; null si no tiene.

commentCountinteger

Comentarios que tiene la incidencia.

createdAtstring<date-time>

Fecha de creación en ISO 8601 UTC.

updatedAtstring<date-time>

Fecha de la última modificación en ISO 8601 UTC.

Valores

scope: item, serializedItem, space, kit, vehicle, custom

Lo devuelven

GET /api/v1/incidents — Listar incidencias
GET /api/v1/incidents/{incidentId} — Obtener una incidencia

Lo modifican

POST /api/v1/incidents — Abrir una incidencia
PATCH /api/v1/incidents/{incidentId} — Actualizar una incidencia
POST /api/v1/incidents/{incidentId}/comments — Comentar una incidencia

¿Te ha resultado útil esta página?

Ejemplo

Atributos

Valores

Lo devuelven

Lo modifican