Scan Types

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

Tarama Türlerine Genel Bakış

Yomio Her biri farklı bir belge türü için optimize edilmiş üç tarama türü sunar. Doğru türü seçmek, başarılı veri çıkarımı için en önemli faktördür.

🧾

Receipt

Engine: Azure Belge Zekası

Best for: Physical paper receipts photographed with your camera
Examples: Market fişleri, restoran hesapları, perakende mağaza fişleri, benzin istasyonu fişleri
Limitations: Only works with photos of actual paper receipts. Screenshots, web pages, and digital orders will fail.
How it works: Görüntü, milyonlarca gerçek fiş fotoğrafı üzerinde eğitilmiş özel bir OCR modeli olan Azure DI prebuilt-receipt modeline gönderilir.
📄

Fatura

Engine: Azure Belge Zekası

Best for: Formal invoices, bills, and structured financial documents
Examples: Müteahhit faturaları, kamu hizmetleri faturaları, yazılım abonelikleri, serbest çalışan faturaları
Limitations: Best with clean digital documents. Handwritten or annotated invoices may have reduced accuracy.
How it works: Görüntü, faturaya özgü alanları tanıyan Azure DI’nin hazır fatura modeline gönderilir.
📋

Other

Engine: GPT-4o Vision (OpenRouter)

Best for: Screenshots, web pages, email confirmations, and anything non-standard
Examples: Web sitesi alışveriş sepeti ekran görüntüleri, sipariş onay sayfaları, e-posta makbuzları, teklifler, fiyat tahminleri
Limitations: Belirli bir sınırlama yoktur — metin içeren hemen hemen her türlü görüntüyü işleyebilir.
How it works: Görüntü, GPT-4o’ya gönderilir — bu, görüntüyü görsel olarak okuyan ve yapılandırılmış verileri ayıklayan çok modlu bir yapay zekadır. Ayrı bir OCR adımı yoktur. Öğeler otomatik olarak kategorize edilir.

Hızlı Karar Kılavuzu

Hangi türü seçeceğinizden emin değil misiniz? Şu adımları izleyin:

1

Is it a physical paper receipt from a store or restaurant?

→ Choose: Makbuz

2

Is it a formal invoice or bill (PDF or print)?

→ Choose: Fatura

3

Bu bir ekran görüntüsü mü, web sayfası mı, e-posta mı yoksa dijital sipariş mi?

→ Choose: Other

4

Makbuz veya fatura bir hata nedeniyle başarısız mı oldu?

→ Choose: Diğer (bu türle yeniden dene)

Sık Karşılaşılan Arıza Senaryoları

İşte en sık yapılan hatalar ve bunların nasıl düzeltileceği:

ScenarioYou choseResultShould beWhy
Screenshot of a website shopping cart (Walmart, Amazon, IKEA, etc.)Makbuz❌ HATA — OCR_FAILEDOtherAzure DI makbuz modeli, kağıt makbuzun bir fotoğrafını bekler. Bir web sitesinin ekran görüntüsünün düzeni, yazı tipleri ve kontrastı farklı olduğundan model bunları çözümleyemez.
Screenshot of an order confirmation emailMakbuz❌ ERROR — OCR_FAILEDDiğerSebep aynı — e-posta düzenleri makbuzlara benzemiyor.
Photo of a computer monitor showing a receipt PDFMakbuz❌ HATA — OCR_FAILEDDiğerScreen glare, Moiré patterns, and pixel grid artifacts prevent the OCR model from reading the text reliably.
Kağıt market fişinin fotoğrafıMakbuz✅ SuccessMakbuzStandard use case — works as expected.
Bir yükleniciden gelen PDF faturaInvoice✅ BaşarıFaturaStandart kullanım senaryosu — beklendiği gibi çalışıyor.

⚠️Önemli

"Makbuz" veya "Fatura" türüyle yapılan tarama başarısız olursa, aynı görüntüyü YENİDEN yüklemeyin. Bunun yerine, "Diğer" türünü kullanarak yeniden deneyin — bu tür, standart dışı belgeleri işleyebilen tamamen farklı bir yapay zeka motoru (GPT-4o vision) kullanır.

Nasıl Çalışır?

Her tarama türü, görüntünüzü farklı bir yapay zeka iş akışına yönlendirir:

Receipt / Invoice pipeline (v1)

Route: POST /belgeler · Engine: Azure Belge Zekası

  1. Dosya doğrulama ve S3'e yükleme
  2. Azure DI OCR (prebuilt-receipt or prebuilt-invoice)
  3. Yanıtın yapılandırılmış verilere ayrıştırılması
  4. Kalemlerle gider oluşturma (ayrı bir LLM çağrısı yoluyla kategorize edilir)

Diğer boru hattı (v2)

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

  1. File validation and S3 upload
  2. Görüntü optimizasyonu (otomatik döndürme, yeniden boyutlandırma, netleştirme, kontrast)
  3. GPT-4o, görüntüyü okur ve yapılandırılmış bir JSON verisi döndürür
  4. Önceden kategorize edilmiş kalemlerle gider oluşturma (ayrı bir LLM adımı yok)

İpuçları ve En İyi Uygulamalar

✅ Do

  • Take a photo of the physical receipt when possible — it works best with Receipt type
  • Ekran görüntüsü, web sayfası, e-posta veya dijital belge için “Diğer” seçeneğini kullanın
  • Tarama başarısız olursa, yeniden yüklemeden önce “Diğer” seçeneğiyle tekrar deneyin
  • Ensure good lighting and keep the document flat for best results

❌ Don't

  • Web sitesi ekran görüntüleri için Receipt'i kullanmayın — işlem başarısız olur
  • Aynı görüntüyü iki kez yüklemeyin — sadece tarama türünü değiştirin
  • Don't use screenshots of screens (monitor/phone showing a document) with Receipt type