# Estados y motivos
> Los estados de un archivo y los motivos por los que no se leyó, y qué hacer en cada caso.
>
> Antes: [Enviar un archivo y leerlo](https://ocost.io/docs/es/files.md)

Cada archivo tiene un `status` que dice hasta dónde ha llegado Ocost con él. Un archivo que no se leyó también tiene un `reason`. Decide según ambos.

## Estados

| Estado | Significado | Qué hacer |
| --- | --- | --- |
| `received` | Guardado, aún sin leer. | Espera. |
| `reading` | Se está leyendo. | Espera. |
| `read` | Leído. `documents` lista lo que contiene. | Lee sus documentos. |
| `not_read` | Guardado, pero no leído. | Mira `reason`. |
| `failed` | Ocost no pudo leerlo. | Mira `reason`. |
| `needs_company` | Leído, pero falta decir a qué sociedad del grupo pertenece. `candidates` las lista. | Hacer `PATCH` con `business_id`, o esperar. Ver [Grupos de empresas](https://ocost.io/docs/es/groups.md). |

> [!NOTE]
> Mientras ningún servicio de lectura responde, un archivo sigue en `reading`. Ocost lo vuelve a intentar durante hasta un día.

## Esperando a su sociedad

Un archivo enviado con la clave de un grupo espera como `needs_company` cuando su documento nombra varias sociedades del grupo, u otra solo por su nombre. Cada uno de sus `candidates` dice `why`: un identificador impreso en el documento, `name` o `home`.

En Ocost, el propietario o el contable responde en Hoy › Asignar, o en Archivos › Aún sin asignar. Ocost propone el primer candidato, salvo que sea `home`. El archivo pasa entonces a esa sociedad y se lee allí. Un archivo enviado a la dirección propia del grupo espera en la bandeja del grupo hasta que su sociedad esté clara. Ninguna clave llega a esa bandeja. [Grupos de empresas](https://ocost.io/docs/es/groups.md#asignar-un-archivo-en-espera) muestra la misma respuesta con `PATCH`.

## Motivos

| Motivo | Con | Significado |
| --- | --- | --- |
| `limit` | `not_read` | Los documentos del mes se han agotado. Ocost lee el archivo por sí solo en `renews_on`. |
| `model_off` | `not_read` | Esta empresa no hace leer los PDF ni las imágenes. Las facturas electrónicas se siguen leyendo. Cuando lo haga, envía los mismos bytes otra vez. |
| `nothing_found` | `not_read` | El archivo no contiene ningún documento. |
| `too_large` | `not_read` | Demasiadas páginas, o una imagen demasiado grande. |
| `damaged` | `failed` | No es un archivo que Ocost pueda abrir. |
| `unavailable` | `failed` | Ningún servicio de lectura respondió durante un día. Envía los mismos bytes otra vez para reintentar. |
| `failed` | `failed` | La lectura falló o fue rechazada. Ocost vuelve a intentar una lectura fallida 10 y 60 minutos después. Envía los mismos bytes otra vez para reintentar antes. |
| `other` | cualquiera | Un motivo que esta versión de la API aún no nombra. |

## Enviarlo otra vez

Enviar los mismos bytes otra vez responde el mismo archivo, con el mismo `id`. Ocost lo cuenta una vez. Por tres motivos vuelve a leer el archivo a partir de los bytes que guarda, y el archivo pasa a `reading`:

| Motivo | Se vuelve a leer |
| --- | --- |
| `unavailable` | Cada vez que lo envías. |
| `failed` | Cada vez que lo envías, a partir de un minuto después del fallo. Un archivo que el modelo rechazó se vuelve a leer una vez. |
| `model_off` | Cuando la empresa tiene un modelo de lectura. |

Por cualquier otro motivo, enviarlo otra vez no cambia nada. No borres un archivo para enviarlo otra vez: un archivo nuevo se vuelve a contar. Un archivo ya leído conserva su lectura cuando mejora el lector de Ocost. Solo «Volver a leer» en Archivos lo lee de nuevo.

## Un ejemplo

Un archivo enviado después de agotarse los documentos del mes:

```json
{
  "id": "01a1b08c-6e3a-7562-8f4a-7924722667b1",
  "name": "invoice.pdf",
  "status": "not_read",
  "reason": "limit",
  "renews_on": "2026-12-01",
  "documents": []
}
```

Ocost lo lee el 1 de diciembre, o antes si el plan crece. Sigue consultando o [mantente sincronizado](https://ocost.io/docs/es/sync.md), y aparece como `read`.

## Archivos largos

Ocost lee solo las primeras páginas de un PDF largo. `pages` cuenta las páginas del archivo, y `pages_read` dice cuántas se leyeron. `pages_read` es `null` cuando Ocost las leyó todas.

## Véase también

- [Enviar un archivo y leerlo](https://ocost.io/docs/es/files.md): Enviar un archivo, reenviarlo sin riesgo, esperar hasta que esté leído, leer sus documentos, obtener el original, borrarlo.
- [Límites y errores](https://ocost.io/docs/es/limits.md): Los documentos al mes del plan, los límites de frecuencia, los tamaños, los errores RFC 9457, los reintentos y dónde se guardan los datos.
- [Grupos de empresas](https://ocost.io/docs/es/groups.md): Grupos de empresas: a qué sociedades llega una clave, la cabecera Ocost-Business, el enrutado por los identificadores del documento, needs_company y los archivos del grupo.
