🧑‍💻

Entegrasyon Kurulumları

14 makaleler Fatih ÇELEBİ Talha MERT Fuat POYRAZ Tarafından Fatih ÇELEBİ, Talha MERT, and Fuat POYRAZ

E-Fatura Entegratörlerin kurulum rehberleri

Paraşüt Entegrasyonu Nasıl Yapılır?

video Ayarlar > Fatura Hesapları > Hesap Ekle yolunu izleyerek yeni hesap ekleme işlemine başlıyoruz Açılan ekranda arama kutusuna ‘Paraşüt’ yazıyoruz ve çıkan sonuçlardan ‘Ekle’ butonuna tıklıyoruz. Açılan ekranda Paraşüt hesap bilgilerimizi giriyoruz. Gerekli olan Client ID ve Client Secret bilgileri Paraşüt tarafından sağlanmaktadır.” Varsayılan Hesap Numarası’ alanı için, Paraşüt uygulamasında Nakit > Kasalar ve Bankalar > Kasa Hesabı kısmınına ilerleyip, tarayıcı adres çubuğunda (URL) görünen numarayı kopyalayıp bu alana yapıştırıyoruz. Bilgileri girdikten sonra ‘Bağlantıyı Test Et’ butonuyla doğrulama yapıyoruz. Doğrulama tamamlandığında, hesabı kaydederek işlemimizi bitiriyoruz. Tüm adımların tamamlanmasının ardından Paraşüt entegrasyonu başarıyla gerçekleştirilmiş olur.

Bizim Hesap Entegrasyonu

Fatura Entegratör > Ayarlar > Fatura Hesapları kısmından “Hesap Ekle” diyoruz “Bizim Hesap” kısmında yer alan “Ekle” butonunu kullanıyoruz. Bizim Hesap tarafından gelen API bilgilerini bu kısma yazıyoruz, daha sonrasında “Bağlantıyı Test Et” diyerek API bilgilerini test ediyoruz ve entegrasyonu sağlıyoruz.

E-Arşiv Portal Entegrasyonu

video Fatura Entegratör > Ayarlar > Fatura Hesapları kısmından “Hesap Ekle” diyoruz “E-Arşiv Portal” kısmında yer alan “Ekle” butonunu kullanıyoruz. E-Logo tarafından gelen API bilgilerini bu kısma yazıyoruz, daha sonrasında “Bağlantıyı Test Et” diyerek API bilgilerini test ediyoruz ve entegrasyonu sağlıyoruz.

Mysoft Entegrasyonu

Fatura Entegratör > Ayarlar > Fatura Hesapları kısmından “Hesap Ekle” diyoruz “Mysoft” kısmında yer alan “Ekle” butonunu kullanıyoruz. Mysoft tarafından gelen API bilgilerini bu kısma yazıyoruz, daha sonrasında “Bağlantıyı Test Et” diyerek API bilgilerini test ediyoruz ve entegrasyonu sağlıyoruz.

Logo işbaşı Entegrasyonu

Fatura Entegratör > Ayarlar > Fatura Hesapları kısmından “Hesap Ekle” diyoruz “Logo İşbaşı” kısmında yer alan “Ekle” butonunu kullanıyoruz. Logo İşbaşı tarafından gelen API bilgilerini bu kısma yazıyoruz, daha sonrasında “Bağlantıyı Test Et” diyerek API bilgilerini test ediyoruz ve entegrasyonu sağlıyoruz.

Sovos Entegrasyonu Nasıl Yapılır ?

Sovos Entegrasyonu Nasıl Yapılır? Bu dokümanda Sovos entegrasyonunu adım adım nasıl tamamlayacağınızı öğreneceksiniz. Entegrasyon tamamlandığında Fatura Entegratör üzerinden doğrudan fatura kesmeye başlayabilirsiniz. https://www.youtube.com/watch?v=sTaTZAeLjzY Başlamadan Önce Kuruluma geçmeden önce aşağıdakilere sahip olduğunuzdan emin olun: - Sovos portalı giriş bilgileriniz (e-posta ve şifre) - Sovos portalında Ürün Ayarları bölümüne erişim yetkisi - Firma bilgileriniz (unvan, vergi dairesi, VKN/TCKN vb.) Adım 1: Kullanıcı Adı ve Şifre Bilgilerini Girin Öncelikle Kullanıcı Adı ve Şifre alanlarına, Sovos portalına giriş yaparken kullandığınız e-posta ve şifre bilgilerini giriyoruz. Sovos entegrasyon ekranı - kullanıcı adı ve şifre alanları Bu bilgiler Sovos portalındaki hesabınızla birebir aynı olmalıdır. Portalda şifrenizi değiştirdiğinizde bu alanı da güncellemeyi unutmayın. Adım 2: Gelen Kutusu ve Posta Kutusu Bilgilerini Bulun Gelen Kutusu ve Posta Kutusu bilgilerimizi Sovos portalı üzerinden öğrenebiliriz: 1. Sovos portalına giriş yapın. 2. Ürün Ayarları > E-Fatura Ayarları bölümüne gidin. 3. "Etiket" yazan kısımdaki bilgileri kopyalayın. 4. Kopyaladığınız bilgileri entegrasyon ekranındaki ilgili alanlara yapıştırın. Sovos portalı - Ürün Ayarları > E-Fatura Ayarları Etiket alanı Adım 3: Fatura Numarası Ayarlarını Yapılandırın Aynı menü üzerinde yer alan "Otomatik Fatura ID" tercihine göre aşağıdaki adımları izlemelisiniz. Seçenek "Evet" ise Fatura Numarası Ön Eki ve Fatura Numarası Seri Numarası alanlarını boş bırakabilirsiniz. Fatura numaraları otomatik olarak oluşturulur. Seçenek "Kapalı" ise - Fatura Numarası Ön Eki: 3 harften oluşan bir ön ek belirlemelisiniz. (örn. GIB) - Fatura Numarası Seri Numarası: Başlangıç numarasını girmelisiniz. (örn. 2026000000001) Otomatik Fatura ID ayarı Not: Otomatik Fatura ID özelliğini kullanmayıp bu değerleri kendiniz belirlediğinizde, oluşturacağınız faturaların numaraları yazdığınız bu başlangıç değeri üzerinden otomatik olarak artmaya devam eder. Adım 4: Firma Bilgilerini Tamamlayın ve Kaydedin Kalan kısımları firma bilgileriniz ile doldurarak entegrasyonu tamamlayabilirsiniz. "Hesap Bilgilerini Kaydet" dedikten sonra fatura kesmeye hazırsınız. Firma bilgileri ve Hesap Bilgilerini Kaydet butonu Entegrasyon tamamlandı. Artık Fatura Entegratör üzerinden fatura oluşturabilirsiniz. Sık Karşılaşılan Durumlar | Durum | Çözüm | | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | Giriş bilgileri hatalı uyarısı alıyorum | Sovos portalına aynı e-posta ve şifre ile giriş yapabildiğinizi kontrol edin. | | Etiket bilgilerini bulamıyorum | Sovos portalında Ürün Ayarları > E-Fatura Ayarları bölümündeki "Etiket" alanına bakın. | | Fatura numarası beklediğim gibi ilerlemiyor | Otomatik Fatura ID ayarınızın açık mı kapalı mı olduğunu kontrol edin; kapalıysa girdiğiniz başlangıç numarasını gözden geçirin. |

Uyumsoft Entegrasyonu Nasıl Yapılır ?

1. Gerekli Bilgiler Entegrasyon sürecine başlamadan önce Uyumsoft tarafından size iletilen aşağıdaki bilgilere sahip olduğunuzdan emin olun: - Portal Kullanıcı Adı: Uyumsoft portalına giriş yaparken kullandığınız kullanıcı adı (Genellikle API yetkisi olan bir kullanıcıdır). - Portal Şifresi: Kullanıcı adına ait şifre. - Firma Bilgileri: Sisteme entegre edilecek şirketin resmi bilgileri (Vergi Kimlik Numarası / TCKN, Firma Unvanı vb.). 2. Entegrasyon Adımları Adım 1: Entegrasyon Ekranına Erişim - Kullandığınız yazılımın/panelin Ayarlar veya Entegrasyonlar menüsüne gidin. - Açılan listeden Uyumsoft Entegrasyonu seçeneğine tıklayın. Adım 2: Portal Bilgilerinin Girilmesi - Karşınıza çıkan ekrandaki ilgili alanlara, Uyumsoft tarafından sağlanan Kullanıcı Adı ve Şifre bilgilerinizi eksiksiz bir şekilde yazın. Adım 3: Firma Bilgilerinin Tanımlanması - Fatura kesecek veya işlem yapacak kuruma ait Firma Bilgilerini (VKN/TCKN, Unvan, Adres vb.) ilgili kutucuklara girin. Not: Girdiğiniz VKN/TCKN bilgisinin Uyumsoft portalındaki bilgilerle birebir eşleştiğinden emin olun. Adım 4: Kaydetme ve Test İşlemi - Tüm bilgileri doldurduktan sonra "Kaydet" veya "Bağlantıyı Test Et" butonuna tıklayın. - Sistem, girdiğiniz bilgilerle Uyumsoft sunucularına bir test isteği gönderecektir. "Bağlantı Başarılı" uyarısını aldığınızda entegrasyonunuz tamamlanmış demektir.

EDM Entegrasyonu Nasıl Yapılır ?

1. Gerekli Bilgiler Entegrasyon sürecine başlamadan önce EDM Bilişim tarafından size iletilen aşağıdaki bilgilere sahip olduğunuzdan emin olun: - Portal Kullanıcı Adı: EDM portalına giriş yaparken kullandığınız kullanıcı adı (Genellikle API/Web servis yetkisi olan ana kullanıcı veya alt kullanıcıdır). - Portal Şifresi: Kullanıcı adına ait şifre. - Firma Bilgileri: Sisteme entegre edilecek şirketin resmi bilgileri (Vergi Kimlik Numarası / TCKN, Firma Unvanı vb.). 2. Entegrasyon Adımları Adım 1: Entegrasyon Ekranına Erişim - Kullandığınız yazılımın/panelin Ayarlar veya Entegrasyonlar menüsüne gidin. - Açılan listeden EDM Bilişim Entegrasyonu seçeneğine tıklayın. Adım 2: Portal Bilgilerinin Girilmesi - Karşınıza çıkan ekrandaki ilgili alanlara, EDM Bilişim tarafından sağlanan Kullanıcı Adı ve Şifre bilgilerinizi eksiksiz bir şekilde yazın. Adım 3: Firma Bilgilerinin Tanımlanması - Fatura kesecek veya işlem yapacak kuruma ait Firma Bilgilerini (VKN/TCKN, Unvan, Adres vb.) ilgili kutucuklara girin. Not: Girdiğiniz VKN/TCKN bilgisinin EDM portalındaki üyelik bilgilerinizle birebir eşleştiğinden emin olun. Adım 4: Kaydetme ve Test İşlemi - Tüm bilgileri doldurduktan sonra "Kaydet" veya "Bağlantıyı Test Et" butonuna tıklayın. - Sistem, girdiğiniz bilgilerle EDM sunucularına bir test isteği gönderecektir. "Bağlantı Başarılı" uyarısını aldığınızda entegrasyonunuz tamamlanmış demektir.

Trendyol Entegrasyonu Nasıl Yapılır ?

Trendyol üzerinden sağ üstte bulunan hesabınıza tıklayarak 'Hesap Bilgileri' sekmesine gidiyoruz. Ardından Entegrasyon Bilgileri Sekmesine İlerliyoruz. Karşımıza Çıkan Sayfadan 'Yeni Entegratör Ekle' Diyerek Entegrasyon Ekliyoruz. Entegratör Adı Olarak 'Fatura Entegratör' Yazabiliriz ve Rol Seçimi Kısmından Tüm İzinleri seçerek ilerliyoruz. Entegrasyon Bilgilerimiz Burada Yer Alıyor. Fatura Entegratör Uygulama Sayfasından Ayarlar Sekmesine Gidiyoruz. Ardından Satış Kanalları Sekmesine Gidiyoruz. Kanal Ekle Butonu ile Trendyol Hesabını Ekle Butonuna Basıp, İçerisindeki Bilgileri Trendyol Tarafındaki Entegrasyon Bilgileri ile Doldurarak Entegrasyonu Sağlıyoruz.

Turkcell e-Faturam Entegrasyonu Rehberi

Entegrasyon Aşaması Turkcell E-Faturam entegrasyonu için öncelikle app.faturaentegrator.com üzerinden Ayarlar > Fatura Hesapları bölümünden 'Turkcell e-Faturam' hesabımızı ekle butonuna basarak entegrasyon ayarlarına gidiyoruz ve firma bilgileri istenen alanları dolduruyoruz. API Key Bilgisi API key alabilmek için portal.turkcellesirket.com üzerinden Turkcell e-Faturam portalına giriş yapıyoruz, daha sonra portal üzerinden API Yönetimi sekmesi üzerinden > Yeni API Anahtarı butonuna tıklıyoruz. Yeni API Key Oluşturma Yeni API anahatarımız için isim berirliyoruz, örnek olarak 'Fatura Entegrator API' Entegrasyonu Tamamlama API anahtarınız bu aşamalardan sonra oluşacak ve bu anahtarı Fatura Entegratör uygulama sayfası üzerindeki entegrasyon bilgileri ekranına girdiğinizde artık Turkcell e-Faturam hesabınızın entegrasyonunu tamamlamış olacaksınız.

JSON Feed (Özel Entegrasyon) Nasıl Yapılır?

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.

LCW Entegrasyonu Nasıl Yapılır?

https://www.youtube.com/watch?v=3VqXXFTIZBI Satıcı ID bilgisini öğrenme İlk olarak LCW satıcı paneline giriş yaptıktan sonra sağ üstten 'Profil' kısmına tıklayıp Satıcı ID'mizi öğrenebiliriz. Fatura Entegratör üzerinde entegrasyon Satıcı ID bilgisini öğrendikten sonra sonra entegrasyon için bundan sonraki süreçte giriş bilgilerimizi bilmemiz yeterli olacak. Bu alanlara giriş Kullanıcı adı(E-posta) ve Şifre girerek entegrasyonu sağlayabiliriz. Artık entegrasyon hazır, uygulama üzerinden 'Siparişler' bölümüne gidip 'Senkronize' ettikten sonra siparişlerimize fatura kesebiliriz.

TÜRMOB (LUCA) Entegrasyonu Nasıl Yapılır?

Adım 1: Yetkilendirme Belgesini Doldurun ve Gönderin Fatura Entegratör'ün sizin adınıza TÜRMOB üzerinden fatura gönderebilmesi için yetkilendirme belgesinin TÜRMOB tarafından onaylanması gerekir. 1. Belgeyi kendi firma bilgilerinizle doldurun. 2. Belgedeki IP adresi alanına 188.245.126.129 yazın. 3. Belgenin ıslak imzalı aslını aşağıdaki adrese kargo ile gönderin. 4. Belgenin bir kopyasını foz@luca.com.tr adresine e-posta ile iletin. Gönderim adresi LUCA Proje Departmanı (Merkez) TÜRMOB – TESMER Gençlik Caddesi No: 107 Anıttepe / ANKARA Önemli: Belge gönderilmediği veya TÜRMOB onayı tamamlanmadığı sürece fatura gönderimlerinizde yetkilendirme hatası alırsınız. Onay tamamlandığında ek bir işlem yapmanıza gerek kalmadan fatura kesmeye başlayabilirsiniz. Adım 2: Kullanıcı Bilgilerini Girin Fatura Entegratör'de Ayarlar > Entegrasyonlar > Fatura Hesapları bölümünden TÜRMOB'u seçin ve aşağıdaki alanları doldurun: - Şirket Vergi Numarası: LUCA'da tanımlı şirketinizin vergi numarası - Kullanıcı Vergi Numarası: e-Fatura kullanıcınıza ait vergi numarası - Kullanıcı Şifresi: LUCA yetkiliniz tarafından tanımlanan kullanıcı şifresi Bu bilgiler LUCA yetkiliniz tarafından tanımlanır; elinizde yoksa foz@luca.com.tr adresinden talep edebilirsiniz. Adım 3: Firma Bilgilerini Tamamlayın ve Kaydedin Vergi dairesi, firma adı (bireysel mükellefseniz ad ve soyad), adres, ilçe ve il alanlarını doldurun. Hesap Bilgilerini Kaydet dedikten sonra entegrasyon tamamlanır. Fatura Resmileştirme Süresi TÜRMOB tarafında faturanın resmileştirilmesi 72 saate kadar sürebilir. Bu süre boyunca faturanız Fatura Entegratör'de beklemede görünür. Fatura Entegratör, TÜRMOB tarafındaki resmileştirmeyi otomatik olarak takip eder; faturanız resmileştiğinde ilgili satış kanalına da otomatik olarak bildirir. Bu süre içinde faturayı tekrar göndermenize gerek yoktur.

QNB eSolutions Entegrasyonu Nasıl Yapılır?

QNB portalına giriş yaptığınız kullanıcı ile entegrasyon kullanıcısı farklı olabilir. Elinizde entegrasyon kullanıcı bilgileri yoksa QNB eSolutions müşteri temsilcinizden talep edebilirsiniz. Adım 1: Kullanıcı Kodu ve Parola Bilgilerini Girin Fatura Entegratör'de Ayarlar > Entegrasyonlar > Fatura Hesapları bölümünden QNB eSolutions'ı seçin; Kullanıcı Kodu ve Parola alanlarına QNB tarafından size tanımlanan entegrasyon kullanıcı bilgilerini girin. QNB panelinde şifrenizi değiştirdiğinizde bu alanı da güncellemeyi unutmayın. Adım 2: Kasa ve Şube Bilgilerini Girin Kasa ve Şube alanları, faturanın QNB tarafında hangi kasa ve şube altında oluşturulacağını belirler. - QNB panelinizde özel bir kasa veya şube tanımı yaptıysanız bu alanlara ilgili kodu yazın. - Tanım yapmadıysanız alanları boş bırakabilirsiniz; varsayılan olarak DFLT kullanılır. Adım 3: Fatura Numarası Ayarlarını Yapılandırın QNB panelinizdeki otomatik seri ve fatura numarası verme tercihine göre aşağıdaki adımları izleyin. Otomatik numaralandırma açık ise Fatura Numarası Ön Eki ve Fatura Numarası Seri Numarası alanlarını boş bırakın. Fatura numaraları QNB tarafında otomatik olarak oluşturulur. Otomatik numaralandırma kapalı ise - Fatura Numarası Ön Eki: 3 harften oluşan bir ön ek belirlemelisiniz. (örn. GIB) - Fatura Numarası Seri Numarası: Başlangıç numarasını girmelisiniz. (örn. 2026000000001) Not: Bu değerleri kendiniz belirlediğinizde, oluşturacağınız faturaların numaraları yazdığınız başlangıç değeri üzerinden otomatik olarak artmaya devam eder. Panelde otomatik numaralandırma açıkken bu alanları da doldurursanız numaralar çakışır ve "Fatura sistemde mevcut" hatası alırsınız. İki yöntemden yalnızca birini kullanın. Adım 4: Firma Bilgilerini Tamamlayın ve Kaydedin Vergi numarası, vergi dairesi, firma adı (bireysel mükellefseniz ad ve soyad), adres, ilçe ve il alanlarını doldurun. Hesap Bilgilerini Kaydet dedikten sonra fatura kesmeye hazırsınız. Sık Karşılaşılan Durumlar Giriş bilgileri hatalı uyarısı alıyorum Portal kullanıcınız ile entegrasyon kullanıcınız farklı olabilir. QNB'den aldığınız entegrasyon kullanıcı kodu ve parolasını kullandığınızı kontrol edin. "Fatura sistemde mevcut" hatası alıyorum Aynı fatura numarasıyla ikinci kez gönderim yapılmıştır. Panelinizdeki otomatik numaralandırma ile bu ekrandaki ön ek ve seri numarası ayarının aynı anda kullanılmadığından emin olun. Fatura numarası beklediğim gibi ilerlemiyor QNB panelinizdeki otomatik numaralandırma ayarının açık mı kapalı mı olduğunu kontrol edin; kapalıysa girdiğiniz başlangıç numarasını gözden geçirin. Kasa veya şube alanına ne yazacağımı bilmiyorum Panelde özel tanımınız yoksa bu alanları boş bırakabilirsiniz; varsayılan olarak DFLT kullanılır.