Eafatura Kargo & E-Arşiv ve E-Fatura Entegrasyonu

Kısa açıklama: WordPress WooCommerce için Fatura ve Kargo 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, >> Fatura Oluştur seçeneğine tıkladığınızda;
Eklenti ayarlarınızdaki tercihinize göre https://www.eafatura.com/api/wp-extension/create-woo-invoice veya https://www.eafatura.com/api/wp-extension/create-woo-barcode 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/wp-extension/create-woo-barcode 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/wp-extension/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ı
   a- https://www.eafatura.com/api/wp-extension/check-api-key : API Anahtarınız ile Eafatura.com kimliğinizi doğrular.
   b- https://www.eafatura.com/api/wp-extension/create-woo-invoice : API Anahtarınız ile Sipariş Numaranızı alarak ilgili siparişinize Fatura oluşturur.
   c- https://www.eafatura.com/api/wp-extension/create-woo-barcode : API Anahtarınız ile Sipariş Numaranızı alarak ilgili siparişiniz için bir kargo barkodu oluşturur.
   d- 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.
   e- https://www.eafatura.com/api/wp-extension/secure-logout : Gelir İdaresi Başkanlığı Resmi Sunucularından “Güvenli Çıkış” yapar.
   f- https://www.eafatura.com/api/wp-extension/get-marketplace-comments : Eklentiye entegre edilen pazaryeri sistemlerindeki ürünlerinizin yorum entegresini yapar.
   g- https://www.eafatura.com/api/wp-extension/save-shipping-credentials : Kargo entegrasyon bilgilerinizi kaydeder.
   h- https://www.eafatura.com/api/wp-extension/update-woo-product-tax: Seçtiğiniz ürünün KDV oranını kaydeder.
   i- https://www.eafatura.com/api/wp-extension/register-woo-integration: WooCommerce’inizi Eafatura ile entegre eder.
   j- https://www.eafatura.com/api/wp-extension/register-new-user: Eafatura.com üzerinde yeni hesap kaydı yapar.
   k – https://www.eafatura.com/api/wp-extension/update-default-shipping: Seçtiğiniz varsayılan kargo firmasını Eafatura API’ye gönderir.
   l – https://wa.me/trabzon: Hata izleme ekranındaki hata kodlarını daha etkili ve ücretsiz teknik destek alabilmeniz için Eafatura’ya gönderebileceğiniz Resmi Mersev Bilişim / Eafatura.com WhatsApp Servis URL’i

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.

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.

1. 

   Eklenti ana panel sayfanız.

2. 

   Ürünlerinizin KDV oranlarını belirleyin, ilgili ürününüzü pazaryeri ID ile eşleştirin.

3. 

   Anlaşmalı kargonuzla entegrasyon yapmak için şubenizden aldığınız bilgileri güvenle kaydedin.

4. 

   Sipariş seçerek kargo barkodu veya fatura oluşturun.

5. 

   WooCommerce Sipariş Listenizden kargo barkodu veya fatura oluşturun.

6. 

   Örnek bir kargo etiketi önizemesi

7. 

   Hata izleme ekranı, servis ve sistem hatalarını görüntüleme ve anında Eafatura'ya gönderme.

8. 

   Kargo takip ekranınızı oluşturun.

Sürüm Geçmişi:
2.1.7 – Barkod Oluşturu kaldırıldı, Paketlendi durumu eklendi. Yeni sipariş durum badge stilleri artık özelleştirilebilir.
2.1.6 – Barkod Oluşturuldu durumu eklendi. fee_lines alanını ilgilendirilen bir hata düzeltildi. Eafatura API servislerine bağlantı güçlendirildi.
2.1.5 – Kargoya Verildi durumu eklendi. Eafatura API Servisinin, bu duruma getirdiği siparişler için gönderimi isteğinize bağlı, kargo takip bilgileri içeren Kargoya Verildi E-Posta gönderimi eklendi.
2.1.4 – Sipariş listesine kargo takip butonu eklendi. Ayrıca kendi kargo gönderi takip ekranınızı tasarlayabilmeniz için shortcode özelliği eklendi.
2.1.3 – Sipariş listesindeki eylem butonlarının bazı müşterilerde çalışmama sorunu düzeltildi. Barkod yazdırma ekranında geliştirmeler yapıldı.
2.1.2 – Aras Kargo entegrasyonu eklendi, varsayılan kargo seçimi eklendi.
2.1.1 – Küçük hata düzeltmeleri yapıldı.
2.1 – Hata izleme ekranı ve Eafatura Destek Hattına direkt gönderim butonu, GİB E-Arşiv Kullanıcıları için güvenli çıkış özelliği eklendi. Bazı hata gidermeleri yapıldı.
2.0.1 – Bazı hata düzeltmeleri yapıldı ve kapıda ödeme kargo barkoduyla ilgili eksikler giderildi.
2.0 – Tüm eklenti yeniden geliştirildi. UI geliştirmeleri yapıldı. Yorum entegrasyonu, yeni üye kaydı getirildi.
1.4 – Bazı görsel değişiklikler yapıldı. Müşteriler artık Hesabım > Siparişler sayfasından siparişlerine ait faturalarını takip edebilir.
1.3 – Bazı eklentilerin, Eafatura eklentisini etkilemesinin önüne geçebilecek birtakım önlemler alındı.
1.2 – Hata düzeltmeleri yapıldı ve API endpointleri güncellendi.
1.1.1 – API Güncellemeleri yapıldı.
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.