Bu entegrasyon için sisteminizin, siparişlerinizi belirli bir adreste (URL) JSON formatında yayınlaması gerekir. Bunun için teknik ekibinize veya yazılımcınıza aşağıdaki dokümanı iletmeniz yeterlidir:
Teknik (geliştirici) dokümanı: https://dev.faturaentegrator.com/feed-entegrasyonu
Yazılımcınızdan şu bilgileri isteyin:
-
Sipariş Feed Adresi (URL) — zorunlu
-
Yetkilendirme bilgileri — feed adresiniz korumalıysa (token, kullanıcı adı/şifre veya özel header)
-
Bildirim Adresi (URL) — isteğe bağlı; fatura kesildiğinde sisteminize haber vermemizi istiyorsanız
Kanalı Ekleyin
Fatura Entegratör paneline giriş yapıp Ayarlar > Entegrasyonlar > Satış Kanalları yolunu izliyoruz.
Kanal Ekle butonuna tıklayıp listeden JSON Feed (Özel Entegrasyon) kanalını seçiyoruz.
Bilgileri Doldurun
Açılan ekranda aşağıdaki alanları dolduruyoruz:
Sipariş Feed Adresi (URL) Siparişlerinizin yayınlandığı adres.
Yetkilendirme Türü Feed adresiniz herkese açıksa Yok seçeneğini işaretleyin. Adresiniz korumalıysa sisteminize uygun olan seçeneği belirleyin:
-
Bearer Token — token bilgisi istenir
-
Basic Auth — kullanıcı adı ve şifre istenir
-
Özel Header — header adı ve değeri istenir
Seçiminize göre ilgili alanlar ekranda otomatik olarak belirir.
Bildirim Adresi (URL) İsteğe bağlıdır. Doldurduğunuzda, faturanız oluşturulduğunda veya silindiğinde sipariş numarası ve fatura bilgileriyle (PDF bağlantısı dahil) bu adrese bildirim gönderilir.
Bağlantıyı Test Edin ve Kaydedin
Bağlantıyı Test Et butonuna tıklıyoruz. "Bağlantı başarılı" mesajını gördüğümüzde Kanal Bilgilerini Kaydet butonu ile kurulumu tamamlıyoruz.
⚠️ Bağlantı testi başarısız olursa: Feed adresinizin internetten erişilebilir olduğundan, yetkilendirme bilgilerini doğru girdiğinizden ve adresin teknik dokümandaki JSON formatında yanıt verdiğinden emin olun.
Siparişlerinizi ve Faturalarınızı Takip Edin
-
Siparişleriniz saatte bir otomatik olarak alınır ve Siparişler sayfasında listelenir.
-
Siparişlerinizden dilediğiniz an tek tıkla fatura oluşturabilir veya otomatik faturalandırmayı kullanabilirsiniz.
-
Bildirim Adresi tanımladıysanız, faturanız resmileştiğinde PDF bağlantısıyla birlikte sisteminize otomatik bildirim gönderilir.
Denemek İster Misiniz?
https://feed-example.faturaentegrator.com/adresinden tüm tip ve webhook için deneme endpointleri mevcut
Kendi feed'inizi hazırlamadan önce entegrasyonun nasıl çalıştığını görmek isterseniz örnek feed adresimizi kullanabilirsiniz:
-
Feed Adresi:
https://feed-example.faturaentegrator.com/orders -
Yetkilendirme Türü: Yok
Bu adres, örnek siparişler içeren bir deneme feed'idir. Kanalı bu adresle ekleyip akışı uçtan uca test edebilirsiniz.
Sık Sorulan Sorular
Siparişlerim gelmiyor, ne yapmalıyım?
Kanal düzenleme sayfasındaki Bağlantıyı Test Et butonu ile adresinizi doğrulayın. Sorun devam ederse feed'inizin teknik dokümandaki formata uygun olduğunu yazılımcınızla birlikte kontrol edin.
Feed'imde vergi numarası olmayan siparişler var, fatura kesilebilir mi?
Evet. Vergi/TC kimlik numarası boş gelen siparişler, mevzuata uygun şekilde 11111111111 (nihai tüketici) olarak faturalandırılır.
Hangi para birimleri destekleniyor?
Feed'inizde ISO kodu ile gönderilen tüm para birimleri (TRY, USD, EUR vb.) desteklenir.