İdeasoft e-Fatura Entegrasyonu

İdeasoft mağazanız, panelinizde açtığınız API uygulaması ve mağaza sahibinin vereceği izinle bağlanır. Onaylanan siparişlere alıcıya göre e-Fatura ya da e-Arşiv Fatura kesilir; tutarı doğrulanamayan sipariş incelemeye kalır.

Belge türleri
e-Fatura ve e-Arşiv Fatura
Faturanın iletimi
PDF ve fatura linki
Siparişler
15 dakikada bir kontrol
Dizüstü bilgisayardan kartla ödeme yapan kişi
İdeasoft siparişinin panelde faturalanmasını gösteren örnek görünüm: sipariş 38412, tutar ₺1.865,40, e-Arşiv Fatura.

İdeasoft ile otomatik faturalama

İdeasoft sipariş entegrasyonu ile gelenler

  1. 01

    İzin bir kez verilir

    Mağaza sahibi İdeasoft ekranında uygulamaya izin verdiğinde yenileme anahtarı alınıp saklanır. Erişim jetonunun süresi dolunca bu anahtarla kendiliğinden yenilenir.

  2. 02

    Onaylanan siparişler faturalanır

    Onay ya da ödeme bekleyen siparişlere fatura kesilmez. Onaylanan, hazırlanan, kargoya verilen ve teslim edilen siparişler faturalanır; ödemesi başarısız olanlar atlanır.

  3. 03

    KDV hariç fiyatlar doğru işlenir

    İdeasoft satır fiyatlarını KDV hariç gönderir; oran her ürünün kendi vergi oranından alınır. Kargo bedeli faturaya %20 KDV ile eklenir.

  4. 04

    İndirimler toplamla sınanır

    Ürün indirimi, havale indirimi, promosyon ve kupon indirimleri satırlara dağıtılır. Sonuç İdeasoft'un sipariş genel toplamını tutmuyorsa sipariş incelemeye düşer.

Kurulum

İdeasoft API uygulaması ve yetkilendirme

  1. 1

    Yönlendirme adresini kopyalayın

    efaturan panelinde İdeasoft entegrasyon sayfasında gösterilen Yönlendirme (Redirect) adresini kopyalayın. API uygulamasını oluştururken bu adres istenir.

  2. 2

    API uygulamasını ekleyin

    İdeasoft yönetim panelinde Entegrasyonlar → API bölümünden yeni bir API ekleyin. Uygulama adını ve yönlendirme adresini girip kaydedin, İzin Yönetimi'nde siparişler için Okuma izni verin.

  3. 3

    Mağazayı kaydedin

    Mağaza Ayarları'nda İdeasoft kanalını seçin; mağaza adresinizi, Client ID ve Client Secret değerlerini girin. Refresh Token alanını boş bırakın.

  4. 4

    İzni onaylayın

    Mağaza kartındaki "İdeasoft ile yetkilendir" düğmesine basın ve açılan İdeasoft ekranında izni verin. Ardından "Bağlantıyı test et" ile siparişlerin okunduğunu doğrulayın.

İdeasoft bağlantısı için panelde istenen bilgiler: Mağaza adresi, Client ID, Client Secret, Refresh Token.
Tabletten siparişleri kontrol eden satıcı ve koli

Ayrıntılar

İdeasoft fatura kesme sırasında dikkat edilenler

İdeasoft sipariş verisinden çıkan kurallar ve yetkilendirmenin süreleri. Fatura kesilmeyen siparişin gerekçesi listede yazar.

  • Yenileme anahtarı her kullanımda yenilenir ve 2 ay hiç kullanılmazsa geçersiz olur. Bağlantı bu kadar uzun süre kapalı kaldıysa mağaza kartındaki "İdeasoft yetkisini yenile" ile izni tekrarlayın.
  • Onay ekranından dönen yetkilendirme kodu 30 saniye geçerlidir. Kod kabul edilmezse yetkilendirmeyi yeniden başlatmanız yeterlidir.
  • Hediye paketi gibi ek hizmet bedeli içeren siparişler, bu bedel faturaya otomatik eklenemediği için incelemeye bırakılır.
  • Kurumsal fatura için fatura adresinde fatura tipinin kurumsal seçilmesi ve 10 haneli vergi numarasının girilmesi gerekir; vergi dairesi de bu adresten okunur. Bireysel alıcının TC kimlik numarası fatura adresinden ya da üye bilgisinden alınır.
  • Ödeme tipi (kredi kartı, mail order, havale, kapıda ödeme) e-Arşiv Fatura'ya ödeme şekli olarak aktarılır.
  • Ürünler & Stok eşlemesinde ürünün stok kodu, stok kodu yoksa barkodu kullanılır.

Sık sorulan sorular

İdeasoft e-Arşiv fatura için merak edilenler

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

İdeasoft bağlantısında neden ayrıca yetkilendirme yapılıyor?

İdeasoft Admin API, mağaza sahibinin uygulamaya izin vermesini ister. Client ID ve Client Secret uygulamayı tanıtır; izin verildiğinde alınan yenileme anahtarı siparişlerin okunmasını sağlar.

Erişim süresi dolunca bir şey yapmam gerekir mi?

Hayır. Erişim jetonu 24 saat geçerlidir ve otomasyon çalıştıkça yenilenir. Yalnızca bağlantı 2 aydan uzun süre hiç kullanılmazsa izni mağaza kartından yeniden vermeniz gerekir.

Ödeme bekleyen siparişler ne zaman faturalanır?

Onay ya da ödeme bekleyen siparişler faturalanmaz. Sipariş İdeasoft'ta onaylandıktan sonra durumu panelde güncellendiğinde fatura kesilir.

Kesilen fatura alıcıya nasıl gönderilir?

Mağaza ayarında e-posta gönderimini açarsanız fatura NES e-posta servisiyle siparişteki e-posta adresine gider. İdeasoft API dokümanında faturayı siparişe yükleyen bir uç nokta bulunmadığından fatura İdeasoft siparişine eklenmez; PDF, UBL ve herkese açık link panelde durur.

Kendi alan adımı kullanıyorum, sorun olur mu?

Hayır. Mağaza adresi alanına magaza-adiniz.myideasoft.com biçimindeki adresi ya da mağazanızın kendi alan adını yazabilirsiniz; yetkilendirme ve sipariş istekleri bu adrese gider.

İdeasoft siparişleri hangi aralıkla çekilir?

Siparişler varsayılan olarak 15 dakikada bir, oluşturulma tarihine göre çekilir. Otomasyon sayfasındaki "Şimdi çalıştır" ile eşitlemeyi beklemeden başlatabilirsiniz.

İlk faturaları elle kontrol edebilir miyim?

Evet. "Otomatik fatura kes" anahtarı kapalıyken siparişler panele gelir ama faturalanmaz; faturayı önizleyebilir, taslak olarak saklayabilir ya da seçtiğiniz siparişleri toplu faturalayabilirsiniz. NES test ortamında belgeler GİB'e iletilmeden denenir.

İdeasoft 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.