Sorun: aynı dekont iki kez elle giriliyordu
Banka dekontları ve makbuzlar muhasebeye e-postayla geliyordu. Her birinden tarih, tutar, karşı taraf ve hesap kodu okunup önce kontrol için Excel’e, ardından Ovis ERP’ye yazılıyordu. İş zor değildi ama tekrarlıydı; yazım hatası da en çok bu tür işlerde çıkar.
Hedef, veri girişini otomatikleştirirken kontrolü kaybetmemekti: yapay zekâ okur, kurallar denetler, muhasebe onaylar, kayıt kendiliğinden düşer.
Başlamadan önce
İndirilebilir dosya bir iskelettir: bağlantılar ve bazı seçimler bilerek boş bırakıldı, çünkü her işletmede farklıdır. Kurmadan önce şunları hazırlayın:
- n8n: Gmail düğümünün “gönder ve yanıt bekle” (Send and Wait for Response) işlemini içeren güncel bir sürüm. Dosyadaki Gmail düğümleri sürüm 2.1, HTTP Request düğümleri sürüm 4.2 ile hazırlandı; içe aktarırken bunları tanımayan bir sürümdeyseniz n8n’i güncelleyin.
- Gmail kimlik bilgisi: tetikleyici ve iki e-posta gönderim düğümü aynı hesabı kullanır.
- Microsoft Excel 365 kimlik bilgisi ve OneDrive ya da SharePoint’te bir çalışma kitabı. İki Excel düğümünde çalışma kitabı ve sayfa seçimi boş; kendinizinkini seçin.
- Excel başlıkları: düğümler alan adlarını sütun adlarıyla otomatik eşler. İlk satıra şu başlıkları yazın: tarih, tutar, para_birimi, karsi_taraf, aciklama, hesap_kodu, guven, sorunlar, gecerli, kaynak_eposta. Denetim izi için durum ve onay_zamani sütunlarını da eklemenizi öneririm (7. adım).
- Claude API anahtarı: n8n’de “Anthropic” türünde kimlik bilgisi olarak eklenir; anahtar iş akışı dosyasına yazılmaz.
- ERP bağlantısı: Ovis ERP adresi OVIS_ERP_URL ortam değişkeninde, erişim bilgisi “Header Auth” kimlik bilgisinde durur. /api/muhasebe/fis uç noktası ve gönderilen alan adları bu işe özeldir; kendi ERP’nizin API belgesine göre uyarlanmalıdır.
- Muhasebe e-posta adresi: dosyadaki muhasebe@sirket.com bir yer tutucudur; onay ve bildirim e-postalarının gideceği adresle değiştirin.
Akışın özeti
- Gmail’e dekont eki olan bir e-posta gelir, akış başlar.
- Ekteki PDF’in metni çıkarılır.
- Claude metinden tarih, tutar, para birimi, karşı taraf, açıklama ve hesap kodunu JSON olarak çıkarır.
- Bir kod adımı bu alanları kurallarla denetler. Sorunlu kayıt ERP’ye gitmez; muhasebeye bildirim düşer.
- Sorunsuz kayıt Excel kontrol tablosuna yazılır ve muhasebeye onay e-postası gider.
- Onaylanırsa kayıt Ovis ERP’ye gönderilir; ardından kontrol tablosundaki satır güncellenir.

Baştan sona bir örnek
Bu bölümdeki dekont, firma adı, tutar ve kimlikler örnek veridir; gerçek bir işlemden alınmamıştır.
ÖRNEK BANKA A.Ş. · EFT DEKONTU
İşlem tarihi: 12.09.2026
Alıcı: Örnek Tedarik A.Ş.
Tutar: 48.250,00 TL
Açıklama: Eylül ayı malzeme alımı, fatura no ÖRN-2026-0912{
"tarih": "2026-09-12",
"tutar": 48250,
"para_birimi": "TRY",
"karsi_taraf": "Örnek Tedarik A.Ş.",
"aciklama": "Eylül ayı malzeme alımı, fatura no ÖRN-2026-0912",
"hesap_kodu": "320.01",
"guven": 0.92,
"sorunlar": []
}Dikkat: hesap kodu dekontta yazmaz. Claude onu açıklamadan tahmin eder; buradaki 320.01 bir satıcı hesabı örneğidir. Kontrol adımı yalnızca kodun biçimini denetleyebilir, doğru hesap olup olmadığını onay adımındaki kişi görür.
"sorunlar": [],
"gecerli": true,
"kaynak_eposta": "18f2c0d4a9b1e7c3" // Gmail mesaj kimliği, e-posta adresi değil| tarih | tutar | para_birimi | karsi_taraf | hesap_kodu | guven | gecerli |
|---|---|---|---|---|---|---|
| 2026-09-12 | 48250 | TRY | Örnek Tedarik A.Ş. | 320.01 | 0.92 | true |
Konu: Onay: Örnek Tedarik A.Ş. · 48250 TRY
Tarih: 2026-09-12
Tutar: 48250 TRY
Hesap kodu: 320.01
Açıklama: Eylül ayı malzeme alımı, fatura no ÖRN-2026-0912
Kayıt Excel kontrol tablosuna eklendi. Onaylarsanız Ovis ERP’ye aktarılacak.
[ Onayla ] [ Reddet ]POST {OVIS_ERP_URL}/api/muhasebe/fis
{
"tarih": "2026-09-12",
"tutar": 48250,
"hesap_kodu": "320.01",
"aciklama": "Eylül ayı malzeme alımı, fatura no ÖRN-2026-0912"
}ERP’nin yanıtı sistemden sisteme değişir; oluşan fişin numarası gibi bir değer dönüyorsa onu da denetim izine yazmanız iyi olur (7. adım).
1. Tetikleyici: dekont e-postası
Gmail tetikleyicisi dakikada bir yeni e-postaya bakar ve yalnızca eki olan, içinde “dekont”, “makbuz” ya da “receipt” geçen e-postaları alır. Ekler akışa indirilir; akış yalnızca ilk eki (attachment_0) işler.
has:attachment (dekont OR makbuz OR receipt)2. PDF’ten metin
“Extract From File” düğümü ekteki PDF’in metin katmanını çıkarır. Sonraki adımlar yalnızca bu metinle çalışır.
Bu akış yalnızca metin katmanı olan PDF’leri okur. Taranmış PDF’ler ve fotoğraf olarak gelen dekontlar için araya bir metin tanıma (OCR) adımı eklemek gerekir.
3. Claude ile alanları çıkarma
Metin, HTTP Request düğümüyle Claude API’ye gönderilir. Asıl iş sistem talimatında: serbest metin değil, belirli alanları olan bir JSON istenir; emin olunmayan alanın boş bırakılması söylenir; 0 ile 1 arasında bir güven değeri ve fark edilen sorunların listesi istenir.
Sen bir muhasebe asistanısın. Dekont metninden yalnızca JSON döndür: tarih (YYYY-AA-GG), tutar (sayı), para_birimi, karsi_taraf, aciklama, hesap_kodu, guven (0-1), sorunlar (liste). Emin olmadığın alanı boş bırak, tahmin etme.“Tahmin etme” cümlesi önemli: boş bırakılan bir alan kontrol adımında yakalanır, yanlış doldurulmuş bir alan ise gözden kaçabilir.
“Yalnızca JSON döndür” demek ise biçimi garanti etmez; model yine de açıklama ekleyebilir ya da bozuk JSON üretebilir. Bu akışta bu risk bir sonraki adımdaki ayrıştırma kontrolüyle karşılanıyor: yanıt JSON olarak okunamazsa kayıt “Yanıt JSON değil” sorunuyla ayrılır ve ERP’ye gitmez.
Daha sağlam bir yol, Claude API’nin yapılandırılmış çıktı özelliği: isteğe bir JSON şeması eklendiğinde yanıt bu şemaya uyacak şekilde üretilir. İndirilebilir dosyada kullanılmıyor; eklemek için istek gövdesine aşağıdaki gibi bir alan yazılır (kısaltılmış):
"output_config": {
"format": {
"type": "json_schema",
"schema": {
"type": "object",
"properties": {
"tarih": { "type": "string" },
"tutar": { "type": "number" },
"hesap_kodu": { "type": "string" },
"guven": { "type": "number" },
"sorunlar": { "type": "array", "items": { "type": "string" } }
},
"required": ["tarih", "tutar", "hesap_kodu", "guven", "sorunlar"],
"additionalProperties": false
}
}
}Şema biçimi garanti eder, iş kuralını değil. “Tutar sıfırdan büyük olmalı” gibi sayısal sınırlar şemaya yazılamadığı için kontrol adımı yapılandırılmış çıktıyla da gereklidir. Güvenlik gerekçesiyle reddedilen ya da uzunluk sınırına takılan yanıtların da şemaya uymayabileceğini hesaba katın.
Claude belgeleri: yapılandırılmış çıktılar
4. Kural kontrolü: yapay zekâya körü körüne güvenmeyin
Bir Code düğümü Claude’un yanıtını ayrıştırır ve beş kuralla denetler. Kurallardan biri bile tutmazsa kayıt “geçersiz” işaretlenir; Claude’un kendi bildirdiği sorunlar da listeye eklenir.
- Yanıt geçerli bir JSON olmalı.
- Tarih boş olmamalı.
- Tutar sıfırdan büyük olmalı.
- Hesap kodu biçime uymalı: üç hane, ardından en fazla üç “.00” grubu (ör. 320.01).
- Güven değeri en az 0,8 olmalı.
if (!/^\d{3}(\.\d{2}){0,3}$/.test(d.hesap_kodu ?? '')) sorunlar.push('Hesap kodu biçimi hatalı')
if ((d.guven ?? 0) < 0.8) sorunlar.push('Düşük güven')Güven değerini doğru okuyun: bu, modelin kendi değerlendirmesidir; ölçülmüş bir doğruluk oranı değildir. 0,8 eşiği “model emin olmadığını söylediyse kaydı insana gönder” anlamına gelir, “%80 doğru” anlamına gelmez. Eşiği ilk haftalarda gelen kayıtlara bakarak ayarlayın.
5. Sorunlu kayıt ERP’ye gitmez
Bir IF düğümü kaydı iki yola ayırır. Geçersiz kayıtlar ERP’ye ulaşmaz; muhasebeye “Kontrol gerekli” konulu, sorunların ve kaynak e-postanın kimliğinin yazdığı bir bildirim gider. Bu ayrım, çıkarılan verideki sorunlar içindir. PDF okuma, Claude API ya da ERP bağlantısı gibi teknik hatalar için dosyada ayrı bir hata yolu yok; bunlar bir sonraki bölümde.
6. Excel kontrol tablosu ve insan onayı
Geçerli kayıt önce Excel’deki kontrol tablosuna eklenir. Ardından Gmail’in “gönder ve yanıt bekle” işlemiyle muhasebeye onay e-postası gider: tarih, tutar, hesap kodu ve açıklama yazar, altında Onayla ve Reddet düğmeleri vardır. Akış yanıt gelene kadar bekler.
7. ERP kaydı ve denetim izi
Onay gelirse kayıt, HTTP Request düğümüyle ERP’nin muhasebe fişi uç noktasına gönderilir. ERP adresi ortam değişkeninde, erişim bilgisi n8n’in kimlik bilgisi alanında durur; iş akışı dosyasında hiçbir anahtar yoktur.
Ardından “Denetim izi” düğümü kontrol tablosundaki satırı günceller. Dürüst olmak gerekirse dosyada bu adım bir iskelet: hangi satırın güncelleneceği (eşleştirme sütunu) ve hangi alanların yazılacağı boş bırakıldı. Kimin neyi ne zaman onayladığının tabloda kalması için bu düğümü kendiniz ayarlamalısınız. Önerdiğim ayar:
- Eşleştirme sütunu: kaynak_eposta (her kaydı üreten e-postanın kimliği).
- durum: “onaylandı, ERP’de” ya da “reddedildi”.
- onay_zamani: n8n ifadesi {{ $now }}.
- Onaylayan: onay e-postasının gittiği adres; birden çok kişi onaylıyorsa her birine ayrı onay adımı kurun.
- ERP’den dönen fiş numarası, varsa.
| kaynak_eposta | durum | onay_zamani | erp_fis_no |
|---|---|---|---|
| 18f2c0d4a9b1e7c3 | onaylandı, ERP’de | 2026-09-12 10:42 | ÖRN-FIS-1042 |
Nerede durur, nerede insan gerekir?
Otomasyonun değeri, neyi yapmadığını bilmekle başlar. İndirilebilir dosyanın bugünkü hâliyle:
| Durum | Akış ne yapar | Dosyada karşılanıyor mu? |
|---|---|---|
| Eksik bilgi (tarih ya da tutar yok) | Kontrol adımı yakalar, muhasebeye “Kontrol gerekli” bildirimi gider | Evet |
| Metin katmanı olmayan (taranmış) PDF | Metin boş gelir, Claude alanları boş bırakır, kontrol adımı yakalar | Evet, dolaylı olarak |
| Fotoğraf olarak gelen dekont | PDF okuma adımı hata verir, çalışma durur | Hayır: OCR adımı gerekir |
| Bir e-postada birden fazla dekont | Yalnızca ilk ek işlenir, diğerleri atlanır | Hayır |
| Aynı dekontun tekrar gelmesi | Yeniden işlenir, ikinci kez onaya düşer; onaylayan fark etmezse ERP’de çift kayıt oluşur | Hayır: onaydan önce tabloda aynı tarih, tutar ve karşı taraf var mı diye bakan bir adım önerilir |
| Yanlış hesap kodu (biçimi doğru) | Kontrol adımı yakalamaz | İnsan onayında yakalanır |
| Muhasebe reddederse | Kayıt ERP’ye gitmez, satır güncellenir | Evet, denetim izi düğümü ayarlandığında |
| Onay hiç gelmezse | Akış beklemeye devam eder | Hayır: bekleme süresine bir sınır ve hatırlatma eklenmesi önerilir |
| Claude API ya da ERP bağlantı hatası | Düğüm hata verir, çalışma durur; kayıt yarım kalır | Hayır: düğüm ayarlarında yeniden deneme (Retry On Fail) ve muhasebeye haber veren bir hata iş akışı (Error Workflow) önerilir |
Kendi akışınıza uyarlarken
- Gmail filtresini dekontlarınızın geldiği adrese ve konu kalıbına göre daraltın.
- Hesap kodu kuralını kendi hesap planınızın biçimine göre değiştirin.
- Güven eşiğini (0,8) ilk haftalarda gelen kayıtlara bakarak ayarlayın.
- Tekrar gelen dekontları yakalayan bir kontrol ve teknik hatalar için bir hata iş akışı ekleyin.
- ERP adımını devreye almadan önce akışı bir süre yalnızca Excel’e yazacak şekilde çalıştırıp sonuçları elle karşılaştırın.