# Статусы и причины
> Статусы файла и причины, по которым он не прочитан, и что делать в каждом случае.
>
> Сначала: [Отправить файл и прочитать](https://ocost.io/docs/ru/files.md)

У каждого файла есть `status`, который говорит, насколько далеко Ocost продвинулся с ним. У непрочитанного файла есть ещё `reason`. Стройте логику на обоих.

## Статусы

| Статус | Смысл | Что делать |
| --- | --- | --- |
| `received` | Сохранён, ещё не прочитан. | Ждать. |
| `reading` | Читается. | Ждать. |
| `read` | Прочитан. `documents` перечисляет, что в нём. | Прочитать его документы. |
| `not_read` | Сохранён, но не прочитан. | Посмотреть `reason`. |
| `failed` | Ocost не смог его прочитать. | Посмотреть `reason`. |
| `needs_company` | Прочитан, но неясно, к какой компании группы он относится. `candidates` их перечисляет. | `PATCH` с `business_id` или ждите. См. [Группы компаний](https://ocost.io/docs/ru/groups.md). |

> [!NOTE]
> Пока ни один сервис чтения не отвечает, файл остаётся в статусе `reading`. Ocost повторяет попытки до суток.

## Ожидает свою компанию

Файл, отправленный ключом группы, ждёт как `needs_company`, когда его документ называет несколько компаний группы или другую компанию только по названию. Каждый из его `candidates` говорит `why`: идентификатор, напечатанный в документе, `name` или `home`.

В Ocost владелец или бухгалтер отвечает в разделе Сегодня › Распределить или в разделе Файлы › Ещё не распределено. Ocost предлагает первого кандидата, если это не `home`. Затем файл переходит в эту компанию и читается там. Файл, присланный на собственный адрес группы, ждёт во входящих группы, пока его компания не станет ясна. Ни один ключ не достаёт до этих входящих. [Группы компаний](https://ocost.io/docs/ru/groups.md#назначьте-ожидающии-фаил) показывает тот же ответ через `PATCH`.

## Причины

| Причина | При статусе | Смысл |
| --- | --- | --- |
| `limit` | `not_read` | Документы месяца исчерпаны. Ocost сам прочитает файл в день `renews_on`. |
| `model_off` | `not_read` | Для этой компании PDF и изображения не читаются. Электронные счета по-прежнему читаются. Когда чтение включат, отправьте те же байты снова. |
| `nothing_found` | `not_read` | В файле нет документа. |
| `too_large` | `not_read` | Слишком много страниц или слишком большое изображение. |
| `damaged` | `failed` | Это не файл, который Ocost может открыть. |
| `unavailable` | `failed` | Ни один сервис чтения не отвечал сутки. Отправьте те же байты снова, чтобы повторить. |
| `failed` | `failed` | Чтение не удалось или было отклонено. Ocost повторяет неудавшееся чтение через 10 и через 60 минут. Чтобы повторить раньше, отправьте те же байты снова. |
| `other` | любом | Причина, которую эта версия API ещё не называет. |

## Повторная отправка

На те же байты Ocost отвечает тем же файлом, с тем же `id`. Ocost засчитывает его один раз. По трём причинам он читает файл снова из сохранённых байтов, и файл переходит в `reading`:

| Причина | Читается снова |
| --- | --- |
| `unavailable` | При каждой отправке. |
| `failed` | При каждой отправке, начиная через минуту после неудачи. Файл, который модель отклонила, читается снова один раз. |
| `model_off` | Когда у компании появится модель для чтения. |

При любой другой причине повторная отправка ничего не меняет. Не удаляйте файл, чтобы отправить его снова: новый файл засчитывается заново. Прочитанный файл сохраняет своё прочтение, когда читатель Ocost улучшается. Только «Прочитать заново» в «Файлах» читает его снова.

## Пример

Файл, отправленный после того, как документы месяца закончились:

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

Ocost прочитает его 1 декабря или раньше, если тариф станет больше. Продолжайте опрос или [синхронизируйтесь](https://ocost.io/docs/ru/sync.md), и файл появится со статусом `read`.

## Длинные файлы

Ocost читает только первые страницы длинного PDF. `pages` считает страницы файла, а `pages_read` говорит, сколько из них прочитано. `pages_read` равно `null`, когда Ocost прочитал все.

## См. также

- [Отправить файл и прочитать](https://ocost.io/docs/ru/files.md): Отправить файл, безопасно отправить его повторно, дождаться чтения, прочитать его документы, получить оригинал, удалить его.
- [Лимиты и ошибки](https://ocost.io/docs/ru/limits.md): Документы тарифа в месяц, лимиты частоты, размеры, ошибки RFC 9457, повторы и где хранятся данные.
- [Группы компаний](https://ocost.io/docs/ru/groups.md): Группы компаний: до каких компаний достаёт ключ, заголовок Ocost-Business, перенаправление по кодам документа, needs_company и файлы в группе.
