kertenkerem_
· LLM Tools · 3 dk okuma

Yapay Zeka Ajanları ile E-Fatura ve Zaman Takibi Otomasyonu: Kod Yazmadan Otonom Faturalandırma!

KOBİ’lerin ve serbest çalışanların (freelancer) her ay sonu yaşadığı o büyük sancıyı bilirsiniz: Çalışılan saatleri tek tek kontrol et, Excel dosyalarını eşitle, müşteriye uygun açıklamalar yaz, sonunda faturayı kes. E-fatura otomasyonu ve Clockify API entegrasyonu tam bu iş için var. Klasik kurallı yazılımlar yerine yapay zeka ajanları kullanırsak ne olur? Bu yazıda LLM workflow’larıyla faturalandırmayı nasıl tamamen otonom hale getirebileceğimizi bizzat test edip inceliyoruz.

Klasik otomasyon neden yetmiyor?

Zapier ya da Make gibi geleneksel entegrasyon araçları iş görür ama “aptaldırlar”. Çalışanınız Clockify’a “CSS hatasını düzelttim, kahve içtim” yazdıysa klasik bir otomasyon bu saçma açıklamayı doğrudan faturaya yansıtır. Müşterinize “kahve içtim” yazan bir fatura göndermek istemezsiniz, değil mi?

LLM ajanlarının fark yarattığı yer burası. Bir LLM ajanı veriyi bir yerden alıp diğerine taşımakla kalmaz, veriyi anlar, sınıflandırır, profesyonel bir dile çevirir, gerekirse reddedip insandan onay ister. Sürece akıl katar.

Sistem nasıl çalışıyor? Adım adım mimari

Kurduğumuz sistemin mantığı basit. Zaman takip aracı ile e-fatura sistemimiz arasında bir köprü görevi görüyor. Temel akış şöyle:

  1. Veri çekme: Clockify API’si kullanılarak haftalık/aylık zaman kayıtları çekilir.
  2. LLM analizi: Çekilen veriler (çalışan adı, proje, harcanan süre, açıklama) LLM ajanına gönderilir.
  3. Anlamlandırma ve filtreleme: Ajan, fatura edilmeyecek saatleri (örneğin dahili toplantılar) ayıklar. Dağınık girilen açıklamaları profesyonel bir dille (“CSS refactoring and UI optimization” gibi) yeniden yazar.
  4. Fatura oluşturma: Yapay zeka, yapılandırılmış (structured JSON) veriyi e-fatura sistemine (Xero, Paraşüt, Qonto vb.) göndererek taslak faturayı hazırlar.

Clockify API entegrasyonu için küçük bir kod örneği

Sistemin kalbinde, Clockify’dan veriyi çeken basit bir API çağrısı yatıyor. Kod gözünüzü korkutmasın, aynı işi n8n veya Make gibi araçlarda tek bir tıkla da yapabilirsiniz:

curl -X GET "https://api.clockify.me/api/v1/workspaces/{workspaceId}/user/{userId}/time-entries" \
  -H "X-Api-Key: YOUR_CLOCKIFY_API_KEY" \
  -H "Content-Type: application/json"

Buradan dönen karmaşık JSON çıktısını doğrudan e-fatura servisine basmak yerine LLM ajanımızın prompt’una (girdisine) besliyoruz.

Test sürüşü: dağınık veriyi faturaya dönüştürmek

Denemek için sisteme bilerek oldukça “dağınık” girilmiş bir Clockify zaman kaydı verdik:

  • Girdi: “Kerem - 3 saat - Buton rengini değiştirdim, patronla tartıştık ama hallettik.”
  • LLM ajanı yorumu (arka planda): “Patronla tartışma kısmı müşteriye yansıtılmamalı. Buton rengi değişimi ‘Arayüz Geliştirmeleri’ altında sınıflandırılmalı.”
  • Oluşan fatura kalemi: “UI/UX Frontend Optimization: Button Components - 3 Hours.”

Sonuç gerçekten etkileyici. LLM ajanları bağlamı anlayıp gereksiz detayları eliyor ve faturayı kurumsal bir dille yazıyor.

Karşılaştırma: klasik otomasyon ve yapay zeka ajanı

Hangi yöntemin işletmenize daha uygun olduğunu görmek için hazırladığımız tabloya göz atın:

Özellik Klasik Otomasyon (Zapier/Make) LLM Ajanı (n8n + GPT-4o)
Esneklik Düşük (Sadece katı kurallara uyar) Yüksek (Serbest metinleri anlar ve yorumlar)
Hata Ayıklama Manuel (Hatalı veriyi aynen işler) Otonom (Hatalı/eksik veriyi tespit edip düzeltir)
Kurulum Zorluğu Kolay (Sürükle-bırak) Orta (İyi bir prompt tasarımı gerektirir)
Çeviri Desteği Yok (Ekstra araç gerekir) Doğal (Türkçe girilen kaydı İngilizce faturaya dönüştürür)

Maliyetler ve ücretsiz alternatifler

Bu sistemi kurmak için servet harcamanız gerekmez. Kullanabileceğiniz araçlar ve maliyetleri şöyle:

  • n8n (ücretsiz / self-hosted): Kendi sunucunuza kurarsanız tamamen ücretsizdir. Bulut sürümü aylık 20€’dan başlar. Yapay zeka entegrasyonları için en iyi ücretsiz alternatiftir.
  • OpenAI API / Claude API: Fatura başına harcanan token miktarı çok düşüktür. 100 fatura üretimi yaklaşık 0.10$ ile 0.50$ arası bir maliyet oluşturur.
  • Clockify: Temel API erişimi sunan ücretsiz planı bu otomasyon için fazlasıyla yeterli.

Gerçekten iş görüyor mu?

Testlerimizde e-fatura otomasyonuna bir LLM katmanı eklemenin, özellikle dışarıdan çok sayıda yüklenici (contractor) ile çalışan KOBİ’ler için büyük kolaylık olduğunu gördük. Yine de her şeyi yapay zekanın insafına bırakmamak gerekiyor. En mantıklı senaryo, ajanın faturayı hazırlayıp “Taslak” olarak kaydetmesi, sizin de tek tıkla onaylayıp göndermenizdir.

İşletmenizde faturalama süreçlerini otomatikleştirmek istiyorsanız n8n ve ücretsiz bir OpenAI API anahtarıyla ilk denemenizi bugün yapabilirsiniz.