Scan Types

Choose the right scan type: Receipt, Invoice, or Other

Огляд типів сканування

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

🧾

Квитанція

Engine: Azure Document Intelligence

Best for: Physical paper receipts photographed with your camera
Examples: Чеки з продуктових магазинів, рахунки з ресторанів, касові чеки з роздрібних магазинів, квитанції з АЗС
Limitations: Працює лише з фотографіями справжніх паперових квитанцій. Знімки екрана, веб-сторінки та цифрові замовлення не будуть прийняті.
How it works: Image is sent to Azure DI prebuilt-receipt model — a specialised OCR trained on millions of real receipt photos.
📄

Рахунок-фактура

Engine: Azure Document Intelligence

Best for: Офіційні рахунки-фактури, рахунки та структуровані фінансові документи
Examples: Рахунки-фактури підрядників, рахунки за комунальні послуги, передплата на програмне забезпечення, рахунки-фактури фрілансерів
Limitations: Best with clean digital documents. Handwritten or annotated invoices may have reduced accuracy.
How it works: Зображення надсилається до вбудованої моделі рахунків-фактур Azure DI, яка розпізнає поля, характерні для рахунків-фактур.
📋

Інше

Engine: GPT-4o Vision (OpenRouter)

Best for: Скріншоти, веб-сторінки, підтвердження електронної пошти та будь-що нестандартне
Examples: Website shopping cart screenshots, order confirmation pages, email receipts, quotes, estimates
Limitations: Конкретних обмежень немає — обробляє практично будь-яке зображення, що містить текст.
How it works: Image is sent to GPT-4o — a multimodal AI that reads the image visually and extracts structured data. No separate OCR step. Items are categorised automatically.

Короткий посібник з прийняття рішень

Не знаєте, який тип вибрати? Дотримуйтесь таких вказівок:

1

Це паперова квитанція, отримана в магазині чи ресторані?

→ Choose: Квитанція

2

Це офіційний рахунок-фактура чи рахунок (у форматі PDF чи у друкованому вигляді)?

→ Choose: Invoice

3

Це скріншот, веб-сторінка, електронний лист чи цифрове замовлення?

→ Choose: Інше

4

Did Receipt or Invoice fail with an error?

→ Choose: Інше (спробуйте ще раз із цим типом)

Типові сценарії відмов

Ось найпоширеніші помилки та поради щодо їх виправлення:

ScenarioYou choseResultShould beWhy
Знімок екрана кошика на веб-сайті (Walmart, Amazon, IKEA тощо)Квитанція❌ ERROR — OCR_FAILEDOtherМодель розпізнавання квитанцій Azure DI розрахована на фотографію паперової квитанції. Знімок екрана веб-сайту має інше оформлення, шрифти та контрастність, які модель не може розпізнати.
Знімок екрана з електронним листом із підтвердженням замовленняReceipt❌ ПОМИЛКА — OCR_FAILEDІншеЗ тієї ж причини — макети електронних листів не схожі на квитанції.
Photo of a computer monitor showing a receipt PDFКвитанція❌ ПОМИЛКА — OCR_FAILEDOtherВідблиски на екрані, ефекти муару та артефакти піксельної сітки заважають моделі OCR надійно розпізнавати текст.
Photo of a paper grocery receiptКвитанція✅ УспіхReceiptСтандартний варіант використання — працює як очікується.
PDF-рахунок від підрядникаInvoice✅ УспіхРахунок-фактураStandard use case — works as expected.

⚠️Важливо

Якщо сканування документа типу «Квитанція» або «Рахунок-фактура» завершилося невдало, НЕ завантажуйте те саме зображення ще раз. Натомість спробуйте ще раз, вибравши тип «Інше» — для нього використовується зовсім інший механізм штучного інтелекту (GPT-4o vision), здатний обробляти нестандартні документи.

Як це працює

Кожен тип сканування направляє ваше зображення в окремий конвеєр штучного інтелекту:

Потік обробки квитанцій / рахунків-фактур (версія 1)

Route: POST /documents · Engine: Azure Document Intelligence

  1. Перевірка файлів та завантаження в S3
  2. Azure DI OCR (prebuilt-receipt або prebuilt-invoice)
  3. Response parsing into structured data
  4. Створення витрат із позиціями (класифікованими за допомогою окремого виклику LLM)

Other pipeline (v2)

Route: POST /v2/documents · Engine: GPT-4o Vision (OpenRouter)

  1. File validation and S3 upload
  2. Оптимізація зображень (автоматичне обертання, зміна розміру, підвищення різкості, регулювання контрасту)
  3. GPT-4o аналізує зображення та повертає структуровані дані у форматі JSON
  4. Expense creation with pre-categorised items (no separate LLM step)

Поради та найкращі практики

✅ Do

  • Якщо є можливість, сфотографуйте паперовий чек — найкраще це працює з типом «Чек»
  • Use Other for any screenshot, web page, email, or digital document
  • Якщо сканування не вдалося, спробуйте ще раз, вибравши варіант «Інше», перш ніж завантажувати файл знову
  • Для досягнення найкращих результатів забезпечте хороше освітлення та тримайте документ рівно

❌ Don't

  • Не використовуйте Receipt для створення скріншотів веб-сайтів — це не спрацює
  • Don't upload the same image twice — just change the scan type
  • Не використовуйте скріншоти екранів (монітора/телефону, на яких відображається документ) для типу квитанції