e-Fatura API entegrasyonu
Evobulut, e-fatura gönderme, gelen e-faturaları işleme ve e-fatura PDF'i alma işlemlerini REST API üzerinden sunan, entegratör bağımsız bir ön muhasebe programıdır. Kendi yazılımınızdan veya e-ticaret sisteminizden fatura oluşturabilir, oluşturduğunuz faturayı e-fatura olarak gönderebilir, GİB üzerinden size ulaşan gelen e-faturaları listeleyip alış faturasına aktarabilir ve faturanın PDF belgesini programatik olarak çekebilirsiniz. Entegrasyonunuz doğrudan bir e-fatura entegratörünün servislerine değil, Evobulut API'sine bağlanır; bu nedenle entegratör değiştiğinde kodunuzda değişiklik yapmanız gerekmez.
Entegratör bağımsız e-fatura entegrasyonu
Türkiye'de e-fatura, e-arşiv ve e-irsaliye belgeleri GİB'e özel entegratörler üzerinden iletilir. Yazılımınızı doğrudan bir entegratörün API'sine bağlarsanız o entegratöre kilitlenirsiniz: her entegratörün kendi kimlik doğrulama yöntemi, kendi alan adları, kendi hata kodları ve kendi belge şeması vardır. Ticari koşullar değiştiğinde veya entegratör değiştirmek istediğinizde entegrasyonu baştan yazmanız gerekir.
Evobulut bu bağımlılığı sizin yerinize üstlenir. Entegratör ilişkisi Evobulut tarafında yönetilir; siz her durumda aynı Evobulut servislerini çağırırsınız. Pratikte bu şu anlama gelir:
| Doğrudan entegratör API'sine bağlanırsanız | Evobulut API'si üzerinden bağlanırsanız |
|---|---|
| Her entegratör için ayrı entegrasyon kodu yazarsınız | Tek servis seti, tüm entegratörler için aynı |
| Entegratör değişince kod yeniden yazılır | Entegratör değişse de kodunuz aynı kalır |
| Her entegratörün kimlik doğrulaması ayrı yönetilir | Tek kimlik doğrulama: Evobulut Token UID |
| Belge şeması entegratöre göre değişir | Fatura yapısı Evobulut'ta standarttır |
| Entegratör seçimi geliştiriciyi de bağlar | Entegratör seçimi ticari bir karardır, teknik değil |
Yani entegratör tercihinizi ticari koşullara göre yapabilir, ileride değiştirebilirsiniz; yazdığınız entegrasyon çalışmaya devam eder. Aynı yazılımla birden fazla Evobulut müşterisine hizmet veriyorsanız, müşterileriniz farklı entegratörler kullanıyor olsa bile tek bir entegrasyon kodu yeterlidir.
Giden e-Fatura servisleri
Kestiğiniz faturayı e-fatura olarak göndermek ve belgesini almak için kullanılan servisler:
- POST Fatura EFatura Pdf Getirme Fatura
- POST Fatura EFatura Pdf Onizleme Fatura
- POST Fatura Efatura Gönderme Fatura
- POST E-Fatura Durum Sorgula Fatura
Tipik e-fatura gönderme akışı
- Oturum açın. Login servisinden Token UID alın.
- Faturayı oluşturun. Fatura ekleme servisi ile fatura başlığını ve satırlarını kaydedin.
- Faturayı onaylayın. Onay servisi ile faturayı kesinleştirin.
- e-Fatura olarak gönderin. e-Fatura gönderme servisini çağırın.
- Belgeyi alın. e-Fatura PDF servisinden faturanın PDF çıktısını çekin.
Gelen e-Fatura servisleri
GİB üzerinden Evobulut'a düşen gelen e-faturalar ayrı bir modülde tutulur. Bu servislerle gelen faturaları listeleyebilir, fatura başlığı ile birlikte tüm satırlarını okuyabilir, satırlardaki ürünleri kendi stok kartlarınızla eşleştirebilir ve faturayı alış faturasına aktarabilirsiniz — yani arayüzde elle yaptığınız işlemlerin tamamı API üzerinden yapılabilir.
- POST Gelen e-Fatura Listesi Gelen e-Fatura
- POST Gelen e-Fatura Detayı ve Satırları Gelen e-Fatura
- POST Gelen e-Fatura Güncelle (Satır Eşleştirme) Gelen e-Fatura
- POST Gelen e-Faturayı İçeri Aktar (Alış Faturası Oluştur) Gelen e-Fatura
- POST Gelen e-Fatura Onayla Gelen e-Fatura
- POST Gelen e-Fatura Arşive Ekle / Çıkar Gelen e-Fatura
- POST Gelen e-Fatura PDF Görüntüle Gelen e-Fatura
Tipik gelen e-fatura akışı
- Yeni gelenleri listeleyin. Gelen e-Fatura Listesi servisini
aktarildi = 0ile çağırın. Periyodik çekimdemin_idya da faturanın size düştüğü tarih (a_gtarih_bas) kullanılır; belge tarihine göre çekmek yanıltır, geçmiş tarihli bir fatura bugün düşebilir. - Detayı ve satırları alın. Detay servisi fatura başlığını ve tüm satırlarını döndürür.
- Satırları eşleştirin. Satırda
stok_eslesti_mi = 0ise ürün henüz bir stok kartına bağlanmamıştır; Güncelle servisi ile stok kartını ve birimi bağlayın. Eşleştirme öğrenilir: aynı tedarikçiden gelen sonraki faturalar kendiliğinden eşleşir. - Alış faturasına aktarın. İçeri Aktar servisi faturayı alış faturasına dönüştürür; isterseniz aynı çağrıda onaylatabilirsiniz.
Fatura modülündeki tüm servisler
Fatura modülü 32 servis içerir: fatura listeleme ve sorgulama, tekil ve toplu fatura ekleme, güncelleme, silme, satır işlemleri, tahsilat yönetimi, döviz değişimi, tevkifat ve ihracat parametreleri.
- POST Fatura Listesi Fatura
- POST Fatura Bilgisi Getir Fatura
- POST Fatura Ekleme Fatura
- POST Fatura Güncelleme Fatura
- POST Fatura Blok Ekle Fatura
- POST Fatura Silme Fatura
- POST Fatura Satır Ekle Fatura
- POST Fatura Satır Güncelle Fatura
- POST Fatura Satır Sil Fatura
- POST Fatura Tahsilatlar Listesi Fatura
- POST Fatura Tahsilatı Ekleme Fatura
- POST Fatura Tahsilatlarını Güncelleme Fatura
- POST Fatura Tahsilatlarını Silme Fatura
- POST Fatura Kapama Bilgisi Getir Fatura
- POST Fatura EFatura Pdf Getirme Fatura
- POST Fatura EFatura Pdf Onizleme Fatura
- POST Fatura Efatura Gönderme Fatura
- POST Fatura SeriLot Ekle Fatura
- POST Fatura Sevk Adres Listesi Fatura
- POST Fatura Onay Fatura
Fatura modülünün tamamını görüntüleyin →
Sıkça sorulan sorular
Evobulut ile API üzerinden e-fatura gönderebilir miyim?
Evet. Evobulut API'si e-fatura gönderme servisi sunar. Fatura kaydını API ile oluşturup onayladıktan sonra e-fatura gönderme servisini çağırarak faturayı gönderebilirsiniz.
Evobulut e-fatura API'si entegratör bağımsız mı?
Evet. Entegrasyonunuz doğrudan bir e-fatura entegratörünün servislerine değil, Evobulut API'sine bağlanır. Entegratör ilişkisi Evobulut tarafında yönetildiği için hangi entegratör kullanılırsa kullanılsın aynı servisleri çağırırsınız.
e-Fatura entegratörümü değiştirirsem yazılımımı yeniden yazmam gerekir mi?
Hayır. Evobulut API'si üzerinden entegre olduğunuzda entegratör değişikliği kodunuzu etkilemez; çağırdığınız servisler, kimlik doğrulama yöntemi ve fatura yapısı aynı kalır. Entegratör seçimi teknik değil, ticari bir karar hâline gelir.
Farklı entegratör kullanan birden fazla müşteriye tek entegrasyonla hizmet verebilir miyim?
Evet. Müşterileriniz farklı e-fatura entegratörleri kullanıyor olsa bile hepsi Evobulut üzerinden çalıştığı için tek bir entegrasyon kodu yeterlidir.
Gelen e-faturaları API ile listeleyip işleyebilir miyim?
Evet. Gelen e-Fatura modülünde GİB üzerinden size ulaşan faturaları listeleyen, fatura başlığı ile birlikte tüm satırlarını döndüren, satırları stok kartlarınızla eşleştiren ve faturayı alış faturasına aktaran servisler bulunur. Arayüzde elle yaptığınız adımların tamamı API üzerinden yapılabilir.
Gelen e-faturaları periyodik olarak nasıl çekmeliyim?
Gelen e-Fatura Listesi servisini son aldığınız kayıt kimliğinden büyükleri getiren min_id parametresiyle ya da faturanın size düştüğü tarih aralığıyla (a_gtarih_bas / a_gtarih_son) çağırınız. Belge tarihine göre çekmek yanıltıcıdır; geçmiş tarihli bir fatura bugün düşebilir.
Gelen e-faturadaki ürünleri kendi stok kartlarımla eşleştirebilir miyim?
Evet. Detay servisinde stok_eslesti_mi = 0 olan satırlar henüz bir stok kartına bağlanmamıştır; Gelen e-Fatura Güncelle servisi ile stok kartını ve birimi bağlarsınız. Eşleştirme kaydedilir, aynı tedarikçiden gelen sonraki faturaların satırları kendiliğinden eşleşir.
e-Fatura PDF'ini API ile çekebilir miyim?
Evet. Evobulut API'sinde e-fatura PDF belgesini döndüren servisler bulunur; faturanın PDF çıktısını kendi sisteminize programatik olarak alabilirsiniz. Gelen e-faturalar için de PDF görüntüleme servisi vardır.
e-Fatura çekebileceğim bir ön muhasebe programı arıyorum, Evobulut uygun mu?
Evobulut, fatura ve e-fatura işlemlerini hem arayüzden hem de REST API üzerinden yapabilmenizi sağlar. Fatura modülünde 30'un üzerinde belgelenmiş servis vardır ve e-fatura gönderme ile PDF alma servisleri dokümantasyonda örnekleriyle yer alır.
Fatura satırlarını API ile tek tek ekleyebilir miyim?
Evet. Fatura modülünde fatura satırı ekleme, güncelleme ve silme servisleri ayrı ayrı belgelenmiştir; ayrıca toplu fatura ekleme servisi de bulunur.