*API REST › Objetos › Operaciones*

# Incidencia

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

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.

Esquemas: `IncidentDto`

## Atributos

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `id` | string | Identificador único de la incidencia. |
| `identifier` | string | Número de incidencia legible. |
| `title` | string | Título corto de la incidencia. |
| `description` | string | Descripción; null si no tiene. |
| `type` | string | Naturaleza: damage, loss, malfunction, cosmetic, theft o custom. |
| `scope` | string | A qué afecta: item, serializedItem, space, kit, vehicle o custom. `item`, `serializedItem`, `space`, `kit`, `vehicle`, `custom` |
| `status` | string | Estado del ciclo de vida: draft, open, waiting, repairing, complete o lost. |
| `priority` | string | Prioridad: urgent, high, medium, low o none. |
| `severity` | string | Gravedad declarada. |
| `blocksAvailability` | boolean | true cuando la incidencia retira el material del conjunto disponible. |
| `affectedQuantity` | integer | Unidades afectadas en stock a granel; null cuando no aplica. |
| `itemId` | string | Artículo afectado; null si no aplica. |
| `serializedItemId` | string | Unidad física afectada; null si no aplica. |
| `spaceId` | string | Espacio afectado; null si no aplica. |
| `vehicleId` | string | Vehículo afectado; null si no aplica. |
| `orderId` | string | Pedido en el que se detectó; null si no procede. |
| `projectId` | string | Proyecto asociado; null si no aplica. |
| `dueDate` | string<date-time> | Fecha objetivo de resolución en ISO 8601 UTC; null si no tiene. |
| `commentCount` | integer | Comentarios que tiene la incidencia. |
| `createdAt` | string<date-time> | Fecha de creación en ISO 8601 UTC. |
| `updatedAt` | string<date-time> | Fecha de la última modificación en ISO 8601 UTC. |

## Valores

| Campo | Valores |
| --- | --- |
| `scope` | `item`, `serializedItem`, `space`, `kit`, `vehicle`, `custom` |

## Ejemplo

*Incident · Generado a partir del esquema*

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

## Lo devuelven

- [`GET /api/v1/incidents`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/list-incidents) — Listar incidencias
- [`GET /api/v1/incidents/{incidentId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/get-an-incident) — Obtener una incidencia

## Lo modifican

- [`POST /api/v1/incidents`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/open-an-incident) — Abrir una incidencia
- [`PATCH /api/v1/incidents/{incidentId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/update-an-incident) — Actualizar una incidencia
- [`POST /api/v1/incidents/{incidentId}/comments`](https://docs.filmo.io/es/rest-api/endpoint-reference/incidents/comment-on-an-incident) — Comentar una incidencia

---

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