Magento e-Fatura Entegrasyonu

Magento 2 ve Adobe Commerce mağazanız, yönetim panelinde oluşturduğunuz entegrasyonun dört anahtarıyla bağlanır. İşleniyor durumuna geçen siparişler faturalanır; fatura linki sipariş geçmişine müşterinin görebileceği bir yorum olarak eklenebilir.

Belge türleri
e-Fatura ve e-Arşiv Fatura
Faturanın iletimi
Magento (Adobe Commerce) tarafına otomatik
Siparişler
15 dakikada bir kontrol
Ekranda yazılım kodu
Magento (Adobe Commerce) siparişinin panelde faturalanmasını gösteren örnek görünüm: sipariş 000001284, tutar ₺5.320,00, e-Fatura.

Magento (Adobe Commerce) ile otomatik faturalama

Magento ve Adobe Commerce e-Fatura akışı

  1. 01

    Sipariş durumu esas alınır

    İşleniyor ve Tamamlandı durumundaki siparişler faturalanır. Yeni, ödeme bekleyen, ödemesi incelemede olan ve beklemeye alınmış siparişlere fatura kesilmez.

  2. 02

    Fatura linki yorum olur

    Kanala iletim açıksa fatura numarası ve link sipariş geçmişine yorum olarak yazılır, Magento da müşteriye sipariş güncelleme e-postası gönderir. Siparişin durumu değişmez.

  3. 03

    Tutar mağaza ayarından bağımsızdır

    Katalog fiyatları KDV dahil ya da hariç girilmiş olsun, kalem tutarları tek bir hesapla KDV dahil baza çevrilir. KDV oranı kalemin vergi yüzdesinden okunur.

  4. 04

    Ürün tipleri ayrıştırılır

    Yapılandırılabilir ürünlerde tutar ana kalemden, fiyatı alt ürünlerden oluşan paketlerde alt kalemlerden alınır. İptal edilen adetler faturaya girmez.

Kurulum

Magento entegrasyon anahtarlarını oluşturma

  1. 1

    Entegrasyon ekleyin

    Magento yönetim panelinde Sistem → Uzantılar → Entegrasyonlar yolunu izleyip "Yeni Entegrasyon Ekle" deyin.

  2. 2

    Kaynak izinlerini verin

    API sekmesinde Satış → İşlemler → Siparişler → İşlemler → Görüntüle kaynağını seçin. Faturanın sipariş yorumu olarak eklenmesi için Yorum kaynağını da işaretleyin.

  3. 3

    Etkinleştirin

    Entegrasyonu kaydedip "Etkinleştir" deyin. Ekranda Consumer Key, Consumer Secret, Access Token ve Access Token Secret değerleri gösterilir.

  4. 4

    Değerleri panele girin

    Mağaza Ayarları'nda Magento kanalını seçin, mağazanın ana adresini ve dört değeri yazıp bağlantıyı test edin. URL yeniden yazma kapalıysa adresin sonuna /index.php ekleyin.

Magento (Adobe Commerce) bağlantısı için panelde istenen bilgiler: Site adresi, Kimlik doğrulama, Consumer Key, Consumer Secret, Access Token, Access Token Secret.
Akıllı telefondan alışveriş yapan kişi

Ayrıntılar

Magento fatura kesme ayrıntıları

Magento sipariş verisine ve mağaza yapılandırmasına bağlı kurallar. Fatura kesilmeyen her siparişin nedeni listede görünür.

  • Yeni durumdaki bir sipariş, Magento içinde fatura ya da gönderi oluşturulup İşleniyor durumuna geçtiğinde faturalanır.
  • VKN/TCKN fatura adresindeki VAT Number (vat_id) alanından, bu alan boşsa müşterinin Tax/VAT Number (taxvat) alanından okunur. Firma adı ile 10 haneli numara birlikteyse kurumsal fatura kesilir.
  • Kalemlerde hiç vergi hesaplanmamışsa sipariş incelemeye düşer. Mağaza ayarlarından Tek tip KDV seçebilir ya da Magento vergi kurallarını tanımlayabilirsiniz.
  • İstekler varsayılan olarak OAuth 1.0a ile imzalanır. Mağazanızda erişim jetonunun bağımsız Bearer jetonu olarak kullanılmasına izin verdiyseniz yalnızca Access Token ile de bağlanabilirsiniz.
  • Mağaza ayarlarında "Durumları getir" ile Magento sipariş durumlarını listeleyip yalnızca seçtiklerinizi çekebilirsiniz.
  • Ödeme yöntemi koduna göre ödeme şekli havale/EFT, kapıda ödeme ya da kart olarak belirlenir.

Sık sorulan sorular

Magento e-Arşiv fatura hakkında merak edilenler

Kurulumla ilgili ayrıntılar için bağlantı adımlarına bakabilirsiniz.

Magento 2 ve Adobe Commerce için aynı bağlantı mı kullanılıyor?

Evet. İkisi de aynı REST API ile çalışır; yönetim panelindeki Entegrasyonlar ekranında oluşturulan anahtarlar her iki sürümde de kullanılır.

Hangi izinleri vermem gerekiyor?

Siparişleri okumak için Satış → İşlemler → Siparişler altındaki Görüntüle kaynağı yeterlidir. Faturanın sipariş geçmişine yorum olarak eklenmesini istiyorsanız Yorum kaynağını da seçin.

Bağlantı testinde yetki hatası alıyorum, neye bakmalıyım?

Entegrasyonun etkin olduğunu, dört anahtarın eksiksiz girildiğini ve sipariş kaynağı izninin verildiğini kontrol edin. Bearer seçtiyseniz Mağazalar → Yapılandırma → Servisler → OAuth → Tüketici Ayarları altındaki bağımsız Bearer jetonu seçeneği açık olmalıdır.

Müşteri faturayı nasıl görür?

Kanala iletim açıksa fatura linki sipariş geçmişine eklenir ve Magento müşteriye sipariş güncelleme e-postası gönderir; yorum müşterinin hesabındaki sipariş sayfasında da görünür. İsterseniz fatura ayrıca NES e-posta servisiyle gönderilir.

Magento siparişleri ne zaman panele gelir?

Eşitleme varsayılan olarak 15 dakikada bir çalışır ve son güncellenen siparişleri alır; sonradan İşleniyor durumuna geçen sipariş bu sayede yakalanır. Beklemeden çekmek için Otomasyon sayfasındaki "Şimdi çalıştır" düğmesini kullanın.

Faturalanmış Magento siparişi iptal ya da iade edilirse ne olur?

Faturalanmış siparişe tekrar fatura kesilmez. Faturası kesildikten sonra Magento içinde iptal edilen ya da iadeyle kapatılan siparişler İptal / İade ekranında listelenir.

Faturaları önce test ortamında deneyebilir miyim?

Evet. "Otomatik fatura kes" kapalıyken siparişler yalnızca çekilir; faturayı önizleyip taslak olarak saklayabilirsiniz. NES test ortamını seçerseniz belgeler GİB'e iletilmeden oluşturulur.

Magento (Adobe Commerce) siparişlerinizi faturalamaya başlayın

efaturan şu an davetle kullanılıyor. Erken erişim talebinizi bırakın; hesabınız açıldığında ilk faturaları NES test ortamında, belgeler GİB'e gitmeden birlikte kontrol edelim.