# Статуси та причини
> Статуси файлу і причини, з яких його не прочитано, і що робити в кожному випадку.
>
> Спершу: [Надіслати файл і прочитати](https://ocost.io/docs/uk/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/uk/groups.md). |

> [!NOTE]
> Поки жодна служба читання не відповідає, файл залишається в `reading`. Ocost пробує знову протягом доби.

## Очікує на свою компанію

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

В Ocost власник або бухгалтер відповідає в розділі Сьогодні › Розподілити або в розділі Файли › Ще не розподілено. Ocost пропонує першого кандидата, якщо це не `home`. Потім файл переходить до тієї компанії і читається там. Файл, надісланий поштою на власну адресу групи, чекає у вхідних групи, доки його компанія не стане зрозумілою. Жоден ключ не сягає цих вхідних. [Групи компаній](https://ocost.io/docs/uk/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 ще не називає. |

## Повторне надсилання

Ті самі байти, надіслані знову, повертають той самий файл із тим самим `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/uk/sync.md), і файл з’явиться як `read`.

## Довгі файли

Ocost читає лише перші сторінки довгого PDF. `pages` рахує сторінки файлу, а `pages_read` каже, скільки з них прочитано. `pages_read` дорівнює `null`, коли Ocost прочитав усі.

## Див. також

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