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

У каждого файла есть 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 ещё не называет.

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

На те же байты 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 декабря или раньше, если тариф станет больше. Продолжайте опрос или синхронизируйтесь, и файл появится со статусом read.

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

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

См. также