Статуси та причини

Кожен файл має status, який каже, наскільки далеко Ocost просунувся з ним. Файл, який не прочитано, має також reason. Розгалужуйте логіку за обома.

Статуси

СтатусЗмістЩо робити
receivedЗбережено, ще не прочитано.Чекайте.
readingЧитається.Чекайте.
readПрочитано. documents перелічує, що в ньому є.Прочитайте його документи.
not_readЗбережено, але не прочитано.Подивіться reason.
failedOcost не зміг його прочитати.Подивіться reason.
needs_companyПрочитано, але невідомо, до якої компанії групи він належить. candidates їх перелічує.PATCH з business_id або чекайте. Див. Групи компаній.

Примітка

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

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

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

В Ocost власник або бухгалтер відповідає в розділі Сьогодні › Розподілити або в розділі Файли › Ще не розподілено. Ocost пропонує першого кандидата, якщо це не home. Потім файл переходить до тієї компанії і читається там. Файл, надісланий поштою на власну адресу групи, чекає у вхідних групи, доки його компанія не стане зрозумілою. Жоден ключ не сягає цих вхідних. Групи компаній показує ту саму відповідь через PATCH.

Причини

ПричинаЗі статусомЗміст
limitnot_readДокументи цього місяця вичерпано. Ocost сам прочитає файл у день renews_on.
model_offnot_readДля цієї компанії PDF і зображення не читаються. Електронні рахунки читаються й далі. Щойно читання ввімкнуть, надішліть ті самі байти знову.
nothing_foundnot_readФайл не містить документа.
too_largenot_readЗабагато сторінок або завелике зображення.
damagedfailedЦе не файл, який Ocost може відкрити.
unavailablefailedЖодна служба читання не відповідала протягом доби. Надішліть ті самі байти знову, щоб повторити спробу.
failedfailedЧитання не вдалося або його відхилено. 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 грудня або раніше, щойно тариф зросте. Продовжуйте опитування або синхронізуйтеся, і файл з’явиться як read.

Довгі файли

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

Див. також