Formstep

n8n ile AI PDF okuma, belgeyi gönderen kişi onaylasın

n8n'de AI ile PDF okuma bazen bir rakamı yanlış alır. Formstep isteğini modelin okuduğuyla önceden doldurun; fatura gönderen onaylasın ya da düzeltsin.

Yazar , Formstep'in kurucusu · Yayınlandı · Güncellendi

Belgeleri AI ile okutmayı seviyorum, okuduğunu kontrolsüz deftere işlemeyi sevmiyorum. n8n ile AI PDF okuma üç node alır ve bir faturayı neredeyse her seferinde doğru okur. Bir rakamı yanlış okuduğunda ise öncekiyle aynı derecede emin görünür; kendi ekibinizden her çıkarımı kontrol etmesini istemek de kaldırmaya çalıştığınız elle işi geri getirir.

Belgeyi gönderen kişi kontrol etmek için daha iyi konumdadır. Burada tedarikçi, üstünde fatura olan ve modelin okuduğu her değerin zaten doldurulduğu bir form alır.

Bitmiş iş akışını formstep-invoice-ai-confirm.json dosyasından içe aktarabilirsiniz. AI node’una örnek bir sonuç sabitler, böylece siz model eklemeden çalışır; modeliniz bağlandığında sabitlemeyi kaldırın. Kendi sunucumdaki n8n 2.44’te, node’un 0.13.0 sürümüyle denedim.

Kısaca: AI PDF’i okur, tedarikçi her değeri üstünde fatura olan bir formda kontrol eder; iş akışı onayladıkları ve düzelttiklerinin listesiyle devam eder.

n8n düzenleyicisinde workflow: Sample invoice, Download the PDF, Extract the text, Claude modelli Read the PDF with AI, Keep the file, Ask the sender to confirm, Wait for the sender ve Answered? düğümü; buradan What the sender corrected ya da No answer: chase the sender düğümlerine dallanıyor

Tüm iş akışı n8n’de. Mor kenarlık, AI node’undaki sabitlenmiş örnek sonucu gösterir. Tam boyutta görmek için seçin.

n8n ile PDF okuma neden sessizce başarısız olur

İki şey ters gider ve hiçbiri hata vermez. Konular 5 Kasım 2026’da okundu.

Çıkarılan veriyi doğrulamanın üç yolu ve her birinin kazandığı durum

Kod kontrolleri ve kendi ekibiniz olağan seçeneklerdir, ama ulaşabiliyorsanız belgeyi gönderen kişi daha iyi bir kontroldür:

  • Koddaki kontroller. Ara toplam artı vergi toplama eşittir, vade tarihi fatura tarihinden sonradır, fatura numarası yenidir. Hiçbir maliyetleri yok, yine de ekleyin; ama tutarlı bir yanlış okumayı kaçırırlar: vergisiz tek satırlık bir faturada yanlış okunan toplam yine de tutar.
  • Ekibinizden biri. Dışarıdan kimsenin bir daha görmemesi gereken belgeler için ya da sorulacak kimse olmadığında uygundur, örneğin eski bir sözleşmenin taraması. Her belge için bir kişinin zamanına mal olur.
  • Gönderen. Kendi faturasını değerler doldurulmuş halde gören tedarikçi saniyeler içinde onaylar ya da yanlış olanı kaynağında düzeltir. Gönderen şirketinizin dışındaysa ve e-postayla ulaşılabiliyorsa kazanan budur.

Makalenin geri kalanı bu seçeneği kurar. İş akışınız, modelin okuduğuyla önceden doldurulmuş ve PDF’in eklendiği, fatura doğrulama formundan bir istek oluşturur; yanıtlar aynı field key’lerle geri gelir. Prefill, kilitli alanlar ve callback her planda var; e-postayı Formstep’in göndermesi için Pro gerekir.

Başlamadan önce

  • Herkese açık HTTPS adresi olan, kendi sunucunuzda çalışan bir n8n üzerinde Formstep node’u ve bir Formstep kimlik bilgisi. n8n Cloud’da bunun yerine REST API’yi bir HTTP Request node’undan çağırın.
  • Anthropic, OpenAI veya Google Gemini gibi, n8n AI node’larının kabul ettiği herhangi bir sohbet modeli için bir kimlik bilgisi.
  • Bir form. Formstep’te Şablonlar’ı açın, Confirm Invoice Details’i seçin, Şablonu kullan’a tıklayın ve yayınlayın. Bu, fatura için bir Documents bloğu ve supplier_name, invoice_number, invoice_date, due_date, total_amount, confirmed ile notes field key’leri olan fatura doğrulama şablonudur.

1. PDF’i alın

Örnek, Response Format değeri File olan bir HTTP Request node’uyla örnek bir faturayı indirir. Gerçek kullanımda bu, fatura gelen kutusunda bir Gmail ya da Outlook tetikleyicisidir ve alıcı gönderendir; ya da bir Google Drive klasörüne eklenen yeni bir dosyadır.

2. Metni çıkarın

Operation değeri Extract From PDF olan bir Extract from File node’u ekleyin. Metin {{ $json.text }} içine düşer.

Taramada ya da fotoğrafta metin yoktur. Bunlar için bu adımın ve sonrakinin yerine görselleri veya PDF’leri kendisi okuyan bir model node’u kullanın. İki türü de alıyorsanız, bir If node’unda text uzunluğunu kontrol edin ve boş olanları o yola yönlendirin.

3. AI ile okutun

Bir Information Extractor node’u ekleyin, sohbet modelinizi bağlayın ve Text değerini {{ $json.text }} yapın. Attributes altına her değer için bir öznitelik ekleyin; adı, doldurduğu field key olsun:

Ad Tür Açıklama
supplier_name String Faturayı düzenleyen şirket
invoice_number String Fatura numarası, basıldığı gibi
invoice_date Date Fatura tarihi, YYYY-MM-DD biçiminde
due_date Date Ödeme vadesi, YYYY-MM-DD biçiminde
total_amount Number Ödenecek toplam, KDV dahil, para birimi olmadan bir sayı

Okuduğu şey {{ $json.output }} altında gelir, örneğin {{ $json.output.total_amount }}. Özniteliklere field key’lerin adını vermek, 5. adımdaki eşlemeyi bire bir tutar.

4. Dosyayı geri koyun

Information Extractor okuduğunu döndürür, PDF’i değil; eklemek için dosyayı geri koyun. Mode değeri Combine ve Combine By değeri Position olan bir Merge node’u ekleyin. HTTP Request node’unu 1. girişe, Information Extractor’ı 2. girişe bağlayın. Böylece her öğede dosya data içinde, okunan değerler output içinde olur.

5. Tedarikçiden onaylamasını isteyin

Bir Formstep Create request node’u ekleyin ve Confirm Invoice Details formunu seçin:

  • Recipient Email tedarikçinin adresidir.
  • Values to Send her alanı değerine eşler, örneğin {{ $json.output.invoice_number }}.
  • Documents, Invoice {{ $json.output.invoice_number }} adıyla data ikili alanını alır.
  • Wait for the Outcome seçeneğini açın ve ardına Resume değeri On Webhook Call olan bir Wait node’u ekleyin.

Tedarikçi, üstünde fatura olan ve her değeri doldurulmuş bir form görür ve yanlış olanı oturum açmadan düzeltir.

Tedarikçinin gördüğü hâliyle Check Your Invoice Details formu: Supplier, Invoice Number, Invoice Date, Due Date ve 27,235 tutarında Total Amount'un üstünde fatura PDF'i, hepsi doldurulmuş
Tedarikçinin açtığı form. Toplam, modelin yanlış okuduğu 27,235 ve düzeltilmeyi bekliyor.

E-postayı Formstep’in göndermesi için Pro veya Business gerekir; Free’de Delivery değerini None bırakın ve isteğin url değerini kendi e-posta node’unuzla gönderin. Expires At ayarlamazsanız istek 30 gün sonra sona erer; bu yüzden vadesi iki hafta sonra olan bir fatura için daha erken bir tarih belirleyin.

6. Nelerin düzeltildiğini görün

{{ $json.body.type }} değerinin request.completed olup olmadığını kontrol eden bir If node’u ekleyin; doğru çıkışına da AI’ın okuduğunu onaylanan yanıtlarla karşılaştıran bir Code node’u koyun:

// Compare what the AI read with what the supplier confirmed.
const read = $('Read the invoice with AI').item.json.output
const confirmed = $json.body.data.answers
const corrected = Object.keys(read).filter((key) => String(read[key]) !== String(confirmed[key]))
return { json: { invoice: confirmed, corrected, notes: confirmed.notes ?? null } }

Test çalışmasında tedarikçi toplamı 27 325 olarak düzeltti ve bir not bıraktı; bu yüzden corrected içinde total_amount yer aldı.

n8n'de Code node'unun çıktısı: total_amount 27325 olan onaylanmış fatura ve toplamın 27 325 olduğunu söyleyen bir not, yanında total_amount'u listeleyen corrected
Tedarikçi yanıtladıktan sonra Code node’unun çıktısı: onaylanan değerler ve değiştirdikleri tek alan.

invoice değerini muhasebe aracınıza işleyin, corrected boş olmayanları da bir kişiye gönderin; böylece yalnızca istisnaları gözden geçirirsiniz. If node’unun yanlış çıkışı süresi dolmuş bir isteği yakalar; orada tedarikçiyi takip edersiniz.

Varyasyonlar

Emin olduklarınızı kilitleyin. Verdiğiniz sipariş numarası gibi kendi sisteminizden gelen değerleri Read-Only Field Names or IDs altına koyun; böylece yalnızca AI’ın okuduğu düzeltmeye açık kalır. Alıcı bunları şöyle görür:

Şirket adı alanında gri, düzenlenemeyen Analytical Engines Ltd değerini ve şu notu gösteren istek formu: Gönderen tarafından dolduruldu
Alıcının gördüğü haliyle kilitli bir alan, başka bir formdan.

Önce kod kontrollerini ekleyin. İstekten önce bir If node’u, aritmetiği tutmayan okumaları tedarikçi yerine ekibinize yönlendirebilir.

Henüz form yok. Form Source değerini New Form yapın ve formu özniteliklerden kurun; dosya başına belge toplama yazısındaki gibi. Faturayı değerlerin üstünde göstermek için yayınlanmış bir form kullanın.

Buna ihtiyacınız olmadığında

Yanlış bir değerin maliyeti düşükse onayı atlayın, onun yerine örnek bir kümeyi kontrol edin. Kimseye sorulamıyorsa belgeyi ekibinize yönlendirin. n8n Cloud’da node henüz yok; REST API aynı işi daha çok yazarak yapar. Gönderen bir meslektaşınızsa, n8n’in kendi formu yeterli olabilir.

Formstep, cevabı bilen kişi şirketinizin dışında olduğunda eklemeye değer. Aynı duraklat-ve-devam-et yapısı, AI adımı olmadan, müşteri onaylayana kadar bir n8n iş akışını duraklatma yazısında; n8n entegrasyon sayfası ise node’un neler yaptığını listeler. Adım adım rehber formstep.io/docs adresinde. Çalışan bir kopyayla başlamak için PDF okuyucu iş akışı şablonunu içe aktarın.

Bu makale hakkında sorular

Aklınızda başka bir şey mi var? Dokümanlar her ayarı anlatıyor, e-postalara da yanıt veriyoruz.

Bir model belgeleri hızlı okur ve ara sıra bir rakamı yanlış alır; yanlış aldığında da aynı derecede emin görünür. Bu iş akışının test çalışmasında 27 325 toplamını 27 235 olarak okudu. Belgeyi düzenleyen kişi bunu saniyeler içinde fark eder.

Extract From PDF, PDF'in taşıdığı metni okur; tarama ya da fotoğrafta metin yoktur. Bunlar için ilk iki adımın yerine görselleri veya PDF'leri kendisi okuyan bir model node'u kullanın. İş akışının geri kalanı aynı kalır.

n8n AI node'larının kabul ettiği her sohbet modeliyle çalışır; Anthropic, OpenAI veya Google Gemini gibi. Bunun için n8n'de kendi kimlik bilginizi bağlarsınız.

Önceden doldurulan değerler varsayılan olarak düzenlenebilir. Verdiğiniz sipariş numarası gibi kendi sisteminizden gelen değerleri Read-Only Field Names or IDs altına koyabilirsiniz; böylece yalnızca AI'ın okuduğu düzeltmeye açık kalır.

Expires At ayarlamazsanız bir istek 30 gün sonra sona erer ve süre dolması iş akışını bir request.expired olayıyla devam ettirir. Fatura daha erken vadeliyse daha kısa bir süre belirleyin ve tedarikçiyi o dalda takip edin.

Pro ve Business'ta evet: Delivery değerini Email the Invitation yapın, Formstep istek bağlantısını gönderir; bir program belirlerseniz hatırlatmalarla birlikte. Free'de Delivery değerini None bırakın ve isteğin url değerini kendi e-posta node'unuzla gönderin. Free ayrıca denemeniz için kendi adresinize 10 davet e-postası verir.

Formstep node'uyla çalışmaz. n8n Cloud yalnızca n8n'in doğruladığı topluluk node'larını yükler ve Formstep node'u henüz doğrulanmış değil. n8n Cloud'da bir HTTP Request node'undan Formstep REST API'sini çağırın; isteğin callbackUrl değeri olarak bir Wait node'unun devam URL'sini kullanın.

Kimden olursa olsun, bilgi toplayın.

Örnek bir form yayınlayın, alıcınız gibi yanıtlayın ve yanıtların geri gelişini izleyin. Hesap gerekmez.

Dokümanları okuyun