Evet, bir kısmını. Yapay zekâ asistanınız faturası kesilmemiş siparişleri bulur, alıcı bilgilerini toplar ve GİB e-Arşiv Portalı'nda taslağı hazırlar. Faturayı SMS koduyla siz imzalarsınız. Sonra asistan faturanın PDF'ini siparişe ekler. Aşağıdaki komut metnini asistanınıza yapıştırın.
Başlamadan önce
- Asistanınız Teachfluence'a bağlı olmalı. Bağlantıyı Yapay zekâ istemcisini Teachfluence'a bağlama dokümanından kurun. İzin ekranında Tool groups altında Sales & products alanını işaretleyin. Fatura araçları bu alandadır.
- Asistanınız web portalını açabilmeli ve dosya yüklemek için HTTP POST isteği gönderebilmeli. Yalnızca sohbet eden bir istemci PDF'i yükleyemeyebilir. Claude Code gibi tarayıcı ve komut çalıştırabilen bir istemci kullanın.
- Organizasyon sahibi ya da yöneticisi olarak çalışabilirsiniz. Başka bir rolde siparişleri görme ve siparişleri düzenleme izinleri gerekir.
- GİB e-Arşiv Portalı'na girebilmeli ve SMS kodunu alabilmelisiniz.
Komut metni
Aşağıdaki metni kopyalayıp asistanınıza yapıştırın. %__ yerine KDV oranını kendiniz yazın. Teachfluence bir oran önermez; hangi oranı uygulayacağınızı muhasebecinize danışın.
Teachfluence'taki ödenmiş ama faturası kesilmemiş siparişlerim için GİB e-Arşiv
Portalı'nda (https://earsivportal.efatura.gov.tr) fatura keseceğiz. Adımlar:
1. Teachfluence'ta org_whoami ile doğru okulda olduğunu doğrula.
2. orders_list ile invoiceStatus = NOT_ISSUED olan siparişleri listele. Bana sipariş
no, alıcı, tutar ve tarihten oluşan bir tablo göster. Hangilerini keseceğimizi ben
seçeceğim.
3. Seçtiğim her sipariş için orders_get_billing_details çağır. Alıcının adını ya da
ünvanını, TCKN ya da VKN'sini, vergi dairesini, adresini ve ödenen tutarı al.
Ürün adı için orders_list_line_items kullan. invoiceStatus NOT_ISSUED değilse o
siparişi atla.
4. Portalda bu bilgilerle fatura taslağı oluştur. KDV oranı: %__ . Ödenen tutar KDV
dahildir: net = toplam / (1 + oran). Taslağı bana göster, onayımı al.
5. Onay verince faturayı SMS ile imzalama adımına getir. SMS kodunu ben gireceğim.
6. Kesilen faturanın PDF'ini indir. Faturadaki numarayı, ETTN'yi, tarihi, net
tutarı, KDV tutarını ve toplamı not al.
7. orders_invoice_upload_create'i orderId ve PDF'in bayt cinsinden boyutuyla çağır.
Dönen url'e, expiresAt dolmadan, multipart/form-data POST yap: fields'taki her
alanı form alanı olarak ekle, PDF'i en sonda "file" adlı alanda gönder.
8. orders_invoice_attach'ı şu alanlarla çağır:
uploadId, documentNumber (fatura no), documentUuid (ETTN),
issuedOn (YYYY-MM-DD), documentType = E_ARSIV,
netAmount, vatRate, vatAmount, grossAmount
Tutarları ondalık metin olarak gönder ("1000.00"); vatRate'i yüzde olarak gönder
("20").
9. "already has an issued sale invoice" hatası gelirse o siparişin faturası zaten
kesilmiştir: tekrar kesme, atla.
10. Her siparişten sonra kısa bir özet ver, sonra bir sonrakine geç.
Kurallar: Benim onayım olmadan hiçbir faturayı imzalama. Bir siparişi bitirmeden
diğerine başlama. İmzalanan fatura geri alınamaz.
İmzalanan fatura geri alınamaz
GİB portalında SMS koduyla imzalanan fatura geri alınamaz. Kodu asistana vermeyin, kendiniz girin. Taslağı imzalamadan önce alıcı adını, TCKN veya VKN'yi, tutarı ve KDV oranını kontrol edin. Aynı kural Logo İşbaşı gibi başka bir fatura programı için de geçerlidir: asistan hazırlar, siz onaylarsınız.
Asistan hangi araçları kullanır
Komut metninde geçen araçların her biri tek iş yapar.
| Araç | Ne yapar | Gereken izin |
|---|---|---|
orders_list | Ödenmiş siparişleri listeler. invoiceStatus değeri NOT_ISSUED olanlar satış faturası henüz kesilmemiş siparişlerdir. | Siparişleri görme |
orders_get_billing_details | Alıcının ödeme sırasında girdiği fatura bilgilerini okur: ad ya da ünvan, TCKN, VKN, vergi dairesi, adres, telefon. Siparişin fatura durumunu ve kesilmiş fatura ile iade belgelerini de verir. | Siparişleri görme |
orders_list_line_items | Fatura satırları için ürün adlarını verir. | Siparişleri görme |
orders_invoice_upload_create | Siparişe PDF yüklemeyi başlatır. PDF en fazla 10 MB olabilir. | Siparişleri düzenleme |
orders_invoice_attach | Yüklenen PDF'i siparişin satış faturası olarak ekler. | Siparişleri düzenleme |
orders_get_billing_details kişisel veri döndürür. Bu bilgiler asistanınızın konuşma geçmişinde kalır. Asistanı güvendiğiniz bir hesapta çalıştırın.
Faturayı siparişe eklerken gereken bilgiler
orders_invoice_attach aracı şu alanları ister. Asistan bunları portaldaki faturadan okur.
| Alan | Değer |
|---|---|
uploadId | orders_invoice_upload_create sonucundaki yükleme kimliği |
documentNumber | Fatura numarası |
documentUuid | ETTN (UUID biçiminde) |
issuedOn | Düzenleme tarihi, YYYY-MM-DD. Bugünden sonraki bir tarih olamaz. |
documentType | E_ARSIV |
netAmount | KDV hariç tutar |
vatRate | KDV oranı, yüzde olarak ("20") |
vatAmount | KDV tutarı |
grossAmount | Toplam tutar. Net tutar ile KDV tutarının toplamına eşit olmalı. |
Her yükleme yalnızca bir kez eklenir. Yükleme süresi dolduysa ya da bir kez kullanıldıysa asistan yeni bir yükleme başlatır.
Ekledikten sonra ne görürsünüz
Faturanın PDF'i ve bilgileri, siparişin fatura belgeleri arasında yönetim panelinde görünür. Siparişin fatura durumu kesildi olarak değişir. Aracın sonucunda siparişi panelde açan bir bağlantı gelir. Ekleme işlemi yalnızca belge ekler, siparişte başka bir şeyi değiştirmez.
Alıcıya e-posta gitmez
Teachfluence faturayı alıcıya göndermez. Faturayı alıcıya iletmek sizin işinizdir.
Sınırlar
- Bir siparişe bir satış faturası eklenir. Siparişte zaten kesilmiş bir satış faturası varsa (elle eklenmiş ya da Paraşüt gibi bir entegrasyonla kesilmiş), yükleme ve ekleme "This order already has an issued sale invoice" hatasıyla reddedilir. Asistan o siparişi atlamalı, GİB'de ikinci bir fatura kesmemelidir. Komut metni bunu söyler.
- Aynı anda iki çalıştırma aynı siparişe fatura ekleyemez. İkincisi reddedilir.
- Teachfluence'ın kendisi faturayı kestiyse ekleme reddedilir.
- Yalnızca PDF kabul edilir. Dosya en fazla 10 MB olabilir.
- Asistan KDV oranı seçmez. Oranı komut metnine siz yazarsınız.
- Fatura düzenleme ve zamanlama yükümlülükleriniz için muhasebecinize danışın. Bu sayfa vergi tavsiyesi vermez.
İlgili
- Siparişlere ve abonelik ödemelerine fatura ekleme: faturayı yapay zekâ kullanmadan panelden siparişe ekleyin.
- Paraşüt ile otomatik e-fatura kesme: faturalar her siparişte kendiliğinden kesilsin istiyorsanız.
- Yapay zekâ istemcisini Teachfluence'a bağlama
- Planları karşılaştırın

