İçeriğe geç
Bu sayfada

Ödemeler, Faturalandırma ve Vergilendirme

Ödenmiş siparişlerim için e-Arşiv faturayı yapay zekâya kestirebilir miyim?

Yapay zekâ asistanınız ödenmiş siparişlerinizi bulur, GİB e-Arşiv Portalı'nda fatura taslağını hazırlar, siz SMS koduyla imzalarsınız; asistan faturanın PDF'ini, fatura numarasını, ETTN'yi ve KDV tutarını siparişe ekler. Kopyalayıp yapıştıracağınız komut metni bu sayfada.

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.

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.

Asistan hangi araçları kullanır

Komut metninde geçen araçların her biri tek iş yapar.

AraçNe yaparGereken 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_detailsAlı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_itemsFatura satırları için ürün adlarını verir.Siparişleri görme
orders_invoice_upload_createSiparişe PDF yüklemeyi başlatır. PDF en fazla 10 MB olabilir.Siparişleri düzenleme
orders_invoice_attachYü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.

AlanDeğer
uploadIdorders_invoice_upload_create sonucundaki yükleme kimliği
documentNumberFatura numarası
documentUuidETTN (UUID biçiminde)
issuedOnDüzenleme tarihi, YYYY-MM-DD. Bugünden sonraki bir tarih olamaz.
documentTypeE_ARSIV
netAmountKDV hariç tutar
vatRateKDV oranı, yüzde olarak ("20")
vatAmountKDV tutarı
grossAmountToplam 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.

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