n8n ile dekont otomasyonu: e-postadan ERP kaydına adım adım

Bir muhasebe ekibi için kurduğum akışın adım adım anlatımı. Sorun basitti: e-postayla gelen her dekont önce elle Excel’e, sonra ERP’ye giriliyordu. Akış bu iki girişi ortadan kaldırıyor ama son sözü muhasebeye bırakıyor. Yazının sonunda akışın nerede durduğunu ve hangi durumları henüz karşılamadığını da açıkça listeledim.

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

  1. Gmail’e dekont eki olan bir e-posta gelir, akış başlar.
  2. Ekteki PDF’in metni çıkarılır.
  3. Claude metinden tarih, tutar, para birimi, karşı taraf, açıklama ve hesap kodunu JSON olarak çıkarır.
  4. Bir kod adımı bu alanları kurallarla denetler. Sorunlu kayıt ERP’ye gitmez; muhasebeye bildirim düşer.
  5. Sorunsuz kayıt Excel kontrol tablosuna yazılır ve muhasebeye onay e-postası gider.
  6. Onaylanırsa kayıt Ovis ERP’ye gönderilir; ardından kontrol tablosundaki satır güncellenir.
Dekont otomasyonunun n8n editöründeki hâli: Gmail tetikleyicisinden ERP kaydına 11 düğüm
İş akışının n8n editöründeki hâli: 11 düğüm.

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.

1. PDF’ten çıkarılan metin
Ö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
2. Claude’un döndürdüğü JSON
{
  "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.

3. Kontrol adımının eklediği alanlar
"sorunlar": [],
"gecerli": true,
"kaynak_eposta": "18f2c0d4a9b1e7c3"   // Gmail mesaj kimliği, e-posta adresi değil
4. Excel kontrol tablosuna eklenen satır (bazı sütunlar kısaltıldı)
tarihtutarpara_birimikarsi_tarafhesap_koduguvengecerli
2026-09-1248250TRYÖrnek Tedarik A.Ş.320.010.92true
5. Muhasebeye giden onay e-postası
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 ]
6. Onaydan sonra ERP’ye giden istek gövdesi
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.

Gmail arama filtresi
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.

Sistem talimatı
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ış):

Yapılandırılmış çıktı (istek gövdesine eklenir)
"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ı.
Hesap kodu ve güven kuralları (JavaScript)
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.
Örnek denetim izi satırı (önerilen sütunlar; örnek veri)
kaynak_epostadurumonay_zamanierp_fis_no
18f2c0d4a9b1e7c3onaylandı, ERP’de2026-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:

DurumAkış ne yaparDosyada karşılanıyor mu?
Eksik bilgi (tarih ya da tutar yok)Kontrol adımı yakalar, muhasebeye “Kontrol gerekli” bildirimi giderEvet
Metin katmanı olmayan (taranmış) PDFMetin boş gelir, Claude alanları boş bırakır, kontrol adımı yakalarEvet, dolaylı olarak
Fotoğraf olarak gelen dekontPDF okuma adımı hata verir, çalışma dururHayır: OCR adımı gerekir
Bir e-postada birden fazla dekontYalnızca ilk ek işlenir, diğerleri atlanırHayır
Aynı dekontun tekrar gelmesiYeniden işlenir, ikinci kez onaya düşer; onaylayan fark etmezse ERP’de çift kayıt oluşurHayı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 reddederseKayıt ERP’ye gitmez, satır güncellenirEvet, denetim izi düğümü ayarlandığında
Onay hiç gelmezseAkış beklemeye devam ederHayı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ırHayı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.

İş akışı dosyasını indir (n8n JSON)