Статуси та причини
Кожен файл має status, який каже, наскільки далеко Ocost просунувся з ним. Файл, який не прочитано, має також reason. Розгалужуйте логіку за обома.
Статуси
| Статус | Зміст | Що робити |
|---|---|---|
received | Збережено, ще не прочитано. | Чекайте. |
reading | Читається. | Чекайте. |
read | Прочитано. documents перелічує, що в ньому є. | Прочитайте його документи. |
not_read | Збережено, але не прочитано. | Подивіться reason. |
failed | Ocost не зміг його прочитати. | Подивіться reason. |
needs_company | Прочитано, але невідомо, до якої компанії групи він належить. candidates їх перелічує. | PATCH з business_id або чекайте. Див. Групи компаній. |
Примітка
Поки жодна служба читання не відповідає, файл залишається в reading. Ocost пробує знову протягом доби.
Очікує на свою компанію
Файл, надісланий ключем групи, чекає як needs_company, коли його документ називає кілька компаній групи або іншу компанію лише за назвою. Кожен із його candidates каже why: ідентифікатор, надрукований у документі, name або home.
В Ocost власник або бухгалтер відповідає в розділі Сьогодні › Розподілити або в розділі Файли › Ще не розподілено. Ocost пропонує першого кандидата, якщо це не home. Потім файл переходить до тієї компанії і читається там. Файл, надісланий поштою на власну адресу групи, чекає у вхідних групи, доки його компанія не стане зрозумілою. Жоден ключ не сягає цих вхідних. Групи компаній показує ту саму відповідь через 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 покращується. Лише «Прочитати знову» у «Файлах» читає його наново.
Приклад
Файл, надісланий після того, як документи місяця закінчилися:
{
"id": "01a1b08c-6e3a-7562-8f4a-7924722667b1",
"name": "invoice.pdf",
"status": "not_read",
"reason": "limit",
"renews_on": "2026-12-01",
"documents": []
}Ocost прочитає його 1 грудня або раніше, щойно тариф зросте. Продовжуйте опитування або синхронізуйтеся, і файл з’явиться як read.
Довгі файли
Ocost читає лише перші сторінки довгого PDF. pages рахує сторінки файлу, а pages_read каже, скільки з них прочитано. pages_read дорівнює null, коли Ocost прочитав усі.