Eafatura e-Arşiv Entegrasyon

Description

Kısa açıklama: WordPress WooCommerce için e-Arşiv Fatura eklentisi.

Kullanmaya Başlamadan Önce

  • GİB e-Arşiv Portal’e Giriş Yapıldıysa, Güvenli Çıkış Yapılması Gerekmektedir.
  • Eafatura.com Panelinize Giriş Yapmışsanız Sol Menüden e-Arşiv Fatura > Güvenli Çıkış seçeneğiyle Güvenli Çıkış Yapmanız Gerekmektedir.

Gereksinimler

  • Eklentinin kullanımı aktif „Ücretsiz“ veya „Premium“, Eafatura.com Hesabı gerektirir.
  • Eafatura.com entegrasyonun başarılı bir şekilde kullanılabilmesi için „Oku/Yaz“ yetkisine sahip REST API Anahtarları.
  • „Oku“ izni, siparişlerinizin listelenmesini, fatura oluşturulacak siparişinizin bilgilerinin okunmasını sağlar.
  • „Yaz“ izni, fatura oluşturduğunuz siparişin durumunun Fatura Kesildi olarak değiştirilmesini, PDF Fatura adresinizin siparişinize eklenmesini sağlar.

Eklentinin Amacı

e-Fatura mükellefi olmayan E-Ticaret faaliyeti sürdüren vergi mükellefleri için kullanılır.
Eklenti, e-Arşiv Portal Kullanıcılarına özel otomatik e-Arşiv Fatura aracıdır.

Kurulum & Nasıl Kullanılır?

  • Eklentiler > Yeni Ekle linkini tıklayarak eklentiyi kurun
  • Eklentiler > Yüklü eklentiler menüsü altından aktif edin
  • Sol menüde görünür olan e-Arşiv Entegrasyon eklentisine tıklayarak Eafatura API Anahtarınızı girip kaydedin.

Ayrıca detaylı kurulum dökümantasyonu için https://www.mersev.com.tr/blog/wordpress-e-arsiv-entegrasyon-eklentisi-nasil-kullanilir adresine gidebilirsiniz.

Eklenti Teknik Detayları

/****** E-ARŞİV FATURA OLUŞTURMA ******/
* WooCommerce Siparişler sayfanızdan fatura oluşturmak istediğiniz siparişinize ait sipariş numaranız, >> e-Arşiv Oluştur seçeneğine tıkladığınızda;
https://www.eafatura.com/api/woo-fatura-olustur API Endpoint’inde gönderilir.

— Bu API Endpoint ile Gönderilen Veriler:
– Eafatura.com API Anahtarınız,
– Fatura Oluşturulmak İstenen Sipariş Numarası,
– Websitenizin URL’i (Yetkisiz Erişimin Engellenmesi Amacıyla)

  • Bu API Endpont’i, sizi API Anahtarınızdan tanır ve e-Arşiv Faturanızı oluşturarak PDF URL’ini WordPress’inize geri gönderir.

/****** KARGO BARKODU OLUŞTURMA ******/
* Eafatura Panelinizde WooCommerce > Kargo Ayarları sayfasından eğer bir Kargo Anlaşması Kurulumu yapmışsanız, kargo barkodunun oluşturulmasını istediğiniz
siparişinizi seçtiğinizde, ilgili siparişinizin numarası;
https://www.eafatura.com/api/woo-barkod-olustur API Endpoint’inde gönderilir.

— Bu API Endpoint ile Gönderilen Veriler:
– Eafatura.com API Anahtarınız,
– Fatura Oluşturulmak İstenen Sipariş Numarası,
– Websitenizin URL’i (Yetkisiz Erişimin Engellenmesi Amacıyla)

  • Bu API Endpont’i, sizi API Anahtarınızdan tanır ve kargo barkodunuzu oluşturarak seçtiğiniz siparişinize ekler.

/****** EAFATURA LİSANS BİLGİLERİNİ ALMA ******/
* Eklenti ayar sayfasında sizden geçerli bir Eafatura API Anahtarı girmeniz beklenir. Girdiğiniz API Anahtarınızı kaydettiğinizde;
API Anahtarınız, https://www.eafatura.com/api/check-api-key API Endpoint’ine gönderilir ve Eafatura.com’da kayıtlı adınız ile
Eafatura kalan kullanım gün sayınız bu Endpointten cevap olarak alınır.

— Bu API Endpoint ile Gönderilen Veriler:
– Eafatura.com API Anahtarınız,
– Websitenizin URL’i (Yetkisiz Erişimin Engellenmesi Amacıyla)

Video Tutorial

Eafatura’da WooCommerce Kolay Kurulum Sihirbazı Nasıl Kullanır Video Kılavuzu
https://www.youtube.com/watch?v=5hbUEaSklJw

3RD Party/External Sources

  1. Parti/Dış Kaynak Detayları
    1- https://www.eafatura.com/api/check-api-key : API Anahtarınız ile Eafatura.com kimliğinizi doğrular.
    2- https://www.eafatura.com/api/woo-fatura-olustur : API Anahtarınız ile Sipariş Numaranızı alarak ilgili siparişinize e-Arşiv Fatura oluşturur.
    3- https://www.eafatura.com/api/woo-barkod-olustur : API Anahtarınız ile Sipariş Numaranızı alarak ilgili siparişiniz için bir kargo barkodu oluşturur.
    4- https://barcode.tec-it.com/barcode.ashx?data=KARGO_BARKODU&code=Code128&translate-esc=on : Harici bir kütüphane kullanmadan, kargo barkodunuzu otomatik
    olarak Code128 standartında barkod görseline dönüştürür.
    5- https://www.mersev.com.tr/blog/wordpress-e-arsiv-entegrasyon-eklentisi-nasil-kullanilir : Eklentinin nasıl kullanılacağını açıklayan resmi dökümantasyon.
    6- https://www.eafatura.com/api/woo-guvenli-cikis?api_key=API_ANAHTARINIZ : Gelir İdaresi Başkanlığı Resmi Sunucularından „Güvenli Çıkış“ yapar.

Bu eklenti bir Mersev Bilişim Yazılım Ltd. Şti. markası olan Eafatura.com tarafından geliştirilmiştir. Daha detaylı bilgi için;
Kullanım Koşulları: https://www.eafatura.com/sozlesme/kullanim-sozlesmesi ve
Gizlilik Politikası: https://www.eafatura.com/sozlesme/gizlilik-politikasi
sayfalarını ziyaret edebilirsiniz.

Screenshots

  • Eklentinizi aktif ettikten sonra sol menüdeki Eafatura bağlantısından eklenti ayarlar sayfanıza Eafatura API Anahtarınızı girin ve kaydedin.
  • Siparişleriniz sayfasında dilediğiniz siparişinizi seçerek kargo barkodu veya e-Arşiv Fatura oluşturun.
  • Sipariş detay sayfasında oluşturulan kargo barkodlarınızı veya fatura URL’inizi görüntüleyin.
  • Sipariş listenizdeki Yeşil Renkli e-Arşiv Logosu, ilgili siparişe PDF Faturanın yüklü olduğu anlamına gelir.

FAQ

Sıkça Sorulan Sorular

  1. Eklenti ücretli midir?
    • Eklenti kullanımı ücretsizdir. Fakat aktif Ücretli veya Ücretsiz bir Eafatura.com hesabı gerektirir.
  2. Neden „Oku/Yaz“ iznine sahip API Anahtarları üretmem gerekiyor?
    • Siparişinize fatura oluşturabilmek için Oku iznine sahip olmanız gerekir. Yaz izni ise, oluşturulan e-Arşiv Faturanın PDF URL’inin veya
      Kargo Barkodunuzun siparişinize eklenmesi için gereklidir.
  3. Nasıl entegrasyon yaparım?
    • Tüm entegrasyon ayarları Eafatura.com Panelinizdeki sol menüde E-Ticaret > WooCommerce > Ayarlar ve E-Ticaret > WooCommerce -> Sipariş Durumları
      sayfasından yapılandırılır. Eklenti Ayarlar sayfasından ise sadece API Anahtarınızı girerek eşleştirme sağlamalısınız.
  4. Toplu e-Arşiv Fatura veya toplu kargo barkodu oluşturabilir miyim?
    • Sistem, toplu fatura oluşturmaya veya toplu barkod oluşturma imkanını sağlar. Fakat websitenizin performansı veya yoğunluğunun, Eafatura.com sunucularının
      yoğunluğunun veya GİB Sunucularının yoğunluğunun bu durumu etkileyebileceğini unutmayın.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Eafatura e-Arşiv Entegrasyon” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

Sürüm Geçmişi:
1.1 – Trendyol Efaturam kullanıcıları için E-Fatura özelliği eklendi.
1.0.4 – Entegrasyon kontrol bildirimleri eklendi.
1.0.3 – Hesap kontrol fonksiyonu düzeltildi.
1.0.2 – Hata düzeltmeleri.
1.0.1 – Bazı kontroller eklendi.
1.0.0 – İlk sürüm.